Campos principales - Lerian

Esta página consolida los campos fundamentales que aparecen en múltiples APIs de Lerian. Estos campos representan la columna vertebral de cómo identificamos datos, rastreamos eventos del ciclo de vida, paginamos resultados y garantizamos la trazabilidad.

1. Identificadores únicos

Campo	Descripción	Usos
id	Identificador único universal (UUID v4)	Midaz, CRM, Fee, Auth, Pix, Identity
accountId	Identificador único de cuenta en el libro mayor	Midaz, CRM, Pix
organizationId	Identificador de la organización propietaria	Midaz, Fee
ledgerId	Identificador único de libro mayor	Midaz, CRM, Fee
holderId	Identificador del titular de la cuenta	CRM
transactionId	Identificador único de transacción financiera	Midaz, Pix
externalId	ID de correlación para sistemas externos	CRM, Pix
endToEndId	Identificador de extremo a extremo Pix	Pix
protocolId	Identificador de protocolo DICT Pix	Pix
segmentId	Identificador de segmento organizacional	Midaz, Fee
portfolioId	Identificador de portafolio	Midaz
assetId	Identificador de activo financiero	Midaz
routeId	Identificador de ruta de operación	Midaz
templateId	Identificador de plantilla	Reporter
jobId	Identificador de trabajo de procesamiento	Reporter
clientId	Identificador de cliente OAuth2	Auth
userId	Identificador de usuario	Auth, Identity
groupId	Identificador de grupo	Identity
roleId	Identificador de rol	Identity
bankId	Código bancario ISPB (8 dígitos)	Pix

2. Campos temporales (marcas de tiempo)

Campo	Descripción	Usos
createdAt	Marca de tiempo de creación (ISO 8601)	Midaz, CRM, Fee, Pix, Identity
updatedAt	Marca de tiempo de última actualización	Midaz, CRM, Fee, Pix, Identity
deletedAt	Marca de tiempo de eliminación lógica	Midaz, CRM, Fee, Identity
executedAt	Marca de tiempo de ejecución efectiva	Pix
scheduledAt	Hora de ejecución programada	Pix
expiresAt	Marca de tiempo de expiración	Pix, Auth
settledAt	Marca de tiempo de liquidación financiera	Pix
transactionAt	Marca de tiempo de transacción	Pix
dueDate	Fecha de vencimiento	Pix
birthDate	Fecha de nacimiento (YYYY-MM-DD)	CRM
foundingDate	Fecha de fundación de empresa	CRM
accountOpeningDate	Fecha de apertura de cuenta	Pix
timestamp	Marca de tiempo de evento genérico	Auth, JD Mock
uptime	Tiempo de actividad del sistema	Pix, JD Mock

| lastLoginAt | Marca de tiempo de último inicio de sesión | Identity | | lastActivityAt | Marca de tiempo de última actividad | Identity |

3. Paginación y navegación

Campo	Descripción	Usos
limit	Elementos por página (default: 10)	Midaz, CRM, Fee, Pix
page	Página actual	Midaz, CRM, Fee

| total | Número total de elementos | Midaz, CRM, Fee | | items | Elementos en la página actual | Midaz, CRM, Fee | | sortOrder | Orden de clasificación (asc/desc) | CRM | | includeDeleted | Incluir elementos eliminados lógicamente | CRM | | hardDelete | Solicita la eliminación sujeta a la política de retención y cumplimiento | CRM |

4. Control y metadatos de auditoría

Campo	Descripción	Usos
version	Versión de recurso o API	Pix, JD Mock
environment	Entorno (prod/dev/stage)	Pix, JD Mock
traceId	Identificador de traza de registro	Pix
createdBy	Usuario creador	Identity
updatedBy	Usuario de última actualización	Identity
deletedBy	Usuario que eliminó el recurso	Identity