Häufig gestellte Fragen zur SP-API – Fehler
Häufig gestellte Fragen zu SP-API-Fehlern.
Tipp
Den aktuellen Status aller SP-APIs finden Sie in der API-Gesundheit-Dashboard. Sie können jederzeit auf das API Health Dashboard zugreifen, indem Sie das auswählen API-Status Schaltfläche in der oberen rechten Ecke der SP-API-Dokumentationsseite.
Häufige Fehler
Warum bekomme ich eine null
Aufzählungswert?
null
Aufzählungswert?Wählen Sie aus, um die Antwort zu erweitern.
Sie verwenden eine veraltete Modellversion. Aktualisieren Sie die Swagger-Modellversion in Ihrer Integration (z. B. regenerieren Sie die Client-Bibliotheken) und versuchen Sie es erneut.
Wie kann ich Drosselungsfehler vermeiden?
Wählen Sie aus, um die Antwort zu erweitern.
In der SP-API ist der Token-Bucket-Algorithmus begrenzt die Anforderungsraten. Informationen zur Vermeidung von Drosselungsfehlern finden Sie unter Nutzungspläne und Ratenlimits in der SP-API.
Batch-Vorgänge
Die folgenden Batch-Operationen sind für SP-API verfügbar:
Weitere Informationen finden Sie in der Ankündigung der SP-API-Veröffentlichung im Mai 2022.
Benachrichtigungs-API
Diese API sendet Benachrichtigungen, anstatt dass Sie mehrere Anfragen an andere APIs senden müssen. Weitere Informationen finden Sie auf der Anwendungsfallleitfaden für die Benachrichtigungs-API v1.
Rate Limiter
Informationen zur Implementierung eines clientseitigen Ratenbegrenzers finden Sie unter Optimieren Sie die Ratenlimits für Anwendungs-Workloads.
Warum erhalte ich die Meldung „In Bearbeitung“ für den Transaktions-API-Aufruf?
Wählen Sie aus, um die Antwort zu erweitern.
Der Transaktionsstatus wird für die folgenden API-Vorgänge unterstützt:
- Bestellung bestätigen
- Versandbestätigungen übermitteln
- Aktualisierungen des Versandstatus übermitteln
- Versandetikett anfordern
- Lagerbestand-Feed
Wenn sich der Transaktionsstatus nicht geändert hat von Processing
zu Failure
oder Success
nach 5 Minuten wurde die Transaktion in unserem System nicht erfolgreich abgeschlossen. Wenn der Transaktionsstatus erfolgreich ist, ändert sich der Status zu Success
. Wenn der Transaktionsstatus erfolgreich ist, ändert sich der Status zu Failure
und hat einen zugehörigen Fehlercode.
Sie können diese API nicht verwenden für Invoice
Nachrichten werden nicht überprüft, da sie nicht überprüft werden können und der Status immer lautet Processing
.
Bei Anfragen mit Versandetiketten, wenn die Transaktion mit einem Ursachencode für einen Terminalfehler fehlgeschlagen ist (z. B. Internal server error
), müssen Sie das Entwickler-Supportteam der Vertriebspartner-API über die Kontaktiere uns Formular für die Untersuchung. Dies geschieht aufgrund betrieblicher Einschränkungen.
Warum erhalte ich eine Fehlermeldung für den Aufruf des Vorgangs "Rechnungen übermitteln"?
Wählen Sie aus, um die Antwort zu erweitern.
Die Betriebsparameter müssen korrekt ausgefüllt werden. Beachten Sie diese Punkte, wenn Sie die Parameter für den API-Aufruf ausfüllen:
- Rechnungsnummern müssen eindeutig sein und dürfen nicht wiederverwendet werden (auch nicht nach einem Jahr).
- Wenn eine über die API gesendete Rechnung aufgrund falscher Daten fehlgeschlagen ist, die Papierrechnung jedoch die richtigen Daten enthält, sollte der Anbieter sie über die API mit den korrekten Daten unter derselben Rechnungs-ID aktualisieren.
- Wenn die Rechnung falsche Daten enthält (sowohl auf Papier als auch über API), wird die Rechnung storniert und eine neue Rechnung mit einer neuen Rechnungs-ID gesendet.
- Keine Rechnung mit Gesamtbetrag
0
sollte gesendet werden, da dies dazu führen würde, dass die Rechnung fehlschlägt. - Amazon benötigt die vollständigen Adressdaten in den Adresssegmenten aus Gründen der Steuereinhaltung. Dies ist besonders wichtig für den Rechnungsempfänger. Für dieses Segment benötigt das Amazon Payee System eine exakte Übereinstimmung.
- Die in der Rechnung angegebenen Zahlungsbedingungen sollten mit den mit dem Amazon-Käufer vereinbarten Zahlungsbedingungen übereinstimmen.
- Die Produktkennzeichnung des Artikels sollte mit der Produktkennzeichnung der Bestellung übereinstimmen, die dem Anbieter in der entsprechenden Bestellung übermittelt wurde. Der Gesamtbetrag der Rechnung sollte mit der Gesamtsumme der Artikel, Gebühren und Zuschläge übereinstimmen.
- Die Summe der Steuerbeträge für jede Zeilenebene muss mit der Summe der Steuerbeträge auf Kopfzeilenebene übereinstimmen.
- Die Gesamtsumme der Rechnung sollte mit der Summe der Mengen aller Artikel übereinstimmen. Die verschiedenen Kosten und Zuschläge müssen auf der Kopfzeilenebene aufgeführt werden.
Wenn einer dieser Parameter fehlt oder falsch ausgefüllt ist, führt dies dazu, dass der API-Aufruf falsche Angaben abruft. Stellen Sie sicher, dass Sie die erforderlichen Informationen angeben, wenn Sie den Vorgang absenden.
Warum erhalte ich einen SPDC300-Fehler?
Wählen Sie aus, um die Antwort zu erweitern.
Dieser Fehler kann durch die Verwendung bestimmter HTML-Tags verursacht werden, insbesondere der Header-Tags <h1><h2><h3><h4>
. Entfernen Sie diese Header-Tags und verwenden Sie nur die Tags, die im Texteditor vorgesehen sind.
Dieser Fehler kann auch darauf hinweisen, dass der Kontostatus aufgrund mangelnder Aktivität auf ruhend gesetzt wurde. Sie können Ihre Kreditkarteninformationen aktualisieren, um das Konto zu reaktivieren. Wenn Sie sich das nächste Mal bei Seller Central einloggen, werden Sie auf die Seite zur Aktualisierung der Kreditkartendaten weitergeleitet. Ihr Konto wird etwa 48 Stunden nach der Aktualisierung der Kreditkartendaten wieder aktiviert.
Warum erhalte ich eine Fehlermeldung 500, wenn ich in Postman ein LWA-Zugriffstoken anfordere?
Wählen Sie aus, um die Antwort zu erweitern.
Wenn Sie 500 Internal Server Error erhalten, überprüfen Sie das Content-Type header ist eingestellt auf application/x-www-form-urlencoded
und die Anforderungsparameter werden zum Hauptteil hinzugefügt und nicht als Abfrageparameter.
Warum erhalte ich einen 500-Fehler, wenn ich eine Anfrage an einen Sandbox-Endpunkt stelle?
Wählen Sie aus, um die Antwort zu erweitern.
Die SP-API-Sandbox funktioniert wie viele Mocking-Frameworks. Sie verwendet einen Mustervergleich, um eine bestimmte Antwort zurückzugeben, wenn die angegebenen Parameter vorhanden sind. Ein Entwickler erhält eine im x-amazon-spds-sandbox-behaviors
-Objekt definierte Antwort, wenn er eine Anfrage sendet, die mit den angegebenen Parametern übereinstimmt.
Wenn die an den Sandbox-Endpunkt gesendete Anfrage nicht mit den Parameterwerten im x-amazon-spds-sandbox-behaviors
-Objekt übereinstimmt, erhalten Sie in der Antwort einen "500 Internal Server Error". Sie müssen die Anfrage mit den genauen Werten senden, die im Modell angegeben sind.
Wenn die API Parameter benötigt, die nicht im x-amazon-spds-sandbox-behaviors
-Objekt angegeben sind, liefert die Sandbox die Antwort unabhängig von den Parameterwerten in der Anfrage, solange die Anfrage gültig ist.
Weitere Informationen über einen Sandbox-Aufruf der SP API finden Sie unter Die Verkaufspartner-API Sandbox.
Warum erhalte ich einen MD1000-Fehlercode?
Wählen Sie aus, um die Antwort zu erweitern.
{{0}} ist der Autorisierungsprozess, den andere Verkäufer einleiten werden, um Ihre Anwendung im Appstore zu autorisieren.
Wenn Sie den Parameter version=beta parameter
angeben, autorisiert der Workflow eine Anwendung im Entwurfsstatus. Wenn Sie den Parameter version=beta
nicht angeben, autorisiert der Workflow eine veröffentlichte Version dieser App-ID im Appstore, andernfalls wird ein Fehlercode "MD1000" zurückgegeben.
Warum erhalte ich einen MD1000-Fehlercode, wenn ich den OAuth Workflow initiiere?
Wählen Sie aus, um die Antwort zu erweitern.
Wenn Sie eine SP-API-Anwendung haben, die nicht veröffentlicht ist, aber der Workflow OAuth auf den Workflow Produktion verweist, wird dieser Fehler zurückgegeben. Vergewissern Sie sich, dass sich die Anwendung im Entwurfsstadium befindet. Wenn ja, fügen Sie den Parameter version=beta
zum OAuth Autorisierungs-URI konstruiert hinzu. Sobald die Anwendung veröffentlicht ist, kann dieser Parameter entfernt werden.
Warum erhalte ich einen MD5100-Fehlercode?
Wählen Sie aus, um die Antwort zu erweitern.
MD5100 kann durch die folgenden Probleme verursacht werden:
- Fehler in der OAuth Autorisierungs-URL.
- Fehlende Weiterleitungslinks in der Anwendung.
- Fragmente in der URL.
Versuchen Sie die folgenden Lösungen, um einen MD5100-Fehler zu beheben:
- Prüfen Sie den Anwendungsstatus:
- Wenn sich die Anwendung im Entwurfsstatus befindet, überprüfen Sie, ob die URL version=beta enthält.
- Wenn die Anwendung veröffentlicht ist, vergewissern Sie sich, dass die URL nicht version=beta enthält. Wenn version=beta in der URL enthalten ist, wird der OAuth-Prozess für den Entwurfsstatus der Anwendung statt für den veröffentlichten Status eingeleitet.
- Vergewissern Sie sich, dass Sie alle Schritte für die Autorisierung von Verkaufspartner-API-Anwendungen befolgt haben.
- Stellen Sie sicher, dass Ihre Anwendung eine Anmelde-URI und eine Umleitungs-URI hat. Sie können die Anmelde-URI und die Umleitungs-URI aktualisieren, indem Sie Ihre Anwendung in der Portal für Lösungsanbieter und Aktualisierung der Anmelde-URI und der Umleitungs-URI-Details.
- Stellen Sie sicher, dass die Anwendung den Marketplace unterstützt, für den der Entwickler autorisiert wurde. In der Portal für Lösungsanbieter, wähle das Edit Angebotsoption für Ihre Anwendung und wählen Sie im Abschnitt Preise die Marktplätze aus, die die Anwendung unterstützen soll.
Wenn das Problem nach Überprüfung dieser Angaben weiterhin besteht, reichen Sie einen Support-Fall ein.
Warum erhalte ich einen SPDC8143-Fehlercode?
Wählen Sie aus, um die Antwort zu erweitern.
Dieser Fehler tritt auf, wenn Sie versuchen, eine Anwendung als Zweitbenutzer zu autorisieren. Um diesen Fehler zu vermeiden, wenden Sie sich an den Kontoinhaber und bitten ihn, diese Aktion für Sie durchzuführen.
Warum sehe ich immer noch die MWS-Autorisierungsseite statt der SP-API-Zustimmungsseite, wenn ich den OAuth-Workflow initiiere?
Wählen Sie aus, um die Antwort zu erweitern.
Prüfen Sie, ob in Ihrer Anwendung die Anmelde-URI und die Weiterleitungs-URI fehlen. Sie können die Anmelde-URI und die Weiterleitungs-URI aktualisieren, indem Sie die App bearbeiten. Navigiere zu Appstore > Develop Apps und wähle Edit App für die App, die Sie verwenden, um das App-Registrierungsformular anzuzeigen und die Anmelde-URI- und Umleitungs-URI-Details zu aktualisieren.
Warum erhalte ich eine Fehlermeldung, wenn ich eine SKU mit Sonderzeichen verwende?
Wählen Sie aus, um die Antwort zu erweitern.
Die von Ihnen verwendete SKU kann Sonderzeichen wie einen umgekehrten oder einen Schrägstrich enthalten (\
, /
), die eine URL-Kodierung erfordern. Dies kann in verschiedenen Sprachen programmgesteuert durchgeführt werden. Hier ein Beispiel in Java:
import java.net.URLEncoder;
import java.nio.charset.StandardCharsets;
import java.io.UnsupportedEncodingException*;*
// Method to encode a SKU using the UTF-8 encoding scheme
private static String encodeSKU(String sSKU) {
try {
return URLEncoder.encode(sSKU, StandardCharsets.UTF_8.toString());
} catch (UnsupportedEncodingException ex) {
e*.*printStackTrace*();*
}
}
Weitere Informationen finden Sie unter URL-Kodierung.
Ich habe einen 400-Fehler erhalten, was soll ich tun?
Wählen Sie aus, um die Antwort zu erweitern.
Weitere Informationen finden Sie unter 400 Fehler lösen.
Benötigen Sie weitere Unterstützung?
Für weitere Unterstützung wenden Sie sich an API-Entwickler-Support für Vertriebspartner.
Updated 23 days ago