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 tu catálogo: La integración enviará todos sus productos habilitados a Linio, al crearlos o actualizarlos en el Centro de vendedores 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 esta integración, háganoslo saber poniéndose en contacto con KAM (Key Account Mannager) . Quien estará encantado de acompañarlo a lo largo del proceso.

Index

Versiones

Versión del Plugin

Estado

1.0

Publicado

Requisitos

Para utilizar Linio para VTEX, necesita:

  • Una cuenta de Seller Center habilitada para vender en Linio. ¿Necesita una?.

  • Una tienda VTEX habilitada.

  • Una política comercial que se ejecuta dentro de su cuenta VTEX con la moneda del país en el que vende en Linio. No requerimos una política comercial nueva, no dude en utilizar la actual si es necesario.

  • Cuando estés listo para probar el proceso de ordenamiento, debes crear un ticket en VTEX solicitando la creación de una APLICACIÓN cuyo nombre es (Proxy para Linio). Puedes usar la imagen a continuación para respaldar la solicitud.

Consideraciones importantes

🚧

Es necesario ser claro acerca de los siguientes elementos para que el proceso en su totalidad sea tan efectivo y claro como es posible.

  • Contactos:
    • ¿Quién es el KAM (Key Account Manager)?
    • ¿Tienes algún colaborador del lado de VTEX?
    • Referencia técnica: ¿Quién llevó a cabo este proceso de integración? (cliente, desarrollador, fábrica de software).
  • Entorno:
    • Staging
    • Producción
  • En tus especificaciones, ¿Tienes algunas variaciones particulares? Ejemplo: tamaño, color, género, otros.
    • Cuál es el ID?
  • ¿Hay algún campo específico creado en tu tienda que no sea estándar de VTEX?
  • ¿Tienes una política de ventas exclusiva para nosotros?
    • ¿Estás considerando agregar una o usarías la genérica?

Configurando su tienda VTEX

Credenciales de usuario

Ahora vamos a completar el archivo seller.csv con sus credenciales de Seller Center y VTEX.

Campos:

  • vtex_seller_id: Es su ID de vendedor (Seller) en VTEX.
  • name: Es el nombre de su cuenta de Seller Center.
  • identifier: Es el nombre de la tienda VTEX.
  • store: Es el código del país: CL, CO, MX o PE.
  • sellercenter_key: Su usuario en Seller Center (su correo electrónico).
  • sellercenter_secret: Su API-KEY en Seller Center.
  • vtex_api_key: Es la clave de la API de VTEX.
  • vtex_api_secret: Es el secreto de la API de VTEX.
  • dock_id: Es el dock que usted, como vendedor, ha configurado para Linio. Puede encontrarlo en la configuración de Logística: https://{store_name}.myvtex.com/admin/logistics/#/dashboard.
  • has_automatic_guide: Indique si trabajará con las guías de envío automáticas proporcionadas por Linio Shipping Provides. 1 = Sí. 0 = No.
  • trade_policy_id: Es la política comercial que usted, como vendedor, ha configurado para Linio.

Ejemplo:

vtex_seller_id,name,identifier,store,sellercenter_key,vtex_api_key,vtex_api_secret,dock_id,has_automatic_guide
1,MyLinioStore,MyVtexStore,MX,[email protected],vtexappkey-foobar-SDFMMM,OYGHBEUGOMTBHJTHVYEDQKJRQIFZGGMCJJJJJGOODVUFTSDVKSQUMRVEP,OQTZVZIZQHJKWYOJWAUPDYXFJONPRQCCVHUQVOHJMGCQKKKKKKKQBPMQSUPGMHHAAHPPEXO,1234,1

Para obtener credenciales VTEX:

  1. Abra una nueva pestaña en su navegador.

  2. Inicie sesión en el administrador de su tienda VTEX:

https://{store_name}.myvtex.com/admin/
  1. En la barra lateral, haga clic en Gestión de la cuenta y luego en Cuenta.

  2. Haga clic en el nombre de su cuenta.

  3. En la sección Seguridad, haga clic en Generar appKey y appToken.

  4. Haga clic en Generar nuevos Tokens.

  5. El token está en el campo que se muestra a continuación. Por una cuestión de seguridad, solo se muestra una vez. Copie este token y guárdelo en un lugar seguro.

  6. Copie su appKey y su appToken.

📘

Obtenga más información sobre las credenciales de VTEX en su tutorial.

Mapeo de categorías

🚧

Mapeo de categorías

  • Importante: El mapeo de categorias debe corresponder al último nivel de VTEX, es decir, estas categorías no deben ser padres de otras categorías.

Para realizar esta acción tiene dos opciones:

  1. Usa las categorías de Linio en tu Tienda VTEX: Te preguntaremos qué categorías quieres usar y nos encargaremos de crear las categorías y los atributos requeridos en tu tienda. ¡No creerás lo fácil que es!

  2. Mapee sus categorías reales con las categorías de Linio: Mapeará sus categorías con las de Linio y nosotros nos encargaremos de crear los atributos necesarios en su tienda.

El mapeo solo se hará una vez para cada categoría. Una vez que haya hecho esto, los nuevos productos se sincronizarán directamente en la categoría correcta.

Opción 1: use las categorías de Linio en su tienda VTEX

Llene el archivo categories.csv usando la siguiente información.

Campos:

  • id_seller_center: Es el ID de categoría en Seller Center. Puede encontrarlo en el archivo a continuación, junto al nombre de cada categoría.
  • id_vtex: Elimine esta columna.

Ejemplo:

id_seller_center
45
345
789

🚧

IMPORTANTE

Esta opción sólo es recomendada para las tiendas de VTEX nuevas. Nosotros crearemos las categorías dentro del árbol de categorías.

Obtenga aquí los ID de categoría de Linio:

Opción 2: mapee sus categorías reales con las categorías de Linio

Complete el archivo categories.csv con la información que se muestra a continuación.

Complete las categorías de Linio usando los archivos de la tabla de arriba.

Campos:

  • id_seller_center: Es el ID de categoría en el Centro de vendedores. Puede encontrarlo en el archivo de arriba, junto al nombre de cada categoría.
  • id_vtex: Es el ID de categoría en VTEX. Puede encontrarlo junto al nombre de cada categoría a medida que expande el árbol de categorías en Catálogo > Categorías.

📘

PARA TENER EN CUENTA

Podemos ayudarte con este archivo CSV, precargando los IDs de las categorías de VTEX. Tienes que preguntarnos. Necesitarás quitar todas las categorías padre y cualquier categoría que tenga al menos un hijo.

Ejemplo:

id_seller_center,id_vtex
45,567
4,5456
789,234

Mapeo de marcas

Ahora vamos a hacer coincidir las marcas de Seller Center con la correspondencia en su tienda VTEX.

Descargue el archivo brands.csv y haga coincidir los identificadores de marca.

Campos:

  • id_seller_center: Es el ID de la marca en el Centro de vendedores. Explicaremos cómo obtener marcas a continuación.
  • id_vtex: Es el ID de marca en VTEX. Puede encontrarlo junto al nombre de cada marca en la sección Brand.

📘

PARA TENER EN CUENTA

Podemos ayudarte con este archivo CSV, precargando los IDs de las marcas de VTEX y Seller Center. Nuestra plantilla pre-cargada buscará automáticamente las marcas que coincidan en ambos sistemas pero si alguna no coincide en SC, tendrás que completar la plantilla manualmente.

Example:

id_seller_center,id_vtex
 1,34
 45,56
 87,34

📘

Puede completar solo las marcas que utilizará.

Obtenga las marcas del Seller Center de esta manera:

  1. Vaya a Seller Center > Configuración general > Integration Management.

  2. En el Explorador de la API, seleccione la acción "GetBrands".

  3. Ejecutar.

🚧

Si recibe el error: "E007: Login failed. Signature mismatch" (Error de inicio de sesión. No coincide la firma), haga clic en "Regenerar firma" y vuelva a ejecutar.

👍

Envíanos la información

Envíe su seller.csv, categories.csv y brands.csv a su KAM.
Cargaremos la información y le avisaremos cuando la integración esté lista para usar.

Si necesita nuestra plantilla pre-cargada, sólo necesitaremos el archivo seller.csv y la mención de las plantillas que necesita.

📘

Marca personalizada

Por favor revise las siguientes recomendaciones:

❗️

Por favor nota que el uso de las siguientes marcas con derecho de autor está prohibido:

  • Comex
  • Club América
  • Victoria's Secret
  • Bath and Body Works
  • Invicta
  • Guess

Si vende productos Apple y Xiaomi, avísenos de antemano.

Configurar afiliado

Una vez que nuestro equipo le informe que su integración está lista, deberá configurar los webhooks.

Se utilizarán webhooks para establecer la comunicación entre Linio y VTEX.

Para configurar webhooks en VTEX, vaya a Pedidos > Gestión de pedidos > Configuración > Afiliados > Novo afiliado y complete los campos como se muestra en la imagen a continuación.

Configurar webhook

Se utilizarán para establecer la comunicación de Linio a VTEX.

Por otro lado, para hacer lo mismo en Linio:

  • Inicie sesión en su cuenta de Seller Center.
  • Vaya a "Integration"
    • Configuración general > Integration management > Webhooks y haz click en Add webhook.
  • Asegúrese de que su configuración se parezca a la imagen a continuación.

La URL es:

https://sellercenter-vtex-api.linio.com/seller-center/webhook/[IDENTIFICADOR_DE_INTEGRACION]

