admin.
Motores
Registra cada motor una vez, a través de la API de motores. 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 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 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 con el tipo y el valor de la clave. Para leer los cambios de una clave, usa su historial de auditoría. Cuando eliminas una clave, 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 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 todos los días. Para estos motivos, corrige la causa:
Cuando la causa desaparece, el mensaje sale por su cuenta en la siguiente verificación. Para verificarlo primero, pide una reevaluación 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.
- Lee el motivo de la detención en la lista de canales.
- Verifica con JD si la lectura eliminó un mensaje que el Courier no recibió.
- Levanta la detención 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 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. 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.
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 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.
409 JDC-0601.