Bem-vindo(a) ao Suporte da Tecnospeed

Em que podemos ajudar? :)

Artigos nessa seção

Exibir mais

Consultar Distribuição DFe

Avatar
Diego de Oliveira
  • Atualizado
Seguir

Nesta documentação vamos explicar como consultar e manifestar as notas destinadas ao CNPJ do emissor no Manager SaaS via API.

 

1. Sincronização de NFe's Destinadas

Enviar uma requisição do tipo POST na rota /nfe/envia e passar no parâmetro arquivo o texto DOCUMENTO=DFE para verificar e sincronizar as notas de acordo com o NSU (Numero Sequencial Único), disponibilizadas pela Sefaz. Também é possível sincronizar apenas uma nota, informando o parâmetro CHAVENOTA.
Obs: Esta operação pode demorar alguns minutos, dependendo da quantidade de notas destinadas que estão disponíveis na Sefaz.

 

 

POST


Homologação 

https://managersaashom.tecnospeed.com.br:7071/ManagerAPIWeb/nfe/envia


Produção

https://managersaas.tecnospeed.com.br:8081/ManagerAPIWeb/nfe/envia

 

 

Headers

 

Nome Descrição Exemplo
Content-Type Indica o tipo de arquivo application/x-www-form-urlencoded

 

 

Body

 

Nome Descrição Exemplo
encode Parâmetro utilizado para evitar que o retorno traga caracteres inválidos. true
grupo Identificação do grupo do emitente. edoc
cnpj CNPJ do emitente. 08187168000160
arquivo
Parâmetros utilizados para realizar a manifestação: 
DOCUMENTO=DFE,  CHAVENOTA

Obs:Informar CHAVENOTA apenas quando for sincronizar uma nota específica.
DOCUMENTO=DFE
CHAVENOTA=41190975405993000261550020000599571016599574

 

 

Retorno

 

Exemplo de retorno:

 

138,Documento localizado,000000000001283,000000000001283


1_-_Sincroniza__o_de_NFe_s_Destinadas.png

Obs.: Essa requisição faz com que o SaaS realize a sincronização das notas emitidas direto com o Web Service do ambiente Nacional, portanto, essa operação pode demorar alguns minutos dependendo da quantidade de notas destinadas a serem disponibilizadas pela Sefaz.
A Sefaz disponibiliza para consulta apenas as notas emitidas nos últimos 90 dias.

 

2. Consultar NFe's sincronizadas

Consultar a chave das notas que foram sincronizadas e precisam ser manifestadas (Realiza a consulta diretamente na base de dados do SaaS)

Enviar uma requisição do tipo GET na rota /nfe/consulta e passar sempre o numero 2 no parâmetro origem para pegar as notas destinadas ao CNPJ. Os demais parâmetros podem possuir valores variados: grupo, cnpj, campos, filtro, limite, ordem.

 

 

GET


Homologação 

https://managersaashom.tecnospeed.com.br:7071/ManagerAPIWeb/nfe/consulta


Produção

https://managersaas.tecnospeed.com.br:8081/ManagerAPIWeb/nfe/consulta

 

 

Querrystring

 

Nome Descrição Exemplo
encode Parâmetro utilizado para evitar que o retorno traga caracteres inválidos. true
grupo Identificação do grupo do emitente. edoc
cnpj CNPJ do emitente. 08187168000160
campos
Informações que se deseja consultar.
Campos disponíveis (Mais comuns):
 
