Documentation Mercado Libre

Check out all the necessary information about APIs Mercado Libre.
circulos azuis em degrade

Documentation

Last update 05/05/2026
FAQs › Items — Shipping attributes and dimensions

Items — Shipping attributes and dimensions


What attributes should I send for the API to accept package dimensions and weight (seller_package_*) and in what units?

Dimensions must be sent as numeric values with units: height/width/length in centimeters and weight in grams (integer). In shipping.dimensions the format AxBxC, weight is typically used, with dimensions in cm and weight in grams. The API validates limits and formats; on some sites sending weight in whole grams avoids errors caused by fractions.

Recommendation
Normalize units in your integration (cm and g), convert fractions to integers when necessary, and validate against API limits before sending.
Why do I get the "seller_package dimensions are too small / invalid" error when sending very small real dimensions (e.g. eyeliners)?

The system validates the realism of dimensions and may reject extremely small measurements; the validation expects packaging dimensions (box or envelope) and not raw product dimensions if the category requires minimums.

Recommendation
Send the dimensions of the actual packaging used (box or envelope) and adjust to category minimums when necessary.
When updating an item with ME2, warnings appear and dimensions don't change. Why?

For ME2/fulfillment logistics, certain dimensions are managed by the logistics operation and cannot always be modified via API; the platform may impose values or consider some measurements as read-only until physical entry into the warehouse.

Recommendation
If the item is in fulfillment mode, consider that some dimensions will be managed by logistics and plan updates coordinated with the operational flow.