AreaCacaoDocs
FormulaciónIngredientes

Campos personalizados

Define campos propios de tu cuenta para capturar información adicional en tus ingredientes.

Qué es

Los campos personalizados te permiten extender la información de tus ingredientes con datos propios que el catálogo estándar no recoge: origen, certificación, número de lote, etc. Los campos que definas son a nivel de tu cuenta.

Ruta de acceso

Desde el catálogo de ingredientes, pulsa el botón Campos personalizados de la cabecera. Se abre un modal con el subtexto "Define campos propios para capturar info adicional en tus ingredientes (origen, certificación, lote, etc.).".

Secciones del modal

El modal muestra la lista Campos definidos (N) —con el número de campos creados entre paréntesis— y una tabla de los campos que ya hayas creado:

ColumnaContenido
LabelNombre visible del campo.
KeyClave interna del campo.
TipoTipo de dato del campo.
RequeridoSi el campo es obligatorio.

Cada fila tiene un icono de lápiz para editar y uno de papelera para eliminar. Si todavía no has creado ninguno, verás "Sin campos definidos. Crea el primero para extender tu catálogo.".

Crear un campo

Abre el editor

Pulsa Nuevo campo. Se abre un sub-formulario en blanco.

Rellena los datos

  • Label (obligatorio) — el nombre visible del campo, por ejemplo País de origen.
  • Key (interno) — la clave interna. Se autogenera a partir del label en formato snake_case, debe empezar por letra minúscula y no se puede cambiar una vez creado el campo.
  • Tipo — elige entre Texto, Número, Fecha, Selección (dropdown) o Booleano (sí/no).
  • Opciones — solo para el tipo Selección: la lista de valores separados por comas, por ejemplo Venezuela, Ecuador, Madagascar.
  • Ayuda (opcional) — un texto de apoyo para quien rellene el campo.
  • Campo obligatorio — casilla para marcar el campo como requerido. Ver el aviso de Estado actual antes de marcarla.

Guarda

Pulsa Crear campo. El campo aparece en la lista de campos definidos.

Editar y eliminar

  • Editar (icono de lápiz) — abre el editor con los datos del campo. La clave interna queda bloqueada y no se puede modificar.
  • Eliminar (icono de papelera) — borra la definición del campo, con confirmación previa. Los valores que ya hubieras capturado en ingredientes no se borran: permanecen guardados, aunque sin su definición.

Validaciones

  • El Label es obligatorio: si lo dejas vacío, verás "El label es obligatorio".
  • La Key debe empezar por letra minúscula y estar en snake_case; en caso contrario verás "Key inválido — debe empezar por letra minúscula y ser snake_case".

Estado actual

Hoy esta pantalla sirve solo para definir los campos. El modal anticipa con la nota "Una vez definidos, podrás capturar valores en cada ingrediente personalizado.", pero el formulario del ingrediente personalizado todavía no muestra los campos definidos, así que de momento no hay dónde rellenar sus valores desde la interfaz (tampoco desde la importación CSV o JSON).

Si marcas un campo como Campo obligatorio, no podrás crear ingredientes personalizados nuevos desde Nuevo ingrediente: al guardar, el servidor responde "El campo "…" es obligatorio" y el formulario no tiene dónde rellenarlo. Deja la casilla sin marcar mientras el formulario no muestre estos campos.

No confundas ambos: los campos personalizados añaden columnas de datos; los ingredientes personalizados son fichas completas nuevas.

Siguientes pasos

En esta página