Hub per sviluppatoriStato dell'APISupporto

Ruoli nell'API per i partner di vendita

Scopri come utilizzare i ruoli nell'API Selling Partner.

Che cos'è un ruolo?

Un ruolo è il meccanismo utilizzato dall'API per i partner di vendita per determinare se uno sviluppatore o un'applicazione ha accesso a un'operazione o a una risorsa. In qualità di sviluppatore, devi richiedere e qualificarti per un ruolo particolare, altrimenti non sarai in grado di accedere alle operazioni e alle risorse raggruppate in quel ruolo. I ruoli proteggono l'accesso alle informazioni di identificazione personale (PII) e ad altri dati sensibili, nonché limitano l'accesso ai dati per garantire che gli sviluppatori accedano solo ai dati necessari per un'applicazione. Questo aiuta a garantire che i clienti si fidino di Amazon e delle aziende di Selling Partner Services che utilizzano l'API per i partner di vendita.

Definizioni dei ruoli

Nella tabella seguente, il termine Con restrizioni indica che il ruolo richiede informazioni sensibili che possono includere informazioni di identificazione personale (PII). Ti verrà richiesto di fornire informazioni aggiuntive sull'utilizzo dei dati e sui controlli di sicurezza.

Ruolo Descrizione
Brand Analytics Accedi ai report che contengono informazioni sulle prestazioni di venditori e fornitori su Amazon e ai report sul comportamento dei consumatori che forniscono informazioni su come i clienti trovano e acquistano i prodotti di un partner di vendita su Amazon. Esempi di operazioni che richiedono questa assegnazione di ruolo:
  • Le createReport funzionamento della Selling Partner API for Reports, se utilizzata per richiedere GET_BRAND_ANALYTICS_SEARCH_TERMS_REPORT rapporto. Questo rapporto restituisce i dati sugli ASIN più cliccati per parola chiave di ricerca e reparto per un marketplace.
  • Le createReport funzionamento della Selling Partner API for Reports, se utilizzata per richiedere GET_PROMOTION_PERFORMANCE_REPORT rapporto. Questo rapporto restituisce i dati delle campagne promozionali per aiutare fornitori e venditori a ottimizzare le promozioni e ad adattare le strategie pubblicitarie.
Refer to Brand Analytics for a complete list of the operations and the feed, report, and notification types that require this role.

Offerta dei prodotti Crea e gestisci offerte di prodotti. Di solito viene utilizzato per report e feed relativi al catalogo dei prodotti e per le operazioni. Esempi di operazioni che richiedono questa assegnazione di ruolo:
  • Le getCatalogItem funzionamento della Selling Partner API for Catalog Items, che restituisce informazioni sull'articolo indicato e sui suoi attributi.
  • Le createReport funzionamento della Selling Partner API for Reports, se utilizzata per richiedere il GET_MERCHANT_LISTINGS_INACTIVE_DATA rapporto. Questo rapporto restituisce elenchi dettagliati inattivi.
  • Le getMyFeesEstimateForSKU funzionamento della Selling Partner API for Product Fees, che restituisce le commissioni stimate per l'articolo indicato.
Refer to Product Listing for a complete list of the operations and the feed, report, and notification types that require this role.

Prezzi Stabilisci i prezzi di listino e automatizza la determinazione dei prezzi dei prodotti. Di solito viene utilizzato per report, feed e operazioni relative ai prezzi. Esempi di operazioni che richiedono questa assegnazione di ruolo:
  • Le createFeed funzionamento dell'API Selling Partner per i feed quando viene utilizzata per inviare un RFQ_UPLOAD_FEED alimentazione. Ciò consente di caricare sconti sulla quantità in risposta alle richieste dei clienti aziendali.
  • Le getPricing funzionamento della Selling Partner API for Pricing, che restituisce le informazioni sui prezzi per le inserzioni delle offerte di un venditore.
  • Le createReport funzionamento della Selling Partner API for Reports, se utilizzata per richiedere il GET_MERCHANT_CANCELLED_LISTINGS_DATA rapporto. Questo rapporto riporta le inserzioni annullate.
Refer to Pricing for a complete list of the operations and the feed, report, and notification types that require this role.

