Rollen in der Verkaufspartner-API
Erfahren Sie, wie Sie Rollen in der Verkaufspartner-API verwenden.
Was ist eine Rolle?
Eine Rolle ist der Mechanismus, der von den Verkaufspartner-APIs verwendet wird, um festzustellen, ob ein Entwickler oder eine Anwendung Zugriff auf einen Vorgang oder eine Ressource hat. Als Entwickler müssen Sie eine bestimmte Rolle beantragen und sich für diese qualifizieren, sonst können Sie nicht auf die unter dieser Rolle zusammengefassten Vorgänge und Ressourcen zugreifen. Rollen schützen den Zugriff auf Personenbezogene Daten (PII) und andere sensible Daten und schränken den Datenzugriff ein, um sicherzustellen, dass Entwickler nur auf Daten zugreifen, die für eine Anwendung erforderlich sind. Dies trägt dazu bei, dass die Kunden Amazon und den Unternehmen der Verkaufspartner-APIs vertrauen.
Rollendefinitionen
In der folgenden Tabelle bedeutet Eingeschränkt, dass die Rolle sensible Daten erfordert, die Personenbezogene Daten (PII) enthalten können. Sie werden aufgefordert, zusätzliche Informationen über Ihre Verwendung der Daten und Ihre Sicherheitskontrollen bereitzustellen.
Rolle | Beschreibung |
---|---|
Markenanalyse | Greifen Sie auf Berichte zu, die Informationen über die Leistung von Verkäufern und Anbietern auf Amazon enthalten, sowie auf Berichte zum Verbraucherverhalten, die Aufschluss darüber geben, wie Kunden die Produkte eines Verkaufspartners auf Amazon finden und kaufen. Beispiele für Vorgänge, die diese Rollenzuweisung erfordern:
|
Produktauflistung | Erstellen und verwalten Sie Produktauflistungen. Wird im Allgemeinen für produktkatalogbezogene Berichte und Feeds sowie für Operationen verwendet. Beispiele für Vorgänge, die diese Rollenzuweisung erfordern:
|
Preisgestaltung | Ermitteln Sie Listenpreise und automatisieren Sie die Preisgestaltung von Produkten. Wird im Allgemeinen für preisbezogene Berichte, Feeds und Vorgänge verwendet. Beispiele für Vorgänge, die diese Rollenzuweisung erfordern:
|
Versand durch Amazon | Versand an Amazon und Amazon liefert direkt an die Kunden (Versand durch Amazon (FBA), Versand durch Amazon-Versandnetzwerk (AFN)). Wird im Allgemeinen für FBA-Verkaufsberichte, Berichte zur Auftragsverfolgung und Vorgänge im Zusammenhang mit der Erfüllung von Bestellungen verwendet. Beispiele für Vorgänge, die diese Rollenzuweisung erfordern:
|
Kommunikation mit dem Käufer | Verwalten Sie Nachrichten an und von Amazon-Käufern. Wird in der Regel für Nachrichten an Amazon-Käufer unter Verwendung der Verkaufspartner-API für Nachrichten verwendet. Beispiele für Vorgänge, die diese Rollenzuweisung erfordern:
|
Käuferwerbung | Fordern Sie Amazon-Käufer zu Bewertungen auf. Wird in der Regel verwendet, um Amazon-Käufer über die Verkaufspartner-API für Anwerbungen um Feedback zu bitten. Beispiele für Vorgänge, die diese Rollenzuweisung erfordern:
|
Einblicke für Verkaufspartner | Zeigen Sie Informationen über das Konto und die Leistung des Amazon Verkaufspartners an. Wird in der Regel für Berichte und Vorgänge verwendet, die Einblicke in Verkäufer liefern. Beispiele für Vorgänge, die diese Rollenzuweisung erfordern:
|
Finanzen und Buchhaltung | Buchhaltungs- und Jahresabschlüsse erstellen. Wird im Allgemeinen zur Erstellung von Buchhaltungs- und Jahresabschlüssen verwendet. Beispiele für Vorgänge, für die diese Rollenzuweisung erforderlich ist:
|
Lagerbestand und Bestellverfolgung | Analysieren und verwalten Sie den Lagerbestand. Wird in der Regel für FBA-Verkaufsberichte, Auftragsverfolgungsberichte und Vorgänge im Zusammenhang mit Bestellungen, Anbieterbestellungen, Auftragsmetriken und Bestandsverwaltung verwendet. Vorgänge, die diese Rolle erfordern, verwenden keine Personenbezogenen Daten, die für den Versand einer Bestellung erforderlich sind. Vielmehr ist diese Rolle für Anwendungen erforderlich, die den Versand von Bestellungen verfolgen, um den Bestand/die Herstellung/die Beschaffung zu verwalten. Beispiele für Vorgänge, die diese Rollenzuweisung erfordern:
|
Lagerung und Vertrieb bei 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:
|
Benachrichtigungen 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:
|
Dienstleister für Zahlungsauslösung | Ermöglicht die Initiierung einer Auszahlung über die vom Verkäufer angegebene Einzahlungsmethode und die Erstattung (Anpassung) für eine Bestellung. Sie können die Rolle Payment Initiation Service Provider (PISP) verwenden, um die Zahlungsmethoden für den Verkäufer anzuzeigen. Eine vollständige Liste der Vorgänge und der Feed-, Berichts- und Benachrichtigungstypen, für die diese Rolle erforderlich ist, finden Sie unter Dienstleister für die Zahlungsauslösung. Informationen zur Registrierung von Entwicklern durch Drittanbieter finden Sie unter Registrierung eines Drittanbieters. |
Anbieter von Kontoinformationsdiensten | Stellt Informationen zum Amazon-Verkaufspartnerkonto bereit, einschließlich Informationen über das Geschäft des Verkäufers und die Marktplätze, auf denen das Verkäuferkonto aktiv ist. Sie können die Rolle des Kontoinformationsdienstanbieters (AISP) verwenden, um Zahlungsmethoden und finanzielle Ereignisse für den Verkäufer einzusehen. Eine vollständige Liste der Vorgänge und der Feed-, Berichts- und Benachrichtigungstypen, für die diese Rolle erforderlich ist, finden Sie unter Dienstanbieter für Kontoinformationen. Informationen zur Registrierung von Entwicklern durch Drittanbieter finden Sie unter Registrierung eines Drittanbieters. |
Direktversand an den Verbraucher (Eingeschränkt) | Versenden Sie Bestellungen direkt an Kunden mit dem Versandunternehmen Ihrer Wahl, einschließlich Amazon. Vorgänge, die diese Rolle erfordern, verwenden Personenbezogene Daten, um den Versand zu ermöglichen. Wird in der Regel für Bestellberichte, Berichte zur Bestellverfolgung, EasyShip und für Vorgänge im Zusammenhang mit dem Versand von Bestellungen bei Amazon verwendet. Beispiele für Vorgänge, die diese Rollenzuweisung erfordern:
|
Steuerliche Rechnungsstellung (Eingeschränkt) | Steuerrechnungen generieren, um die Steuervorschriften einzuhalten. Vorgänge, die diese Rolle erfordern, benötigen Personenbezogene Daten, um die Erstellung von Steuerrechnungen zu ermöglichen. Wird im Allgemeinen für Steuer- und Bestellberichte sowie für Vorgänge verwendet, die Informationen über Bestellungen liefern. Beispiele für Vorgänge, die diese Rollenzuweisung erfordern:
|
Steuerüberweisung (Eingeschränkt) | 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:
|
Professionelle Dienstleistungen (Eingeschränkt) | 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:
|
Häufig gestellte Fragen
Wie kann ich mich für eine Rolle bewerben und qualifizieren?
Sie beantragen und qualifizieren sich für Rollen in der Vertriebspartner-API, indem Sie Ihr Entwicklerprofil ausfüllen. Welche spezifischen Informationen angefordert werden, hängt davon ab, ob Sie sich zuvor registriert haben.
Sobald Ihr Profil übermittelt wurde, prüft Amazon die bereitgestellten Informationen und genehmigt oder verweigert Ihre Anfrage. Wenn Ihr Antrag abgelehnt wird, können Sie den Grund für die Ablehnung angeben und Ihr Profil erneut einreichen.
Wie wähle ich die Rollen für meine Anwendung aus?
Wenn Sie Ihre Verkaufspartner-API-Anwendung auf der Seite zur Erstellung des Anwendungsclients erstellen, können Sie Rollen aus denjenigen auswählen, die in Ihrem Entwicklerprofil angefordert und genehmigt wurden. Wenn die von Ihnen benötigte Rolle fehlt, müssen Sie die Rollen in Ihrem Entwicklerprofil aktualisieren, um sie aufzunehmen, und dann Ihr Profil erneut zur Bewertung durch Amazon einreichen. Nach der Genehmigung steht die hinzugefügte Rolle für Ihre Anwendung zur Auswahl.
Hinweis: Wenn Sie eine hybride SP-API-Anwendung veröffentlicht haben, müssen Sie Ihre Anwendung vor der erneuten Autorisierung erneut auflisten.
Wie lege ich fest, welche Rollen ich anfordern soll?
Lesen Sie die Rollenbeschreibungen in diesem Dokument, um den Zweck jeder Rolle zu verstehen und um Beispiele für die Ressourcen und Vorgänge zu sehen, die von jeder Rolle gesteuert werden. Verwenden Sie für jede Rolle den angegebenen Link, um zur Dokumentation zu navigieren, die eine vollständige Liste der Vorgänge und der Feed-, Berichts- und Benachrichtigungstypen enthält, für die die Rolle erforderlich ist.
Was passiert, wenn ich einen Vorgang aufrufe, für den ich nicht die erforderliche(n) Rolle(n) habe?
Die Antwort auf die Anfrage hat einen HTTP-Statuscode von 403 und Fehlerinformationen im Antwortkörper.
Wie kann ich eine neue Rolle hinzufügen, nachdem meine App veröffentlicht wurde?
So fügen Sie eine neue Rolle hinzu, nachdem Ihre App veröffentlicht wurde:
- Gehen Sie zu Ihrem Entwicklerprofil und reichen Sie eine Rolle ein, die hinzugefügt werden soll.
- Sobald Ihr Entwicklerprofil genehmigt wurde, gehen Sie zur Konfiguration Ihrer Anwendung und übernehmen die neu genehmigte Rolle für Ihre Anwendung. Speichern Sie die Änderungen und nehmen Sie die Anwendung erneut in die Auflistung auf.
- Nachdem die Anwendung genehmigt wurde, generieren Sie mit neue Berechtigungen ein neues Aktualisierungstoken, das den Zugriff auf die API-Vorgänge, Berichte, Feeds und Benachrichtigungen gewährt, die von der neuen Rolle bereitgestellt werden.
Updated 27 days ago