La columna financiera de Mogos, lista para múltiples entidades
Hoy Mogos cobra, cotiza y maneja tasas, pero el dinero vive en features, no en un sistema financiero. Este es el plan para convertirlo en una base banca-grade: entidades legales separadas que nunca mezclan sus finanzas, un libro mayor por entidad, liquidación entre compañías con respaldo legal y reconciliación de todos los canales de cobro. Es la base de la sección de pagos de crescō y el cimiento del futuro módulo de créditos.
SepararRegistrarLiquidarReconciliarAuditar
Entidades
China · Venezuela + EE.UU. / franquicias
Contabilidad
Libros separados, nunca mezclados
Dinero
Doble partida · Decimal
Datos
1 sola DB · acceso por entidad
organigrama de entidades
Una marca, varias empresas legales
Cada país es una empresa distinta, con sus propias cuentas bancarias y contabilidad. La plataforma es una sola; el acceso a los datos se aísla por entidad.
Mogos Group
marca paraguas · plataforma unificada
Mogos International Logistics
China · clientes LatAm · contenedor / consolidación
activa
Mogos Venezuela
representante exclusivo · DDP puerta a puerta
activa
Mogos EE.UU.
operación propia · ruta China → EE.UU. → VE
futuro
Franquicias
p. ej. Panamá · marco legal y financiero propio
futuro
estado actual
Lo que ya existe, y lo que falta
El punto de partida real, leído del código. Hay base sólida de cobros; falta la columna contable.
Ya existe
Cotizaciones polimórficas (flete / almacén / servicio) con line items y pagos parciales
Transacción → Pago → Recibo, con anulación auditada
Ledger append-only de recompensas — el único libro hoy
Falta
Multi-entidad y separación contable (hoy todo es un "Mogos Group" implícito)
Liquidación inter-compañía
Libro mayor de doble partida
Dinero robusto: hoy es Float (riesgo de redondeo)
Reconciliación de transferencias — el canal principal
Créditos / wallets / balances
flujo de un pago · hoy
Cómo se registra un cobro actualmente
El camino que ya existe en el código. Funciona — pero termina en un recibo, no en un asiento contable.
01Cotización
→
02 · intentoTransacción
→
03 · successPago
→
04Recibo
entra por Pasarela → TransacciónTasas BCV ⤳ Cotización⚠ no genera asiento contable
huecos detectados
Los riesgos a resolver
Dinero como FloatErrores de redondeo acumulables. Banca exige enteros / Decimal.
Sin doble partidaBalances, créditos y conciliación quedan frágiles.
Sin multi-entidadNo soporta China / Venezuela / EE.UU. con finanzas separadas.
Sin liquidación inter-compañíaNo modela "China le factura a Venezuela".
Sin reconciliación multi-canalTransferencias (HK), yuan y pasarela no se atribuyen por libro.
Endpoints de tasas públicosMarcados TODO: secure — hueco de seguridad.
Webhooks sin idempotencia / firmaRiesgo de doble-cobro o replay.
FaltanNotas de crédito / reembolso, mora, impuestos, factura china.
quién cobra, y cómo
El canal difiere por entidad
La contabilidad debe quedar separada — y el diseño no ata un canal a una entidad: China podría cobrar por pasarela a futuro.
Mogos International LogisticsChina
clientes de LatAm · contenedor
Canal dominante: transferencia bancaria, en su mayoría directo a Hong Kong (no es yuan)
Una minoría paga directo en yuan a la cuenta de China (limitado)
Stripe / PayPal: secundarios
Necesita emitir factura china
Mogos VenezuelaVenezuela
DDP puerta a puerta
Cobro en USD por pasarela (PayPal, Stripe, etc.)
El cliente paga a Venezuela el servicio puerta a puerta
Reconciliación de pasarela atribuida a su propio libro
Liquidación inter-compañía
Cuando China le presta un servicio a Venezuela, China le factura a Mogos Venezuela y el ledger genera la cuenta inter-compañía (VE debe a China). Respaldo: los contratos legales entre Venezuela, China y EE.UU. Las finanzas nunca se mezclan — se liquidan.
flujo propuesto · inter-compañía
Cómo entraría y se liquidaría
Cada cobro entra al libro de su entidad; cuando China presta un servicio a Venezuela, se genera la cuenta inter-compañía. Todo sobre una sola base de datos, aislada por entidad.
Cliente Venezuela
→USD por pasarela
Mogos Venezuela · libro VE
Cliente LatAm
→transferencia (HK) + yuan
Mogos China · libro CN
→factura servicios
Inter-compañía VE → China
→liquida
Mogos Venezuela
Base de datos única · acceso aislado por entidad — los libros nunca se mezclan
el núcleo, por dentro
Cinco pilares
Una propuesta abierta al criterio de Diego (banca) — para validar, ajustar o contra-proponer.
01
Libro mayor de doble partida
Cada movimiento = asientos balanceados (débito = crédito). Una verdad contable única y auditable, base de balances y créditos.
02
Dinero robusto
Montos en enteros / Decimal, nunca Float. Moneda funcional por entidad y FX al momento del asiento.
03
Multi-entidad + separación
Libros separados por entidad sobre una sola DB con acceso aislado. Inter-compañía con respaldo legal.
04
Pagos y reconciliación
Reconcilia transferencia + yuan + pasarela, atribuyendo cada cobro a su entidad y libro. Idempotencia y firmas de webhook.
05
Conciliación y auditoría
Match de extractos de banco / pasarela contra el ledger, con cola de excepciones. Todo asiento es inmutable; las correcciones se hacen con asientos de reverso. Trazabilidad completa de cada intento y cambio de estado.
hoja de ruta
Una cadena de dependencias
La auditoría informa al núcleo, y el núcleo habilita los créditos.
primeroAuditoría de pasarelaRevisar la pasarela actual contra parámetros banca-grade. Hallazgos + remediación.en planificación
→
núcleoNúcleo financieroLedger, multi-entidad, dinero robusto, reconciliación. La base.diseño · backend
→
futuroMódulo de créditosLíneas de crédito, estados de cuenta, scoring, mora. Se monta sobre el núcleo.backlog
decisiones para ti
Preguntas abiertas, Diego
Lo que tu criterio de banca debe definir antes de construir.
01Libros 100% separados por entidad con una capa de consolidación arriba — ¿cómo se consolida y reporta sin mezclar?
02Como viene DB nueva: ¿doble partida completa desde el inicio (greenfield) o híbrido por fases?
03Moneda funcional por entidad y política de FX para la liquidación China → Venezuela.
04¿Cómo se dispara y concilia la liquidación inter-compañía, alineada a los contratos legales? ¿Tiempo real o corte periódico?
05¿Cómo separar toda la contabilidad por entidad sin atar un canal a una entidad?
06Dinero: ¿enteros minor-units o Decimal? ¿Qué precisión?
07¿Qué debe dejar listo el núcleo para que el módulo de créditos se monte encima sin fricción?
Por qué un núcleo, y no más features
El dinero es el lugar donde Mogos no se puede permitir improvisar. Varias empresas legales,
varias monedas, cobros que entran por transferencia, yuan y pasarela, y un cliente
—Mogos Venezuela— que además le paga a China. Sin un libro mayor que registre cada
movimiento como un asiento balanceado, separado por entidad, todo eso se vuelve frágil:
balances que no cuadran, liquidaciones a mano, créditos imposibles de auditar. El núcleo
existe para que la verdad contable sea una sola, separada y auditable — y para que el
módulo de créditos se monte encima sin reinventar nada.
Las finanzas nunca se mezclanCada entidad: empresa, cuentas y contabilidad propias. Se liquidan entre sí, no se confunden.
Una plataforma, datos aisladosUna sola base de datos; cada entidad solo ve lo suyo.
El canal no define la entidadTransferencia, yuan o pasarela: cualquiera puede entrar a cualquier libro.
Doble partida desde la raízCada movimiento es un asiento balanceado; las correcciones se reversan, no se borran.
Diego propone y revisaLa arquitectura es una hipótesis; el criterio de banca manda.