AUTO PARTS: COMPATIBILIDADE DE AUTOPEÇAS

A partir do dia 24 de junho de 2024 está disponível na Shopee a feature que permite adicionar compatibilidade entre veículos e produtos de auto peças. Com isso alguns endpoints foram criados e outros tiveram atualizações relacionadas a esse tema.

Vantagens no uso da feature de compatibilidade

• Sellers poderão configurar itens mais completos, com os dados de veículos compatíveis com seus produtos;
• Os itens com compatibilidade preenchida irão aparecer em posições de melhor relevância na página de resultados da pesquisa (SRP) do buyer;
• O buyer terá maior confiabilidade na compra, uma vez que será mais fácil confirmar se um item é de fato compatível com seu veículo.

Considerando esse cenário, se o seus clientes (os sellers) trabalham com itens de autopeças, recomendamos fortemente que implementem os novos endpoints na plataforma de vocês.

Estrutura dos dados

Os dados dos veículos são armazenados da seguinte forma:

Estabelecido isso, é importante reforçar que os parâmetros listados acima seguem a seguinte relação de dependência: brand > model > year > version.

Novos endpoints:

v2.product.get_all_vehicle_list

• Como o nome indica, é o endpoint responsável por trazer toda a lista de veículos presente na base de dados da Shopee. Para usá-lo, o parâmetro obrigatório é o tamanho da página (page_size) que pode ser de no máximo 100 itens. Mais detalhes do endpoint você encontra em sua página do API Reference.
• Exemplo de retorno do endpoint:

{
    "error": "",
    "message": "",
    "warning": "",
    "request_id": "6535ecb33a3f8c6900c8d2b515f3c821",
    "response": {
        "vehicle_list": [
            {
                "brand_id": 5770,
                "brand_name": "Chevrolet",
                "model_id": 5905,
                "model_name": "Chevette",
                "year_id": 5712,
                "year_name": "1979",
                "version_id": 5907,
                "version_name": "Hatch"
            },
            {
                "brand_id": 5770,
                "brand_name": "Chevrolet",
                "model_id": 5905,
                "model_name": "Chevette",
                "year_id": 5712,
                "year_name": "1979",
                "version_id": 5906,
                "version_name": "S"
            }....
           ],
        "has_next_page": true,
        "next_offset": 61
    }
}

v2.product.get_vehicle_list_by_compatibility_detail

• Nesse endpoint é possível identificar os detalhes para cada um dos elementos do veículo (marca / modelo / ano / versão). O parâmetro obrigatório é o "compatibility_details" onde você pode especificar que nível de detalhamento deseja ver. Parâmetros opcionais (brand_id / model_id / year_id / version_id) ajudam no refinamento da busca. Mais informações em sua página na API Reference.
• Exemplos de chamadas no endpoint:

Mudanças em endpoints existentes

Alguns endpoints sofreram ajustes para que possam se adequar ao fluxo de compatibilidade, são eles:

• V2.product.add_item;
• V2.product.update_item;
• v2.product.get_item_base_info;

Nos dois primeiros endpoints é possível inserir as informações de compatibilidade para itens novos / existentes, respectivamente. No terceiro as mudanças auxiliam a confirmar se as informações de compatibilidade foram adicionadas corretamente.

Exemplo de estrutura para chamadas no v2.product.add_item e v2.product.update_item

    "compatibility_info": {
        "vehicle_info_list": [
            {
                "brand_id": 5770,
                "model_id": 5911,
                "year_id": 5590,
                "version_id": 5912
            },
            {
                "brand_id": 5508,
                "model_id": 5509,
                "year_id": 5516
            },
            {
                "brand_id": 5770,
                "model_id": 5905
            }
        ]
    },

Algumas considerações importantes:

• Se um determinado produto é compatível com todas as versões de um determinado ano, basta informar os ids para brand, model e year, o sistema entenderá que todas as versões daquele ano deverão ser inseridas na lista de compatibilidade;

			{
                "brand_id": 5508,
                "model_id": 5509,
                "year_id": 5516
            }

• De maneira similar, se todas as versões de todos os anos de um dado modelo forem compatíveis com o produto, basta informar os ids para brand e model;

            {
                "brand_id": 5770,
                "model_id": 5905
            }

• O v2.product.update_item poderá ser usado normalmente para adicionar as informações de compatibilidade em itens existentes que não a possuam. Nesse caso, basta informar a lista de compatibilidade conforme exemplos acima;

• ATENÇÃO: Ao usar o v2.product.update_item para adicionar compatibilidade em um item que já possui veículos em sua lista, você deverá informar a lista de ids existente atualmente no item + os novos ids de compatibilidade. Caso contrário, a lista de ids existente será sobreposta pelos novos ids informados na chamada do update item.

Se restar alguma dúvida no uso dos novos endpoints, basta abrir um ticket e iremos te auxiliar a integrar corretamente com a nova funcionalidade.