Integración de Brubank
y Banco Comercial.
Integración completa de Brubank y Banco Comercial, preservando Banco Coinag y convirtiendo el back office actual en una operación multibanco.
Alcance funcional
de la integración.
Un operador podrá crear una cuenta, elegir el producto y el banco, y seguir todo su ciclo desde el mismo back office.
◆Banco Coinag
Se conserva la integración vigente y se adapta al nuevo modelo sin interrumpir cuentas existentes.
◆Brubank
Nuevo adaptador para cuentas, saldos, movimientos, transferencias y conciliación.
◆Banco Comercial
Segundo adaptador nuevo, aislado de los demás y conectado al mismo modelo operativo.
Arquitectura actual:
Coinag como único proveedor.
La selección de banco no existe como dato: está implícita en configuración y atraviesa todos los flujos de dinero.
- 01Las cuentas guardan CVU y alias, pero no proveedor ni tipo de producto.
- 02Coinag implementa directamente saldos, transferencias, consultas, CVU y alias.
- 03Existe una sola cuenta recaudadora configurada globalmente.
- 04Transferencias y conciliación consultan siempre al mismo banco.
- 05Créditos entrantes utilizan un único clearing contable.
- Hacer explícito qué banco atiende cada cuenta.
- Separar reglas comunes de contratos particulares.
- Preservar trazabilidad histórica durante la migración.
- Evitar referencias duplicadas entre proveedores.
- Mantener Coinag productivo durante el cambio.
Arquitectura propuesta:
resolución por proveedor.
El negocio opera con una interfaz estable; cada banco traduce su autenticación, formatos, errores y capacidades.
Back office Lohas
Alta, seguimiento, operación, auditoría y conciliación en un único lugar.
Router multibanco
Resuelve proveedor, producto, recaudadora y capacidades de cada cuenta.
Coinag · Brubank · Comercial
Tres adaptadores desacoplados, configurados y monitoreados por separado.
Cambios requeridos
en el modelo de datos.
◆Catálogos operativos
- Proveedores bancarios y capacidades.
- Tipos de cuenta y productos habilitados.
- Cuentas recaudadoras por banco y moneda.
- Clearing contable asociado.
◆Relación bancaria de la cuenta
- Proveedor y producto seleccionados.
- Identificador externo, CBU/CVU y alias.
- Estado de provisionamiento y último error.
- Fechas de solicitud, activación y cierre.
◆Snapshots transaccionales
- Banco y recaudadora en cada transferencia.
- Referencias externas identificadas por proveedor.
- Evidencia preservada aunque la cuenta cambie.
◆Migración Coinag
- Asignación segura a cuentas existentes.
- Compatibilidad hacia atrás durante el despliegue.
- Verificación de cantidades y relaciones.
- Rollback técnico sin pérdida de información.
Cambios en el alta
y gestión de cuentas.
Selección del producto
Banco, tipo de cuenta, cuenta recaudadora y tipo de persona; solo se muestran combinaciones compatibles.
Validación local
Cliente, documentación, permisos y reglas del producto se verifican antes de contactar al banco.
Provisionamiento seguro
La solicitud se envía con idempotencia. Un timeout no crea automáticamente una segunda cuenta.
Seguimiento y recuperación
Estados pendiente, activa, rechazada, suspendida o cerrada; reintentos y consulta externa controlados.
Auditoría
Actor, banco, resultado, cambios y mensajes sanitizados quedan disponibles para soporte y control.
Desarrollo de los
adaptadores bancarios.
◆Autenticación
Credenciales, tokens, renovación, certificados y timeouts aislados por proveedor.
◆Cuentas
Alta, consulta, actualización, baja lógica y recuperación del identificador externo.
◆Saldos
Normalización de saldo actual y disponible sin perder precisión monetaria.
◆Movimientos
Paginación, fechas, referencias y contrapartes traducidas al modelo Lohas.
◆Transferencias
Creación idempotente, resultado confirmado y consulta ante estados inciertos.
◆Errores
Separación entre rechazo de negocio, indisponibilidad, timeout y respuesta ilegible.
Enrutamiento y ejecución
de transferencias.
- 01La orden captura banco, cuenta de origen y recaudadora.
- 02El router selecciona el adaptador correspondiente.
- 03Se usa una referencia idempotente por proveedor.
- 04Solo un éxito confirmado contabiliza la salida.
- 05La referencia bancaria queda vinculada a la orden.
- 01Un timeout queda pendiente; nunca se reenvía a ciegas.
- 02Se consulta al mismo proveedor con la referencia original.
- 03Confirmado, rechazado y ausente tienen reglas explícitas.
- 04Las diferencias pasan a conciliación y revisión.
- 05No se duplica una transferencia por cambiar de banco.
Este trabajo modifica ejecución, recuperación, persistencia, restricciones de unicidad y pruebas del circuito de transferencias.
Procesamiento de créditos,
reversas y webhooks.
◆Recepción
Endpoint, webhook, polling o archivo según el mecanismo provisto por cada banco.
◆Autenticidad
Firma, certificado, secreto o allowlist de red aplicada antes de procesar información.
◆Normalización
Importe, moneda, origen, destino, concepto y referencias convertidos al modelo común.
◆Idempotencia
Las claves se acotan por proveedor para aceptar reintentos y evitar colisiones entre bancos.
◆Contabilización
Crédito o reversa atómica contra el clearing que representa los fondos de ese banco.
◆Evidencia
Hash, estado, intentos y resultado se conservan sin almacenar secretos ni respuestas sensibles completas.
Clearing contable y
conciliación por banco.
Separar los fondos por proveedor permite identificar dónde está el dinero y conciliar cada posición de forma independiente.
◆Conciliación multibanco
Consulta o importación por proveedor; comparación de referencia, importe, cuenta y contraparte; clasificación de diferencias.
◆Operación y evidencia
Archivos o APIs, filtros por banco, corridas protegidas, historial, alertas y revisión sin eliminar evidencia.
Configuración, seguridad
y monitoreo.
◆Secretos
Credenciales separadas por banco y ambiente, nunca guardadas en tablas ni repositorio.
◆Conectividad
Pruebas no destructivas de autenticación, TLS y disponibilidad para cada proveedor.
◆Webhooks
Validación de origen, límites de payload, rate limiting y registro de cada intento.
◆Observabilidad
Métricas, logs y alertas diferenciadas para identificar qué banco está degradado.
◆Despliegue
Variables, verificadores, workers y scheduler actualizados en los ambientes existentes.
◆Privacidad
Minimización de datos, sanitización de errores y actualización del inventario de terceros.
Pruebas técnicas y
homologación bancaria.
- Contratos unitarios por adaptador.
- Alta y recuperación idempotente.
- Transferencias exitosas, rechazadas e inciertas.
- Créditos, reversas y duplicados.
- Clearing y diarios balanceados.
- Regresión completa sobre Coinag.
- Casos felices y rechazos del proveedor.
- Credenciales y conectividad real por ambiente.
- Entrega de eventos o archivos de prueba.
- Comparación de saldos y movimientos.
- Prueba end-to-end desde el back office.
- Evidencia y cierre de observaciones estándar.
Componentes actuales
que deben modificarse.
| Componente actual | Situación actual | Modificación requerida |
|---|---|---|
| accounts | Solo guarda CVU y alias. | Asociar proveedor, producto, recaudadora y estado externo. |
| CoinagClient | Implementa todos los contratos bancarios. | Separar capacidades comunes y conservarlo como adaptador Coinag. |
| AppServiceProvider | Inyecta Coinag para cualquier operación. | Registrar un resolver capaz de elegir adaptador por cuenta. |
| ManageAccountCvu | Usa una recaudadora global. | Recibir el perfil bancario y operar sobre su proveedor. |
| ExecuteTransfer | Envía todas las salidas al mismo gateway. | Resolver y conservar el proveedor de cada orden. |
| ReconcileTransfers | Consulta todas las órdenes en Coinag. | Agrupar y consultar órdenes por proveedor. |
| Webhooks Coinag | Ruta, contrato y validación específicos. | Endpoints y autenticación independientes por banco. |
| Ledger | Un único clearing externo. | Clearing por banco o cuenta recaudadora. |
| DC0 / mov_ | Formatos y canal SFTP de Coinag. | Adaptar el mecanismo equivalente de cada banco. |
Esquema de datos
propuesto.
Resolución de proveedores
y capacidades.
Esta separación evita obligar a Brubank o Banco Comercial a imitar endpoints particulares de Coinag y permite probar cada contrato con dobles deterministas.
Secuencia de creación
de una cuenta bancaria.
◆Límite transaccional
La cuenta local se confirma antes de invocar al banco. Una caída externa no revierte ni deja abierta la transacción de base.
◆Recuperación
Ante timeout se conserva el estado pendiente y se consulta por la referencia idempotente antes de permitir otro envío.
Secuencias transaccionales
y conciliación.
- 01Snapshot de banco y cuenta.
- 02Autorización de cuatro ojos.
- 03Envío al adaptador.
- 04Consulta si el resultado es incierto.
- 05Ledger solo con confirmación.
- 01Autenticar origen.
- 02Validar contrato y tamaño.
- 03Normalizar identificadores.
- 04Deduplicar por proveedor.
- 05Contabilizar vía outbox.
- 01Obtener evidencia bancaria.
- 02Comparar referencia e importe.
- 03Comparar cuentas y CUIT.
- 04Clasificar diferencias.
- 05Exponer revisión sin borrar evidencia.
Condiciones de aceptación
de la implementación.
- El banco seleccionado determina el adaptador usado.
- Las cuentas existentes continúan operando con Coinag.
- Altas repetidas no generan cuentas duplicadas.
- Saldos y movimientos se consultan en su proveedor.
- Transferencias inciertas se resuelven por consulta.
- Créditos y reversas se contabilizan una única vez.
- Ningún secreto aparece en base, logs o auditoría.
- Todo diario financiero permanece balanceado.
- Las referencias no colisionan entre proveedores.
- Webhooks no autenticados se rechazan antes de procesar.
- Conciliación conserva las diferencias como evidencia.
- Configuración incompleta falla antes del despliegue.
Resumen de entregables
incluidos.
| Frente | Entregable verificable | Impacto |
|---|---|---|
| Arquitectura | Router y contratos multibanco | Base reutilizable |
| Datos | Proveedores, productos, recaudadoras y estados | Trazabilidad |
| Migración | Coinag incorporado al nuevo modelo | Continuidad |
| Back office | Alta, selección, seguimiento y auditoría | Operación |
| Brubank | Adaptador bancario completo | Nuevo proveedor |
| Banco Comercial | Adaptador bancario completo | Nuevo proveedor |
| Transferencias | Routing, idempotencia y recuperación | Dinero saliente |
| Ingresos | Créditos, reversas y evidencia | Dinero entrante |
| Contabilidad | Clearing segregado y doble partida | Control financiero |
| Conciliación | Comparación y excepciones por banco | Exactitud |
| Infraestructura | Secretos, monitoreo y despliegue | Producción |
| QA | Automatización, regresión y homologación | Confiabilidad |
Desglose del
presupuesto.
| Paquete de trabajo | Contenido principal | Asignación |
|---|---|---|
| Núcleo multibanco y migración | Modelo, router, contratos, compatibilidad Coinag | US$4.000 |
| Integración Brubank | Cuentas, saldos, movimientos, transferencias y eventos | US$3.500 |
| Integración Banco Comercial | Cuentas, saldos, movimientos, transferencias y eventos | US$3.500 |
| Transferencias y clearing | Routing, estados inciertos y contabilidad segregada | US$3.000 |
| Ingresos y conciliación | Créditos, reversas, archivos/webhooks y diferencias | US$2.000 |
| Back office y auditoría | UX, validaciones, seguimiento y controles | US$1.000 |
| QA, seguridad y deployment | Pruebas, homologación estándar, monitoreo y entrega | US$2.000 |
| Total | Alcance integral a precio cerrado | US$19.000 |
La asignación expresa el valor comercial relativo de cada paquete. El equipo puede mover esfuerzo entre frentes sin alterar el total ni degradar los criterios de aceptación.
Cronograma estimado
de implementación.
Contratos, accesos y diseño Semanas 1–2
Capacidades, credenciales, casos de homologación, modelo final y criterios de aceptación.
Núcleo multibanco y migración Semanas 3–4
Datos, router, clearing, compatibilidad Coinag y primeras pantallas del back office.
Brubank Semanas 5–7
Adaptador, alta, operación transaccional, eventos, pruebas y seguimiento visual.
Banco Comercial Semanas 8–10
Segundo adaptador y cierre del comportamiento común entre los tres proveedores.
Conciliación y salida Semanas 11–14
Regresión, observabilidad, homologación estándar, despliegue y documentación.
Duración estimada total: entre 12 y 14 semanas. Los frentes se superponen cuando ambos sandboxes están disponibles. Una espera de terceros desplaza el calendario del hito afectado.
Precio y
forma de pago.
- Brubank + Banco Comercial
- Adaptación completa de Coinag
- Back office y modelo multibanco
- Transferencias, ingresos y conciliación
- QA, homologación estándar y deployment
- 30 días de garantía
- 30%US$5.700Inicio y reserva del equipo.
- 30%US$5.700Núcleo multibanco disponible en desarrollo.
- 25%US$4.750Dos proveedores listos para homologación.
- 15%US$2.850Entrega final del alcance acordado.
Validez comercial: 15 días
Supuestos y
trabajos adicionales.
- APIs documentadas y estables.
- Sandboxes y credenciales disponibles al inicio.
- ARS y productos definidos en kickoff.
- Una homologación y una corrección por banco.
- Reutilización de infraestructura existente.
- Sin cambios contractuales durante el desarrollo.
- Un cuarto banco o nuevos productos posteriores.
- Otro proveedor de KYC o validación documental.
- Monedas distintas de ARS.
- Migración histórica o saneamiento no informado.
- Formatos o canales agregados después del relevamiento.
- Auditorías externas o certificaciones obligatorias.
- Rondas extra por cambios de API del proveedor.
- Soporte evolutivo posterior a la garantía.
Requisitos
para comenzar.
01Confirmar propuesta
Aprobar alcance integral, inversión de US$19.000 y esquema de hitos.
02Habilitar accesos
Documentación, sandboxes y contactos técnicos de Brubank y Banco Comercial.
03Kickoff
Definimos productos, criterios de aceptación y calendario operativo de la primera semana.
unbroker
consulting.unbroker.app