Datáfono

Introducción

El módulo Datáfono permite cobrar facturas con tarjeta usando un datáfono bancario físico, integrando el cobro directamente con la facturación de FactuPOS.

Cuando el cajero elige Tarjeta como medio de pago, FactuPOS le envía el monto al datáfono. El cliente acerca/inserta su tarjeta, el datáfono pide autorización al banco, y la respuesta vuelve a FactuPOS. Si el banco aprueba, la factura se completa automáticamente con el código de autorización como comprobante.

Componentes

Arquitectura del puente

El puente es necesario porque el navegador no puede abrir conexiones TCP directas al datáfono — solo habla HTTP/HTTPS. El puente local recibe HTTP, abre el socket TCP al POS, le manda el JSON y devuelve la respuesta.

Instalar FactuposDatafono

El puente se instala en cada PC de caja que cobre con tarjeta. Son 3 pasos: instalar el puente, autorizar el navegador, y configurar en FactuPOS.

1) Instalar el puente (1 clic)

1. Descargar el instalador: FactuposDatafono-Setup.zip (descomprimir y ejecutar el .exe) (también en el menú Aplicaciones → Datáfono → Instalador).
2. Ejecutarlo. Si Windows SmartScreen avisa: Más información → Ejecutar de todas formas.
3. Deja el puente arrancando con Windows (oculto, con ícono en la bandeja) + desinstalador. No hay que copiar nada a mano.
4. En la bandeja aparece el ícono de tarjeta: verde = corriendo, rojo = detenido (puede estar en la flechita ▲ de iconos ocultos).

2) Autorizar Chrome/Edge — OBLIGATORIO desde Chrome 142

Chrome/Edge 142+ bloquean que la web de FactuPOS hable con el puente local 127.0.0.1 (error Failed to fetch / Permission was denied … loopback), aunque el puente esté corriendo. Hay que autorizarlo:

1. Descargar Permitir-Datafono-Chrome.reg (clic derecho → Guardar enlace como, que termine en .reg).
2. Doble clic → Sí (edita el registro; puede pedir admin).
3. Cerrar Chrome del todo y reabrir.
4. Verificar en chrome://policy: debe aparecer LocalNetworkAccessAllowedForUrls con tus dominios.

3) Configurar en FactuPOS (DTF-001)

Menú Configuración → General → Datáfono: Estado Habilitado, banco, URL del puente http://127.0.0.1:8765, e IP / puerto / Merchant ID del datáfono. Detalle en Configurar (DTF-001).

Si el datáfono es BAC Credomatic: son 13 pasos, no 3

BAC no se instala como los demás. Su pinpad es USB (no va en la red) y necesita, además del puente nuestro, el SDK del banco corriendo en la misma PC. El orden es obligatorio:

schtasks /create /tn "BAC httpRunSDK" /tr "\"C:\CSP-SDK-BAC-3.12.3\CSP SDK Integracion EMV 3.12.3 v1\BacCredomatic.httpRunSDK.exe\"" /sc onlogon /rl highest /f

El paso a paso completo, con qué hacer en cada pantalla y qué hacer si algo falla, está en el Manual de Instalación BAC Credomatic (INSTALACION-BAC.md), que viene junto con el SDK en el paquete privado del banco.

Ubicaciones

Tray icon

Al lado del reloj de Windows aparece un icono. Click derecho abre el menú:

Configurar (DTF-001)

Acceso: Configuración → Datáfono o Herramientas → Datáfono → Configurar Datáfono.

Sección "Configuración"

Probar puente

Verifica que el ejecutable está corriendo y responde HTTP.

1. Asegurarse de que FactuposDatafono.exe está abierto
2. En DTF-001, click Probar puente

Resultados posibles

Probar conexión POS

Hace un TCP probe al datáfono — abre el socket sin enviar ninguna transacción. Sirve para confirmar que el POS está prendido, en MODO CAJA y escuchando en el puerto configurado.

1. Llenar IP, Puerto y Merchant ID
2. Click Guardar
3. Click Probar puerto POS

Cobrar prueba

Una vez puente OK + POS responde, hacer un cobro real sin afectar facturación:

1. En DTF-001, sección Pruebas de transacciones, ingresar un monto pequeño (ej. 100)
2. Click Cobrar prueba
3. El POS muestra "Acerque/inserte/pase su tarjeta"
4. El cajero pasa una tarjeta real (puede ser la propia, se anula después)
5. Resultado en pantalla:
   • APROBADA con auth_code, ticket_number, reference_number, etc.
   • RECHAZADA con rsp_code y mensaje del banco

Anular / Devolver / Reimprimir

Las tres operaciones requieren el ticket_number (número de boleta) que devolvió el POS al cobrar.

Anular

Solo funciona el mismo día y antes del cierre de lote. Cancela completamente la transacción.

Devolver

Funciona incluso después del cierre. Procesa un reembolso al cliente. Acepta monto parcial (no necesariamente el total).

Reimprimir

Imprime una copia del voucher. Solo si la prioridad de impresión es del POS o de la caja según configuración Polaris.

Cierre y reportes

