VTEX to Mercado Libre Catalog & Feed Synchronizer
Mercado Libre rejects listings that miss category-required attributes or combine variations incorrectly. IRONFEED validates the VTEX catalog against those rules before anything is published.
Validate the ficha técnica, fill required technical attributes and publish country-specific pricing from a single VTEX catalog.
Why the default VTEX sync breaks
Incomplete ficha técnica
Each Mercado Libre category demands its own technical attributes. Missing brand, model or color blocks publication or buries the listing.
Invalid variation combinations
VTEX SKU structures do not always translate into valid Mercado Libre variation sets, and the API rejects the whole item group.
Currency and price rules per country
One VTEX account serving several countries needs distinct currencies, price tables and shipping assumptions per marketplace site.
Live in three steps
Connect your store
Authorize IRONFEED through the platform app or a scoped API key. The catalog is read directly, with no export files to maintain.
Set transformation rules
Map fields, build titles, normalize images and prices, and define custom label and exclusion rules once. They run on every sync.
Publish the live feed URL
Register the IRONFEED URL in the destination channel. Every refresh delivers a validated catalog with no manual re-upload.
VTEX → Mercado Libre attribute mapping
| VTEX field | Mercado Libre attribute | IRONFEED automated handling |
|---|---|---|
| sku.id | seller_custom_field | Stable seller SKU reference for reconciliation |
| brand.name | BRAND | Required attribute with normalized brand values |
| specification.Model / Color | MODEL, COLOR | Ficha técnica completion from specification groups |
| categoryTree | category_id | Category predictor with required-attribute checks |
| commertialOffer.Price | price, currency_id | Per-country price table and currency selection |
Mercado Libre errors this integration prevents
Faltan atributos obligatorios de ficha técnica
Mandatory attributes are category-specific and identified by codes such as BRAND and MODEL. Store catalogs keep the same information in free-text fields or in the title, so no value maps to the expected attribute code.
View fix & ruleCombinación de variantes no válida para la categoría
Store catalogs allow arbitrary option names such as material, flavour or pack size. Mercado Libre rejects axes its category does not define, and it also rejects two variants that resolve to the same combination.
View fix & ruleMoneda no coincide con el site local de Mercado Libre
Regional sellers keep one base currency internally and expect conversion at publish time. The integration passes the base amount through, and locale formatting adds separators the API does not accept.
View fix & ruleVTEX to Mercado Libre FAQs
See what your VTEX feed looks like to Mercado Libre
Run the free audit and get the failing checks, product counts and the exact rule that fixes each one.