Skip to main content
Los tipos de cuenta clasifican las cuentas de tu ledger. Cada tipo de cuenta tiene un nombre, una descripción y un valor de clave único. Registras los tipos de cuenta que coinciden con tu estructura contable. Cuando habilitas la validación de tipo de cuenta, el ledger verifica el campo type de cada nueva cuenta no externa contra estos tipos registrados.

​
Cómo funciona la validación de tipo de cuenta

​
Habilitar la validación de tipo de cuenta

Habilitas la validación de tipo de cuenta por ledger mediante la API de configuración del Ledger. Envía una solicitud PATCH al endpoint de configuración del Ledger:
Los cambios de configuración tienen efecto de inmediato y no requieren un nuevo despliegue. Puedes actualizarlos en cualquier momento mediante la API.

​
Comportamiento del campo type en la API de Cuentas

Cuando creas una cuenta, el comportamiento del campo type depende de la configuración de validación:
  • Validación deshabilitada (predeterminado): debes proporcionar un type. Acepta cualquier valor de cadena de hasta 256 caracteres. El ledger no lo compara con los tipos de cuenta registrados.
  • Validación habilitada: el campo type debe coincidir con el keyValue de un tipo de cuenta registrado. Midaz guarda los nuevos valores de keyValue en minúsculas y compara el valor sin distinguir mayúsculas de minúsculas. Usa valores en minúsculas en las solicitudes y en la configuración. Si no coincide, el ledger rechaza la cuenta con un error de validación. Las cuentas externas omiten esta verificación.
Antes de habilitar la validación de tipo de cuenta, revisa tus cuentas existentes. El campo type de una cuenta existente no puede cambiarse, así que crea un tipo de cuenta registrado que coincida o vuelve a crear la cuenta cuyo type debe cambiar.

​
El campo keyValue

El campo keyValue identifica un tipo de cuenta. Tiene estas restricciones:
  • Inmutable: defines keyValue cuando creas el tipo de cuenta. No puedes cambiarlo después. El endpoint de actualización de tipo de cuenta no acepta este campo.
  • Único por ledger: cada keyValue debe ser único dentro de un ledger.
  • Se usa para la validación: cuando habilitas validateAccountType en la configuración del Ledger, el ledger compara el campo type de cada cuenta no externa con un keyValue registrado, sin distinguir mayúsculas de minúsculas. El ledger rechaza cualquier cuenta no externa con un type no registrado.

​
Administrar los tipos de cuenta

Administras los tipos de cuenta mediante la API o la Lerian Console.
Consulta también
  • Enrutamiento de transacciones: las rutas de operación usan ruleType: account_type para validar el type de una cuenta contra los valores account.validIf configurados en la ruta.
  • Asientos contables: cómo Midaz resuelve las rúbricas de débito y crédito para las cuentas que estos tipos clasifican.