Guia de caso de uso da API de listagem de itens

Acesse dados de listagens de parceiros de venda na Amazon.

Versão da API: 2021-08-01

O que é a API de listagem de itens (Listings Items)?

Usando a API Listings Items, você pode criar, editar, excluir e recuperar detalhes sobre listagens da Amazon (SKUs) para um parceiro de vendas. Isso inclui fatos do produto, como títulos de itens e termos de vendas, como preço e estoque. Consulte a Referência da API de listagem de itens para obter detalhes sobre as operações da API Listings Items e os tipos de dados e esquemas associados.

Os dados de listagens enviados à API Listings Items seguem o formato de esquema JSON fornecido pela API de definições de tipo de produto. Consulte a documentação da API de definições de tipo de produto para obter detalhes sobre como recuperar esquemas para tipos de produtos da Amazon e validar dados antes de enviar à Amazon com a API Listings Items.

Características principais

  • Recuperar detalhes sobre listagens: a API Listings Items aceita operações GET para retornar informações detalhadas sobre uma listagem existente.

  • Criar ou atualizar totalmente as listagens: a API Listings Items aceita operações PUT para criar uma nova listagem ou substituir totalmente os dados de uma listagem existente.

  • Atualizar listas parcialmente: a API Listings Items aceita operações PATCH para atualizar um ou mais atributos individuais de uma listagem existente, como para atualizar preço e quantidade. Além disso, a API Listings Items aceita operações PATCH para excluir um ou mais atributos individuais de uma listagem existente.

  • Excluir listagens: a API Listings Items aceita operações DELETE para excluir uma listagem existente.

  • Mensagens de problema localizadas: a API Listings Items fornece mensagens de problema localizadas na localidade especificada pelo aplicativo de chamada ou na localidade padrão do mercado da Amazon.

  • Validação de envio: a API Listings Items fornece validação de dados de envio antes de aceitar um envio para processamento. Erros de validação que impedem processamento adicional são fornecidos de forma síncrona ao aplicativo de chamada.

Terminologia

  • Listagem: uma listagem da Amazon é um item que um parceiro de vendas listou para venda na Amazon e é identificado por uma unidade de manutenção de estoque (SKU). Os fatos do produto incluídos nas listagens da Amazon são reconciliados em itens de catálogo da Amazon, que são identificados pelos números de identificação padrão da Amazon (ASINs).

  • Atualização completa: uma atualização completa de uma listagem da Amazon resulta na validação completa dos requisitos de dados nos dados enviados e cria uma nova listagem ou substitui os dados de uma listagem existente.

  • Atualização parcial: uma atualização parcial de uma listagem da Amazon resulta na validação parcial dos requisitos de dados para os atributos fornecidos e atualiza um ou mais atributos de uma listagem existente.

  • Tipo de produto: um tipo de produto (product type) da Amazon é uma categorização hierárquica de itens no catálogo da Amazon. Os requisitos de dados do item estão vinculados ao tipo de produto associado ao item.

Considerações

  • Atualizações 1x1: a API Listings Items aceita atualizações de listagens uma de cada vez. Para casos de uso mais adequados para uploads em massa, o tipo de feed JSON_LISTINGS_FEED pode ser usado com a API de Feeds. O JSON_LISTINGS_FEED é o equivalente em massa da API Listings Items, oferecendo os mesmos recursos e esquemas fornecidos pela API Product Type Definitions.

  • Tipos de produtos com suporte total: a API Listings Items ainda não oferece suporte total a todos os tipos de produtos da Amazon. Os tipos de produtos compatíveis da Amazon diferem pelo tipo de parceiro de vendas (vendedor ou fornecedor) e pelo mercado da Amazon. Consulte a API de definições de tipo de produtos para obter a lista mais recente dos tipos de produtos da Amazon disponíveis.

  • Tipos de produtos parcialmente suportados: para tipos de produtos da Amazon ainda não totalmente suportados pela API Listings Items, são suportados apenas os envios de oferta para ASINs existentes e atualizações parciais usando o tipo de produto PRODUCT.

  • Resultados e problemas: as respostas das operações putListingsItem, patchListingsItem e deleteListingsItem dos itens de listagem indicam se o envio foi aceito ou não para processamento, juntamente com quaisquer problemas que impeçam que o envio seja aceito. As respostas não incluem problemas que ocorrem após a aceitação do envio para processamento. As respostas à operação getListingsItem de itens de listagens podem incluir problemas que ocorrem após o processamento do envio.

