Crear una Cuenta
Utilice este endpoint para crear una Cuenta en Midaz. Puede crear tantas cuentas como sea necesario para estructurar su ledger, pero cada solicitud crea solo una cuenta a la vez.
Importante: Antes de crear una Cuenta, asegúrese de que el Activo correspondiente ya exista. Utilice el endpoint Crear un Activo para registrarlo si es necesario.
Si ha definido previamente Tipos de Cuenta, asegúrese de que estén correctamente configurados antes de la creación de la cuenta. Recomendamos recrear las cuentas existentes o actualizarlas para incluir el tipo correcto antes de habilitar la función de validación de Tipo de Cuenta — esto ayuda a prevenir errores de validación y garantiza el cumplimiento de su estructura contable.
Nota: el valor type external está reservado para cuentas externas gestionadas por el sistema y se rechaza en la entrada.
Encabezados
El tipo de medio del recurso. El valor recomendado es application/json.
Un identificador único utilizado para rastrear y seguir cada solicitud.
Token JWT bearer para autenticación.
Requerido cuando PLUGIN_AUTH_ENABLED=true (obligatorio en despliegues multiinquilino).
Opcional en el modo OSS de inquilino único predeterminado.
Formato: Bearer <token>
Parámetros de ruta
El identificador único de la Organización asociada al Ledger.
El identificador único del Ledger asociado.
Cuerpo
El código que identifica el Activo utilizado en la Cuenta. Importante: Debe ser un Activo que ya haya creado usando el endpoint Crear un Activo.
100Especifica el Tipo de Cuenta asociado a la cuenta. Este campo es obligatorio. Importante: Cuando la validación de Tipo de Cuenta está habilitada para su Organización y Ledger, el valor debe coincidir con un keyValue existente definido en su configuración de Tipos de Cuenta. Cuando la validación está deshabilitada (comportamiento predeterminado), el campo sigue siendo obligatorio pero acepta cualquier cadena de formato libre sin validación. El valor external está reservado y se rechaza en la entrada.
256El nombre de la Cuenta.
256Un identificador único y fácil de usar para la cuenta. Se utiliza para referenciar la cuenta en transacciones y otras operaciones. Si no se proporciona, el sistema usará el ID de la cuenta como alias. Nota: el alias no debe contener el prefijo reservado @external/, que está reservado para cuentas externas gestionadas por el sistema.
100^[a-zA-Z0-9@:_-]+$Define si la cuenta debe iniciar bloqueada.
El identificador único de la Cuenta matriz, si esta es una subcuenta.
El identificador único de la Entidad responsable de la Cuenta.
256El identificador único del Portafolio asociado.
El identificador único del Segmento que se utiliza para agrupar la Cuenta.
Un objeto que contiene información sobre el estado. Importante: Si no se proporciona, el estado predeterminado será 'ACTIVE'.
Un objeto que contiene pares clave-valor para agregar como metadatos, donde el campo name es la clave y el campo value es el valor. Por ejemplo, para agregar un Centro de Costo, use 'costCenter': 'BR_11101997'.
Restricciones: las claves deben tener como máximo 100 caracteres; los valores de cadena de texto, como máximo 2000 caracteres. No se permiten objetos anidados (los valores deben ser cadena de texto, número o booleano), la estructura no puede exceder una profundidad máxima de 10, y se permite un máximo de 100 claves.
Respuesta
Indica que la solicitud fue exitosa y la respuesta contiene los datos esperados.
El identificador único de la Cuenta.
El identificador único de la Organización.
El identificador único del Ledger.
El código que identifica el Activo utilizado en la Cuenta.
El nombre de la Cuenta.
256Un identificador único y fácil de usar para la cuenta. Se utiliza para referenciar la cuenta en transacciones y otras operaciones.
Especifica el Tipo de Cuenta asociado a la cuenta.
Define si la cuenta debe estar bloqueada.
El identificador único de la Cuenta matriz.
El identificador único de la Entidad responsable de la Cuenta.
El identificador único del Portafolio asociado.
El identificador único del Segmento que se utiliza para agrupar la Cuenta.
Un objeto que contiene información sobre el estado.
Un objeto que contiene pares clave-valor para agregar como metadatos, donde el campo name es la clave y el campo value es el valor. Por ejemplo, para agregar un Centro de Costo, use 'costCenter': 'BR_11101997'.
Restricciones: las claves deben tener como máximo 100 caracteres; los valores de cadena de texto, como máximo 2000 caracteres. No se permiten objetos anidados (los valores deben ser cadena de texto, número o booleano), la estructura no puede exceder una profundidad máxima de 10, y se permite un máximo de 100 claves.
Fecha y hora de creación (UTC).
Fecha y hora de la última actualización (UTC).
Fecha y hora de la eliminación lógica, si aplica (UTC).

