El mapa de titularidad
El mapa de titularidad es una lista de claves. Cada clave tiene un motor dueño. Un operador crea y cambia el mapa a través de la API de titularidad. El Courier rechaza un segundo dueño para una clave con
409 JDC-0102. Para cambiar el dueño, el operador mueve la clave.
El mapa acepta siete tipos de clave:
Los tipos que el enrutamiento entrante no usa están disponibles para los motores a través de la consulta de titularidad. Un motor usa la consulta para saber si otro motor es dueño del destino de un pago.
El Courier normaliza cada valor de clave. Por ejemplo, quita la puntuación de un CPF y los ceros a la izquierda de una agencia. Envía el valor como lo guardas.
Cada cambio en el mapa escribe una entrada en el historial de auditoría de la clave, en la misma transacción. La entrada registra quién hizo el cambio, cuándo, el dueño anterior y el nuevo dueño. Un movimiento también registra su motivo. Puedes leer el historial de una clave después de su eliminación, a través de la consulta de auditoría por clave.
Enrutamiento en el riel SPB
El rol
spb-consumer lee los mensajes SPB que JD guarda para tu institución. El Courier guarda cada mensaje antes de decidir la ruta. Después, aplica estas reglas, en orden:
- Registro de envíos. Cuando el número de control (
NumCtrlIF) del mensaje coincide con un envío del registro de envíos, el mensaje va al motor que hizo el envío. Esta regla enruta las respuestas a los mensajes que un motor envió. - Mapa de titularidad. El Courier lee la cuenta acreditada del mensaje: agencia y cuenta, o la cuenta de pago. Cuando el mapa tiene un dueño para esa cuenta, el mensaje va al dueño.
- Modo de entrega. Cuando el mapa no tiene dueño, el Courier lee el modo de entrega declarado para el código del mensaje. Esta regla nunca se aplica a los códigos de dinero
STR0008,STR0008R1,STR0008R2,STR0010,STR0010R1ySTR0010R2. - Retención. Cuando ninguna regla decide, el Courier retiene el mensaje.
DELIVERY_FAILED.
El Courier no empuja mensajes SPB a los motores. Cada motor le pide sus mensajes al Courier por la misma interfaz SOAP que usa con JD. El Courier responde con el mensaje más antiguo que espera a ese motor. Para los detalles, consulta Conectar un motor.
Modos de entrega
Un modo de entrega se aplica a un código de mensaje SPB. Un operador lo declara con un motivo. Hay dos modos:ALL_ENGINES: el mensaje va a cada motor habilitado.REFUSE: el mensaje no va a ningún motor. El Courier lo guarda, con el estadoREFUSED.
422 JDC-0110. Una declaración revocada sigue legible como historial. El riel Pix no acepta declaraciones.
Reentrega
Un operador puede servir de nuevo un mensaje SPB a uno de los motores a los que se enrutó el mensaje. El Courier no le pregunta de nuevo a JD. La siguiente solicitud del motor recibe el mensaje guardado, con su número de secuencia original. Tu operador da un motivo, y el Courier lo registra.Bypass
Un bypass es el estado en el que un motor se conecta de nuevo a JD directamente, fuera del Courier. Un operador declara un bypass en el riel SPB con el motor y un motivo. Mientras un bypass está activo, el Courier no lee de JD en ese riel. Tampoco enruta ni verifica de nuevo los mensajes SPB. Un ciclo de conciliación que se ejecuta durante un bypass lista las garantías suspendidas. Como máximo un motor puede estar en bypass en un riel. El riel Pix no tiene bypass.Enrutamiento en el riel Pix
JD envía las llamadas Pix entrantes de tu institución a la dirección que sirve el rol
pix-ingress. El Courier decide el dueño durante la llamada, entrega la llamada al motor y reenvía a JD la respuesta del motor.
JD hace dos tipos de llamada:
- Preguntas. JD espera una respuesta antes de continuar: validación de cuenta, el bloqueo del débito de Pix Automático y las validaciones de autorización y de agendamiento. El Courier no retiene una pregunta.
- Mensajes. JD informa un hecho: cash-in, devolución y los registros, las liquidaciones y los eventos de Pix Automático. El Courier puede retener un mensaje.
Qué clave enruta cada llamada
Tus ISPBs son los ISPBs participantes que el operador registra en los motores.
Las llamadas de Pix Automático que siguen una etapa anterior necesitan un registro de esa etapa. El Courier registra las etapas anteriores que entrega. Para los pagos en curso antes de que el Courier reciba Pix, cada motor declara sus etapas. Consulta Conectar un motor.
Qué recibe JD
Cuando el motor responde a un mensaje con un estado
5xx, 408 o 429, el Courier reenvía esa respuesta a JD y retiene el mensaje. El siguiente reenvío de JD llega de nuevo al motor. Cuando el motor responde con un estado 3xx, 401 o 403, o no responde, JD recibe 503 y el Courier retiene el mensaje.
Mensajes retenidos
Un mensaje retenido queda en la base de datos del Courier con su motivo. El Courier no lo acredita, no lo devuelve a BACEN y no lo elimina. Tu operador lista los mensajes retenidos, del más antiguo al más nuevo, a través de la API de retenidos. La lista muestra el motivo y los horarios. No muestra el contenido del mensaje.
Cómo sale un mensaje retenido
El Courier verifica de nuevo cada mensaje retenido con una causa de enrutamiento o de entrega, como máximo una vez por minuto. Cuando la causa desaparece, el mensaje sale por su cuenta. Por ejemplo, un operador asigna la cuenta, o habilita de nuevo el motor dueño. En Pix, un reenvío de JD también ejecuta la decisión de nuevo. Un operador también puede pedir una reevaluación con un motivo. El Courier registra quién la pidió, cuándo y por qué, y verifica el mensaje primero. La reevaluación ejecuta las mismas reglas de enrutamiento que un mensaje nuevo. El operador nunca elige el motor. El Courier rechaza una reevaluación para el motivoCLASSIFICATION_FAILED con 422 JDC-0204.
Cuando el Courier libera un mensaje Pix, JD no está en la llamada. El Courier guarda la respuesta del motor y se la da a JD en el siguiente reenvío.
Envíos a JD y el registro de envíos
Los motores envían sus mensajes SPB a JD a través del rol
spb-sender. El Courier escribe cada envío en el registro de envíos antes de que el envío salga. Después, envía el mensaje a JD una vez y reenvía al motor la respuesta de JD. El Courier nunca envía un mensaje de nuevo por su cuenta.
El registro de envíos registra uno de estos resultados para cada envío:
El Courier acepta cada número de control una vez para cada tenant. Un envío con el resultado
NOT_SENT no cuenta. Un segundo envío del mismo número de control no llega a JD.
Un envío indeterminado recibe su respuesta cuando el motor consulta a JD sobre él a través del Courier. Para tratar los envíos indeterminados que quedan, consulta Operación diaria.