> ## 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 JD Courier

> O JD Courier responde com problem details da RFC 9457 na API do operador e na API dos motores. Consulte um código JDC-NNNN para saber o que ele significa.

**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](https://docs.lerian.studio/pt/interfaces/jd-courier/jd-courier-routing.md) descreve. O trânsito Pix traz um código apenas no resultado da validação de conta.

```json application/problem+json theme={null}
{
  "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, o achado 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, uma das credenciais dele ou a aplicação a desvincular 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, um ciclo encontrou o achado de conciliação de novo depois da sua leitura, 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-0117 | Outro tenant detém o trilho ativo. |
| JDC-0118 | Relay entre cores: nenhum motor é dono da conta do recebedor. Nada foi enviado. |
| JDC-0119 | Relay entre cores: o dono da conta do recebedor não é o motor em `X-Courier-Expected-Owner`. Nada foi enviado. |
| JDC-0121 | Relay entre cores: a conta do recebedor pertence ao motor que chama. Nada foi enviado. |
| JDC-0202 | A mensagem não está mais retida. |
| JDC-0303 | O envio não é um envio indeterminado aberto: ele tem um veredito, ou um operador já o fechou. |
| JDC-0503 | Trânsito Pix: o crédito já tem um resultado de validação de conta diferente. O primeiro resultado prevalece. |
| 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 pode ser usada: 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-0304 | Você não pode suspender o trilho. A JD envia as mensagens deste trilho. Pare o trilho na JD. |

### 500

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

### 503

| `code` | Significado |
| - | - |
| JDC-0120 | Relay entre cores: o motor dono está desabilitado, não tem endereço para o trilho ou não aceitou a chamada. Nada foi enviado. |
| 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. |


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