API REST y GraphQL
La vía preferente cuando el ERP la expone: Holded, Odoo reciente, Sage Business Cloud o el Service Layer de SAP Business One.
Ingeniería · Integración de ERP
Integración de ERP: SAP, Sage, Holded, Odoo y sistemas legacy
Conectamos tu ERP con el resto de tus sistemas para que el dato deje de viajar en copiar y pegar. SAP Business One, Sage 50 y 200, Holded, Odoo o un ERP propietario de hace quince años sin API documentada. El método lo decide el sistema, no nuestra preferencia: API REST si la hay, SOAP, EDI o webhooks si no, y lectura directa de la base de datos cuando no queda otra vía.
Actualizado:
Definiciones clave
- ERP legacy
- Sistema de gestión antiguo, a menudo propietario y sin API moderna documentada. Se integra por SOAP, por exportaciones programadas con parseo o leyendo su base de datos en modo solo lectura.
- EDI (Electronic Data Interchange)
- Estándar de mensajería B2B (EDIFACT en Europa, ANSI X12 en América) usado en logística, automoción y gran consumo para intercambiar pedidos, facturas y albaranes de forma estructurada.
- Webhook
- Aviso HTTP que un sistema envía a otro cuando ocurre un evento. Permite sincronizar casi al instante sin preguntar cada minuto si ha cambiado algo.
- Cola de errores irrecuperables
- Cola donde acaban los mensajes que han agotado todos los reintentos. Permite que una persona los analice y los corrija sin que se pierda ningún dato.
Cómo se integra un ERP, incluido el que no tiene API
Integrar un ERP es conectar el sistema donde vive el dato maestro —clientes, artículos, pedidos, facturas— con el software que lo necesita. Cuando esa conexión no existe, alguien la hace a mano: exporta, pega, corrige. El coste no es solo el tiempo; es que el dato deja de ser fiable y nadie sabe cuál de las dos copias es la buena.
Los ERP que aparecen en las empresas españolas son casi siempre los mismos, y cada uno expone los datos de una forma distinta. Holded y las versiones nuevas de Odoo tienen API REST razonable. SAP Business One se integra por Service Layer (REST) o por la DI API (SOAP heredado). Sage 50 y Sage 200 dependen mucho de la versión y de cómo se instaló. Y luego está el ERP propietario, escrito hace años, sin documentación y sin nadie que recuerde por qué esa tabla se llama así.
En ese último caso —el de los sistemas legacy— la integración no es imposible, es distinta. Se usa lo que el sistema permita, por orden de fiabilidad: SOAP heredado, exportaciones programadas con parseo, EDI en formato EDIFACT o X12 cuando el sector lo usa, o acceso de solo lectura a la base de datos a través de vistas. La última opción es automatizar contra la interfaz gráfica (RPA): funciona, y se rompe en cuanto alguien cambia una pantalla. Si el proyecto va a acabar ahí, se dice antes de firmar.
Una integración no está terminada cuando los datos empiezan a moverse. Está terminada cuando se sabe qué pasa el día que fallan: cola de reintentos con espera creciente, cola de errores irrecuperables para que una persona los revise, y un registro de qué entró, qué salió y qué se quedó por el camino. Los fallos silenciosos de sincronización son el motivo por el que nadie se fía del dato.
Este problema —un documento que entra por un canal externo y tiene que acabar como un registro estructurado dentro de un sistema— es exactamente el que resuelve Perizial, nuestro SaaS de peritaje en producción: el encargo de la aseguradora entra por correo, PDF o integración, y sale como un expediente asignado al perito correcto sin que nadie lo teclee. Si lo que necesitas no es conectar el ERP sino sustituir el sistema legacy por fases, ese es otro trabajo y tiene su propia página.
Vías de integración y qué se entrega
SOAP heredado
Para ERP y servicios web antiguos que nunca llegaron a tener REST, como la DI API de SAP Business One.
EDI (EDIFACT y X12)
Mensajería B2B estructurada en logística, automoción y gran consumo: ORDERS, INVOIC, DESADV, RECADV.
Webhooks bidireccionales
Sincronización casi inmediata sin sondeo continuo, con verificación de firma en cada mensaje entrante.
Lectura directa de la base de datos
Cuando el ERP legacy no expone nada: acceso de solo lectura a través de vistas, sin escribir nunca en sus tablas.
Cola de reintentos
Espera creciente entre reintentos y cola de errores irrecuperables. Un mensaje que falla no se pierde: se queda esperando a una persona.
Reglas de mapeo en configuración
La transformación de datos entre sistemas vive en configuración, no enterrada en el código. Cambiarla no exige un despliegue.
Registro de cada sincronización
Qué entró, qué salió, qué falló y cuándo. Es lo que permite reconciliar cuando dos sistemas discrepan.
Migración del histórico
Carga inicial con validación, deduplicación y reconciliación contra el origen, con un informe de qué registros no cuadran.
Dónde se puede ver funcionando
La ingesta de Perizial es una integración de este tipo funcionando en producción. El encargo de peritaje llega por correo, por PDF adjunto o por integración con el sistema de la aseguradora; se extraen los datos, se valida, se crea el expediente y se asigna al perito correcto por especialidad, geografía y carga de trabajo. Nadie teclea nada. Perizial está en producción con clientes de pago y planes públicos desde 69,99 € al mes: la integración se puede ver en marcha, no solo en un diagrama.
Preguntas frecuentes
- ¿Con qué ERP se puede integrar?
- Con cualquiera que exponga sus datos por alguna vía: API REST, SOAP, EDI, webhooks, exportaciones programadas o acceso de solo lectura a su base de datos. En España los más habituales son SAP Business One, Sage 50 y Sage 200, Holded y Odoo. Antes de presupuestar se comprueba qué expone el sistema de verdad, porque la documentación de un ERP y su comportamiento real no siempre coinciden.
- ¿Y si nuestro ERP es legacy y no tiene API moderna?
- Se integra igual, por la vía que el sistema permita. Por orden de fiabilidad: SOAP heredado, exportaciones programadas con parseo, EDI, o acceso de solo lectura a la base de datos con vistas. La última opción es automatizar contra la interfaz (RPA): funciona, pero se rompe cuando cambia una pantalla. Si hay que llegar ahí, se dice antes de firmar, no después.
- ¿Integrar el ERP legacy o sustituirlo?
- Integrar, casi siempre, si el ERP hace bien su trabajo. Sustituir un ERP que funciona es el proyecto más caro y más arriesgado que puede acometer una empresa, y rara vez lo justifica el ahorro. La modernización tiene sentido cuando el sistema ya no se puede mantener ni evolucionar; en ese caso, la migración se hace por fases y sin parar producción.
- ¿La sincronización es en tiempo real o por lotes?
- Depende del dato. El dato crítico (un pedido, un stock, un expediente) va en tiempo real con webhooks o eventos. El dato masivo y no crítico (conciliación contable, informes) va por lotes nocturnos. La decisión es de coste y de operación, no de preferencia técnica.
- ¿Qué pasa cuando una sincronización falla?
- El mensaje no se pierde: entra en una cola de reintentos con espera creciente y, si agota los reintentos, va a una cola de errores irrecuperables para que una persona lo revise. Cada integración se entrega con un registro de qué entró, qué salió y qué falló. Una integración sin ese registro no está terminada, porque los fallos silenciosos se descubren tres días tarde.
- ¿Habéis integrado un flujo así en producción?
- Sí. Perizial recibe los encargos de peritaje de las aseguradoras por correo, PDF o integración, extrae los datos con IA y los convierte en un expediente asignado al perito correcto, sin que nadie los teclee. Está en producción con clientes de pago. Es el mismo problema que una integración de ERP: un documento que entra por un canal externo y tiene que acabar como un registro estructurado y fiable dentro de un sistema.
- ¿Trabajáis con empresas de Lugo y de Galicia?
- Sí. El domicilio social de Cyber Vault SL está en Lugo, y trabajamos en remoto con clientes de toda España y de la Unión Europea. La integración de un ERP se hace contra el sistema, no contra la oficina: lo que importa es qué expone el ERP y quién tiene las credenciales.
Servicios relacionados
Modernización de software legacy →
Cuando el ERP legacy no hay que conectarlo, sino sustituirlo por fases y sin parar producción.
Automatización de procesos →
Cuando lo que hay que automatizar es el proceso completo, y el ERP es solo una de sus paradas.
Desarrollo de software a medida →
Cuando el sistema que tiene que hablar con el ERP todavía hay que construirlo.
¿Hablamos de tu proyecto?
Escribe a [email protected] y cuenta qué proceso quieres automatizar, qué datos toca y con qué sistemas tiene que hablar. Con eso se puede responder si tiene sentido, qué alcance tendría y en qué rango de precio cae.