El Cierre de lote (Z bancario) consolida todas las transacciones del día y las envía al banco para liquidación.

Bancos soportados

Para activar un banco nuevo se requiere: documentación del protocolo del banco, plugin nuevo en el puente y carpeta dedicada en /datafono/codigo/<banco>/.

Facturación con datáfono

Una vez activado el datáfono en DTF-001, los 4 módulos de facturación llaman al datáfono automáticamente cuando el cajero elige Tarjeta como medio de pago:

• Factura Desktop
• FastPOS
• FastPOS 2
• Factura Móvil

Flujo del cobro

1. Cajero arma la factura
2. Click en Tarjeta (medio de pago 02) o teclas equivalentes
3. FactuPOS muestra "Cobrando con datáfono..."
4. El datáfono pide la tarjeta al cliente
5. Si el banco aprueba:
   • FactuPOS guarda el pago con auth_code|ticket_number|reference_number|****1234 como comprobante
   • Se cierra normal la factura
6. Si el banco rechaza:
   • FactuPOS muestra mensaje de error y NO guarda el pago
   • El cajero puede reintentar o cobrar con otro medio

Listado de movimientos (DTF-002)

Toda transacción que pasa por el datáfono se registra automáticamente en la tabla BancoMovimientos con todos los campos del POS (ticket, autorización, referencia, EMV, tarjeta enmascarada, etc.). El módulo DTF-002 permite consultarlas, reimprimir voucher, anular y verificar contra el POS.

Filtros disponibles

Acciones por movimiento

Sobre cada cobro aprobado de tipo COMPRA:

Consultar — qué interpreta cada respuesta

• REIMPRESION aprobada → el ticket existe en el POS (puede estar activo o anulado, REIMPRESION no diferencia).
• REPORTE AUDITORIA aprobado con el ticket apareciendo 1 vez → activo. Apareciendo 2+ veces → fue anulado (cobro + anulación).
• REPORTE AUDITORIA con rsp_code 99 → la transacción no está habilitada en Polaris. Tip: usar el botón Anular; si el POS dice "TRANSACCION YA ANULADA" entonces ya estaba anulada.

Imprimir detalle / Cierre de lote

Si la estación tiene un datáfono asignado, en la parte superior aparecen dos botones de color (sólo cuando hay datáfono; en cajas de solo contado no se muestran):

Solución de problemas

"Failed to fetch" / "Permission was denied … loopback"

Causa #1 (Chrome/Edge 142+): el navegador bloquea que la web toque 127.0.0.1 aunque el puente esté corriendo. Se ve en la consola (F12) como blocked by CORS policy: Permission was denied … loopback address space.

1. Aplicar Permitir-Datafono-Chrome.reg (ver Instalar, paso 2) y reiniciar el navegador.
2. Verificar en chrome://policy que aparezca LocalNetworkAccessAllowedForUrls.

Causa #2: el puente no está corriendo (o abrís DTF-001 desde otra PC).

1. Verificar el ícono verde en la bandeja (puede estar en la flechita ▲). Si no está, reinstalá o arrancá el puente.
2. Probar en el browser (nueva pestaña): http://127.0.0.1:8765/salud debe responder JSON con "version".
3. Si EADDRINUSE en el log: había otra instancia. Desde v0.4.3 se resuelve solo; en versiones viejas, taskkill /F /IM FactuposDatafono.exe y arrancar de nuevo.

"ECONNREFUSED" al probar el POS

Causa: el datáfono está prendido y en la red, pero NO está escuchando en el puerto.

1. Verificar con ping <IP del POS> que la red funciona
2. Pedir a Promerica que active MODO CAJA en Polaris para tu terminal
3. Confirmar el puerto correcto (default 8080)

"rsp_code: 02" Transacción no permitida

Causa: el Merchant ID es incorrecto, o la transacción no está habilitada en Polaris.

1. Confirmar el Merchant ID con el banco
2. Pedir habilitar todas las transacciones en plantilla TRANSACCIONES de Polaris (COMPRA NORMAL, ANULACION, DEVOLUCIONES, REIMPRESION, CIERRE, ULTIMA TRANSACCION, PRUEBA COMUNICACION, ESTADO DE CONEXION)

El POS está en la misma red pero ping no responde

Causa: el POS quedó en una red diferente (típicamente 4G del POS, no la WiFi del comercio).

1. Verificar con ipconfig en la PC y el dato de IP del POS (boleta de inicialización del POS)
2. Si las redes son distintas, conectar el POS a la WiFi del comercio
3. Asignar IP estática del POS dentro del rango de la WiFi (ej. 192.168.100.x)

Timeout 130000ms en cobro

Causa: el POS recibió pero no respondió (tarjeta sin firmar, cliente abandonó, problema de comunicación con el banco).

1. Antes de reintentar, click Última transacción — si aparece la transacción, el banco SÍ aprobó (no reintentar para evitar doble cobro)
2. Si no aparece nada en última transacción, sí se puede reintentar

Logs detallados

Cada acción del puente se registra en %APPDATA%\FactuposDatafono\logs\YYYY-MM-DD.log. Acceso rápido desde el tray icon: Ver logs…