Skip to main content
En values, cada propiedad usa la key del campo. La configuración del campo se envía por separado.

​
Números

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

​
Fechas

Para integraciones nuevas, usa ISO 8601 y elige el formato según la configuración del campo:
Incluye siempre un offset o Z cuando envíes hora. dateConfig.includeTime controla cómo el tablero captura y muestra el dato, pero no cambia la validación de la API. Por compatibilidad, la API también acepta fechas DD/MM/YYYY y timestamps Unix en milisegundos. Un timestamp se convierte a una fecha y hora ISO 8601 en UTC. Evita esos formatos en integraciones nuevas: DD/MM/YYYY puede ser ambiguo y un timestamp siempre representa un instante con hora.
createdAt y updatedAt no son campos configurables de tipo date. La API administra ambos y los devuelve como timestamps Unix en milisegundos, por ejemplo 1720000000000.

​
Selecciones

Puedes enviar el id o la label de una opción. La API almacena y devuelve su id.
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.

​
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. Al consultar un registro, el campo contiene un arreglo de objetos:

​
Plantillas PDF

No envíes un valor para campos pdf_template. Para producir el documento usa Generar PDF.

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