Sistemas internos de gestión: conecta tu ERP

En tu día a día, la presión de modernizar los procesos se topa con la realidad de que ya tienes herramientas críticas funcionando: planillas, sistemas de facturación y plataformas de cobro. En este artículo verás, con ejemplos concretos del contexto peruano, cómo conectar un nuevo sistema interno de gestión de operaciones con esas piezas sin perder datos ni tiempo.

Con qué se tiene que hablar

Antes de diseñar cualquier integración, es esencial mapear todos los sistemas que tu empresa mantiene en producción. En la práctica peruana, la lista suele incluir:

• Planillas Excel o Google Sheets que alimentan reportes de producción y control de inventario.
• Software de facturación electrónica ya certificado por la SUNAT (por ejemplo, Nubefact o Facturama).
• Plataformas de gestión de compras que operan sobre módulos de SAP Business One o soluciones locales.
• Sistemas de recursos humanos que manejan nómina y horarios.
• Herramientas de BI como Power BI o Qlik, que consumen datos de bases internas.

Cada uno de estos sistemas tiene una API (o, en el caso de Excel, un punto de acceso mediante ODBC/ODBC‑like) y un esquema de datos propio. El primer paso es crear un inventario de interfaces: nombre del sistema, versión, método de acceso (REST, SOAP, JDBC) y frecuencia de actualización requerida. Este inventario sirve como contrato de integración y evita sorpresas cuando el proyecto avanza.

Una práctica recomendada es definir puntos de sincronización claros:

• Datos maestros (clientes, proveedores, productos) se sincronizan en tiempo real o cada 5 min, según la criticidad.
• Transacciones operativas (órdenes de producción, tickets de servicio) pueden enviarse en lotes cada 15 min para reducir carga.
• Indicadores de rendimiento se actualizan en el BI al final del día.

Con este mapa, el equipo de desarrollo puede diseñar conectores que lean y escriban únicamente los campos necesarios, reduciendo el riesgo de colisiones de datos.

SUNAT y facturación electrónica

La normativa peruana exige que toda emisión de comprobantes electrónicos pase por la SUNAT en tiempo real. Los proveedores de facturación electrónica ofrecen APIs certificadas que aceptan JSON o XML y devuelven el CDR (Código de Respuesta) en segundos.

Requisitos clave:

1. Certificado digital: tu empresa debe contar con un certificado .pfx que la API usa para firmar los documentos.
2. Catálogo de tipos de documento: no todos los proveedores soportan todos los códigos de operación; verifica que el que usas (factura, boleta, nota de crédito) esté habilitado.
3. Límites de tasa: la SUNAT permite un máximo de 10 000 comprobantes por hora por empresa; si tu volumen supera ese número, necesitas un plan de alta disponibilidad.

Errores típicos:

• Campos obligatorios incompletos: la SUNAT rechaza facturas sin el número de documento del cliente o sin el código de unidad de medida. La API suele devolver un mensaje de error 400 con la lista de campos faltantes.
• Desincronización de estados: si tu ERP marca la factura como “pagada” antes de recibir el CDR, puedes generar conciliaciones erróneas. La solución es crear una cola de eventos que solo actualice el estado tras el ACK de la SUNAT.
• Cambios de versión de API: los proveedores actualizan sus endpoints cada 12 meses. Mantén una suscripción a su boletín técnico y versiona tu cliente para que, en caso de cambio, solo se actualice el módulo de integración.

Una estrategia práctica es implementarla en dos capas: un micro‑servicio de “Facturación” que se encarga de la comunicación con la SUNAT y un adaptador dentro del ERP que envía los datos a ese micro‑servicio. Así, si cambian los requisitos, solo tocas la capa de facturación.

Cobros y bancos

En Perú, la diversificación de medios de pago ha crecido: Yape, Plin, Niubiz, Izipay y la integración directa con bancos (BBVA, Interbank). Cada uno tiene su propio modelo de API y sus tiempos de respuesta.

Yape y Plin

