## SEFAZ / SC / NFE Consulta detalhada de Nota Fiscal eletrônica no governo do estado de Santa Catarina. ### URL do site - https://sat.sef.sc.gov.br/tax.NET/Sat.NFe.Web/Consultas/ConsultaPublicaNFe.aspx?amb=PROD ### Requisição URL para POST: `https://api.infosimples.com/api/v2/consultas/sefaz/sc/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. | > * 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": "sefaz/sc/nfe", "parameters": { "nfe": "11111111111111111111111111111111111111111111" }, "client_name": "Minha Empresa", "token_name": "Token de Produção", "billable": true, "price": "0.2", "requested_at": "2020-07-16T15:32:56.000-03:00", "elapsed_time_in_milliseconds": 490, "remote_ip": "111.111.111.111", "signature": "U2FsdGVkX18kBlc0isqAEMZAaUtAidKbOKRDnK5Gus61hRIvoRkxef4baLnr4U1gOAjO7hiKIh0/oRi0lOSduw==" }, "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": "1111 1111 1111 1111 1111 1111 1111 1111 1111 1111 1111", "cobranca": { "fatura": { "numero": "", "valor_original": "", "valor_desconto": "", "valor_liquido": "", "normalizado_valor_original": 0.0, "normalizado_valor_desconto": 0.0, "normalizado_valor_liquido": "1.1" }, "duplicatas": [], "formas_pagamento": [ { "forma_pagamento": "90", "valor": "0,00", "tipo_integracao": "", "cnpj_credenciadora": "", "bandeira_operadora": "", "numero_autorizacao": "", "normalizado_forma_pagamento": 90, "normalizado_valor": 0.0 } ], "troco": "", "normalizado_troco": 0.0 }, "destinatario": { "nome": "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", "indicador_ie": "11 - Contribuinte ICMS (informar a IE do destinatário)", "ie": "111111111111", "suframa": "SP", "im": "", "email": "empresa@email.com", "normalizado_cnpj": "11111111111111", "normalizado_cpf": "", "normalizado_cep": "01311-300", "normalizado_municipio": "São Paulo", "normalizado_pais": "Nome de Exemplo", "normalizado_indicador_ie": "1" }, "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": "", "uf": "SP", "pais": "Nome de Exemplo", "ie": "111111111", "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": "", "endereco": "Avenida Paulista", "bairro": "Jardins", "municipio": "São Paulo", "uf": "SP", "normalizado_cnpj": "", "normalizado_cpf": "", "normalizado_municipio": "São Paulo" }, "local_entrega": { "cnpj": "", "cpf": "", "endereco": "Avenida Paulista", "bairro": "Jardins", "municipio": "São Paulo", "uf": "SP", "normalizado_cnpj": "", "normalizado_cpf": "", "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": "", "numero": "", "data_emissao": "11/11/1111 11:11:11-11:11", "data_saida_entrada": "", "valor_total": "8.774,00", "normalizado_valor_total": 8774.0, "emitente": { "cnpj": "11.111.111/1111-11", "cpf": "", "nome": "Nome de Exemplo", "ie": "111111111", "uf": "SP", "normalizado_cnpj": "11111111111111", "normalizado_cpf": "" }, "destinatario": { "cnpj": "11.111.111/1111-11", "cpf": "", "nome": "Nome de Exemplo", "ie": "111111111111", "uf": "SP", "destino_operacao": "2 - Operação Interestadual", "consumidor_final": "1 - Normal", "presenca_comprador": "9 - Operação não presencial (outros)", "normalizado_cnpj": "11111111111111", "normalizado_cpf": "", "normalizado_destino_operacao": 2, "normalizado_consumidor_final": "1", "normalizado_presenca_comprador": 9 }, "emissao": { "processo": "1 - com aplicativo do Contribuinte", "versao": "1.1", "tipo": "1 - Normal", "finalidade": "1 - Normal", "natureza_operacao": "REMESSA DE MERCADORIA", "tipo_operacao": "1 - Saída", "forma_pagamento": "", "digest": "AAAAAAAA/AAAA11AAA/AAAAAA1A=", "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": {} }, { "evento": "Ciência da Operação pelo Destinatário (Órgão Autor: AN)", "protocolo": "111111111111111", "data_autorizacao": "11/11/1111 às 11:11:11-11:11", "data_inclusao": "", "info": {}, "detalhes": {}, "autorizacao_sefaz": {}, "condicoes_uso": {} }, { "evento": "CT-e Autorizado (Órgão Autor: )", "protocolo": "111111111111111", "data_autorizacao": "11/11/1111 às 11:11:11-11:11", "data_inclusao": "", "info": {}, "detalhes": {}, "autorizacao_sefaz": {}, "condicoes_uso": {} }, { "evento": "(Órgão Autor: AN)", "protocolo": "111111111111111", "data_autorizacao": "11/11/1111 às 11:11:11-11:11", "data_inclusao": "", "info": {}, "detalhes": {}, "autorizacao_sefaz": {}, "condicoes_uso": {} }, { "evento": "(Órgão Autor: AN)", "protocolo": "111111111111111", "data_autorizacao": "11/11/1111 às 11:11:11-11:11", "data_inclusao": "", "info": {}, "detalhes": {}, "autorizacao_sefaz": {}, "condicoes_uso": {} }, { "evento": "Carta de Correção Eletrônica (Orgão Autor: SC)", "protocolo": "111111111111111", "data_autorizacao": "11/11/1111 às 11:11:11-11:11", "data_inclusao": "", "info": { "orgao": "42 - SANTA CATARINA", "ambiente": "1 - Produção", "versao": "1.11", "autor": "11.111.111/1111-11", "chave_acesso": "11111111111111111111111111111111111111111111", "id": "", "data": "11/11/1111 às 11:11:11-11:11", "tipo": "110110 - Carta de Correção", "sequencial": "1" }, "detalhes": { "descricao": "Exemplo de texto", "versao": "1.11", "texto": "Correcao referente a descricao do item correto BMH1002P31F2A", "justificativa": "" }, "autorizacao_sefaz": { "mensagem": "Exemplo de texto", "protocolo": "111111111111111", "datahora": "11/11/1111 às 11:11:11-11:11" }, "condicoes_uso": { "descricao": "Exemplo de texto" } }, { "evento": "Confirmação da Operação pelo Destinatário (Órgão Autor: AN)", "protocolo": "111111111111111", "data_autorizacao": "11/11/1111 às 11:11:11-11:11", "data_inclusao": "", "info": {}, "detalhes": {}, "autorizacao_sefaz": {}, "condicoes_uso": {} } ] }, "nfe_completa": "true", "normalizado_chave_acesso": "11111111111111111111111111111111111111111111", "numero": "111111", "produtos": [ { "num": "1", "descricao": "Exemplo de texto", "qtd": 1.0, "unidade": "UN", "valor": "8.774,00", "normalizado_valor": 8774.0, "codigo": "11111111", "ncm": "11111111", "cest": "", "indicador_escala_relevante": "", "cnpj_fabricante_mercadoria": "", "codigo_beneficio_fiscal_uf": "SP", "ex_tipi": "", "cfop": "6915", "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": "SEM GTIN", "unidade_comercial": "UN", "quantidade_comercial": "1,1111", "ean_tributavel": "SEM GTIN", "unidade_tributavel": "UN", "quantidade_tributavel": "1,1111", "valor_unitario_comercial": "8.774,0000000000", "valor_unitario_tributavel": "8.774,0000000000", "numero_pedido": "", "item_pedido": "", "tributos": "", "fci": "", "icms": { "origem_mercadoria": "0 - Nacional", "tributacao_icms": "40 - Isenta", "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": "" }, "ipi": { "classe_enquadramento": "", "codigo_enquadramento": "111", "codigo_selo": "", "cnpj_produtor": "", "quantidade_selo": "", "cst": "55-Saída com suspensão", "quantidade_total_unidade_padrao": "", "valor_unidade": "", "valor_ipi": "", "base_calculo": "", "aliquota": "" }, "importacao": { "base_calculo": "", "despesas_aduaneiras": "", "imposto_importacao": "", "iof": "", "documentos": [] }, "pis": { "cst": "08 - Operação Sem Incidência da Contribuição", "base_calculo": "", "aliquota": "", "valor": "" }, "cofins": { "cst": "08 - Operação Sem Incidência da Contribuição", "base_calculo": "", "aliquota": "", "valor": "" }, "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": "" } } ], "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": "8.774,00", "valor_frete": "0,00", "valor_seguro": "0,00", "outras_despesas": "0,00", "valor_ipi": "0,00", "valor_ipi_devolvido": "", "valor_nfe": "1.111,11", "valor_descontos": "0,00", "valor_ii": "0,00", "valor_pis": "1,11", "valor_cofins": "0,00", "valor_tributos": "", "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": 8774.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": "1.1", "normalizado_valor_nfe": "1111.1", "normalizado_valor_descontos": 0.0, "normalizado_valor_ii": 0.0, "normalizado_valor_pis": "1.1", "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": "1.1", "normalizado_valor_fcp_retido_anteriormente": "1.1" }, "transporte": { "modalidade_frete": "1 - Por Conta do Emitente", "normalizado_modalidade_frete": "1", "transportador": { "cnpj": "11.111.111/1111-11", "cpf": "", "nome": "Nome de Exemplo", "ie": "111111111111", "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": "PACOTE", "marca": "MOVELEIRA", "numeracao": "", "peso_liquido": "1,111", "peso_bruto": "5,000" } ] }, "versao_xml": "1.11", "xml_baixado_com_certificado": false, "site_receipt": null } ], "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 url = 'https://api.infosimples.com/api/v2/consultas/sefaz/sc/nfe' args = { "nfe": "VALOR_DO_PARAMETRO_NFE", "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.