SaidasXml

Documentação para importação de XML Saídas

Abaixo instruções para postagem de arquivos Xml's para posterior importação do movimento fiscal referente às saídas. O objetivo desta documentação é facilitar a integração dos movimentos fiscais de outros programas (softwares) com o Questor. Através de postagem de arquivos Xml com as informações dos documentos fiscais, impostos e detalhamento de itens.

Para o ERP cujo objetivo seja fazer a postagem de documentos fiscais do tipo XML, é expressamente importante que seja além de postado o documento fiscal ao qual se tenha por finalidade, que seja efetuada a importação pelo produto Questor, que seja também enviado qual é o Modelo do documento fiscal, seguindo os códigos de modelos conforme documentação da Receita Federal.

No Questor, chamaremos internamente a rotina para a importação dos documentos fiscais. Contudo, é importante ressaltar que nem todos os modelos de documentos são possíveis de serem importadas pelas rotinas internar por meio do SYN.

Sendo neste caso restrito os seguintes "Modelos de Documentos Fiscais" para SAÍDAS

Modelos de documentos fiscais eletrônicos

Nota Fiscal Eletrônica (NFe) – Modelo 55

• • A NF-e é um dos documentos fiscais eletrônicos mais comuns, e emitida para registrar transações comerciais originadas de pessoas jurídicas, como: vendas, devoluções, remessas para consertos, baixas de estoque e outras operações. Nela são destacados os impostos de ICMS, PIS, a COFINS, o IPI e o Imposto sobre Importação. A adesão a este documento é obrigatória para contribuintes de ICMS que querem registrar as operações mencionadas anteriormente.

Conhecimento de Transporte Eletrônico (CTe) – Modelo 57

• • O CT-e é o documento emitido para registrar operações de transporte de carga de terceiros, pois neste documento, são vinculadas as notas fiscais das mercadorias que serão transportadas. É a partir do CT-e que os postos fiscais farão a conferência da prestação de serviço que está sendo realizada. Além de registrar a operação de transporte, emitir CTe garante a devida contribuição de impostos como ICMS, PIS e COFINS.

Cupom Fiscal Eletrônico (CFe) - Modelo 59

• • Esse sistema tem como objetivo documentar de forma eletrônica todos os arquivos e operações do comércio de varejo no Estado de São Paulo. Serve como substituto das emissões dos cupons fiscais deixando mais simples os tramites legais dos tributos.
    • Para a emissão do SAT modelo 59 não é necessário ter internet no local, porem dentro do prazo de no máximo 10 dias precisará se conectar à internet para o envio das notas armazenadas na Sefaz. Um único aparelho pode atender várias lojas.
    • A diferença do SAT (modelo 59) para a NFCe (modelo 65) é que para a utilização do SAT é necessário adquirir um aparelho SAT específico e um software homologado junto a Sefaz. O documento auxiliar é impresso em qualquer tipo de impressora térmica comum, dispensando o uso da impressora fiscal. Ele só funciona com Java 32 bits e é utilizado somente no estado de São Paulo.

Bilhete de Passagem Eletrônico (BP-e) - Modelo 63

• • O BP-e, Bilhete de Passagem Eletrônico (modelo 63) é o documento emitido e armazenado eletronicamente, de existência apenas digital, com o intuito de documentar as prestações de serviço de transporte de passageiros, cuja validade jurídica é garantida pela assinatura digital do emitente e autorização de uso pela administração tributária da unidade federada do contribuinte, antes da ocorrência do fato gerador.
    
    • O BP-e deverá ser emitido com base no leiaute estabelecido no Manual de Orientações do Contribuinte, por meio de software desenvolvido ou adquirido pelo contribuinte.
    • O emitente deverá manter o BP-e em arquivo digital, sob sua guarda e responsabilidade, pelo prazo estabelecido na legislação tributária, mesmo que fora da empresa, devendo ser disponibilizado para a administração tributária quando solicitado.

Nota Fiscal do Consumidor Eletrônica (NFCe) – Modelo 65

• • Apesar de o nome ser semelhante ao documento anterior, estes documentos são muito diferentes um do outro. O propósito da NFC-e é contabilizar para o estado, o ICMS das mercadorias comercializadas pelo varejo para o consumidor final. Este documento substituiu o cupom fiscal emitido por ECF e nota fiscal modelo 2 de venda a consumidor. Uma das vantagens na substituição de cupom fiscal pela NFCe, é a possibilidade de utilização de qualquer impressora não fiscal, sem necessidade de autorização pela SEFAZ. Antes havia a necessidade de autorização prévia do equipamento a ser utilizado.

