SellerCentralGetOrders - Amazon Seller Central
← Amazon Seller Central Add-On Übersicht
Migrationsleitfaden: SellerCentralGetOrders v1 zu v2
Dieser Leitfaden hilft Ihnen bei der Migration vom SellerCentralGetOrders v1 Step (mit Amazon SP-API Orders v0) zum neuen SellerCentralGetOrders v2 Step (mit Amazon SP-API Orders 2026-01-01).
Wichtig: Der v1 Step ist veraltet und wird am 27.03.2027 entfernt. Bitte planen Sie Ihre Migration entsprechend.
Änderungen bei Step-Inputs
Entfernte Step-Inputs
| Input-Name | Alternative |
|---|---|
buyerEmail | Verwenden Sie amazonOrderId zur Filterung spezifischer Bestellungen bei Bedarf |
sellerOrderId | Verwenden Sie amazonOrderId zur Filterung spezifischer Bestellungen bei Bedarf |
electronicInvoiceStatus | Nicht verfügbar in neuer API. Manuelle Filterung (Filter Step) bei Bedarf erforderlich |
enableOrderItems | Artikel werden jetzt immer abgerufen |
enableOrderAddresses | Konsolidiert in Enthaltene Daten. Verwenden Sie “Käuferinformationen” bzw. “Lieferadresse” |
enableOrderItemsBuyerInfo | Konsolidiert in Enthaltene Daten. Verwenden Sie stattdessen “Order Buyer” |
Neue Step-Inputs
Der Step-Input Enthaltene Daten ermöglicht Ihnen die Kontrolle darüber, welche optionalen Daten abgerufen werden, ähnlich wie die v1-Flags enableOrderItems und enableOrderAddresses, jedoch mit wesentlich granularerer Kontrolle.
| Input-Name | Beschreibung |
|---|---|
Enthaltene Daten | Mehrfachauswahlfeld zur Auswahl zusätzlicher Daten, die in den Ergebnissen enthalten sein sollen: |
Die neue Eingabe Enthaltene Daten basierend auf Ihren Anforderungen:
- Wenn Sie Käuferinformationen benötigen: Wählen Sie “Besteller”
- Wenn Sie Lieferadressen benötigen: Wählen Sie “Lieferadresse”
- Wenn Sie Finanzdaten benötigen: Wählen Sie “Bestellumsatz, OrderItems-Umsatz”
- Wenn Sie Kosteninformationen benötigen: Wählen Sie “Kosten Bestellpositionen”
- Wenn Sie Rabatte benötigen: Wählen Sie “Rabatte und Sonderangebote”
- Wenn Sie Stornierungsinformationen benötigen: Wählen Sie “Stornierung von Bestellpositionen”
- Wenn Sie Fulfillment-Details benötigen: Wählen Sie “Versand- und Lieferdetails”
- Wenn Sie Paketverfolgung benötigen: Wählen Sie “Bestellpakete”
Migrationsschritte
- Identifizieren Sie alle Flows, die den SellerCentralGetOrders v1 Step verwenden (siehe )
- Empfehlung: Duplizieren Sie den Step als Backup. Der duplizierte Step kann pausiert werden. So können Sie bei Bedarf die Einstellungen des alten Steps prüfen.
- Tauschen Sie den Step durch die neue Version aus (siehe Stepeinstellungen)
- Wählen Sie die
Enthaltene Datenbasierend auf Ihren Anforderungen aus (siehe oben) - Prüfen Sie in nachfolgenden Steps, ob entfernte/geänderte Spalten (siehe Abschnitt “Entfernte Spalten” oben) des SellerCentralGetOrders Steps verwendet werden und passen Sie diese ggf. an.
Änderungen bei Ausgabespalten
Entfernte Spalten
Die folgenden Spalten sind in v2 nicht mehr verfügbar:
Entfernte Spalten auf Bestellebene
orderStatus→ Ersetzt durchfulfillmentStatusorderChannel→ Nicht in neuer API bereitgestelltfulfillmentInstructionSupplySourceId→ Nicht in neuer API bereitgestelltcbaDisplayableShippingLabel→ Nicht in neuer API bereitgestelltisEstimatedShipDateSet→ Nicht in neuer API bereitgestellteasyShipShipmentStatus→ Inpackage_status(Enthaltene Daten= “Bestellpakete”)isGlobalExpressEnabled→ Nicht in neuer API bereitgestelltnumberOfItemsShipped→ Nicht in neuer API bereitgestelltnumberOfItemsUnshipped→ Nicht in neuer API bereitgestelltpaymentMethod→ Nicht in neuer API bereitgestelltpromiseResponseDueDate→ Nicht in neuer API bereitgestelltisReplacementOrder→ InassociatedOrdersvorhandenreplacedOrderId→ InassociatedOrdersvorhandenisSoldByAB→ Nicht in neuer API bereitgestelltisISPU→ SpalteorderType-IN_STORE_PICK_UPpaymentExecutionDetail→ Nicht in neuer API bereitgestelltpaymentMethodDetails→ Nicht in neuer API bereitgestelltdefaultShipFromLocationAddress_...→ Nicht in neuer API bereitgestelltbuyerInfo_buyerCounty→ Nicht in neuer API bereitgestelltbuyerInfo_buyerEmail→ Veraltet und immer leer (Amazon beschränkt den Zugriff auf Käufer-E-Mails - siehe Amazons Käuferinformationsdokumentation)buyerInfo_taxInfoCompanyLegalName→ Nicht in neuer API bereitgestelltbuyerInfo_taxInfoTaxingRegion→ Nicht in neuer API bereitgestellt
Entfernte Spalten auf Bestellpositionsebene
orderItem_conditionId→ Ersetzt durchorderItem_conditionTypeorderItem_conditionSubtypeId→ Ersetzt durchorderItem_conditionSubtypeorderItem_itemTax_amount→ Entfernt (Steuer jetzt in “Umsatz und finanzielle Aufschlüsselung”)orderItem_itemTax_currencyCode→ Entfernt (Steuer jetzt in “Umsatz und finanzielle Aufschlüsselung”)orderItem_isSerialNumberRequired→ Nicht in neuer API bereitgestelltorderItem_isTransparency→ Nicht in neuer API bereitgestelltorderItem_priceDesignation→ Nicht in neuer API bereitgestelltorderItem_scheduledDeliveryStartDate→ Ersetzt durchorderItem_earliestScheduledDeliveryWindoworderItem_scheduledDeliveryEndDate→ Ersetzt durchorderItem_latestScheduledDeliveryWindoworderItem_deemedResellerCategory→ Nicht in neuer API bereitgestelltorderItem_storeChainStoreId→ Nicht in neuer API bereitgestelltorderItem_shippingTax_amount→ Entfernt (jetzt in “Umsatz und finanzielle Aufschlüsselung”)orderItem_shippingTax_currencyCode→ Entfernt (jetzt in “Umsatz und finanzielle Aufschlüsselung”)orderItem_shippingDiscount_amount→ Entfernt (jetzt in “Sonderangebote für Bestellpositionen”)orderItem_shippingDiscount_currencyCode→ Entfernt (jetzt in “Sonderangebote für Bestellpositionen”)orderItem_shippingDiscountTax_amount→ Entfernt (jetzt in “Sonderangebote für Bestellpositionen”)orderItem_shippingDiscountTax_currencyCode→ Entfernt (jetzt in “Sonderangebote für Bestellpositionen”)orderItem_promotionDiscount_amount→ Entfernt (jetzt in “Sonderangebote für Bestellpositionen”)orderItem_promotionDiscount_currencyCode→ Entfernt (jetzt in “Sonderangebote für Bestellpositionen”)orderItem_promotionDiscountTax_amount→ Entfernt (jetzt in “Sonderangebote für Bestellpositionen”)orderItem_promotionDiscountTax_currencyCode→ Entfernt (jetzt in “Sonderangebote für Bestellpositionen”)orderItem_CODFee_amount→ EntferntorderItem_CODFee_currencyCode→ EntferntorderItem_CODFeeDiscount_amount→ EntferntorderItem_CODFeeDiscount_currencyCode→ EntferntorderItem_productInfoDetail_numberOfItems→ Nicht in neuer API bereitgestelltorderItem_pointsGranted→ Nicht in neuer API bereitgestelltorderItem_pointsMonetaryValue_amount→ Nicht in neuer API bereitgestelltorderItem_pointsMonetaryValue_currencyCode→ Nicht in neuer API bereitgestelltorderItem_isBuyerRequestedCancel→ Ersetzt durch Stornierungsdaten (jetzt in “Stornierung von Bestellpositionen”)orderItem_buyerCancelReason→ Ersetzt durch Stornierungsdaten
Neue Spalten
Die folgenden Spalten sind neu in v2 verfügbar:
Neue Spalten auf Bestellebene
orderAliasIds→ Karte alternativer BestellkennungendeliveryPreference_addressInstruction→ Besondere LieferanweisungendeliveryPreference_deliveryCapabilities→ LieferfähigkeitendeliveryPreference_dropOffLocation→ Abgabeort-PräferenzassociatedOrders→ Verwandte Bestellungen (z.B. Ersatzlieferungen, Retouren)buyerInfo_buyerCompanyName→ Firmenname des Käufers (B2B-Bestellungen)
Neue Spalten für Bestellpositionen (Basis)
orderItem_quantityUnfulfilled→ Anzahl noch nicht erfüllter ArtikelorderItem_earliestScheduledDeliveryWindow→ Beginn des LieferfenstersorderItem_latestScheduledDeliveryWindow→ Ende des LieferfenstersorderItem_cashOnDelivery→ Nachnahme-IndikatororderItem_palletDelivery→ Palettenlieferungs-IndikatororderItem_recipientAgeVerification→ AltersverifizierungsanforderungorderItem_recipientIdentityVerification→ IdentitätsverifizierungsanforderungorderItem_signatureConfirmation→ Signatur-erforderlich-Indikator
Finanz-/Erlösspalten für Bestellpositionen (wenn Enthaltene Daten = “Bestellumsatz, OrderItems-Umsatz” enthält)
orderItem_itemProceedsTotal_amount→ Gesamterlös für den ArtikelorderItem_itemProceedsTotal_currencyCode→ Währung des Gesamterlöses- Finanzaufschlüsselungsspalten (verschiedene Erlöskomponenten)
Paketverfolgungsspalten (wenn Enthaltene Daten = “Bestellpakete” enthält)
package_referenceId→ Paketkennungpackage_carrier→ Versanddienstleisternamepackage_createdTime→ Wann das Paket erstellt wurdepackage_shippingService→ Verwendeter Versandservicepackage_trackingNumber→ Tracking-Nummerpackage_shipTime→ Wann das Paket versandt wurdepackage_status→ Paketstatus (z.B. Versandt, Zugestellt)package_detailedStatus→ Detaillierter Paketstatuspackage_itemQuantities→ Karte der Artikel-IDs zu Mengen im Paketpackage_itemTransparencyCodes→ Transparenzcodes für Artikel
Zusätzliche Information und Support
- Amazon SP-API Dokumentation: https://developer-docs.amazon.com/sp-api/
- Amazon SP-API Orders API v2026-01-01 Referenz: https://developer-docs.amazon.com/sp-api/docs/orders-api-v2026-01-01-reference
- Amazon SP-API Migrationsleitfaden: https://developer-docs.amazon.com/sp-api/docs/orders-api-migration-guide
- Synesty Studio Support: Kontaktieren Sie uns bei Fragen im Forum (https://forum.synesty.com) oder über unser Ticket System (https://apps.synesty.com/studio/support)
Inputs
Das sind die Optionen, mit denen man den Step konfigurieren kann.
| Name | Datentyp | Beschreibung | Pflichtfeld | Werte |
|---|---|---|---|---|
| account | ACCOUNT | Ihr Konto | Ja | |
| limit | STRING | Beschränken Sie die Anzahl der Aufträge. | Nein | |
| orderStatus | STRINGLIST | Auftragsstatusfilter (Standard: Alle). | Nein |
|
| fulfillmentChannel | STRINGLIST | Bestellungen nach Versandkanal filtern (Standard: Alle). | Nein |
|
| marketplace | STRINGLIST | Wählen Sie einen Marktplatz aus. Es können maximal 10 Marktplatz-IDs ausgewählt werden. | Ja |
|
| createdAfter | DATETIME | Datumsfilter, der Artikel zurückgibt, die nach einem bestimmten Datum erstellt wurden. (Wird oft in Kombination mit der letzten Laufzeit des Flows verwendet.) Sie müssen mindestens den Filter createdAfter oder lastupdatedAfter verwenden. | Nein | |
| createdBefore | DATETIME | Datumsfilter, der Elemente zurückgibt, die vor einem bestimmten Datum erstellt wurden. (Wird oft in Kombination mit dem aktuellen Zeitstempel verwendet.) | Nein | |
| lastupdatedAfter | DATETIME | Datumsfilter, der Artikel zurückgibt, die nach einem bestimmten Datum aktualisiert wurden. (Wird oft in Kombination mit der letzten Laufzeit des Flows verwendet.) Sie müssen mindestens den Filter createdAfter oder lastupdatedAfter verwenden. | Nein | |
| lastupdatedBefore | DATETIME | Datumsfilter, der Elemente zurückgibt, die vor einem bestimmten Datum aktualisiert wurden. (Wird oft in Kombination mit dem aktuellen Zeitstempel verwendet.) | Nein | |
| sellerOrderId | STRING | Die SellerOrderId einer Bestellung, die vom Verkäufer angegeben wird. Wird verwendet, um nur die Bestellungen auszuwählen, die mit der Bestellkennung übereinstimmen. Wenn SellerOrderId angegeben wird, können FulfillmentChannels, OrderStatuses, PaymentMethod, LastUpdatedAfter, LastUpdatedBefore und BuyerEmail nicht angegeben werden. | Nein | |
| amazonOrderId | STRING | Eine Liste von AmazonOrderId-Werten. Eine AmazonOrderId ist ein von Amazon definierter Bestellungsbezeichner im Format 3-7-7. Mehrere Bestellkennungen können durch Komma getrennt werden (max. 50) | Nein | |
| electronicInvoiceStatus | STRINGLIST | Wird verwendet, um Bestellungen mit elektronischen Rechnungsstatus auszuwählen, die mit den angegebenen Werten übereinstimmen (Standard: Alle). | Nein |
|
| enableOrderAddresses | STRING | Aktivieren/Deaktivieren der Abfrage der Bestelladresse. | Nein |
|
| enableOrderItems | STRING | Aktivieren / Deaktivieren der zusätzlichen Abfrage von Bestellpositionen. Beachten Sie, dass das Abrufen von Artikeln mit dieser Option viel langsamer ist. | Nein |
|
| enableOrderItemsBuyerInfo | STRING | Liefert Käuferinformationen (Käuferinformationen für individuelle Bestellungen, Geschenkinformationen) für die Bestellpositionen in der Bestellung. | Nein |
|
Outputs
Das sind die Ergebnisse des Steps, die von nachfolgenden Steps, nach der Ausführung verwendet werden können.
| Name | Datentyp | Beschreibung | Werte | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| output | SPREADSHEET | Das Ergebnis in Form eines SPREADSHEETs. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Folgende Felder sind im Output enthalten:
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||