handle - ID do registro no banco de dados.
chave - Chave da NFe.
situacao - Situação da NFe (Autorizada, Rejeitada).
nnf - Número da NFe.
codnf - Código da NFe.
nrecibo - Número do recibo da NFe.
nomeemitente - nome do emitente da nota.
serie - serie da nota.
Origem - Origem do documento.
nprotenvio - Número do protocolo de envio da NFe.
nprotcanc - Número do protocolo de cancelamento da NFe.
modoentrada - Modo de entrada da NFe (Normal, EPEC, SVCAN).
cnpj - CNPJ do emitente da NFe.
motivo - Resposta da Sefaz sobre o processamento da NFe.
dtautorizacao - Data de autorização da NFe.
dtcadadstro - Data de cadastro da NFe no banco de dados.
dtcancelamento - Data do cancelamento da NFe.
dtemissao - Data de emissão da NFe.
email - Email do destinatário da NFe.
docdestinatario - Documento do destinatário da NFe.
nomedestinatario - Nome do destinatário da NFe.
nlote - Número do lote da NFe.
ambiente - Ambiente de emissão da NFe (1 - Produção; 2 - Homologação).
valortotal - Valor total da NFe.
 
Obs: Para obter o mesmo formato de retorno do envio, utilizar os campos: codnf, chave, cstat, xmotivo

 
 
codnf, chave, cstat, motivo
filtro
Filtro da consulta.
 dtemissao >= '2018-02-01 00:00:00'
limite
Limite de registros que serão recebidos.
 50
ordem
Ordem em que serão recebidos os registros (Order By):
ASC - Ascendente pelo campo informado;
DESC - Descendente pelo campo informado;
 dtemissao ASC
origem Valores aceitos:
1 - Emitidas à Terceiros;
2 - Recebidas de Terceiros (notas destinadas);
3 - Operação Interna;
4 - Todas.
 2

 

 

Retorno

 

Exemplo de retorno:

 

23/07/2018 00:51:14,31180703981899000169550010001306604869306001,,AUTORIZADA
23/07/2018 08:16:00,32180729617631000136550030000003591009111137,,AUTORIZADA
23/07/2018 12:14:00,35180762603733000178550000000255411689857453,,AUTORIZADA

 

2_-_Consultar_NFe_s_sincronizadas.png

 

3. Enviar Manifestação do Destinatário (MDe) 

É necessário realizar a manifestação do destinatário para que a Sefaz disponibilize o download completo do XML. Você deve enviar uma requisição do tipo POST na rota /nfe/envia e passar os seguintes valores no parâmetro arquivo: DOCUMENTO=MDE, TIPOEVENTO, CHAVENOTA, DHEVENTO, FUSO e JUSTIFICATIVA
Você pode mandar o TIPOEVENTO=2 no parâmetro arquivo para manifestar com a opção "Conhecimento da Operação", e assim a nota não ficar com um evento de manifestação definitivo.
Depois de analisar o XML você pode enviar a manifestação novamente de forma definitiva com a confirmação ou não dessa operação: 

 

TipoEvento Descrição
1 Confirmação da operação.
2 Ciência da operação.
3 Desconhecimento da operação.
4 Operação não Realizada.

 

 

POST


Homologação 

https://managersaashom.tecnospeed.com.br:7071/ManagerAPIWeb/nfe/envia


Produção

https://managersaas.tecnospeed.com.br:8081/ManagerAPIWeb/nfe/envia

 

 

Headers

 

Nome Descrição Exemplo
Content-Type Indica o tipo de arquivo application/x-www-form-urlencoded

 

 

Body

 

Nome Descrição Exemplo
encode Parâmetro utilizado para evitar que o retorno traga caracteres inválidos.  true
grupo Identificação do grupo do emitente.  edoc
cnpj CNPJ do emitente.  08187168000160
arquivo
Parâmetros utilizados para realizar a manifestação: 
DOCUMENTO=MDE, TIPOEVENTO, CHAVENOTA, DHEVENTO, FUSO, JUSTIFICATIVA
DOCUMENTO=MDE
TIPOEVENTO=2
CHAVENOTA=41180208187168000160550200007000651000000104
DHEVENTO=2018-02-20T18:20:00
FUSO=-03:00
 

 

Observação: A Justificativa é obrigatória somente se o Tipo Evento for igual à 4.

Ex: JUSTIFICATIVA=Tenho desconhecimento desta operação.

 

Retorno

 

Exemplo de retorno:

 

AUTORIZADO,29180903295812000108550000000000021000028908,135,Evento registrado e vinculado a NF-e

 

3_-_Enviar_MDe.png

 

