mogos.Arquitectura de producto · 10 septiembre 2026

Gestión de pagos · diseño esencial

Dos compañías.
Un recorrido claro.

Venezuela atiende al cliente. China hace posible el pago en yuanes. Cada compañía conserva su dinero, sus decisiones y sus documentos. Una gestión conecta todo.

Cotizar en AdminEjecutar en CajaConciliar en FinanzasAsistir desde AI

Diseño para implementación. Las pantallas y los importes son ejemplos; esta página no realiza pagos ni modifica cuentas.

01 / Cada cosa en su sitio

La gestión comienza con una necesidad.

El cliente ya tiene un proveedor. Mogos gestiona su pago. El encargo inicial viaja de Venezuela a China; la propuesta de China vuelve a Venezuela antes de presentar las condiciones finales al cliente.

01 · Admin VECrear y enviar el encargoProveedor, monto en CNY y fecha requerida. Guardar un borrador todavía no avisa a China.
02 · Caja CNRevisar si se puede atenderAparece en «Por revisar». Confirmar viabilidad o pedir información.
03 · Admin CNCotizar el servicio de ChinaFondos necesarios, tarifa propia, tasa, vigencia y condiciones.
04 · Admin VEOfertar y autorizarTarifa al cliente, aceptación comercial y decisión de financiación.
05 · Caja + FinanzasEjecutar y conciliarFondos, conversiones, pago y remanentes. Cada entidad confirma su parte.

Administración

El acuerdo y el control.

Gestiona cotizaciones, proformas, ajustes y cuentas por cobrar. Finanzas registra el cobro y la financiación de Venezuela, autoriza anticipos y concilia ambos libros por separado.

  • Condiciones comerciales versionadas.
  • Proveedores y destinos de pago.
  • Obligaciones, saldos y cierre.

Caja

Lo que ocurre en China.

Una bandeja de tareas concretas: revisar un encargo, recibir USDT, convertir a CNY y registrar el pago. Cada acción tiene responsable, compañía y evidencia.

  • Pendientes persistentes por operación.
  • Importes reales y conversiones parciales.
  • Gastos de oficina en su propio flujo.

Mogui · MCP · futuro

El mismo trabajo, conversado.

Slack o Claude podrán preparar y consultar la misma gestión. Las acciones monetarias exigirán las facultades de la persona y el contexto de compañía correspondiente.

  • Mismos servicios y validaciones.
  • Vista previa de la acción concreta.
  • El pendiente existe antes del aviso.
Una referencia, dos libros. GP-0001 une el encargo, las dos ofertas y todos los movimientos. Compartir la referencia permite colaborar; cada compañía conserva el acceso a sus propios datos y comparte solo el contexto necesario.

02 / Seguir el dinero

Cada cambio debe poder explicarse.

Recorrer la operación permite ver qué ocurrió, quién actúa y dónde queda el dinero. El ejemplo usa una tasa distinta de 1:1 para separar USD y USDT desde el principio.

GP-0001 · Pago a proveedor en China

Proveedor: 700 CNY · Base: 101,00 USD · Cliente: 12% · China: 6%

1 USDT cuesta 1,01 USD · 1 USDT produce 7,00 CNY · Sin comisiones ni impuestos.

Ejemplo interactivo

Venezuela · Admin / Finanzas

El cliente paga 113,12 USD.

101,00 USD para el principal y 12,12 USD de gestión. El cobro se aplica al documento del cliente y a esta operación.

Se registra: Entrada en una cuenta USD de Venezuela y aplicación del cobro.
Sigue pendiente: Financiar a China y pagar al proveedor.

Saldos después de este paso

Venezuela · USD113,12 USD
Venezuela · USDT0,00 USDT
En tránsito · USDT0,00 USDT
China · USDT0,00 USDT
China · CNY0,00 CNY
Recibido por proveedor0,00 CNY

China acepta 106 USDT para cancelar 107,06 USD a la tasa pactada de 1,01 USD/USDT. El tránsito es un control de transferencia, no otra cuenta bancaria disponible. Las tasas son ilustrativas. El caso simplificado supone recepción íntegra y costos cero. El sistema conserva por separado tasa cotizada, tasa ejecutada y política de valoración contable.

Si Venezuela ya tiene USDT, asigna ese saldo. Se conserva la procedencia de su adquisición anterior y solo se registra la reserva/aplicación correspondiente. No se inventa una compra USD→USDT por cada gestión.

03 / Pantallas que entregan el siguiente paso

Una acción principal.
Todo el contexto a mano.

Caja abre en la compañía activa y muestra qué necesita atención. Revisar viabilidad, aceptar condiciones y autorizar un desembolso son decisiones diferentes, aunque las haga la misma persona.

mogos. / Admin / Gestión de pagosVenezuela ▾ · Persona autorizada

