> ## 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](/pt/interfaces/jd-courier/jd-courier-routing) descreve.

<CodeGroup>
  ```json application/problem+json theme={null}
  {
    "type": "https://errors.lerian.studio/v1/JDC-0102",
    "title": "Conflict",
    "status": 409,
    "detail": "<error_detail>",
    "code": "JDC-0102"
  }
  ```
</CodeGroup>

**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. |


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