Guia de conversão de ofertas para AFN

Como converter ofertas para vendê-las nos programas FBA - Logística da Amazon ou FBA Onsite - Logística da Amazon.

Quando um SKU é criado na Amazon, caso não tenha sido especificado o modelo de logística na requisição da sua criação, por padrão, ele será criado como sendo uma oferta MFN (Logística do Vendedor). Para vendê-lo dentro do programa FBA - Logística da Amazon ou FBA Onsite - Logística da Amazon é preciso já criá-lo com as informações requeridas ou então convertê-lo para AFN (Amazon Fulfillment Network) utilizando a operação patchListingsItem, no caso de atualizações 1x1, ou então via API Feeds JSON para atualização em massa.

📘

Baterias e mercadorias perigosas

Para criar ou converter um item de listagem (SKU) em Fulfillment by Amazon (FBA), você precisa fornecer informações adicionais sobre o produto, como se ele possui bateria ou se pode ser considerado uma mercadoria perigosa (também chamado de Hazmat). Qualquer tentativa de criação ou conversão de um SKU em FBA sem fornecer informações sobre baterias e mercadorias perigosas irá falhar retornando erro (HTTP status 400).

Conversão de uma oferta para AFN

Siga os seguintes passos para converter uma oferta para AFN ("fulfillment_channel_code":"AMAZON_NA") e receber notificações geradas como resultado.

📘

Criação de novo produto ou oferta

Para criação de novo produto ou oferta, consulte o Guia de criação de listagens.

Passo 1: Chame a operação getDefinitionsProductType para obter o JSON Schema que descreve os atributos (opcionais e obrigatórios) e restrições para o tipo de produto raiz "PRODUCT".

Exemplo de requisição da operação getDefinitionsProductType para obter a definição do tipo de produto genérico "PRODUCT":

JSON

GET https://sellingpartnerapi-na.amazon.com/definitions/2020-09-01/productTypes/PRODUCT
    ?marketplaceIds=A2Q3Y263D00KWC
    &requirements=LISTING
    &locale=pt_BR

Passo 2: Com base no JSON Schema obtido no passo anterior, monte o body JSON da requisição com os atributos necessários para a conversão da oferta para AFN que será utilizado na operação patchListingsItem. Você deverá adicionar no body todos os atributos obrigatórios se "fulfillment_channel_code": "AMAZON_NA".

Exemplo de atributos obrigatórios retornado no JSON Schema obtido pela operação getDefinitionsProductType, para quando "fulfillment_channel_code": "AMAZON_NA".

Passo 3: Verifique se os dados da listagem atendem aos requisitos antes do envio usando os utilitários de validação do JSON Schema. Consulte Meta-Schema de definição de tipo de produto da Amazon (v1) para obter mais detalhes sobre como validar dados com o tipo de produto JSON Schemas. Você deve garantir que os atributos necessários sejam fornecidos, que todos os valores sejam válidos, que quaisquer regras condicionais sejam consideradas e que todos os requisitos do esquema sejam atendidos.

Passo 4: Chame a operação patchListingsItem para enviar o item de listagem com o body JSON preparado e validado nas etapas anteriores.

Exemplo de body JSON para conversão de uma oferta MFN já criada no catálogo do vendedor para AFN:

JSON

{
   "productType":"PRODUCT",
   "patches":[
      {
         "op":"add",
         "path":"/attributes/fulfillment_availability",
         "value":[
            {
               "fulfillment_channel_code":"AMAZON_NA"
            }
         ]
      },
      {
         "op":"delete",
         "path":"/attributes/fulfillment_availability",
         "value":[
            {
               "fulfillment_channel_code":"DEFAULT"
            }
         ]
      },
      {
         "op":"replace",
         "path":"/attributes/supplier_declared_dg_hz_regulation",
         "value":[
            {
               "marketplace_id":"A2Q3Y263D00KWC",
               "value": "not_applicable"
            }
         ]
      },
      {
         "op":"replace",
         "path":"/attributes/batteries_required",
         "value":[
            {
               "marketplace_id":"A2Q3Y263D00KWC",
               "value": "false"
            }
         ]
      }
   ]
}

🚧

Tipo de produto (productType)

Como o objetivo da requisição é apenas converter a oferta (SKU) para AFN, pode ser enviado "productType":"PRODUCT".

Os demais parâmetros do body JSON deverão ser construídos com base no JSON Schema atual obtido no Passo 1. Caso o produto possua bateria por exemplo (batteries_required: true), outros atributos obrigatórios precisarão ser adicionados na requisição para que a conversão possa ser realizada com sucesso.

❗️

Evite oferta híbrida!

Sempre envie a operação "delete" para o "fulfillment_channel_code":"DEFAULT" além da operação "add" para "fulfillment_channel_code":"AMAZON_NA" para evitar que a oferta fique disponível em ambos os modelos de logística, causando o que chamamos de oferta híbrida.

Seguem abaixo as definições dos principais atributos obrigatórios na conversão de ofertas para FBA:

Atributo	Descrição
supplier_declared_dg_hz_regulation Obrigatório	O valor deverá ser true se o produto for um material, substância, resíduo perigoso sujeito à regulamentação para transporte, armazenamento e descarte, ou false se não for esse o caso. Tipo: boolean
batteries_required Obrigatório	O valor deverá ser true se forem necessárias baterias para ligar o item (ou se o item for uma bateria) ou false se não for esse o caso. Note que uma bateria recarregável interna também é considerada uma bateria. Tipo: boolean
ncm_code Obrigatório somente para FBA Logística da Amazon	Informação válida de acordo com a tabela de NCM vigente. O código precisa ter 8 dígitos e ser válido. Tipo: array
import_designation Obrigatório somente para FBA Logística da Amazon	Envie um valor válido da lista suspensa. Tipo: array

Consulte mais detalhes e os valores válidos atuais dos atributos utilizando a operação getDefinitionsProductType.

Para atualizações em massa, consulte o Guia de gerenciamento de listagens.

Passo 5: Inspecione o retorno da solicitação. A API Listings Items realiza uma primeira validação de forma síncrona, o que significa que alguns erros já podem ser capturados logo no input do seu request. Para isso, monitore a resposta para identificar se o status do envio foi ACCEPTED ou INVALID durante a submissão. Se INVALID, um ou mais problemas de validação síncrona impediram a aceitação da subida do produto (pode ser algum atributo obrigatório faltando ou campos com valores inválidos, por exemplo). Se ACCEPTED, as validações iniciais foram aprovadas e os dados foram enviados para processamento adicional com o catálogo da Amazon (essa segunda etapa de validação é de forma assíncrona). As notificações do passo a seguir ajudarão a monitorar esses status; consulte Como lidar com problemas de itens de listagens para obter mais informações. Corrija os problemas de validação e reenvie a solicitação.

Passo 6: Após receber ACCEPTED no passo anterior, aguarde as notificações assíncronas de LISTINGS_ITEM_STATUS_CHANGE ou LISTINGS_ITEM_ISSUES_CHANGE para obter maiores informações sobre o produto e seu status.

Você deve assinar as notificações mencionadas para recebê-las. Consulte Inscrever-se nas notificações de listagens para obter mais informações.

Após receber alguma das notificações, para saber qual foi a mensagem de erro ("ERROR") ou aviso ("WARNING") recebida, chame a operação getListingsItem. Importante mencionar que "WARNING" não impede a criação do produto, mas "ERROR" impede a criação do produto com sucesso, portanto, sempre consulte a operação getListingsItem caso receba uma notificação com o valor "ERROR" no atributo Severities.

Conversão de uma oferta de AFN para MFN

Para converter uma oferta de AFN ("fulfillment_channel_code":"AMAZON_NA") para MFN ("fulfillment_channel_code":"DEFAULT"), chame a operação patchListingsItem com o seguinte body JSON abaixo com a quantidade de estoque desejada no atributo "quantity":

JSON

{
   "productType":"PRODUCT",
   "patches":[
        {
         "op":"add",
         "path":"/attributes/fulfillment_availability",
         "value":[
            {
               "fulfillment_channel_code":"DEFAULT",
                "quantity":0
            }
         ]
       },
       {
         "op":"delete",
         "path":"/attributes/fulfillment_availability",
         "value":[
            {
               "fulfillment_channel_code":"AMAZON_NA"
            }
         ]
      }
   ]
}

Inspecione o retorno da solicitação e confirme a conversão da oferta realizando os passos 5 e 6 detalhados anteriormente no guia de conversão de ofertas para AFN.

❗️

Evite oferta híbrida!

Sempre envie a operação "delete" para o "fulfillment_channel_code":"AMAZON_NA" além da operação "add" para "fulfillment_channel_code":"DEFAULT" para evitar que a oferta fique disponível em ambos os modelos de logística, causando o que chamamos de oferta híbrida.

Para atualizações em massa, consulte o Guia de gerenciamento de listagens em massa.