Linio está disponible como canal de ventas VTEX. A través de esta integración, puede unirse a nuestro mercado en Chile, Colombia, México y Perú sin importar en qué parte del mundo se encuentre. Es realmente fácil administrar todo su catálogo de productos Linio y cumplir con los pedidos y, lo mejor de todo, sin salir de su tienda VTEX.

Con VTEX y el canal de ventas de Linio, puede:

1. Administrar su catálogo: La integración enviará todos sus productos habilitados a Linio, al crearlos o actualizarlos en el Seller Center de Linio. Puede crear sus productos de forma individual o masiva importándolos a VTEX.
2. Procesar pedidos: Los pedidos creados en Linio se reflejarán automáticamente en VTEX. Puede procesar pedidos utilizando proveedores de envío Linio preseleccionados y obtener documentos listos para imprimir dentro de VTEX, o utilizar su propio proveedor de envío.
3. Sincronizar stock automáticamente: La integración está diseñada para tener una conexión síncrona en tiempo real entre ambos sistemas para actualizar el stock en ambos lados cada vez que un usuario actualiza su stock manualmente o cuando se crea un pedido.

👍

IMPORTANTE

Si está interesado en utilizar nuestra integración, háganoslo saber poniéndose en contacto con su KAM (Key Account Manager), quien nos acompañará en este proceso.

Proceso de integración

• Versión
• Fase 00: Inducción / Alcance
  • Cobertura
    • Producto
      • Creación de producto
      • Publicación en linio.com
      • Actualización del producto
      • Stock de seguridad
      • Stock infinito VTEX
      • Desactivación del producto
      • Ofertas por SKU
      • Promociones y campañas
    • Órdenes
      • Sincronización de órdenes
      • Documentos de la orden
      • Configuración Sufijo
    • Envíos
  • ¿Qué ocurre en mi tienda?
  • ¿Los productos se sincronizan automáticamente?
  • ¿Las órdenes se sincronizan automáticamente?
  • Tengo una tienda en staging, ¿puedo validar la integración aquí?
  • ¿Qué datos debo tener para comenzar el proceso?
    • En su tienda en Seller Center
    • En su tienda VTEX
  • ¿Cómo comienzo el proceso?
  • Estados de fases
• Fase 01: Configuraciones
  • Configuraciones en VTEX
    • Creación de política comercial (Trade Policy)
    • Creación de muelle de carga (Dock)
    • Creación de código postal
    • Proxy For Linio
    • Credenciales de API
  • Configuraciones para Seller Center
    • Confección de sellers.csv
      • Mapeo de marcas (brands.csv)
      • Mapeo de categorías (categories.csv)
    • Configurar Webhook
    • Configurar afiliado en VTEX
• Fase 02: Catálogo
  • Creación de producto demo
  • Envío de datos del producto
• Fase 03: Órdenes
  • Matriz de órdenes
• Fase 04: Sincronización de catálogo completo
• Más ayuda
  • Tu mejor aliado
  • Seller Center
  • Preguntas frecuentes
  • Contáctenos

Versión

Proceso de integración

El proceso de integración completo consta de cuatro fases. A continuación mencionaremos lo que ocurrirá en su tienda y cuáles son los pasos a seguir en cada una de las pruebas para validar la correcta configuración de la integración.

Fase 00: Inducción / Alcance

Esta fase es fundamentalmente un espacio para recopilar toda la información necesaria para que, junto al equipo de integración y su KAM (Key Account Manager), podamos asistirlo de manera eficiente.

Cobertura

Producto

Creación de producto

Al momento de crear el producto, deben tenerse presentes las siguientes consideraciones.

El cumplir con estos ítems mencionados, se asegura la correcta sincronización con Seller Center y la aprobación por parte de Quality Control para que el producto sea publicado con éxito.

Publicación en linio.com

Como mencionamos anteriormente, el producto que se encuentra en VTEX debe cumplir ciertos requisitos básicos para que sea publicado.

Seller Center
Seller Center realiza validaciones automáticas una vez que el producto ingresa en el sistema. Si cumple la totalidad de los ítems, el producto será publicado en linio.com de manera automática.

