# Sales Layer

El PIM Sales Layer almacena y gestiona tus datos en tres [**entidades**](#user-content-fn-1)[^1]:

* Categorias
* Productos
* Variantes

{% hint style="warning" %}
Además de estas tres entidades, es posible crear **entidades personalizadas**, que permiten almacenar datos que no están directamente asociados a un producto o variante en concreto (por ejemplo, una lista de certificados, una agenda de autores, etc).

El módulo Sales Layer de EasyCatalog no puede importar dichas entidades de forma predeteminada, por lo que será necesario contar con un desarrollo a media, o bien configurar un canal adicional en Sales Layer de tipo Excel o CSV.

[Contacta con nosotros](https://nousmedis.com/es/contacto-2/) para que podamos ayudarte en la configuración de tu instancia de Sales Layer.
{% endhint %}

## 1. Configuración de Sales Layer

Para poder exportar la información de tus productos, categorías y variantes a EasyCatalog, primero deberás crear un canal de salida del tipo EasyCatalog. 

### 1. 1. Crea un canal del tipo EasyCatalog

Dirígete al apartado `Canales`, y haz clic en la pestaña `Tienda de canales`. Busca ahora el canal `EasyCatalog for Adobe InDesign` y pulsa el botón `Crear`.

<figure><img src="https://3269882995-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLM9dfJ6ksXeL8dv0ysZM%2Fuploads%2F4jFPQWbc9U79dGO0v4L4%2FSL_canales.png?alt=media&#x26;token=7856cb4a-5e7f-4035-99cc-a80f109caa3b" alt="Selecciona el canal EasyCatalog for Adobe InDesign en la tienda de canales de Sales Layer"><figcaption><p>Selecciona el canal EasyCatalog for Adobe InDesign en la tienda de canales de Sales Layer</p></figcaption></figure>

### 1.2. Parámetros generales

Cuando pulsas el botón `Crear` (del paso anterior) Sales Layer mostrará el asistente de configuración de canales:&#x20;

<figure><img src="https://3269882995-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLM9dfJ6ksXeL8dv0ysZM%2Fuploads%2FZQ8fA2AE6RNLsmdR5UEP%2FSL_EC_paso1.png?alt=media&#x26;token=c183192a-d372-4667-8e3f-a4bf0a67f4ea" alt=""><figcaption></figcaption></figure>

<mark style="color:red;">➊</mark> Sales Layer mostrará el código del canal. Deberás anotar este código porque será necesario a la hora de especificar el código de canal en el cuadro de diálogo de EasyCatalog.

<mark style="color:red;">➋</mark> Añade un título descriptivo para tu canal. Te ayudará a distinguirlo del resto de canales cuando configures más de un canal del tipo EasyCatalog.

<mark style="color:red;">➌</mark> Debajo del título del canal, Sales Layer mostrará el texto que añadas en el campo `Descripción`.

<mark style="color:red;">➍</mark> Para poder establecer una conexión segura, necesitarás asignar una `clave privada`. Sales Layer generará una clave privada si todavía no has creado ninguna. Anota también este dato, pues es necesario para la configuración del canal en EasyCatalog.

<mark style="color:red;">➎</mark> Si tu instancia de Sales Layer gestiona la información de producto en más de un idioma, selecciona aquí los idiomas que deseas exportar a EasyCatalog.

{% hint style="success" %}
Cuando tu instancia de Sales Layer cuenta con más de un idioma, todos los campos configurados como multi idioma se exportarán utilizando el siguiente patrón: `nombre del campo_código de idioma`. Por ejemplo, un campo llamado `Características` y configurado como multi idioma, se exportará tantas veces como idiomas hayas marcado en esta opción. Si has marcado Español e Inglés, se exportará como `Características_es` y como `Características_en`.&#x20;
{% endhint %}

<mark style="color:red;">➏</mark> Exportar ítems con estado te permitirá determinar si exportar `todos` los productos, sólo los que están marcados como `visibles`, `visibles y borradores`, o `visibles e invisibles`.

{% hint style="danger" %}
Uno de los errores más frecuentes durante la configuración del canal EasyCatalog es marcar la opción `Sólo visibles`. Recuerda que, por defecto, Sales Layer marca un producto recién creado o importado como `Borrador`. Con la opción `Sólo visibles` seleccionada, EasyCatalog sólo recibirá los productos en estado `Visible`.
{% endhint %}

La opción `incluir categorías vacías` enviará a EasyCatalog la información de una categoría, aunque no tenga asignado ningún producto. Deja este valor en `No` para evitar que tu panel de EasyCatalog reciba más datos de los necesarios.&#x20;

### 1.3. Datos de Salida

Pulsa el botón `Continuar` para acceder a la pestaña `Datos de Salida`.

<figure><img src="https://3269882995-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLM9dfJ6ksXeL8dv0ysZM%2Fuploads%2FoWFB7GgT523ovOkS5i3y%2FSL_EC_paso2.png?alt=media&#x26;token=a2cbc2ea-d110-4327-ac7b-d29ea3732f3e" alt="Configuración de Datos de Salida en un canal EasyCatalog de Sales Layer"><figcaption><p>Configuración de Datos de Salida en un canal EasyCatalog de Sales Layer</p></figcaption></figure>

<mark style="color:red;">➊</mark> En el primer apartado deberás seleccionar cada una de las entidades que se exportarán. Recuerda que EasyCatalog sólo soporta de forma nativa las entidades `Categorías`, `Productos` y `Variantes`. Si no ves una de las entidades que quieres exportar, pulsa el botón `+ Añadir Tabla` y selecciónala de la lista desplegable.

{% hint style="success" %}
[Contacta con nosotros](https://nousmedis.com/es/contacto/) si quieres configurar un conector de importación que importe lo datos de entidades personalizadas.
{% endhint %}

<mark style="color:red;">➋</mark> <mark style="color:$primary;">La opción activar permite incluir la entidad en los datos de salida (Si) o excluirla (No).</mark>

<mark style="color:red;">➌</mark> Escribe el nombre que quieres que tenga la entidad en el canal de salida.

{% hint style="danger" %}
No cambies el valor por defecto que propone Sales Layer, o EasyCatalog no podrá reconocer la tabla.&#x20;
{% endhint %}

<mark style="color:red;">➍</mark> Si sólo quieres exportar parte de tu catálogo de productos, selecciona una categoría de la lista desplegable. Deja el valor en blanco para exportar todos los productos de todas las categorías.

{% hint style="success" %}
En Sales Layer, un producto puede pertenecer a más de una categoría. Cuando esto sucede, Sales Layer exportará el producto **tantas veces como categorías tenga asignada**. En ese caso, será muy importante seleccionar el campo `ID` como campo clave durante la configuración del panel en EasyCatalog; de lo contrario, EasyCatalog devolverá un error por registros duplicados y no podrá finalizar la importación correctamente.
{% endhint %}

<mark style="color:red;">➎</mark> Si quieres filtrar los datos que exportará el canal, puedes introducir una cadena de búsqueda: Sales Layer sólo exportará las categorías que cumplan el criterio de búsqueda.

<mark style="color:red;">➏</mark> Por defecto, el canal de exportación a EasyCatalog mostrará todos los campos de la entidad seleccionada. Cada línea representa un campo. Puedes cambiar el orden de los campos arrastrando arriba o abajo.

1. El icono de un candado significa que el campo no se puede eliminar (es necesario para la correcta importación desde EasyCatalog).
2. La opción `Tipo` determina de qué forma se exportarán los datos: `Normal` (cadena de caracteres o números), `Imagen` (exportará la url de descarga del archivo de imagen) o `Plantilla` (permite definir otros formatos de salida a medida, como JSON o XML).&#x20;
3. La columna `Nombre en EasyCatalog` te permite cambiar el nombre del campo que recibirá EasyCatalog. Esta opción no se puede modificar en campos bloqueados.
4. La columna `Campo relacionado` te permite escoger qué campo exportar en dicha fila. Si el campo no existe en tu PIM y quieres, por ejemplo, exportar un valor constante, selecciona la opción **campo vacío** y a continuación usa el botón `+ Fórmula` para escribir un valor o una fórmula.

<mark style="color:red;">➐</mark> Sales Layer incorpora un potente editor de fórmulas que permite manipular el contenido y formato de cada uno de los campos en el canal de salida.

<figure><img src="https://3269882995-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLM9dfJ6ksXeL8dv0ysZM%2Fuploads%2Fq2IW5rxH1iLE9mJIwcC8%2FSL_EC_formulas.png?alt=media&#x26;token=c812f6db-e695-47bc-b5ae-219ca06b10a3" alt="Editor de fórmulas de un canal de Salida en Sales Layer"><figcaption><p>Editor de fórmulas de un canal de Salida en Sales Layer</p></figcaption></figure>

<mark style="color:red;">➑</mark> Los campos tipo imagen permite exportar una o más versiones (formatos) de tus imágenes. Para confeccionar tu catálogo en alta calidad escoge siempre la opción `Original (ORG).` &#x20;

Repite los mismos pasos para configurar cada una de las entidades (Productos y Variantes).

## 2. Configuración del Origen de datos Sales Layer en EasyCatalog

Este es el paso más sencillo. Para empezar, selecciona `Archivo > Nuevo > Panel de EasyCatalog > Nuevo Origen de Datos Sales Layer`. Se abrirá el siguiente cuadro de diálogo:

<figure><img src="https://3269882995-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLM9dfJ6ksXeL8dv0ysZM%2Fuploads%2FfXykjpn6PDl63Hh9DyAr%2FConfiguracion%20Origen%20Sales%20Layer.png?alt=media&#x26;token=884da191-0637-426b-bf71-221709c5c014" alt="Cuadro de diálogo Configuración de origen de datos Sales Layer"><figcaption><p>Cuadro de diálogo Configuración de origen de datos Sales Layer</p></figcaption></figure>

Configura las diferentes opciones del cuadro de diálogo siguiendo estas instrucciones:

1. Empieza asignando un nombre a tu origen de datos. Será el que utilizará el panel de datos que se creará cuando pulses el botón `OK`.
2. Pega el `código de conector` y la `clave privada` que creaste en el paso anterior, durante la configuración del conector EasyCatalog en Sales Layer.
3. En el campo `Versión`, deja el valor por defecto 1.18. Para utilizar la antigua API de Sales Layer, escribe 1.17.
4. Si tu configuración de Sales Layer utiliza la entidad `Variantes`, marca esta casilla para poder importarlas.
5. Pulsa el botón `Aplicar` para que EasyCatalog se conecte a Sales Layer y valide que las credenciales y opciones que has seleccionado son válidas. Si todo está correcto, EasyCatalog mostrará una previsualización de los campos que configuraste en el canal de salida de Sales Layer.
6. Si en tu instancia de Sales Layer un producto puede pertenecer a más de una categoría, o bien has decidido importar las variantes, usa el campo ID como `campo clave`. De lo contrario, EasyCatalog devolverá un error por registros duplicados. Por defecto el campo ID ya está marcado como campo clave.
7. Pulsa el botón `OK` para finalizar.

[^1]: Una entidad de Sales Layer vendría a ser el equivalente a una Tabla en una Base de Datos relacional.