## Receita Federal / PER/DCOMP
 A API consulta pedidos PER/DCOMP (Pedido Eletrônico de Restituição, Ressarcimento ou Reembolso e Declaração de Compensação) no aplicativo de celular Receita Federal. Quando há mais de um pedido no retorno da pesquisa, os dados do primeiro pedido são retornados e, para os demais pedidos, apenas os seus números são retornados, permitindo que a consulta de dados completa de um determinado pedido seja feita posteriormente. 


### URL do site
- https://play.google.com/store/apps/details?id=br.gov.economia.receita.rfb&hl=pt_BR

### Requisição
URL para POST: `https://api.infosimples.com/api/v2/consultas/receita-federal/perdcomp`



| 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. |
| cpf**      | CPF do indivíduo a ser consultado.                                                                       |
| cnpj**     | CNPJ da empresa a ser consultada.                                                                        |
| perdcomp** | Número do PER/DCOMP                                                                                      |

> * 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/perdcomp",
    "parameters": {
      "cnpj": "11111111111111",
      "data_fim": "",
      "data_inicio": ""
    },
    "client_name": "Minha Empresa",
    "token_name": "Token de Produção",
    "billable": true,
    "price": "0.2",
    "requested_at": "2021-06-28T16:57:54.000-03:00",
    "elapsed_time_in_milliseconds": 10,
    "remote_ip": "111.111.111.111",
    "signature": "U2FsdGVkX18z8cwGckH0vt8vfouyIM4UlzKO2bv8WYMTt5h1xvWgFZq2SOWpwoddhyuLqnb8j/jCMznOd7yybA=="
  },
  "data_count": 1,
  "data": [
    {
      "perdcomp": [
        {
          "perdcomp": "111111111111111111111111",
          "cnpj": "11111111111111",
          "cpf": "",
          "solicitante": "EXEMPLO DE NOME",
          "tipo_documento": "Declaração de Compensação",
          "tipo_credito": "Pagamento Indevido ou a Maior",
          "data_transmissao": "11/11/1111",
          "situacao": "Em análise",
          "situacao_detalhamento": "Recepcionado em procedimento de análise."
        }
      ],
      "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/perdcomp'
args = {
  "cpf":      "VALOR_DO_PARAMETRO_CPF",
  "cnpj":     "VALOR_DO_PARAMETRO_CNPJ",
  "perdcomp": "VALOR_DO_PARAMETRO_PERDCOMP",
  "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.