Control de calidad
Uno de los ítems más importantes de la validación para que el producto sea publicado en linio.com de manera automática, es el Control de calidad. Este puede visualizarse ingresando a editar el producto en Seller Center.
Para que sea aprobado, el producto debe tener un puntaje igual o superior a 75%.
Puede conocer más haciendo click aquí.

Actualización del producto

La actualización de los cambios aplicados en su tienda de VTEX hacia Seller Center se realiza de forma automática.
Lo único que debe tener presente es que solo se sincronizarán aquellos productos que posean la Política Comercial de Linio tildada.

Stock de seguridad

La integración maneja un stock de seguridad para evitar compras a productos sin stock. Su valor por defecto es 5, lo que significa que si un SKU tiene 5 o menos unidades en stock quedará inactivo en Seller Center.

Este valor se puede modificar desde la tienda VTEX configurando un nuevo atributo, los pasos a seguir son los siguientes:



1. Ir a la categoría principal y crear un atributo de SKU tipo "combo" con nombre “LIN_SecurityStock” o “FALA_SecurityStock”, según sea Linio o Falabella:

2. Agregar los valores que se quieran usar:

3. Completar atributo en el SKU que se desee modificar stock de seguridad:


Stock infinito VTEX

La integración no permite productos con la configuración de VTEX stock infinito. Si un producto tiene esta opción habilitada, la integración enviará el producto a Seller Center pero con stock 0 y estado inactivo.

Desactivación del producto

Para desactivar un producto en el linio.com de Seller Center, debe realizar los siguientes pasos:

• En su tienda de VTEX
  • Busque el producto que no desea sincronizar.
  • Desmarque la Política Comercial de Linio.

• En Seller Center
  • Busque el producto a desactivar.
  • En la columna de Activo, cambie el estado del switch de ON a OFF.

Ofertas por SKU

La integración soporta precios de oferta por SKU, indicándolo para cada SKU en la política comercial creada para Linio.

Debemos generar un precio de oferta sobre la política de Linio creada sobre el SKU deseado.

Editar el precio del SKU para la política comercial de linio:
Menú > Catálogo > Productos y SKUs > Click sobre el ícono de precio ($)

Editar el precio de la política comercial de Linio

Agregar un precio de oferta para el SKU entre fechas/horas

Promociones y campañas

Actualmente la integración no soporta promociones de tipo campaña, sin embargo estamos trabajando para agregar esta característica. Pronto tendremos noticias.

Órdenes

Sincronización de Órdenes

Las órdenes generadas en Seller Center son sincronizadas de manera automática en su tienda de VTEX.
Workflow Cubiertos:

• Creación: Las órdenes se crearán en linio.com y esto se replicará en su tienda VTEX
• Facturada: Las órdenes creadas en VTEX, serán facturadas y se actualizará en Seller Center al estado Listo para enviar.
• Cancelada: Las órdenes pueden cancelarse tanto en Seller Center como en VTEX, el resultado será replicado en su contraparte (tener presente que solo ocurrirá si la orden en VTEX no fue facturada).

Importante mencionar que cada vez que se cambia de estado se agrega una nota en la factura de VTEX indicando esto.
Para que la orden se sincronice de Seller Center a VTEX, el producto debe tener en la tienda de VTEX stock asignado a la política comercial y ésta debe estar tildada.

Documentos de la orden


Cuando se sincroniza una orden con VTEX, la integración agregará una nota con las URL de los documentos generados.


Configuración Sufijo

Esta configuración agrega el número de orden en Seller Center al identificador de la orden creada en VTEX.
La integración crea la orden con los datos de {afiliado}-{id orden Seller Center}, ejemplo "LNS-123123".

Con esta opción habilitada la orden se mostrará de la siguiente manera “LINIO-123123-22112211” generando este valor con los datos de {afiliado}-{id orden Seller Center}-{número orden Seller Center}.

Para activar esa opción, se le debe solicitar al equipo de soporte de la integración realizar la configuración.

Envíos

Envío de pedidos

El procesamiento de pedidos en Linio es diferente si utiliza su propio acuerdo de envío o los de Linio.
Estados disponibles para pedidos:

Escenario 1: Uso de su propio acuerdo de envío.

