## Receita Federal / PGFN (CND Federal) - Lista Segunda Via Retorna uma lista com segunda via de Certidões de Débitos Relativos a Créditos Tributários Federais e à Dívida Ativa da União a partir do número de CNPJ ou CPF, e das datas de início e fim da emissão. Não retorna as certidões, apenas as informações sobre elas. ### URL do site - https://solucoes.receita.fazenda.gov.br/Servicos/CertidaoInternet/PJ/Consultar/ ### Requisição URL para POST: `https://api.infosimples.com/api/v2/consultas/receita-federal/pgfn/2via-list` | 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. | | cnpj** | CNPJ da empresa a ser consultada. | | cpf** | CPF do indivíduo a ser consultado. | | data_inicio* | Data de início de emissão no formato ISO 8601. Por exemplo, 22 de Abril de 1985 é representado em ISO 8601 da forma "1985-04-22". Preste atenção que é necessário incluir zeros, o formato "1985-4-22" seria inválido. | | data_fim* | Data final de emissão no formato ISO 8601. Por exemplo, 22 de Abril de 1985 é representado em ISO 8601 da forma "1985-04-22". Preste atenção que é necessário incluir zeros, o formato "1985-4-22" seria inválido. | | birthdate** | Data de nascimento no formato ISO 8601. Por exemplo, 22 de Abril de 1985 é representado em ISO 8601 da forma '1985-04-22'. Preste atenção que é necessário incluir zeros, o formato '1985-4-22' seria inválido. Obrigatório caso a consulta seja feita através de um CPF | > * 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/pgfn/2via-list", "parameters": { "cnpj": "11111111111111", "data_fim": "1111-11-11", "data_inicio": "1111-11-11" }, "client_name": "Minha Empresa", "token_name": "Token de Produção", "billable": true, "price": "0.24", "requested_at": "2021-09-09T08:15:41.000-03:00", "elapsed_time_in_milliseconds": 17967, "remote_ip": "111.111.111.111", "signature": "U2FsdGVkX18DJq6asBjdNJe0RQixKCqvNMeD8aXfTnxLuIVna6s2DFJi2PEkUcall2qyzb1gPdAbQM/He5Xvaw==" }, "data_count": 1, "data": [ { "certidoes": [ { "codigo_controle": "1E1F.11BF.1EBF.1111", "tipo": "Positiva com efeitos de negativa", "data_emissao": "11/11/1111 11:11:11", "data_validade": "11/11/1111", "situacao": "Expirada", "informacoes_complementares": "Exemplo de texto" }, { "codigo_controle": "AA1A.111D.1E11.1A11", "tipo": "Positiva com efeitos de negativa", "data_emissao": "11/11/1111 11:11:11", "data_validade": "11/11/1111", "situacao": "Expirada", "informacoes_complementares": "Exemplo de texto" }, { "codigo_controle": "1111.B1C1.111C.11A1", "tipo": "Positiva com efeitos de negativa", "data_emissao": "11/11/1111 11:11:11", "data_validade": "11/11/1111", "situacao": "Expirada", "informacoes_complementares": "Exemplo de texto" }, { "codigo_controle": "F111.11CA.C111.FF1C", "tipo": "Positiva com efeitos de negativa", "data_emissao": "11/11/1111 11:11:11", "data_validade": "11/11/1111", "situacao": "Expirada", "informacoes_complementares": "Exemplo de texto" }, { "codigo_controle": "F1A1.E11E.EC11.E111", "tipo": "Positiva com efeitos de negativa", "data_emissao": "11/11/1111 11:11:11", "data_validade": "11/11/1111", "situacao": "Expirada", "informacoes_complementares": "Exemplo de texto" }, { "codigo_controle": "11E1.E111.A1DE.1111", "tipo": "Positiva com efeitos de negativa", "data_emissao": "11/11/1111 11:11:11", "data_validade": "11/11/1111", "situacao": "Expirada", "informacoes_complementares": "Exemplo de texto" }, { "codigo_controle": "1111.A11C.CB1E.1111", "tipo": "Positiva com efeitos de negativa", "data_emissao": "11/11/1111 11:11:11", "data_validade": "11/11/1111", "situacao": "Expirada", "informacoes_complementares": "Exemplo de texto" }, { "codigo_controle": "111E.1111.BAD1.1F1E", "tipo": "Positiva com efeitos de negativa", "data_emissao": "11/11/1111 11:11:11", "data_validade": "11/11/1111", "situacao": "Expirada", "informacoes_complementares": "Exemplo de texto" }, { "codigo_controle": "11E1.1111.11F1.ED1F", "tipo": "Positiva com efeitos de negativa", "data_emissao": "11/11/1111 11:11:11", "data_validade": "11/11/1111", "situacao": "Expirada", "informacoes_complementares": "Exemplo de texto" }, { "codigo_controle": "11F1.1ECC.1111.1B1E", "tipo": "Positiva com efeitos de negativa", "data_emissao": "11/11/1111 11:11:11", "data_validade": "11/11/1111", "situacao": "Expirada", "informacoes_complementares": "Exemplo de texto" }, { "codigo_controle": "1111.B1D1.1D11.111C", "tipo": "Positiva com efeitos de negativa", "data_emissao": "11/11/1111 11:11:11", "data_validade": "11/11/1111", "situacao": "Expirada", "informacoes_complementares": "Exemplo de texto" }, { "codigo_controle": "1A1B.1111.1111.C111", "tipo": "Positiva com efeitos de negativa", "data_emissao": "11/11/1111 11:11:11", "data_validade": "11/11/1111", "situacao": "Expirada", "informacoes_complementares": "Exemplo de texto" }, { "codigo_controle": "A11D.111A.111C.1C11", "tipo": "Positiva com efeitos de negativa", "data_emissao": "11/11/1111 11:11:11", "data_validade": "11/11/1111", "situacao": "Expirada", "informacoes_complementares": "Exemplo de texto" }, { "codigo_controle": "1D11.1111.11F1.E111", "tipo": "Positiva com efeitos de negativa", "data_emissao": "11/11/1111 11:11:11", "data_validade": "11/11/1111", "situacao": "Expirada", "informacoes_complementares": "Exemplo de texto" }, { "codigo_controle": "1C11.F111.1E1E.CEB1", "tipo": "Positiva com efeitos de negativa", "data_emissao": "11/11/1111 11:11:11", "data_validade": "11/11/1111", "situacao": "Expirada", "informacoes_complementares": "Exemplo de texto" }, { "codigo_controle": "11E1.11E1.FA11.1AB1", "tipo": "Positiva com efeitos de negativa", "data_emissao": "11/11/1111 11:11:11", "data_validade": "11/11/1111", "situacao": "Expirada", "informacoes_complementares": "Exemplo de texto" }, { "codigo_controle": "1E1C.C1AE.EC11.1C11", "tipo": "Positiva com efeitos de negativa", "data_emissao": "11/11/1111 11:11:11", "data_validade": "11/11/1111", "situacao": "Expirada", "informacoes_complementares": "Exemplo de texto" }, { "codigo_controle": "111D.11AC.1E11.1111", "tipo": "Positiva com efeitos de negativa", "data_emissao": "11/11/1111 11:11:11", "data_validade": "11/11/1111", "situacao": "Expirada", "informacoes_complementares": "Exemplo de texto" }, { "codigo_controle": "D1B1.F1E1.11D1.C1AD", "tipo": "Positiva com efeitos de negativa", "data_emissao": "11/11/1111 11:11:11", "data_validade": "11/11/1111", "situacao": "Expirada", "informacoes_complementares": "Exemplo de texto" }, { "codigo_controle": "11CD.111A.1DB1.1B11", "tipo": "Positiva com efeitos de negativa", "data_emissao": "11/11/1111 11:11:11", "data_validade": "11/11/1111", "situacao": "Expirada Prorrogada até 30/06/2020", "informacoes_complementares": "Exemplo de texto" }, { "codigo_controle": "CD1C.B111.1111.D1FC", "tipo": "Positiva com efeitos de negativa", "data_emissao": "11/11/1111 11:11:11", "data_validade": "11/11/1111", "situacao": "Expirada Prorrogada até 29/06/2020", "informacoes_complementares": "Exemplo de texto" }, { "codigo_controle": "A111.1D11.EB1D.C111", "tipo": "Positiva com efeitos de negativa", "data_emissao": "11/11/1111 11:11:11", "data_validade": "11/11/1111", "situacao": "Expirada Prorrogada até 22/06/2020", "informacoes_complementares": "Exemplo de texto" }, { "codigo_controle": "F1CB.11A1.111F.1111", "tipo": "Positiva com efeitos de negativa", "data_emissao": "11/11/1111 11:11:11", "data_validade": "11/11/1111", "situacao": "Expirada", "informacoes_complementares": "Exemplo de texto" }, { "codigo_controle": "BC1D.1BB1.B1FD.D111", "tipo": "Positiva com efeitos de negativa", "data_emissao": "11/11/1111 11:11:11", "data_validade": "11/11/1111", "situacao": "Expirada", "informacoes_complementares": "Exemplo de texto" }, { "codigo_controle": "111B.11AB.1111.B1ED", "tipo": "Positiva com efeitos de negativa", "data_emissao": "11/11/1111 11:11:11", "data_validade": "11/11/1111", "situacao": "Expirada", "informacoes_complementares": "Exemplo de texto" }, { "codigo_controle": "E11B.1E11.1A11.1C11", "tipo": "Positiva com efeitos de negativa", "data_emissao": "11/11/1111 11:11:11", "data_validade": "11/11/1111", "situacao": "Expirada", "informacoes_complementares": "Exemplo de texto" }, { "codigo_controle": "DCE1.EC1D.DE1B.11C1", "tipo": "Positiva com efeitos de negativa", "data_emissao": "11/11/1111 11:11:11", "data_validade": "11/11/1111", "situacao": "Expirada", "informacoes_complementares": "Exemplo de texto" }, { "codigo_controle": "1111.111D.FB11.FCBD", "tipo": "Positiva com efeitos de negativa", "data_emissao": "11/11/1111 11:11:11", "data_validade": "11/11/1111", "situacao": "Expirada", "informacoes_complementares": "Exemplo de texto" }, { "codigo_controle": "11E1.AF1F.1D11.B1AE", "tipo": "Positiva com efeitos de negativa", "data_emissao": "11/11/1111 11:11:11", "data_validade": "11/11/1111", "situacao": "Expirada", "informacoes_complementares": "Exemplo de texto" }, { "codigo_controle": "11FC.1A11.111A.11D1", "tipo": "Negativa", "data_emissao": "11/11/1111 11:11:11", "data_validade": "11/11/1111", "situacao": "Expirada", "informacoes_complementares": "Exemplo de texto" } ], "cnpj": "11.111.111/1111-11", "cpf": "", "normalizado_cnpj": "11111111111111", "normalizado_cpf": "", "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/receita-federal/pgfn/2via-list' args = { "cnpj": "VALOR_DO_PARAMETRO_CNPJ", "cpf": "VALOR_DO_PARAMETRO_CPF", "data_inicio": "VALOR_DO_PARAMETRO_DATA_INICIO", "data_fim": "VALOR_DO_PARAMETRO_DATA_FIM", "birthdate": "VALOR_DO_PARAMETRO_BIRTHDATE", "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.