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:
|
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:
|
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:
|
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:
|
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:
|
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:
|
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:
|
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:
|
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:
|
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:
|
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:
|
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:
|
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:
|
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:
|
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:
|
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:
- Go to your developer profile and submit a role to be added.
- 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.
- 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.
Updated 27 days ago