Escrituração de Despesas · v1.0
Referência de Erros
Lista completa de todos os códigos de erro do endpoint de despesas, divididos em Erros de Requisição e Erros de Item.
Erros de Requisição interrompem o request inteiro (HTTP 400/403/404) e nenhum item do lote é processado. Erros de Item sempre retornam HTTP 200 — cada um aparece no array
errors da resposta, e os demais itens do lote continuam sendo processados normalmente.Erros de Requisição
| Código | HTTP | Descrição |
|---|---|---|
| EXPENSES_ERROR_001 | 400 | Corpo da requisição ausente ou inválido. |
| EXPENSES_ERROR_002 | 400 | O campo 'identificador' não corresponde ao token de acesso utilizado. |
| EXPENSES_ERROR_003 | 400 | O campo 'issuer_code' é obrigatório. |
| EXPENSES_ERROR_004 | 404 | Emissor não encontrado para o identificador informado. |
| EXPENSES_ERROR_005 | 403 | O emissor está desativado. Ative-o antes de registrar despesas. |
| EXPENSES_ERROR_006 | 400 | O campo 'expenses' está ausente ou não é um array. |
| EXPENSES_ERROR_007 | 400 | O campo 'expenses' foi enviado como um array vazio. |
| EXPENSES_ERROR_019 | 403 | Nenhum endpoint de callback registrado. Obrigatório fora do ambiente sandbox. |
Erros de Item
| Código | HTTP | Descrição |
|---|---|---|
| EXPENSES_ERROR_008 | 200 | O item não é um objeto JSON válido. |
| EXPENSES_ERROR_009 | 200 | O campo 'id' está ausente ou não é um número inteiro. |
| EXPENSES_ERROR_010 | 200 | O mesmo 'id' aparece mais de uma vez no array 'expenses' do mesmo request. |
| EXPENSES_ERROR_011 | 200 | Já existe uma despesa registrada com esse 'id' para este emissor (de um request anterior). |
| EXPENSES_ERROR_012 | 200 | O campo 'date' está ausente ou não segue o formato AAAA-MM-DD. |
| EXPENSES_ERROR_013 | 200 | A data informada é posterior à data atual. |
| EXPENSES_ERROR_014 | 200 | O campo 'accountCode' não segue o padrão A00.00.00000. |
| EXPENSES_ERROR_015 | 200 | O campo 'value' está ausente ou foi enviado como string. |
| EXPENSES_ERROR_016 | 200 | O 'value' é zero, negativo, ou excede o valor máximo permitido (99.999.999,99). |
| EXPENSES_ERROR_017 | 200 | O campo 'description' está ausente, vazio, ou excede 255 caracteres. |
| EXPENSES_ERROR_018 | 200 | Erro interno ao salvar este item especificamente. Tente reenviar apenas ele. |
Documentação — Escrituração de Despesas · Versão 1.0
Última atualização: 29 de julho de 2026