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:
- The selling partner must authorize you to call the Selling Partner API (SP-API) on their behalf. For details about how selling partners can authorize an application to call the SP-API on their behalf, refer to Authorizing Selling Partner API Applications.
- Your developer profile must include the Finance and Accounting role. To learn about roles, refer to Roles in the Selling Partner API.
- The app registration page for your application must include the Finance and Accounting role.
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:
Nome | Descrição | Schema |
---|---|---|
business | Informações sobre a empresa do vendedor. Dependendo do vendedor businessType , você pode omitir determinados campos. | Business |
businessType | O tipo de negócio para o qual a conta do vendedor está registrada. | enum (BusinessType ) |
marketplaceParticipationList | Uma lista de participações no mercado. | < MarketplaceParticipationList > array |
primaryContact | Informações sobre o contato principal do vendedor. | PrimaryContact |
sellingPlan | Detalhes 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:
- The selling partner must authorize you to call the Selling Partner API (SP-API) on their behalf. For details about how selling partners can authorize an application to call the SP-API on their behalf, refer to Authorizing Selling Partner API Applications.
- Your developer profile must include the Finance and Accounting role. To learn about roles, refer to Roles in the Selling Partner API.
- The app registration page for your application must include the Finance and Accounting role.
- The marketplace identifier of the marketplace for which you want data. For a list of marketplace identifiers, refer to Marketplace IDs.
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:
Nome | Descrição | Schema |
---|---|---|
marketplaceParticipationList | Uma 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
}
}
]
Updated about 2 months ago