1. Se recibe un nuevo pedido en su cuenta de Seller Center.
2. Si el SKU vendido en Linio existe en VTEX, el pedido debe sincronizarse:
   • VTEX SKU = Seller Center Seller SKU.
3. Dentro de los detalles del pedido, debería ver el menú desplegable "Estado"
4. Seleccione "Invoice Package".
5. Complete el proveedor de envío y el número de seguimiento.
6. Botón "Guardar".

Como verá, no es posible cambiar el estado a "Enviado" o "Entregado". Esto sucede porque incluso si desea utilizar su propio acuerdo de envío, debe utilizar un proveedor de envío válido disponible en Linio. No se puede proveer un transportista que no sea válido para Linio.

Ofrecer diferentes opciones de envío permite a los clientes elegir el costo de envío y el tiempo de entrega que más les convenga. Cada método de envío puede ser adecuado para diferentes clases de clientes:

Escenario 2: Uso del acuerdo de proveedores de envío de Linio.

Para procesar un pedido, siga los mismos pasos que en el Escenario 1.

Después de actualizar la página, verá los enlaces para obtener documentos sobre los comentarios del pedido:

• Factura: Es el recibo de Linio. Adjúntelo al paquete para que el cliente lo descubra una vez que se entregue el paquete.
• ShippingParcel: Es el PDF generado por Seller Center. Debe imprimirlo y pegarlo en el paquete para enviar el producto al cliente.

Escenario 3: Cancelaciones.

1. La cancelación sigue los mismos 4 primeros pasos desde el envío del pedido mencionadas en el Escenario 1, pero en lugar del paquete de factura, la selección debe ser "Cancelar pedido".
2. Haga clic en el botón Guardar.

El pedido debe cancelarse en Seller Center y en VTEX. Como resultado, el producto queda desactivado en la Tienda Linio.

¿Qué ocurre en mi tienda?

• Inicialmente deberá generar algunos elementos necesarios con el fin de lograr cumplir con las necesidades de la integración que realizará las transacciones para sincronizar productos y órdenes. (política Comercial, Dock, código postal, instalación de aplicación complementaria, otros).
• Más avanzado en la Fase 02, se crearán especificaciones a nivel producto y el SKU dentro de un grupo especialmente identificado para Linio. Estas especificaciones deberán ser completadas y son estos datos los que se reflejaran en Seller Center.

¿Los productos se sincronizan automáticamente?

Sí, los productos se sincronizan automáticamente de VTEX hacia Seller Center.

¿Las órdenes se sincronizan automáticamente?

Sí, las órdenes se sincronizan automáticamente de Seller Center hacia VTEX y viceversa según corresponda la equivalencia de estados.

Tengo una tienda en staging, ¿Puedo validar la integración aquí?

Linio cuenta con un ambiente de staging para realizar pruebas. La única condición a tener en cuenta es que la tienda de VTEX-STG debe ir con Seller Center-STG y VTEX-PROD debe ir con Seller Center-PROD.

¿Qué datos debo tener para comenzar el proceso?

Para comenzar el proceso de integración de VTEX con Seller Center debes tener los siguientes datos:

En su tienda en Seller Center

En su tienda VTEX

¿Cómo comienzo el proceso?

El primer proceso debe comenzarlo poniendo se en contacto con su KAM (Key Account Manager), quien se pondrá en contacto con el equipo de Integraciones, donde se le darán instrucciones particulares para avanzar con cada una de las fases mencionadas más adelante.
No comience ninguna fase sin que el equipo de integración o su KAM lo indique.

Estados de fases

Cada una de las fases mencionadas a continuación posee tres estados básicamente.

Fase 01: Configuraciones

El proceso de configuración inicial está compuesto por los siguientes items:

• Configuraciones en la tienda de VTEX
• Configuraciones iniciales para Seller Center.
  • Confección de sellers.csv
  • Mapeo de marcas y categorías

Configuraciones en VTEX

Debe realizar las siguientes configuraciones en su tienda de VTEX. Puede emplear las que tiene configuradas, pero recomendamos siempre aislar lo que más se pueda cada una de las integraciones en su tienda con el fin de prevenir futuros inconvenientes.

Creación de Política comercial (Trade Policy)