🚧

🚧 Manipulando esquemas JSON genéricos em bibliotecas de clientes

Se você gerou uma biblioteca cliente, é importante observar que o Swagger Codegen gera tipos com base nas propriedades definidas nos modelos Swagger e que o Swagger Codegen produzirá tipos vazios ou incompletos quando um objeto é definido com additionalProperties: true. Para lidar com esses objetos, use o--import-mappings parâmetro de linha de comando para mapear esses objetos para um tipo de objeto JSON genérico ou um tipo de objeto personalizado de sua escolha.

Exemplo de parâmetros de entrada do Swagger Codegen:

C#:--import-mappings ItemAttributes=Newtonsoft.Json.Linq.JObject
Java:--import-mappings ItemAttributes=com.google.gson.JsonObject

Tutorial: Recuperar detalhes sobre uma listagem

Use este tutorial para retornar informações detalhadas sobre uma listagem da Amazon para um determinado parceiro de vendas e mercado da Amazon. Os detalhes retornados podem incluir vários conjuntos de dados opcionais que fornecem informações importantes sobre o estado da listagem.

Importante: as novas notificações LISTINGS_ITEM_ISSUES_CHANGE e LISTINGS_ITEM_STATUS_CHANGE mencionadas nos parágrafos a seguir estão disponíveis apenas para vendedores no momento.

Por exemplo, se você se inscreveu para receber a notificação LISTINGS_ITEM_ISSUES_CHANGE usando a Selling Partner API for Notifications (API Notifications) e recebe a notificação, pode chamar a operação getListingsItem da API Listings Item para obter mais detalhes. A notificação LISTINGS_ITEM_ISSUES_CHANGE não inclui o mesmo nível de informações detalhadas sobre problemas que a API Listings Item. Para retornar informações mais detalhadas, chame getListingsItem e especifique issues no parâmetro includedData para obter o conjunto de dados de problemas.

Da mesma forma, se você assinar a notificação LISTINGS_ITEM_STATUS_CHANGE usando a API Notifications e receber a notificação, poderá chamar a operação getListingsItem para receber informações mais detalhadas. Por exemplo, se uma listagem deixar de ser DISCOVERABLE conforme indicado na notificação, convém obter o conjunto de dados de problemas para ver o motivo da supressão da pesquisa.

Para outro exemplo, se a notificação LISTINGS_ITEM_STATUS_CHANGE não indicar que a listagem pode ser comprada (ou seja, o status não inclui BUYABLE), um motivo comum pode ser a falta de estoque. Nesse caso, chame a operação getListingsItem e inclua fulfillmentAvailability no parâmetro includedData para retornar o conjunto de dados do fulfillmentAvailability.

Em geral, os conjuntos de dados disponíveis por meio do parâmetro includedData ajudarão você a entender melhor o status da listagem. Os conjuntos de dados disponíveis incluem informações resumidas, atributos contribuídos, problemas, informações sobre ofertas (vendedores), disponibilidade de estoque (vendedores) e detalhes de aquisição (fornecedores).

Pré-requisitos

Para concluir este tutorial, você precisará de:

  • Autorização do parceiro de vendas para quem você está fazendo chamadas. Consulte o Guia do desenvolvedor da API do parceiro de vendas para obter mais informações.

  • Aprovação para a função Lista de produtos em seu perfil de desenvolvedor.

  • A função Lista de produtos selecionada na página de registro do aplicativo para seu aplicativo.

Etapa 1: Enviar solicitação de obtenção de item de listagens

Chame a operação getListingsItem para retornar detalhes sobre um item de listagem, passando os seguintes parâmetros:

Parâmetros da requisição

Parâmetros do Path

ParâmetroExemploDescrição
sellerId

Obrigatório
AXXXXXXXXXXXXXUm identificador de parceiro de vendas, como uma conta de comerciante ou código de fornecedor.
Tipo: string
sku

Obrigatório
ABC123Identificador (unidade de manutenção de estoque) do item de listagem exclusivo do parceiro de vendas.
Tipo: string

Parâmetros da Query

ParâmetroExemploDescrição
marketplaceIds

