Lista de erros do JD Courier

Formato de erro A API do operador e a API dos motores do JD Courier respondem a um erro com um problem detail da RFC 9457, com o media type application/problem+json. Cada erro traz um código JDC-NNNN no campo code. Compare pelo código, não pelo texto. A interface SOAP e o endereço Pix não trazem códigos JDC-NNNN. Nessas superfícies, a JD e os motores recebem as respostas que Como o roteamento funciona descreve.

{
  "type": "https://errors.lerian.studio/v1/JDC-0102",
  "title": "Conflict",
  "status": 409,
  "detail": "<error_detail>",
  "code": "JDC-0102"
}

Definições de campo

type – Um URI que identifica o código de erro.
title – O texto do status HTTP.
status – O código de status HTTP.
detail – A explicação desta ocorrência do erro.
code – Um identificador estável do erro (JDC-NNNN). Use-o para o tratamento programático e para os pedidos de suporte.
errors – Opcional. Uma lista de erros de campo, cada um com um location e uma message.
instance – Opcional. O identificador desta ocorrência.

Erros do JD Courier

400

`code`	Significado
JDC-0001	A requisição não é válida: um corpo malformado, um campo fora do intervalo, ou um header `X-Idempotency` ausente ou longo demais.

401

`code`	Significado
JDC-0401	A autenticação é necessária para acessar este recurso.

403

`code`	Significado
JDC-0405	Você não tem permissão para acessar este recurso.
JDC-0406	O tenant de quem chama está suspenso ou expurgado.

404

`code`	Significado
JDC-0004	O recurso não foi encontrado: por exemplo, o trilho, o ciclo de conciliação, a parada do canal ou a mensagem SPB.
JDC-0103	A atribuição de titularidade não foi encontrada.
JDC-0109	O motor, ou a credencial do canal SOAP dele, não foi encontrado.
JDC-0201	A mensagem retida não foi encontrada.
JDC-0302	O registro de envios não tem este número de controle.

409

`code`	Significado
JDC-0003	A chave `X-Idempotency` foi usada antes com um corpo diferente.
JDC-0008	A requisição conflita com o estado atual: por exemplo, o canal não está parado, ou uma requisição com a mesma chave `X-Idempotency` ainda está em andamento.
JDC-0102	Outro motor é dono da chave. Para mudar o dono, mova a chave.
JDC-0107	Um motor com este ID já está registrado.
JDC-0114	Outro motor já usa este subject de credencial.
JDC-0116	O registro do Courier dá esta etapa do Pix Automático a outro motor. Pare e informe a um operador.
JDC-0202	A mensagem não está mais retida.
JDC-0301	Outro motor já está em bypass neste trilho.
JDC-0303	O envio não é um envio indeterminado aberto: ele tem um veredito, ou um operador já o fechou.
JDC-0601	Um ciclo de conciliação já roda neste trilho.

413

`code`	Significado
JDC-0006	O corpo da requisição é maior que o limite.

422

`code`	Significado
JDC-0002	Um campo viola uma regra: por exemplo, um valor em branco ou uma nota fora do tamanho.
JDC-0101	O motor de destino não está registrado.
JDC-0104	A chave não é utilizável: está em branco, é longa demais ou está malformada para o tipo.
JDC-0105	O motor de destino está desabilitado.
JDC-0106	O ID do motor não corresponde a `^[a-z0-9-]{1,32}$`.
JDC-0108	Uma requisição de desabilitação não tem motivo.
JDC-0110	O código da mensagem é um código de dinheiro do trilho. Ele não pode ter um modo de entrega.
JDC-0112	O trilho não aceita este modo de entrega.
JDC-0113	A mensagem não foi roteada para este motor, então ela não pode ser servida a ele de novo.
JDC-0115	O motor de destino já é dono da chave.
JDC-0204	O motivo da retenção é sobre a própria mensagem, então uma nova decisão de roteamento não pode liberá-la.
JDC-0501	O trilho não tem bypass.

500

`code`	Significado
JDC-9000	Ocorreu um erro inesperado.

503

`code`	Significado
JDC-0902	A licença está revogada. O processo responde aos probes e recusa as outras requisições até a licença ficar válida de novo.
JDC-9001	Uma dependência do Courier está indisponível. Tente de novo mais tarde. Na consulta de titularidade, falhe o pagamento.

Outros 4xx

`code`	Significado
JDC-0007	A requisição falhou com um status 4xx que não tem código específico. O campo `status` traz o status.

Recusa no boot

Este código não aparece em uma resposta HTTP. O processo o escreve no log e para no boot.

`code`	Significado
JDC-0314	O papel `spb-consumer` compartilha um processo com outro papel. Rode `spb-consumer` sozinho.

Motores

Mapa de titularidade

API dos motores

Canais

Mensagens

Registro de envios

Conciliação

Tratamento de erros

Lista de erros do JD Courier

Erros do JD Courier

400

401

403

404

409

413

422

500

503

Outros 4xx

Recusa no boot

​Erros do JD Courier

​400

​401

​403

​404

​409

​413

​422

​500

​503

​Outros 4xx

​Recusa no boot

Erros do JD Courier

400

401

403

404

409

413

422

500

503

Outros 4xx

Recusa no boot