Dokumentation
Entwickler-HubAPI-StatusUnterstützung

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:
  • Das createReport Betrieb der Vertriebspartner-API für Berichte, wenn sie zur Anforderung der verwendet wird GET_BRAND_ANALYTICS_SEARCH_TERMS_REPORT melden. Dieser Bericht gibt Daten zu den ASINs zurück, auf die am häufigsten geklickt wurde, sortiert nach Suchbegriff und Abteilung für eine Marketplace-Site.
  • Das createReport Betrieb der Vertriebspartner-API für Berichte, wenn sie zur Anforderung der verwendet wird GET_PROMOTION_PERFORMANCE_REPORT melden. Dieser Bericht liefert Daten aus Werbekampagnen, um Anbietern und Verkäufern zu helfen, ihre Werbeaktionen zu optimieren und ihre Werbestrategien anzupassen.
Eine vollständige Liste der Vorgänge und der Feed-, Berichts- und Benachrichtigungstypen, die diese Rolle erfordern, finden Sie unter Markenanalyse.

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:
  • Das getCatalogItem Betrieb der Verkaufspartner-API für Katalogartikel, die Informationen über den angegebenen Artikel und seine Attribute zurückgibt.
  • Das createReport Betrieb der Vertriebspartner-API für Berichte, wenn sie zur Anforderung der verwendet wird GET_MERCHANT_LISTINGS_INACTIVE_DATA melden. Dieser Bericht gibt detaillierte inaktive Angebote zurück.
  • Das getMyFeesEstimateForSKU Betrieb der Vertriebspartner-API für Produktgebühren, die die geschätzten Gebühren für den angegebenen Artikel zurückgibt.
In der Produktauflistung finden Sie eine vollständige Liste der Vorgänge und der Feed-, Berichts- und Benachrichtigungstypen, die diese Rolle 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:
  • Das createFeed Betrieb der Vertriebspartner-API für Feeds, wenn sie zum Einreichen von RFQ_UPLOAD_FEED füttern. Auf diese Weise können Sie Mengenrabatte hochladen, um auf Anfragen von Geschäftskunden zu antworten.
  • Das getPricing Betrieb der Verkaufspartner-API für Preisinformationen, die Preisinformationen für die Angebotslisten eines Verkäufers zurückgibt.
  • Das createReport Betrieb der Vertriebspartner-API für Berichte, wenn sie zur Anforderung der verwendet wird GET_MERCHANT_CANCELLED_LISTINGS_DATA melden. Dieser Bericht gibt stornierte Angebote zurück.
Unter Preisgestaltung finden Sie eine vollständige Liste der Vorgänge und der Feed-, Berichts- und Benachrichtigungsarten, die diese Rolle 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:
  • Das createReport Betrieb der Vertriebspartner-API für Berichte, wenn sie zur Anforderung der verwendet wird GET_FBA_ESTIMATED_FBA_FEES_TXT_DATA melden. Dieser Bericht enthält geschätzte Verkaufs- und Versandgebühren von Amazon.
  • Das getSubscription Betrieb der Vertriebspartner-API für Benachrichtigungen, wenn sie zum Abonnieren von verwendet wird FBA_OUTBOUND_SHIPMENT_STATUS Benachrichtigungen. Diese Benachrichtigungen werden immer dann gesendet, wenn wir eine FBA-Lieferung für einen Verkäufer erstellen oder stornieren.
  • Das getLabels Betrieb der Vertriebspartner-API für eingehenden Versand, die Paket-/Palettenetiketten zurücksendet.
  • Das createFeed Betrieb der Vertriebspartner-API für Feeds, wenn sie zum Einreichen von POST_FBA_INBOUND_CARTON_CONTENTS füttern. Auf diese Weise können Sie Informationen zum Kartoninhalt einreichen, wenn Sie Inventar an das Versandnetzwerk von Amazon versenden.
