Conecta tu nuevo sistema al ecosistema actual

Migrar de Excel a un sistema propio es solo el comienzo; el verdadero reto está en que el nuevo software hable el mismo idioma que los procesos y plataformas que tu empresa ya utiliza. En este artículo verás, con ejemplos concretos y plazos claros, cómo conectar tu solución a los sistemas críticos de SUNAT, a los medios de cobro locales y a las APIs que ya tienes en marcha.

Con qué se tiene que hablar

Antes de escribir una sola línea de código, es esencial mapear el panorama tecnológico de tu empresa. En la mayoría de los negocios peruanos que manejan datos en Excel, los siguientes elementos suelen estar presentes y no se van a tirar:

• Bases de datos auxiliares: MySQL, PostgreSQL o incluso Access que alimentan reportes internos.
• Plataformas de gestión: ERP ligero, sistemas de inventario o módulos de facturación que ya están integrados con la SUNAT.
• Herramientas de colaboración: Google Workspace o Microsoft 365, donde los archivos Excel se comparten y se actualizan en tiempo real.
• Sistemas de tickets o help desk: que registran incidencias y están vinculados a la hoja de seguimiento de SLA.
• Automatizaciones con RPA: scripts que extraen datos de Excel para enviarlos a correo o a un dashboard.

El primer paso es crear un inventario de interfaces. Cada punto de contacto debe describirse con:

1. Tipo de integración (API REST, SOAP, archivo CSV, Webhook).
2. Frecuencia de sincronización (en tiempo real, cada 15 min, batch nocturno).
3. Volumen de datos (filas/mes, transacciones/día).
4. Responsable interno y externo.

Con esta tabla, el equipo de desarrollo puede estimar el esfuerzo: típicamente una semana para mapear y documentar, dos a tres semanas para diseñar los conectores y una semana para pruebas unitarias de cada integración.

SUNAT y facturación electrónica

La normativa peruana obliga a emitir comprobantes electrónicos a través de la SUNAT. Tu nuevo sistema debe cumplir con los siguientes requisitos:

• Emisión de XML con el esquema UFE (Formato Único de Facturación Electrónica).
• Firma digital usando certificado digital vigente.
• Validación previa contra el servicio de validación de la SUNAT (código 0 = aceptado).
• Envío de documentos mediante el endpoint de Resumen Diario y Resumen Mensual.

Errores típicos

• Caducidad del certificado: si no se renueva antes de su vencimiento, la emisión se detiene. Solución: programar una alerta 30 días antes.
• Formato de número de documento: la SUNAT rechaza documentos con RUC mal formateado (8 dígitos + dígito verificador). Validar con algoritmo MOD 11.
• Desfase de zona horaria: la hora del servidor debe estar sincronizada a GMT‑5; de lo contrario, los documentos aparecen con marca temporal fuera de rango.

Plazos de integración

• Desarrollo del conector: 2 semanas para generar y firmar XML, 1 semana para pruebas contra el entorno de pruebas de SUNAT.
• Certificación: 1 semana para enviar los primeros 10 documentos y obtener la aprobación.
• Puesta en producción: 1 semana de monitoreo intensivo.

En total, 5 semanas de trabajo dedicado, con una dedicación de 80 horas en promedio.

Cobros y bancos

En Perú, la mayoría de las pymes utilizan medios de pago digitales como Yape, Plin, Niubiz (antes VisaNet) e Izipay. Cada uno tiene su propio modelo de integración.

• Yape y Plin: ofrecen APIs REST que permiten generar links de pago y consultar el estado. La autenticación se hace con Bearer Token que se renueva cada 24 h.
• Niubiz: requiere la firma de un contrato y la generación de certificados PKCS#12. La comunicación se hace mediante SOAP y los resultados llegan en XML.
• Izipay: API REST con webhook de notificaciones de pago; el webhook debe responder 200 OK en menos de 2 segundos.

Conexión real

1. Crear una capa de abstracción en tu sistema que exponga métodos genéricos: generarLinkPago(monto, referencia), consultarEstadoPago(id). Cada método delega al adaptador del proveedor.
2. Mapear los estados de cada plataforma a un estado interno único (p.ej., pendiente, pagado, rechazado).
3. Sincronizar en tiempo real mediante webhooks; si el webhook falla, programar un reintento cada 5 min durante 1 hora.

Plazos estimados

• Diseño de la capa de abstracción: 1 semana.
• Implementación de adaptadores: 1 semana por cada proveedor (en paralelo, 2 semanas si se hacen dos simultáneamente).
• Pruebas de integración y pruebas de carga: 1 semana.
• Ajustes post‑lanzamiento: 1 semana de monitoreo.

Con tres proveedores típicos, el esfuerzo total ronda 5 semanas.

Qué pedirle al proveedor

Una integración exitosa depende de la calidad de la documentación que recibas. Cuando contrates una API externa, solicita siempre lo siguiente:

• Especificación OpenAPI/Swagger actualizada, con ejemplos de request y response.
• Guía de autenticación: tipo de token, proceso de renovación y políticas de expiración.
• Límites de consumo (rate limits) y plan de throttling.
• Mecanismo de versionado: cómo se anuncia una nueva versión y cuánto tiempo se mantiene la anterior.
• Política de cambios: notificación mínima 30 días antes de romper compatibilidad.
• Entorno de pruebas (sandbox) que reproduzca fielmente el comportamiento de producción.

Qué pasa cuando la otra parte cambia

• Versionado semántico: si el proveedor lanza una versión mayor (v2), mantén la versión v1 activa al menos 90 días.
• Adaptador de adaptación: inserta una capa intermedia que traduce los campos nuevos a los que tu sistema espera. Así, solo actualizas esa capa cuando sea necesario.
• Monitor de salud: programa una tarea que verifique diariamente la disponibilidad del endpoint y notifique al equipo si la latencia supera 500 ms.

Conclusión

Quien ha llegado hasta aquí entiende que la migración de Excel a un sistema propio no termina en la captura de datos, sino en la conexión con los ecosistemas ya existentes: bases de datos auxiliares, la SUNAT, los medios de pago locales y los proveedores de API. Con un inventario claro, una capa de abstracción bien diseñada y requisitos de documentación estrictos, puedes lograr una integración robusta en entre 12 y 15 semanas de trabajo, sin interrumpir la operación diaria. El resultado es un flujo continuo de información que elimina la duplicidad de Excel y garantiza cumplimiento legal y financiero en el contexto peruano.