Guia de casos de uso da API de vendedores v1

Recupere informações da conta do vendedor e do mercado.

Versão da API: V1

O que é a API Sellers?

The Selling Partner API for Sellers (Sellers API) provides information about seller accounts and marketplaces. The returned information includes:

  • Os mercados nos quais o vendedor pode listar itens
  • O idioma e a moeda padrão de um site
  • Se o vendedor suspendeu os anúncios
  • Informações comerciais do vendedor

For details about the operations, data types, and schemas of the Sellers API, refer to Sellers API v1 Reference.

Tutorial: obtenha as informações da conta de um vendedor (somente na UE)

Saiba como recuperar as informações da conta de um vendedor. As informações que você recupera incluem uma lista de participações no mercado, informações comerciais e detalhes do plano de vendas. Isso só está disponível na região da UE.

Pré-requisitos

Para concluir este tutorial, você deve preencher os seguintes pré-requisitos:

Obtenha informações da conta

Call the getAccount operation.

Parâmetros de solicitação

Nenhuma.

Exemplo de solicitação

GET /sellers/v1/account

Propriedades de resposta

Uma resposta bem-sucedida inclui as seguintes propriedades:

NomeDescriçãoSchema
businessInformações sobre a empresa do vendedor. Dependendo do vendedor businessType, você pode omitir determinados campos.Business
businessTypeO tipo de negócio para o qual a conta do vendedor está registrada.enum (BusinessType)
marketplaceParticipationListUma lista de participações no mercado.< MarketplaceParticipationList> array
primaryContactInformações sobre o contato principal do vendedor.PrimaryContact
sellingPlanDetalhes do plano de vendas.enum (SellingPlan)

Exemplo de resposta

{ "businessType": "PRIVATE_LIMITED", "marketplaceParticipationList": [ { "marketplace": { "id": "ATVPDKIKX0DER", "name": "United States", "countryCode": "US", "domainName": "www.amazon.com" }, "storeName": "BestSellerStore", "participation": { "isParticipating": true, "hasSuspendedListings": false } } ], "sellingPlan": "PROFESSIONAL", "business": { "name": "BestSeller Inc.", "nonLatinName": "ベストセラー株式会社", "registeredBusinessAddress": { "addressLine1": "123 Main St", "addressLine2": "Suite 500", "city": "Seattle", "stateOrProvinceCode": "WA", "postalCode": "98101", "countryCode": "US" }, "companyRegistrationNumber": "123456789", "companyTaxIdentificationNumber": "987654321" }, "primaryContact": { "name": "John Doe", "nonLatinName": "ジョン・ドゥ", "address": { "addressLine1": "456 Oak St", "addressLine2": "Apt 12", "city": "Seattle", "stateOrProvinceCode": "WA", "postalCode": "98102", "countryCode": "US" } } }

Tutorial: obtenha a participação de um vendedor no mercado

Saiba como obter uma lista das lojas da Amazon nas quais o vendedor pode listar itens. As informações que você recupera incluem informações do mercado, o nome da loja do vendedor no mercado, se o vendedor participa do mercado e se o vendedor suspendeu os anúncios no mercado.

Pré-requisitos

Para concluir este tutorial, você deve preencher os seguintes pré-requisitos:

Obtenha participação no mercado

Call the getMarketplaceParticipations operation.

Parâmetros de solicitação

Nenhuma.

Exemplo de solicitação

GET /sellers/v1/marketplaceParticipations

Resposta

Uma resposta bem-sucedida inclui os seguintes elementos:

NomeDescriçãoSchema
marketplaceParticipationListUma lista de mercados da Amazon em que o vendedor pode listar itens e os clientes podem ver e comprar itens.< MarketplaceParticipationList> array

Exemplo de resposta

[ { "marketplace": { "id": "ATVPDKIKX0DER", "name": "Amazon.com", "countryCode": "US", "defaultCurrencyCode": "USD", "defaultLanguageCode": "en_US", "domainName": "www.amazon.com" }, "storeName": "BestSellerStore", "participation": { "isParticipating": true, "hasSuspendedListings": false } } ]

Esta página ajudou você?