Häufig gestellte Fragen zu APIs für Angebote

Items show as restricted if you don’t have access to the product type. If you have access issues, reach out to your vendor manager or Contact Us, making sure to specify that your issue is an API inquiry.

Preiserhöhungen für bestehende Artikel sind per API nicht möglich. Signifikante Preissenkungen müssen ebenfalls überprüft werden. Wenden Sie sich in diesem Fall an Ihren Lieferantenmanager oder öffnen Sie eine Kontaktiere uns Fall. Laden Sie dann Ihre Kostenänderungen hoch über Items > Edit Item Costs.

In einigen Grenzfällen hat sich das Schema möglicherweise geändert und die ursprünglichen Werte, die ein Anbieter eingereicht hat, sind nicht mehr gültig. Wenn dies der Fall ist, bitten Sie den Anbieter, eine Anfrage an das Amazon-Supportteam zu senden.

A+-Premium-Inhalte werden nicht unterstützt.

Die APIs bieten eine alternative Methode zum Senden von Katalogdaten an Amazon. Der nachfolgende Prozess und die Regeln für Katalogdaten sind unabhängig von der Einreichungsmethode identisch. In einigen Fällen, insbesondere wenn wir bereits ein Angebot für ein Produkt haben, haben die von einem Anbieter eingereichten Informationen möglicherweise keine Priorität.

Die Übersichtsansicht ist eine Zusammenfassung der ASIN, für die Sie ein Angebot erstellen. Wenn die Übersichtsansicht nicht ausgefüllt ist, liegt das daran, dass die Einreichung fehlgeschlagen ist und keiner ASIN entspricht. Stellen Sie sicher, dass Sie das Schema und das Format für Ihren Produkttyp überprüfen, und versuchen Sie es erneut. Wenn das Problem weiterhin besteht, senden Sie eine Anfrage an den Support für Entwickler.

Your listing might have experienced an issue after submission (an asynchronous issue). To view such issues, use the getListingsItem operation.

Wenn Sie die Meldung "Entspricht nicht Ihren Produktkategorien" erhalten, ist die ASIN in einer Produktkategorie eingerichtet, auf die der Anbieter keinen Zugriff hat. Senden Sie uns eine Anfrage über Vendor Central unter Angabe der Nachricht, der ASIN(s) und des richtigen Produkttyps. Senden Sie eine Anfrage an Support für Entwickler, wenn Sie technischen Support benötigen oder wenn dies in der Anleitung zur Fehlerbehebung angegeben ist.

Wenn Sie die Meldung "Nicht unterstützt – die folgenden Produkte können nicht hinzugefügt werden" erhalten, senden Sie uns eine Anfrage über Vendor Central unter Angabe der Problemmeldung und der betroffenen ASINs/externen ID(s). Senden Sie eine Anfrage an Support für Entwickler, wenn Sie technischen Support benötigen oder wenn dies in der Anleitung zur Fehlerbehebung angegeben ist.

To identify the appropriate listing requirements, you must first select the correct product type. This allows Amazon to provide all necessary listing requirements upfront. The following steps outline the process:

1. Benutze das searchDefinitionsProductTypes Vorgang, um eine Liste der zutreffenden Produkttypen für Ihre Vertriebspartner zu erhalten. Wenn Sie einen Produkttitel haben, können Sie eine zuverlässige Empfehlung für den Produkttyp erhalten, indem Sie den itemName Parameter. Mit dem itemName Parameter, Sie können den Produkttitel und die Beschreibung kombinieren, um detailliertere Vorschläge für Produkttypen zu erhalten. Sie können auch verwenden keywords um Produkttypen zu durchsuchen oder einen leeren Parameter zu übergeben, um die gesamte Liste der verfügbaren Produkttypen zurückzugeben. Weitere Informationen finden Sie im Anwendungsfallleitfaden für die API v2020-09-01 für Produkttypdefinitionen.

2. Nachdem Sie den Produkttyp kennen, rufen Sie den getDefinitionsProductType Betrieb mit dem requirements Parameter zum Abrufen der Anforderungen für die Erstellung einer neuen Liste.

Ja. Die Schemaversion wird immer auf die neueste Version der Amazon-Produkttypdefinition aktualisiert.

Es gibt mehrere Möglichkeiten, Änderungen zwischen zwei Schemaversionen zu identifizieren:

