> ## 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.

# Diccionario de campos de Lerian

> El diccionario centralizado de campos usados en los productos de Lerian: Midaz, su CRM y Fees integrados, Flowker, Pix, Auth, Reporter y los plugins relacionados.

Esta guía organiza los campos usados en todo el ecosistema de Lerian en una única referencia. Ayuda a los equipos de ingeniería que trabajan con Midaz, sus componentes integrados de CRM y Fees Engine, Flowker, Identity, Pix, Auth, Reporter y los plugins relacionados.

Este diccionario te ayuda a validar payloads, mejorar la interoperabilidad, simplificar el QA y acelerar el desarrollo de integraciones.

## Por qué importa este diccionario

***

Las nuevas funcionalidades, plugins y versiones traen nuevos campos y comportamientos. Este diccionario centraliza todas las definiciones, para que puedas ver cómo se comunican nuestros productos entre sí.

Úsalo para:

* Construir integraciones con confianza
* Reducir la ambigüedad entre workflows
* Validar estructuras de payload
* Dar soporte a QA, observabilidad y debugging
* Acelerar la incorporación de nuevos desarrolladores

## Cómo usar esta página

***

Cada sección agrupa los campos por categorías semánticas. Cada campo incluye:

* Nombre del campo
* Descripción
* Dónde se usa en los productos de Lerian

Si trabajas con un producto específico, abre la página del diccionario correspondiente a esa área, listada más abajo en Estructura del diccionario.

<Danger>
  Para una validación estricta del esquema, siempre consulta las especificaciones oficiales de OpenAPI. Esos archivos reflejan la estructura exacta que requiere cada endpoint.
</Danger>

## Antes de explorar

***

Este diccionario sigue convenciones consistentes en todos los productos.

* Las fechas usan los formatos ISO 8601 o RFC3339
* Los UUID siguen el formato v4
* Los campos de Pix siguen los estándares de BACEN
* Los campos de workflow siguen la semántica de runtime y creación de Flowker
* Los campos de Fees Engine reflejan el último modelo v2
* Los metadatos siempre son un par clave-valor flexible

<Warning>
  Si tu integración usa operaciones sensibles como Pix, Identity o Fees Engine, verifica el comportamiento y los formatos aceptados directamente en las APIs del producto. Algunos campos se comportan de forma diferente según el contexto de ejecución.
</Warning>

## Estructura del diccionario

***

El diccionario tiene las siguientes categorías:

<Columns cols={2}>
  <Card title="Campos principales" icon="layer-group" href="/es/reference/field-dictionary/fd-core-fields">
    Campos esenciales compartidos en todas las APIs de Lerian, incluidos identificadores, timestamps, paginación y metadatos de auditoría.
  </Card>

  <Card title="Personas y organizaciones" icon="users" href="/es/reference/field-dictionary/fd-people-organizations">
    Campos que describen personas, empresas, usuarios, grupos y estructuras organizacionales.
  </Card>

  <Card title="Datos financieros" icon="money-bills" href="/es/reference/field-dictionary/fd-financial-data">
    Campos relacionados con datos bancarios, operaciones de Pix, transacciones financieras, códigos QR y límites operativos.
  </Card>

  <Card title="Autenticación y seguridad" icon="unlock-keyhole" href="/es/reference/field-dictionary/fd-auth-security">
    Campos usados para autenticación, autorización, flujos de OAuth2, validación de webhooks y monitoreo de la salud del sistema.
  </Card>

  <Card title="Workflows y reportes" icon="signs-post" href="/es/reference/field-dictionary/fd-workflows-reporting">
    Campos relacionados con la orquestación de workflows (Flowker), los reportes (Reporter), el cálculo de comisiones y el manejo de errores.
  </Card>

  <Card title="Tracer" icon="shield-check" href="/es/reference/field-dictionary/fd-tracer">
    Campos para la validación de transacciones, reglas, límites de gasto y respuestas de decisión.
  </Card>

  <Card title="Operaciones de Pix" icon="arrows-rotate" href="/es/reference/field-dictionary/fd-pix-operations">
    Campos para la resolución de disputas de Pix: reclamos, reportes de infracción, solicitudes de devolución y marcadores de fraude.
  </Card>

  <Card title="Operaciones del ledger" icon="scale-balanced" href="/es/reference/field-dictionary/fd-ledger-operations">
    Campos para saldos, rutas de transacción, rutas de operación e índices de metadatos.
  </Card>
</Columns>