# Campos

Los campos de evento son los atributos definidos en el tipo de evento que forman el contrato de datos aceptado en `POST /events`.

En términos prácticos, son estos campos los que determinan qué se validará en el envío, qué se ignorará y qué podrá usarse para generar métricas y monitoreos.

## Qué se puede configurar en un campo

Al registrar un campo en el panel de administración, usted define:

* **ID del campo**: identificador usado en el payload de la API;
* **nombre y descripción**: etiquetas mostradas en el panel;
* **tipo de dato**: formato esperado para el valor;
* **tipo de propiedad**: cómo se tratará el campo en el modelado;
* **obligatoriedad**: si el campo debe estar presente en cada evento;
* **estado**: si el campo está activo o inactivo.

## Tipos de dato disponibles

La plataforma permite los siguientes tipos de campo:

* **texto**;
* **lista** (valores predefinidos);
* **número entero**;
* **número decimal**;
* **número en coma flotante**;
* **booleano**.

### Observaciones importantes

* El campo de texto acepta hasta 128 caracteres.
* Los campos de tipo lista permiten registrar ítems permitidos para validación.
* En campos decimales, la precisión y la escala se definen en la creación.

## Tipo de propiedad: dimensión o medición

Cada campo también recibe un tipo de propiedad:

* **dimensión**: representa una característica del evento usada para segmentación;
* **medición**: representa un valor variable usado en consolidaciones.

Esta elección impacta cómo las métricas y los monitoreos pueden configurarse más adelante.

## Reglas de validación en el envío de eventos

Al recibir eventos a través de `POST /events`, el contrato de campos se aplica con las siguientes reglas:

* los campos obligatorios ausentes causan rechazo;
* los valores fuera del tipo esperado causan rechazo;
* los campos inactivos pueden permanecer en el payload, pero sus valores son ignorados;
* los campos desconocidos pueden ignorarse o rechazarse, según la configuración del tipo de evento.

## Buenas prácticas para modelar campos

* Defina IDs estables y semánticos desde el principio.
* Comience con un conjunto reducido de campos esenciales.
* Use campos de lista cuando haya un conjunto controlado de valores.
* Evite crear campos redundantes para el mismo concepto.
* Revise periódicamente los campos sin uso.

## Restricciones y ciclo de vida

Algunas configuraciones son estructurales y deben planificarse en el momento de la creación:

* el ID del campo no puede modificarse después del registro;
* el tipo de propiedad no puede modificarse después del registro;
* en campos decimales, la precisión y la escala quedan fijas después de la creación;
* los ítems de campo del tipo lista se gestionan después de que se crea el campo;
* el tipo de evento tiene un límite de hasta 100 campos.

Al eliminar un campo, la operación puede fallar si está en uso por métricas (por ejemplo, en dimensiones o agregaciones).