• Tipo de integración: Webhooks + API REST.
• Flujo típico: tu sistema genera una solicitud de cobro (monto, número de teléfono) → el cliente autoriza en la app → el webhook envía confirmación.
• Tiempo de confirmación: 2‑5 segundos en promedio.
• Errores comunes: token expirado (renovar cada 24 h) y número no registrado (validar antes de enviar).

Niubiz y Izipay

• Tipo de integración: API REST con firma HMAC.
• Flujo típico: petición de pago → redirección a página de checkout → respuesta sincrónica con código de autorización.
• Tiempo de confirmación: 1‑2 segundos.
• Errores comunes: divergencia entre monto solicitado y monto autorizado (por redondeo) y fallas de certificado SSL.

Bancos (transferencias ACH, CCI)

• Tipo de integración: archivos CNV (CSV) o API SOAP.
• Frecuencia: suele procesarse en lotes nocturnos; la conciliación llega en 24 h.
• Errores comunes: número de cuenta mal formateado y rechazo por falta de fondos.

Cómo conectar de verdad

1. Centraliza los tokens: guarda los tokens de acceso en un vault interno (por ejemplo, HashiCorp Vault) y renueva automáticamente con cron de 12 h.
2. Normaliza los estados: crea una tabla de estados de pago (pendiente, autorizado, rechazado, conciliado) y mapea cada respuesta de los proveedores a esos estados.
3. Implementa reintentos exponenciales: si un webhook no llega, reintenta 3 veces con intervalos de 1, 5 y 15 min antes de marcar como fallido.
4. Audita cada transacción: registra request/response completo con timestamp y hash de integridad para cumplir con la normativa de la SBS.

Con esta arquitectura, tu ERP puede mostrar en tiempo real el avance del cobro sin importar el medio que el cliente elija.

Qué pedirle al proveedor

Cuando decides integrar un sistema externo, el acuerdo de nivel de servicio (SLA) y la calidad de la documentación son tan críticos como la funcionalidad del propio software.

APIs y documentación

• Especificación OpenAPI/Swagger: permite generar automáticamente clientes en Java, .NET o Python. Exige que el proveedor mantenga el spec actualizado al menos cada trimestre.
• Versionado semántico: la URL debe incluir la versión (v1, v2). Cambios mayores requieren que el proveedor notifique con al menos 30 días de antelación.
• Entorno de sandbox: indispensable para pruebas sin afectar datos reales. Asegúrate de que el sandbox reproduzca latencias y códigos de error del entorno productivo.

Cambios en la otra parte

• Webhooks de versión: solicita que el proveedor envíe un webhook cuando publique una nueva versión o cambie un endpoint.
• Política de deprecación: debe haber al menos 60 días de coexistencia entre la versión antigua y la nueva.
• Soporte técnico: un canal de tickets con SLA de 4 h para incidencias críticas.

Contrato de integración

Redacta un acuerdo de integración que incluya:

• Responsabilidades: quién valida los datos, quién mantiene la infraestructura de red y quién gestiona los certificados.
• Métricas de disponibilidad: 99.5 % de uptime mensual, latencia máxima 200 ms para respuestas síncronas.
• Procedimientos de emergencia: plan de rollback en caso de fallo de la API, con tiempo estimado de 2 h para volver a la versión estable.

Al tener estos puntos claros, reduces el riesgo de que un cambio inesperado en el proveedor provoque interrupciones en tu operación.

Conclusión

Has visto cómo, paso a paso, puedes conectar un nuevo sistema interno de gestión de operaciones con los aplicativos, la SUNAT y los medios de pago que ya utilizas en Perú. El proceso comienza con un inventario preciso de los sistemas existentes, sigue con la adaptación a los requisitos de facturación electrónica, pasa por la normalización de los cobros a través de múltiples plataformas y termina con la definición de requisitos claros para los proveedores externos. Aplicando estos principios, tu empresa logra una integración fluida, reduce tiempos de inactividad y mantiene el control sobre la información crítica sin sacrificar la inversión ya realizada en herramientas actuales.