4. Download XML da Sefaz

Esse passo é importante pois ele faz o download do XML completo da Sefaz, esse ponto é importante ser feito após a Manifestação Destinatário. 

 

 

POST


Homologação 

https://managersaashom.tecnospeed.com.br:7071/ManagerAPIWeb/nfe/envia


Produção

https://managersaas.tecnospeed.com.br:8081/ManagerAPIWeb/nfe/envia

 

 

Headers

 

Nome Descrição Exemplo
Content-Type Indica o tipo de arquivo application/x-www-form-urlencoded

 

 

Body

 

Nome Descrição Exemplo
encode Parâmetro utilizado para evitar que o retorno traga caracteres inválidos.  true
grupo Identificação do grupo do emitente.  edoc
cnpj CNPJ do emitente.  08187168000160
arquivo
Parâmetros utilizados para realizar a manifestação: 
DOCUMENTO=DNF,  CHAVENOTA
DOCUMENTO=DNF
CHAVENOTA=41190975405993000261550020000599571016599574
ImportaDownload=1

 

 

Retorno

 

Exemplo de retorno:

 

29180903295812000108550000000000021000028908,Autorizado o uso da NF-e
29180903295812000108550000000000021000028908,Importação disparada na pasta importa

 

 

5. Download do XML completo da NFe

Realiza o download do XML completo de uma NFe destinada ao CNPJ caso já tenha ocorrido a manifestação e sincronização do evento, por parte da Sefaz.

Para isso, envie uma requisição GET na rota nfe/xml com os parâmetros grupo, cnpj e chavenota.

Caso o XML venha de forma resumida, significa que o evento de manifestação ainda não foi vinculado pela Sefaz, dessa forma, caso a manifestação realmente já tenha sido realizada é necessário aguardar a sincronização do WebService ou se não, enviar a manifestação novamente e então efetuar uma nova sincronização das NFe's destinadas (passo 1) para verificar se o XML completo já ficou disponível.

 

GET


Homologação 

https://managersaashom.tecnospeed.com.br:7071/ManagerAPIWeb/nfe/xml


Produção

https://managersaas.tecnospeed.com.br:8081/ManagerAPIWeb/nfe/xml

 

 

Querrystring

 

Nome Descrição
encode Parâmetro utilizado para evitar que o retorno traga caracteres inválidos.
grupo Identificação do grupo do emitente.
cnpj CNPJ do emitente.
chavenota
Chave da nota que se deseja obter o XML.

 

 

Retorno

 

Exemplo de retorno:

 

<NFe xmlns="http://www.portalfiscal.inf.br/nfe">
        <infNFe Id="NFe41180508187168000160550010020000001020000009" versao="4.00">
                <ide>
                        <cUF>41</cUF>
                        <cNF>02000000</cNF>
                        <natOp>VENDA DE MERCADORIA ADQ. DE TERCEIRO - PF E PJ NAO CONTRIBUI</natOp>
                        <mod>55</mod>
                        <serie>1</serie>
                        <nNF>2000000</nNF>
                        <dhEmi>2018-05-28T17:00:00-03:00</dhEmi>
                        <dhSaiEnt>2018-05-28T17:00:00-03:00</dhSaiEnt>
                        <tpNF>1</tpNF>
                        <idDest>1</idDest>
                        <cMunFG>4115200</cMunFG>
                        <tpImp>1</tpImp>
                        <tpEmis>1</tpEmis>
                        <cDV>9</cDV>
                        <tpAmb>2</tpAmb>
                        <finNFe>1</finNFe>
                        <indFinal>1</indFinal>
                        <indPres>1</indPres>
                        <procEmi>0</procEmi>
                        <verProc>TecnoERP - 1.2.3</verProc>
                </ide>
{.......}
</NFe>

 

4_-_Download_XML_da_NFe.png

 
Collection para ser importado no Postman com os exemplos: 
https://www.getpostman.com/collections/1aa15f35866ad64169ed
 

Artigos relacionados

Comentários

0 comentário

Por favor, entre para comentar.