Obrigatório
A2Q3Y263D00KWCLista delimitada por vírgulas de identificadores da Amazon marketplace.

Consulte o Guia do desenvolvedor da API do parceiro de vendas para obter a lista de identificadores da Amazon marketplace.
Tipo: array(csv)
issueLocalept_BRLocalização do problema.

Padrão: Quando nenhuma localidade é fornecida, a localidade padrão do primeiro mercado é usada. O padrão de localização é en_US quando uma mensagem localizada não está disponível na localidade especificada. Tipo: string
includedDatasummariesUma lista delimitada por vírgulas de conjuntos de dados a serem incluídos na resposta. Consulte IncludedData na referência da API para obter a lista de conjuntos de dados disponíveis.

Padrão: summaries.
Tipo: < enum (IncludedData) > array(csv)

Exemplo de Requisição

GET https://sellingpartnerapi-na.amazon.com/listings/2021-08-01/items/AXXXXXXXXXXXX/50-TS3D-QEPT
  ?marketplaceIds=ATVPDKIKX0DER
  &issueLocale=en_US
  &includedData=issues,attributes,summaries,offers,fulfillmentAvailability

Resposta
Uma resposta bem-sucedida inclui uma ou mais das seguintes informações:

NomeExemploDescrição
skuABC123Identificador (unidade de manutenção de estoque) do item de listagem exclusivo do parceiro de vendas.
Tipo: string
summariesVeja o exemplo de Resposta Detalhes de resumo de um item de listagem.

Tipo: ItemSummaries
attributesVeja o exemplo de Resposta Objeto JSON que contém dados de atributo de item de listagens estruturadas codificados por nome de atributo.

Tipo: ItemAttributes
issuesVeja o exemplo de Resposta Problemas associados ao item de listagens.

Tipo: ItemIssues
offersVeja o exemplo de Resposta Detalhes da oferta para o item de listagens.

Tipo: ItemOffers
fulfillmentAvailabilityVeja o exemplo de Resposta Disponibilidade de atendimento para o item de listagens.

Tipo: <FulfillmentAvailability > array
procurementVeja o exemplo de Resposta Informações de aquisição do fornecedor para o item de listagem.

Tipo: ItemProcurement

Exemplo de Resposta

Resposta de exemplo para um vendedor que inclui os conjuntos de dados summaries, attributes, issues, offers, e fulfillmentAvailability.

{
  "sku": "50-TS3D-QEPT",
  "summaries": [
    {
      "marketplaceId": "ATVPDKIKX0DER",
      "asin": "B08YRD1CNN",
      "productType": "DRINKING_CUP",
      "conditionType": "new_new",
      "status": [
        "BUYABLE",
        "DISCOVERABLE"
      ],
      "itemName": "6 Pack Coffee Mug Set, Farielyn-X 16 Ounce Ceramic Coffee Cups, Black Large Coffee mugs, Restaurant Coffee Cups for Coffee, Tea, Cappuccino, Cocoa, Cereal, Matte Black Outside and Colorful Inside",
      "createdDate": "2021-07-14T19:57:02.327Z",
      "lastUpdatedDate": "2021-07-14T19:57:10.637Z",
      "mainImage":
      {
        "link": "https://m.media-amazon.com/images/I/41epVg7mZoS.jpg",
        "height": 500,
        "width": 500
      }
    }
  ],
  "attributes":
  {
    "condition_type": [
      {
        "value": "new_new",
        "marketplace_id": "ATVPDKIKX0DER"
      }
    ],
    "merchant_shipping_group": [
      {
        "value": "legacy-template-id",
        "marketplace_id": "ATVPDKIKX0DER"
      }
    ],
    "merchant_suggested_asin": [
      {
        "value": "B08YRD1CNN",
        "marketplace_id": "ATVPDKIKX0DER"
      }
    ],
    "purchasable_offer": [
      {
        "currency": "USD",
        "start_at":
        {
          "value": "2021-07-14T19:56:57.717Z"
        },
        "our_price": [
          {
            "schedule": [
              {
                "value_with_tax": 30.0
              }
            ]
          }
        ],
        "marketplace_id": "ATVPDKIKX0DER"
      }
    ],
    "fulfillment_availability": [
      {
        "fulfillment_channel_code": "DEFAULT",
        "quantity": 1,
        "marketplace_id": "ATVPDKIKX0DER"
      }
    ],
    "main_product_image_locator": [
      {
        "media_location": "https://media-origin-na-ssl.integ.amazon.com/images/I/xxxx1.jpg",
        "marketplace_id": "ATVPDKIKX0DER"
      }
    ],
    "other_product_image_locator_1": [
      {
        "media_location": "https://media-origin-na-ssl.integ.amazon.com/images/I/xxxxx2.jpg",
        "marketplace_id": "ATVPDKIKX0DER"
      }
    ],
    "other_product_image_locator_2": [
      {
        "media_location": "https://media-origin-na-ssl.integ.amazon.com/images/I/xxxxx3.jpg",
        "marketplace_id": "ATVPDKIKX0DER"
      }
    ]
  },
  "issues": [
    {
      "message": "Attributes tagged as relevant_attributes are incomplete. Provide values for the following attribute(s): item_weight, theme, item_dimensions, item_diameter",
      "severity": "WARNING",
      "attributeName": "item_diameter",
      "attributeNames": [
        "item_diameter",
        "item_dimensions",
        "item_weight",
        "theme"
      ]
    },
    {
      "message": "Attributes tagged as customer_returns are incomplete. Provide values for the following attribute(s): color, item_dimensions, item_weight",
      "severity": "WARNING",
      "attributeName": "color",
      "attributeNames": [
        "color",
        "item_dimensions",
        "item_weight"
      ]
    }
  ],
  "offers": [
    {
      "marketplaceId": "ATVPDKIKX0DER",
      "offerType": "B2C",
      "price":
      {
        "currency": "USD",
        "amount": "30.0"
      }
    }
  ],
  "fulfillmentAvailability": [
    {
      "fulfillmentChannelCode": "DEFAULT",
      "quantity": 1
    }
  ]
}

