Escaneo desde Plan START • API Directa PRO y ENTERPRISE

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.

Planes

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.

1

Ingresa a la Versión Web

Abre app.ned.mobi con tu cuenta de comercio matriz y selecciona "Integración POS" en el menú.

2

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.

3

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.

4

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.

Desde Plan START

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.

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.

Panel de Auditoría POS ● Tiempo Real
Ventas Vía API 1.420
Escaneo de Tirilla 389
Descuentos (Bonos + Pts) $ 2.180.000
Duplicadas Bloqueadas 14 (100% Antifraude)
Exportar XLSX (21 cols)
Exportar CSV

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.

Integración POS Asistida con Ingeniería NED

¿Usas Siigo, Alegra, Vendty, Helisa, ICG, Micros o un desarrollo propio? Nuestro equipo acompaña directamente a tu negocio o proveedor técnico en la configuración, homologación y pruebas sin costo adicional en Planes PRO y ENTERPRISE.