Descripción

El módulo POS Latín Pagos para Odoo 19 conecta el Punto de Venta directamente con la pasarela venezolana Latín Pagos para procesar transacciones de Pago Móvil sin salir del POS.

El cajero captura los datos del cliente (cédula, banco, teléfono y token OTP) en un popup y la solicitud se envía al API REST de Latín Pagos a través de un proxy interno de Odoo, evitando problemas de CORS y manteniendo el token JWT cacheado en la compañía con renovación automática.

Funcionalidades principales

• Cobro C2P (Customer to Person): el cliente autoriza el pago con un token OTP del banco emisor; el cobro se acredita al comercio.
• Envío P2P (Person to Person): envíos a un tercero desde la cuenta del comercio con un solo clic.
• Vuelto digital: entrega el cambio al cliente vía Pago Móvil cuando paga en efectivo y no hay sencillo.
• Autenticación JWT cacheada: el token se almacena en res.company, se renueva automáticamente y reintenta una vez ante 401.
• Lista de bancos en vivo: el popup carga la lista oficial de bancos desde el API de Latín Pagos.
• Consultas de operación: menú con Estado del API, Balance, Histórico (por cuenta) y Bancos.
• Auditoría en pos.payment: referencia, status, mensaje y la solicitud/respuesta cruda en JSON quedan persistidas por cada cobro.
• Configuración por compañía: URL del API, usuario y clave de la pasarela, separados de la base del POS.
• Acción configurable por método de pago: cada pos.payment.method elige si es C2P, P2P o Vuelto.
• Compatible con Odoo 19: sin _load_pos_data_fields y sin tocar el ciclo de carga del POS.

Interfaz y experiencia de usuario

El cajero ve un botón de Latín Pagos en la barra superior del POS, y un popup de captura que precarga los datos del cliente (nombre, cédula, teléfono) cuando hay un partner asignado al ticket. Una vez confirmado el cobro, el indicador de procesamiento se mantiene hasta que la pasarela responde, y el número de referencia queda asociado al pago para conciliación posterior.

Flujo de un cobro

1. Configura la URL, usuario y clave de Latín Pagos en la ficha de la compañía.
2. Crea un método de pago en el POS con terminal Latín Pagos y elige la acción (C2P, P2P o Vuelto).
3. En el POS, agrega el método de pago al ticket. El popup precarga los datos si el cliente está asignado.
4. El cajero captura banco, teléfono, monto y token OTP, y confirma.
5. Odoo envía la solicitud al API de Latín Pagos a través del proxy backend.
6. La respuesta (referencia, status, mensaje) queda asociada al pos.payment y el ticket se cierra.

Detalles técnicos

• Hereda pos.config, pos.payment.method, pos.payment y res.company.
• Implementa una PaymentInterface personalizada (PaymentLatinPagos) en el POS, con popups OWL nativos.
• Controlador HTTP que actúa como proxy hacia el API REST de Latín Pagos para evitar restricciones CORS.
• Autenticación JWT con cache en compañía y renovación a las 23 horas.
• Whitelist de campos por endpoint (C2P / P2P / Vuelto) acorde al contrato oficial.
• Documentación de referencia: docs.latin-pagos.com.
• Sin dependencias externas más allá del módulo estándar point_of_sale.

Nuestros servicios

Customización Integración Instalación

Creación y Actualización Migración Soporte

Contáctanos

Obtendrás asistencia gratuita durante 60 días por cualquier error o problema.

Para consultas o soporte: info@mi-erp.app