Exemplo de requisição e resposta para um fornecedor que inclui o conjunto de dados summaries, procurement, e issues.

Exemplo de Requisição

GET https://sellingpartnerapi-na.amazon.com/listings/2021-08-01/items/AXXXXXXXXXXXX/example-sku
  ?marketplaceIds=ATVPDKIKX0DER
  &issueLocale=en_US
  &includedData=summaries,procurement,issues

Exemplo de Resposta

{
  "sku": "example-sku",
  "summaries": [
    {
      "marketplaceId": "ATVPDKIKX0DER",
      "asin": "B071VG5N9D",
      "productType": "LUGGAGE",
      "conditionType": "new_new",
      "status": [
        "DISCOVERABLE"
      ],
      "itemName": "Hardside Carry-On Spinner Suitcase Luggage",
      "createdDate": "2021-02-01T00:00:00Z",
      "lastUpdatedDate": "2021-03-01T00:00:00Z",
      "mainImage":
      {
        "link": "https://www.example.com/luggage.png",
        "height": 500,
        "width": 500
      }
    }
  ],
  "procurement": [
    {
      "costPrice":
      {
        "currencyCode": "USD",
        "amount": "100.00"
      }
    }
  ],
  "issues": [
    {
      "message": "Attributes tagged as relevant_attributes are incomplete. Provide values for the following attribute(s): item_weight, theme, item_dimensions, item_diameter",
      "severity": "WARNING",
      "attributeName": "item_diameter",
      "attributeNames": [
        "item_diameter",
        "item_dimensions",
        "item_weight",
        "theme"
      ]
    },
    {
      "message": "Attributes tagged as customer_returns are incomplete. Provide values for the following attribute(s): color, item_dimensions, item_weight",
      "severity": "WARNING",
      "attributeName": "color",
      "attributeNames": [
        "color",
        "item_dimensions",
        "item_weight"
      ]
    }
  ]
}

Tutorial: Criar ou atualizar totalmente uma listagem

Use este tutorial para criar ou atualizar totalmente uma listagem da Amazon para um determinado parceiro de vendas e mercado da Amazon.

Pré-requisitos

Para concluir este tutorial, você precisará de:

  • Autorização do parceiro de vendas para quem você está fazendo chamadas. Consulte o Guia do desenvolvedor da API do parceiro de vendas para obter mais informações.

  • Aprovação para a função Lista de produtos em seu perfil de desenvolvedor.

  • A função Lista de produtos selecionada na página de registro do aplicativo para seu aplicativo.

  • Uma carga útil de listagem baseada em JSON Schema que adere ao esquema JSON fornecido pela API do parceiro de vendas para definições de tipo de produto para determinado parceiro de venda, mercado da Amazon e tipo de produto da Amazon.

