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:
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.
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.
Now we are going to fill the seller.csv file with your credentials from Seller Center and VTEX.
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:
Open a new tab in your browser.
Login into your VTEX Store Admin:
In the sidebar, click on Account Management and then on Accounts.
Click on your Account name.
In the Security section, click on Generate appKey and appToken.
Click on Generate new Tokens.
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.
appKey and your
Get more information about VTEX credentials in their tutorial
To perform this action you have two options:
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!
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.
Fill the file categories.csv using the information bellow
id_seller_center 45 345 789
Get Linio's category IDs here:
Fill the file categories.csv using the information below.
Fill the Linio's categories using the files on the table above.
id_seller_center,id_vtex 45,567 4,5456 789,234
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,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:
Go to Seller Center > Settings > Integration Management.
On the API Explorer select the Action "GetBrands".
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.
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:
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:
Go to your Seller Center account. On the Products > Manage Products, you should see your product created.
To validate if the images were uploaded, place the mouse over the Name.
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:
If you are selling Apple and Xiaomi products, let us know beforehand.
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.
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.
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".
A new order is received at your Seller Center account.
If the SKU sold at Linio exist into VTEX the order should be synced:
VTEX SKU = Seller Center SellerSku.
Inside the order details you should see the Status dropdown:
Select "Invoice Package".
Fill the Shipping Provider and Tracking Number.
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).
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.
The cancellation follows the same 4 first steps from the Order dispatching, but instead of Invoice Package, the selection should be "Cancel order".
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.
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.
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.
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.
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:
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.
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: