POS Redeban Colombia — Datáfono integrado al Punto de Venta
Cobre con datáfonos Redeban directamente desde el POS de Odoo 16: el monto viaja solo al datáfono y la transacción aprobada aplica el pago y valida la orden sin digitar nada — con voucher Redeban en el ticket y auditoría completa.
Lo que obtiene
POS Redeban Colombia conecta el Punto de Venta de Odoo 16 con los datáfonos de Redeban a través de la interfaz oficial «Cajas para Windows» v9.2.4. El cajero toca el método de pago y el monto exacto — con IVA proporcional discriminado — viaja solo al datáfono en Modo Escucha (TEF Nuevo Flujo): sin digitar valores, sin tecla verde, sin errores de monto. Aprobada la transacción, el POS aplica el pago, valida la orden, factura e imprime el ticket con el voucher Redeban incluido.
El paquete trae el addon POS más el RedebanAgent: un servicio Windows
(un solo .exe portable) que traduce entre el navegador del POS y
Cajas.exe mediante el protocolo SOLICITUD.TXT /
RESPUESTA.TXT del manual técnico Redeban — sin tocar ni reemplazar la
instalación que el banco ya dejó en el comercio. Incluye además el configurador visual
RedebanConfig y el modelo de auditoría
pos.redeban.transaction con RRN, autorización, franquicia, tarjeta
enmascarada, terminal, recibo, cuotas, fecha/hora del datáfono, latencia y tramas crudas.
GET /transaction/<trace_id>.
Componentes de la solución
Un addon Odoo + un agente local por caja. Todo incluido en el mismo paquete: addon, agente, configurador visual y scripts de instalación como servicio Windows.
Addon POS (pos_redeban_co)
Popup de cobro «Datáfono Redeban» (componente OWL) con auto-envío al datáfono, monto gigante, contador de espera en segundos y colores semáforo. Pantalla de pago con validación de saldo, IVA proporcional en pagos parciales, idempotencia anti-duplicados y auto-validación de la orden al quedar saldada (aplica pago + factura + imprime). Los 7 campos Redeban viajan en la línea de pago y sobreviven refresh y modo offline.
OWL popup Auto-validación IVA proporcional Offline-safe
RedebanAgent (servicio Windows)
Agente HTTP local en 127.0.0.1:8765 que escribe
SOLICITUD.TXT y hace polling de RESPUESTA.TXT
según el Config.sip del comercio (timeouts, respuesta
larga/corta, política de borrado — los lee, no los impone). Un solo
.exe portable instalado como servicio con arranque automático
(NSSM), logs JSON rotados y token Bearer opcional.
127.0.0.1:8765 Config.sip auto Servicio NSSM Bearer token
Auditoría pos.redeban.transaction
Cada intento — aprobado, declinado, sin respuesta, error o manual — queda registrado en Odoo: RRN, autorización, franquicia, tarjeta enmascarada, cuotas, terminal, recibo, fecha/hora del datáfono, latencia y tramas crudas. Lista con colores por estado, total aprobado, filtros y agrupaciones por franquicia / terminal / POS / fecha, y botón «Redeban» en la orden.
RRN indexado Raw request/response Latencia ms
RedebanConfig (configurador visual)
GUI portable de doble clic para el técnico de la tienda: detecta
automáticamente dónde está Cajas.exe, muestra el
Config.sip de solo lectura, prueba el agente con un clic
(/health → EN LÍNEA / NO responde) y lo reinicia. Puerto,
carpeta de Cajas, ID de la caja, token y Modo Escucha sin editar archivos
a mano.
Detección automática Probar agente Sin editar archivos
Capturas del producto
Capturas reales del módulo operando en producción: POS de Odoo 16 cobrando $ 49.500,00 contra un datáfono Redeban en Modo Escucha.
Un toque: método de pago «Datáfono Redeban»
El cajero selecciona el método de pago marcado como Redeban en la pantalla de pago — aquí «Datafono Redeban PASTO C1», conviviendo con transferencias y Addi. El saldo pendiente exacto ($ 49.500,00) con su IVA proporcional viaja automáticamente al datáfono: el cajero no digita el monto en ninguna parte.
Auto-envío al datáfono — «Inserte / acerque la tarjeta»
Al abrirse, el popup «Datáfono Redeban» envía la transacción sin pulsar nada: muestra el monto a cobrar en grande, el spinner «Inserte / acerque la tarjeta en el datáfono...», el contador «Esperando al datáfono... (3s)» y la pista para cancelar con la tecla ROJA. Botones «Cancelar» y «Pago manual» siempre a la mano.
El datáfono recibe el monto solo
Con el Modo Escucha (TEF Nuevo Flujo) el datáfono Redeban pasa directo a «Acerque, inserte o deslice su tarjeta en el dispositivo» — sin tecla verde, sin re-digitar el valor. El cliente paga con chip, banda, contactless o QR.
No aprobada — reintente sin miedo
Si el datáfono declina (tecla ROJA, PIN incorrecto, entidad no
responde), el popup muestra «No aprobada» con el código exacto del
datáfono. «Reintentar» relanza el cobro con el mismo
trace_id — la idempotencia por RRN/trace_id garantiza
que nunca se registre doble. «Pago manual» queda como salida de
contingencia.
Cancelación guiada — tecla ROJA
«Cancelar» no cierra a ciegas: el popup pide cancelar en el datáfono («Oprima la tecla ROJA») para que la declinación quede registrada en ambos lados, con opción «Volver» a la espera o «Sí, cerrar».
Forzar cierre — solo con doble confirmación
Si el datáfono sigue esperando la tarjeta, aparece el aviso «Sigue esperando. Pulse de nuevo para forzar.» y el botón cambia a «Forzar cierre»: solo ese segundo clic aborta bajo responsabilidad del cajero. Así el POS y el datáfono nunca quedan descuadrados por un cierre accidental.
Flujo típico de una venta
- Cobro: el cajero toca «Datáfono Redeban» → el POS envía monto,
IVA proporcional, número de factura y código de caja al agente local
(
POST /transaction/purchase, operación 00 Compra Estándar). - Pago: el datáfono en Modo Escucha muestra el monto; el cliente
acerca, inserta o desliza la tarjeta y digita su PIN. El agente espera
RESPUESTA.TXTcon el timeout del propioConfig.sip(90 s por defecto). - Aprobación: check verde con Autorización, Franquicia, Tarjeta, Recibo y RRN → al segundo se auto-confirma: línea de pago exacta y orden validada automáticamente; el ticket imprime el bloque VOUCHER REDEBAN (Redeban, Tarjeta, Aprob., RRN, Terminal, Recibo).
- Contingencia: si algo falla — declinada, sin respuesta, agente caído — el cajero reintenta con un toque o registra el pago manual digitando Autorización + RRN del voucher físico.
- Anulación: el RedebanAgent incluye la operación 01 Anulación
(
POST /transaction/voidcon número de recibo y clave de supervisor) para reversar cobros de forma controlada contra el datáfono. - Cierre y conciliación: el menú «Transacciones Redeban» en Odoo muestra cada transacción con estado, RRN, autorización, latencia y tramas crudas — agrupable por franquicia, terminal, POS y fecha para el cuadre contra Redeban.
Configuración en 5 campos por caja
En el método de pago del POS (grupo «Redeban (Cajas.exe)», visible al activar el check):
Activa el cobro con datáfono en ese método de pago.
http://localhost:8765 — el RedebanAgent de esa caja.
Identificador de la caja (ej.
PASTO-C1) para multi-caja.
Autenticación
Authorization: Bearer opcional contra el agente
(campo oculto tipo contraseña).
90.000 ms por defecto (mínimo 5.000) — override del TimeOut del
Config.sip.
«Datafono Redeban PASTO C1», «... C2»: cada caja apunta a su propio agente y datáfono.
Requisitos
Con la interfaz Redeban «Cajas para Windows» v9.2.4 instalada y licenciada por Redeban (
Cajas.exe, Config.sip).
Conectado por puerto COM y configurado en Modo Escucha (TEF Nuevo Flujo) — recomendado para cobro sin tecla verde.
El agente escucha solo en
127.0.0.1 — nada queda expuesto a la red.
Única dependencia del addon. Instalación del agente en ~10 minutos por caja (.exe portable + servicio automático).
| Availability |
Odoo Online
Odoo.sh
On Premise
|
| Odoo Apps Dependencies |
•
Point of Sale (point_of_sale)
• Discuss (mail) • Inventory (stock) • Invoicing (account) |
| Lines of code | 1844 |
| Technical Name |
pos_redeban_co |
| License | See License tab |
| Website | https://www.mi-erp.app |
Proprietary License v1.0 Este software y los archivos asociados (el "Software") solo se pueden utilizar (ejecutar, modificado, ejecutado después de modificaciones) si ha comprado una licencia válida de los autores, normalmente a través de las aplicaciones de Odoo, o si ha recibido una acuerdo de los autores del Software (consulte el archivo COPYRIGHT). Puede desarrollar módulos de Odoo que utilicen el Software como una biblioteca (normalmente dependiendo de él, importándolo y usando sus recursos), pero sin copiar cualquier código fuente o material del Software. Está prohibido publicar, distribuir, sublicenciar o vender copias del Software. o copias modificadas del Software. El aviso de copyright anterior y este aviso de permiso deben incluirse en todos copias o partes sustanciales del Software. EL SOFTWARE SE PROPORCIONA "TAL CUAL", SIN GARANTÍA DE NINGÚN TIPO, EXPRESA O IMPLÍCITAS, INCLUIDAS PERO NO LIMITADAS A LAS GARANTÍAS DE COMERCIABILIDAD, APTITUD PARA UN PROPÓSITO PARTICULAR Y NO INFRACCIÓN. EN NINGÚN CASO LOS AUTORES O TITULARES DE LOS DERECHOS DE AUTOR SERÁN RESPONSABLES DE NINGÚN RECLAMO, DAÑOS U OTRA RESPONSABILIDAD, YA SEA EN UNA ACCIÓN DE CONTRATO, AGRAVIO O DE OTRA FORMA, SURGIENDO, FUERA DE O EN RELACIÓN CON EL SOFTWARE O EL USO U OTROS NEGOCIACIONES EN EL SOFTWARE.
Please log in to comment on this module