## Receita Federal / NFE
A consulta retorna os dados e eventos da Nota Fiscal Eletrônica a partir da chave de acesso informada através da pesquisa no portal da Receita Federal. Caso não seja possível consultar os dados completos da Nota Fiscal, a consulta retornará os dados resumidos.
### URL do site
- https://www.nfe.fazenda.gov.br/portal/consultaRecaptcha.aspx?tipoConsulta=resumo&tipoConteudo=7PhJ+gAVw2g=
### Requisição
URL para POST: `https://api.infosimples.com/api/v2/consultas/receita-federal/nfe`
| Parâmetro | Descrição |
| ------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| token* | Chave de autenticação da API. É com o token que a API reconhece e autoriza quem está fazendo a consulta. |
| nfe* | Chave de acesso da NF-e. |
| pkcs12_cert** | Se você deseja fazer o download do XML da NFE usando seu certificado digital, você deve informar este parâmetro. O parâmetro deve ser enviado com o conteúdo do arquivo do certificado digital A1 criptografado seguindo as instruções de criptografia. |
| pkcs12_pass** | Se você deseja fazer o download do XML da NFE usando seu certificado digital, você deve informar este parâmetro. O parâmetro deve ser enviado com a senha do certificado digital A1 criptografada seguindo as instruções de criptografia. |
> * Parâmetro obrigatório.
> ** Parâmetro opcional. Pode ser necessário informar algum dos parâmetros opcionais para que a consulta funcione adequadamente.
### Exemplos de respostas (OK)
```json
{
"code": 200,
"code_message": "A requisição foi processada com sucesso.",
"errors": [],
"header": {
"api_version": "v2",
"service": "receita-federal/nfe",
"parameters": {
"nfe": "11111111111111111111111111111111111111111111"
},
"client_name": "Minha Empresa",
"token_name": "Token de Produção",
"billable": true,
"price": "0.24",
"requested_at": "2020-07-16T15:35:31.000-03:00",
"elapsed_time_in_milliseconds": 138,
"remote_ip": "111.111.111.111",
"signature": "U2FsdGVkX1+MS/CWSLXyjsyOYJAcFlws5SXaZuJtlFUqB+I8v0kWjYc0XL/vWHIMDbbWmp5OfBLd97tHlz083Q=="
},
"data_count": 1,
"data": [
{
"avulsa": {
"cnpj": "",
"cpf": "",
"reparticao_emitente": "",
"matricula_funcionario": "",
"nome_funcionario": "Nome de Exemplo",
"fone_fax": "",
"uf": "SP",
"numero_documento_arrecadacao": "",
"valor_documento_arrecadacao": "",
"data_emissao_documento_arrecadacao": "",
"data_pagamento_documento_arrecadacao": "",
"normalizado_cnpj": "",
"normalizado_cpf": "",
"normalizado_valor_documento_arrecadacao": "1.1"
},
"chave_acesso": "11-1111-11.111.111/1111-11-11-111-111.111.111-111.111.111-1",
"cobranca": {
"fatura": {
"numero": "111111",
"valor_original": "808,72",
"valor_desconto": "0,00",
"valor_liquido": "111,11",
"normalizado_valor_original": 808.72,
"normalizado_valor_desconto": 0.0,
"normalizado_valor_liquido": "111.11"
},
"duplicatas": [
{
"numero": "111",
"vencimento": "23/09/2019",
"valor": "808,72",
"normalizado_valor": 808.72
}
],
"formas_pagamento": [
{
"forma_pagamento": "0 - Pagamento à Vista",
"valor": "99 - Outros",
"tipo_integracao": "808,72",
"cnpj_credenciadora": "",
"bandeira_operadora": null,
"numero_autorizacao": "",
"normalizado_forma_pagamento": 0,
"normalizado_valor": 99.0
},
{
"forma_pagamento": "",
"valor": "",
"tipo_integracao": "",
"cnpj_credenciadora": "",
"bandeira_operadora": null,
"numero_autorizacao": "",
"normalizado_forma_pagamento": null,
"normalizado_valor": 0.0
},
{
"forma_pagamento": "",
"valor": null,
"tipo_integracao": null,
"cnpj_credenciadora": "",
"bandeira_operadora": null,
"numero_autorizacao": "",
"normalizado_forma_pagamento": null,
"normalizado_valor": 0.0
}
],
"troco": "",
"normalizado_troco": 0.0
},
"destinatario": {
"nome": "Nome de Exemplo",
"cnpj": "",
"cpf": "111.111.111-11",
"endereco": "Avenida Paulista",
"bairro": "Jardins",
"cep": "01311-300",
"municipio": "São Paulo",
"telefone": "(11)11111-1111",
"uf": "SP",
"pais": "Nome de Exemplo",
"indicador_ie": "11 - Não Contribuinte, que pode ou não possuir Inscrição Estadual no Cadastro de Contribuintes do ICMS",
"ie": "",
"suframa": "SP",
"im": "",
"email": "empresa@email.com",
"normalizado_cnpj": "",
"normalizado_cpf": "11111111111",
"normalizado_cep": "01311-300",
"normalizado_municipio": "São Paulo",
"normalizado_pais": "Nome de Exemplo",
"normalizado_indicador_ie": "1"
},
"documentos_referenciados": [
{
"chave_acesso": "11-1111-11.111.111/1111-11-11-111-111.111.111-111.111.111-1",
"normalizado_chave_acesso": "11111111111111111111111111111111111111111111",
"tipo_documento": "Nota Fiscal Eletrônica"
}
],
"emitente": {
"nome": "Nome de Exemplo",
"nome_fantasia": "Nome de Exemplo",
"cnpj": "11.111.111/1111-11",
"cpf": "",
"endereco": "Avenida Paulista",
"bairro": "Jardins",
"cep": "01311-300",
"municipio": "São Paulo",
"telefone": "(11)1111-1111",
"uf": "SP",
"pais": "Nome de Exemplo",
"ie": "111111111111",
"ie_substituto": "",
"inscricao_municipal": "",
"municipio_icms": "São Paulo",
"cnae": "",
"regime": "3 - Regime Normal",
"normalizado_cnpj": "11111111111111",
"normalizado_cpf": "",
"normalizado_cep": "01311-300",
"normalizado_municipio": "São Paulo",
"normalizado_pais": "Nome de Exemplo",
"normalizado_regime": 3
},
"info_adicionais": {
"formato_impressao": "1 - DANFE normal, retrato",
"normalizado_formato_impressao": 1,
"informacoes_fisco": "",
"informacoes_complementares": "Exemplo de texto",
"observacoes_contribuinte": [],
"compra": {
"nota_empenho": "",
"pedido": "",
"contrato": ""
}
},
"local": {
"cnpj": "",
"cpf": "111.111.111-11",
"endereco": "Avenida Paulista",
"bairro": "Jardins",
"municipio": "São Paulo",
"uf": "SP",
"normalizado_cnpj": "",
"normalizado_cpf": "11111111111",
"normalizado_municipio": "São Paulo"
},
"local_entrega": {
"bairro": "Jardins",
"cep": "01311-300",
"cnpj": "",
"cpf": "111.111.111-11",
"endereco": "Avenida Paulista",
"municipio": "São Paulo",
"recebedor": "Exemplo de Nome",
"uf": "SP",
"normalizado_cnpj": "",
"normalizado_cpf": "11111111111",
"normalizado_municipio": "São Paulo"
},
"local_retirada": {
"cnpj": "",
"cpf": "",
"endereco": "Avenida Paulista",
"bairro": "Jardins",
"municipio": "São Paulo",
"uf": "SP",
"normalizado_cnpj": "",
"normalizado_cpf": "",
"normalizado_municipio": "São Paulo"
},
"nfe": {
"modelo": "55",
"serie": "1",
"numero": "111111",
"data_emissao": "11/11/1111 11:11:11-11:11",
"data_saida_entrada": "",
"valor_total": "808,72",
"normalizado_valor_total": 808.72,
"emitente": {
"cnpj": "11.111.111/1111-11",
"cpf": "",
"nome": "Nome de Exemplo",
"ie": "111111111111",
"uf": "SP",
"normalizado_cnpj": "11111111111111",
"normalizado_cpf": "",
"municipio": "São Paulo",
"pais": "Nome de Exemplo"
},
"destinatario": {
"cnpj": "",
"cpf": "111.111.111-11",
"nome": "Nome de Exemplo",
"ie": "",
"uf": "SP",
"destino_operacao": "1 - Operação Interna",
"consumidor_final": "1 - Consumidor final",
"presenca_comprador": "2 - Operação pela internet",
"normalizado_cnpj": "",
"normalizado_cpf": "11111111111",
"normalizado_destino_operacao": 1,
"normalizado_consumidor_final": "1",
"normalizado_presenca_comprador": 2,
"municipio": "São Paulo",
"pais": "Nome de Exemplo"
},
"emissao": {
"processo": "1 - com aplicativo do Contribuinte",
"versao": "1.1.111",
"tipo": "1 - Normal",
"finalidade": "1 - Normal",
"natureza_operacao": "VENDA DE MERCADORIAS SUJEITA AO REGIME DE S.T. - SUBSTITUIDO",
"tipo_operacao": "1 - Saída",
"forma_pagamento": "",
"digest": "AAAAAAAAA11AAAA111AAA11AAAA=",
"normalizado_processo": "1",
"normalizado_tipo": 1,
"normalizado_finalidade": "1",
"normalizado_tipo_operacao": 1,
"normalizado_forma_pagamento": null
},
"situacao": "AUTORIZADA",
"situacao_ambiente": "produção",
"eventos": [
{
"evento": "Autorização de Uso",
"protocolo": "111111111111111",
"data_autorizacao": "11/11/1111 às 11:11:11-11:11",
"data_inclusao": "11/11/1111 às 11:11:11",
"info": {},
"detalhes": {},
"autorizacao_sefaz": {},
"condicoes_uso": {}
}
],
"chave_acesso": "11-1111-11.111.111/1111-11-11-111-111.111.111-111.111.111-1"
},
"nfe_completa": true,
"normalizado_chave_acesso": "11111111111111111111111111111111111111111111",
"numero": "111111",
"produtos": [
{
"num": "1",
"descricao": "Exemplo de texto",
"qtd": 1.0,
"unidade": "PC",
"valor": "808,72",
"normalizado_valor": 808.72,
"codigo": "11111",
"ncm": "11111111",
"cest": "1111111",
"indicador_escala_relevante": "S - Produzido em Escala Relevante;",
"cnpj_fabricante_mercadoria": "",
"codigo_beneficio_fiscal_uf": "SP",
"ex_tipi": "",
"cfop": "5405",
"outras_despesas": "",
"valor_desconto": "",
"valor_frete": "",
"valor_seguro": "",
"normalizado_cnpj_fabricante_mercadoria": "",
"composicao_valor": "1 - O valor do item (vProd) compõe o valor total da NF-e (vProd)",
"ean_comercial": "4957812591553",
"unidade_comercial": "PC",
"quantidade_comercial": "1,1111",
"ean_tributavel": "4957812591553",
"unidade_tributavel": "PC",
"quantidade_tributavel": "1,1111",
"valor_unitario_comercial": "808,7200000000",
"valor_unitario_tributavel": "808,7200000000",
"numero_pedido": "11111111",
"item_pedido": "1",
"tributos": "128,75",
"fci": "",
"icms": {
"origem_mercadoria": "2 - Estrangeira - Adquirida no Mercado Interno",
"tributacao_icms": "60 - ICMS cobrado anteriormente por substituição tributária",
"modalidade": "",
"base_calculo": "",
"aliquota": "",
"valor": "",
"base_calculo_fcp": "",
"percentual_fcp": "",
"valor_fcp": "",
"base_calculo_icms_st": "",
"aliquota_icms_st": "",
"valor_icms_st": "",
"base_calculo_fcp_retido": "",
"percentual_fcp_retido": "",
"valor_fcp_retido": "",
"percentual_reducao_bc_icms_st": "",
"percentual_mva_icms_st": "",
"modalidade_bc_icms_st": "",
"percentual_reducao_bc": "",
"valor_desonerado": "",
"motivo_desoneracao": "",
"bc_modalidade": "",
"bc_valor": "",
"bc_valor_st": "",
"bc_perccentual": "",
"uf": "SP"
},
"ipi": {
"classe_enquadramento": "",
"codigo_enquadramento": "111",
"codigo_selo": "",
"cnpj_produtor": "",
"quantidade_selo": "",
"cst": "99 - Outras saídas",
"quantidade_total_unidade_padrao": "",
"valor_unidade": "",
"valor_ipi": "0,00",
"base_calculo": "0,00",
"aliquota": "0,0000"
},
"importacao": {
"base_calculo": "",
"despesas_aduaneiras": "",
"imposto_importacao": "",
"iof": "",
"documentos": []
},
"pis": {
"cst": "01 - Operação Tributável (base de cálculo = valor da operação alíquota normal (cumulativo/não cumulativo))",
"base_calculo": "808,72",
"aliquota": "1,6500",
"valor": "13,34"
},
"cofins": {
"cst": "01 - Operação Tributável (base de cálculo = valor da operação alíquota normal (cumulativo/não cumulativo))",
"base_calculo": "808,72",
"aliquota": "7,6000",
"valor": "61,46"
},
"cofins_st": {
"quantidade_vendida": "",
"aliquota": ""
},
"info_adicionais": "Exemplo de texto",
"especifico_veiculos_novos": {
"tipo_operacao": "",
"chassi": "",
"cilindradas": "",
"cor": "",
"cor_descricao": "Exemplo de texto",
"cor_codigo": "",
"peso_liquido": "",
"peso_bruto": "",
"serie": "",
"tipo_combustivel": "",
"numero_motor": "",
"capacidade_maxima_tracao": "São Paulo",
"distancia_eixos": "",
"ano_modelo": "",
"ano_fabricacao": "",
"tipo_pintura": "",
"tipo_veiculo": "",
"especie": "",
"condicao_vin": "",
"condicao_veiculo": "",
"marca_codigo": "",
"potencia_motor": "",
"capacidade_passageiros": "São Paulo",
"restricao": ""
},
"especifico_medicamentos": {
"numero_lote": "",
"quantidade_produtos_no_lote": "",
"data_fabricacao": "",
"data_validade": "",
"preco_maximo_consumidor": ""
}
}
],
"resumida": {
"nfe": {
"natureza_operacao": "VENDA DE MERCADORIAS SUJEITA AO REGIME DE S.T. - SUBSTITUIDO",
"tipo_operacao": "1 - Saída",
"chave_acesso": "11-1111-11.111.111/1111-11-11-111-111.111.111-111.111.111-1",
"modelo": "55",
"serie": "1",
"numero": "111111",
"data_emissao": "11/11/1111 11:11:11-11:11",
"normalizado_chave_acesso": "11111111111111111111111111111111111111111111"
},
"emitente": {
"cnpj": "11.111.111/1111-11",
"cpf": "",
"ie": "111111111111",
"nome": "Nome de Exemplo",
"municipio": "São Paulo",
"uf": "SP",
"pais": "Nome de Exemplo",
"normalizado_cnpj": "11111111111111",
"normalizado_cpf": ""
},
"destinatario": {
"cnpj": "",
"cpf": "111.111.111-11",
"ie": "",
"nome": "Nome de Exemplo",
"municipio": "São Paulo",
"uf": "SP",
"pais": "Nome de Exemplo",
"normalizado_cnpj": "",
"normalizado_cpf": "11111111111"
},
"produtos": [
{
"num": "1",
"descricao": "Exemplo de texto",
"quantidade": "1.1",
"unidade_comercial": "PC",
"valor_unidade": "",
"valor_produto": "808,72"
}
],
"eventos": [
{
"evento": "Autorização de Uso",
"protocolo": "111111111111111",
"data_autorizacao": "11/11/1111 às 11:11:11-11:11",
"data_inclusao": "11/11/1111 às 11:11:11",
"info": {},
"detalhes": {},
"autorizacao_sefaz": {},
"condicoes_uso": {}
}
],
"digest": "AAAAAAAAA11AAAA111AAA11AAAA=",
"valor_total": "402,72"
},
"totais": {
"base_calculo_icms": "0,00",
"valor_icms": "0,00",
"desonerado_icms": "0,00",
"base_calculo_icms_st": "0,00",
"valor_icms_substituicao": "0,00",
"valor_produtos": "808,72",
"valor_frete": "0,00",
"valor_seguro": "0,00",
"outras_despesas": "0,00",
"valor_ipi": "0,00",
"valor_ipi_devolvido": "1,11",
"valor_nfe": "111,11",
"valor_descontos": "0,00",
"valor_ii": "0,00",
"valor_pis": "11,11",
"valor_cofins": "61,46",
"valor_tributos": "128,75",
"valor_fcp": "0,00",
"valor_icms_fcp": "",
"valor_icms_interestadual_dest": "",
"valor_icms_interestadual_rem": "",
"valor_fcp_retido": "1,11",
"valor_fcp_retido_anteriormente": "1,11",
"normalizado_base_calculo_icms": 0.0,
"normalizado_valor_icms": 0.0,
"normalizado_desonerado_icms": 0.0,
"normalizado_base_calculo_icms_st": 0.0,
"normalizado_valor_icms_substituicao": 0.0,
"normalizado_valor_produtos": 808.72,
"normalizado_valor_frete": 0.0,
"normalizado_valor_seguro": 0.0,
"normalizado_outras_despesas": 0.0,
"normalizado_valor_ipi": 0.0,
"normalizado_valor_ipi_devolvido": "1.1",
"normalizado_valor_nfe": "111.11",
"normalizado_valor_descontos": 0.0,
"normalizado_valor_ii": 0.0,
"normalizado_valor_pis": "11.11",
"normalizado_valor_cofins": 61.46,
"normalizado_valor_tributos": 128.75,
"normalizado_valor_fcp": 0.0,
"normalizado_valor_icms_fcp": 0.0,
"normalizado_valor_icms_interestadual_dest": 0.0,
"normalizado_valor_icms_interestadual_rem": 0.0,
"normalizado_valor_fcp_retido": "1.1",
"normalizado_valor_fcp_retido_anteriormente": "1.1"
},
"transporte": {
"modalidade_frete": "1 - Contratação do Frete por Conta do Remetente",
"normalizado_modalidade_frete": "1",
"transportador": {
"cnpj": "11.111.111/1111-11",
"cpf": "",
"nome": "Nome de Exemplo",
"ie": "ISENTO",
"endereco": "Avenida Paulista",
"municipio": "São Paulo",
"uf": "SP",
"normalizado_cnpj": "11111111111111",
"normalizado_cpf": ""
},
"veiculo": {
"placa": "",
"uf": "SP",
"rntc": ""
},
"reboque": {
"placa": "",
"uf": "SP",
"rntc": ""
},
"volumes": [
{
"quantidade": "1",
"especie": "VOLUME",
"marca": "",
"numeracao": "1",
"peso_liquido": "1,111",
"peso_bruto": "3,500"
}
]
},
"url_html": "https://www.exemplo.com/exemplo-de-url",
"url_xml": "https://www.exemplo.com/exemplo-de-url",
"versao_xml": "1.11",
"xml_baixado_com_certificado": false,
"site_receipt": "https://www.exemplo.com/exemplo-de-url"
}
],
"site_receipts": []
}
```
### Arquivo de visualização de consulta
O arquivo de visualização de consulta (`site_receipts`) disponibilizado no retorno da API é **emitido pela fonte original**.
### Exemplos de códigos para integração com a API
#### Python
```python
# Testado com: Python 3.10.19, Python 3.14.0
import requests
import base64
# pip install aes-bridge
import aes_bridge
url = 'https://api.infosimples.com/api/v2/consultas/receita-federal/nfe'
args = {
"nfe": "VALOR_DO_PARAMETRO_NFE",
"pkcs12_cert": aes_bridge.encrypt(base64.b64encode(open("certificado.pfx", "rb").read()).decode(), "INFORME_A_CHAVE_DE_CRIPTOGRAFIA").decode("ascii").replace("+", "-").replace("/", "_").rstrip("="),
"pkcs12_pass": aes_bridge.encrypt("SENHA_DO_CERTIFICADO", "INFORME_A_CHAVE_DE_CRIPTOGRAFIA").decode("ascii").replace("+", "-").replace("/", "_").rstrip("="),
"token": "INFORME_AQUI_O_TOKEN_DA_CHAVE_DE_ACESSO",
"timeout": "300"
}
response = requests.post(url, args)
response_json = response.json()
response.close()
if response_json['code'] == 200:
print("Retorno com sucesso: ", response_json['data'])
elif response_json['code'] in range(600, 799):
mensagem = "Resultado sem sucesso. Leia para saber mais: \n"
mensagem += "Código: {} ({})\n".format(response_json['code'], response_json['code_message'])
mensagem += "; ".join(response_json['errors'])
print(mensagem)
print("Cabeçalho da consulta: ", response_json['header'])
print("URLs com arquivos de visualização (HTML/PDF): ", response_json['site_receipts'])
```
## Estamos prontos para ajudar
Ainda tem alguma dúvida ou precisa de ajuda na sua integração? Entre em contato em [suporte@infosimples.com.br](mailto:suporte@infosimples.com.br) e receba ajuda da nossa equipe técnica altamente qualificada.