Catálogo
Categorías y productos externos con IDs estables, estado activo/inactivo y mapeo hacia entidades internas.
Partner API
Conecta un POS externo sin entregar la base de datos.
WAGMI recibe datos operativos por API, los valida, los organiza por tenant y sucursal, y la deja lista para revisión contable. El POS sigue vendiendo; WAGMI convierte esos datos en backoffice confiable mediante un contrato V1 controlado. El adaptador actual está limitado al primer POS aprobado; otros POS requieren sandbox, mapeo y aprobación antes de producción.
Flujo de integración
De payload externo a revisión contable.
1
Conectar
Con aprobación humana, se crea una conexión por empresa/sucursal con API key y modo sandbox o producción.
2
Recibir
El partner envía categorías, productos, facturas y anulaciones por endpoints versionados.
3
Validar
WAGMI revisa firma, timestamp, idempotencia, moneda, fiscalidad, sucursal y duplicados.
4
Revisar
Los imports entran a staging para que el equipo vea errores, gaps y próximas acciones.
5
Postear
La contabilidad se afecta solo cuando la política del cliente y la revisión lo permiten.
Datos aceptados
Lo necesario para operar sin recapturar.
El contrato V1 se mantiene deliberadamente pequeño. Primero sincroniza catálogo e invoices cerradas; luego se amplían casos cuando el partner y el cliente ya están operando.
Facturas
Ventas cerradas con cliente, líneas, pagos, impuestos, descuentos y fuente fiscal.
Anulaciones
Void controlado para imports no posteados o estados que permitan reversa segura.
Health
Endpoint de capacidades para validar conexión, moneda soportada y estado de la integración.
Riesgos cubiertos
Integraciones con límites operativos.
El diseño asume reintentos, payloads malos, conexiones que hay que pausar y sucursales que no se pueden mezclar.
Sin acceso directo a base de datos.
API keys por conexión y secretos cifrados.
Firma HMAC con timestamp para reducir replay.
Idempotencia obligatoria para reintentos seguros.
Contrato V1 con política de versionado y deprecación.
Reintentos claros: backoff para 429/5xx, corregir payload/auth en 4xx.
Rate limits por IP y credencial.
Staging auditable antes de afectar libros.
Mapeo de sucursales para no mezclar operaciones.
Pausa/reactivación de conexiones sin borrar historial.
Sandbox primero
Probamos con muestras antes de conectar tráfico real.
La primera conexión valida health, catálogo, invoices, anulaciones, errores e idempotencia antes de operar en modo producción.
Sin acceso a base de datos
El partner nunca recibe credenciales directas ni tablas internas.
Revisión antes de postear
Las facturas entran a staging y se auditan antes de afectar libros.
Aislamiento por cliente
La conexión resuelve empresa y sucursal desde credenciales, no desde payload libre.