Canal de ventas VTEX

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

Versión del Plugin

Estado

1.0

Publicado

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.

Dato

Nivel

Descripción

Activo

Producto

Debe estar activo el producto.

Política Comercial

Producto

Debe tener marcada la política comercial generada para Linio.

Marca

Producto

Debe tener asignada una marca de las mapeadas en el proceso de integración.

Categoría

Producto

Debe tener una categoría asignada, de las mapeadas en el proceso de integración.

Imagen

Producto

Debe tener por lo menos una imagen cargada.
Su dimensión (en píxeles) debe estar entre 200x200 y 2000x2000.

Precio

SKU

Debe tener precio asignado a nivel SKU para la política comercial de Linio.

Stock

SKU

Debe tener un valor asignado para la política comercial de Linio.
Debe ser igual o mayor a 5.

Paquetería

SKU

Las medidas de empaquetado (peso expresado en gramos).

  • Seller Center = VTEX
  • 1kg = 1000.00g
  • 0.5Kg = 500.00g

Esto ocurre porque VTEX envía los datos en gramos y luego se convierten en kilogramos en Seller Center.

Especificaciones

Producto/SKU

Debe verificar todas las especificaciones dentro del grupo Linio's specifications a nivel Producto y SKU.
Aquellas identificadas con (required) son obligatorias.

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.

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

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.

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:

Estado

Descripción

Pendiente

Es el estado predeterminado para los nuevos pedidos.

Cancelado

Es un estado opcional para los pedidos. Debes saber que en algunos casos se cobrará una tarifa de cancelación (obtén más información al final del documento).

Listo para enviar

Es el estado que se enviará. Importante: El producto debe embalarse en su almacén y estar listo para ser recogido. Después de eso, el estado cambiará a "Enviado".

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:

Tipo

Descripción

Postal

Este es el preferido por los clientes que optan por un método de envío gratuito o de bajo costo y están dispuestos a esperar más tiempo para la entrega de sus productos.

Express

Es lo que prefieren los clientes que desean pagar más por una entrega rápida y puede ser más apropiado en determinadas circunstancias (producto comprado como regalo, temporada navideña, etc.).

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

Requisito

Descripción

Cuenta en Seller Center

Es indispensable tener una cuenta habilitada para vender en Linio.
¿Crear una nueva cuenta?.

KAM

Para comenzar el proceso de integración es indispensable tener asignado un KAM (Key Account Manager).
Esta persona será quien se pondrá en contacto con el equipo de integración.

En su tienda VTEX

Requisito

Descripción

Tienda

Debe tener una tienda habilitada en VTEX.

Política Comercial

Recomendamos siempre crear una política comercial, especialmente dedicada para nuestra integración. De todas formas si lo requiere puede emplear la que desee.
Esto determinará si el producto debe ser sincronizado.

Código postal

Esta configuración es importante para el proceso de envío de sus productos.

Aplicación Proxy For Linio

Debe tener instalada la aplicación Proxy For Linio en su tienda, esta será necesaria para poder sincronizar las órdenes entre Seller Center y 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.

Estados

Descripción

Instrucciones

El equipo de integración envía las instrucciones e información complementaria para poder comenzar cada fase.

Validación

Se reciben los datos, se procesan, analizan y valida que sean correctos, de lo contrario se acompaña para conseguir el resultado esperado.

Aprobación

Se informa la aprobación de la fase e indica instrucciones para la siguiente.

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

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

Campo

Tipo

Descripción

store

Chile: CL
Colombia: CO
México: MX
Perú: PE

Es el código del país en el cual se registró para Seller Center

name

Texto

Es el nombre de su cuenta de Seller Center

sellercenter_key

Email
[email protected]
[email protected]

Este es el usuario que tiene configurado en su tienda de Seller Center con permisos Full Access

sellercenter_secret

Texto

Relacionado al correo del usuario, api-key

VTEX

Campo

Tipo

Descripcion

vtex_seller_id

Número

Es su ID de vendedor (Seller) en VTEX.
Por lo general suele ser 1.

Puede consultarlo desde
VTEX > Menú > MarketPlace > Sellers > Gestión

trade_policy_id

Número

Corresponde el ID de la política comercial generada para la integración de Linio.

Puede consultarlo o crearlo desde
VTEX > Menú > Configuración de la tienda > Políticas comerciales

has_automatic_guide

Número

  • Si: 1
  • No: 0

Indique si trabajará con las guías de envío automáticas proporcionadas por Linio Shipping Provides.

dock_id

Alfanumérico

Es el dock que usted, como vendedor, ha configurado para Linio.

Puede consultarlo o crearlo desde
VTEX > Menú > Pedidos > Inventario y envío > Estrategia de envío > Muelles de carga

identifier

miTienda.myvtex.com

Es el nombre de la tienda VTEX

vtex_api_key

vtexappkey-example-LNLVTEX

Es la clave de la API de VTEX

vtex_api_secret

Alfanumérico

Es el token de acceso API de 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 recomendamos que el nivel de la categoría de Seller Center sea igual o superior a 4, de tal manera que los productos sean aprobados por el control de calidad (Quality Control)
Ejemplo:

  • Pet Supplies > Dogs (Nivel 2)
  • Pet Supplies > Dogs > Dogs Carriers & Travel Products > Dogs Carriers (Nivel 4)

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.

Condición

Descripción

Política Comercial (Trade Policy)

Debe tener tildada la política comercial generada anteriormente para la integración de Linio.
* Determina si el producto se sincroniza con Seller Center.

Categoría

Debe estar sobre la categoría mapeada en la Fase 01: Configuración Inicial.

Imagen

Debe tener una imagen mayor a 200x200 y menor a 2000x2000. (ver imagen de ejemplo)

Precio

Debe asignarle un precio al SKU para la política comercial de Linio.
Recomendamos que sea acorde a la categoría asignada.

Stock

Debe asignarle un stock al SKU para la política comercial de Linio.
Recomendamos un valor de 10, posteriormente utilizado en Fase 03.

Especificaciones

Complete todos los campos de especificaciones a nivel Product y SKU indicados con la leyenda (Required).

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

Casos

Paso 01

Paso 02

Paso3

Resultado

Caso 1: Order Delivered

Linio.com: Crear una orden del producto demo en linio FrontEndUrl (1)

VTEX: Cambiar el estado de la orden a Facturada.

Seller Center: Cambiar el estado de la orden a Delivered (2)

Estado de orden en
Seller Center: Delivered
VTEX: Facturada

Caso 2: En VTEX Order Canceled (3)

Linio.com: Crear una orden del producto demo en linio FrontEndUrl (1)

VTEX: Cambiar el estado de la orden a Cancelada.

n/a

Estado de orden en
Seller Center: Cancelada
VTEX: Cancelada

Caso 3: en Seller Center Order Canceled (3)

Linio.com: Crear una orden del producto demo en linio FrontEndUrl (1)

Seller Center: Cambiar el estado a cancelada

n/a

Estado de orden en
Seller Center: Cancelada
VTEX: Cancelada

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í.