Extensão Contador · v1.0
Referência de Erros
Lista completa de todos os códigos de erro retornados pelos endpoints da Extensão Contador, agrupados por endpoint.
Todos os erros retornam um JSON com os campos
error_code e error_message. O código HTTP indica a categoria do erro:4xx erros do cliente · 5xx erros internos do servidor./receipts/pdf-request| Código | HTTP | Descrição |
|---|---|---|
| RECEIPT_QUERY_ERROR_001 | 400 | Corpo da requisição ausente ou inválido. |
| RECEIPT_QUERY_ERROR_002 | 400 | O campo 'identificador' não corresponde ao token de acesso utilizado. |
| RECEIPT_QUERY_ERROR_003 | 400 | Os campos 'issuer_code' e 'receipt_number' são obrigatórios. |
| RECEIPT_QUERY_ERROR_008 | 404 | Emissor não encontrado para o identificador informado. |
| RECEIPT_QUERY_ERROR_009 | 403 | O emissor está desativado. |
| RECEIPT_QUERY_ERROR_010 | 403 | Nenhum certificado digital registrado (não se aplica ao sandbox). |
| RECEIPT_QUERY_ERROR_011 | 403 | Certificado digital expirado (não se aplica ao sandbox). |
| RECEIPT_QUERY_ERROR_012 | 403 | Nenhum endpoint de callback registrado (não se aplica ao sandbox). |
| RECEIPT_QUERY_ERROR_013 | 500 | Erro interno ao registrar a solicitação. Tente novamente mais tarde. |
/receipts/list-request| Código | HTTP | Descrição |
|---|---|---|
| RECEIPT_QUERY_ERROR_001 | 400 | Corpo da requisição ausente ou inválido. |
| RECEIPT_QUERY_ERROR_002 | 400 | O campo 'identificador' não corresponde ao token de acesso utilizado. |
| RECEIPT_QUERY_ERROR_006 | 400 | Os campos 'issuer_code', 'start_date' e 'end_date' são obrigatórios. |
| RECEIPT_QUERY_ERROR_007 | 400 | Formato de data inválido. Utilize o formato AAAA-MM-DD. |
| RECEIPT_QUERY_ERROR_014 | 400 | 'start_date' e 'end_date' devem estar no mesmo ano-calendário. |
| RECEIPT_QUERY_ERROR_015 | 400 | O intervalo entre 'start_date' e 'end_date' não pode exceder 3 meses. |
| RECEIPT_QUERY_ERROR_016 | 400 | 'start_date' não pode ser posterior a 'end_date'. |
| RECEIPT_QUERY_ERROR_008 | 404 | Emissor não encontrado para o identificador informado. |
| RECEIPT_QUERY_ERROR_009 | 403 | O emissor está desativado. |
| RECEIPT_QUERY_ERROR_010 | 403 | Nenhum certificado digital registrado (não se aplica ao sandbox). |
| RECEIPT_QUERY_ERROR_011 | 403 | Certificado digital expirado (não se aplica ao sandbox). |
| RECEIPT_QUERY_ERROR_012 | 403 | Nenhum endpoint de callback registrado (não se aplica ao sandbox). |
| RECEIPT_QUERY_ERROR_013 | 500 | Erro interno ao registrar a solicitação. Tente novamente mais tarde. |
Documentação — Extensão Contador · Versão 1.0
Última atualização: 29 de julho de 2026