## SEFAZ / BA / NFC-e (Completa) Consulta Nota Fiscal de Consumidor Eletrônica (NFC-e) completa na Secretaria da Fazenda (SEFAZ) do Estado da Bahia (BA). ### URL do site - http://nfe.sefaz.ba.gov.br/servicos/nfce/Modulos/Geral/NFCEC_consulta_chave_acesso.aspx ### Requisição URL para POST: `https://api.infosimples.com/api/v2/consultas/sefaz/ba/nfce-completa` | 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. | | nfce* | Nfce | > * 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", "api_version_full": "2.2.10-20230814124415", "product": "Consultas", "service": "sefaz/ba/nfce-completa", "parameters": { "nfce": "11111111111111111111111111111111111111111111" }, "client_name": "Minha Empresa", "token_name": "Token de Produção", "billable": true, "price": "0.2", "requested_at": "2023-08-14T23:48:04.000-03:00", "elapsed_time_in_milliseconds": 665, "remote_ip": "111.111.111.111", "signature": "U2FsdGVkX18IeFMhm920SkIGpwHid4DIjExC3h360lRAXoqkDpw0tFqpLhTaVu3rA+tKZ7Ao607RsghtS+wR9A==" }, "data_count": 1, "data": [ { "avulsa": { "cnpj": "12.345.678/9012-34", "cpf": "123.456.789-01", "reparticao_emitente": "", "matricula_funcionario": "12345", "nome_funcionario": "Exemplo de Nome", "fone_fax": "(11) 11111-1111", "uf": "SP", "numero_documento_arrecadacao": "", "valor_documento_arrecadacao": "", "data_emissao_documento_arrecadacao": "", "data_pagamento_documento_arrecadacao": "", "normalizado_cnpj": "12345678901234", "normalizado_cpf": "12345678901", "normalizado_valor_documento_arrecadacao": 0.0 }, "chave_acesso": "1111 1111 1111 1111 1111 1111 1111 1111 1111 1111 1111", "cobranca": { "fatura": {}, "duplicatas": [], "formas_pagamento": [ { "forma_pagamento": "Cartão de Crédito", "valor": "53,00", "tipo_integracao": "", "cnpj_credenciadora": "12.345.678/9012-34", "bandeira_operadora": "", "numero_autorizacao": "111", "meio_pagamento": "1 - Dinheiro", "normalizado_forma_pagamento": null, "normalizado_valor": 53.0 } ], "troco": "", "normalizado_troco": 0.0 }, "destinatario": { "nome": "Exemplo de Nome", "cnpj": "12.345.678/9012-34", "cpf": "123.456.789-01", "endereco": "Avenida Paulista, 807. São Paulo. SP. Brasil.", "bairro": "Bela Vista", "cep": "01311-915", "municipio": "SAO PAULO / SP", "telefone": "(11) 1111-1111", "uf": "SP", "pais": "", "indicador_ie": "", "ie": "11111111", "suframa": "", "im": "11111111", "email": "exemplo@email.com", "normalizado_cnpj": "12345678901234", "normalizado_cpf": "12345678901", "normalizado_cep": "01311915", "normalizado_municipio": "1111111", "normalizado_pais": null, "normalizado_indicador_ie": null }, "documentos_referenciados": [], "emitente": { "nome": "Exemplo de Nome", "nome_fantasia": "Exemplo de Nome Fantasia", "cnpj": "12.345.678/9012-34", "cpf": "123.456.789-01", "endereco": "Avenida Paulista, 807. São Paulo. SP. Brasil.", "bairro": "Bela Vista", "cep": "01311-915", "municipio": "SAO PAULO / SP", "telefone": "(11) 1111-1111", "uf": "SP", "pais": "1058 - BRASIL", "ie": "11111111", "ie_substituto": "", "inscricao_municipal": "111", "municipio_icms": "1111111", "cnae": "", "regime": "3 - Regime Normal", "normalizado_cnpj": "12345678901234", "normalizado_cpf": "12345678901", "normalizado_cep": "01311915", "normalizado_municipio": "1111111", "normalizado_pais": null, "normalizado_regime": null }, "info_adicionais": { "formato_impressao": "4 - DANFE NFC-e", "normalizado_formato_impressao": 4, "informacoes_fisco": "Exemplo de Texto", "informacoes_complementares": "Exemplo de Texto", "observacoes_contribuinte": [], "compra": { "nota_empenho": "", "pedido": "", "contrato": "" } }, "local": { "cnpj": "12.345.678/9012-34", "cpf": "123.456.789-01", "endereco": "Avenida Paulista, 807. São Paulo. SP. Brasil.", "bairro": "Bela Vista", "municipio": "SAO PAULO / SP", "uf": "SP", "normalizado_cnpj": "12345678901234", "normalizado_cpf": "12345678901", "normalizado_municipio": "1111111" }, "local_entrega": { "cnpj": "12.345.678/9012-34", "cpf": "123.456.789-01", "endereco": "Avenida Paulista, 807. São Paulo. SP. Brasil.", "bairro": "Bela Vista", "municipio": "SAO PAULO / SP", "uf": "SP", "normalizado_cnpj": "12345678901234", "normalizado_cpf": "12345678901", "normalizado_municipio": "1111111" }, "local_retirada": { "cnpj": "12.345.678/9012-34", "cpf": "123.456.789-01", "endereco": "Avenida Paulista, 807. São Paulo. SP. Brasil.", "bairro": "Bela Vista", "municipio": "SAO PAULO / SP", "uf": "SP", "normalizado_cnpj": "12345678901234", "normalizado_cpf": "12345678901", "normalizado_municipio": "1111111" }, "nfe": { "modelo": "65", "serie": "20", "numero": "1111111111", "data_emissao": "11/11/1111", "data_saida_entrada": "", "valor_total": "", "normalizado_valor_total": "", "emitente": { "cnpj": "12.345.678/9012-34", "cpf": "123.456.789-01", "nome": "Exemplo de Nome", "ie": "11111111", "uf": "SP", "normalizado_cnpj": "12345678901234", "normalizado_cpf": "12345678901", "municipio": "SAO PAULO / SP", "pais": "" }, "destinatario": { "cnpj": "12.345.678/9012-34", "cpf": "123.456.789-01", "nome": "Exemplo de Nome", "ie": "11111111", "uf": "SP", "destino_operacao": "", "consumidor_final": "", "presenca_comprador": "", "normalizado_cnpj": "12345678901234", "normalizado_cpf": "12345678901", "normalizado_destino_operacao": null, "normalizado_consumidor_final": "1", "normalizado_presenca_comprador": null, "municipio": "SAO PAULO / SP", "pais": "" }, "emissao": { "processo": "1111111-11.1111.1.11.1111", "versao": "", "tipo": "", "finalidade": "", "natureza_operacao": "", "tipo_operacao": "", "forma_pagamento": "Cartão de Crédito", "digest": "+AAbbCCDDeeFFggHH0123456789=", "normalizado_processo": null, "normalizado_tipo": null, "normalizado_finalidade": null, "normalizado_tipo_operacao": null, "normalizado_forma_pagamento": null }, "situacao": "", "situacao_ambiente": "", "eventos": [], "chave_acesso": "1111 1111 1111 1111 1111 1111 1111 1111 1111 1111 1111" }, "nfe_completa": true, "normalizado_chave_acesso": "11111111111111111111111111111111111111111111", "numero": "1111111111", "produtos": [ { "num": "1", "descricao": "Exemplo de descrição", "qtd": "APTANUTRI PREMIUM 3 - 800G", "unidade": "UNUN", "valor": "53,00", "normalizado_valor": 53.0, "codigo": "111", "ncm": "11111111", "cest": "1701500", "ex_tipi": "", "cfop": "5405", "outras_despesas": "0,00", "valor_desconto": "0,00", "valor_frete": "0,00", "valor_seguro": "0,00", "composicao_valor": "1 - O valor do item (vProd) compõe o valor total da NF-e (vProd)", "ean_comercial": "1111111111111", "unidade_comercial": "UNUN", "quantidade_comercial": "1,0000", "ean_tributavel": "1111111111111", "unidade_tributavel": "UN", "quantidade_tributavel": "1,0000", "valor_unitario_comercial": "53,0000", "valor_unitario_tributavel": "53,0000", "numero_pedido": "11111111", "item_pedido": "", "tributos": "", "fci": "", "icms": { "origem_mercadoria": "0 - Nacional", "valor_icms_st": "", "percentual_reducao_bc_icms_st": "" } } ], "resumida": { "nfe": { "natureza_operacao": "", "tipo_operacao": "", "chave_acesso": "1111 1111 1111 1111 1111 1111 1111 1111 1111 1111 1111", "modelo": "65", "serie": "20", "numero": "1111111111", "data_emissao": "11/11/1111", "normalizado_chave_acesso": "11111111111111111111111111111111111111111111", "data_saida_entrada": "", "valor_total": "", "normalizado_valor_total": "" }, "emitente": { "cnpj": "12.345.678/9012-34", "cpf": "123.456.789-01", "ie": "11111111", "nome": "Exemplo de Nome", "municipio": "SAO PAULO / SP", "uf": "SP", "pais": "", "normalizado_cnpj": "12345678901234", "normalizado_cpf": "12345678901" }, "destinatario": { "cnpj": "12.345.678/9012-34", "cpf": "123.456.789-01", "ie": "11111111", "nome": "Exemplo de Nome", "municipio": "SAO PAULO / SP", "uf": "SP", "pais": "", "normalizado_cnpj": "12345678901234", "normalizado_cpf": "12345678901" }, "produtos": [], "valor_total": "", "eventos": [], "digest": "+AAbbCCDDeeFFggHH0123456789=" }, "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": "53,00", "valor_frete": "0,00", "valor_seguro": "0,00", "outras_despesas": "0,00", "valor_ipi": "0,00", "valor_ipi_devolvido": null, "valor_nfe": "53,00", "valor_descontos": "0,00", "valor_ii": "0,00", "valor_pis": "0,00", "valor_cofins": "0,00", "valor_tributos": "(11,11)", "valor_fcp": "", "valor_icms_fcp": "", "valor_icms_interestadual_dest": "", "valor_icms_interestadual_rem": "", "valor_fcp_retido": "", "valor_fcp_retido_anteriormente": "", "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": 53.0, "normalizado_valor_frete": 0.0, "normalizado_valor_seguro": 0.0, "normalizado_outras_despesas": 0.0, "normalizado_valor_ipi": 0.0, "normalizado_valor_ipi_devolvido": 0.0, "normalizado_valor_nfe": 53.0, "normalizado_valor_descontos": 0.0, "normalizado_valor_ii": 0.0, "normalizado_valor_pis": 0.0, "normalizado_valor_cofins": 0.0, "normalizado_valor_tributos": 0.0, "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": 0.0, "normalizado_valor_fcp_retido_anteriormente": 0.0 }, "transporte": { "modalidade_frete": "9 - Sem Frete", "normalizado_modalidade_frete": null, "transportador": { "cnpj": "12.345.678/9012-34", "cpf": "123.456.789-01", "nome": "Exemplo de Nome", "ie": "11111111", "endereco": "Avenida Paulista, 807. São Paulo. SP. Brasil.", "municipio": "SAO PAULO / SP", "uf": "SP", "normalizado_cnpj": "12345678901234", "normalizado_cpf": "12345678901" }, "veiculo": { "placa": "AAA1111", "uf": "SP", "rntc": "" }, "reboque": { "placa": "AAA1111", "uf": "SP", "rntc": "" }, "volumes": [] }, "versao_xml": "", "xml_baixado_com_certificado": false, "site_receipt": "https://www.exemplo.com/exemplo-de-url" } ], "site_receipts": [ "https://www.exemplo.com/exemplo-de-url" ] } ``` ### Arquivo de visualização de consulta O arquivo de visualização de consulta (`site_receipts`) disponibilizado no retorno da API **pode ser sintetizado pela Infosimples** usando as informações originais da fonte quando o arquivo emitido pela fonte não for adequado para visualização. ### Exemplos de códigos para integração com a API #### Python ```python # Testado com: Python 3.10.19, Python 3.14.0 import requests url = 'https://api.infosimples.com/api/v2/consultas/sefaz/ba/nfce-completa' args = { "nfce": "VALOR_DO_PARAMETRO_NFCE", "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.