> ## Documentation Index
> Fetch the complete documentation index at: https://docs.lerian.studio/llms.txt
> Use this file to discover all available pages before exploring further.

# Tipos de cuenta

> Clasifica cuentas para reforzar la estructura del Ledger, validar transacciones y alinear el comportamiento de cuentas con tus reglas de negocio.

Los Tipos de Cuenta son plantillas de comportamiento para las cuentas de tu ledger. Definen qué operaciones se permiten en una cuenta, si la cuenta es interna o externa, y cómo participa en la conciliación — convirtiendo una etiqueta de formato libre en un contrato gobernado que el ledger aplica en cada transacción.

Los [**Tipos de Cuenta**](/es/reference/midaz/create-an-account-type) en Midaz te permiten clasificar sistemáticamente las cuentas de acuerdo con las necesidades de la estructura financiera de tu organización. Estas clasificaciones definen la naturaleza y el propósito de las cuentas dentro del diseño de tu Ledger, lo que permite un enrutamiento de transacciones adecuado y una validación operativa en diferentes categorías de cuentas.

Los Tipos de Cuenta se pueden personalizar a través de la API de Tipos de Cuenta para que coincidan con tus requisitos comerciales y flujos de trabajo financieros específicos, proporcionando la base para el procesamiento de transacciones estructurado mientras se mantiene la integridad de los datos.

## Cómo funciona la validación de Tipo de Cuenta

### Habilitación de la validación de Tipo de Cuenta

La validación de Tipo de Cuenta se habilita por Ledger a través de la [API de Configuración del Ledger](/es/midaz/ledgers#ledger-settings). Para activarla, envía una solicitud `PATCH` al endpoint de Configuración del Ledger:

<CodeGroup>
  ```json PATCH /v1/organizations/{org_id}/ledgers/{ledger_id}/settings theme={null}
  {
    "accounting": {
      "validateAccountType": true
    }
  }
  ```
</CodeGroup>

<Tip>
  Los cambios de configuración surten efecto de inmediato — no es necesario redesplegar. Puedes actualizarlos en cualquier momento a través de la API.
</Tip>

### Comportamiento del campo `type` en la API de Cuentas

Al crear una Cuenta, el comportamiento del campo `type` se adapta en función de la activación de la característica de Validación de Tipo de Cuenta:

* **Validación de Tipo de Cuenta** **Deshabilitada (Predeterminada):** El campo `type` es opcional y acepta cualquier cadena de formato libre.
* **Validación de Tipo de Cuenta Habilitada:** El campo `type` se vuelve **obligatorio** y debe coincidir con uno de los Tipos de Cuenta registrados previamente a través de la API de Tipos de Cuenta. Si se envía un tipo no válido o no registrado, el sistema devolverá un error de validación.

<Tip>
  Si tu organización está habilitando la característica de Validación de Tipo de Cuenta, recomendamos revisar las cuentas existentes. Es posible que debas recrearlas o asignar retroactivamente el Tipo de Cuenta apropiado para alinearlas con tu estructura contable.
</Tip>

Esta dinámica garantiza que cada cuenta se alinee con las categorías contables formales requeridas por tu negocio, fortaleciendo la gobernanza y los informes financieros.

### El campo `keyValue`

<Note>
  El campo `keyValue` identifica un Tipo de Cuenta y tiene las siguientes restricciones:

  * **Inmutable:** El `keyValue` se establece en el momento de la creación y no puede modificarse posteriormente. 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 determinado.
  * **Usado para validación de tipo:** Cuando `validateAccountType` está habilitado en la Configuración del Ledger, el campo `type` de cualquier Cuenta debe coincidir exactamente con uno de los strings `keyValue` registrados. Las cuentas creadas con un valor `type` no registrado serán rechazadas.
</Note>

## Gestión de Tipos de Cuenta

***

Puedes gestionar tus Tipos de Cuenta exclusivamente a través de la API.

* [Crear un Tipo de Cuenta](/es/reference/midaz/create-an-account-type) — Registra un nuevo Tipo de Cuenta para tu Ledger.
* [Listar Tipos de Cuenta](/es/reference/midaz/list-account-types) — Recupera todos los Tipos de Cuenta configurados en tu Ledger.
* [Recuperar un Tipo de Cuenta](/es/reference/midaz/retrieve-an-account-type) — Obtén información detallada sobre un Tipo de Cuenta específico.
* [Actualizar un Tipo de Cuenta](/es/reference/midaz/update-an-account-type) — Modifica la definición de un Tipo de Cuenta existente.
* [Eliminar un Tipo de Cuenta](/es/reference/midaz/delete-an-account-type) — Elimina un Tipo de Cuenta que ya no está en uso.

<Note>
  **Consulta también**

  * [Enrutamiento de Transacciones](/es/midaz/transaction-routing-entities) — Las Rutas de Operación usan `ruleType: account_type` para validar las cuentas contra los Tipos de Cuenta definidos aquí.
  * [Asientos Contables](/es/midaz/accounting-entries) — Cómo se resuelven las rúbricas de débito y crédito para las cuentas que estos tipos clasifican.
</Note>