POS: Caisse-AP payment protocol for France
Este módulo añade soporte para el protocolo Caisse AP sobre IP en el Punto de Venta de Odoo.
El protocolo Caisse AP es un protocolo independiente del proveedor utilizado en Francia para comunicarse entre un punto de venta y un terminal de pago. Está implementado por terminales de pago Ingenico, terminales de pago Verifone y otras marcas de terminales de pago. Este protocolo está diseñado por una asociación francesa llamada Association du paiement, abreviada como AP. ¡Ten en cuenta que el protocolo Caisse-AP es utilizado por los terminales de pago Ingenico desplegados en Francia, pero no por el mismo modelo de terminales de pago Ingenico desplegados en otros países!
Este módulo soporta un enlace bidireccional con el terminal de pago:
- envía el importe al terminal de pago
- espera el final de la transacción de pago
- analiza la respuesta del terminal de pago que proporciona el estado del pago: en caso de éxito, la línea de pago se valida automáticamente; en caso de fallo, se muestra un mensaje de error y el usuario de Odoo puede reintentar o eliminar la línea de pago.
El protocolo Caisse-AP se escribió inicialmente para serie y USB. Desde la versión 3.x del protocolo Caisse AP, también soporta IP. Cuando se utiliza sobre IP, el cliente (punto de venta) y el servidor (terminal de pago) intercambian datos de texto simple codificados en ASCII a través de un socket TCP en bruto.
El protocolo Caisse-AP tiene un inconveniente importante: como utiliza un socket TCP en bruto, no se puede utilizar desde código JS puro. Por lo tanto, el código JS del punto de venta no puede generar por sí mismo la consulta para enviar el importe al terminal de pago. En este módulo, el código JS del punto de venta envía una consulta al servidor de Odoo que abre un socket TCP en bruto hacia el terminal de pago. Esto implica que, si el servidor de Odoo no está en la LAN sino en algún lugar de Internet y el terminal de pago tiene una IP privada en la LAN, necesitarás configurar una regla de reenvío de puerto TCP en el cortafuegos para redirigir la conexión TCP del servidor de Odoo al terminal de pago.
Traducción automática al español (DeepSeek) de la descripción original de OCA, que está en inglés.
auto_awesome Qué hace este módulo
Generado por IA a partir del código · Odoo 19.0Añade una opción de terminal de pago Caisse-AP over IP a Odoo Point of Sale, permitiendo a los cajeros enviar el importe a un terminal de pago francés y recibir el resultado del pago automáticamente.
Este módulo añade un nuevo tipo de terminal de pago llamado "Caisse AP over IP (France only)" a los métodos de pago del Punto de Venta. Al configurar un método de pago, puedes elegir este tipo de terminal y rellenar la dirección IP o el nombre DNS del terminal, su puerto TCP (por defecto 8888) y el modo de pago (tarjeta o cheque). La dirección y el puerto son obligatorios y se validan; el puerto debe estar entre 1 y 65535.
Durante una venta, cuando el cajero selecciona este método de pago e inicia el pago, Odoo envía el importe al terminal a través de la red y espera la respuesta del terminal. La línea de pago muestra un estado de espera mientras el terminal está procesando. Si el terminal aprueba, el pago se marca como exitoso y el tipo de tarjeta y la referencia de la transacción se almacenan en la línea de pago; también se puede añadir una línea de ticket al recibo. Si el terminal rechaza, se muestra un mensaje de error. Si no se puede contactar con el terminal o la respuesta no está clara, el cajero ve un error y puede gestionar el pago manualmente.
El módulo también comprueba que el importe no sea cero ni demasiado grande, y admite tanto pagos como reembolsos. Funciona con el modelo pos.payment.method y añade campos al formulario del método de pago en la configuración del Punto de Venta.
Depende de
Modelos y campos (1)
- pos.payment.method · amplía un modelo existentefr_caisse_ap_ip_mode (Payment Mode), fr_caisse_ap_ip_port (Caisse-AP Payment Terminal Port), fr_caisse_ap_ip_address (Caisse-AP Payment Terminal IP Address)
Texto generado por IA (DeepSeek) al leer el código de la versión 19.0 en GitHub; puede contener errores, así que verifícalo en el código antes de decidir. Ver el código en GitHub
Disponibilidad por versión
Revisado: 2026-11-03Estado de confirmación: 5 confirmadas, 4 sin información de 9 versiones.
Fuentes · Odoo 17.0
Confirmado el 2026-11-03 en la rama 17.0 de OCA/l10n-france.
terminal Instalación y uso
Documentación de OCA · Odoo 19.0Configuración
Fuente · Odoo 19.0En el menú Punto de venta \> Configuración \> Métodos de pago, en el método de pago que corresponda a un pago con tarjeta:
- seleccione el diario adecuado, que debe ser un diario de banco (y no un diario de caja, de lo contrario el campo Integrar con es invisible)
- campo Integración: seleccione Terminal
- campo Integrar con: seleccione Caisse AP over IP (solo Francia)
- campo Caisse-AP Payment Terminal IP Address: establezca la dirección IP del terminal de pago,
- campo Caisse-AP Payment Terminal Port: establezca el puerto TCP del terminal de pago (8888 por defecto),
- campo Modo de pago: establezca Tarjeta (el valor Cheque es para el método de pago Cheque si utiliza una impresora de cheques conectada al terminal de pago como Ingenico i2200)
Traducción automática al español (DeepSeek) de la documentación original de OCA; los comandos y el código no se traducen. Sin información verificada en OCA: Instalación, Uso.
Las instrucciones de instalación, el paquete de distribución, las dependencias y los pasos de configuración no se muestran porque todavía no se han verificado en la documentación del módulo para ninguna versión.
Datos importados de GitHub: esta ficha refleja la última revisión del catálogo, no una consulta en directo. Verifica siempre en la documentación del módulo y en staging antes de instalar en producción.