Lista de errores de JD Courier

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.

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

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.

Motores

Mapa de titularidad

API de los motores

Canales

Mensajes

Registro de envíos

Conciliación

Manejo de errores

Lista de errores de JD Courier

Errores de JD Courier

400

401

403

404

409

413

422

500

503

Otros 4xx

Rechazo en el arranque

​Errores de JD Courier

​400

​401

​403

​404

​409

​413

​422

​500

​503

​Otros 4xx

​Rechazo en el arranque

Errores de JD Courier

400

401

403

404

409

413

422

500

503

Otros 4xx

Rechazo en el arranque