Logistica di Amazon Spedisci ad Amazon e Amazon spedisce direttamente ai clienti (Logistica di Amazon (FBA), Rete logistica di Amazon (AFN)). Di solito viene utilizzato per report sulle vendite Logistica di Amazon, i report sul monitoraggio degli ordini e le operazioni relative alla gestione logistica degli ordini. Esempi di operazioni che richiedono questa assegnazione di ruolo:
  • Le createReport funzionamento della Selling Partner API for Reports, se utilizzata per richiedere GET_FBA_ESTIMATED_FBA_FEES_TXT_DATA rapporto. Questo rapporto contiene le commissioni di vendita e gestione stimate di Amazon.
  • Le getSubscription funzionamento della Selling Partner API for Notifications se utilizzata per abbonarsi a FBA_OUTBOUND_SHIPMENT_STATUS notifiche. Queste notifiche vengono inviate ogni volta che creiamo o annulliamo una spedizione FBA per un venditore.
  • Le getLabels funzionamento della Selling Partner API for Fulfillment Inbound, che restituisce le etichette dei pacchi/pallet.
  • Le createFeed funzionamento dell'API Selling Partner per i feed quando viene utilizzata per inviare un POST_FBA_INBOUND_CARTON_CONTENTS alimentazione. Ciò ti consente di inviare informazioni sul contenuto dei pacchi quando spedisci l'inventario alla rete logistica di Amazon.
Refer to Amazon Fulfillment for a complete list of the operations and the feed, report, and notification types that require this role.

Comunicazione con l'acquirente Gestisci i messaggi da e verso gli acquirenti Amazon. Di solito viene utilizzato per inviare messaggi agli acquirenti di Amazon utilizzando l'API per i partner di vendita per la messaggistica. Esempi di operazioni che richiedono questa assegnazione di ruolo:
  • Le getMessagingActionsForOrder funzionamento della Selling Partner API for Messaging, che restituisce un elenco di tipi di messaggi disponibili per un ordine specificato.
  • Le createConfirmOrderDetails funzionamento della Selling Partner API for Messaging, che invia un messaggio per porre all'acquirente una domanda relativa all'ordine prima della spedizione.
  • Le createConfirmDeliveryDetails funzionamento della Selling Partner API for Messaging, che invia un messaggio a un acquirente per organizzare una consegna o confermare le informazioni di contatto per effettuare una consegna.
Refer to Buyer Communication for a complete list of the operations and the feed, report, and notification types that require this role.

Sollecitazione dell'acquirente Richiedi un feedback agli acquirenti Amazon. Di solito viene utilizzato per sollecitare il feedback degli acquirenti Amazon utilizzando l'API per i partner di vendita per le sollecitazioni. Esempi di operazioni che richiedono questa assegnazione di ruolo:
  • Le getSolicitationActionsForOrder funzionamento della Selling Partner API for Solicitations, che restituisce un elenco dei tipi di sollecitazione disponibili per un ordine.
  • Le createProductReviewAndSellerFeedbackSolicitation operazione, che invia una richiesta a un acquirente chiedendo un feedback e una recensione del prodotto per un ordine.
Refer to Buyer Solicitation for a complete list of the operations and the feed, report, and notification types that require this role.

Informazioni sui partner di vendita Visualizza informazioni sul rendimento dell'account per i partner di vendita Amazon. Di solito viene utilizzato per i report e le operazioni utilizzate per restituire informazioni sui venditori. Esempi di operazioni che richiedono questa assegnazione di ruolo:
  • Le createReport funzionamento della Selling Partner API for Reports, se utilizzata per richiedere GET_V1_SELLER_PERFORMANCE_REPORT rapporto. Questo rapporto contiene metriche di performance individuali tratte dal pannello di controllo di Seller Central.
  • Le getMarketplaceParticipations funzionamento della Selling Partner API for Sellers, che restituisce un elenco di marketplace in cui un venditore può effettuare vendite e informazioni sulla partecipazione del venditore a tali marketplace.
Refer to Selling Partner Insights for a complete list of the operations and the feed, report, and notification types that require this role.

Finanza e contabilità Elabora rendiconti contabili e finanziari. Di solito viene utilizzato per la creazione di rendiconti contabili e finanziari. Esempi di operazioni che richiedono questa assegnazione di ruolo:
  • Le getReports funzionamento della Selling Partner API for Reports, se utilizzata per restituire un elenco di GET_V2_SETTLEMENT_REPORT_DATA_FLAT_FILE report creati.
  • Le getSubscription funzionamento della Selling Partner API for Notifications, se utilizzata per restituire informazioni sugli abbonamenti al FEE_PROMOTION tipo di notifica.
Refer to Finance and Accounting for a complete list of the operations and the feed, report, and notification types that require this role.

Inventario e monitoraggio degli ordini Analizza e gestisce l'inventario. Di solito, viene utilizzato per i report sulle vendite Logistica di Amazon, i report di monitoraggio degli ordini e le operazioni relative a ordini, ordini dei fornitori, metriche degli ordini di vendita e gestione dell'inventario. Le operazioni che richiedono questo ruolo non utilizzano le PII necessarie per spedire un ordine. Piuttosto, questo ruolo è necessario per le applicazioni che tracciano le spedizioni degli ordini per gestire inventario/produzione/acquisti. Esempi di operazioni che richiedono questa assegnazione di ruolo:
  • Le createReport funzionamento della Selling Partner API for Reports, se utilizzata per richiedere GET_MERCHANT_LISTINGS_DATA rapporto. Questo rapporto restituisce elenchi attivi dettagliati.
  • Le createFeed funzionamento dell'API Selling Partner per i feed quando viene utilizzata per inviare un POST_FLAT_FILE_FULFILLMENT_DATA alimentazione. Ciò ti consente di inviare le informazioni sull'evasione degli ordini ad Amazon.
  • Le getOrderMetrics funzionamento della Selling Partner API for Sales, che restituisce le metriche aggregate degli ordini.
Refer to Inventory and Order Tracking for a complete list of the operations and the feed, report, and notification types that require this role.

Magazzinaggio e distribuzione Amazon Analyze and manage Amazon Warehousing and Distribution shipments and inventory. Generally used for interacting with AWD inventory information and shipment details using the Selling Partner API for Amazon Warehousing and Distribution. Examples of operations that require this role assignment:
  • The listInventory operation of the Selling Partner API for Amazon Warehousing and Distribution, which returns inventory levels and states for products in AWD.
  • The getInboundShipment operation, which returns details about the shipment such as status and received quantities for reconciliation.
Refer to Amazon Warehousing and Distribution for a complete list of the operations and the feed, report, and notification types that require this role.
Notifiche in Seller Central Send targeted notifications to sellers within Seller Central. Using the App Integrations API v2024-04-01, you can send notifications that inform the seller about their business or to encourage the seller to take action on your website. Examples of operations that require this role assignment:
  • The createNotification operation creates and sends a notification to sellers with information relevant to their business.
  • The deleteNotifications operation deletes a notification that was previously sent to a seller.
For a complete list of the operations that require this role, refer to the Notifications in Seller Central role.
Fornitore di servizi di avvio del pagamento Allows the initiation of a payout to the seller’s deposit method and the issuance of a refund (adjustment) for an order. You can use the Payment Initiation Service Provider (PISP) role to view payment methods for the seller.
For a complete list of the operations and the feed, report, and notification types that require this role, refer to Payment Initiation Service Provider.
For information about third-party provider developer registration, refer to Third-Party Provider Registration.
Fornitore di servizi di informazioni sull'account Provides information about the Amazon Selling Partner account, including information about the seller’s business and the marketplaces where the seller account is active. You can use the Account Information Service Provider (AISP) role to view payment methods and financial events for the seller.
For a complete list of the operations and the feed, report, and notification types that require this role, refer to Account Information Service Provider.
For information about third-party provider developer registration, refer to Third-Party Provider Registration.
Spedizione diretta al consumatore (con restrizioni) Spedisci gli ordini direttamente ai clienti utilizzando il corriere di loro scelta, incluso Amazon. Le operazioni che richiedono questo ruolo utilizzano le PII per abilitare la spedizione. Di solito viene utilizzato per i report sugli ordini, i report di monitoraggio degli ordini, EasyShip e per le operazioni relative alla spedizione degli ordini effettuati su Amazon. Esempi di operazioni che richiedono questa assegnazione di ruolo:
  • Le getShipment funzionamento della Selling Partner API for Merchant Fulfillment, che restituisce le informazioni sulla spedizione per una spedizione specificata.
  • Le getOrders funzionamento della Selling Partner API for Orders, che restituisce un elenco di ordini e informazioni sugli ordini in base ai criteri specificati.
  • Le createReport funzionamento della Selling Partner API for Reports, se utilizzata per richiedere GET_FLAT_FILE_ ORDER_REPORT_DATA_SHIPPING rapporto.
  • Le createFeed funzionamento della Selling Partner API for Feeds, se utilizzata per inviare un POST_ORDER_FULFILLMENT_DATA alimentazione. Questo feed consente al tuo sistema di aggiornare il sistema di Amazon con le informazioni sull'evasione degli ordini.
Refer to Direct-to-Consumer Shipping (Restricted) for a complete list of the operations and the feed, report, and notification types that require this role.

Fatturazione fiscale (con restrizioni) Genera fatture fiscali conformi alle normative fiscali. Le operazioni che richiedono questo ruolo richiedono informazioni di identificazione personale (PII) per consentire la generazione di fatture fiscali. Di solito, viene utilizzata per i report fiscali e gli ordini e per le operazioni che restituiscono informazioni sugli ordini. Esempi di operazioni che richiedono questa assegnazione di ruolo:
  • Le createReport funzionamento della Selling Partner API for Reports, se utilizzata per richiedere GET_AMAZON_FULFILLED_SHIPMENTS_INVOICING rapporto. Questo rapporto riporta informazioni dettagliate su ordine/spedizione/articolo.
  • Le getOrderAddress funzionamento della Selling Partner API for Orders, che restituisce l'indirizzo di spedizione di un ordine.
  • Le getOrderBuyerInfo funzionamento della Selling Partner API for Orders, che restituisce le informazioni sull'acquirente relative a un ordine.
  • Le createReport funzionamento della Selling Partner API for Reports, se utilizzata per richiedere il GET_EASYSHIP_DOCUMENTS rapporto. Questo rapporto contiene la fattura, l'etichetta di spedizione e i documenti di garanzia per un ordine Easy Ship.
Refer to Tax Invoicing (Restricted) for a complete list of the operations and the feed, report, and notification types that require this role.
Versamento delle imposte (con restrizioni) Calculate and remit sales taxes. Operations that require this role might use PII to calculate sales taxes. Generally used for FBA Sales Reports and Order Reports and operations that return information about orders. Examples of operations that require this role assignment:
  • Le createReport funzionamento della Selling Partner API for Reports, se utilizzata per richiedere GET_AMAZON_FULFILLED_SHIPMENTS_REMITTANCE rapporto. Questo rapporto riporta informazioni dettagliate su ordine/spedizione/articolo.
  • Le getOrderItems funzionamento della Selling Partner API for Orders, che restituisce informazioni dettagliate sugli articoli relativi a un ordine.
  • Le getOrders funzionamento della Selling Partner API for Orders, che restituisce un elenco di informazioni sugli articoli dell'ordine per un periodo di tempo e una serie di criteri.
Refer to Tax Remittance (Restricted) for a complete list of the operations and the feed, report, and notification types that require this role.
Servizi professionali (Limitato) Provides add-on services such as Room of Choice Delivery, Assembly and Installation to Amazon buyers. Generally used to provide add-on services to Amazon buyers using the Selling Partner API for Services. Examples of operations that require this role assignment:
  • Le getServiceJobs funzionamento della Selling Partner API for Services, che restituisce un elenco di dettagli del lavoro di assistenza per la query di filtro specificata.
  • Le addAppointmentForServiceJobByServiceJobId operazione, che aggiunge un appuntamento al lavoro di assistenza indicato dall'identificativo del lavoro di servizio specificato.
Refer to Professional Services for a complete list of the operations and the feed, report, and notification types that require this role.

Domande frequenti

Come posso richiedere e qualificarmi per un ruolo?

Puoi richiedere e qualificarti per i ruoli di Selling Partner API compilando il tuo profilo sviluppatore. Le informazioni specifiche richieste dipendono dal fatto che tu ti sia registrato in precedenza.

Una volta inviato il tuo profilo, Amazon valuta le informazioni fornite e approva o rifiuta la tua richiesta. In caso di rifiuto, puoi analizzare il motivo del rifiuto e quindi inviare nuovamente il tuo profilo.

Come faccio a scegliere i ruoli per la mia applicazione?

Quando crei la tua applicazione API per i partner di vendita nella pagina di creazione del client dell'applicazione, puoi scegliere i ruoli tra quelli richiesti e approvati nel tuo profilo sviluppatore. Se il ruolo che ti serve non è presente, devi aggiornare i ruoli nel tuo profilo sviluppatore per includerlo, quindi inviare nuovamente il profilo per la valutazione da parte di Amazon. Una volta approvato, il ruolo aggiunto sarà disponibile per essere selezionato per la tua applicazione.

Nota: se disponi di un'applicazione SP-API ibrida pubblicata, devi ripubblicarla prima di riautorizzarla.

Come faccio a determinare quali ruoli richiedere?

Rivedi le descrizioni dei ruoli in questo documento per comprenderne ogni singolo scopo e per vedere esempi delle risorse e delle operazioni regolate da ciascun ruolo. Per ogni ruolo, utilizza il link fornito per accedere alla documentazione che fornisce un elenco completo delle operazioni e dei tipi di feed, dei report e delle notifiche che richiedono questo ruolo.

Cosa succede quando chiamo un'operazione per la quale non ho i ruoli richiesti?

La risposta alla richiesta avrà un codice di stato HTTP 403 e informazioni di errore nel corpo della risposta.

Come faccio ad aggiungere un nuovo ruolo dopo la pubblicazione della mia app?

Per aggiungere un nuovo ruolo dopo la pubblicazione dell'app, procedi nel seguente modo:

  1. Go to your developer profile and submit a role to be added.
  2. After your developer profile is approved, go to your application configuration and apply the newly approved role to your application. Save the changes and re-list the application.
  3. After the application is approved, get new authorizations to generate a new refresh token that will grant access to the API operations, reports, feeds and notifications the new role will provide.

Questa pagina ti è stata utile?