Novo Matching Amazon

Este artigo interno explica o funcionamento do Novo Matching Amazon no ANYMARKET, incluindo a consulta por EAN no catálogo da Amazon, análise de sugestões de match, validação da oferta e criação do anúncio do tipo Match.

O Matching ocorre quando o seller tenta publicar um produto que já existe no catálogo da Amazon. Antes de criar o anúncio, o ANYMARKET consulta a Amazon utilizando o EAN do produto para verificar se já existe um ASIN correspondente no catálogo.

Neste artigo:

• Pré-requisitos
• Como funciona o Novo Matching Amazon
• Passo a passo do fluxo de matching
• Boas práticas
• Dúvidas comuns

Pré-requisitos

Antes de analisar ou executar o fluxo de matching da Amazon, valide se:

• O produto possui EAN informado;
• A integração Amazon está configurada corretamente no ANYMARKET;
• O produto possui dados mínimos para criação da oferta, como preço, estoque e condição;
• O seller confirmou se o produto sugerido pela Amazon corresponde ao produto que está sendo publicado;
• Há acesso ao OUTPUT do Kibana para consulta das chamadas, quando necessário.

Como funciona o Novo Matching Amazon

Quando o ANYMARKET identifica que um produto pode existir no catálogo da Amazon, é feita uma consulta informando o EAN do produto.

Essa consulta é realizada em toda a base de produtos cadastrados na Amazon, independentemente de o produto pertencer ao seller atual ou a outro seller.

A consulta pode ser localizada no log OUTPUT utilizando o OI e o EAN do produto como filtros.

Exemplo de endpoint utilizado na consulta:

https://sellingpartnerapi-na.amazon.com/catalog/2022-04-01/items?pageSize=5&marketplaceIds=A2Q3Y263D00KWC&includedData=summaries,images,relationships,attributes&keywords=7908069302543

Se a Amazon não retornar sugestão de match, o produto poderá seguir para criação como novo produto, ou seja, New ASIN.

Se houver sugestão de match, o seller deverá avaliar se o produto retornado corresponde ao produto que está sendo publicado.

Passo a passo do fluxo de matching

1. Consultar se existe produto com o mesmo EAN na Amazon

O ANYMARKET consulta a Amazon utilizando o EAN do produto. Essa consulta busca sugestões de ASINs já existentes no catálogo da Amazon.

Quando não houver sugestão de match, o retorno será semelhante ao exemplo abaixo:

{
  "numberOfResults": 0,
  "items": []
}

Quando houver sugestão de match, o retorno trará informações do produto sugerido, como ASIN, atributos, imagens, relacionamentos e dados de catálogo.

Exemplo simplificado de retorno com sugestão:

{
  "numberOfResults": 1,
  "items": [
    {
      "asin": "B0BDF5B11V",
      "attributes": {
        "externally_assigned_product_identifier": [
          {
            "value": "7908069302543",
            "type": "ean",
            "marketplace_id": "A2Q3Y263D00KWC"
          }
        ],
        "brand": [
          {
            "value": "Basoto Brasil",
            "marketplace_id": "A2Q3Y263D00KWC"
          }
        ],
        "item_name": [
          {
            "value": "Mesa Aparador Retrátil Basoto Annie com 4 bancos embutidos 100% MDF - Castanho",
            "marketplace_id": "A2Q3Y263D00KWC"
          }
        ]
      }
    }
  ]
}

2. Avaliar a sugestão de match

Após o retorno da Amazon, o seller deve avaliar se o produto sugerido corresponde ao produto que está tentando publicar.

Se o produto sugerido não for o mesmo produto que o seller está publicando e o seller desejar cadastrar um novo produto, será necessário entrar em contato com o suporte da Amazon para que a Amazon realize o cadastro ou ajuste necessário.

3. Validar a oferta com VALIDATION_PREVIEW

Após selecionar o produto sugerido para match, o ANYMARKET realiza uma nova validação do JSON do produto.

Essa validação usa o mesmo endpoint de criação de produto, porém com o parâmetro:

mode=VALIDATION_PREVIEW

A Amazon valida se os atributos estão preenchidos corretamente e também pode realizar validações adicionais, como:

• Isenção de EAN;
• Autorização para publicação;
• Restrições para listar o ASIN;
• Campos obrigatórios ou inválidos para a oferta.

Exemplo de URL para consulta no OUTPUT do Kibana:

https://sellingpartnerapi-na.amazon.com/listings/2021-08-01/items/AYV01WSGEPBGV/9136?issueLocale=pt_BR&mode=VALIDATION_PREVIEW&marketplaceIds=A2Q3Y263D00KWC

Caso a Amazon retorne erro nessa etapa, a mensagem será apresentada na transmissão.

4. Criar o anúncio do tipo Match

Se o seller confirmar que deseja continuar com o match, o ANYMARKET cria o anúncio do tipo Match na Amazon.

Exemplo de endpoint utilizado:

https://sellingpartnerapi-na.amazon.com/listings/2021-08-01/items/A71CUV34LHQDX/2431136?issueLocale=pt_BR&marketplaceIds=A2Q3Y263D00KWC

Nessa chamada, o ANYMARKET envia o parâmetro:

"requirements": "LISTING_OFFER_ONLY"

Esse parâmetro informa à Amazon que o anúncio será criado como uma oferta para um produto já existente no catálogo.

Também é enviado o ASIN sugerido para match no atributo merchant_suggested_asin, para que a Amazon entenda com qual produto do catálogo o seller deseja vincular a oferta.

Exemplo simplificado:

