¿Qué es un campo personalizado?

Los campos personalizados son una potente característica de las plataformas de comercio electrónico, que permiten una mayor flexibilidad y la posibilidad de adaptar la plataforma para satisfacer requisitos empresariales específicos.

Un campo personalizado es un campo de datos definido por el usuario que le permite capturar y almacenar información específica para sus necesidades o preferencias empresariales. Estos campos no están predefinidos por el sistema, sino que pueden ser creados, nombrados y configurados por los usuarios para capturar información única relevante para sus operaciones. Proporcionan flexibilidad a la hora de almacenar y organizar datos más allá de los campos estándar, lo que permite llevar un registro más completo y personalizado.

Se pueden añadir campos personalizados a un producto, empresa, cliente, perfil, pedido u otras entidades dentro de la plataforma para capturar información específica que no esté cubierta por los campos estándar.

‍¿Dónde se pueden encontrar y gestionar los campos personalizados?

Los campos personalizados se encuentran en el Menú principal -> Configuración -> Campos personalizados

Hay tres entidades en las que puede crear o editar campos personalizados: Producto, Variante de producto y Compañia.

Producto: se refiere al artículo tangible o intangible que una empresa pone a la venta o utiliza. Puede ser un objeto físico, como un smartphone o un libro, o un servicio digital, como un software o una suscripción. Los productos tienen características, prestaciones y funcionalidades distintas que satisfacen necesidades o deseos específicos de los clientes. En el contexto de su backoffice, un producto probablemente contendría información como el nombre del producto, el precio, la categoría y cualquier otro detalle relevante.

Variante de producto: es una versión o variación específica de un producto que comparte algunas similitudes con el producto original pero puede diferir en ciertos atributos, como el tamaño, el color, la configuración o el envase. Las variantes de producto suelen utilizarse para ofrecer a los clientes más opciones y atender a diferentes preferencias o requisitos sin tener que crear productos totalmente distintos.

Compañía: Una empresa es una entidad jurídica formada por un grupo de personas para llevar a cabo actividades empresariales, como la fabricación, el comercio o la prestación de servicios, con el objetivo de generar beneficios. En el contexto de su backoffice, una entidad de empresa representaría a su organización y contendría información como el nombre de la empresa, la dirección, los datos de contacto, el número de identificación fiscal y cualquier otro dato relevante específico de la empresa.

En la pantalla principal, puede ver un resumen de todos los campos personalizados creados y sus características: el nombre (campo), la entidad a la que pertenece (ámbito del campo) y si es un campo obligatorio o no. Al acceder a ellos, puede ver sus características (nombre, ID, tipo y valor). También puede editar o eliminar el campo personalizado haciendo clic en los iconos de la derecha de esta pantalla. Para ver información detallada al respecto, vaya a la sección "creación de campos personalizados".

También hay una herramienta de búsqueda que permite encontrar más fácilmente un campo personalizado existente por su nombre o por su ID.

¿Quién puede editar los campos personalizados?

Es importante definir los permisos de acceso de los usuarios para garantizar que sólo el personal autorizado pueda modificar los campos personalizados.

En el backoffice cada tenant puede definir y configurar roles y permisos según las necesidades de la empresa. Para ello existe la función Roles y Permisos.

El backoffice, como opción por defecto, sólo permite a los usuarios "propietarios" obtener, crear, actualizar y eliminar un campo personalizado.

‍Crear campos personalizados

Un usuario puede añadir un campo personalizado en cualquiera de las entidades existentes: Producto, Variante de producto y Empresa. Un campo personalizado sólo puede pertenecer a una entidad.

En el backoffice la cantidad máxima que permite la creación de campos personalizados es 50.

Para añadir un nuevo campo personalizado, el usuario deberá definir e introducir la información en los siguientes tipos de campos:

