Lista de erros do TED Lerian

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.

{
  "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.

Visão geral

API de Transferências

API de TEDs recebidas

API de Conciliação

API de Operações

API de Políticas

API de Participantes

Tratamento de erros

Lista de erros do TED Lerian

Erros do TED Lerian

​Erros do TED Lerian

Erros do TED Lerian