Documentação do retorno da consulta de NF-e
As informações da NF-e disponibilizadas estão de acordo com o leiaute da NF-e, disponibilizado pelo Encontro Nacional de Coordenadores e Administradores Tributários Estaduais (ENCAT).
As Notas Técnicas com as informações de leiaute da NF-e estão nesse link do ENCAT.
A estrutura do Json de retorno seguem as mesmas especificações dos esquemas XML dos Web Services, disponibilizados no link NF-e.
Os campos do tipo numérico serão retornados no Json no FORMATO NUMBER. E caso o valor numérico do campo seja um valor muito grande, o retorno poderá aparecer no json no FORMATO DE NOTAÇÃO CIENTÍFICA. Cabe a aplicação que consome o serviço da API dar o tratamento adequado para campos numéricos.
Exemplo de retorno
{
"nfeProc": {
"protNFe": {
"infProt": {
"nProt": 55455534534,
"digVal": "jfdgh76tr542786rteuhyfbwef8=",
"dhRecbto": "2019-07-22T09:34:06-03:00",
"Id": "Id445345345",
"chNFe": "87878774456468954646464654654546545446579312",
"xMotivo": "Autorizado o uso da NF-e",
"cStat": 100
}
},
"NFe": {
"infNFe": {
"infAdic": {
"infCpl": "Lorem ipsum dolor...",
"obsCont": [
{
"xCampo": "LEI DA TRANSPARENCIA",
"xTexto": "O VALOR APROXIMADO DE TRIBUTOS INCIDENTES SOBRE O PRECO DESTE SERVICO E DE R$ 5.62 (16.06) FONTE: IBPT"
}
]
},
"det": [
{
"nItem": 1,
"prod": {
"cEAN": "SEM GTIN",
"cProd": "JC59-00035A-SI",
"qCom": 1,
"cEANTrib": "SEM GTIN",
"vUnTrib": 265.79,
"qTrib": 1,
"vProd": 265.79,
"xProd": "UNIDADE DE DISCO RIGIDO 320GB",
"vUnCom": 265.79,
"indTot": 1,
"uTrib": "UN",
"NCM": 84717012,
"uCom": "UN",
"CFOP": 5949,
"CEST": 2103300,
"rastro": [
{
"nLote": "Lote 1",
"qLote": 18,
"dFab": "2019-07-22",
"dVal": "2020-06-22",
"cAgreg": "Agregador 1"
}
]
},
"imposto": {
"ICMS": {
"ICMS40": {
"orig": 1,
"CST": 41
}
},
"IPI": {
"IPINT": {
"CST": 53
},
"cEnq": 999
},
"COFINS": {
"COFINSNT": {
"CST": "07"
}
},
"PIS": {
"PISNT": {
"CST": "07"
}
}
}
}
],
"total": {
"ICMSTot": {
"vCOFINS": 0,
"vBCST": 0,
"vICMSDeson": 0,
"vProd": 265.79,
"vSeg": 0,
"vFCP": 0,
"vFCPST": 0,
"vNF": 265.79,
"vPIS": 0,
"vIPIDevol": 0,
"vBC": 0,
"vST": 0,
"vICMS": 0,
"vII": 0,
"vFCPSTRet": 0,
"vDesc": 0,
"vOutro": 0,
"vIPI": 0,
"vFrete": 0
}
},
"pag": {
"detPag": [
{
"vPag": 265.79,
"tPag": 99
}
]
},
"Id": "NFe87878774456468954646464654654546545446579312",
"ide": {
"tpNF": 1,
"mod": 55,
"indPres": 0,
"tpImp": 1,
"nNF": 1353368,
"cMunFG": 3534401,
"procEmi": 0,
"finNFe": 1,
"dhEmi": "2019-07-22T09:33:31-03:00",
"tpAmb": 1,
"indFinal": 1,
"dhSaiEnt": "2019-07-22T09:33:31-03:00",
"idDest": 1,
"tpEmis": 1,
"cDV": 0,
"cUF": 35,
"serie": 3,
"natOp": "Outra saida merc./prestacao serv. nao espec.",
"cNF": "00012763",
"verProc": "5.0.1500.2985"
},
"emit": {
"CNAE": 34324,
"xNome": "ACME SERVICOS LTDA",
"IM": 96852,
"CRT": 3,
"xFant": "ACME SERVICOS LTDA",
"CNPJ": "4545345345345",
"enderEmit": {
"fone": 4534534534,
"UF": "SP",
"xPais": "Brasil",
"cPais": 1058,
"xLgr": "AV Paulista",
"xMun": "São Paulo",
"nro": 628,
"cMun": 454545,
"xBairro": "Bairro do Chaves",
"CEP": "06200000"
},
"IE": 8465465454
},
"dest": {
"xNome": "ACME SERVICOS LTDA",
"CNPJ": "4545345345345",
"enderDest": {
"xCpl": "GALP 1 E 2",
"fone": 4534534534,
"UF": "SP",
"xPais": "Brasil",
"cPais": 1058,
"xLgr": "AV Paulista",
"xMun": "Osasco",
"nro": 628,
"cMun": 454545,
"xBairro": "Bairro do Chaves",
"CEP": "06200000"
},
"IE": 8465465454,
"indIEDest": 9,
"email": "acme@acme.com"
},
"transp": {
"modFrete": 0,
"vol": [
{
"pesoL": 0.03,
"qVol": 1,
"pesoB": 0.033
}
],
"transporta": {
"xNome": "John Doe da Silva",
"UF": "SP",
"xEnder": "Rua 1",
"xMun": "Sao Paulo",
"CNPJ": "4654654654654",
"IE": 8789789789
}
}
}
},
"versao": 4
},
"procEventoNFe": [
{
"evento": {
"infEvento": {
"cOrgao": 91,
"dhEvento": "2019-12-19T19:50:06-03:00",
"detEvento": {
"descEvento": "Registro Passagem Automatico MDF-e com CT-e"
},
"tpEvento": 610554
}
},
"retEvento": {
"infEvento": {
"cOrgao": 91,
"nProt": 891193694384618,
"dhRegEvento": "2019-12-19T19:50:06-03:00",
"tpEvento": 610554
}
}
}
]
}