Debemos crear una política comercial especialmente destinada para nuestra integración, esta es la que determinará que productos deben ser sincronizados con Seller Center. Documentación oficial.

Creación de Muelle de carga (Dock)

Debemos crear un muelle de carga para Documentación oficial.

Creación de Código Postal

Por favor vea el siguiente instructivo para crear correctamente el código postal.Descargar.

Proxy For Linio

Debemos instalar una aplicación complementaria en nuestra tienda que no se encuentra disponible en el marketplace de VTEX, por lo que debe solicitarla generando un ticket a soporte. A continuación tendrá la información necesaria para hacerlo.

• Ingresar a Support VTEX
• Genere un nuevo ticket con el siguiente contenido, acompañado de la imagen a continuación.

Buenas estimados,
Estamos realizando el proceso de integración con linio.com, nos indicaron que debemos solicitar
por este medio la instalación de la siguiente aplicación en nuestra tienda.

AccountName: {{Reemplazar}}

Háganos saber si requerirá alguna información adicional para ejecutar la solicitud.

Gracias

Credenciales de API

Debe crear y configurar correctamente las credenciales para el uso de la API: credenciales de API de VTEX.
Al momento de asignarle rol de usuario, puede asignar el rol "owner" o, en caso de configurar otro rol distinto de owner, debe asegurarse que el mismo tenga al menos los siguientes permisos:

Configuraciones para Seller Center

Confección de sellers.csv

Con las configuraciones realizadas anteriormente en su tienda de VTEX confeccionaremos un archivo sellers.csv con los datos mencionados a continuación.

store,name,sellercenter_key,sellercenter_secret,vtex_seller_id,trade_policy_id,has_automatic_guide,dock_id,identifier,vtex_api_key,vtex_api_secret
MX,MyLinioStore,[email protected],testL1Ni05e11eRcen7erC0nV7ex,1,7,1,1s2bc,MyVtexStore,vtexappkey-example-SDFMMM,OYGHBEUGOMTBHJTHVYEDQKJRQIFZGGMCJJJJJGOODVUFTSDVKSQUMRVEP

Detalle de los campos
Seller Center

VTEX

Adjuntar y enviar el archivo confeccionado sellers.csv en la cadena de correo electrónico iniciada por su KAM con el equipo de integraciones. Se validará que los datos sean correctos y se enviará la información necesaria para continuar configurando las relaciones entre Marcas y Categorías en Seller Center y su tienda de VTEX.

Mapeo de marcas (brands.csv)

Recibirá un archivo brands.csv, donde deberemos relacionar el ID de la marca en su tienda de VTEX con su equivalencia en Seller Center.
Puede revisar la siguiente documentación faqs > Marcas o puede despejar cualquier inquietud con su KAM (Key Account Manager)

Mapeo de categorías (categories.csv)

Recibirá un archivo categories.csv, donde deberemos relacionar el ID de la categoría en su tienda de VTEX con su equivalencia en Seller Center.

En este punto solicitamos que el nivel de la categoría de Seller Center sea el máximo disponible, el que podrá variar entre 4 y 5. De esta manera, aseguremos que los productos tengan una mayor probabilidad de aprobación por el equipo de Control de Calidad (Quality Control)
Ejemplo:

• Moda > Hombres (Nivel 2)
• Moda > Hombres > Ropa Hombres > Camisetas hombre > Camisetas manga corta hombre (Nivel 5)
  

Puede revisar la siguiente documentación faqs > Categorías o puede despejar cualquier inquietud con su KAM (Key Account Manager)

Enviar brands.csv y categories.csv

Adjuntar y enviar los archivos de mapeo brands.csv y categories.csv en la cadena de correo electrónico iniciada por su KAM con el equipo de integraciones. Se validará que los datos sean correctos para avanzar con la siguiente fase o corregirlos si es necesario.

Configurar Webhook

Una vez realizados estos pasos se le enviarán los datos para configurar el webhook en Seller Center. Éste se emplea para establecer la comunicación de Seller Center a VTEX.

• Inicie sesión en su cuenta de Seller Center.
• Diríjase a Integración
  • Configuración general > Integración management > Webhooks y haz click en Add webhook.
