Validação da tabela de medidas

Recomendações para publicações de moda

• Preencher a ficha técnica das publicações.
• Verificar os gêneros por país utilizando o recurso /catalog_domains/$DOMAIN_ID/attributes/GENDER para que as publicações se refiram aos gêneros reconhecidos pelo Mercado Livre.
• Carregar todos los atributos obrigatórios, como as variações das publicações.
• Identificar se não cumpre algum requisito de qualidade e tomar as medidas pertinentes.
• Confirmar se o domínio tem atributos configurados para a utilização de tabela de medidas.
• Para domínios aplicáveis, utilizar pelo menos os campos de gênero e marca para encontrar uma tabela de medidas adequada para associar à sua publicação.
• Especifica atributos do tipo GRID_ID e GRID_ROW_ID conforme seja apropriado, ao criar ou modificar a publicação.

Validações ao criar uma tabela de medidas

Para manter as tabelas de medidas com informações de qualidade, criamos validações que mediante mensagens de erro nos informarão as ações que o vendedor deve tomar antes de criar uma tabela de medidas, as quais detalhamos a seguir:

1. O valor {VALUE_NAME} que foi especificado para o atributo gênero não é um valor válido na ficha técnica do domínio.

{
"error": "chart_tech_specs_not_found",
"message": "Chart technical specification not found for SITE:{SITE_ID}-DOMAIN:{DOMAIN_ID}-GENDER:{VALUE_NAME}",
"status": 404
}

2. Não foi especificado um atributo principal ou main_attribute.

{
"error": "main_attribute_missing_error",
"message": "Main attribute for site {SITE_ID} is missing.",
"status": 400
}

3. O atributo {ATTRIBUTE_ID} escolhido como main_attribute ou principal não é um atributo válido, você deve consultar a ficha técnica da tabela de medidas que informará de possíveis atributos candidatos.

{
"code": "invalid_main_attribute_id",
"message": "Chart main attribute with ID {ATTRIBUTE_ID} is invalid."
}

4. Existem atributos requeridos {ATTRIBUTE_ID} na ficha técnica da tabela de medidas que não foram especificados. A mensagem adiciona informação detalhada da fila ou row {ROW_MAIN_ATTRIBUTE_VALUE_NAME} de onde falta informação.

{
    "code": "required_row_attribute_not_found",
    "message": "Required attribute {ATTRIBUTE_ID} was not found in row {MAIN_ATTRIBUTE_ID} {ROW_MAIN_ATTRIBUTE_VALUE_NAME}.",
    "cell": {
        "attribute_id": "{ATTRIBUTE_ID}",
        "row": {
            "id": null,
            "main_attribute": {
                "id": "{MAIN_ATTRIBUTE_ID}",
                "value": "{ROW_MAIN_ATTRIBUTE_VALUE_NAME}"
            }
        }
    }
}

5. O valor {VALUE_NAME} informado no atributo {ATTRIBUTE_ID} não é válido, você deve consultar a ficha técnica da tabela de medidas para obter a lista de valores que pode usar. A mensagem adiciona informação detalhada da fila ou row {ROW_MAIN_ATTRIBUTE_VALUE_NAME} que apresenta o erro.

{
    "code": "invalid_row_attribute_value",
    "message": "Attribute {ATTRIBUTE_ID} in row {MAIN_ATTRIBUTE_ID} {VALUE_NAME} has an invalid value.",
    "cell": {
        "attribute_id": "{ATTRIBUTE_ID}",
        "row": {
            "id": null,
            "main_attribute": {
                "id": "{MAIN_ATTRIBUTE_ID}",
                "value": "{ROW_MAIN_ATTRIBUTE_VALUE_NAME}"
            }
        }
    }
}

6. O valor {VALUE_NAME} do atributo {ATTRIBUTE_ID}, está fora do intervalo permitido, são adicionadas informações do intervalo A mensagem adiciona informação detalhada da fila ou row {ROW_MAIN_ATTRIBUTE_VALUE_NAME} que apresenta o erro.

{
    "code": "value_out_of_range",
    "message": "The value {VALUE_NAME} of the {ATTRIBUTE_ID} attribute of the row main attribute {MAIN_ATTRIBUTE_ID} {ROW_MAIN_ATTRIBUTE_VALUE_NAME} is out of range. The value must be within the range: {MINIMUM_RANGE} - {MAXIMUM_RANGE}",
    "cell": {
        "attribute_id": "{ATTRIBUTE_ID}",
        "row": {
            "id": null,
            "main_attribute": {
                "id": "{MAIN_ATTRIBUTE_ID}",
                "value": "{ROW_MAIN_ATTRIBUTE_VALUE_NAME}"
            }
        }
    }
}

7. O valor {VALUE_NAME} do atributo principal é incorreto já que está fazendo uso de palavras como gênero, cores, etc. Deve conter apenas palavras que tenham relação com o tamanho. A mensagem adiciona informação detalhada da fila ou row {ROW_MAIN_ATTRIBUTE_VALUE_NAME} que apresenta o erro.

{
    "code": "invalid_attribute_value",
    "message": "The value {VALUE_NAME} of the attribute {ATTRIBUTE_ID}   is incorrect. The value must contain only words related to SIZE",
    "cell": {
        "attribute_id": "{ATTRIBUTE_ID}",
        "row": {
            "id": null,
            "main_attribute": {
                "id": "{MAIN_ATTRIBUTE_ID}",
                "value": "{ROW_MAIN_ATTRIBUTE_VALUE_NAME}"
            }
        }
    }
}

