## Receita Federal / Simples (Listagem de Períodos para Emissão de DAS)
Lista os Documentos de Arrecadação do Simples Nacional (DAS) de um Microempreendedor Individual (MEI) optante pelo SIMEI (Sistema de Recolhimento em Valores Fixos Mensais do Tributos do Simples Nacional) no ano informado, disponíveis para emissão.


### Site URL
- http://www8.receita.fazenda.gov.br/SimplesNacional/Aplicacoes/ATSPO/pgmei.app/Identificacao

### Request
POST endpoint: `https://api.infosimples.com/api/v2/consultas/receita-federal/listar-das`



| Parameter | Description                                                 |
| --------- | ----------------------------------------------------------- |
| token*    | The token that will authenticate and authorize the request. |
| cnpj*     | CNPJ of the company to be queried.                          |
| ano*      | Ano                                                         |

> * Required parameter.

> ** Optional parameter. Sometimes it is necessary to set at least one of the optional parameters for the service to work properly.


### Response examples (OK)
```json
{
  "code": 200,
  "code_message": "A requisição foi processada com sucesso.",
  "errors": [],
  "header": {
    "api_version": "v2",
    "api_version_full": "2.2.15-20231127175146",
    "product": "Consultas",
    "service": "receita-federal/listar-das",
    "parameters": {
      "ano": "2023",
      "cnpj": "12.345.678/9012-34"
    },
    "client_name": "Minha Empresa",
    "token_name": "Token de Produção",
    "billable": true,
    "price": "0.26",
    "requested_at": "2023-11-28T10:46:31.000-03:00",
    "elapsed_time_in_milliseconds": 546,
    "remote_ip": "111.111.111.111",
    "signature": "U2FsdGVkX19ysdYmOscEqsB/jhlpIkH+8AZJbWQH5QcuPeKuatOOsV/EUnKCSIbGQpVy89HIynbFvu3RS5o4MQ=="
  },
  "data_count": 1,
  "data": [
    {
      "anos_disponiveis": [
        "2018",
        "2019",
        "2020",
        "2021",
        "2022",
        "2023"
      ],
      "cnpj": "12.345.678/9012-34",
      "normalizado_cnpj": "12345678901234",
      "periodos": {
        "202310": {
          "periodo": "Outubro/2023",
          "apurado": "Sim",
          "situacao": "Devedor",
          "principal": "R$ 67,00",
          "multas": "R$ 1,77",
          "juros": "R$ 0,00",
          "total": "R$ 68,77",
          "data_vencimento": "11/11/1111",
          "data_acolhimento": "28/11/2023",
          "icms": "R$ 1,00",
          "iss": "R$ 0,00",
          "inss": "R$ 66,01",
          "normalizado_principal": 67.0,
          "normalizado_multas": 1.77,
          "normalizado_juros": 0.0,
          "normalizado_total": 68.77,
          "normalizado_icms": 1.0,
          "normalizado_iss": 0.0,
          "normalizado_inss": 66.01
        },
        "202311": {
          "periodo": "Novembro/2023",
          "apurado": "Sim",
          "situacao": "A Vencer",
          "principal": "R$ 67,00",
          "multas": "R$ 0,00",
          "juros": "R$ 0,00",
          "total": "R$ 67,00",
          "data_vencimento": "11/11/1111",
          "data_acolhimento": "20/12/2023",
          "icms": "R$ 1,00",
          "iss": "R$ 0,00",
          "inss": "R$ 66,01",
          "normalizado_principal": 67.0,
          "normalizado_multas": 0.0,
          "normalizado_juros": 0.0,
          "normalizado_total": 67.0,
          "normalizado_icms": 1.0,
          "normalizado_iss": 0.0,
          "normalizado_inss": 66.01
        },
        "202312": {
          "periodo": "Dezembro/2023",
          "apurado": "Sim",
          "situacao": "A Vencer",
          "principal": "R$ 67,00",
          "multas": "R$ 0,00",
          "juros": "R$ 0,00",
          "total": "R$ 67,00",
          "data_vencimento": "11/11/1111",
          "data_acolhimento": "22/01/2024",
          "icms": "R$ 1,00",
          "iss": "R$ 0,00",
          "inss": "R$ 66,01",
          "normalizado_principal": 67.0,
          "normalizado_multas": 0.0,
          "normalizado_juros": 0.0,
          "normalizado_total": 67.0,
          "normalizado_icms": 1.0,
          "normalizado_iss": 0.0,
          "normalizado_inss": 66.01
        }
      },
      "razao_social": "Exemplo de Razão Social",
      "site_receipt": "https://www.exemplo.com/exemplo-de-url"
    }
  ],
  "site_receipts": [
    "https://www.exemplo.com/exemplo-de-url"
  ]
}
```


### Preview file

The preview file (`site_receipts`) in the response JSON is **generated by the source (website/app)** that processed the automation.

### Code snippets


#### Python
```python
# Tested with: Python 3.10.19, Python 3.14.0
import requests

url = 'https://api.infosimples.com/api/v2/consultas/receita-federal/listar-das'
args = {
  "cnpj":    "VALUE_OF_PARAMETER_CNPJ",
  "ano":     "VALUE_OF_PARAMETER_ANO",
  "token":   "WRITE_YOUR_TOKEN_HERE",
  "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'])
```


## We are here to help
Do you still need to figure something out? Reach us at [suporte@infosimples.com.br](mailto:suporte@infosimples.com.br) and our highly qualified support team will be happy to help.