Guida ai casi d'uso dell'API v1 per venditori
Recupera le informazioni sull'account venditore e sul marketplace.
Versione API: V1
Cos'è l'API Sellers?
The Selling Partner API for Sellers (Sellers API) provides information about seller accounts and marketplaces. The returned information includes:
- I marketplace in cui il venditore può mettere in vendita gli articoli
- La lingua e la valuta predefinite di un marketplace
- Se il venditore ha sospeso le offerte
- Informazioni commerciali del venditore
For details about the operations, data types, and schemas of the Sellers API, refer to Sellers API v1 Reference.
Tutorial: Ottieni le informazioni sull'account di un venditore (solo UE)
Scopri come recuperare i dati dell'account di un venditore. Le informazioni che recuperi includono un elenco di partecipazioni al marketplace, informazioni commerciali e dettagli del piano di vendita. È disponibile solo nella regione UE.
Prerequisiti
Per completare questo tutorial, è necessario completare i seguenti prerequisiti:
- 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.
Ottieni informazioni sull'account
Call the getAccount
operation.
Parametri della richiesta
Nessuna.
Esempio di richiesta
GET /sellers/v1/account
Proprietà della risposta
Una risposta con esito positivo include la seguente proprietà:
Nome | Descrizione | Schema |
---|---|---|
business | Informazioni sull'attività del venditore. A seconda del venditore businessType , puoi omettere determinati campi. | Business |
businessType | Il tipo di attività per cui è registrato l'account venditore. | enum (BusinessType ) |
marketplaceParticipationList | Un elenco delle partecipazioni al mercato. | < MarketplaceParticipationList > array |
primaryContact | Informazioni sul contatto principale del venditore. | PrimaryContact |
sellingPlan | Dettagli del piano di vendita. | enum (SellingPlan ) |
Esempio di risposta
{
"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: Ottieni la partecipazione al mercato di un venditore
Scopri come ottenere un elenco di marketplace Amazon in cui il venditore può pubblicare articoli. Le informazioni che recuperi includono informazioni sul marketplace, il nome del negozio del venditore nel marketplace, se il venditore partecipa al marketplace e se ha sospeso le offerte sul marketplace.
Prerequisiti
Per completare questo tutorial, è necessario completare i seguenti prerequisiti:
- 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.
Ottieni la partecipazione al marketplace
Call the getMarketplaceParticipations
operation.
Parametri della richiesta
Nessuna.
Esempio di richiesta
GET /sellers/v1/marketplaceParticipations
Risposta
Una risposta corretta include i seguenti elementi:
Nome | Descrizione | Schema |
---|---|---|
marketplaceParticipationList | Un elenco di marketplace Amazon in cui il venditore può pubblicare articoli e i clienti possono visualizzare e acquistare articoli. | < MarketplaceParticipationList > array |
Esempio di risposta
[
{
"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