Una cuenta es el lugar donde viven los saldos en Fidi X. Cada movimiento de dinero que ocurre en el sistema afecta al menos a dos cuentas — una que entrega valor y otra que lo recibe. Definir una buena estructura de cuentas desde el inicio es lo que permite que la operación financiera sea confiable, auditable y fácil de mantener en el tiempo.
De quién es el dinero#
Cualquier negocio financiero administra dos tipos de dinero que son fundamentalmente distintos: el dinero que le pertenece a la empresa, y el dinero que la empresa le debe a otros — usuarios, clientes, socios. Una wallet de usuario, un saldo de cuenta virtual, un programa de puntos — en todos estos casos la empresa custodia valor que no es suyo. Esa distinción no es solo contable: define obligaciones legales, criterios de auditoría y la forma en que se reporta el negocio.Fidi X captura esa distinción a través del campo normal_balance. Al crear una cuenta, este campo define su naturaleza económica — si representa dinero propio o una obligación hacia un tercero. La pregunta que hay que hacerse es simple:¿Este dinero le pertenece a la empresa, o se lo debe a alguien?
Cuentas DEBIT — dinero propio#
Una cuenta DEBIT representa recursos que pertenecen a la empresa. Su saldo crece cuando recibe operaciones de débito, y decrece cuando recibe créditos. En términos contables, son cuentas de activo.La cuenta que representa la caja o tesorería de la empresa.
Una cuenta de reserva operativa.
Cuentas CREDIT — dinero de terceros#
Una cuenta CREDIT representa obligaciones que la empresa tiene hacia otros — usuarios, clientes, socios. Su saldo crece cuando recibe operaciones de crédito, y decrece cuando recibe débitos. En términos contables, son cuentas de pasivo.La wallet de un usuario — la empresa administra ese saldo, pero le pertenece al usuario. Es una obligación pendiente de entrega.
Un programa de puntos o beneficios — bajo principios contables como IFRS, representan una obligación pendiente hacia quien los acumuló y se reconocen como pasivo contingente.
normal_balance desde el inicio garantiza que el modelo de cuentas sea auditable y consistente.| ¿Cuál es la naturaleza del dinero? | Tipo de cuenta |
|---|
| Es dinero que la empresa posee | DEBIT |
| Es dinero que la empresa le debe a un usuario, cliente o socio | CREDIT |
| Es un beneficio o punto comprometido con un tercero | CREDIT |
Cómo operan las cuentas en una transacción#
En Fidi X toda transacción sigue el principio de partida doble: siempre opera sobre al menos dos cuentas, y el total de débitos debe ser igual al total de créditos.El caso más frecuente es cuando una transacción involucra una cuenta DEBIT y una cuenta CREDIT — una es la fuente, la otra es el destino. El ejemplo más claro es un cash in:La tesorería de la empresa (cuenta DEBIT) recibe los fondos → operación DEBIT → su saldo sube.
La wallet del usuario (cuenta CREDIT) refleja la obligación → operación CREDIT → su saldo sube.
DEBIT), usando direcciones opuestas. Esto es contablemente válido, pero es un caso menos frecuente reservado para movimientos internos entre activos propios de la empresa.
Estado de una cuenta#
Una cuenta en Fidi X puede estar en tres estados a lo largo de su ciclo de vida:Activa — opera con normalidad. Puede recibir y emitir movimientos.
Suspendida — temporalmente inhabilitada. No puede operar hasta que se reactive.
Cerrada — inhabilitada de forma permanente. No puede volver a operar.
Jerarquía de cuentas#
Fidi X permite que una cuenta tenga una cuenta madre (parent_account_id), habilitando estructuras jerárquicas para organizar el modelo de cuentas según la lógica del negocio. Esta capacidad es la base para construir productos más sofisticados como subcuentas o bolsillos dentro de una cuenta principal.
Personas#
Una persona es una entidad opcional que permite asociar información de un titular a una o más cuentas. Es útil cuando el producto necesita administrar datos de los usuarios que están detrás de las cuentas — nombre, identificación, datos de contacto — sin que eso afecte la lógica contable.No todos los casos de uso requieren personas. Su uso depende de si el negocio necesita gestionar la identidad de los titulares dentro de Fidi X, o si esa responsabilidad vive en otro sistema.Las personas también soportan jerarquía — una persona puede tener dependientes, lo que permite modelar estructuras organizacionales o familiares cuando el producto lo requiere.
(referencia técnica de la API)
Modificado en 2026-05-29 14:31:20