• Nombre de campo personalizado Elabore un nombre descriptivo que identifique fácilmente su campo personalizado.
• ID: es necesario incluir un ID único que se pueda encontrar en la API y permita una integración sin problemas. Se recomienda poner el nombre del ID sin espacios y con el carácter especial (-) si es un nombre compuesto, por ejemplo: origen-país, facturación-importe mínimo.
• Ámbito del campo: defina el ámbito del campo para especificar las áreas o entidades precisas en las que se aplica el campo personalizado, por ejemplo, Producto o Variante de producto. Es importante tener en cuenta que un campo personalizado sólo puede pertenecer a una entidad.
• Tipo de campo: Es importante seleccionar el tipo de campo ideal en función de la recogida deseada de sus datos. Existen nueve tipos diferentes: alfanumérico, numérico, texto, texto enriquecido, booleano desplegable, dinero, imagen, archivo.‍
• Valor por defecto: la API necesita recibir el campo "valor" con un formato específico al crear cualquier campo personalizado. El valor SIEMPRE es una cadena, pero, esta cadena, debe tener un formato específico dependiendo del tipo de campo personalizado al que nos refiramos.‍
• Campo obligatorio: Decide si el campo es obligatorio para la información esencial o no. Si se crea un campo y se marca como obligatorio, esto debería desencadenar actualizaciones en todos los contextos. El valor por defecto del campo personalizado es esencial para este paso. Tras definir el valor, todas las empresas existentes deben actualizarse con el valor predeterminado.

Tipos de campo :

Aquí encontrará una explicación más detallada de cada tipo de campo y sus características de valor por defecto para que pueda introducir los datos en el formato correcto.

Alfanumérico:

Se refiere a los campos de datos que pueden aceptar tanto letras (caracteres alfabéticos) como números (caracteres numéricos). Estos campos permiten a los usuarios introducir y almacenar datos alfanuméricos, que pueden incluir una combinación de letras, números y caracteres especiales como signos de puntuación o símbolos. Los campos personalizados alfanuméricos son versátiles y suelen utilizarse para capturar información como nombres, direcciones, códigos de producto o números de identificación.

El formato para introducir el valor por defecto es texto y enteros, por ejemplo: "Palau_Mar 21"

‍Número:

Se refiere a los campos de datos que aceptan específicamente valores numéricos. Estos campos están diseñados para almacenar datos numéricos, como números enteros o de coma flotante, lo que permite a los usuarios introducir y manipular información numérica. Este tipo se suele utilizar para capturar datos cuantitativos, como cantidades, medidas, cifras financieras, porcentajes y otros valores numéricos relevantes para las necesidades del usuario.

El formato para introducir el valor por defecto es entero, por ejemplo : "132"

Texto:

Se refiere a los campos de datos diseñados para almacenar y manejar información textual. Estos campos permiten a los usuarios introducir y almacenar datos de texto arbitrarios, incluidas letras, símbolos y caracteres especiales. Los campos de texto son versátiles y pueden albergar diversas formas de contenido textual, como nombres, descripciones, comentarios y otras entradas de texto de forma libre.

The format to enter the default value is a JSON object, according to object (list<string, string>). These objects often have a collection of attributes that define their properties and relationships with other objects. JSON is a structure to represent data. JSON objects are collections of key-value pairs, where keys are strings and values can be strings, numbers, boolean, arrays, other JSON objects, or null.

Es un objeto traducible. El formato estándar suele ser minúsculas para el código de idioma y mayúsculas para el código de país, separados por un guión bajo:

Por ejemplo:

{
	”es_ES”: "Bienvenidos a la empresa”, 
	“en_GB”: “Welcome to the company”
}

Texto enriquecido:

Se refiere a un tipo de campo de datos que permite a los usuarios introducir y almacenar contenido de texto formateado. A diferencia de los campos de texto plano, que sólo admiten texto sin formato, los campos de texto enriquecido permiten aplicar diversas opciones de formato de texto, como tipos de encabezado, tamaños de fuente, listas numeradas o con viñetas e incluso hipervínculos incrustados.