Unter Versand durch Amazon finden Sie eine vollständige Liste der Vorgänge und der Feed-, Berichts- und Benachrichtigungsarten, die diese Rolle 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:
  • Das getMessagingActionsForOrder Betrieb der Vertriebspartner-API für Messaging, die eine Liste der für eine bestimmte Bestellung verfügbaren Nachrichtentypen zurückgibt.
  • Das createConfirmOrderDetails Betrieb der Vertriebspartner-API für Messaging, die eine Nachricht sendet, um einem Käufer vor dem Versand eine bestellungsbezogene Frage zu stellen.
  • Das createConfirmDeliveryDetails Betrieb der Vertriebspartner-API für Messaging, die eine Nachricht an einen Käufer sendet, um eine Lieferung zu arrangieren oder die Kontaktinformationen für die Lieferung zu bestätigen.
Unter Kommunikation mit dem Käufer finden Sie eine vollständige Liste der Vorgänge sowie der Feed-, Berichts- und Benachrichtigungstypen, für die diese Rolle erforderlich ist.

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:
  • Das getSolicitationActionsForOrder Betrieb der Vertriebspartner-API für Werbeanfragen, die eine Liste der für eine Bestellung verfügbaren Angebotsarten zurückgibt.
  • Das createProductReviewAndSellerFeedbackSolicitation Vorgang, bei dem ein Käufer um Feedback und eine Produktbewertung für eine Bestellung gebeten wird.
Unter Käuferwerbung finden Sie eine vollständige Liste der Vorgänge sowie der Feed-, Berichts- und Benachrichtigungstypen, für die diese Rolle erforderlich ist.

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:
  • Das createReport Betrieb der Vertriebspartner-API für Berichte, wenn sie zur Anforderung der verwendet wird GET_V1_SELLER_PERFORMANCE_REPORT melden. Dieser Bericht enthält einzelne Leistungskennzahlen aus dem Seller Central-Dashboard.
  • Das getMarketplaceParticipations Betrieb der Verkaufspartner-API für Verkäufer, die eine Liste von Marktplätzen, auf denen ein Verkäufer verkaufen kann, sowie Informationen über die Teilnahme des Verkäufers an diesen Marktplätzen zurückgibt.
Eine vollständige Liste der Vorgänge und der Feed-, Berichts- und Benachrichtigungstypen, die diese Rolle erfordern, finden Sie unter Einblicke für Verkaufspartner.

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:
  • Das getReports Betrieb der Vertriebspartner-API für Berichte, wenn sie verwendet wird, um eine Liste der GET_V2_SETTLEMENT_REPORT_DATA_FLAT_FILE Berichte erstellt.
  • Das getSubscription Betrieb der Vertriebspartner-API für Benachrichtigungen, wenn sie verwendet wird, um Informationen über Abonnements an die FEE_PROMOTION Art der Benachrichtigung.
Eine vollständige Liste der Vorgänge und der Feed-, Berichts- und Benachrichtigungsarten, die diese Rolle erfordern, finden Sie unter Finanzen und Buchhaltung.

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:
  • Das createReport Betrieb der Vertriebspartner-API für Berichte, wenn sie zur Anforderung der verwendet wird GET_MERCHANT_LISTINGS_DATA melden. Dieser Bericht gibt detaillierte aktive Angebote zurück.
  • Das createFeed Betrieb der Vertriebspartner-API für Feeds bei Verwendung zum Einreichen von POST_FLAT_FILE_FULFILLMENT_DATA füttern. Auf diese Weise können Sie Informationen zur Auftragsabwicklung an Amazon senden.
  • Das getOrderMetrics Betrieb der Vertriebspartner-API für den Vertrieb, die aggregierte Bestellkennzahlen zurückgibt.
Eine vollständige Liste der Vorgänge und der Feed-, Berichts- und Benachrichtigungstypen, die diese Rolle erfordern, finden Sie unter Lagerbestand und Bestellungsverfolgung.

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:
  • Das listInventory Betrieb der Vertriebspartner-API für Amazon Warehousing and Distribution, die Lagerbestände und -status für Produkte in AWD zurückgibt.
  • Das getInboundShipment Vorgang, bei dem Details zur Sendung wie Status und eingegangene Mengen zur Abstimmung zurückgegeben werden.
Beziehen Sie sich auf Lagerung und Vertrieb bei Amazon für eine vollständige Liste der Vorgänge und der Feed-, Berichts- und Benachrichtigungstypen, für die diese Rolle erforderlich ist.
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:
  • Das createNotification operation erstellt und sendet eine Benachrichtigung an Verkäufer mit Informationen, die für ihr Unternehmen relevant sind.
  • Das deleteNotifications operation löscht eine Benachrichtigung, die zuvor an einen Verkäufer gesendet wurde.
Eine vollständige Liste der Vorgänge, für die diese Rolle erforderlich ist, finden Sie im Benachrichtigungen in der Rolle „Seller Central“.
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:
  • Das getShipment Betrieb der Vertriebspartner-API für Merchant Fulfillment, die Sendungsinformationen für eine bestimmte Sendung zurückgibt.
  • Das getOrders Betrieb der Vertriebspartner-API für Bestellungen, die eine Liste von Bestellungen und Bestellinformationen auf der Grundlage der angegebenen Kriterien zurückgibt.
  • Das createReport Betrieb der Vertriebspartner-API für Berichte, wenn sie zur Anforderung der verwendet wird GET_FLAT_FILE_ ORDER_REPORT_DATA_SHIPPING melden.
  • Das createFeed Betrieb der Vertriebspartner-API für Feeds, wenn sie zum Einreichen von POST_ORDER_FULFILLMENT_DATA füttern. Dieser Feed ermöglicht es Ihrem System, das System von Amazon mit Informationen zur Auftragsabwicklung zu aktualisieren.
Eine vollständige Liste der Vorgänge und der Feed-, Berichts- und Benachrichtigungstypen, die diese Rolle erfordern, finden Sie unter Direktversand an Verbraucher (Eingeschränkt).

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:
  • Das createReport Betrieb der Vertriebspartner-API für Berichte, wenn sie zur Anforderung der verwendet wird GET_AMAZON_FULFILLED_SHIPMENTS_INVOICING melden. Dieser Bericht enthält detaillierte Bestell-/Versand-/Artikelinformationen.
  • Das getOrderAddress Betrieb der Verkaufspartner-API für Bestellungen, die die Lieferadresse für eine Bestellung zurückgibt.
  • Das getOrderBuyerInfo Betrieb der Verkaufspartner-API für Bestellungen, die Käuferinformationen für eine Bestellung zurückgibt.
  • Das createReport Betrieb der Vertriebspartner-API für Berichte, wenn sie zur Anforderung der verwendet wird GET_EASYSHIP_DOCUMENTS melden. Dieser Bericht enthält die Rechnung, das Versandetikett und die Garantiedokumente für eine Easy Ship-Bestellung.
Eine vollständige Liste der Vorgänge und der Feed-, Berichts- und Benachrichtigungsarten, die diese Rolle erfordern, finden Sie unter Steuerrechnung (Eingeschränkt).
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:
  • Das createReport Betrieb der Vertriebspartner-API für Berichte, wenn sie zur Anforderung der verwendet wird GET_AMAZON_FULFILLED_SHIPMENTS_REMITTANCE melden. Dieser Bericht enthält detaillierte Bestell-/Versand-/Artikelinformationen.
  • Das getOrderItems Betrieb der Vertriebspartner-API für Bestellungen, die detaillierte Artikelinformationen zu einer Bestellung zurückgibt.
  • Das getOrders Betrieb der Vertriebspartner-API für Bestellungen, die eine Liste mit Bestellartikelinformationen für einen bestimmten Zeitraum und eine Reihe von Kriterien zurückgibt.
Eine vollständige Liste der Vorgänge und der Feed-, Berichts- und Benachrichtigungsarten, die diese Rolle erfordern, finden Sie unter Steuerüberweisung (eingeschränkt).
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:
  • Das getServiceJobs Betrieb der Vertriebspartner-API für Dienstleistungen, die eine Liste mit Serviceauftragsdetails für die angegebene Filterabfrage zurückgibt.
  • Das addAppointmentForServiceJobByServiceJobId Vorgang, der dem Servicejob, der durch die angegebene Servicejob-ID angegeben ist, einen Termin hinzufügt.
Beziehen Sie sich auf Professionelle Dienstleistungen für eine vollständige Liste der Vorgänge und der Feed-, Berichts- und Benachrichtigungstypen, für die diese Rolle erforderlich ist.

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:

  1. Gehen Sie zu Ihrem Entwicklerprofil und reichen Sie eine Rolle ein, die hinzugefügt werden soll.
  2. 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.
  3. 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.

Hat Ihnen diese Seite weitergeholfen?