• Ingrese la URL facilitada y tilde todos los casilleros (Feed, Order, Product).

Configurar afiliado en VTEX

Se enviará la URL para configurar el afiliado en VTEX, ésta se utiliza para establecer la comunicación de VTEX a Seller Center.

Para configurar el afiliado en VTEX

• Debe seguir la siguiente ruta:
• Pedidos > Gestión de pedidos > Configuración > Afiliados > Novo afiliado
• Complete los campos como se muestra en la imagen a continuación.

Fase 02: Catálogo

Consiste en generar un producto demo en la tienda de VTEX y realizar una simulación de sincronización con Seller Center.

Este producto que crearemos menciona test en varios campos para prevenir la compra accidental de parte de usuarios que están visitando Linio.com, particularmente en ambientes de producción.

Creación de producto Demo

El producto que crearemos en la tienda de VTEX debe cumplir las siguientes condiciones.

Ejemplo para producto demo.

• 00_img_demo.png: Imagen para el producto.

• 01_product_demo.png: Lista del producto demo.

• 02_edit_product_product.png: Datos del producto.

• 03_edit_product_specifications.png: Datos de las especificaciones del producto a completar (LIN).

• 04_edit_sku_sku.png: Datos del SKU a completar.

• 05_price_for_sku.png: Ajustar precio para política comercial de Linio.

• 06_stock_for_sku.png: Ajustar Stock para política comercial de Linio.

Envío de datos del producto

Una vez generado el producto, se deben enviar en la misma cadena de correo electrónico los siguientes datos:

• productId: 123456
• skuId: 654321

El equipo de Linio simulará la sincronización del producto, validando el correcto funcionamiento del mismo.
En caso de que esta prueba sea exitosa, se avanzará con la Fase 03. En caso contrario, se mencionarán los detalles a corregir.

Fase 03: Órdenes

Esta fase está diseñada para validar el flujo completo de órdenes de Seller Center a VTEX por medio de una pequeña matriz de prueba.

Aquí contaremos con la colaboración de su KAM (Key Account Manager) para avanzar con el producto generado anteriormente.

Tomado como ejemplo el producto demo creado anteriormente.

Matriz de órdenes

Completaremos la siguiente matriz de prueba de órdenes

En caso de que detecte algún inconveniente que impida continuar avanzando, por favor infórmelo en la misma cadena de correo electrónico, de lo contrario continúe hasta terminar la matriz completa e informe los números de órdenes generados en Seller Center para que nuestro equipo valide el flujo completo.

• Caso 1: N° orden Seller Center: 0000001
• Caso 2: N° orden Seller Center: 0000002
• Caso 3: N° orden Seller Center: 0000003

(1) KAM informará al equipo de Logisitica/Finanzas que estas órdenes son parte de una demo.
(2) Cambio de estado solicitado por el KAM al equipo de logística.
(3) Estos casos deben cancelarse, SIN haberse cambiado el estado en VTEX a facturada

Una vez validada completa la matriz de órdenes, se indicará avanzar con la fase final.

Fase 04: Sincronización de catálogo completo.

A partir de este momento puede comenzar a sincronizar con Seller Center todos los productos que posea en su tienda de VTEX.

Para acompañarlo con lo mencionado antes o despejar cualquier duda que se le presente, recomendamos ver a su KAM (Key Account Manager) como un aliado estratégico para el éxito.

Más ayuda

Tu mejor aliado

Tu mejor aliado, quien puede guiarte en todo momento y sabe exactamente en qué equipo puedes apoyarte, es tu KAM.

Seller Center

Si tiene preguntas acerca de los procedimientos internos llevados a cabo por Seller Center, como pedidos, envíos, desactivación de productos, garantías, comisiones, entre otros; por favor no dude en consultar nuestra documentación haciendo click aquí.

Preguntas frecuentes

Puedes visitar una sección de preguntas frecuentes que está en constante evolución haciendo click aquí.

Discusión

Es una sección donde puedes elevar tus preocupaciones o incluso encontrar respuestas, usando las etiquetas para filtrar rápidamente lo que estás buscando. Haz click aquí.

Contáctenos

En caso de que tenga algún problema específico con la integración, puede contactarnos a través de los siguientes medios: haz click aquí.