The format to enter the default value is a JSON object, according to object (list<string, string>)

Es un objeto traducible. El formato estándar suele ser minúsculas para el código de idioma y mayúsculas para el código de país, separados por un guión bajo, por ejemplo:

{
	”es_ES”: “<p>**Bienvenidos** <b>**a**</b> **la empresa**</p>”,
  	“en_GB”: “<p>**Welcome** <b><**to the company**</b><p>”
}

Booleano:

Se refiere a un tipo de campo de datos que almacena datos binarios. Suelen utilizarse para capturar respuestas simples de sí/no o verdadero/falso, casillas de verificación u opciones binarias. Estos campos son sencillos y eficaces para almacenar datos que requieren una decisión binaria, como si se ha completado una tarea, se cumple una condición o se selecciona una opción.

El formato para introducir el valor por defecto es booleano, representando dos estados posibles, por ejemplo "verdadero" o "falso".

Desplegable:

Este campo personalizado, también conocido como lista desplegable, es un elemento de la interfaz de usuario que presenta una lista de opciones predefinidas para que los usuarios las seleccionen. Este tipo de campo personalizado permite a los usuarios elegir una única opción de una lista de opciones disponibles presentadas en un menú desplegable. Estas opciones pueden representar varias categorías, estados, opciones o atributos relevantes para los datos que se están capturando, por ejemplo, tamaño de la empresa (pequeña, mediana, grande), selección de país (lista de países).

A la hora de crear un campo personalizado desplegable, primero habría que definir el conjunto o lista de opciones que identifican correctamente las posibles respuestas al campo establecido y que se mostrarán en el menú desplegable.

En segundo lugar, es necesario cargar un archivo CSV con este conjunto de opciones haciendo clic en "añadir valores". Hay un ejemplo descargado en formato CSV.

Por ejemplo, para un campo personalizado desplegable denominado "tamaño de la empresa", los usuarios tendrían que cargar:
‍

```
ID,Nombre (EN_GB),Nombre (ES_ES),Nombre (CA_ES),Nombre (ES_MX),
Defaultoption-001,en_GB,es_ES,ca_ES,es_MX,1

small,small,pequeña,petita,pequeña,1
medium,medium,mediana,mitjana,mediana,
large,large,grande,gran,grande,

```

En este ejemplo, es importante notar que los usuarios necesitan formatear el texto de acuerdo a cada idioma que previamente definieron y habilitaron. Se recomienda no dejar ninguna columna de idioma en blanco, para ir cumplimentando cada columna de idioma según se haya habilitado. Si deja un idioma sin información (en blanco), habrá un valor vacío en "valores desplegables".

Si un usuario necesita actualizar los valores de un campo personalizado desplegable existente, existe la opción "actualizar valores", en la que los usuarios deben cargar un nuevo archivo CSV con el nuevo conjunto de opciones, siguiendo la misma lógica de formato que se ha explicado anteriormente.

Al editar un campo personalizado desplegable, es importante tener en cuenta que sólo se permite añadir opciones, cambiar las etiquetas y cambiar la opción predeterminada.

No se permite eliminar o cambiar valores en el backoffice porque esto podría generar incoherencias o errores en la información previa recopilada.

Dinero:

Un campo personalizado dinero es un campo de datos diseñado específicamente para almacenar y gestionar valores monetarios. Este tipo de campo personalizado está optimizado para manejar datos financieros, como importes en moneda, precios, costes, presupuestos o valores de transacción.

Dinero campo personalizado incluye características tales como:

1. Símbolo de moneda: Posibilidad de especificar el símbolo o código de moneda asociado al valor monetario (por ejemplo, $ para dólares estadounidenses, € para euros).

Puede obtener las divisas permitidas utilizando este punto final de la API.

En el backoffice por defecto, usted puede encontrar estas monedas: USD, EUR, GBP, JPY, MXN, PEN.