Etapa 1. Enviar solicitação de colocação de item de listagem

Chame a operação putListingsItem para criar ou atualizar totalmente uma listagem, passando os seguintes parâmetros.

Parâmetros da requisição

Parâmetros do Path

ParametroExemploDescrição
sellerId

Obrigatório
AXXXXXXXXXXXXXUm identificador de parceiro de vendas, como uma conta de comerciante ou código de fornecedor.

Tipo: string
sku

Obrigatório
ABC123Identificador (unidade de manutenção de estoque) do item de listagem exclusivo do parceiro de vendas.

Tipo: string

Parâmetros da Query

ParametroExemploDescrição
marketplaceIds

Obrigatório
ATVPDKIKX0DERLista delimitada por vírgulas de identificadores de mercado da Amazon.

Consulte o Guia do desenvolvedor da API do parceiro de vendas para obter a lista de identificadores de mercado da Amazon. Tipo: array(csv)
issueLocaleen_USLocalização do problema.

Padrão: Quando nenhuma localidade é fornecida, a localidade padrão do primeiro mercado é usada. O padrão de localização é en_US quando uma mensagem localizada não está disponível na localidade especificada.

Tipo: string

Parâmetros do Body

ParametroExemploDescrição
body

Obrigatório
Veja o exemplo de requisiçãoO esquema do corpo da solicitação para a operação putListingsItem.
Tipo: ListagensItemPutRequest

Exemplo de Requisição

PUT https://sellingpartnerapi-na.amazon.com/listings/2021-08-01/items/AXXXXXXXXXXXXX/ABC123
    ?marketplaceIds=ATVPDKIKX0DER
    &issueLocale=en_US
{
  "productType": "LUGGAGE",
  "requirements": "LISTING",
  "attributes": {
    "condition_type": [
      {
        "value": "new_new",
        "marketplace_id": "ATVPDKIKX0DER"
      }
    ],
    "item_name": [
      {
        "value": "AmazonBasics 16\" Underseat Spinner Carry-On",
        "language_tag": "en_US",
        "marketplace_id": "ATVPDKIKX0DER"
      }
    ],
    ...
  }
}

Resposta

Uma resposta bem-sucedida inclui o seguinte:

ParametroExemploDescrição
skuABC123Identificador (unidade de manutenção de estoque) do item de listagem exclusivo do parceiro de vendas.

Tipo: string
statusACCEPTEDStatus do envio do item de listagens. Tipo: enum(Status)
submissionIdf1dc291475dd11eabc550242ac130003Identificador exclusivo do envio do item de listagens.

Tipo: string
issuesVeja o exemplo de RespostaProblemas de itens de listagens relacionados ao envio de itens de listagens.

Tipo: <Issue> array

Exemplo de Resposta

{
  "sku": "ABC123",
  "status": "INVALID",
  "submissionId": "f1dc291475dd11eabc550242ac130003",
  "issues": [
    {
      "code": "90220",
      "message": "'product_description' is required but not supplied.",
      "severity": "ERROR",
      "attributeNames": [
        "product_description"
      ]
    }
    ...
  ]
}

Tutorial: Atualizar parcialmente uma listagem

Use este tutorial para atualizar parcialmente uma listagem da Amazon para um determinado parceiro de vendas e mercado da Amazon usando a API Listings Items.

As atualizações parciais são enviadas na forma de documentos JSON Patch. Consulte https://tools.ietf.org/html/rfc6902 para obter mais detalhes sobre documentos JSON Patch. Para listagens da Amazon, os documentos JSON Patch podem adicionar, substituir ou excluir atributos inteiros. Não há suporte para a aplicação de patches no conteúdo dos atributos.

Pré-requisitos