• Rufen Sie den getDefinitionsProductType bedienen und untersuchen Sie die checksum Eigentum in der Antwort.
• Abonnieren Sie den PRODUCT_TYPE_DEFINITIONS_CHANGE Benachrichtigung, um Updates in Echtzeit zu erhalten, wenn eine neue Version eines Produkttyps für einen Marketplace verfügbar wird. Wenn eine neue Produkttypversion die Benachrichtigung ausgelöst hat, enthält die Payload für Benachrichtigungen die neue Produkttypversion im ProductTypeVersion Eigentum.
• Beachten Sie die Ankündigungen zur Markteinführung, die Amazon jeden Monat veröffentlicht (z. B. https://developer-docs.amazon.com/sp-api/changelog/update-october-updates-to-listing-attribute-usage-and-enumeration-values). Weitere Informationen finden Sie unter Ankündigungen.

Basierend auf den Such- und Kaufsignalen von Kunden überprüft Amazon die Produktmerkmale regelmäßig und plant die erforderlichen Aktualisierungen für die letzte Woche eines jeden Monats. Manchmal nimmt Amazon vor der geplanten Veröffentlichung einige Aktualisierungen vor, um Kundenfeedback zu berücksichtigen und etwaige Mängel oder Lücken zu beheben. Die meisten Änderungen sind geringfügig und wirken sich nicht auf das Kundenverhalten aus. Bevor Sie ein Attribut für die Einreichung Ihres Angebots aktualisieren, verwenden Sie das API für Definitionen von Produkttypen um das neueste JSON-Schema zu erhalten.

Use the $lifecycle attribute to find details about deprecated content and actions to take. Deprecated content is content that is still technically valid but is removed in the future. For example, the enumDeprecated element of the $lifecycle attribute lists deprecated enumeration values that you should work to replace with the latest values.

Sie können Artikel auf folgende Weise bei Amazon anbieten:

• Sie können das verwenden Angebote | Artikel | API v2021-08-01 um programmgesteuert auf Angebote von Verkaufspartnern bei Amazon zuzugreifen. Verwenden Sie diese API, um Details zu Amazon-Angeboten (SKUs) für einen Vertriebspartner zu erstellen, zu bearbeiten, zu löschen und abzurufen. Sie können beispielsweise Produktfakten wie Artikeltitel und Verkaufsbedingungen wie Preise bearbeiten.
• Sie können das verwenden JSON_LISTINGS_FEED, das ist ein Bulk-Feed-Format, das mit dem austauschbar ist Angebote | Artikel | API v2021-08-01 Operationen. Der Feed stellt Ihre Massenübermittlung in die Warteschlange und ruft dann den auf Angebote | Artikel | API v2021-08-01 in deinem Namen. Nach Abschluss des Vorgangs enthält der Bericht zur Feed-Verarbeitung das Validierungsfeedback von Angebote | Artikel | API v2021-08-01.

Weitere Informationen finden Sie in der Leitfaden zur Erstellung von Arbeitsabläufen zur Verwaltung von Angeboten.

Das Katalog Artikel API v2022-04-01 stellt Informationen auf ASIN-Ebene bereit, die anhand verschiedener Angebote mit diesem Artikel abgeglichen werden. Der Angebote | Artikel | API v2021-08-01 enthält Informationen zu dem spezifischen Angebot, das von einem Vertriebspartner eingereicht wurde.

Ja. Das Katalog Artikel API v2022-04-01 gibt Daten zurück, die einer ASIN zugeordnet sind. Eine ASIN steht auf allen Marketplace-Sites für denselben physischen Artikel, mit wenigen Ausnahmen. Die Daten für jede ASIN unterscheiden sich jedoch je nach Marketplace, da die Länder für diese Marketplace-Site unterschiedliche Datenanforderungen haben.

Da es sich bei den meisten Attributen um lokalisierten Text handelt, kann der Text außerdem je nach Marketplace oder Region unterschiedlich sein, auch wenn der Text dasselbe Produkt beschreibt. Verwenden Sie den marketplaceIds Filter im Produkttyp-Definitionen API v2020-09-01 Operationen, um die marktspezifischen Anforderungen für die Erstellung oder Aktualisierung von Produkten zu ermitteln.

Ja. Wenn Sie keine Produktkennzeichnung haben, können Sie ein Produkt mit einer GTIN-Ausnahme erstellen. Für eine Befreiung müssen Sie über Ihr Seller Central-Konto einen manuellen Freistellungsantrag stellen. Weitere Informationen finden Sie unter Seller Central. Nachdem Sie eine Genehmigung erhalten haben, können Sie Angebote über das Formular einreichen Angebote | Artikel | API v2021-08-01. Sie müssen Folgendes bereitstellen GENERIC als Markennamen und lege den fest supplier_declared_has_product_identifier_exemption attributieren true.

No. Amazon uses submission timestamps to ensure that updates happen in the correct order.

When you upload a JSON_LISTINGS_FEED with inventory updates, Amazon records the feed submission time as the timestamp for all updates within the feed. If you then initiate an inventory update through the patchListingsItem operation, the system assigns the request submission time as the timestamp for that inventory update. In this scenario, if the patchListingsItem operation gets processed first, then it overrides the data provided in the JSON_LISTINGS_FEED.

Nein. Das JSON_LISTINGS_FEED und Angebote | Artikel | API v2021-08-01 unterstützt einen einzelnen Marktplatz pro Feed.

Markeninhaber haben die höchste Priorität, Daten auf der Produktdetailseite bei Amazon zu aktualisieren. Wenn Amazon seine eigenen Daten auf der Produktdetailseite verwendet, können Markeninhaber diese durch ein Ticket an den Seller Central-Support außer Kraft setzen.

Before you submit a listing, verify that the attributes of the listing adhere to the JSON schema for the product type. For information about JSON schema validation utilities, refer to Amazon Product Type Definitions Meta-Schema (v1).
After you validate the JSON, you can preview errors before you create or update a listing by using VALIDATION_PREVIEW mode. This mode provides a test environment that checks the values that you provide in the payload for validation errors. VALIDATION_PREVIEW mode synchronously performs the same checks that are done on production submissions, but without persisting to your catalog.

Amazon führt mehrere Validierungen für Angebote durch, die von Vertriebspartnern eingereicht wurden. Einige dieser Validierungen werden synchron als Antwort auf die Eingaben zurückgegeben. Wenn Sie die Angebotsdaten mit dem hochladen Angebote | Artikel | API v2021-08-01 und der Einreichungsstatus ist ACCEPTED, dann hat die Einreichung die synchronen Validierungen bestanden. Amazon sendet die Einreichung an einen anderen Standort weiter, um die SKU zu erstellen oder zu aktualisieren. Es gibt eine Reihe nachgelagerter Prozesse, die dann ausgeführt werden, um einen Artikel im Amazon-Katalog zu erstellen oder zu aktualisieren. Jeder dieser nachgelagerten Prozesse kann zu Problemen führen, die asynchron zurückgegeben werden. Zum Beispiel, wenn ein eingereichtes Angebot Daten enthält, die mit einem anderen Artikel im Amazon-Katalog in Konflikt stehen. Um Artikel im Amazon-Katalog erfolgreich zu erstellen oder zu aktualisieren, müssen Sie gemeldete Probleme synchron und asynchron behandeln. Weitere Informationen zu Problemen bei der Angebotserstellung finden Sie unter Umgang mit Problemen mit Artikeln in Angeboten und Fehlerbehebung bei API-Problemen mit Artikeln.

Amazon sendet eine LISTINGS_ITEM_STATUS_CHANGE Benachrichtigung, wenn sich der Status eines Angebotsartikels ändert. Eine Benachrichtigung wird veröffentlicht, wenn sich die Kaufbarkeit eines Angebotsartikels ändert oder wenn ein Artikel erstellt oder gelöscht wird. Um eine Benachrichtigung zu erhalten, wenn ein Inserat erstellt wird, abonnieren Sie den LISTINGS_ITEM_STATUS_CHANGE Benachrichtigung. Die ListingsItemStatus Das in der Payload zurückgegebene Attribut enthält den aktuellen Status, der dem betroffenen Angebotsartikel zugeordnet ist. Wenn kein Wert vorhanden ist, gilt der Statusstatus nicht für den Artikel mit dem Angebot. Zum Beispiel, wenn DISCOVERABLE ist nicht vorhanden, Amazon Retail kann nicht nach dem angebotenen Artikel suchen.

There can be a delay because the Amazon backend updates every 15 minutes. As a result, every update might be delayed by 0-15 minutes depending on when the update occurred in that window.
For example, a 15-20 minute delay for the LISTINGS_ITEM_ISSUES_CHANGE and LISTINGS_ITEM_STATUS_CHANGE notifications is normal. Our data sources can be up to 15 minutes behind because the data sources rely on many upstream processes to send updates for notifications.

In contrast, the getListingItem operation directly queries the current state, which is why the results are available faster (within 1-5 minutes). To minimize throttling errors, you must use push notifications to receive real-time updates for status changes and issues with listings.

Throughout the process phase of a listing submission, Amazon evaluates the listing. If the listing deviates from the selected product type, the listing's product type switches to a recommended product type. This results in attributes from the new product type to show up as missing. We convey information about a changed product type through a warning on the listing.

You can use the searchDefinitionsProductTypes operation to retrieve a list of all the applicable product types. To retrieve a high-confidence recommendation for the correct product type with this operation, use the itemName parameter.

Mit dem JSON_LISTINGS_FEED, Sie können alle 5 Minuten bis zu 10.000 SKUs in einer einzigen Anfrage senden. Um Drosselungsproblemen vorzubeugen, senden Sie statt kleiner Feeds einen großen Feed. Das Hochladen mehrerer kleiner Feeds alle paar Sekunden ist ineffizient und kann zu einem Rückstand führen. Dies kann die Verarbeitung anderer Feeds blockieren und Sie dazu zwingen, einige der zuvor übermittelten Feeds zu stornieren. Anstatt dieselben Daten zu senden, senden Sie nur aktualisierte Informationen, um die Anzahl der Anrufe zu reduzieren. Informationen zur Optimierung Ihrer Feed-Einreichungen finden Sie unter Bewährte Methoden für Feeds API.

Die Bildattribute, die von der Angebote | Artikel | API v2021-08-01 Operations ordnet Bilder ASINs auf globaler Ebene zu, auf der die ASIN existiert, auch wenn Sie Folgendes angeben marketplace_id Selektor. Dieses Verhalten steht im Einklang mit anderen Erfahrungen, wie Ein Produkt hinzufügen innerhalb von Seller Central.