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

# Valores por tipo de campo

> Formato de los valores que envías y recibes en los registros.

En `values`, cada propiedad usa la `key` del campo. La [configuración del campo](/tableros/tipos-de-campo) se envía por separado.

| `type`            | Valor en `values`                        |
| ----------------- | ---------------------------------------- |
| `string`          | `string`                                 |
| `number`          | `number`                                 |
| `boolean`         | `true` o `false`                         |
| `date`            | Fecha o fecha y hora ISO 8601            |
| `enum`            | ID o etiqueta de una opción              |
| `enum_multi`      | Arreglo de IDs o etiquetas               |
| `relation_single` | ID de un registro relacionado            |
| `relation_multi`  | Arreglo de IDs de registros relacionados |
| `contact_single`  | ID de un contacto                        |
| `contact_multi`   | Arreglo de IDs de contactos              |
| `lookup`          | No lo envíes; la API lo calcula          |
| `files`           | No lo envíes para adjuntar archivos      |

## Números

`numberFormat` no transforma el valor. Con formato `percent`, por ejemplo, `25` se muestra como `25 %`.

## Fechas

Usa formatos ISO 8601:

* Solo fecha: `"2026-07-23"`.
* Fecha y hora: `"2026-07-23T18:30:00-06:00"` o `"2026-07-24T00:30:00Z"`.

Incluye un offset o `Z` cuando envíes hora. `dateConfig.includeTime` controla la presentación del tablero, pero no cambia la validación de la API.

## Selecciones

Puedes enviar el `id` o la `label` de una opción. La API almacena y devuelve su `id`.

```json theme={null}
{
  "values": {
    "estado": "Vigente",
    "coberturas": ["responsabilidad_civil", "danos_materiales"]
  }
}
```

Al crear o actualizar registros, `upsertEnumOptions: true` permite crear las etiquetas que todavía no existen.

## Relaciones y contactos

Envía un ID para los tipos `*_single` y un arreglo de IDs para los tipos `*_multi`.

Para modificar una relación sin reemplazar su valor completo, usa [Actualizar relaciones](/tableros/actualizar-relaciones-registro).

## Campos reflejados

No envíes valores para campos `lookup`. La API los calcula al leer el registro:

* `firstValue` y `lastValue` devuelven un valor.
* `allValues` y `uniqueValues` devuelven un arreglo.

## Archivos

No envíes archivos ni URLs directamente en `values`. Usa [Subir archivo](/tableros/subir-archivo).

Al consultar un registro, el campo contiene un arreglo de objetos:

```json theme={null}
[
  {
    "id": "<file-id>",
    "name": "poliza.pdf",
    "url": "https://...",
    "type": "application/pdf",
    "size": 245760
  }
]
```

## Valores predeterminados

`defaultValue` aplica al crear un registro cuando omites la `key`. Está disponible para `string`, `number`, `boolean`, `date`, `enum` y `enum_multi`.

No se aplica al actualizar un registro ni cuando envías la propiedad con `null`.

<Warning>
  `required` marca el campo como obligatorio en el esquema y en la captura del tablero. Al escribir por API, valida en tu integración que los valores requeridos estén presentes.
</Warning>