Para concluir este tutorial, você precisará de:

  • Autorização do parceiro de vendas para quem você está fazendo chamadas. Consulte o Guia do desenvolvedor da API do parceiro de vendas para obter mais informações.

  • Aprovação para a função Lista de produtos em seu perfil de desenvolvedor.

  • A função Lista de produtos selecionada na página de registro do aplicativo para seu aplicativo.

  • Para atualizações de atributos, cargas úteis de atributos de listagem com base em JSON que aderem ao JSON Schema fornecido pela API de definições de tipo de produto para determinado parceiro de venda, mercado da Amazon, tipo de produto da Amazon e atributos.

  • Para exclusões de atributos, cargas úteis de atributos de listagem baseados em JSON que aderem ao JSON Schema fornecido pela API de definições de tipo de produto para determinado parceiro de venda, mercado da Amazon, tipo de produto da Amazon e atributos com as propriedades do seletor dos atributos a serem excluídos. Os atributos não podem ser excluídos apenas pelo nome, os valores do seletor identificam qual instância de atributos excluir.

Etapa 1. Enviar solicitação de correção de item de listagem

Chame a operação patchListingsItem para atualizar parcialmente uma listagem, passando os seguintes parâmetros:

Parâmetros da Requisição

Parâmetros do Path

ParametroExemploDescrição
sellerId

Obrigatório
AXXXXXXXXXXXXXUm identificador de parceiro de vendas, como uma conta de comerciante ou código de fornecedor.

Tipo: string
sku

Obrigatório
ABC123Identificador (unidade de manutenção de estoque) do item de listagem exclusivo do parceiro de vendas.

Tipo: string

Parâmetros da Query

ParametroExemploDescrição
marketplaceIds

Obrigatório
ATVPDKIKX0DERLista delimitada por vírgulas de identificadores de mercado da Amazon.

Consulte o Guia do desenvolvedor da API do parceiro de vendas para obter a lista de identificadores de mercado da Amazon.

Tipo: array(csv)
issueLocaleen_USLocalização do problema.

Padrão: Quando nenhuma localidade é fornecida, a localidade padrão do primeiro mercado é usada. O padrão de localização é en_US quando uma mensagem localizada não está disponível na localidade especificada.

Tipo: string

Parâmetro do Body

ParametroExemploDescrição
body

Obrigatório
Veja o Exemplo de RequisiçãoO esquema do corpo da solicitação para a operação patchListingsItem.

Tipo: ListingsItemPatchRequest

Exemplo de Requisição

PATCH https://sellingpartnerapi-na.amazon.com/listings/2021-08-01/items/AXXXXXXXXXXXXX/ABC123
    ?marketplaceIds=ATVPDKIKX0DER
    &issueLocale=en_US
{
  "productType":"LUGGAGE",
  "patches":[
    {
      "op":"replace",
      "path":"/attributes/item_name",
      "value":[
        {
          "value": "AmazonBasics 16\" Underseat Spinner Carry-On",
          "language_tag": "en_US",
          "marketplace_id": "ATVPDKIKX0DER"
        }
      ]
    },
    {
      "op":"replace",
      "path":"/attributes/purchasable_offer",
      "value":[
        {
          "marketplace_id": "ATVPDKIKX0DER",
          "currency": "USD",
          "our_price": [
            {
              "schedule": [
                {
                  "value_with_tax": 15.00
                }
              ]
            }
          ]
        }
      ]
    },
    {
      "op":"delete",
      "path":"/attributes/item_type_name",
      "value":[
        {
          "marketplace_id": "ATVPDKIKX0DER",
          "language_tag": "en_US"
        }
      ]
    }
  ]
}

Resposta

Uma resposta bem-sucedida inclui o seguinte:

NomeExemploDescrição
skuABC123Identificador (unidade de manutenção de estoque) do item de listagem exclusivo do parceiro de vendas.

Tipo: string
statusACCEPTEDStatus do envio do item de listagens.

Tipo: enum(Status)
submissionIdf1dc291475dd11eabc550242ac130003Identificador exclusivo do envio do item de listagens.

Tipo: string
issuesVeja o Exemplo de RespostaProblemas de itens de listagens relacionados ao envio de itens de listagens.

Tipo: <Issue> array

Exemplo de Resposta

{
  "sku": "ABC123",
  "status": "ACCEPTED",
  "submissionId": "f1dc291475dd11eabc550242ac130003",
  "issues": []
}

Tutorial: Excluir uma listagem

Use este tutorial para excluir uma listagem da Amazon para um determinado parceiro de vendas e mercado da Amazon usando a API Listings Items.

Pré-requisitos