GP-0001 · cliente de ejemplo

Pago ejecutado en China.

Por conciliar
Cliente → Venezuela113,12 USDCobrado y aplicado
Venezuela → China106,00 USDT107,06 USD según acuerdo
China → Proveedor700,00 CNYPago registrado con soporte
RegistroCompañíaResultado
Oferta al cliente · v1VenezuelaAceptada · 12%
Oferta de China · v1ChinaAceptada · 6%
Conversión y pagoChinaVinculados · evidencia adjunta
RemanentesCada entidadVE: 6,06 USD · CN: 6,00 USDT

04 Admin conserva la historia completa.

El detalle reúne documentos, pendientes, autorizaciones, movimientos y actividad. El resumen entre compañías muestra datos compartidos autorizados; abrir cuentas o comprobantes internos requiere permiso en la entidad dueña. «Pagado» no significa «conciliado».

04 / Dos tarifas independientes

El ajuste conserva el acuerdo.

Si cambia el principal, cada tarifa mantiene su porcentaje pactado. La gestión conserva el documento original y agrega la diferencia. Un cobro anterior sigue aplicado.

Calculadora de referencia: todos los importes en una misma unidad, sin tasas, comisiones ni impuestos. No fija tarifas para otras gestiones.

Diferencia sobre el documento original

Al cliente+3,36
A China+3,18
Participación VE+0,18

Total cliente: 112,00 → 115,36. Si ya pagó 112,00, quedan 3,36 por cobrar. China: 106,00 → 109,18.

La diferencia se presenta y aprueba en la misma gestión. El envío adicional es otro movimiento vinculado.

DocumentoQué permite el diseñoQué queda trazado
BorradorEditar antes de presentar.Última versión de trabajo y autor.
Cotización / proforma enviadaEmitir una nueva versión conservando la anterior.Condiciones, tasa, vencimiento y aceptación de cada versión.
Factura fiscal emitidaVincular el documento correctivo aplicable al régimen del emisor.Original, motivo, diferencia y nueva obligación. El tipo fiscal debe validarse.
Reducción del totalReconocer saldo a favor y registrar devolución o aplicación expresa.Destino del crédito. Una reducción documental no ejecuta una devolución.
112 → 106 → 100. En el ejemplo original, la tarifa al cliente es 12 y el costo del servicio de China es 6: Venezuela conserva 6 y China 6 antes de costos e impuestos. No se agregan otros 6 al total del cliente ni se impone un reparto 50/50.

05 / Un equipo pequeño, facultades claras

La responsabilidad acompaña a la compañía.

Una persona puede cotizar, aprobar y pagar si así se configura. Puede hacerlo para Venezuela, China o ambas. Los perfiles son atajos editables para asignar acciones; el puesto y la aplicación no conceden permisos por sí solos.

Matriz funcional propuesta. No asigna permisos reales a personas.
CapacidadContexto de compañíaSuperficie principalCondición visible
Crear y presentar una gestiónEmisora, Venezuela en este casoAdminProveedor, moneda, importe y versión.
Revisar / cotizar el servicio de ChinaReceptora, China en este casoCaja → AdminViabilidad separada de autorización.
Autorizar fondos o anticipoEntidad que asume el compromisoAdmin · FinanzasLímite, financiador y segundo aprobador si aplica.
Registrar cobro / adquirir / enviar USDTDueña de las cuentas de origenAdmin · FinanzasFondos reales, aplicaciones y soporte.
Recibir / convertir / pagarDueña de las cuentas de ChinaCajaAutorización, cuenta, destino y monto.
Ajustar / conciliar / cerrarDueña del registro afectadoAdmin · FinanzasHistoria, reversión y período.
Cambiar de compañía cambia el contexto de la siguiente acción. Un borrador, documento o captura pendiente de sincronizar conserva su propietario. Cada evento registra persona, compañía actuante y, si difieren, quién ejecutó y quién registró.

La financiación será flexible.

Dos caminos posibles. La política define quién puede anticipar y hasta cuánto; un anticipo deja registrada una obligación por recuperar.

Fondos confirmados y asignados

El pago usa fondos de la gestión.

La cuenta de origen dispone del importe necesario, la asignación no está consumida por otro pago y el destino está autorizado.

  • Identificar fondos y cuenta.
  • Confirmar autorización vigente.
  • Aplicar el pago al pendiente del proveedor.

Flexibilidad con una decisión concreta.

Una cuenta necesita fondos reales incluso cuando se anticipa dinero propio. La autorización de crédito no crea saldo bancario.

Se puede anticipar desde Venezuela o desde China si la política de la entidad lo permite. El préstamo o cuenta por recuperar se relaciona con la gestión y con quien debe reponerlo.

Si el dinero ya se movió sin la autorización requerida, se captura el hecho con evidencia y se abre una excepción. El sistema no esconde una salida real ni la convierte retroactivamente en una aprobación.

El otro camino

Cuando algo cambia, aparece una tarea.

La excepción conserva el dinero registrado y señala qué falta, cuánto y quién puede resolverlo.

La tasa venció o cambió.

China actualiza su propuesta en Admin. Venezuela presenta el ajuste y obtiene la aceptación aplicable. No se sustituye la tasa de una ejecución pasada.

Llegó menos USDT.

China registra lo recibido. La diferencia queda como comisión identificada o faltante por resolver; Venezuela conserva el pendiente correspondiente.

Pago parcial o cancelación.

Aplicar cada pago. Cancelar solo lo no ejecutado; resolver devoluciones y anticipos por recuperar sin borrar movimientos.

Sin conexión o respuesta perdida.

Guardar captura con identidad estable. Mostrar «Por sincronizar». Un reintento recupera el mismo registro y nunca ejecuta otro pago.

El banco llega después.

Finanzas une la observación a la captura existente. Si hay varias coincidencias, solicita revisión antes de vincular.

Sobra principal o queda un anticipo.

Asignar responsable y destino: devolver, aplicar o recuperar. La ejecución puede terminar y la obligación seguir abierta.

06 / El contrato para construirlo

Una fuente de saldo.
Reglas compartidas en cada canal.

El diseño integra las piezas actuales de Mogos. Añade el expediente operativo y resuelve las conexiones que hoy no garantizan una ejecución completa entre compañías.

Qué reutilizamos y qué cambia
Pieza existenteTrabajo de esta entrega
Company / CompanyUserConservar membresías. Añadir facultades por persona y compañía, entidad financiera explícita y alcance cerrado en comandos monetarios.
ServiceQuote / Quotation / PaymentConservar comercial y cobros. Relacionar oferta independiente CN→VE, documentos versionados, ajustes y aplicaciones sin duplicar facturación.
MoneyAccount / MoneyMovementÚnica fuente de saldos nativos. Validar dueño, moneda y dirección; cantidades decimales y una identidad por hecho monetario.
Egreso / Ingreso / observación bancariaCapturas y evidencias del mismo movimiento. Resolver llegada en cualquier orden, idempotencia y sincronización pendiente.
Swap / enlaces / conciliaciónSeparar transferencia intercompañía asíncrona de conversión real dentro de una entidad. Ningún resultado se asigna a US_LLC por defecto.
Alcancía / presupuesto / exportaciónOficina en su propio origen. Presupuesto mensual separado del dinero disponible; exportación completa y reproducible sin duplicar transferencias.
Mogui / MCPCanales posteriores sobre los mismos comandos. Crear pendiente persistente antes de notificar. Reportar en Slack no basta para afectar saldo.
Modelo de operación y estados

Gestión → origen comercial + emisor/receptor + proveedor/destino versionado + ofertas cliente/CN + solicitudes y decisiones + obligaciones + ajustes + aplicaciones + eventos monetarios + evidencias + actividad.

Cada evento lleva compañía propietaria, entidad financiera, cuenta, moneda nativa, cantidad, fecha real, versión aceptada, autor, ejecutor cuando difiera y clave de idempotencia. Una transferencia enlaza envío y recepciones; una conversión enlaza dos cantidades reales y sus comisiones. Una aplicación distribuye un evento entre una o varias gestiones sin exceder su cantidad disponible.

  • Encargo: borrador → enviado → información pendiente / viable / no viable / cancelado.
  • Comercial: cotizado → presentado → aceptado / vencido / sustituido. Cliente y China conservan decisiones propias.
  • Financiación: por autorizar / autorizada / parcial / fondos asignados / anticipo por recuperar.
  • Envío: pendiente / enviado / recibido parcial / recibido / diferencia por resolver.
  • Ejecución: por convertir / conversión parcial / fondos CNY / pago parcial / pagado.
  • Control: por sincronizar / registrado / por conciliar / conciliado. Cierre operativo, obligaciones liquidadas y cierre contable son hitos distintos.

El resumen visual deriva el próximo pendiente de estos estados. Un único estado «completado» no reemplaza todos los registros.

Diez reglas que deben comprobarse
  1. Saldo por cuenta, entidad y moneda = apertura + entradas − salidas. Una vista consolidada identifica fecha y tasa; no suma monedas directamente.
  2. Cobro, captura, feed bancario y conciliación afectan una sola vez el dinero real. Respuesta perdida y reintento devuelven el mismo resultado.
  3. USD→USDT y USDT→CNY guardan cantidades reales independientes. La tasa ejecutada tiene unidades; las comisiones conservan monto, moneda y responsable.
  4. Enviar no confirma recibir. Cantidad esperada = recepciones aplicadas + deducciones documentadas + pendiente de ese tramo.
  5. Facturar, aprobar, reservar o asignar fondos no produce efectivo. Una autorización de anticipo no crea dinero disponible.
  6. El saldo del cliente, la obligación entre empresas y el pendiente del proveedor se explican por separado. Las aplicaciones no consumen más de lo disponible.
  7. Las dos tarifas conservan su base y versión. Un cambio de configuración no modifica acuerdos aceptados ni tasas ejecutadas.
  8. Una conciliación valida entidad, cuenta, moneda, dirección e importe; no basta que sumen lo mismo.
  9. Todo remanente se clasifica por dueño y propósito. Los decimales, la precisión USDT y el residuo de redondeo quedan definidos y reproducibles.
  10. Un cambio de compañía no reasigna documentos ni capturas. Usuario sin compañía o permiso explícito no puede ejecutar comandos financieros.
Secuencia de implementación y pruebas de aceptación

1. Identidad y dinero. Mapear entidades/cuentas, extender permisos y crear la raíz de gestión. Implementar comandos idempotentes, aplicaciones y captura/observación como un solo hecho. Validar todos los saldos antes de construir automatismos.

2. Admin y relevo a China. Envío del encargo, bandeja persistente, ofertas independientes, vigencia, aceptación, ajustes, autorización y anticipos. El doble clic en enviar genera un único pendiente en China.

3. Caja y conciliación. USD/USDT en VE, recepciones, conversiones parciales, pagos, remanentes y exportación. El mismo caso debe cuadrar por operación y por cada cuenta nativa.

4. Piloto y AI. Corte y conciliación del histórico, piloto con ambas compañías, luego canales AI con la misma identidad y autorización. Integrar Alcancía por período sin mezclar presupuesto con fondos de clientes.

Aceptación mínima: ejecutar el ejemplo 113,12 USD → 106 USDT → 700 CNY; luego USDT preexistente, anticipo VE, anticipo CN, fondos insuficientes, dos recepciones, comisión de red, conversión parcial, pago parcial, ajuste positivo/negativo, cancelación y devolución. Verificar banco antes/después de captura, reintento tras respuesta perdida, identidad/moneda ajena rechazada, cambio de compañía con borrador pendiente y exportación sin duplicados. Resolver saldo inicial y capturas históricas sin vínculo antes del corte.

Estos son criterios de implementación. La publicación del diseño no acredita que esas pruebas de Mogos ya hayan pasado.

Qué falta configurar antes del piloto
  • Identidad real: determinar qué entidad presta el servicio de China/Hong Kong y quién es titular de cada cuenta y wallet. La moneda no determina la entidad. HKD requiere soporte explícito si entra en alcance.
  • Documentación por emisor: validar proforma, factura del servicio, fondos administrados y documento correctivo. No asignar ingreso o tratamiento fiscal automáticamente al total recibido.
  • Políticas operativas: perfiles, límites de anticipos, responsable de recuperarlos, segundo aprobador cuando aplique, condiciones de evidencia y regularización.
  • Condiciones comerciales: tarifas/base por operación, fuente y vigencia de tasas, momento de fijación, gastos bancarios/red y quién los asume. El ajuste mantiene ambos porcentajes pactados.
  • Oficina: período mensual de Alcancía, manejo del saldo no usado y reposición. Cada gasto conserva su origen y autorización presupuestaria.

La financiación flexible y el mecanismo de ajustes están decididos. Los valores concretos se configuran; los hechos jurídicos y la titularidad de cuentas se confirman con sus responsables.

Base de la revisión y relación con Finanzas

Revisión de código sobre la referencia local origin/development · 6ea5d0281c565a5ab11d43c459d8c7697b82c808 del 7 de septiembre de 2026. No acredita el estado remoto actual ni el estado de los datos en producción.

Se identificaron rutas que crean Ingreso sin MoneyMovement, reintentos de Caja sin clave estable, clasificación bancaria que puede duplicar capturas, entidad por defecto al convertir ServiceQuote a Quotation y swap con diferencias atribuidas a US_LLC. El alcance anterior exige cerrar esas rutas, integrar la valoración real USD/USDT y validar las asignaciones de conciliación.

El informe interno con referencias de código y el contrato de proyecto acompañan esta entrega. Se reutiliza el repositorio de Mogos; no se crea una app financiera ni un saldo paralelo.

Fuera de alcance: ejecución bancaria automática, trading, un nuevo ERP contable, tratamiento tributario inventado por el producto y habilitación automática de permisos a empleados.

  • Rapidez con contexto. Una acción principal, datos reutilizados y la siguiente responsabilidad visible.
  • Formalidad proporcional. Equipo pequeño, capacidades combinables y políticas configurables por entidad.
  • Historia que se conserva. Versiones y ajustes vinculados; los hechos reales no desaparecen.
  • Números explicables. Cada importe pertenece a una cuenta, una moneda, una entidad y un propósito.