{
  "productType": "PRODUCT",
  "requirements": "LISTING_OFFER_ONLY",
  "attributes": {
    "merchant_suggested_asin": [
      {
        "value": "B0CYFCQGS8",
        "marketplace_id": "A2Q3Y263D00KWC"
      }
    ],
    "condition_type": [
      {
        "value": "new_new",
        "marketplace_id": "A2Q3Y263D00KWC"
      }
    ],
    "fulfillment_availability": [
      {
        "quantity": 10,
        "fulfillment_channel_code": "DEFAULT"
      }
    ],
    "purchasable_offer": [
      {
        "marketplace_id": "A2Q3Y263D00KWC",
        "currency": "BRL",
        "our_price": [
          {
            "schedule": [
              {
                "value_with_tax": 100.00
              }
            ]
          }
        ]
      }
    ]
  }
}

5. Consultar logs no Kibana

Todos os logs do fluxo podem ser consultados no OUTPUT do Kibana.

Para localizar as chamadas, utilize filtros como:

• OI do seller;
• EAN do produto;
• SKU;
• ASIN sugerido;
• URL do endpoint de catálogo;
• URL do endpoint de listings;
• mode=VALIDATION_PREVIEW;
• LISTING_OFFER_ONLY.

6. Verificar restrição para listar o ASIN

Antes ou durante o fluxo, a Amazon pode validar se o seller possui permissão para listar determinado ASIN.

Quando houver restrição, o retorno pode indicar necessidade de aprovação via Seller Central, por exemplo:

{
  "title": "Request Approval via Seller Central.",
  "type": "text/html"
}

Nesse caso, o seller deverá seguir o fluxo de autorização diretamente na Amazon.

7. Agrupamento de variação para produtos Match

Para produtos Match, a documentação da Amazon indica que não é possível fazer o agrupamento de variações pelo fluxo de matching.

Isso significa que:

• Se o produto sugerido para match já estiver agrupado corretamente na Amazon, os anúncios ficarão agrupados conforme o produto sugerido;
• Se as variações estiverem desagrupadas na Amazon, o match será feito com produtos individuais e sem agrupamento.

Caso o seller deseje agrupar essas variações, será necessário entrar em contato com a Amazon pelos recursos do Seller Central.

Links de apoio:

• Ferramenta de autoatendimento do Seller Central
• Como faço para criar variações?

Documentação de apoio da Amazon

• Como saber se o item que eu quero listar já existe ou não no catálogo da Amazon
• Listando uma oferta para um item que já existe no catálogo da Amazon (Matching)

Boas práticas

• Valide se o EAN do produto está correto antes de iniciar a publicação.
• Analise com atenção se o produto sugerido pela Amazon é realmente o mesmo produto do seller.
• Use o OI e o EAN para localizar a consulta de catálogo no OUTPUT do Kibana.
• Se a sugestão de match estiver incorreta, oriente o seller a acionar a Amazon para correção ou criação do produto.
• Utilize o parâmetro LISTING_OFFER_ONLY apenas quando o produto for uma oferta para ASIN já existente.
• Valide o uso de merchant_suggested_asin com o ASIN correto retornado pela Amazon.
• Considere que produtos Match não permitem agrupamento de variação pelo fluxo de matching.
• Se houver restrição de ASIN, o seller deve solicitar autorização no Seller Central.

Dúvidas comuns

O que é Matching Amazon?
É o fluxo utilizado quando o seller está publicando um produto que já existe no catálogo da Amazon. Nesse caso, o ANYMARKET cria uma oferta vinculada ao ASIN existente.

Como o ANYMARKET identifica se existe um produto com o mesmo EAN?
O ANYMARKET consulta o catálogo da Amazon pelo endpoint de catálogo, usando o EAN do produto como keyword.

A consulta busca apenas produtos do seller?
Não. A consulta é realizada em toda a base de produtos cadastrados na Amazon, independentemente de o produto ser do seller atual ou de outro seller.

O que acontece quando não há sugestão de match?
O retorno virá com numberOfResults: 0 e items: []. Nesse caso, o produto pode seguir para criação como novo produto, se atender aos requisitos da Amazon.

O que acontece quando há sugestão de match?
A Amazon retorna informações do produto sugerido, incluindo ASIN, atributos, imagens e dados de catálogo. O seller deve avaliar se a sugestão corresponde ao produto que deseja publicar.

O que fazer se o produto sugerido não for o mesmo produto?
Se o seller desejar cadastrar um novo produto, deverá entrar em contato com o suporte da Amazon para que a Amazon realize o cadastro ou ajuste necessário.

Qual parâmetro indica que o anúncio é Match?
O parâmetro "requirements": "LISTING_OFFER_ONLY".

Para que serve o merchant_suggested_asin?
Serve para informar à Amazon o ASIN sugerido para match, indicando com qual produto do catálogo o seller deseja vincular a oferta.

O que é VALIDATION_PREVIEW?
É uma validação enviada para a Amazon antes da criação efetiva da oferta, usando mode=VALIDATION_PREVIEW no endpoint de listings.

Onde consulto os logs do fluxo?
No OUTPUT do Kibana, utilizando filtros como OI, EAN, SKU, ASIN, VALIDATION_PREVIEW ou LISTING_OFFER_ONLY.

É possível agrupar variações em produtos Match?
Não pelo fluxo de matching. Se o ASIN sugerido já estiver agrupado na Amazon, o anúncio seguirá esse agrupamento. Se estiver desagrupado, o match será feito individualmente.

O que fazer se o seller quiser agrupar variações desagrupadas na Amazon?
Será necessário acionar a Amazon pelo Seller Central para solicitar o agrupamento.

O que fazer se a Amazon retornar restrição para listar o ASIN?
O seller deve solicitar autorização diretamente no Seller Central, conforme orientação retornada pela Amazon.