> ## Documentation Index
> Fetch the complete documentation index at: https://docs.lerian.studio/llms.txt
> Use this file to discover all available pages before exploring further.

# Lista de erros do TED Lerian

> O **TED Lerian** retorna respostas de erro estruturadas com um código estável, para que você identifique o que deu errado e como corrigir.

**Formato do erro**

Cada erro é um body `application/problem+json` (RFC 9457) com um `code` estável. Trate os erros pelo `code`; o texto de `detail` pode mudar.

```json JSON theme={null}
{
  "type": "about:blank",
  "title": "Unprocessable Entity",
  "status": 422,
  "detail": "Daily limit exceeded for the source account",
  "code": "TED-0030"
}
```

**Definições de campo**

* **`code`** – Um identificador estável do erro, no formato `TED-NNNN`.
* **`title`** – Um resumo curto do tipo de problema.
* **`status`** – O código de status HTTP.
* **`detail`** – Uma explicação legível desta ocorrência.
* **`type`** – Uma referência ao tipo de problema. O padrão é `about:blank`.
* **`instance`** – Opcional. Uma referência a esta ocorrência.
* **`errors`** – Opcional. Uma entrada para cada campo rejeitado, com `location`, `message` e `value`.
* **`upstream`** – Opcional. O erro que um provedor intermediado reportou, com o seu próprio `code` e `message`, literalmente.

Cada resposta, de sucesso ou de erro, traz o header `X-Request-Id`. Inclua-o nas solicitações de suporte.

## Erros do TED Lerian

***

Os erros a seguir podem ocorrer quando você chama os endpoints do TED Lerian. `TED-0031`, `TED-1011` e `TED-1013` nunca são respostas de erro: eles chegam em `rejection.code` de uma transferência com status `REJECTED`. Em um envio, `TED-1001` chega da mesma forma. Se você repetir um `POST /v1/transfers` cuja primeira tentativa ficou sem resposta, qualquer recusa ainda pode significar que a primeira tentativa criou a transferência: consulte-a com `GET /v1/transfers` antes de enviá-la com uma chave nova.

