Sucursal de origen, conciliación y portal en vivo

Lección 4 de 8

Curso Cobro a domicilio y SDK de FINORA Pago. Anterior: Cobro en la nube por API y webhooks.

Objetivo

Que cada venta a domicilio quede en la tienda de la que salió el pedido, que puedas cruzarla con tus pedidos al final del día y que el comercio la vea en vivo en el Monitor de transacciones de su portal, con la sucursal del pedido.

Quién decide la sucursal

Camino	Quién la declara	Cómo
SDK (app a app)	Tu app, pedido por pedido	sucursalCodigo("CENTRO") o sucursalId(42): es obligatoria
Cobro en la nube	La asignación del día del datáfono	POST /api/v1/pagos/asignaciones con terminalId, storeCode y fecha; sin asignación, la tienda fija del datáfono

En el SDK no se usa la asignación del día: un motorizado puede llevar en el mismo recorrido pedidos de tiendas distintas, y tu app sabe de cuál sale cada uno.

Lo que comprueba FINORA

1. En el teléfono, FINORA Pago verifica que la sucursal está entre las permitidas a tu app en la lista de integradores (lección 5).
2. En el servidor, el Merchant verifica que la sucursal existe, que es del comercio del terminal (o de una de sus agencias, en una cadena) y que, si mandas código e id, son la misma tienda.

Si algo falla recibes PETICION_INVALIDA con SUCURSAL_INVALIDA o NO_AUTORIZADO, sin leer la tarjeta y sin crear nada. Los códigos de sucursal son exactos: "Centro" no es "CENTRO" y no se recortan espacios.

Qué guardar de cada cobro

Dato	Para qué
referenciaExterna	Une el pedido con el cobro
referenciaFinora	Con ella se consulta la venta en FINORA
rrn, autorizacion, stan	Reclamos y cuadre con el estado de cuenta
terminalId, sucursalCodigo	Dónde se cobró y a qué tienda se atribuyó
ultimos4, marca	Recibo y atención al cliente
simulado	Descartar cobros de prueba

Pasos: cuadrar el día

1. Exporta los cobros del día desde el portal del comercio o consúltalos por API desde tu servidor (FINORA_URL es la URL del Merchant de tu comercio). En el portal, los resúmenes y filtros de Ventas agrupan hoy por la sucursal fija del terminal; para ver la tienda del pedido usa el Monitor de transacciones o la API:

   curl -s "$FINORA_URL/api/v1/pagos/intenciones/FNRLZ3K9Q1" -H "X-API-Key: $FINORA_API_KEY"

2. Cruza por referenciaFinora (o por rrn + terminalId) con tus pedidos.

3. Cierra los pendientes: cada pedido que tu app dejó en EN_DUDA o SIN_RESPUESTA debe terminar como pagado o como no pagado, nunca quedar abierto (lección 6).

4. Separa las anulaciones: una venta ANULADA no aparece en el lote liquidado.

El portal en vivo

En el portal del comercio, Ventas y dinero › Monitor de transacciones muestra las ventas del día a medida que ocurren, sin recargar la página, con el alcance del usuario (todo el comercio o su sucursal). El botón «Ver» de cada fila abre el detalle: la tienda con su mapa, el comprobante, el origen de la venta y su línea de tiempo (orden creada, tarjeta leída, autorización, veredicto, firma, recibo). La firma del cliente solo la ve quien tiene el permiso correspondiente, y cada vez que alguien la abre queda registrado.

Las ventas cobradas con el SDK aparecen en el monitor como cualquier otra, bajo la sucursal que declaró tu app, y la intención guarda qué app integradora la creó.

Monitor y reportes de ventas

Hoy la sucursal del pedido se ve en vivo en el Monitor de transacciones. Los resúmenes y filtros de la sección Ventas del portal todavía agrupan por la sucursal fija del terminal: si un mismo equipo cobra para varias tiendas, ahí sus ventas aparecen bajo la tienda del equipo. Los reportes de ventas por tienda con la sucursal del pedido llegan en la próxima versión.

Ejemplo

Pedido	Tienda declarada	Resultado	En el Monitor de transacciones
PED-1001	CENTRO	APROBADA	Venta en CENTRO
PED-1002	ESTE	APROBADA	Venta en ESTE, mismo motorizado y mismo teléfono
PED-1003	TIENDA-AJENA (de otro comercio)	PETICION_INVALIDA · SUCURSAL_INVALIDA	Nada: no se creó la orden

Verificación

• Cobra dos pedidos de tiendas distintas con el mismo teléfono y comprueba en el monitor que cada uno cayó en su tienda.
• Intenta cobrar con un código de sucursal que no existe: debes recibir SUCURSAL_INVALIDA sin que FINORA Pago pida la tarjeta.
• Consulta por API la referenciaFinora del primer cobro: la intención trae tu referenciaExterna y la sucursal.

Próximamente

• Consulta directa por referenciaExterna.
• Enlace al comprobante digital (comprobanteUrl). Está construido detrás de un interruptor que aún no está activo. Cuando se active, en el primer cobro el enlace llegará a tu servidor por el webhook intencion.resultado; tu app solo lo obtendrá al consultar o repetir el cobro con la misma referenciaExterna, no en el resultado inmediato.

Siguiente: Lección 5 · Seguridad: lista de integradores y huella del certificado