Integración POS: Flexibilidad Total para tu Comercio
Premia a tus clientes, acumula y redime puntos en efectivo, valida bonos por sucursal y genera boletas de sorteo al instante. En NED puedes operar con Escaneo de Tirilla en mostrador o conectar tu software mediante API Directa (v2.2.0), o combinar ambos según tu operación.
Multi-Sucursal, Multi-Caja y Cero Fricción
¿Tienes cajas principales con software contable (Siigo, Alegra, Vendty, Helisa, ICG, Micros o ERP propio) y puntos auxiliares con tablet? Usa API Directa en tus cajas centrales y Escaneo de Tirilla en mostradores adicionales. Todo se consolida por sede y caja en un solo Panel Web de Auditoría.
Configuración Inicial en tu Panel Web
Administra tus canales, regla de factura y credenciales desde la versión web de NED en menos de 2 minutos.
Plan START: incluye Escaneo de Tirilla en movimientos, regla de factura y Auditoría POS.
Planes PRO y ENTERPRISE: desbloquean API Directa, generación de API Keys por matriz/sucursal/caja y Integración POS Asistida con nuestro equipo de ingeniería. Consulta nuestra tabla de planes.
Ingresa a la Versión Web
Abre app.ned.mobi con tu cuenta de comercio matriz y selecciona "Integración POS" en el menú.
Activa tus Modos de Captura
En la pestaña Configuración, habilita Escanear Tirilla (activo por defecto) y, si tienes Plan PRO o ENTERPRISE, activa API Directa.
Regla de Factura (Opcional)
Define el patrón regex de tus tickets para bloquear errores de digitación (ej. ^FAC-[0-9]{4,8}$) y verifícalo en el probador en vivo.
Genera API Keys o Opera
Guarda tu configuración (se replica automáticamente a todas tus sucursales) y, para API Directa, crea tus credenciales por sede o caja en la pestaña API Keys.
Modalidades de Integración POS
Elige operación inmediata desde el mostrador sin programación o automatización total conectada a tu software POS/ERP.
1. Escaneo de Tirilla
Captura desde Movimientos con cámara QR, lector de barras o registro de ticket.
¿Para quién es?
Comercios, cafés, boutiques, droguerías y supermercados que no desean intervenir su software de facturación y buscan operar en minutos con antifraude garantizado.
Operación del cajero:
- 1 Abre la pantalla de Movimientos / Registrar Venta en la App o Web de NED.
- 2 Escanea el código QR o de barras impreso en la tirilla térmica (o captura el número de factura).
- 3 Ingresa la cédula del cliente, confirma el monto y aplica bonos o puntos en efectivo disponibles en pantalla.
- 4 Pulsa "Registrar Compra". Si la tirilla cumple la regla de factura y no está duplicada, el cliente recibe sus beneficios al instante.
Blindaje 72 horas: Si intentan volver a registrar o escanear el mismo número de factura, NED bloquea el intento automáticamente.
2. API Directa de NED
Integración máquina a máquina con tu POS o ERP en < 20 ms.
¿Para quién es?
Cadenas y comercios con software POS/ERP (Siigo, Alegra, Vendty, Helisa, ICG, Micros o desarrollo propio). El cajero no sale de su sistema de caja; todo ocurre vía API REST.
Capacidades clave v2.2.0:
- 1 Pre-validación en caja: Verifica cupones (POST /api/pos/bono/validar) y saldo de puntos en efectivo (POST /api/pos/puntos/consultar) sin quemarlos en sedes no autorizadas.
- 2 Registro ultrarrápido (< 20 ms): POST /api/pos/compra procesado en Go + Redis 7 con idempotencia de 72 horas y soporte para puntos_a_redimir y fecha_transaccion.
- 3 Consulta y Anulación (Nota Crédito): Consulta liquidación final (GET /api/pos/compra/{id}) o anula facturas (POST /api/pos/compra/anular) revirtiendo puntos, boletas y cupones automáticamente.
Multi-Sucursal y Multi-Caja: Genera credenciales a nivel Matriz, Sucursal o Caja registradora individual, con validación de las 4 dinámicas por sede.
Cuadro Comparativo
Compara ambas modalidades para definir la mejor arquitectura en cada punto de venta.
| Criterio | 1. Escaneo de Tirilla | 2. API Directa (v2.2.0) |
|---|---|---|
| Planes incluidos | ✅ START, PRO y ENTERPRISE | ✅ PRO y ENTERPRISE |
| ¿Requiere programador? | ❌ No, listo para usar | ✅ Sí (con acompañamiento asistido de NED) |
| Intervención del cajero | Escanea la tirilla en la app y confirma | Cero (cobra en su software POS habitual) |
| Velocidad de respuesta | ~5 a 8 segundos | ⚡ < 20 ms (Go + Redis 7) |
| Bonos, Puntos en Efectivo, Referidos y Sorteos | Sí (con validación en pantalla) | Sí (pre-validación de bonos/puntos y liquidación por sede) |
| Anulaciones / Notas Crédito | Control en panel | Automático vía POST /api/pos/compra/anular |
| Prevención de fraudes | Regex + Idempotencia 72 horas | Regex + Idempotencia atómica Redis 7 (72h) + Rate Limit |
El Cierre Contable: Módulo de Auditoría Web
Concilia tus ventas, puntos redimidos, bonos, referidos y anulaciones contra el Reporte Z / X de caja.
Control total por Sucursal y Caja
Todas las operaciones registradas por Escaneo de Tirilla o API Directa se consolidan en tiempo real en el módulo web de Auditoría POS.
-
Filtros avanzados por Sucursal, Caja/Terminal, cajero, rango de fechas y estado (
PROCESADA,DUPLICADA_BLOQUEADA,ANULADA). - Totales reales netos y brutos con desglose de descuento por bonos, redención de puntos y referidos (excluyendo anuladas).
- Registro antifraude de facturas duplicadas bloqueadas en Redis 7 durante 72 horas.
- Exportación en streaming a Excel (.xlsx) y CSV (21 columnas contables) lista para Siigo, SAP o World Office.
* Disponible en la versión web (app.ned.mobi) para todos los planes activos desde START.
Preguntas Frecuentes sobre Integración POS
Resolvemos las dudas más habituales de los comercios y equipos técnicos.
¿Puedo combinar Escaneo de Tirilla y API Directa?
Sí, totalmente. Puedes tener tus cajas principales conectadas por API Directa y usar el Escaneo de Tirilla en islas, eventos o cajas auxiliares.
¿Qué ocurre si un cliente intenta usar un cupón en una sucursal no autorizada?
La pre-validación (POST /api/pos/bono/validar) responde indicando las sedes válidas y mantiene intacto el cupón en la app del cliente sin quemarlo.
¿Qué necesito para acceder a la API Directa y API Keys?
Contar con Plan PRO o Plan ENTERPRISE activo. El modo Escaneo de Tirilla y el módulo web de Auditoría POS ya vienen incluidos desde el Plan START.
¿La API Directa demora el cobro o permite anular facturas?
No demora el cobro: responde en < 20 ms gracias a Go + Redis 7. Además, si hay una devolución o error en caja, puedes revertir puntos, boletas y cupones con POST /api/pos/compra/anular.