--- title: "Campos de entidad" description: "Crea campos personalizados para guardar datos que Requiply no almacena por defecto, como el número del carné de conducir de un cliente o el número de serie de un artículo." canonical_url: "https://requiply.com/docs/es/guides/settings/fields/entity-fields" --- # Campos de entidad > Crea campos personalizados para guardar datos que Requiply no almacena por defecto, como el número del carné de conducir de un cliente o el número de serie de un artículo. En la página **Entity fields** (campos de entidad) creas y gestionas los campos personalizados que amplían los datos que se recogen en tu organización de Requiply. Sirve para adaptar la información que recoges más allá de los campos predefinidos, y está conectada con todos los lugares del producto donde se muestran o se rellenan esos campos personalizados. Aquí es donde vienes para **añadir un campo extra a un cliente, un artículo o una reserva** cuando Requiply no lo guarda por defecto: el número del carné de conducir o el número de registro de la empresa de un cliente, la fecha de compra o el número de serie de un artículo, el nombre del evento de una reserva. Crear el campo aquí es el primero de dos pasos: una vez que existe, añádelo a los registros a los que pertenece en [Configuraciones por nivel](https://requiply.com/docs/es/guides/settings/fields/level-configurations), que es lo que hace que aparezca en el formulario. Esta página está en **Settings → Fields → Entity fields**. **Solo para administradores.** La página está protegida por el middleware `admin`, así que los usuarios que no son administradores no pueden acceder a los campos de entidad ni gestionarlos.
![La página Entity fields con una tabla paginada que lista los campos personalizados, sus claves y sus tipos](https://requiply.com/docs/assets/settings/fields/entity-fields/entity-fields-screenshot.png)
La página Entity fields lista todos los campos personalizados definidos para la organización con su nombre, su clave de campo y su tipo.
## Por qué importa esta página Los campos de entidad permiten a tu organización guardar información propia de tu negocio. Los campos estándar cubren lo básico, pero cada negocio tiene sus propias necesidades de datos: método de contacto preferido, notas sobre alergias, números de referencia internos, instrucciones especiales, etc. Al definir los campos personalizados una sola vez en esta página, tu equipo puede recoger datos coherentes y estructurados allí donde se usen esos campos. Cada campo tiene una **clave de campo** estable que se genera automáticamente a partir de su nombre, así que los datos siguen siendo localizables aunque más adelante cambies el nombre que se muestra en la interfaz. ## Quién puede usar esta página - **Solo los administradores.** La página, la página para añadir y la página de edición requieren acceso de administrador. - El personal y los empleados habituales no ven esta área. - La página también depende del contexto de la organización activa: carga los campos de la organización seleccionada en ese momento. ## Qué verás Cuando hay campos de entidad, la página muestra una única tarjeta con una tabla paginada de todos los campos de la organización. La tabla incluye: - Una **fila de cabecera** con el título de la página, un **cuadro de búsqueda** global y un botón **+ Add field** (añadir campo) a la derecha. - Una columna **Name** (nombre) con el nombre legible del campo. Los campos que proporciona Requiply llevan una etiqueta **System** (sistema) (consulta [Campos del sistema](#campos-del-sistema)). - Una columna **Field Key** (clave de campo) que muestra, en texto monoespaciado, la clave generada automáticamente para uso interno. - Una columna **Field Type** (tipo de campo) que muestra el tipo de campo como una etiqueta de color (por ejemplo, Textbox, Textarea, Number, Select, Multiselect, Checkbox, Date, Phone). - Una columna **Actions** (acciones), fijada a la derecha, con dos botones con icono en cada fila: un **lápiz** para editar y una **papelera** para eliminar. Los campos del sistema muestran un **candado** en su lugar. La tabla está paginada con 10 filas por página por defecto, y el usuario puede elegir entre 5, 10, 20 o 50 filas por página. ## Estado vacío Cuando todavía no se ha creado ningún campo de entidad, la tabla se sustituye por un marcador vacío que muestra: - Un icono de lista. - Un título que anima al administrador a añadir el primer campo. - Un botón principal que lleva al administrador a la página **Add entity field** (añadir campo de entidad). El primer campo es importante porque establece cómo recogerá tu equipo los datos personalizados a partir de ese momento. Elegir desde el principio un nombre claro y el tipo de campo adecuado evita confusiones más adelante. ## Acciones principales ### Añadir un campo de entidad nuevo Al pulsar **+ Add field** (desde la cabecera de la tabla o desde el estado vacío) se abre la página **Add entity field**. La página para añadir se divide en dos columnas: - **Izquierda:** el formulario para definir el campo. - **Derecha:** una tarjeta **Preview** (vista previa) en tiempo real que muestra cómo se verá el campo una vez guardado. El formulario pide: - **Name**: el nombre legible del campo. Obligatorio, hasta 100 caracteres. La clave de campo se genera automáticamente a partir de este nombre (el cirílico se translitera, el resultado se pasa a minúsculas, se eliminan los caracteres que no son alfanuméricos y los espacios se convierten en guiones). - **Field type** (tipo de campo): se elige en un desplegable con todos los tipos de campo de entidad admitidos: Textbox, Textarea, Number, Select, Multiselect, Checkbox, **Date** y **Phone**. Según el tipo elegido, aparece configuración adicional: - **Select / Multiselect:** un campo **Options** (opciones) basado en chips donde añades las opciones que pueden elegir los usuarios. - **Number:** una sección **Number format** (formato numérico) con las reglas `min`, `max`, `minFractionDigits` y `maxFractionDigits`. Por defecto, de 0 a 1000 con entre 0 y 2 decimales. - **Date:** una sección **Date Format** (formato de fecha) con un interruptor **Show time** (mostrar la hora). Desactivado, el campo guarda una fecha de calendario sin más; activado, guarda un instante y la nota de ayuda dice *"Values are stored in UTC and shown in the organization timezone."* (los valores se guardan en UTC y se muestran en la zona horaria de la organización). La sección muestra una vista previa del formato elegido como *Displayed as: {value}* (se muestra como) e indica la zona horaria en la que se mostrará. - **Phone:** sin sección de formato. El campo se muestra como un campo de teléfono con un selector de país y su bandera, y guarda el número en formato internacional E.164 (`+380953370000`). El selector se abre con el país del teléfono de tu organización y, si no lo hay, con el país del idioma de la interfaz. - **Textbox / Textarea:** una sección **Text format** (formato de texto) con las reglas de longitud `min` y `max`. Por defecto, de 0 a 500. Al pulsar **Save** se crea el campo para la organización actual y vuelves a la lista de campos de entidad con un aviso de confirmación. **Cancel** vuelve a la lista sin guardar. Mientras se guarda, la página queda bloqueada por una capa a pantalla completa. ### Editar un campo de entidad Al pulsar el icono del **lápiz** junto a un campo se abre la página **Edit entity field** (editar campo de entidad).
![La página Edit entity field con un campo de tipo Select que muestra sus opciones y una vista previa en tiempo real a la derecha](https://requiply.com/docs/assets/settings/fields/entity-fields/edit-field.png)
Edición de un campo Select. El nombre y el tipo de campo son de solo lectura; solo se puede cambiar la lista de opciones (con su vista previa en tiempo real).
La página de edición también usa un diseño de dos columnas con una vista previa en tiempo real a la derecha. En la página de edición: - **Name** y **Field type** se muestran como texto de solo lectura. No se pueden cambiar una vez creado el campo. - Solo se puede editar la configuración propia del tipo de campo: - **Select / Multiselect:** la lista **Options**. - **Number:** las reglas de formato numérico (mínimo, máximo, decimales). - **Date:** el interruptor **Show time**. - **Textbox / Textarea:** las reglas de formato de texto (longitud mínima y máxima). El botón **Save changes** (guardar los cambios) sigue desactivado hasta que cambias algo respecto a los valores cargados. **Cancel** vuelve a la lista sin guardar. Mientras se cargan o se guardan los datos, una capa de carga cubre la página. ### Eliminar un campo de entidad La página ofrece dos formas de eliminar un campo: - Desde la lista, pulsa el icono de la **papelera** en las acciones de la fila. - Desde la página de edición, pulsa el botón **Delete**, abajo a la izquierda. Las dos opciones abren el diálogo de confirmación **Delete entity field** (eliminar campo de entidad). Tras confirmar, el campo se elimina y la lista se actualiza (o, si lo hiciste desde la página de edición, vuelves a la lista). **Atención:** eliminar un campo es, en principio, una acción definitiva. Todos los lugares que muestran el campo o dependen de él dejarán de tenerlo disponible, así que asegúrate de que ningún flujo de trabajo importante depende de él antes de eliminarlo. ### Campos del sistema Algunos campos los define Requiply y no tú, porque otras partes del producto los leen. Aparecen en la lista con una etiqueta **System** y un **candado** en lugar de los botones de editar y eliminar: *"System field definitions are managed by Requiply. You can configure where they are used."* (Requiply gestiona las definiciones de los campos del sistema; tú puedes configurar dónde se usan).
Campo Clave Tipo Niveles Lo usa
ЄДРПОУ / РНОКПП (ІПН) : el código ucraniano de persona jurídica (EDRPOU de 8 dígitos) o el número fiscal de persona física (RNOKPP / IPN de 10 dígitos) system_ua_legal_party_code Textbox, de 8 a 10 dígitos Client, Organization Enviar un documento para firmar rellena el código del cliente a partir de este campo.
Se crea un campo del sistema para cada organización y, una vez que lo añades en [Configuraciones por nivel](https://requiply.com/docs/es/guides/settings/fields/level-configurations), se comporta como cualquier otro campo: aparece en el formulario de cliente (o en [Información de la organización](https://requiply.com/docs/es/guides/settings/organization/info)), se guarda en cada registro y está disponible como variable de plantilla. Solo admite dígitos y debe tener exactamente 8 o 10 dígitos; no tiene valor por defecto. ### Buscar La cabecera incluye un cuadro de **búsqueda global**. Lo que escribes en él filtra la tabla en todas las columnas visibles con una coincidencia de tipo "contiene", así que es fácil encontrar un campo por su nombre, su clave o la etiqueta de su tipo. ## Formularios y campos ### Página para añadir
Campo Obligatorio Notas
Name Sí De 1 a 100 caracteres. Se usa para generar la clave de campo.
Field type Sí Debe ser uno de los valores de EntityFieldType . Por defecto, Textbox .
Options Cuando el tipo es Select o Multiselect Lista libre de chips.
Number format Cuando el tipo es Number min , max , minFractionDigits , maxFractionDigits .
Date Format Cuando el tipo es Date Interruptor Show time .
Text format Cuando el tipo es Textbox o Textarea Longitud min , max .
Validación visible en el código: el nombre es obligatorio y tiene un máximo de 100 caracteres; el tipo de campo debe ser un valor válido de `EntityFieldType`. ### Página de edición - **Name** y **Field type** son de solo lectura. - Se muestran las mismas secciones de configuración según el tipo que en la página para añadir, rellenadas con los valores del campo guardado. - **Save changes** solo se activa cuando la configuración correspondiente es distinta de la que se cargó al principio. ## Los tipos de campo Date y Phone Estos dos tipos de campo se añadieron después del conjunto original, y los dos hacen algo más que guardar un texto. ### Date Un campo **Date** (fecha) se muestra como un selector de fecha y se ordena, se filtra y se compara como una fecha real y no como texto, algo importante en las condiciones de los [flujos de trabajo](https://requiply.com/docs/es/guides/automations/workflows) y en las columnas de las tablas. El interruptor **Show time** decide qué se guarda realmente:
Show time Se guarda como Se muestra como
Desactivado Una fecha de calendario, YYYY-MM-DD . El mismo día en todas partes y para todo el mundo. Adecuado para el fin de una garantía, la fecha de compra o la validez de una licencia.
Activado Un instante, en UTC. Convertido a la zona horaria de la organización definida en Fecha y hora . Adecuado para las horas de inspección y todo aquello en lo que importa la hora.
Como un campo solo de fecha no lleva zona horaria, nunca se desplaza un día cuando se lee desde otro país. Activa **Show time** solo cuando la hora del día forma parte real del valor. ### Phone Un campo **Phone** (teléfono) se muestra como un campo de teléfono con un selector de país con buscador y su bandera, y guarda lo que escribes en formato internacional **E.164**: un `+`, el prefijo del país y, después, el número nacional sin los ceros iniciales. Si escribes `095 337 0000` con Ucrania seleccionada, se guarda `+380953370000`. Guardar siempre la misma forma canónica es lo que permite que el mismo número funcione como enlace para llamar, como contacto de WhatsApp, Viber o Telegram desde las acciones rápidas de un cliente, y como destinatario de la [acción de flujo de trabajo de SMS y Viber](https://requiply.com/docs/es/guides/automations/workflows) sin tener que limpiarlo. El selector se abre con el país del número de teléfono de tu organización y, si la organización no tiene ninguno, con el país del idioma de la interfaz. ## Cómo se conecta esta página con el resto de Requiply
Función Cómo le afecta esta página
Recogida de datos personalizados Los campos definidos aquí se convierten en los campos personalizados que tu equipo puede rellenar en las entidades que los admiten.
Estabilidad de la clave de campo El fieldKey generado automáticamente es el identificador estable con el que se hace referencia al campo en los datos guardados, así que conviene tratarlo como el identificador fijo para integraciones o informes.
Comportamiento según el tipo Las reglas de formato y las opciones elegidas aquí determinan la validación y la selección allí donde se muestre el campo.
## Casos habituales ### Configurar datos personalizados para un negocio nuevo Un administrador abre **Settings → Fields → Entity fields**, llega al estado vacío y añade los primeros campos que quiere controlar: por ejemplo, un Select "Contacto preferido", un Textbox "Referencia interna" y un Number "Límite de descuento" con reglas de formato de mínimo y máximo. ### Añadir una opción nueva a un desplegable existente Un equipo necesita un valor nuevo en un campo Select. El administrador pulsa el lápiz junto al campo, añade el chip nuevo en la lista **Options** y guarda. El nombre y el tipo del campo no cambian, así que los datos existentes siguen cuadrando. ### Ajustar la validación de un campo de texto libre Tras ver que el personal escribe notas muy largas en un Textbox, un administrador edita el campo y baja la longitud **max** en las reglas de formato de texto. A partir de ese momento, las entradas nuevas quedan limitadas. ### Limpiar los campos que no se usan Un administrador revisa la lista, busca los campos que sospecha que ya no se usan y los elimina con el icono de la papelera tras confirmarlo en el diálogo de eliminación. ## Consejos y precauciones **Consejo:** elige bien el nombre del campo al crearlo: de él sale la clave de campo generada automáticamente, y el nombre y el tipo no se pueden editar después. Si necesitas otro nombre u otro tipo, tendrás que eliminar el campo y crear uno nuevo. **Consejo:** en los campos Select y Multiselect, planifica la lista de opciones antes de empezar a usar el campo, para que los usuarios vean un conjunto coherente de opciones desde el primer día. **Atención:** eliminar un campo de entidad lo quita del sistema. Confirma que ningún flujo de trabajo importante sigue dependiendo de él antes de eliminarlo. **Los campos del sistema** no se pueden editar ni eliminar aquí. Si no necesitas alguno, simplemente no lo añadas a ningún nivel en [Configuraciones por nivel](https://requiply.com/docs/es/guides/settings/fields/level-configurations). ## Sitemap See the full [sitemap](https://requiply.com/docs/sitemap.md) for all pages.