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

# Operación diaria

> El trabajo diario del operador de JD Courier: motores, el mapa de titularidad, movimientos de cuentas, mensajes retenidos, la detención del canal SPB, envíos indeterminados y conciliación.

Esta página es para el operador de tu institución que opera el Courier. Cada tarea usa la API del operador que sirve el rol `admin`.

## Motores

***

Registra cada motor una vez, a través de la [API de motores](/es/reference/interfaces/jd-courier/register-an-engine). Un motor tiene un ID, un nombre visible, sus ISPBs participantes y, para Pix, la dirección en la que recibe las llamadas Pix.

No existe eliminación. Para detener un motor, [deshabilítalo](/es/reference/interfaces/jd-courier/enable-disable-or-rename-an-engine) con un motivo. Un motor deshabilitado no recibe nuevas entregas ni nuevas claves. Mantiene las claves de las que es dueño, así que los mensajes nuevos de esas claves quedan retenidos hasta que habilites el motor de nuevo o muevas las claves.

## El mapa de titularidad

***

[Asigna](/es/reference/interfaces/jd-courier/assign-a-key-to-an-engine) cada cuenta a su motor antes de que el Courier reciba mensajes para ella. Un mensaje para una cuenta sin dueño queda retenido. En Pix Automático, asigna también el CNPJ de cada cobrador que atiende tu institución. Cada motor reclama sus propias recurrencias.

Para encontrar el dueño de una clave, [lista las asignaciones](/es/reference/interfaces/jd-courier/list-ownership-assignments) con el tipo y el valor de la clave. Para leer los cambios de una clave, usa su [historial de auditoría](/es/reference/interfaces/jd-courier/ownership-history-for-one-key).

Cuando [eliminas una clave](/es/reference/interfaces/jd-courier/unassign-a-key), los mensajes de esa clave quedan retenidos. El Courier no los acredita y no los devuelve a BACEN.

## Mover cuentas entre motores

***

Una ola de migración mueve cuentas de un motor a otro. [Mueve cada clave](/es/reference/interfaces/jd-courier/move-a-key-to-another-engine) con un motivo. El Courier registra el dueño anterior y el motivo en el historial de auditoría. Después del movimiento, la siguiente consulta responde el nuevo dueño.

Algunos mensajes no siguen el movimiento:

* En SPB, la respuesta a un envío va al motor que hizo el envío.
* En Pix, un mensaje que un intento anterior envió al dueño anterior queda retenido. El Courier no lo envía al nuevo dueño.
* En Pix Automático, un débito, su reversión y un estado de cancelación del agendamiento se quedan con el motor que tiene el bloqueo o el agendamiento.

## Mensajes retenidos

***

Revisa los [mensajes retenidos](/es/reference/interfaces/jd-courier/list-retained-messages) todos los días. Para estos motivos, corrige la causa:

| Motivo | Qué hacer |
| - | - |
| `ACCOUNT_UNASSIGNED` | Asigna la clave a su motor. En Pix Automático, pide al motor que reclame la recurrencia o que declare la etapa anterior. |
| `DELIVERY_FAILED` | Revisa el motor, su dirección Pix y su credencial. |
| `UNRECOGNIZED_TYPE` | Para un código que no es de dinero, declara un [modo de entrega](/es/interfaces/jd-courier/jd-courier-routing#delivery-modes) para el código. |
| `OWNERSHIP_DECISION_UNAVAILABLE` | Confirma que la base de datos del Courier está disponible y que los motores declaran sus ISPBs participantes. |

Cuando la causa desaparece, el mensaje sale por su cuenta en la siguiente verificación. Para verificarlo primero, [pide una reevaluación](/es/reference/interfaces/jd-courier/run-a-retained-message-s-routing-decision-again) con un motivo. Tú no eliges el motor: lo eligen las reglas de enrutamiento.

## Detención del canal SPB

***

El rol `spb-consumer` detiene el canal SPB cuando una lectura de JD puede haber eliminado un mensaje que el Courier no recibió. Por ejemplo, JD responde con un estado `5xx` distinto de `503`, o la lectura agota el tiempo después de que salió la solicitud. La detención interrumpe los mensajes SPB entrantes para cada motor.

Mientras el canal está detenido, el Courier no lee de JD, no enruta y no verifica de nuevo los mensajes SPB retenidos. Un reinicio no levanta la detención.

1. Lee el motivo de la detención en la [lista de canales](/es/reference/interfaces/jd-courier/list-the-registered-rails-their-declared-properties-and-their-state).
2. Verifica con JD si la lectura eliminó un mensaje que el Courier no recibió.
3. [Levanta la detención](/es/reference/interfaces/jd-courier/lift-a-durable-channel-halt) con una nota de 10 a 500 caracteres sobre lo que verificaste.

## Envíos indeterminados

***

Un envío indeterminado es un envío SPB que salió del Courier sin un veredicto de JD. Una consulta del motor con `ConsultaNumCtrlIF` puede resolverlo. Para ver los envíos que siguen abiertos, [lista el registro de envíos](/es/reference/interfaces/jd-courier/list-spb-sends) con `open=true`.

Cuando encuentras el resultado fuera del Courier, por ejemplo con el motor o con el soporte de JD, [cierra el envío manualmente](/es/reference/interfaces/jd-courier/close-an-indeterminate-send-by-hand). Da una referencia a la evidencia y una nota.

El cierre es solo un registro:

* El resultado sigue siendo `INDETERMINATE`.
* El número de control sigue bloqueado para un nuevo envío.
* Una consulta posterior del motor todavía va a JD.
* El envío ya no cuenta como un envío abierto.

El Courier no tiene cierre como `NOT_SENT`. Si un operador se equivocara sobre un envío que "nunca salió", un segundo envío del mismo número de control podría llegar a BACEN.

## Conciliación

***

El rol `admin` ejecuta un ciclo de conciliación para cada riel cada minuto. Un ciclo revisa una ventana de tiempo pasada. El [informe de conciliación](/es/reference/interfaces/jd-courier/reconciliation-report-for-a-rail) muestra estos conteos:

* **Esperados**: los resultados que esperan los mensajes de la ventana.
* **Completados**: las entregas a los motores, para cada motor.
* **Retenidos**: los mensajes que siguen retenidos.
* **Rechazados**: los mensajes rechazados por un modo de entrega.

La divergencia es el conteo esperado menos los otros tres. Una divergencia distinta de cero es un posible mensaje perdido: investígala. El informe también lista los envíos SPB que JD aceptó y cuya respuesta no llegó dentro de la ventana de retorno. Para ejecutar un ciclo ahora, [dispara uno](/es/reference/interfaces/jd-courier/trigger-a-reconciliation-cycle-for-a-rail). Un riel que ya ejecuta un ciclo responde `409 JDC-0601`.


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