VTEX Sales Channel

Linio is available as a VTEX Sales Channel. Through this integration, you can join our marketplace in Chile, Colombia, Mexico, and Peru no matter where you are in the world. It is really easy to manage your whole Linio product catalog and fulfill orders, and best of all without leaving your VTEX store.

With VTEX and the Linio Sales Channel, you can:

  1. Manage your catalog: The integration will push all your enabled products into Linio, by creating or updating them in Linio's Seller Center. You can create your products individually or massively by importing them into VTEX.
  2. Order processing: The orders created at Linio will be automatically reflected in VTEX. You can process orders using preselected Linio shipment providers and get print-ready documents inside VTEX, or use your own shipment provider.
  3. Stock synchronized automatically: The integration is designed to have a synchronous real-time connection between both systems in order to update stock on both sides each time a user updates it's stock manually or when order is created.

👍

IMPORTANT

If you are interested in using this integration, let us know by contacting your KAM (Key Account Mannager) who will gladly accompany you throughout the process.

Index

Versions

Plugin VersionStatus
1.0Released

Requirements

To use Linio for VTEX, you need:

  • A Seller Center account enabled to sell on Linio. Needing one?

  • A VTEX store enabled.

  • A Trade policy running within your VTEX account with the currency of the country you sell on Linio. We do not require a brand new Trade Policy, feel free to use your current one if needed.

  • When you are ready to test the order process, you must create a ticket in Vtex requesting the installation of an APPLICATION whose name is (Proxy for Linio). You can use the image below to support the request.

Important considerations

🚧

It is necessary to be clear about the following items so that the whole process is as effective and clear as possible

  • Contacts
    • Who is the KAM (Key Account Mannager)?
    • Do you have any collaborator on the VTEX side?
    • Technical reference: Who carried out this integration process? (client, developer, software factory)
  • Environment.
    • Staging
    • Productions
  • Within your specifications, do you have any particular variations? example: (size, color, gender, sex, others).
    • What is the id?
  • Is there a specific field created for your store that is not the vtex standard?
  • Do you have an exclusive Sales Policy for us?
    • Are you considering adding one or would you use the generic one?

Setting up your VTEX store

User Credentials

Now we are going to fill the seller.csv file with your credentials from Seller Center and VTEX.

Fields:

  • vtex_seller_id: It is your Seller vtex Id.
  • name: It is your Seller Center account name.
  • identifier: It is the VTEX Store name.
  • store: It is the country code: CL, CO, MX or PE.
  • sellercenter_key: Your user at Seller Center (your email).
  • sellercenter_secret: Your API-KEY at Seller Center.
  • vtex_api_key: It is the VTEX API Key.
  • vtex_api_secret: It is the VTEX API Secret.
  • dock_id: It is the dock you as a seller have configurated for Linio. You can find it at the Logistics configuration: https://{store_name}.myvtex.com/admin/logistics/#/dashboard
  • has_automatic_guide: Indicate if you will work with automatic shipping guides provided by Linio Shipping Provides. 1 = Yes. 0 = No
  • trade_policy_id: It is the trade policy you as a seller have configurated for Linio.

Example:

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

To get VTEX credentials:

  1. Open a new tab in your browser.

  2. Login into your VTEX Store Admin:

https://{store_name}.myvtex.com/admin/
  1. In the sidebar, click on Account Management and then on Accounts.

  2. Click on your Account name.

  3. In the Security section, click on Generate appKey and appToken.

  4. Click on Generate new Tokens.

  5. The token is in the field that is shown next. For a matter of safety, it is shown only once. Copy this token and save it in a safe place.

  6. Copy your appKey and your appToken.

📘

Get more information about VTEX credentials in their tutorial

Categories mapping

🚧

Categories Mapping

  • Important: Category mapping must correspond to the lowest level in VTEX, that is, these categories must have no children categories.

To perform this action you have two options:

  1. Use Linio's categories on your VTEX Store: We will ask you which categories you want to use, and we will take care of creating the categories and the required attributes in your store. You will not believe how easy it is!

  2. Map your actual categories with Linio's categories: you will map your categories with Linio's ones, and we will take care of creating the required attributes in your store.

The mapping will only be done once for each category. Once you have done this, new products will be sync directly into the correct category.

Option 1: Use Linio's categories on your VTEX Store

