Menu
Feedback
Start here
Tutorials
Developer portal

Known Issues
Support Rules
Troubleshooting

Frequently Asked Questions
Announcements
Tutorials
Tutorials
Explore in-depth tutorials for operating your VTEX store.
Tutorials
Integrations
Integrations overview
How does the cart with multiple items work in Mercado Livre?
How does the cart with multiple items work in Mercado Livre?

Mercado Livre has made an update that allows the inclusion of more than one different item in the cart. The so-called multi-item cart brought a new logic for handling the identification of orders and products, which made it necessary to change the way VTEX works with these data.

How it works in Mercado Livre

With the new feature, Mercado Livre began to display only one ID for the order, regardless of the amount of products added in the cart. However, the back-end doesn't work with this data, assigning a different ID for each item, plus a unique ID for the shipping.

This means that the unique order identification code is only displayed on the end-user screen and is not part of the data that's shared with other systems (such as VTEX platform).

How it works in VTEX

Mercado Livre sends to VTEX the IDs processed in the back-end: both the delivery ID and the individual item IDs. Because the unique order ID is not sent to our platform, we had to make a change in our integration with Mercado Livre.

Instead of using the IDs of each item (which would generate separate orders in our system), we've changed the logic and started considering the delivery ID to identify the order as a whole. That way, the integration works with only the shipping code (shipment_Id), the only one provided by Mercado Livre that is shared by all products of the same order.

You can find both IDs through the report generated on the integration's panel on VTEX Admin.

{"base64":"  ","img":{"width":1324,"height":449,"type":"png","mime":"image/png","wUnits":"px","hUnits":"px","length":50504,"url":"https://raw.githubusercontent.com/vtexdocs/help-center-content/refs/heads/main/docs/en/tutorials/Integrations/Integrations%20overview/how-does-the-cart-with-multiple-items-work-in-mercado-livre_1.png"}}

This logic of operation applies to all types of delivery, except those that include pickup points. In such, the platform continues to use the old ID.

Contributors
2
Photo of the contributor
Photo of the contributor
+ 2 contributors
Was this helpful?
Yes
No
Suggest Edits (GitHub)
Contributors
2
Photo of the contributor
Photo of the contributor
+ 2 contributors
On this page
Still got questions?
Ask the community
Find solutions and share ideas in the VTEX community.
Join our community
Request support from VTEX
For personalized assistance, contact our experts.
Open a support ticket
GithubDeveloper portalCommunityFeedback