📘

IMPORTANTE

Luego de que la integración haya sido validada, le proveeremos el [IDENTIFICADOR_DE_INTEGRACION] para configurar el webhook correcto y afiliarse.

Productos

Creación de productos:

• El producto debe pertenecer a una categoría mapeada.
• El producto debe pertenecer a una marca mapeada.
• Producto activo.
• Producto con precio.
• Producto con stock mayor que 5.
• Producto con especificaciones de Linio completas (validar Lin_Variation si se aplica).
• Producto con una política de ventas de Linio activa.
• Producto con imágenes.
• Producto con medidas de empaquetado (peso expresado en gramos).

Step 1: Si tiene variaciones, selecciónalo en:

Productos y SKUs > Edit SKU> Especificaciones:

Step 2: Luego de establecer la configuración, vaya a editar el producto:

Step 3: Complete tantos campos como haya en la especificación de Linio, recuerde que los campos requeridos son indicados con ¨(obligatorio)¨:

📘

Importante

Para que los productos sean visibles en Seller Center, necesitamos que pasen el control de calidad y tengan al menos 75% aprobación, como se detalla en la imagen. Estos son los campos obligatorios organizados por categoría junto a sus requisitos:

Una vez haya completado estos pasos, necesito la siguiente información de los productos de prueba:

PRODUCTID, IDSKU, SKU, MODEL, SIZE, BRAND.

Uso

Luego de que toda la configuración haya sido cargada, puedes crear productos en tu tienda VTEX y la integración se sincronizará automáticamente con el Seller Center. Puedes crear productos individualmente o importarlos.

📘

Importante

Debes completar todos los campos de categoría para Linio para que puedan ser sincronizados con el Seller Center.

El contenido debe estar en español.

Si el producto alcanza un contenido de alta calidad, el producto se activará automáticamente en la tienda Linio.

Para validar que los productos se sincronizaron con Seller Center:

  1. Vaya a su cuenta de Seller Center. En Productos > Administrar Productos, debería ver su producto creado.

  2. Para validar si las imágenes fueron cargadas, coloque el mouse sobre el Nombre.

  3. Recomendamos una validación adicional en la vista de feeds. Vaya a Productos > Carga Masiva de Productos > Revisa los resultados. Debes ver aquí todo en verde, con una mano levantando el pulgar.

Aquí tenemos una observación importante que hacer. La validación de los productos dependerá de muchos factores diferentes. Uno de ellos es el Control de Calidad que es una validación automática en Linio, que decide si el producto debe ser aprobado o rechazado. Para obtener una guía breve, póngase en contacto con esta validación básica en Linio. Lo mismo está disponible en Seller Center:

📘

Aquí tenemos una observación importante que hacer. La validación de los productos dependerá de muchos factores diferentes. Uno de ellos es el Control de Calidad que es una validación automática en Linio, que decide si el producto debe ser aprobado o rechazado. Para obtener una guía breve, póngase en contacto con esta validación básica en Linio. Lo mismo está disponible en Seller Center.

Deshabilitar productos:

Primero debes hacerlo desde VTEX y luego desde Seller Center.

VTEX: Productos y SKUs> Editar > Cambiar.

Seller Center: Productos > Administrar Productos > desactivar.

Actualizar productos

Una vez que los productos se crearon en VTEX y se sincronizaron con Seller Center, se pueden actualizar para diferentes escenarios que ocurren en la operación diaria.

Actualizaciones de contenido y precio:

Puede actualizar el contenido, el stock y el precio. El sistema validará si el producto se creó antes o no. En el caso de que un producto fue creado previamente sin usar VTEX y todavía esté activo en Linio Seller Center, debe eliminar este producto en Linio y crearlo nuevamente en VTEX.

👍

Evaluación de pedido punto-a-punto

Una vez que las evaluacioens del producto se hayan llevado a cabo, podemos pasar a la evaluación del pedido con la ayuda de su KAM asignado para ubicar un pedido y ver su recorrido completo.

Pedidos

Envío de pedidos

El procesamiento de pedidos en Linio es diferente cuando utiliza su propio acuerdo de envío o los de Linio.

Estados disponibles para pedidos:

  • 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 SellerSku.

  1. Dentro de los detalles del pedido, debería ver el menú desplegable Estado:

  2. Seleccione "Invoice Package".

  3. Complete el proveedor de envío y el número de seguimiento.

  4. 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:

  • 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 (por ejemplo, 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. Imprímelo y pégalo 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, 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.

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 tienes preguntas acerca de los procedimientos internos llevados a cabo por Seller Center, por ejemplo pedidos, envíos, desactivación de productos, garantías, comisiones, entre otros; por favor no dudes 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 tengas algún problema específico con la integración, puedes contactarnos a través de los siguientes medios: haz click aquí.