Para concluir este tutorial, você precisará de:

  • Autorização do parceiro de vendas para quem você está fazendo chamadas. Consulte o Guia do desenvolvedor da API do parceiro de vendas para obter mais informações.

  • Aprovação para a função Lista de produtos em seu perfil de desenvolvedor.

  • A função Lista de produtos selecionada na página de registro do aplicativo para seu aplicativo.

Etapa 1. Enviar solicitação de exclusão de item de listagem

Chame a operação deleteListingsItem para excluir uma listagem, passando os seguintes parâmetros:

Parâmetros da Requisição

Parâmetros do Path

ParametroExemploDescrição
sellerId

Obrigatório
AXXXXXXXXXXXXXUm identificador de parceiro de vendas, como uma conta de comerciante ou código de fornecedor.

Tipo: string
sku

Obrigatório
ABC123Identificador (unidade de manutenção de estoque) do item de listagem exclusivo do parceiro de vendas.

Tipo: string

Parâmetros da Query

ParametroExemploDescrição
marketplaceIds

Obrigatório
ATVPDKIKX0DERLista delimitada por vírgulas de identificadores de mercado da Amazon.

Consulte o Guia do desenvolvedor da API do parceiro de vendas para obter a lista de identificadores de mercado da Amazon.

Tipo: array(csv)
issueLocaleen_USLocalização do problema.

Padrão: Quando nenhuma localidade é fornecida, a localidade padrão do primeiro mercado é usada. O padrão de localização é en_US quando uma mensagem localizada não está disponível na localidade especificada.

Tipo: string

Exemplo da Requisição

DELETE https://sellingpartnerapi-na.amazon.com/listings/2021-08-01/items/AXXXXXXXXXXXXX/ABC123
    ?marketplaceIds=ATVPDKIKX0DER
    &issueLocale=en_US

Resposta
Uma resposta bem-sucedida inclui o seguinte:

NomeExemploDescrição
skuABC123Identificador (unidade de manutenção de estoque) do item de listagem exclusivo do parceiro de vendas.

Tipo: string
statusACCEPTEDStatus do envio do item de listagem.

Tipo: enum(Status)
submissionIdf1dc291475dd11eabc550242ac130003Identificador exclusivo do envio do item de listagens.

Tipo: string
issuesVeja Exemplo de RespostaProblemas de itens de listagens relacionados ao envio de itens de listagens.

Tipo: <Issue> array

Exemplo de Resposta

{
  "sku": "ABC123",
  "status": "ACCEPTED",
  "submissionId": "f1dc291475dd11eabc550242ac130003",
  "issues": []
}

Envio de imagens e outros atributos de mídia

A API Listings Items aceita imagens de produtos e outros atributos de conteúdo de mídia das seguintes fontes:

  • Conteúdo público do bucket do Amazon S3 acessível por meio de URL HTTP ou HTTPS
  • Conteúdo público de distribuição do Amazon CloudFront acessível por meio de URL HTTP ou HTTPS
  • Conteúdo de bucket privado do Amazon S3 baixado por meio de URL do S3 (por exemplo, s3://bucket-name/object-name.jpg)

🚧

Imagens hospedadas em servidores de terceiros não são aceitas!

Se você usar um bucket privado do Amazon S3, também deverá configurar sua política de bucket do Amazon S3 para permitir que as operações GetObject e ListBucket na função do IAM acessando o bucket (arn:aws:iam::368641386589:role/Media-Download-Role). Consulte a seguinte política de bucket do S3 para obter um exemplo.

O conteúdo privado do Amazon S3 é tratado como imutável, o que significa que você não pode alterar o conteúdo de uma chave de objeto do Amazon S3. O novo conteúdo de mídia requer uma nova chave de objeto do Amazon S3. Essa convenção oferece o benefício de tempos de processamento aprimorados e evita o custo de downloads redundantes caso os envios de listagem sejam reprocessados.

Veja a seguir um exemplo de política de bucket do Amazon S3 que habilita as operações necessárias em um bucket chamado bucket-name:

{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Sid": "",
            "Action": [
                "s3:GetObject",
                "s3:ListBucket"
            ],
            "Effect": "Allow",
            "Resource": [
                "arn:aws:s3:::bucket-name/*",
                "arn:aws:s3:::bucket-name"
            ],
            "Principal": {
                "AWS": [
                    "arn:aws:iam::368641386589:role/Media-Download-Role"
                ]
            }
        }
    ]
}