Validations

Our goal is to improve the quality of our sellers' listings. For this reason we provide a flow that validates consistencies within the listing before its creation and, on certain occasions, requests corrective actions from the seller to meet the expected requirements.
Example of a response with validations after executing the request to create a listing:

{
   "message": "Validation error",
   "error": "validation_error",
   "status": 400,
   "cause": [
       {
           "department": "structured-data",
           "cause_id": 2511,
           "type": "warning",
           "code": "create.item.attribute.business_conditional",
           "references": [
               "item.attributes"
           ],
           "message": "Attribute [AGE_GROUP] to be added with values [(6725189,null)]"
       },
       {
           "department": "moderations",
           "cause_id": 3250,
           "type": "error",
           "code": "moderations.seller.not_authorized",
           "references": [
               "item.seller_id",
               "item.category_id",
               "item.attributes[0]"
           ],
           "message": "Seller is not authorized for this brand and category"
       },
       {
           "department": "structured-data",
           "cause_id": 1212,
           "type": "warning",
           "code": "normalize.item.attribute.values",
           "references": [
               "item.variations[0].attribute_combinations[1].values"
           ],
           "message": "Attribute [SIZE] to be modified - values [(null,32.5 BR)] should be [(11375386,32.5 BR)] - Normalized form: [migration]"
       },
       {
           "department": "shipping",
           "cause_id": 4029,
           "type": "warning",
           "code": "shipping.me2_adoption_mandatory",
           "references": [
               "shipping.modes",
               "user.shipping_preferences.option"
           ],
           "message": "ME2 adoption is mandatory for the user"
       }

Fields description

• message: message indicating that it was generated by quality validation.
• error: error code.
• status: http code to identify an error.
• cause: array that contains the detail of the validations executed and that may require action by the seller to resolve them.

• department: name of Mercado Libre's area that is the owner of the validation.
• cause_id: validation ID.
• type: validation type with two possible values: warning (non-blocking validation for the execution of the request, informative) or error (blocking validation for the execution of the request that requires an action from the seller that modifies the JSON).
• code: validation code.
• references: references to JSON features that caused the validation.
• message: message that details the validation caused.

Detail

You will find below the details of the validations that help to improve the quality of the publications, where the first four columns refer to the cause_id, type, code and message fields of the response, respectively: