Hub per sviluppatoriStato dell'APISupporto

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:

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à:

NomeDescrizioneSchema
businessInformazioni sull'attività del venditore. A seconda del venditore businessType, puoi omettere determinati campi.Business
businessTypeIl tipo di attività per cui è registrato l'account venditore.enum (BusinessType)
marketplaceParticipationListUn elenco delle partecipazioni al mercato.< MarketplaceParticipationList> array
primaryContactInformazioni sul contatto principale del venditore.PrimaryContact
sellingPlanDettagli 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:

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:

NomeDescrizioneSchema
marketplaceParticipationListUn 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 } } ]

Questa pagina ti è stata utile?