EntradasXml

Documentação para importação de XML Entradas

Abaixo seguem instruções para postagem de arquivos XML para posterior importação do movimento fiscal referente às entradas. 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 enviado o modelo do documento fiscal, seguindo os códigos de modelos conforme documentação da Receita Federal, além das informações do documento fiscal ao qual se tenha por finalidade a importação pelo produto Questor.

No Questor, é efetuada a execução interna da rotina para a importação dos documentos fiscais. Contudo, é importante ressaltar que nem todos os modelos de documentos são possíveis de serem importados pelas rotinas internas por meio do SYN, sendo, neste caso, restrito os seguintes "Modelos de Documentos Fiscais" para Entradas:

Modelos de documentos fiscais eletrônicos

Nota Fiscal Eletrônica (NF-e) — Modelo 55

• A NF-e é um dos documentos fiscais eletrônicos mais comuns, 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 (CT-e) — 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 CT-e garante a devida contribuição de impostos como ICMS, PIS e COFINS.

Nota Fiscal do Consumidor Eletrônica (NFC-e) — 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 NFC-e, é 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-e OS — (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.
• O CT-e OS substituiu a Nota Fiscal de Serviço de Transporte, Modelo 7, quando utilizada para:
  Transporte de Pessoas: por agência de viagem ou por transportador, sempre que executar, em veículo próprio ou fretado, serviço de transporte intermunicipal, interestadual ou internacional, de pessoas.
  Transporte de Valores: por transportador de valores para englobar, em relação a cada tomador de serviço, as prestações realizadas, desde que no período de apuração do imposto.
  Excesso de Bagagem: por transportador de passageiro para englobar, no final do período de apuração do imposto, os documentos de excesso de bagagem emitidos durante o mês.

Assim, os modelos 55, 57, 65 e 67 são os modelos de documentos aceitos nas postagens por meio do Questor SYN e que internamente direcionaremos a execução da rotina através de um ambiente único e centralizado.

Os demais modelos de documentos como, por exemplo, notas de comunicação modelos 21, 22 e notas de prestação de serviços municipais, estes podem ser enviados através de "Layout TXT" ou importados por rotinas internas.  Para estes modelos de documentos, não será efetuado o processo de centralização no Questor 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, na tag "xmls": [ "string" ].

Importante: Caso seja postado mais de um XML, dentro de um mesmo post, cada XML deve ser separado por "," (vírgula), ou seja, a cada novo documento dentro do mesmo arquivo terá um separador indicando o término de um XML e o início do próximo XML, conforme o exemplo abaixo:

"xmls": [ "XML 1", "XML 2"]

A postagem dos documentos Fiscais de Entrada, deve ser efetuada no seguinte URL:

Link Métodos — Homologação:

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

Link Métodos — Produção:

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

Orientações campo a campo:

• "cnpjCliente": "string" — Neste campo será enviado o número do CNPJ do cliente do ERP que é em comum cliente também no Sistema Gestão Contábil do Questor
• "entradaSaidaEnum": 1 - Neste campo será enviada a identificação do tipo da 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

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 (NF-e)

Modelo 57 — Conhecimento de Transporte Eletrônico (CT-e)

Modelo 65 — Nota Fiscal do Consumidor Eletrônica (NFC-e)

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". Este campo de data, pode também ser utilizado com um lote de arquivos, sendo que a quantidade limite de arquivos existentes na tag "xmls" está limitada a, no máximo, 50 documentos por post efetuado pelo ERP.

OBS: Importante que a data de entrada seja enviada, de fato, com a data da entrada do documento. 

• "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 possível a autorização de mais de um CNPJ autorizado.
• "xmls": ["string"] — Neste campo devem ser enviados os arquivos que, de fato, serão importados no produto Gestão Contábil do Questor, ou seja, é nesta tag que serão enviados os documentos fiscais XML, sendo que cada documento será enviado em string com separação de cada documento por ",". Cada post está limitado a, no máximo, 50 XML.

Importante: Caso seja postado mais de um XML, dentro de um mesmo post, cada XML deve ser separado por "," (vírgula), conforme o exemplo: "xmls": [ "XML 1", "XML 2" ]

Modelo do Post com vários arquivos XML de Entradas:

Conforme exemplo abaixo: