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.
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.
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.
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.
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.
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.
Saldos después de este paso
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.
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.
Un nuevo encargo.
GP-0001 · Recibido de Venezuela
Primero, viabilidad.
Comprueba beneficiario, plazo y posibilidad de pagar. Luego prepara la cotización en Admin.
01 La solicitud sí llega a China.
«Enviar a China» crea este pendiente. Alternativas: pedir datos o indicar que no se puede atender. La revisión no aprueba el gasto ni crea fondos.
Confirma lo recibido.
GP-0001 · Envío VE-0001
Puede llegar por partes.
Una diferencia queda explicada como comisión, faltante o recepción pendiente.
02 Enviar y recibir son dos hechos.
Se vinculan sin confirmar automáticamente el saldo de la otra entidad. «Registrado» y «verificado por banco o red» conservan estados distintos.
De USDT a yuanes.
GP-0001 · China
El proveedor sigue pendiente.
La conversión deja fondos disponibles en CNY. El pago se registra en el siguiente paso.
03 Dos importes reales, una conversión.
Monto de origen, monto de destino, cuentas, tasa, fecha y comprobante. Si se convierte todo el saldo, el remanente podrá quedar en CNY.
GP-0001 · cliente de ejemplo
Pago ejecutado en China.
| Registro | Compañía | Resultado |
|---|---|---|
| Oferta al cliente · v1 | Venezuela | Aceptada · 12% |
| Oferta de China · v1 | China | Aceptada · 6% |
| Conversión y pago | China | Vinculados · evidencia adjunta |
| Remanentes | Cada entidad | VE: 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».
Pagar al proveedor.
GP-0001 · destino validado
Después de pagar fuera de Mogos.
Registra la ejecución real. Si hay una integración futura, autorizar y ejecutar seguirán siendo acciones identificables.
05 La persona con facultad ejecuta.
Puede pertenecer a contabilidad. Se conservan quién pagó y quién lo registró si son distintos. Un cambio de beneficiario exige revisar la autorización afectada.
Lo que queda tiene dueño.
GP-0001 · pago terminado
Clasificar antes de cerrar.
Retención por tarifa, devolución o saldo aplicado. La caja disponible y el resultado económico se muestran por separado.
06 Un sobrante no se convierte solo en utilidad.
El saldo puede incluir tarifa, fondos del cliente o diferencias. La gestión también puede conservar anticipos por recuperar, mostrados como obligación separada.
El mismo permiso.
«Prepara el envío a China»
La conversación no crea autoridad.
El sistema valida compañía, alcance y versión. El aviso enlaza al registro que ya existe.
07 AI entra por la misma puerta.
Preparar, consultar y registrar acciones habilitadas mediante Mogos. Una notificación en Slack por sí sola no equivale a una gestión ni a un pago registrado.
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.
Introduce importes positivos o cero y porcentajes entre 0 y 100.
Diferencia sobre el documento original
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.
| Documento | Qué permite el diseño | Qué queda trazado |
|---|---|---|
| Borrador | Editar antes de presentar. | Última versión de trabajo y autor. |
| Cotización / proforma enviada | Emitir una nueva versión conservando la anterior. | Condiciones, tasa, vencimiento y aceptación de cada versión. |
| Factura fiscal emitida | Vincular el documento correctivo aplicable al régimen del emisor. | Original, motivo, diferencia y nueva obligación. El tipo fiscal debe validarse. |
| Reducción del total | Reconocer saldo a favor y registrar devolución o aplicación expresa. | Destino del crédito. Una reducción documental no ejecuta una devolución. |
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.
| Capacidad | Contexto de compañía | Superficie principal | Condición visible |
|---|---|---|---|
| Crear y presentar una gestión | Emisora, Venezuela en este caso | Admin | Proveedor, moneda, importe y versión. |
| Revisar / cotizar el servicio de China | Receptora, China en este caso | Caja → Admin | Viabilidad separada de autorización. |
| Autorizar fondos o anticipo | Entidad que asume el compromiso | Admin · Finanzas | Límite, financiador y segundo aprobador si aplica. |
| Registrar cobro / adquirir / enviar USDT | Dueña de las cuentas de origen | Admin · Finanzas | Fondos reales, aplicaciones y soporte. |
| Recibir / convertir / pagar | Dueña de las cuentas de China | Caja | Autorización, cuenta, destino y monto. |
| Ajustar / conciliar / cerrar | Dueña del registro afectado | Admin · Finanzas | Historia, reversión y período. |
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.
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.
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.
China registra lo recibido. La diferencia queda como comisión identificada o faltante por resolver; Venezuela conserva el pendiente correspondiente.
Aplicar cada pago. Cancelar solo lo no ejecutado; resolver devoluciones y anticipos por recuperar sin borrar movimientos.
Guardar captura con identidad estable. Mostrar «Por sincronizar». Un reintento recupera el mismo registro y nunca ejecuta otro pago.
Finanzas une la observación a la captura existente. Si hay varias coincidencias, solicita revisión antes de vincular.
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 existente | Trabajo de esta entrega |
|---|---|
| Company / CompanyUser | Conservar membresías. Añadir facultades por persona y compañía, entidad financiera explícita y alcance cerrado en comandos monetarios. |
| ServiceQuote / Quotation / Payment | Conservar 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 bancaria | Capturas y evidencias del mismo movimiento. Resolver llegada en cualquier orden, idempotencia y sincronización pendiente. |
| Swap / enlaces / conciliación | Separar 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ón | Oficina en su propio origen. Presupuesto mensual separado del dinero disponible; exportación completa y reproducible sin duplicar transferencias. |
| Mogui / MCP | Canales 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
- Saldo por cuenta, entidad y moneda = apertura + entradas − salidas. Una vista consolidada identifica fecha y tasa; no suma monedas directamente.
- Cobro, captura, feed bancario y conciliación afectan una sola vez el dinero real. Respuesta perdida y reintento devuelven el mismo resultado.
- USD→USDT y USDT→CNY guardan cantidades reales independientes. La tasa ejecutada tiene unidades; las comisiones conservan monto, moneda y responsable.
- Enviar no confirma recibir. Cantidad esperada = recepciones aplicadas + deducciones documentadas + pendiente de ese tramo.
- Facturar, aprobar, reservar o asignar fondos no produce efectivo. Una autorización de anticipo no crea dinero disponible.
- 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.
- Las dos tarifas conservan su base y versión. Un cambio de configuración no modifica acuerdos aceptados ni tasas ejecutadas.
- Una conciliación valida entidad, cuenta, moneda, dirección e importe; no basta que sumen lo mismo.
- 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.
- 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.