1. Fidi X
Fidi X Developer Preview
  • Fidi X
    • Introducción
    • Conceptos Fundamentales
    • Diccionario de Datos - Enumeraciones
    • Autenticación
      • Obtener Token de Acceso
    • Cuentas
      • Crear Cuenta
      • Obtener Cuenta por ID
      • Listar Cuentas por Ledger
      • Actualizar Cuenta
      • Eliminar Cuenta
      • Suspender Cuenta
      • Activar Cuenta
      • Obtener Balance de Cuenta
      • Obtener Cuentas linkeadas
      • Linkear Cuenta Bancaria
      • Deslinkear Cuenta Bancaria
    • Personas
      • Crear Persona
      • Listar Personas
      • Obtener Persona por ID
      • Obtener jerarquía de persona
      • Bloquear persona y descendientes
      • Desbloquear persona y descendientes
      • Actualizar datos de persona
      • Eliminar persona (soft delete)
    • Transacciones
      • Crear Transacción
      • Create Notification
    • Operaciones
      • Listar Operaciones
    • Webhooks
      • Crear Suscripción Webhook
      • Listar Suscripciones
      • Obtener Suscripción
      • Actualizar Suscripción
      • Eliminar Suscripción
  1. Fidi X

Conceptos Fundamentales

Antes de integrar Fidi X, es útil tener una imagen clara de las entidades que componen el sistema y cómo se relacionan entre sí. No hace falta memorizar cada detalle ahora — esta sección existe para que puedas volver a ella cuando necesites orientarte.
Fidi X está construido sobre un modelo jerárquico: cada entidad vive dentro de otra, y esa estructura es la que garantiza el orden y la consistencia de toda la operación financiera.
(diagrama de entidades)

Organización
Es el nivel más alto del modelo. Representa al cliente de Fidi X — la empresa que opera sobre la plataforma. Cada organización es creada y configurada por el equipo de Fidi, y es el contenedor dentro del cual vive todo lo demás. Como cliente, todas las operaciones ocurren dentro de tu organización.
Ledger
El libro contable de la organización. Es el espacio donde se registran todas las cuentas, los activos y las transacciones. Una organización puede tener más de un ledger cuando necesita separar operaciones — por ejemplo, distintas líneas de negocio o geografías. Todo lo que ocurre en Fidi X ocurre dentro de un ledger.
Asset
Representa el tipo de valor que opera el ledger — una moneda, una criptomoneda, puntos, o cualquier unidad de valor que el negocio necesite administrar. Cada cuenta está asociada a un asset, y las transacciones solo pueden operar con assets que existan y estén activos en el ledger.
Cuenta
Es donde viven los saldos. Cada cuenta pertenece a un ledger, opera con un asset específico, y tiene una naturaleza contable definida — ya sea un activo propio de la empresa o una obligación hacia un tercero. Las cuentas son las piezas fundamentales sobre las que se construye cualquier producto financiero en Fidi X.
Balance
Es el estado actual de una cuenta — cuánto tiene disponible, cuánto está en tránsito y cuánto está bloqueado. El balance no se modifica directamente: es el resultado de todas las transacciones que han operado sobre esa cuenta.
Persona
Es una entidad opcional que representa a un usuario o participante dentro del sistema. Permite agrupar y administrar la información de quienes son titulares de cuentas, sin que eso afecte la lógica contable. No todos los casos de uso de Fidi X requieren personas — su uso depende de si el producto necesita administrar datos asociados a los titulares de las cuentas.
Transacción
Es el registro de un evento financiero. Cada transacción agrupa al menos dos movimientos contables que deben estar balanceados — lo que sale de un lado tiene que entrar por el otro. Una vez registrada, una transacción es inmutable: no se puede modificar ni eliminar.
Operación
Es cada uno de los movimientos individuales que componen una transacción. Si una transacción es el evento, las operaciones son los asientos contables que lo materializan — cada una sobre una cuenta específica, en una dirección específica, por un monto específico.
Modificado en 2026-05-29 14:30:15
Anterior
Introducción
Siguiente
Diccionario de Datos - Enumeraciones
Built with