Integrador del back office (API del Merchant)

Módulo en desarrollo

FINORA Terminales POS todavía no forma parte de la versión instalada en el entorno de demostración. Esta ruta describe cómo vas a trabajar con él; las lecciones se comprobarán en el ambiente de prueba.

Quién eres

Eres del equipo técnico que conecta FINORA Merchant con el ERP. El Merchant le informa al ERP lo que pasa con los comercios y los terminales, y le consulta disponibilidad, cobranza y facturas. Tu trabajo es que esa conversación sea segura y que un reintento nunca duplique nada.

Lo que haces en FINORA

• Envías hechos (comercios, eventos de terminal, licencias, uso mensual, liquidaciones, foto diaria) con una clave de idempotencia y el hash de su contenido.
• Consultas la disponibilidad de un serial, el estado de cobranza y las facturas.
• Acusas las solicitudes de suspensión o bloqueo que el operador ejecutó.
• Vigilas la bandeja de la API y la deriva entre los dos sistemas.

Tu ruta

1. 1

   Qué puede vender y cobrar una comercializadora8 min

   La regla de la 049.20 que gobierna todo el módulo.

2. 2

   Cobranza y por qué la suspensión está apagada10 min

   Qué solicitudes vas a recibir y cuándo.

3. 3

   Contrato de la APIPróximamente

   Los once procesos, el JSON canónico, las claves, los códigos y el cliente de ejemplo. Está en la documentación técnica de FINORA LVE, no en la Academia.

Tu lista de cada día, semana y mes

Cada día

• Revisa el outbox: ninguna fila muerta sin explicación.
• Revisa la deriva entre el ERP y el Merchant.

Cada semana

• Revisa los rechazos de la bandeja de la API por código.

Cada mes

• Confirma que el uso del mes llegó completo, con todas sus partes.

Lo que se mide de tu trabajo

Indicador	Qué quiere decir	Buena señal
Conflictos de idempotencia	Una clave reutilizada con otro contenido	Ninguno
Hash inválido	El JSON del Merchant no se canoniza igual que en el ERP	Ninguno
Uso completo a tiempo	Todas las partes del mes antes de la corrida	Todos los comercios

Errores frecuentes

Lo que pasa	Por qué	Qué hacer
Reintentar con otra carga y la misma clave	Se recalculó el mensaje	La carga se guarda con la clave y no se recalcula
Montos con decimales	El monto viajó como número decimal	Los montos van en céntimos enteros
Un rechazo se reintenta para siempre	Se trató como error de red	Un rechazo de negocio da siempre el mismo resultado: alerta

Tu rol en el sistema

El usuario técnico del Merchant usa el rol de integración, que no tiene menú. No abre ventanas: solo ejecuta los procesos de la API y lee la tasa del BCV. Ninguna persona entra con ese rol. No tiene menú a propósito: un menú le daría ventanas, y por ellas el usuario técnico podría leer tablas del sistema que no necesita.