1. Formato: Compatibilidad con opciones de formato como separadores de miles, separadores decimales y colocación de divisas para mejorar la legibilidad y la coherencia.

En el backoffice el usuario debe introducir el valor monetario con una coma y dos decimales. Por ejemplo, 4,50 USD.

El formato para introducir el valor por defecto es un JSON, según objeto (importe: entero, moneda: cadena). Por ejemplo:

 {
  "amount": "1",
  "currency": "EUR"
  }

Imagen:

Un campo personalizado imagen es un campo de datos que permite a los usuarios cargar, almacenar y mostrar imágenes o gráficos asociados a un registro o entidad concretos. Este tipo de campo personalizado permite a los usuarios incluir contenido visual como fotografías, logotipos, iconos, diagramas u otros elementos gráficos junto con datos textuales o numéricos. Este campo personalizado permite adjuntar imágenes en estos formatos admitidos PNG, JPEG, GIF.

Para subir imágenes, el usuario debe utilizar el punto final de la API, y poner la url del archivo aquí, en el campo "url". En caso de que el campo personalizado permita múltiples archivos (se establece en el campo personalizado), debe hacer el mismo proceso para cada archivo manteniendo la misma referencia del campo personalizado (campo de referencia).

Además, permitimos imágenes externas. En este caso, debes poner la url de la imagen externa en el campo "url" y el campo id queda vacío. No permitimos que los campos id y url estén vacíos.

El formato para introducir el valor por defecto es un JSON, según objeto (url(opcional): cadena, id(opcional): cadena). Por ejemplo,

{
   "id": "img_0123ADR13S5KWSO110"
 }

 {
   "url": "https://external-url-example.app/path/to/image.jpg"
 }

Archivo:

Un archivo de campo personalizado es un campo de datos que permite a los usuarios cargar, almacenar y gestionar archivos o documentos asociados a un registro o entidad concretos. Este campo personalizado permite a los usuarios adjuntar archivos en este formato compatible:

• Acrobat (.pdf)
• Excel (.xls, xlsx)
• Open Office (.odt)
• Word (.doc, .docx)
• Formato de texto enriquecido (.rtf)
• Texto sin formato (.txt)
• Valores separados por comas (.csv)

El usuario debe utilizar el punto final de la API para subir archivos, y poner el id aquí, en el campo "id". En caso de que el campo personalizado permita múltiples archivos (se establece en el campo personalizado), debe hacer el mismo proceso para cada archivo manteniendo la misma referencia del campo personalizado (campo de referencia).

También permitimos archivos externos. En este caso, debe poner la url del archivo externo en el campo "url" y el campo id queda vacío.

No permitimos que los campos id y url estén vacíos.

El formato para introducir el valor por defecto es un JSON, según Object (id (opcional): string, name: string, url(opcional): string). Por ejemplo

{
   "id": "file_01FPHJA12AZSH133SAS11K",
   "name": "my file"
}

{
  "url": "https://external-url-example.app/path/to/file.pdf", 
  "name": "my file"
} 

‍

Edición de campos personalizados

La edición de los campos personalizados puede limitarse al mínimo, y si se requieren cambios importantes, se aconseja a los clientes que borren y creen de nuevo los campos personalizados.

El usuario que puede editar un campo personalizado, por defecto, es un usuario "propietario", pero dependerá de qué usuario haya habilitado este tipo de permiso.

Los campos que se pueden editar son:

• nombre del campo personalizado, valor por defecto y campo obligatorio

Los campos que no se pueden editar son:

• ID, ámbito y tipo de campo

Eliminación de campos personalizados

La eliminación de un campo puede estar restringida en algunas ocasiones, dependiendo de los roles y permisos configurados.

Existe la posibilidad de borrar todos los campos personalizados creados, pero esto sólo se permitirá a los usuarios "propietarios" o a los usuarios que tengan habilitado este tipo de permiso.

Un usuario administrador de la empresa, por ejemplo, no puede eliminar ni editar un campo personalizado; sólo puede verlos.

‍