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 04/12/2024

Produtos Recondicionados

Importante:
Disponível em MLA, MLB, MLM, MLC, MLU, MPE, MCO.

Os produtos recondicionados dentro do domínio CELLPHONES competirão em um catálogo exclusivo, permitindo uma melhor segmentação e experiência para os compradores interessados nesse tipo de produto.

Catálogo de recondicionados

Para fazer parte do catálogo de recondicionados, é obrigatório incluir o novo atributo GRADING, que define o estado do produto.

A seguir, são descritos os graus disponíveis e suas interpretações:

Grau Descrição
Excelente Marcas de uso sutis e tela sem detalhes ou imperfeições. Deve ter mais de 80% da capacidade da bateria.
Bueno -Bom- Pequenas marcas de uso e tela sem detalhes ou imperfeições. Deve ter mais de 80% da capacidade da bateria.
Aceptable -Aceitável- Marcas de uso notórias e tela com arranhões ou riscos. Deve ter mais de 80% da capacidade da bateria.

Publicar celulares recondicionados

Para que um produto seja elegível no catálogo de recondicionados, é necessário atender às seguintes condições no momento de criar ou modificar a publicação:

  1. Condição do item: O atributo ITEM_CONDITION deve ter o valor "recondicionado" (refurbished). Ver mais.
  2. Estado do produto: É obrigatório incluir o atributo GRADING com um dos valores aceitos (Excelente, Bom, Aceitável). Ver mais.

Exemplo:


{
    "id": "GRADING",
    "name": "Estado del producto",
    "value_id": "40108830",
    "value_name": "Excelente",
    "value_struct": null,
    "values": [
        {
            "id": "40108830",
            "name": "Excelente",
            "struct": null,
            "source": 7571550481372610
        }
    ],
    "attribute_group_id": "OTHERS",
    "attribute_group_name": "Otros",
    "source": 7571550481372610,
    "value_type": "list"
}

Os itens recondicionados que não incluírem o atributo GRADING não serão elegíveis para participar do catálogo. Após adicionar o grau correspondente, verifique novamente a elegibilidade do produto através do endpoint de validação de elegibilidade.

Publicar diretamente no catálogo refurbished

  • Buscar o produto em /products/search
  • Realizar um POST em /items com o catalog_product_id (pdp tradicional) e catalog_listing:true. (igual ao para catálogo tradicional)

Se o item tiver o grading configurado, será replicado ao produto refurbished e começará a competir.


Publicar a partir do tradicional

  • Identifique através da API de elegibilidade os itens elegíveis por conter o GRADING.
  • POST /items/catalog_listings para publicar

Você pode identificar a qual tipo de página de produto seu item está associado consultando os detalhes do produto (traditional | refurbished):

Exemplo:


{
    "pdp_types": [
        "refurbished"
    ]
}

Próxima: Competição.