En tolola.tech terminamos recientemente el proyecto tango-integration-interapis: una integración entre el sistema de reportería de Tango Gestión y la API de confección de archivos de Interbanking. El resultado fue el mismo para los dos clientes — cero intervención manual en el proceso de pagos masivos.
En este artículo contamos cómo fue el proyecto, qué desafíos encontramos y por qué este tipo de integración vale la pena.
El problema que teníamos que resolver
Los dos clientes compartían el mismo dolor: usaban Tango Gestión para administrar su contabilidad y proveedores, pero el proceso de pago masivo a través de Interbanking era completamente manual.
El flujo antes de la integración era más o menos así:
- El equipo de administración exportaba un reporte de Tango en Excel
- Alguien lo revisaba, limpiaba y reformateaba a mano
- Se subía el archivo al portal de Interbanking
- Se esperaba la confirmación y se conciliaba de nuevo en Tango
Tiempo invertido por ciclo de pago: entre 3 y 5 horas. Con errores humanos frecuentes y dependencia total de una persona clave.
La solución: tango-integration-interapis
Diseñamos una capa de integración en Node.js + NestJS que conecta ambos extremos de forma automática.
Cómo funciona el flujo integrado
Tango Gestión (reportería)
↓
API interna que lee y transforma los datos
↓
Generación automática del archivo de confección Interbanking
↓
Upload vía API a la plataforma bancaria
↓
Confirmación y registro automático en el sistema
Los componentes principales
1. Extractor de reportes de Tango
Tango Gestión expone sus datos a través de reportes configurables. Construimos un módulo que consume esos reportes en formato estructurado y los normaliza para el paso siguiente.
2. Transformador al formato Interbanking
Interbanking tiene un formato de archivo de confección específico — campos de longitud fija, codificación particular, cabeceras y totales de control. Construimos un parser que transforma los datos de Tango al formato exacto que la API bancaria espera.
3. Validaciones previas
Antes de enviar cualquier archivo, el sistema valida: CBUs correctos, importes dentro de límites, coherencia de totales, fechas de acreditación válidas. Si algo falla, se notifica por email antes de que llegue al banco.
4. Integración con la API de Interbanking
La confección y envío de lotes de pago se realiza a través de la API de Interbanking, con autenticación por certificado digital y manejo de reintentos ante errores transitorios.
5. Registro y trazabilidad
Cada operación queda registrada con su estado, timestamp y referencia bancaria. El equipo de administración puede ver en tiempo real qué pagos se procesaron, cuáles quedaron pendientes y cuáles fallaron.
Los desafíos reales del proyecto
La documentación de Interbanking no es pública
Este fue el primer obstáculo. La API de Interbanking no tiene documentación abierta — se accede mediante acuerdo comercial con el banco. Trabajar con el equipo técnico del cliente para obtener las especificaciones y los certificados llevó tiempo, pero es un paso inevitable.
El formato de archivos tiene muchas variantes
Interbanking tiene distintos formatos según el tipo de operación: transferencias, débitos, pagos de haberes. Cada uno tiene sus propias reglas. Diseñamos el transformador de forma modular para que cada tipo de operación tenga su propia lógica sin mezclar responsabilidades.
Los datos de Tango necesitan limpieza
Los reportes de Tango son muy ricos en información, pero no siempre están normalizados de la forma que Interbanking espera. CBUs con espacios, importes con formato incorrecto, campos opcionales vacíos — el módulo de validación fue clave para detectar estos casos antes del envío.
Ambientes de prueba limitados
Interbanking tiene un ambiente de homologación, pero no replica todos los escenarios de producción. Parte de las pruebas finales se hicieron en producción con lotes de bajo importe, con rollback manual preparado.
El resultado
| Métrica | Antes | Después |
|---|---|---|
| Tiempo por ciclo de pago | 3 a 5 horas | 8 minutos |
| Errores humanos | Frecuentes | Cero |
| Dependencia de persona clave | Alta | Eliminada |
| Trazabilidad | Manual en planilla | Automática con logs |
Los dos clientes pasaron de un proceso propenso a errores y dependiente de una persona a un pipeline completamente automatizado que corre sin intervención.
¿Cuándo tiene sentido hacer esta integración?
Esta solución es especialmente valiosa para empresas que:
- Procesan más de 20 pagos por ciclo (proveedores, haberes, comisiones)
- Ya usan Tango Gestión como sistema contable
- Operan con Interbanking como plataforma bancaria principal
- Tienen errores recurrentes en el proceso manual de carga de archivos
- Quieren eliminar la dependencia de una persona que "sabe cómo hacerlo"
Stack técnico
- Backend: Node.js + NestJS
- Integración Tango: Reportería vía módulo de exportación configurado
- Integración Interbanking: API de confección con autenticación por certificado digital
- Notificaciones: Email automático ante errores o confirmaciones
- Infraestructura: Deploy en VPS con cron jobs para ejecución programada
¿Tu empresa tiene el mismo problema?
Si usás Tango Gestión y Interbanking y todavía estás procesando pagos de forma manual, podemos ayudarte.
En tolola.tech hacemos la primera reunión sin costo para entender tu caso y ver si esta integración aplica a tu operación.
📩 tololatech@gmail.com
💬 WhatsApp: +54 9 11 2724-6517
🌐 www.tolola.tech
tolola.tech es una consultora de desarrollo de software especializada en integraciones API, automatización e IA. Buenos Aires, Argentina.
Top comments (0)