8. O valor do atributo {ATTRIBUTE_ID} é igual ao especificado na linha {ROW_MAIN_ATTRIBUTE_VALUE_NAME}; não é permitido especificar valores duplicados numa guia de tamanho.

{
    "code": "duplicated_measure_value",
    "message": "Duplicated measure in attribute {ATTRIBUTE_ID} was found in row {MAIN_ATTRIBUTE_ID} {ROW_MAIN_ATTRIBUTE_VALUE_NAME} .",
    "cell": {
        "attribute_id": "{ATTRIBUTE_ID}",
        "row": {
            "id": null,
            "main_attribute": {
                "id": "{MAIN_ATTRIBUTE_ID}",
                "value": "{ROW_MAIN_ATTRIBUTE_VALUE_NAME}"
            }
        }
    }
}

9. Os valores do campo FILTRABLE_SIZE para a mesma tabela de medidas, são numéricos ou alfanuméricos, não sendo permitida qualquer combinação de tipos de dados no atributo.

{
    "code": "value_is_not_the_same_type",
    "message": "All FILTRABLE_SIZE values must be the same type, only numbers or alphanumeric",
    "cell": {
        "attribute_id": "FILTRABLE_SIZE",
        "row": {
            "id": null,
            "main_attribute": {
                "id": "{MAIN_ATTRIBUTE_ID}",
                "value": "{ROW_MAIN_ATTRIBUTE_VALUE_NAME}"
            }
        }
    }
}

10. O atributo {ATTRIBUTE_ID} não deve estar na tabela de medidas, este erro acontece porque foi informado um atributo do tipo BODY_MEASURE, CLOTHING_MEASURE ou MIXED_MEASURE, e a tabela de medidas tem configurado um tipo de medida diferente a do atributo. As tabelas podem ter apenas um tipo de medida.

{
   "code": "invalid_row_attribute",
   "message": "Attribute {ATTRIBUTE_ID} found in row {MAIN_ATTRIBUTE_ID} {ROW_MAIN_ATTRIBUTE_VALUE_NAME} is not valid and should not be present in the chart rows.",
   "cell": {
       "attribute_id": "{ATTRIBUTE_ID}",
       "row": {
           "id": null,
           "main_attribute": {
               "id": "{MAIN_ATTRIBUTE_ID}",
               "value": "{ROW_MAIN_ATTRIBUTE_VALUE_NAME}"
           }
       }
   }
}

Validações ao associar uma tabela a uma publicação

Para alguns domínios da vertical Fashion é obrigatório associar uma tabela de medidas à publicaçãos para isso validamos que a informação da publicação é consistente mediante mensagens de erro que buscam uma ação corretiva por parte do vendedor, as quais detalhamos a seguir.

1. O atributo SIZE_GRID_ID não existe na publicação:

{
    "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. Para a publicação existe o atributo SIZE_GRID_ID, mas não existe o atributo que especifica o 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. Para a publicação e/ou suas variações não se específica o atributo SIZE:

{
    "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. A publicação com a especificação do atributo SIZE_GRID_ID, mas o código de tabela enviado é inválido, por exemplo, quando a publicação se associa a uma tabela de medidas de outra categoria:

{
    "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. A publicação conta com a especificação de atributo SIZE_GRID_ID y SIZE_GRID_ROW_ID mas o id enviado no row é inválido, ou seja, não existe na tabela específicada no 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. O atributo size da publicação ou da variação, deve corresponder consistentemente ao da row da tabela que se está selecionado, devem ser idênticos, se o SIZE da publicação ou variação é inválido nesta comparação:

{
    "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. Os atributos detalhados na tabela devem corresponder consistentemente com a informação da publicação, por exemplo, o atributo GENDER da tabela deve ser o mesmo que o da publicação:

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

8. Você está tentando associar uma tabela de medidas personalizada ou específico que não pertence ao vendedor atual.

{
"department": "structured-data",
"cause_id": 2617,
"type": "error",
"code": "invalid.fashion_grid.seller_id.values",
"references": [
"item.seller_id"
],
"message": "The size chart {CHART_ID} doesn't belong to the seller id [{SELLER_ID}]"
}

Moderações

Novas publicações que criadas com sucesso no Mercado Livre, mas que não cumpram com um ou mais motivos de validação descritos acima, serão moderadas e posteriormente pausadas. Você poderá consultar o motivo e a solução usando a API de moderação.

Exemplo de uma resposta a um item moderado devido a inconsistências na tabela de medidas:

{
   "infractions": [
       {
           "id": "1124452904",
           "date_created": "2023-02-06T09:38:17.795-0400",
           "user_id": "1048645520",
           "related_item_id": "MLB3185096322",
           "element_id": "MLB3185096322",
           "element_type": "ITM",
           "site_id": "MLB",
           "filter_subgroup": "TP",
           "reason": "O anúncio foi pausado porque o gênero do guia de tamanhos não corresponde ao do anúncio. Por favor, vincule outro guia para reativar o anúncio.",
           "remedy": "Vincule outro guia de tamanhos para reativar o anúncio
O gênero do guia de tamanhos não corresponde ao do anúncio.
"
       }
   ],
   "paging": {
       "offset": 0,
       "limit": 20,
       "total": 1
   },
   "sorting_type": "date_created_desc"
}

Próxima: Qualidade da foto de moda.