Fill the file categories.csv using the information bellow

Fields:

  • id_seller_center: It is the category ID in Seller Center. You can find it in the file below, next to the name of each category.
  • id_vtex: Delete this column.

Example:

id_seller_center
45
345
789

🚧

IMPORTANT

This option is just recommended for the new VTEX stores. We will create the categories inside the category tree.

Get Linio's category IDs here:

Option 2: Map your actual categories with Linio's categories

Fill the file categories.csv using the information below.

Fill the Linio's categories using the files on the table above.

Fields:

  • id_seller_center: It is the category ID in Seller Center. You can find it in the file above, next to the name of each category.
  • id_vtex: It is the category ID in VTEX. You can find it next to the name of each category as you expand the categories tree in Catalog > Categories.

📘

TO TAKE IN CONSIDERATION

We can help you with this csv file pre-charging the VTEX category IDs. You need to ask us. You will need to remove parent categories and any category that has a child.

Example:

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

Brands mapping

Now we are going to match Brands from Seller Center with the correspondence on your VTEX store.

Download the brands.csv file and match brand identifiers.

Fields:

  • id_seller_center: It is the brand ID in Seller Center. We will explain how to get brands below.
  • id_vtex: It is the brand ID in VTEX. You can find it next to the name of each brand in the Brand section.

📘

TO TAKE IN CONSIDERATION

We can help you with this csv file pre-charging the VTEX and Seller Center (SC) brand IDs. You need to ask us. Our pre-charged template will automatically search the perfect marched brands between both systems but if there are some brand that does not match in SC you will need to complete manually.

Example:

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

📘

You can fill only the brands you will use.

Get the Seller Center's brands in this way:

  1. Go to Seller Center > Settings > Integration Management.

  2. On the API Explorer select the Action "GetBrands".

  3. Execute.

🚧

If you get the error: "E007: Login failed. Signature mismatch", do click on "Regenerate Signature" and execute again.

👍

Send us the information

Send your seller.csv, categories.csv and brands.csv to your KAM
We will load the information and let you know when the integration is ready to use.

If you will need our pre-charged template we will need only the seller.csv file and the mention of your needed templates.

📘

Custom branding

Please review the following suggestions

❗️

Please note that the use of the following copyrighted brands is prohibited:

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

If you are selling Apple and Xiaomi products, let us know beforehand.

Configuring affiliate

After our team lets you know your integration is ready, you will need to configure webhooks.

Will be used to establish communication from VTEX to LINIO.

To configure webhooks at VTEX please go to Orders > Order Management > Settings > Affiliates > New Affiliate and fill the fields as in the image below.

Configuring webhook

Will be used to establish communication from LINIO to VTEX.

On the other hand, to do the same at Linio.

  • Login to your Seller Center's account
  • Go to Integration
    • Menu > Settings > Integration Management > Webhooks and click Add webhook.
  • Make sure that your configuration seems like the image below.

The URL is:

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

📘

IMPORTANT

After the integration was validated, we will provide you the [INTEGRATION_IDENTIFIER] in order to configure the correct webhook and affiliate.

Products

Product Creation:

• Product must belong to a mapped category
• Product must belong to a mapped brand
• Active product
• Priced Product
• Product with stock greater than 5
• Product with full Linio specifications (validate Lin_Variation if applicable)
• Product with active Linio Sales policy
• Product with pictures
• Product with package measurements (weight expressed in grams)

Step 1: If it has variations select it in:

Products and SKU > Edit SKU> Specification:

Step 2: after having this configuration ready, go to edit the product:

Step 3: Complete as many fields as Linio's specification, remember that the required fields are indicated with ¨(required)¨:

Step 4: Active Linio Sales policy

Vtex: SKUs Products> Edit> Change

📘

Important

For the products to be visible in the Seller Center we need them to pass the quality control and have at least 75% approval as detailed in the image, these are the mandatory fields by categories and their requirements:

Once you are OK with these steps, I need the following data from the test products:

PRODUCTID, IDSKU, SKU, MODEL, SIZE, BRAND

Usage

After all the configuration is uploaded, you can create products on your VTEX store, and the integration will sync it correctly to the Seller Center. You can create products individually or import them.

📘

Important

You must complete all the required category fields for Linio so it can be synchronized to the seller center.

The content must be in Spanish.