| Código | HTTP | Título | Quando acontece | Como corrigir |
| - | - | - | - | - |
| `TED-0001` | 400 | Bad Request | O JSON está malformado ou um tipo é inválido. | Corrija o body da requisição. |
| `TED-0002` | 422 | Validation Failed | Um campo obrigatório está ausente ou fora do formato (veja `errors`). | Corrija os campos listados. |
| `TED-0003` | 422 | Invalid Purpose Code | `purposeCode` está fora do domínio oficial. | Use um código de 5 dígitos do dicionário de domínios do SFN. |
| `TED-0004` | 422 | Description Required | `purposeCode=99999` sem `description`. | Envie `description`. |
| `TED-0005` | 422 | Recipient Bank Required | Nem `bankId` nem `bankCode` foi enviado, ou os dois foram. | Envie exatamente um. |
| `TED-0006` | 422 | Unknown Participant | `bankCode` ou `bankId` não está na relação de participantes do STR. | Verifique com `GET /v1/participants`. |
| `TED-0007` | 422 | Document Mismatch | O documento não é um CPF (11 dígitos) nem um CNPJ (14 dígitos), somente com dígitos. | Corrija o documento. |
| `TED-0008` | 400 | Account Header Required | `X-Account-Id` está ausente ou não é um UUID. | Envie `X-Account-Id` com a conta de origem. |
| `TED-0009` | 403 | Account Not Owned | `X-Account-Id` não pertence à organização da identidade autenticada. | Use uma conta da sua própria organização. |
| `TED-0010` | 404 | Not Found | O recurso não existe na instituição. | Verifique o identificador. |
| `TED-0011` | 400 | Idempotency Key Required | `X-Idempotency` está ausente em uma requisição com efeito. | Envie o header. |
| `TED-0012` | 422 | Idempotency Key Reuse | A mesma chave com um body diferente. No `POST /v1/transfers`, também uma chave que já criou uma transferência, inclusive depois da janela do `X-TTL`. | Um recurso já pode existir para essa chave. Consulte-o antes de usar uma chave nova (para uma transferência, `GET /v1/transfers` filtrado por `client_reference`, ou por `account_id` e data). |
| `TED-0013` | 409 | Idempotent Request In Flight | Uma requisição com a mesma chave ainda está em andamento. | Tente de novo após `Retry-After`. |
| `TED-0014` | 409 | Duplicate Request | Uma requisição materialmente idêntica enviada pouco depois de outra. | Aguarde ou leia a transferência existente. |
| `TED-0015` | 409 | Reconciliation Already Running | Um ciclo de conciliação já está em execução. | Aguarde o ciclo em execução terminar. |
| `TED-0020` | 422 | Outside Operating Window | Fora do horário oficial ou depois do cut-off da instituição. | Envie de novo na próxima janela (`GET /v1/policy/window`). |
| `TED-0021` | 422 | Non-Business Day | Fim de semana ou feriado bancário. | Envie de novo no próximo dia útil. |
| `TED-0022` | 503 | Operating Window Undetermined | A grade horária, o calendário ou a configuração está indisponível. O TED Lerian recusa em vez de adivinhar. | Tente de novo. |
| `TED-0030` | 422 | Usage Limit Exceeded | O limite por transferência, diário ou mensal foi excedido. | Reduza o valor ou aguarde a virada do período. |
| `TED-0031` | — | Insufficient Balance | A conta de origem não tem saldo suficiente. | Ajuste o valor. |
| `TED-0040` | 503 | Fee Calculation Unavailable | O cálculo de tarifa está indisponível e a política da instituição não permite enviar sem tarifa. | Tente de novo. |
| `TED-0060` | 409 | Invalid State Transition | A ação não combina com o status atual. | Leia o status e escolha a ação certa. |
| `TED-0061` | 409 | Not Cancellable | A transferência está liquidada, é recebida, já está em status final, ou está aguardando conciliação ou esgotada (o status real é desconhecido). | Use uma devolução quando ela se aplicar; para aguardando conciliação ou esgotada, use `POST /v1/transfers/{transferId}/unblock` com evidência. |
| `TED-0062` | 409 | Not Returnable | O status não permite uma devolução. | — |
| `TED-0063` | 422 | Partial Return Not Allowed | Um valor parcial foi enviado. | As devoluções são sempre integrais. |
| `TED-0064` | 422 | Invalid Return Code | `returnCode` está fora do domínio oficial. | Use um `CodDevTransf` válido. |
| `TED-0065` | 422 | Evidence Required | Um destravamento sem evidência válida, ou sem `rejectionCode` quando `outcome=REJECTED`. | Envie a evidência do STR (e o código de rejeição quando ele se aplicar). |
| `TED-0066` | 422 | Return Code Required | Uma resolução de revisão manual com `action=RETURN` e sem `returnCode`. | Envie `returnCode`. |
| `TED-0067` | 409 | Held Return Carried By Transfer | Uma transferência que ainda pode liquidar carrega a devolução retida que você tentou encerrar. | Não a encerre: o TED Lerian devolve o valor ao remetente quando essa transferência liquidar. Estorne qualquer crédito que você fez no ledger para ela. |
| `TED-0070` | 401 | Unauthorized | O token está ausente, inválido ou expirado. | Autentique-se. |
| `TED-0071` | 403 | Forbidden | O papel não tem permissão para o recurso ou a ação, ou a licença do produto não é válida para a organização. | Solicite a permissão ou contate a Lerian sobre a licença. |
| `TED-0080` | 503 | Tenant Configuration Missing | Falta uma configuração obrigatória da instituição, como os limites de uso. | O administrador configura a política. |
| `TED-0081` | 422 | Cutoff After Official Close | O cut-off é posterior ao fechamento oficial. | Envie um horário igual ou anterior ao fechamento oficial. |
| `TED-1000` | 503 | Ledger Unavailable | O ledger não confirmou o resultado. A operação já pode estar no ledger. | Leia o status do recurso antes de agir de novo. |
| `TED-1001` | 422 | Ledger Rejected | O ledger recusou por uma regra de negócio (conta inativa, ativo, rota). | Verifique a conta e a configuração. |
| `TED-1010` | 503 | Rail Unavailable | A resposta do conector do STR a um cancelamento é desconhecida. A solicitação de cancelamento continua registrada. | Tente de novo com o mesmo `X-Idempotency` e o mesmo `reason`. |
| `TED-1011` | — | Rail Rejected | O conector recusou o comando por uma validação de protocolo. | Corrija os dados. |
| `TED-1012` | 503 | Rail Capability Unavailable | O conector não oferece a capacidade, como cancelar um lançamento pendente no STR. | Acompanhe a transferência até ela chegar a um status final. |
| `TED-1013` | — | Rail Closed Without STR Decision | O trilho encerrou a TED sem decisão do STR (alçada negada ou expirada). | Não altere os dados. Verifique a alçada ou o caso no trilho e envie uma nova TED se ainda for o caso. |
| `TED-1020` | 503 | Account Registry Unavailable | O cadastro de contas está indisponível. | Tente de novo. |
| `TED-1021` | 422 | Account Not Found | A conta ou o seu titular não foi encontrado no cadastro. | Verifique os dados. |
| `TED-9000` | 500 | Internal Error | Uma falha inesperada. | Contate o suporte com o `X-Request-Id`. |
| `TED-9002` | 503 | Service Unavailable | O serviço está indisponível, por exemplo quando a trilha de auditoria não consegue registrar uma mudança de política. | Tente de novo mais tarde. |
| `TED-9003` | 413 | Request Entity Too Large | O body da requisição é maior do que o servidor HTTP aceita. | Envie um body menor. |
| `TED-9004` | 400 | Bad Request | O servidor HTTP recusa a requisição e nenhum outro código se aplica, por exemplo quando o caminho não aceita o método. O `detail` indica a causa. | Corrija a requisição. |


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.