Puntos clave
- Primero el diagnóstico: auditamos el ERP, las planillas y los flujos reales antes de proponer cualquier cambio.
- Si el sistema actual sigue sirviendo al negocio, se integra vía API; se reconstruye solo lo que frena la operación.
- Una capa de integración aísla al sistema legacy y expone un contrato estable al resto de la empresa.
- Webhooks, colas con reintentos e idempotencia evitan pérdidas de datos cuando un sistema falla.
- La trazabilidad y la seguridad se diseñan desde el inicio: no son extras para agregar al final.
En casi todas las empresas que crecen aparece el mismo síntoma: el ERP factura, el e-commerce vende, el CRM registra oportunidades y el depósito controla stock, pero ninguno de esos sistemas habla con los demás. La integración termina siendo una persona copiando datos entre pantallas o una planilla que se actualiza «cuando se puede». Cada dato duplicado es una fuente de error, y cada error termina llegando al cliente.
La tentación habitual es reemplazar todo de una vez. En la práctica, reescribir un sistema que sostiene la facturación diaria es el camino más caro y más riesgoso. Lo que funciona es otra estrategia: entender a fondo lo que ya existe, rodearlo con una capa de integración bien diseñada y cambiar solo lo que realmente frena la operación.
Nuestra regla: diagnóstico antes que código
Antes de proponer una arquitectura, analizamos en detalle todo lo que la empresa ya usa: el ERP, las planillas de Excel, el CRM, los sistemas de terceros y, sobre todo, los pasos manuales que unen todo eso. Muchas veces el problema no es el ERP sino la falta de conexión entre el ERP y el resto de los canales.
Qué relevamos en el diagnóstico
- Inventario de sistemas: qué herramienta usa cada área, quién carga cada dato y cuál es la fuente de verdad de cada entidad (clientes, productos, stock, precios).
- Cargas duplicadas: dónde el mismo dato se ingresa dos o más veces, y cuánto tiempo del equipo se va en eso.
- Puntos de acceso disponibles: si el sistema tiene API, si se puede leer una réplica de su base de datos, si genera exportaciones o intercambia archivos.
- Volúmenes y ventanas horarias: cuántas operaciones por día, en qué momentos y con qué tolerancia a demoras.
- Reglas de negocio implícitas: las que viven en la cabeza de una persona o en fórmulas de una planilla, y que ningún sistema documenta.
Integrar o reconstruir: el criterio
Si el ERP o las planillas siguen cumpliendo bien su función y el problema es que no se conectan con otros canales, los integramos vía API y los dejamos hacer lo que hacen bien. Recién cuando la herramienta actual bloquea la operación —no escala, no permite modelar una regla de negocio clave u obliga a duplicar carga manual todos los días— conviene reconstruir esa parte, y siempre de forma incremental.
Caso aplicado en el sector financiero
Patrones desacoplados para integrar sin frenar la operación
Una capa de integración que aísla al legacy
Los sistemas legacy suelen tener modelos de datos que reflejan decisiones de hace años: códigos de producto con significado oculto, estados que se infieren combinando columnas, fechas guardadas como texto. Si cada servicio nuevo consume esos modelos tal cual, el desorden se replica en cada integración.
Por eso ubicamos un servicio intermedio —una capa anticorrupción— cuya única responsabilidad es traducir: recibe el formato del sistema viejo y expone una API con un contrato limpio, documentado con OpenAPI y versionado desde el primer día (/v1/). Si mañana el ERP se reemplaza, cambia la capa de integración, no cada sistema que depende de ella.
Webhooks y eventos en lugar de sincronizaciones manuales
No todas las integraciones necesitan respuesta inmediata. Consultar el precio vigente al armar un carrito sí requiere una llamada sincrónica. Pero avisar al ERP que se concretó una venta, actualizar el CRM o descontar stock conviene resolverlo de forma asincrónica, con webhooks o eventos: si el ERP está en mantenimiento, el evento espera y se procesa cuando vuelve.
Colas con reintentos e idempotencia
En sistemas distribuidos los mensajes se duplican y los servicios fallan; la pregunta no es si va a pasar, sino qué ocurre cuando pasa. Cada mensaje lleva una clave única para que el receptor detecte duplicados, los fallos transitorios se reintentan espaciando los intentos, y los que fallan de forma persistente pasan a una cola de revisión en lugar de bloquear al resto. Un receptor de webhooks idempotente, en Laravel, puede ser así de simple:
public function handle(StockMovementRequest $request): JsonResponse
{
$key = $request->header('Idempotency-Key');
// Evento ya procesado: respondemos OK sin repetir la operación.
// La columna "key" tiene índice único: dos entregas simultáneas no pasan juntas.
if (ProcessedEvent::where('key', $key)->exists()) {
return response()->json(['status' => 'duplicate'], 200);
}
DB::transaction(function () use ($request, $key) {
StockService::applyMovement($request->validated());
ProcessedEvent::create(['key' => $key]);
});
return response()->json(['status' => 'processed'], 202);
}Cuando el procesamiento es más pesado, el receptor solo valida y encola, y un worker hace el trabajo con reintentos y backoff configurados:
class SyncInvoiceToErp implements ShouldQueue
{
use Dispatchable, InteractsWithQueue, Queueable;
public int $tries = 5;
/** Segundos entre reintentos: 10s, 1 min, 5 min, 15 min. */
public function backoff(): array
{
return [10, 60, 300, 900];
}
public function handle(ErpClient $erp): void
{
$erp->upsertInvoice($this->invoice->toErpPayload());
}
}Trazabilidad de punta a punta
Cuando un pedido atraviesa cinco sistemas, la pregunta «¿dónde se trabó?» tiene que poder responderse en minutos. Para eso cada operación lleva un ID de correlación que viaja en todas las llamadas y mensajes, los logs son estructurados y cada integración expone métricas básicas: volumen, tasa de error y tamaño de la cola pendiente. Con alertas sobre esos indicadores, los problemas se detectan antes de que los reporte un cliente.
Seguridad en cada integración
- Firmas HMAC en los webhooks entrantes, para verificar que el mensaje viene de quien dice venir y no fue alterado.
- Tokens con el mínimo privilegio necesario y credenciales fuera del repositorio, en variables de entorno o un gestor de secretos.
- Validación estricta de cada payload antes de tocar la base de datos: tipos, rangos y campos obligatorios.
- HTTPS obligatorio, límites de tasa por cliente y registro de auditoría de las operaciones sensibles.
Una secuencia de migración que funciona
- Diagnóstico: mapear sistemas, flujos y fuentes de verdad, y decidir qué se integra y qué se reconstruye.
- Instalar la capa de integración en modo lectura, sin cambiar todavía ningún comportamiento.
- Activar primero el flujo de mayor dolor y menor riesgo —por ejemplo, la sincronización de stock—, validando contra la operación real.
- Pasar a eventos los procesos que hoy dependen de tareas programadas o de carga manual.
- Retirar los procesos viejos recién cuando el nuevo flujo demostró estabilidad en producción.
La integración de sistemas no es un proyecto de infraestructura aislado: es lo que permite que la operación escale sin sumar personas para mover datos de un lado a otro. Hecha con criterio, se implementa de forma incremental, sin detener la facturación ni un solo día.
Preguntas frecuentes
¿Se puede integrar un ERP que no tiene API?
Sí, en la mayoría de los casos. Según el sistema, se puede leer una réplica de su base de datos, procesar exportaciones programadas o intercambiar archivos por SFTP. Ese mecanismo se encapsula detrás de una API propia, para que el resto de los sistemas no dependa de cómo se obtiene el dato.
¿Integrar sistemas obliga a frenar la operación?
No. La integración se construye en paralelo: primero en modo lectura, después validando resultados contra la operación real y, recién entonces, activando la escritura por etapas. Cada paso tiene vuelta atrás, así que el equipo sigue trabajando con sus herramientas de siempre durante todo el proceso.
¿Los microservicios son siempre la mejor arquitectura?
No. Para muchas PyMEs alcanza con un sistema principal bien modularizado y un servicio de integración. Los microservicios suman costo operativo, así que los proponemos cuando hay dominios realmente independientes, necesidades de escala distintas o equipos que necesitan desplegar por separado.

