Documentation Mercado Libre

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

Documentation

Last update 25/04/2023

Validations

Our goal is to improve the experience on the site. For this reason, we have made available the size chart, where sellers of fashion can give more details of the measurements of their products to buyers. This way, the seller can decrease the number of questions, returns due to size problems, and increase sales. Review the documentation to see how to validate a size chart.

Summary recommendations for fashion listings

  • Complete the technical sheet for the item.
  • Review genders by country using the /catalog_domains/$DOMAIN_ID/attributes/GENDER resource so that your listings reference genders are recognized by the Mercado Libre.
  • Upload all the required attributes, as well as variations in your listings.
  • Identify if any quality requirements are not complied and take the necessary actions.
  • Confirm if the domain has attributes configured for the size chart. When you find an attribute of type GRID_ID and GRID_ROW_ID you will recognize that for this domain the size chart is required, and will not allow you to create or modify it without having the size chart loaded correctly.

Validations and error messages

The requirement of the size chart is meant to validate if the information in the listing is consistent by using error messages, which we detail below.


In the validations of the requirement of a size chart for Live Listing, are not considered adjustments such as:
- Stock and price changes in the listing
- Paused or closed status changes in the listing
This means that, the error will not appear at the moment you make a PUT to the /items/ resource.


1. The SIZE_GRID_ID attribute does not exist in the listing:

{
    "code": "missing.fashion_grid.grid_id.values",
    "message": "Attribute [SIZE_GRID_ID] is missing",
    "type": "ERROR",
    "cause_id": 2610,
    "references": [
        "item.attributes"
    ],
    "department": "structured-data",
    "validation": "fashion-validator",
    "custom_data": {}
}

2. For the listing where there is the SIZE_GRID_ID attribute, but there is no attribute that specifies the row SIZE_GRID_ROW_ID:

{
    "code": "missing.fashion_grid.grid_row_id.values",
    "message": "Attribute [SIZE_GRID_ROW_ID] is missing",
    "type": "ERROR",
    "cause_id": 2611,
    "references": [
        "item.attributes"
    ],
    "department": "structured-data",
    "validation": "fashion-validator",
    "custom_data": {}
}

3. For the listing and/or its variations the attribute SIZE is not specified:

{
    "code": "missing.fashion_grid.size.values",
    "message": "Attribute [SIZE] is missing",
    "type": "ERROR",
    "cause_id": 2612,
    "references": [
        "item.attributes"
    ],
    "department": "structured-data",
    "validation": "fashion-validator",
    "custom_data": {}
}

4. The listing with the SIZE_GRID_ID attribute specification, but the table code sent is invalid, for example when the listing associates a size chart of another category:

{
    "code": "invalid.fashion_grid.grid_id.values",
    "message": "Attribute [SIZE_GRID_ID] is not valid",
    "type": "ERROR",
    "cause_id": 2613,
    "references": [
        "item.name"
    ],
    "department": "structured-data",
    "validation": "fashion-validator",
    "custom_data": {}
}

5. The listing has the attribute specification SIZE_GRID_ID and SIZE_GRID_ROW_ID but the id sent in row is invalid, it does not exist in the table specified in grid_id:

{
    "code": "invalid.fashion_grid.grid_row_id.values",
    "message": "Attribute [SIZE_GRID_ROW_ID] is not valid",
    "type": "ERROR",
    "cause_id": 2614,
    "references": [
        "item.name"
    ],
    "department": "structured-data",
    "validation": "fashion-validator",
    "custom_data": {}
}

6. The size attribute of the listing or variation must consistently match the row in the table you are selecting; they must be identical if the SIZE of the listing or variation is invalid in this comparison:

{
    "code": "invalid.fashion_grid.size.values",
    "message": "Attribute [SIZE] is not valid",
    "type": "WARNING",
    "cause_id": 2615,
    "references": [
        "item.name"
    ],
    "department": "structured-data",
    "validation": "fashion-validator",
    "custom_data": {}
}

7. The attributes detailed in the table must correspond consistently with the information in the listing, for example, the GENDER attribute in the table must be the same as the one in the listing:

{
    "code": "invalid.fashion_grid.size.values",
    "message": "Attribute [GENDER] is not valid",
    "type": "WARNING",
    "cause_id": 2616,
    "references": [
        "item.name"
    ],
    "department": "structured-data",
    "validation": "fashion-validator",
    "custom_data": {}
}