VTEX Sales Channel

Linio is available as a VTEX Sales Channel. Through this integration, you can join our marketplace in Argentina, 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.



If you are interested in using this integration, please let us know, sending an email to [email protected] We are always happy to help you.


Plugin Version





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.

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.


  • 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: AR, 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.



To get VTEX credentials:

  1. Open a new tab in your browser.

  2. Login into your VTEX Store 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

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


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



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.


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



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.


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




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 [email protected]
We will load the information and let you know when the integration is ready to use.

Configuring webhooks

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

Webhooks will be used to establish communication between Linio and VTEX.

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

The URL will be given by our team when everything it's OK.

On the other hand, to do the same at Linio, login to your Seller Center's account:

Go to Integration Management > Webhooks and click Add webhook.

Make sure that your configuration seems like the image below.

The URL is:



Product Creation:

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

You must complete all the required category fields for Linio so it can be synchronized to 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 the 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:

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.

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.

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.

Order cancelation process and main doubts:

Orders may be canceled by the seller, the customer or Linio:
When the promised delivery time has ended, the customer has not received the package, and no Proof of Delivery has been issued, including attempts to deliver the product.
Before the seller has initiated the shipping process, within Delivery Time Supplier (DTS), and before the order has been marked as ‘Ready to Ship’ on Seller Center.
Within 14 natural days after delivery under the Linio Satisfaction Guarantee (processed as returns).
Before canceling an order please timely notify your Account Manager.

  1. Linio can cancel an order?
    Linio’s Operations team may cancel an order in the following circumstances:
    After the DTS has ended and the shipment status is ‘Ready to Ship’ on Seller Center but has no activity for 24 hours. The order could be canceled by the Operations team if there is no satisfactory reply from the seller within 24 hours during business days.

  2. About the express shipments:
    Within 14 natural days after delivery under the Linio Satisfaction Guarantee (processed as returns).
    After the DTS has ended and the shipment status is ‘Ready to Ship’ on Seller Center but has no activity for 48 hours. The order could be canceled by the Operations team if there is no satisfactory reply from the seller within 48 hours business days.
    If an order was purchased as an Express shipment but was shipped with a Postal Service. The seller will have less than 24 hours business days to provide a satisfactory reply.

  3. Cancellation penalties:
    Sellers will not receive payments for products canceled by the seller, the customer, or Linio prior to delivery. For products canceled after the shipping period, commission-based penalties apply:
    If the order is canceled by the seller:

  • Within DTS, before shipping: 0.5 x Commission
  • Extended DTS: 1 x Commission
  • Shipping Period Expired, after shipping: 1.5 x Commission
  • If the order is canceled by Linio or the customer:
  • Shipping Period Expired, after shipping: 1.5 x Commission
  1. Does Linio offer a guarantee?
    International products are eligible for the Linio Satisfaction Guarantee. Under the guarantee, customers are not charged for returns, exchanges, and replacements within the guarantee period. The guarantee period begins once the product is delivered and lasts 14 natural days in all countries. Products that are eligible for LinioPlus, Linio’s free-shipping customer loyalty program, are eligible for a return period of 30 natural days.

  2. What if I offer a guarantee for my products?
    Additionally of the Linio Satisfaction Guarantee, you may offer a guarantee issued by you, the product brand or the manufacturer. In case you offer a guarantee, ensure you add the following details on the ‘Product Warranty’ column of the product creation template:

  • The time period the warranty is valid
  • The pieces of the product eligible for the warranty
  • Who is responsible for the costs of inverse logistics and return to the customer?
  • The circumstances in which the guarantee does not apply.
  • If you do not offer a warranty write “Solo Garantía de Satisfacción Linio is ESP”.
  1. How do I receive an item returned by the customer?
    It is highly recommended that you count with an inverse logistics solution to handle customer returns. Returned products are temporarily stored in Linio’s local warehouse (currently available in Mexico, Colombia, Chile and Peru). It is the seller’s responsibility to find an inverse logistics solution to ship the product back to the origin.