En operaciones de alimentación corporativa que han crecido, la acumulación de sistemas es inevitable: un software de gestión de menús, un ERP contable, un sistema de facturación electrónica, reportes de Excel para el cliente, y alguna herramienta de comunicación interna. El problema no es tener varios sistemas: es que ninguno habla con los demás y alguien tiene que cargar los mismos datos dos, tres o cuatro veces.
La doble carga de datos no es solo ineficiente. Es una fuente permanente de errores: facturas que no coinciden con los pedidos, reportes que no cuadran con la contabilidad, insumos que figuran en stock pero ya se consumieron. Este artículo describe los patrones de integración que resuelven ese problema de forma práctica.
El problema real: datos maestros inconsistentes
Antes de pensar en webhooks o APIs, hay que entender por qué los sistemas no coinciden. La causa más frecuente no es técnica: es que los mismos objetos del negocio (un cliente, un producto, un proveedor) tienen nombres o códigos distintos en cada sistema.
El cliente "Banco XYZ - Casa Central" en el sistema de pedidos puede estar cargado como "XYZ S.A." en el ERP y como "Banco XYZ (CC)" en el sistema de facturación. Técnicamente son el mismo cliente, pero ningún sistema lo sabe. Integrar sistemas con datos maestros inconsistentes solo automatiza la inconsistencia.
Antes de integrar: limpiar los maestros
El trabajo previo imprescindible antes de cualquier integración:
- Elegir un sistema como fuente de verdad para cada entidad (clientes, productos, proveedores).
- Asignar un identificador único a cada entidad que viaje a todos los sistemas.
- Definir quién puede crear registros nuevos en cada entidad y desde qué sistema.
Sin este paso, la integración va a funcionar técnicamente y va a generar inconsistencias de negocio de todos modos.
Webhook vs. polling: cuándo usar cada uno
Son los dos patrones fundamentales para sincronizar sistemas. La elección incorrecta genera retrasos o carga innecesaria en la infraestructura.
Webhooks (push)
El sistema origen envía una notificación al sistema destino en el momento en que ocurre un evento. Ejemplo: cuando se confirma un pedido en SPA Lunch, se dispara automáticamente una llamada al ERP para crear el comprobante de venta.
Cuándo conviene: para eventos que deben procesarse en tiempo real o casi real. Confirmación de pedidos, aprobación de facturas, cambios de estado de entrega.
Consideraciones: el sistema destino debe estar disponible para recibir la notificación. Si no lo está, se necesita un mecanismo de reintentos. Siempre implementar idempotencia: si el mismo evento llega dos veces, no debe generar dos registros.
Polling (pull)
El sistema destino consulta periódicamente al sistema origen para ver si hay datos nuevos. Ejemplo: el ERP consulta cada 15 minutos si hay pedidos nuevos para importar.
Cuándo conviene: cuando el sistema origen no soporta webhooks, cuando los volúmenes son bajos, o cuando pequeñas demoras en la sincronización son aceptables.
Consideraciones: definir una ventana de polling razonable. Consultar cada minuto genera carga innecesaria; consultar cada hora puede crear retrasos inaceptables en flujos críticos.
El flujo integrado: de pedido a factura sin intervención manual
El flujo más valioso en alimentación corporativa es el que va desde la confirmación del pedido hasta la factura electrónica emitida y el reporte al cliente generado. Así se ve un flujo bien integrado:
- Pedido confirmado en SPA Lunch → se crea automáticamente en el ERP como orden de venta con el ID de cliente y los ítems con sus códigos maestros.
- Entrega registrada → el ERP actualiza el estado de la orden y genera el remito electrónico.
- Cierre de período → el ERP consolida las órdenes del período y genera la factura electrónica con el detalle de consumo por empleado o por área.
- Factura aprobada → el sistema de reportes genera automáticamente el informe de consumo para el cliente corporativo.
En este flujo, el único punto de intervención humana es la revisión antes de emitir la factura. Todo lo demás es automático.
Qué exponer por API y qué no
No todo tiene que estar integrado. Exponer demasiados endpoints o sincronizar demasiados datos en tiempo real agrega complejidad sin beneficio proporcional.
Sí integrar en tiempo real:
- Estado de pedidos (confirmado, en producción, entregado).
- Datos de facturación (montos, ítems, cliente, período).
- Stock de insumos críticos si hay múltiples cocinas que comparten bodega.
Integrar en batch (diario o semanal):
- Histórico de consumo por cliente para reportes.
- Movimientos contables para conciliación.
- Actualización de precios de insumos desde el ERP hacia el sistema de costos.
No integrar (gestionar manualmente o no gestionar):
- Datos históricos que no generan decisiones operativas.
- Información que cambia con muy baja frecuencia y cuya inconsistencia temporal no tiene impacto.
Auditoría de integraciones: qué registrar siempre
Toda integración debe registrar, como mínimo:
- Timestamp de cada evento enviado y recibido.
- ID del objeto involucrado en cada transacción.
- Estado de la operación: éxito, error, reintento.
- Payload de la solicitud y la respuesta (o al menos un hash para trazabilidad sin almacenar datos sensibles).
Estos registros son indispensables para diagnosticar problemas. Cuando una factura no coincide con el pedido, el log de integración es lo primero que hay que revisar.
Consideraciones específicas para Argentina
La integración con sistemas de facturación electrónica en Argentina tiene particularidades que no aplican en otros mercados:
- Los comprobantes deben seguir el esquema de AFIP (tipos de comprobante, puntos de venta, CAE).
- Las actualizaciones de alícuotas de IVA deben propagarse a todos los sistemas en forma sincronizada.
- Los remitos electrónicos para transporte de mercadería tienen requisitos propios si aplica.
Si el ERP ya gestiona la facturación electrónica con AFIP, el flujo recomendado es que SPA Lunch alimente al ERP con los datos operativos y deje toda la lógica fiscal en el ERP. Duplicar la lógica fiscal en el sistema operativo es una fuente de problemas garantizada.