Crear una Cuenta

Abre una nueva Cuenta en tu Ledger desde la Console para empezar a recibir y enviar saldos de Activo mediante Transacciones vinculadas a un Portafolio.

Debes vincular una Cuenta a un Activo existente. Crea el Activo antes de crear la Cuenta.

​

Antes de empezar

---

Necesitas una Organización, un Ledger y un Activo existentes. Si el Ledger usa Validate Account Type, crea los Tipos de Cuenta necesarios antes de abrir este formulario.

Decide qué representa la cuenta antes de elegir su tipo y alias. Ejemplos habituales son cuentas de cliente, comercio, tesorería, ingresos por tarifas, liquidación, suspenso y gastos.

​

Crear la Cuenta

---

Para crear una Cuenta, sigue estos pasos:

1. Desde la página Accounts, haz clic en el botón New Account.

2. El formulario New Account se abrirá en el lado derecho de la pantalla con tres pestañas: Account Details, Portfolio y Metadata.

3. Completa la información requerida en la pestaña Account Details.

   Para más información sobre los campos del formulario, consulta la sección Guía de campos.

4. (Opcional) Cambia a la pestaña Portfolio para vincular esta cuenta a un Portafolio con fines de reporte y gestión.

   • Selecciona un Portafolio del desplegable
   • Si no existen Portafolios, puedes crear uno primero
   • Puedes vincular o desvincular cuentas de los Portafolios en cualquier momento
5. (Opcional) Cambia a la pestaña Metadata para añadir pares clave-valor personalizados con contexto adicional o fines de integración.

6. Haz clic en el botón Save para crear la Cuenta.

​

Guía de campos

---

Campo	Qué introducir	Ejemplo
Account Name	Nombre descriptivo opcional para la cuenta. Midaz acepta hasta 256 caracteres y asigna un nombre predeterminado si no se envía ningún nombre.	John Doe Checking Account
Account Alias	Identificador único legible. No puede cambiarse tras la creación.	customer_john_checking
Type	Clasificación de la cuenta. Obligatorio. Cuando la validación de Tipo de Cuenta está habilitada, seleccionas entre los Tipos de Cuenta predefinidos; de lo contrario, lo escribes libremente. No puede cambiarse tras la creación.	customer
External account	Interruptor disponible al crear una cuenta. Actívalo para crear una cuenta externa — el tipo se establece en external automáticamente y representa saldos mantenidos fuera de este ledger.	—
Entity ID	Identificador externo opcional de Titular, cliente, departamento o partner.	customer_123
Asset	Activo que usará esta cuenta. Selecciona un Activo existente. No puede cambiarse tras la creación.	BRL
Segment	Categoría de agrupación opcional, disponible cuando existen Segmentos.	Retail
Portfolio	Grupo opcional de reporte o gestión para esta Cuenta.	Customer Portfolio
Metadata Key	Nombre de campo opcional para clasificación o integración.	costCenter
Metadata Value	Valor para la clave de metadatos.	BR_11101997

​

Ejemplos rápidos

---

Cuenta corriente de cliente

Escenario: Crear una cuenta corriente para un cliente.

Campo	Valor
Account Name	John Doe Checking
Account Alias	@customer_123_checking
Type	checking
Entity ID	customer_123
Asset	USD
Allow Sending	true
Allow Receiving	true

Cuenta de tesorería

Escenario: Crear una cuenta principal de tesorería para operaciones de la compañía.

Campo	Valor
Account Name	Main Treasury
Account Alias	@treasury_main
Type	treasury
Entity ID	org_treasury_dept
Asset	USD
Segment	Finance
Allow Sending	true
Allow Receiving	true

Cuenta de presupuesto por departamento

Escenario: Crear una cuenta de presupuesto para el departamento de ingeniería.

Campo	Valor
Account Name	Engineering Budget 2024
Account Alias	@eng_budget_2024
Type	expense
Entity ID	dept_engineering
Asset	USD
Segment	Engineering
Allow Sending	true
Allow Receiving	true

​

Notas importantes

---

Campos que no se pueden cambiar tras la creación

No puedes cambiar los siguientes campos tras crear la cuenta:

• Account Alias - Elígelo con cuidado, porque las transacciones usan el alias
• Type - No puedes reclasificarlo después de establecerlo
• Asset Code - No puedes cambiar la moneda o commodity de la cuenta

Para cambiar alguno de estos campos, crea una nueva cuenta.

Validación de Tipo de Cuenta

Si tu Ledger usa la validación de Tipo de Cuenta:

• Seleccionas el Type entre tus Tipos de Cuenta predefinidos en lugar de escribirlo libremente
• Debes seleccionar entre Tipos de Cuenta predefinidos o crearlos antes
• Esto asegura la consistencia en el plan de cuentas de tu Organización

Consulta Gestionar Cuentas para más información.

Allow Sending y Allow Receiving

Estos indicadores controlan los permisos de transacción:

• Allow Sending = false: No puedes usar la cuenta como origen (lado débito) en transacciones
• Allow Receiving = false: No puedes usar la cuenta como destino (lado crédito) en transacciones

Ambos indicadores están activados por defecto. Solo puedes cambiarlos después de crear la cuenta. Usa estos indicadores para:

• Congelar una cuenta temporalmente
• Crear una cuenta solo de recepción (por ejemplo, escrow)
• Crear una cuenta solo de envío (caso poco común)

Después de crear una cuenta, puedes usarla en transacciones de inmediato. Verifica que toda la información sea correcta antes de guardar, especialmente los campos inmutables.

​

Qué hacer a continuación

---

Después de crear las Cuentas de origen y destino:

1. Crea o revisa Rutas Contables en Crear una Ruta Contable.
2. Crea una Transacción en Crear una Transacción.

Equivalente en la API

Endpoint Crear una Account