Recursos Cross

Confira os principais recursos das nossas APIs
circulos azuis em degrade

Documentação do

Você pode usar esta documentação para as seguintes unidades de negócio:

Última atualização em 28/08/2024

Validações

Nosso objetivo é aumentar a qualidade das publicações de nossos vendedores. Por este motivo disponibilizamos um fluxo que valida consistências dentro da publicação antes de sua criação e em certas ocasiões, solicita ações de correção por parte do vendedor, para cumprir os requisitos esperados.
Exemplo de resposta com validações após executar a chamada para a criação de uma publicação:



{
   "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"
       }

Descrição dos campos

  • message: mensagem que indica que foi gerada pela validação de qualidade.
  • error: código de erro.
  • status: código http para identificar erro.
  • cause: array que contém o detalhe das validações executadas e que possivelmente requer uma ação do vendedor para solucioná-las.
    • department: nome da área do Mercado Livre owner da validação.
    • cause_id: ID da validação.
    • type: tipo de validação com dois possíveis valores warning (validação não bloqueante para a execução da chamada, informativa) ou erro (validação bloqueante para a execução da chamada que requer uma ação do vendedor que modifique o JSON).
    • code: código da validação.
    • references: referências aos atributos do JSON que causaram a validação.
    • message: mensagem que detalha a validação causada.

Detalhe

A seguir, você irá encontrar o detalhe das validações que ajudam a melhorar a qualidade das publicações, onde as quatro primeiras colunas referem-se aos campos cause_id, type, code e message da resposta, respectivamente:

Id Tipo Código de validação Mensagem Descrição Possível solução
101 error body.invalid_field_types linvalid property type: [$FIELD_ID] expected URL-Friendly String but was String value: $VALUE. O campo $FIELD_ID tem valores inválidos $VALUE. Para os valores disponíveis dos campos, consulte /categories/$CATEGORY_ID/$TYPE_ID.
109 error item.price.invalid The category $CATEGORY_ID requires a minimum price of $VALUE. O preço está abaixo do permitido para esta categoria. Consulte o campo minimum_price em /categories/$CATEGORY_ID.
126 error item.category_id.invalid Is not allowed to post in category $CATEGORY_ID. Make sure you're posting in a leaf category". "listing_allowed": false não permite publicar nesta categoria. Consulte o campo listing_allowed em /categories/$CATEGORY_ID.
129 error item.price.invalid Price must be less than 9999999999. O preço supera o máximo permitido. Corrigir o campo price com um valor válido.
147 error item.attributes.missing_required The attributes [$ATTRIBUTE_ID] are required for category $CATEGORY_ID and channel marketplace. Check the attribute is present in the attributes list or in all variation's attributes_combination or attributes. O atributo $ATTRIBUTE_ID é obrigatário para esta categoria $CATEGORY_ID. Para ver os atributos obrigatórios na categoria, consulte /categories/$CATEGORY_ID/attributes reconociendo "tags": { "required": true }.
154 error item.attributes.invalid_length Invalid value length for attribute $ATTRIBUTE_ID. Maximum length is 255. A longitude máxima para o atributo $ATTRIBUTE_ID foi superada. Para ver os atributos consulte /categories/$CATEGORY_ID/attributes campo value_max_length.
173 error item.listing_type_id.requiresPictures Item pictures are mandatory for listing type gold_special. As imagens são obrigatórias. Associar imagens na publicação.
201 error item.pictures.max Items in category $CATEGORY_ID cannot exceeds $NUMBER pictures. As imagens excedem a quantidade máxima permitida. Consulte o límite permitido de imagens em /categories/$CATEGORY_ID campos max_pictures_per_item e max_pictures_per_item_var.
204 error item.pictures.picture_not_found Picture id $PICTURE_ID does not exist. A imagem não existe. Adicione uma imagem válida.
369 error body.required_fields The variations[$VARIATION_NUMBER] does not contains some or none of the following properties [attribute_combinations, $ATTRIBUTE_ID]. O atributo $ATTRIBUTE_ID é obrigatório para o array de attribute_combinations na variação. Para ver os atributos obrigatórios na categoria, consulte /categories/$CATEGORY_ID/attributes identificando "tags": { "required": true }.
372 error tem.attributes.non_existent.limit_exceded The attribute_combinations not existing in category $CATEGORY_ID in the variation $VARIATION_ID exceed the allowed amount, only 1 of this kind is allowed. Algum dos atributos especificados no array de attribute_combinations não existe ou está repetido. Verifique o array attribute_combinations.
382 warning item.category_id.migrated Category id migrated to: $CATEGORY_ID. O id de categoria informado foi migrado a $CATEGORY-ID. Não aplica, o campo é automático.
394 error item.attribute.values.name.invalid Attribute $ATTRIBUTE_ID has a values entry with name too long ($CHARACTERS_NUMBER). Maximum name size allowed is 255. A longitude máxima para o atributo $ATTRIBUTE_ID foi superada. Para ver os atributos consulte a /categories/$CATEGORY_ID/attributes campo value_max_length.
465 warning item.video_id.dropped Item video id was dropped. Desativamos a opção de incluir vídeos do YouTube nas publicações do Mshops e Marketplace. Utilize Clips.
1212 warning normalize.item.attribute.values Attribute [$ATTRIBUTE] to be modified - values [($VALUE_ID,$VALUE_NAME)] should be [($VALUE_ID,$VALUE_NAME)] - Normalized form: [migration]. O atributo não conta com o value_id ou value_name especificados na chamada, completamos automaticamente o campo que falta. Não aplica.
2511 warning create.item.attribute.business_conditional Attribute $ATTRIBUTE to be added with values [($VALUE_ID,$VALUE_NAME)]". O atributo não está especificado na chamada, adicionamos automaticamente. Não aplica.
3250 warning moderations.seller.not_authorized Seller is not authorized for this brand and category. É uma marca que deve ser validada, ou seja, demostrar que se adquirem los produtos através de distribuidores ou retailers autorizados pela marca no país. Entre no Mercado Livre na seção de Vendas > Preferências de vendas > Validações, selecione “Validar marca”, entre na marca e valide, depois anexe as faturas de compra .
4029 warning shipping.me2_adoption_mandatory ME2 adoption is mandatory for the user. O tipo de envio ME2 é obrigatário para o usuário, completamos a informação automaticamente. Não aplica.
7710 error item.attribute.product_identifier.invalid Product Identifier [GTIN] has invalid values: [$VALUE]. O identificador de produtos contém caracteres inválidos. Adicione um identificador de produto válido.
7711 error item.attribute.product_identifier.invalid_format Product Identifier [GTIN] contains values with invalid format: [$VALUE]. O identificador do produto beste caso GTIN tem formato incorreto. Adicione um identificador de produto válido.
7712 error item.attribute.product_identifier.invalid
_by_domain_catalog
Product Identifier [GTIN] with values [$VALUE] corresponds to category [$CATEGORY_ID]. O identificador de produto enviado corresponde a um produto de outra categoria $CATEGORY_ID dentro do mesmo domínio onde está publicando. Adicione um identificador de produto válido para a categoria que está publicando.
7714 error The {$UNIVERSAL_CODE_FIELD} universal code has an incorrect format. Ao menos um atributo do tipo (GTIN, EAN, UPC, JAN, GTIN14, ISBN, ISBN10, ISBN13) é inválido. Pode validar os códigos, usando este recurso /product-identifier/validator?product_identifier=$UNIVERSAL_CODE_FIELD.
7810 error item.attribute.missing_conditional_required The attributes [$ATTRIBUTE_ID] are required for category [$CATEGORY_ID]. Check the attribute is present in the attributes list or in all variation's attributes_combination or attributes. O GTIN é um atributo obrigatário para a categoria $CATEGORY_ID. Para ver os atributos obrigatórios na categoria, consulte /categories/$CATEGORY_ID/attributes identificando "conditional_required": true
3701 error item.attribute.invalid_product_identifier Enter a universal code that you have not used in another brand listing/category listing. O GTIN foi utilizado para outras publicações de outra marca ou domínio. Corrija o campo GTIN ou código universal.
3702 error item.attribute.invalid_sanitary_registry_value The value you entered in {$ATTRIBUTE_ID} is incorrect. An example is: {$VALUE}. Possuí erros de formato em dados de registro sanitário. Corrija o atributo $ATTRIBUTE_ID com um valor válido.
3703 error item.pictures.invalid_size The photos must have a minimum size of 500 pixels on at least one side. As fotos devem ter um tamanho máximo de 500 pixels em ao menos um dos lados. Carregar fotos que cumprem com o estândar mínimo de 500 pixels.
3704 error item.attribute.missing_catalog_required The {$FIELD_ID} field is mandatory and was not added. Falta completar algum dos atributos de tipo catalog_required ou catalog_child_required. Para ver os atributos obrigatórios na categoria, consulte /categories/$CATEGORY_ID/attributes identificando "catalog_required": true ou “catalog_child_required”: true
3705 error item.title.minimum_length You should include more main features in the title to differentiate it from other products. O título deve incluir mais detalhe sobre o produto ofertado. Corrigir o campo título da publicação.
3706 error item.pictures.unavailable An error occurred while processing the photo. Please upload it again. Durante o processo de carregamento de imagem principal houve uma falha ou ficou inacessível. Tete carregar a publicação, se o erro persistir modifique a imagem.
3707 error item.descriptions.length_exceeded You exceeded the {$VALUE} character limit. Shorten the description. A descrição não deve superar $VALUE caracteres Corrigir a descrição para não superar a regra de quantidade máxima de caracteres permitidos.
3708 error item.attribute.number_invalid_format The value you entered in {$FIELD_ID} is incorrect. An example is: {$VALUE}. O valor informado no campo $FIELD_ID é incorreto. Corrigir valores errado que tem um formato incorreto nos atributos numéricos.
3709 error item.attribute.invalid_sale_units You added {$VALUE_1} in the {$FIELD_ID_1} field, but you have not filled out the {$FIELD_ID_2} field.
You added {$VALUE_1} in the {$FIELD_ID_1} field and, in this case, the {$FIELD_ID_2} field should not be {$VALUE_2}.
If in the {ase, the {$FIELD_ID} option, you chose {$VALUE_1}, in this field you must fill in {ase, the {$VALUE_2}.
Você carregou {0} no campo{1} mas não completou o campo {2}.
Você carregou {0} no campo {1} e, neste campo, o campo {2} não deve ser {3}.
Se em {0} escolheu {1}, neste campo deve completar {2}.
Corrigir os atributos SALE_FORMAT e UNITS_PER_PACK. Seguindo as seguintes condições: Se está carregando UNITS_PER_PACK, deve estar carregado SALE_FORMAT.
Se SALE_FORMAT tem valor Unidad, então UNITS_PER_PACK (se está carregado) deve ser 1.
Se SALE_FORMAT tem valor Pack, então UNITS_PER_PACK deve ser maio que 1.
Se SALE_FORMAT tem valor Peso, então NET_WEIGHT deve estar carregado.
3710 error item.attribute.invalid_voltage It is not allowed to sell products of this voltage in Argentina. Aplica para Argentina, tem uma voltagem entre 100 e 199 Volts e sua venda não é permitida. Não aplica.
3711 error item.attribute.gtin_invalid_domain The {$GTIN} universal code corresponds to the {$CATEGORY_ID} category. Se valida que o GTIN não está em outro produto correspondente a outro domínio ao qual está publicando. Adicionar um identificador de produto válido para a categoria que está publicando.
3712 error item.attribute.gtin_invalid_brand The {$GTIN} universal code corresponds to the {$BRAND} brand. O código universal informado corresponde a outra marca $BRAND diferente a que informou para sua publicação. Adicionar um identificador de produto válido para a categoria que está publicando.
4210 error invalid.title.gender Please make sure you enter a gender that matches the title of your listing. O título da publicação refere-se a um gênero diferente do indicado no atributo GENDER. O título deve ser corrigido para se referir ao mesmo gênero, tal como indicado na ficha técnica da publicação.
3416 warning item.attribute.anatel_homologation_number.invalid Declaro que este produto é homologado pela ANATEL e assumo responsabilidade legal caso não esteja em conformidade com a regulamentação. O código ANATEL informado é inválido. Deverá subir um código ANATEL válido em conformidade com a regulamentação.
3417 warning item.attribute.ean.invalid Declaro que este produto é homologado pela ANATEL e assumo responsabilidade legal caso não esteja em conformidade com a regulamentação. O código GTIN/EAN informado é inválido. Deverá subir um código GTIN/EAN válido em conformidade com a regulamentação.
3418 warning item.attribute.anatel_homologation_number.missing Declaro que este produto é homologado pela ANATEL e assumo responsabilidade legal caso não esteja em conformidade com a regulamentação. O código ANATEL não foi informado. Deverá informar um código ANATEL válido em conformidade com a regulamentação.
3419 warning item.attribute.ean.missing Declaro que este produto é homologado pela ANATEL e assumo responsabilidade legal caso não esteja em conformidade com a regulamentação. O código GTIN/EAN não foi informado. Deverá informar um código GTIN/EAN válido em conformidade com a regulamentação.