## SEFAZ / SP / Cupom Fiscal Eletrônico (SAT) - Detalhado Consulta os dados de um Cupom Fiscal Eletrônico (CFE) Detalhado emitido no estado de São Paulo por meio da chave de acesso informada. ### URL do site - https://satsp.fazenda.sp.gov.br/COMSAT/Public/ConsultaPublica/ConsultaPublicaCfe.aspx ### Requisição URL para POST: `https://api.infosimples.com/api/v2/consultas/sefaz/sp/cfe-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. | | chave* | Chave | > * 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.11-20230824132318", "product": "Consultas", "service": "sefaz/sp/cfe-completa", "parameters": { "chave": "111111111111" }, "client_name": "Minha Empresa", "token_name": "Token de Produção", "billable": true, "price": "0.24", "requested_at": "2023-08-24T18:46:58.000-03:00", "elapsed_time_in_milliseconds": 252, "remote_ip": "111.111.111.111", "signature": "U2FsdGVkX19fPlFcSIoHTSq3O7zU/CaNwwxN+3EKN0pJGc9zjWy1x4Nv6qrcHQd2Mu5mnl/Rn2lDEAVaXjw0+A==" }, "data_count": 1, "data": [ { "cfe": { "dados_cfe": { "numero_cfe": "111111", "valor_cfe": "26,00", "normalizado_valor_cfe": 26.0 }, "emitente": { "cnpj": "12.345.678/9012-34", "normalizado_cnpj": "12345678901234", "nome_razao_social": "Exemplo de Nome", "nome_fantasia": "Exemplo de Nome Fantasia", "inscricao_estadual": "206.704.321.117", "uf": "SP" }, "numero_caixa": "001", "destinatario": { "cnpj": "12.345.678/9012-34", "normalizado_cnpj": "12345678901234", "nome_razao_social": "Exemplo de Nome" }, "emissao": { "versao_xml": "008", "numero_serie_sat": "111111111", "versao_software_basico": "01.01.00", "cnpj_software_house": "12.345.678/9012-34" } }, "destinatario": { "cnpj": "12.345.678/9012-34", "normalizado_cnpj": "12345678901234", "nome_razao_social": "Exemplo de Nome" }, "emitente": { "cnpj": "12.345.678/9012-34", "normalizado_cnpj": "12345678901234", "inscricao_estadual": "206.704.321.117", "inscricao_municipal": "111", "nome_fantasia": "Exemplo de Nome Fantasia", "nome_razao_social": "Exemplo de Nome", "endereco": "Avenida Paulista, 807. São Paulo. SP. Brasil.", "cep": "01311-915", "bairro_distrito": "ALDEIA", "municipio": "SAO PAULO / SP", "uf": "SP", "codigo_regime_tributario": "Simples Nacional", "regime_tributacao_issqn": "Microempresa Municipal", "indicador_rateio_desconto_subtotal": "Não" }, "local_entrega": { "endereco": "Avenida Paulista, 807. São Paulo. SP. Brasil.", "bairro_distrito": "Não Informado", "municipio": "SAO PAULO / SP", "uf": "SP" }, "produtos_servicos": [ { "num": "1", "descricao": "Exemplo de descrição", "qtd_comercial": "1,0000", "normalizado_qtd_comercial": 1.0, "unidade_comercial": "un", "valor_liquido_item": "26,00", "normalizado_valor_liquido_item": 26.0, "informacoes_adicionais": "Nenhuma informação adicional até esta data", "codigo_produto": "11", "codigo_gtin": "Não Informado", "codigo_ncm": "11111111", "codigo_substituicao_tributaria": "Não Informado", "cfop": "5102", "valor_unitario": "26,000", "normalizado_valor_unitario": 26.0, "valor_bruto": "26,00", "normalizado_valor_bruto": 26.0, "regra_calculo": "A", "normalizado_regra_calculo": 0.0, "valor_desconto": "Não Informado", "normalizado_valor_desconto": 0.0, "outras_respesas_acessorias": "Não Informado", "rateio_desconto_subtotal": "Não Informado", "rateio_acrescimo_subtotal": "Não Informado", "observacoes_fisco": "Não Informado", "origem_mercadoria": "0 - Nacional, exceto as indicadas nos códigos 3, 4, 5 e 8", "tributacao_icms": "Não Informado", "codigo_situacao_operacao_simples_nacional": "300 - Imune", "aliquota_efetiva": "Não Informado", "valor_icms": "Não Informado", "codigo_situacao_tributaria_pis": "07 - Operação Isenta de Contribuição", "valor_base_calculo_pis": "Não Informado", "aliquota_pis_percentual": "Não Informado", "quantidade_vendida_pis": "Não Informado", "aliquota_pis": "Não Informado", "valor_pis": "Não Informado", "valor_base_calculo_pis_st": "Não Informado", "aliquota_pis_st_percentual": "Não Informado", "quantidade_vendida_pis_st": "Não Informado", "aliquota_pis_st": "Não Informado", "valor_pis_st": "Não Informado", "codigo_situacao_tributaria_cofins": "07 - Operação Isenta de Contribuição", "valor_base_calculo_cofins": "Não Informado", "aliquota_cofins_percentual": "Não Informado", "valor_cofins": "Não Informado", "quantidade_vendida_cofins": "Não Informado", "aliquota_cofins": "Não Informado", "valor_base_calculo_cofins_st": "Não Informado", "aliquota_cofins_st_percentual": "Não Informado", "valor_cofins_st": "Não Informado", "quantidade_vendida_cofins_st": "Não Informado", "aliquota_cofins_st": "Não Informado", "valor_deducoes_issqn": "Não Informado", "valor_base_calculo_issqn": "Não Informado", "aliquota_issqn": "Não Informado", "valor_issqn": "Não Informado", "item_lista_servicos": "Não Informado", "cod_municipio_fato_gerador_issqn": "Não Informado", "cod_tributacao_issqn_municipio": "Não Informado", "natureza_operacao_issqn": "Não Informado", "incentivo_fiscal_issqn": "2 - Não", "valor_aprox_tributos_produto_servico": "8,34" } ], "totais": { "totais": { "valor_total_cfe": "26,00", "normalizado_valor_total_cfe": 26.0, "valor_total_produtos_servicos": "26,00", "normalizado_valor_total_produtos_servicos": 26.0, "valor_total_descontos_item": "0,00", "normalizado_valor_total_descontos_item": 0.0, "valor_total_despesas_acessorias_item": "0,00", "normalizado_valor_total_despesas_acessorias_item": 0.0, "valor_entrada_desconto_subtotal": "Não Informado", "normalizado_valor_entrada_desconto_subtotal": 0.0, "valor_entrada_acrescimo_subtotal": "Não Informado", "normalizado_valor_entrada_acrescimo_subtotal": 0.0 }, "icms": { "valor_total_icms": "0,00", "normalizado_valor_total_icms": 0.0, "valor_total_pis": "0,00", "normalizado_valor_total_pis": 0.0, "valor_total_cofins": "0,00", "normalizado_valor_total_cofins": 0.0, "valor_total_pis_st": "0,00", "normalizado_valor_total_pis_st": 0.0, "valor_total_cofins_st": "0,00", "normalizado_valor_total_cofins_st": 0.0 }, "issqn": { "valor_total_base_calculo_issqn": "Não Informado", "normalizado_valor_total_base_calculo_issqn": 0.0, "valor_total_iss": "Não Informado", "normalizado_valor_total_iss": 0.0, "valor_total_pis_servicos": "Não Informado", "normalizado_valor_total_pis_servicos": 0.0, "valor_total_cofins_servicos": "Não Informado", "normalizado_valor_total_cofins_servicos": 0.0, "valor_total_pis_st_servicos": "Não Informado", "normalizado_valor_total_pis_st_servicos": 0.0, "valor_total_cofins_st_servicos": "Não Informado", "normalizado_valor_total_cofins_st_servicos": 0.0, "valor_tributos_aproximado_cfe_sat": "8,34", "normalizado_valor_tributos_aproximado_cfe_sat": 8.34 }, "meios_pagamento": [ { "codigo": "111", "valor": "26,00", "normalizado_valor": 26.0, "credenciadora_cartao": "" } ], "valor_troco": "0,00", "normalizado_valor_troco": 0.0 }, "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 url = 'https://api.infosimples.com/api/v2/consultas/sefaz/sp/cfe-completa' args = { "chave": "VALOR_DO_PARAMETRO_CHAVE", "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.