If the product achieves a high quality content, the product will automatically become active in the Linio store.

To validate products were synced to Seller Center:

  1. Go to your Seller Center account. On the Products > Manage Products, you should see your product created.

  2. To validate if the images were uploaded, place the mouse over the Name.

  3. We recommend an additional validation into the feeds view. Go to Products > Import Products > Monitor Import Result. You must see here all in green, with a hand rising the thumb.

Here we have an important observation to do. The validation of the products will depend on many different factors. One of them is quality control that is an automatic validation at Linio, that decides if the product should be approved or rejected. For a short guide, please be in touch with this basic validation at Linio. The same is available at Seller Center:

📘

Here we have an important observation to do. The validation of the products will depend on many different factors. One of them is quality control that is an automatic validation at Linio, that decides if the product should be approved or rejected. For a short guide, please be in touch with this basic validation at Linio. The same is available at Seller Center:

Disable Products:

First, you have to do it from Vtex and then from Seller Center.

Vtex: SKUs Products> Edit> Change

Seller Center: Products> Manage Products>Turn it off

Product Updates

Once the products were created at VTEX and synced to Seller Center, they can be updated for different scenarios that happen in the daily operation.

Content and price updates:

You can update the content, stock and price. The system will validate whether or not the product was created before. In the scenario where a product created previously without using VTEX and it still active in Linio Seller Center you should delete this product at Linio and create it again in VTEX.

👍

End-to-end order testing

Once the product tests have been carried out, we can go to the order test with the help of your assigned KAM to place an order and see its complete flow.

Orders

Order dispatching

The order processing in Linio is different when you use your own shipment agreement or Linio's ones.

Available statuses for orders:

  • Pending: Is the default status for the new orders.

  • Canceled: Is an optional status for orders. You should know that a cancellation fee will be charged in some cases (Get more information at the end of the document).

  • Ready to Ship: Is the status to be dispatched. Important: The product should be packed in your warehouse and be ready to be picked up. After that, the status will change to "Shipped".

Scenario 1: Using your own shipment agreement.

  1. A new order is received at your Seller Center account.

  2. If the SKU sold at Linio exist into VTEX the order should be synced:

VTEX SKU = Seller Center SellerSku.

  1. Inside the order details you should see the Status dropdown:

  2. Select "Invoice Package".

  3. Fill the Shipping Provider and Tracking Number.

  4. Save button.

As you will see, it is not possible to change the status to "Shipped" or "Delivered". This happens because even if you want to use your own shipment agreement, you must use a valid shipment provider available at Linio. You cannot feed a carrier not valid for Linio.

Offering different shipping options allows customers to choose the shipping cost and delivery time that best suits them. Each shipping method may be suitable for different customer segments:

  • Postal: This is preferred by customers who opt for a low-cost or free shipping method and are willing to wait longer for the delivery of their products.

  • Express: This is preferred by customers willing to pay extra for quick delivery and may be more appropriate in certain circumstances (e.g. product bought as a gift, holiday season, etc).

Scenario 2: Using Linio's shipment providers agreement.

To process an order please follow the same steps as Scenario 1.

After you refresh the page, you will see the links to get documents on the order comments:

• Invoice: It is the receipt from Linio. Attach it into the package to be discovered by the customer once the package is delivered.

• ShippingParcel: Is the PDF generated by Seller Center. Print and paste it on the package in order to send the product to the customer.

Scenario 3: Cancellations:

  1. The cancellation follows the same 4 first steps from the Order dispatching, but instead of Invoice Package, the selection should be "Cancel order".

  2. Click on the Save button.

The order should be canceled at Seller Center and in VTEX. As a result, the product becomes OFF in the Linio Store.

More help

Your best ally

Your best ally who can guide you at all times and know exactly which team to lean on is your KAM (Key Account Mannager).

Seller Center

If you have any questions about the internal processes carried out by Seller Center, for example, orders, shipments, deactivation of products, Warranties, commissions among others, please do not hesitate to consult our documentation by click here.

Integrations FAQs

You can visit a section of frequently asked questions which is constantly evolving click here.

Discuss

It has a section available where you can raise your concerns or even find the answers to which you are presented, use the tags to quickly filter what you are looking for. click here.

Contact US

In case you have any specific problem with the integration, you can contact us by the following means. click here.