Conhecimento de Transporte Eletrônico para Outros Serviços (CT-e OS) - Modelo 67

• • O CT-eOS – (modelo 67) foi instituído pelo Ajuste SINIEF 10/2016, publicado no Diário Oficial da União em 14 de julho de 2016 que altera o Ajuste SINIEF 09/2007.

Ou seja, os modelos 55, 57, 59, 63, 65 e 67 são os modelos que são aceitas as postagens por meio do SYN e que internamente direcionaremos a chamada por meio de um ambiente unico e centralizado.

Demais modelos de documentos, como, por exemplo, notas de comunicação, modelos 21,22. Notas Municipais de Serviço, estes demais documentos podem ser enviados por meio de Layout TXT, ou importado por meio de rotinas internas, mas não faremos o processo de centralização no SYN.

Formato do Arquivo:

• O arquivo deve ser no formato ".Xml"
• A postagem dos arquivos deve ser individual por estabelecimento, ou seja, por CNPJ de cada empresa, com o mesmo CNPJ no arquivo "Xml" do Cnpj informado na tag "cnpjCliente": "string", existente no cabeçalho do método.
• Cada arquivo Xml deve ser informado separadamente, dentro da tag "xmls": [ "string" ].
  Importante: Caso seja postado mais de um XML, dentro de um mesmo post, cada XML deve ser separado para "," VIRGULA, ou seja, aca novo documento, será separado cada XML por virgula, conforme imagem abaixo:
  • "xmls": [ "XML 1", "XML 2"]

A postagem dos documentos Fiscais de Entrada, devem ser efetuadas no seguinte Url:

Link Métodos - Homologação:

• https://synhomologacao.questor.com.br/api/v2/docfiscal/inserir

Link Métodos - Produção:

• https://syn.questor.com.br/api/v2/docfiscal/inserir

Orientações campo a campo:

• "cnpjCliente": "string" - Neste campo será enviado o numero do CNPJ do cliente do ERP que é o mesmo CNPJ em comum do cliente também no Questor Gestão Contábil.
• "entradaSaidaEnum": 1 - Neste campo será enviada a identificação do tipo de movimentação dos documentos postados, ou seja, seguir o mesmo critério da documentação de elaboração dos documentos conforme manuais da receita federal do brasil.

0=Entradas e

1=Saídas,

• "tipoDocFiscal": 55 - Neste campo será enviado o tipo do documento postado pelo ERP, ou seja, o modelo do documento seguindo o mesmo critério da documentação de elaboração dos documentos conforme manuais da receita federal do brasil.

Modelo 55 - Nota Fiscal Eletrônica (NFe)
Modelo 57 - Conhecimento de Transporte Eletrônico (CTe)
Modelo 59 - Cupom Fiscal Eletrônico (CFe)
Modelo 63 - Bilhete de Passagem Eletrônico (BPe)
Modelo 65 - Nota Fiscal do Consumidor Eletrônica (NFCe)
Modelo 67 - Conhecimento de Transporte Eletrônico para Outros Serviços (CT-e OS)

• "dataDocumento": "31/12/2021" - Neste campo será enviada a data dos documentos fiscais existentes na tag "xmls", Importante que esta data seja enviada de fato com a data da entrada do documento. Este campo data, pode também ser utilizada com um lote de arquivos, sendo que a quantidade limite de arquivos existentes na tag "xmls" esta limitado a no máximo 50 documentos por post efetuado pelo Erp.
• "permissao": ["string"] - Neste campo deve ser enviado qual/quais os CNPJ's dos autorizados a baixar os documentos Xml postados, neste campo é que será enviado o código do CNPJ autorizado a efetuar o download das movimentações transmitidas pelo ERP, sendo que é possivél a autorização de mais de um Cnpj autorizado. Importante: Neste campo o ERP/Empresa, deverá informar qual é o CNPJ do Escritório autorizado a importar os arquivos postados pela EMPRESA. Este será o CNPJ do Escritório contido na personalização do Escritório Contábil.
• "xmls": ["string"] - Neste campo deve ser eviado os arquivos que de fator serão efetuados o download no produto gestão contábil do Questor, ou seja, é nesta tag que será enviado os documentos fiscal Xml, sendo que cada documento será enviado em string com separação de cada documento por ",". Vale frisar que cada post esta limitado a no máximo 50 Xmls.
  
  • Importante: Caso seja postado mais de um XML, dentro de um mesmo post, cada XML deve ser separado por "," ou seja
  • "xmls":
    • [ "XML 1", "XML 2" ]

Modelo do Post com Mais de um arquivo Xml de Saídas:

Conforme exemplo abaixo: