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

> JD Courier responde con problem details de la RFC 9457 en la API del operador y en la API de los motores. Busca un código JDC-NNNN para saber qué significa.

**Formato de error**

La API del operador y la API de los motores de JD Courier responden a un error con un problem detail de la RFC 9457, con el media type `application/problem+json`. Cada error lleva un código `JDC-NNNN` en el campo `code`. Compara por el código, no por el texto.

La interfaz SOAP y la dirección Pix no llevan códigos `JDC-NNNN`. En esas superficies, JD y los motores reciben las respuestas que describe [Cómo funciona el enrutamiento](/es/interfaces/jd-courier/jd-courier-routing).

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

**Definiciones de campo**

* **`type`** – Un URI que identifica el código de error.
* **`title`** – El texto del estado HTTP.
* **`status`** – El código de estado HTTP.
* **`detail`** – La explicación de esta ocurrencia del error.
* **`code`** – Un identificador estable del error (`JDC-NNNN`). Úsalo para el manejo programático y para las solicitudes de soporte.
* **`errors`** – Opcional. Una lista de errores de campo, cada uno con un `location` y un `message`.
* **`instance`** – Opcional. El identificador de esta ocurrencia.

## Errores de JD Courier

***

### 400

| `code` | Significado |
| - | - |
| JDC-0001 | La solicitud no es válida: un cuerpo mal formado, un campo fuera de su rango, o un encabezado `X-Idempotency` ausente o demasiado largo. |

### 401

| `code` | Significado |
| - | - |
| JDC-0401 | Se requiere autenticación para acceder a este recurso. |

### 403

| `code` | Significado |
| - | - |
| JDC-0405 | No tienes permiso para acceder a este recurso. |
| JDC-0406 | El tenant de quien llama está suspendido o purgado. |

### 404

| `code` | Significado |
| - | - |
| JDC-0004 | No se encontró el recurso: por ejemplo, el riel, el ciclo de conciliación, la detención del canal o el mensaje SPB. |
| JDC-0103 | No se encontró la asignación de titularidad. |
| JDC-0109 | No se encontró el motor, o su credencial del canal SOAP. |
| JDC-0201 | No se encontró el mensaje retenido. |
| JDC-0302 | El registro de envíos no tiene este número de control. |

### 409

| `code` | Significado |
| - | - |
| JDC-0003 | La clave `X-Idempotency` se usó antes con un cuerpo distinto. |
| JDC-0008 | La solicitud entra en conflicto con el estado actual: por ejemplo, el canal no está detenido, o una solicitud con la misma clave `X-Idempotency` todavía está en curso. |
| JDC-0102 | Otro motor es dueño de la clave. Para cambiar el dueño, mueve la clave. |
| JDC-0107 | Ya hay un motor registrado con este ID. |
| JDC-0114 | Otro motor ya usa este subject de credencial. |
| JDC-0116 | El registro del Courier le da esta etapa de Pix Automático a otro motor. Detente e informa a un operador. |
| JDC-0202 | El mensaje ya no está retenido. |
| JDC-0301 | Otro motor ya está en bypass en este riel. |
| JDC-0303 | El envío no es un envío indeterminado abierto: tiene un veredicto, o un operador ya lo cerró. |
| JDC-0601 | Ya se ejecuta un ciclo de conciliación en este riel. |

### 413

| `code` | Significado |
| - | - |
| JDC-0006 | El cuerpo de la solicitud es más grande que el límite. |

### 422

| `code` | Significado |
| - | - |
| JDC-0002 | Un campo viola una regla: por ejemplo, un valor en blanco o una nota fuera de su longitud. |
| JDC-0101 | El motor de destino no está registrado. |
| JDC-0104 | La clave no se puede usar: está en blanco, es demasiado larga o está mal formada para su tipo. |
| JDC-0105 | El motor de destino está deshabilitado. |
| JDC-0106 | El ID del motor no coincide con `^[a-z0-9-]{1,32}$`. |
| JDC-0108 | Una solicitud de deshabilitación no tiene motivo. |
| JDC-0110 | El código del mensaje es un código de dinero del riel. No puede tener un modo de entrega. |
| JDC-0112 | El riel no acepta este modo de entrega. |
| JDC-0113 | El mensaje no se enrutó a este motor, así que no se le puede servir de nuevo. |
| JDC-0115 | El motor de destino ya es dueño de la clave. |
| JDC-0204 | El motivo de la retención es sobre el propio mensaje, así que una nueva decisión de enrutamiento no puede liberarlo. |
| JDC-0501 | El riel no tiene bypass. |

### 500

| `code` | Significado |
| - | - |
| JDC-9000 | Ocurrió un error inesperado. |

### 503

| `code` | Significado |
| - | - |
| JDC-0902 | La licencia está revocada. El proceso responde a sus sondas y rechaza las otras solicitudes hasta que la licencia vuelva a ser válida. |
| JDC-9001 | Una dependencia del Courier no está disponible. Reintenta más tarde. En la consulta de titularidad, falla el pago. |

### Otros 4xx

| `code` | Significado |
| - | - |
| JDC-0007 | La solicitud falló con un estado 4xx que no tiene código específico. El campo `status` lleva el estado. |

## Rechazo en el arranque

***

Este código no aparece en una respuesta HTTP. El proceso lo escribe en su log y se detiene en el arranque.

| `code` | Significado |
| - | - |
| JDC-0314 | El rol `spb-consumer` comparte un proceso con otro rol. Ejecuta `spb-consumer` solo. |


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