API-Referenz Bestellungen

Der Endpunkt orders/ stellt Ihnen eine Schnittstelle zur Verwaltung von Bestelldaten in unserem Shop-System bereit. Mit dieser Schnittstelle können Sie Bestelldaten abrufen, löschen und den Status aktualisieren.

Unterstützte Methoden

Angabe aller unterstützten Methoden.

Befehl/Info	Endpunkte	GET	PUT	POST	DELETE
Bestellungen	orders/

Datenfelder einer Bestellung

Name	Typ	Bedeutung
createdAt	String	Zeitpunkt, zu dem die Bestellung aufgegeben wurde (ISO 8601-Format, UTC).
updatedAt	String	Zeitpunkt der letzten Änderung (ISO 8601-Format, UTC). Nur in der Listenansicht enthalten.
payedAt	String	Zeitpunkt der Bezahlung (ISO 8601-Format, UTC). Nur in der Listenansicht enthalten.
isImported	Boolean	Gibt an, ob die Bestellung importiert wurde. Nur in der Listenansicht enthalten.
accountId	Integer	ID des Kundenkontos, das die Bestellung getätigt hat. Nur in der Listenansicht enthalten.
version	Integer	Version des Datenformats der Bestellung. Nur in der Listenansicht enthalten.
deleted	Boolean	Gibt an, ob die Bestellung gelöscht wurde.
deliveryStatus	Objekt	Informationen über den Versand
id	String	Eindeutige ID der Bestellung.
paymentStatus	Integer	Status der Bezahlung (z. B. offen, bezahlt, fehlgeschlagen) Mögliche Werte: 0 = `Pending` 1 = `Finished` 2 = `Error` 3 = `Redirected` 4 = `CanceledByUser` 5 = `Rejected` 6 = `CanceledByAdmin` 7 = `Refunded` 8 = `RefundedPartially`
processingStatus	Integer	Status der Bestellverarbeitung Mögliche Werte: 0 = `New` 1 = `Finished` 2 = `Deleted` 3 = `Canceled`
verificationStatus	Integer	Status der Echtheit der Bestellung (z. B. echt, Testbestellung) Mögliche Werte: 0 = `Default` 1 = `Test` 2 = `Fake`
verificationComment	Objekt	Kommentar zur Verifizierung der Bestellung. Enthält optional die Felder `title` (String) und `comment` (String).
subshopId	String	ID des Subshops, über den die Bestellung abgeschlossen wurde.
data.general.dateTime	String	Zeitpunkt der Bestellung laut Metadaten (ISO 8601-Format, UTC).
data.general.orderId	String	Eindeutige ID der Bestellung.
data.general.sessionId	String	ID der Session, in der die Bestellung abgeschlossen wurde.
data.general.shopId	String	Technischer Name des Shops.
data.general.shopLanguage	String	Sprache des Shops während der Bestellung.
data.general.subshopId	String	Subshop-ID aus Metadaten (redundant mit oberem Feld).
data.general.testMode	Boolean	Gibt an, ob die Bestellung im Testmodus erstellt wurde.
data.general.version	String	Programmversion des Shopsystems zum Zeitpunkt der Bestellung.
data.customer.accountId	Integer	ID des Kundenkontos, das die Bestellung getätigt hat.
data.customer.accountType	String	Typ des Kundenkontos. Mögliche Werte: `"new"` `"registered"` `"guest"`
data.customer.customerNumber	String	Kundennummer (sofern vergeben).
data.customer.deviceType	Integer	Gerätetyp des Kunden beim Checkout. `1` – Desktop, `2` – Handy, `3` – Tablet.
data.customer.email	String	E-Mail-Adresse des Kunden.
data.customer.ipAddress	String	IP-Adresse des Kunden bei der Bestellung.
data.customer.memberId	Integer	ID des Benutzers innerhalb des Kundenkontos, der die Bestellung getätigt hat.
data.customer.platformType	Integer	Plattformtyp des Kunden. `1` – Web, `2` – App.
data.shippingAddress	Objekt (Adresse)	Lieferadresse
data.billAddress	Objekt (Adresse)	Rechnungsadresse Kann beim Express-Checkout ein leeres Objekt sein, wenn `expressCheckoutSkipsAddressValidation` in `checkout.checkout` aktiviert ist. Die von PayPal gelieferte Adresse steht dann in `data.paypal-checkout.rawAddress`.
data.order.billing	Objekt	Umrechnung des Gesamtbetrags in Euro. Enthält die Felder `amount` (Number), `amountEur` (Number), `usedRate` (Number), `rateDate` (String, `YYYY-MM-DD`) und `valid` (Boolean). Nur enthalten, wenn eine Umrechnung möglich war.
data.order.billingCountry	String	Land der Rechnungsadresse, das für die Steuerberechnung verwendet wurde.
data.order.currencyIso	String	ISO-Code der Währung (z. B. EUR).
data.order.currencySymbol	String	Währungssymbol (z. B. €).
data.order.defaultTaxRate	String	Standard-Mehrwertsteuersatz.
data.order.delivererId	String	ID des Versanddienstleisters.
data.order.delivererOrderText	String	Anzeigename des Versanddienstleisters.
data.order.delivererType	String	Typ der Versandart. Mögliche Werte: `"standard"` `"pickup"`
data.order.deliveryCost	String	Versandkosten (Brutto).
data.order.deliveryTaxRate	String	Mehrwertsteuersatz auf Versand.
data.order.isTaxExempt	Boolean	Gibt an, ob die Bestellung aufgrund des Lieferlands steuerbefreit ist.
data.order.paymentCost	String	Kosten der Zahlungsart.
data.order.paymentDiscount	String	Rabatt der Zahlungsart.
data.order.paymentFields	Objekt	Zusätzliche Eingabefelder der Zahlungsart mit den vom Kunden eingegebenen Werten.
data.order.paymentId	String	ID der gewählten Zahlungsart.
data.order.paymentLabels	String[]	Labels der Zahlungsart.
data.order.paymentOrderText	String	Anzeigename der Zahlungsart.
data.order.paymentProvider	String	Zahlungsanbieter der Zahlungsart.
data.order.paymentTaxRate	String	Mehrwertsteuersatz auf die Kosten der Zahlungsart.
data.order.paymentTechnicalOrderText	String	Technischer Bestelltext der Zahlungsart.
data.order.paymentType	String	Typ der Zahlungsart.
data.order.priceType	String	Preisangabe: “gross” oder “net”.
data.order.referer	String	Ursprungs-URL der Bestellung.
data.order.shippingCountry	String	Lieferland, das für die Steuerberechnung verwendet wurde.
data.order.subreferer	String	Weitere Herkunftsinformationen.
data.order.subtotal	String	Zwischensumme der Produkte.
data.order.surchargeCost	String	Zuschlagskosten.
data.order.surchargeTaxRate	String	Mehrwertsteuersatz auf Zuschläge.
data.order.tax	String	Gesamtsumme der Steuern.
data.order.taxDeduction	String	Abgezogene Steuer bei steuerbefreiten Bestellungen.
data.order.total	String	Gesamtsumme der Bestellung (inkl. Versand und Rabatte).
data.order.totalCommission	String	Gesamte Provision.
data.order.totalDiscount	String	Gesamter Rabattbetrag.
data.order.totalPreDeduction	String	Gesamtsumme der Bestellung vor Abzug der Steuer bei Steuerbefreiung.
data.order.totalVoucher	String	Gesamter eingelöster Gutscheinwert.
data.order.totalWeight	number	Gesamtgewicht der Bestellung.
data.order.usedExemptionRule	String	Regel, nach der die Steuerbefreiung geprüft wurde. Mögliche Werte: `"shippingOnly"` `"shippingAndBilling"` `""` (keine Regel)
data.orderList.item[].basketId	String	ID des Warenkorbeintrags.
data.orderList.item[].commission	String	Provision für diesen Artikel. Nur enthalten, wenn eine Provision anfällt.
data.orderList.item[].commissionTax	String	Steuer auf die Provision. Nur bei horizontaler Steuerberechnung enthalten.
data.orderList.item[].commissionTaxRate	String	Mehrwertsteuersatz auf die Provision.
data.orderList.item[].createdAt	String	Zeitpunkt, zu dem der Artikel in den Warenkorb gelegt wurde (ISO 8601-Format, UTC).
data.orderList.item[].discount	String	Rabatt auf diesen Artikel.
data.orderList.item[].extraFields	Objekt	Benutzerdefinierte Felder des Warenkorbartikels.
data.orderList.item[].freeFields	Objekt	Texteingabefelder des Artikels mit den vom Kunden eingegebenen Werten. Nur enthalten, wenn Werte vorhanden sind.
data.orderList.item[].hidden	Boolean	Gibt an, ob der Set-Bestandteil im Warenkorb ausgeblendet ist. Nur bei Set-Bestandteilen enthalten.
data.orderList.item[].inputOrigin	String	Herkunft des Warenkorbeintrags. Mögliche Werte: `"normal"` `"autoBasket"` `"accountBasket"` `"cookieBasket"` `"unknown"`
data.orderList.item[].insert	String	Werbemittelkennzeichen des Artikels.
data.orderList.item[].isAutoBasket	Boolean	Artikel automatisch in den Warenkorb gelegt.
data.orderList.item[].isChangeable	Boolean	Warenkorbartikel änderbar.
data.orderList.item[].isChild	Boolean	Gibt an, ob der Artikel ein Bestandteil eines Set-Produkts ist.
data.orderList.item[].isRemovable	Boolean	Warenkorbartikel entfernbar.
data.orderList.item[].isSetParent	Boolean	Gibt an, ob der Artikel das übergeordnete Set-Produkt ist.
data.orderList.item[].isSetProduct	Boolean	Gibt an, ob der Artikel zu einem Set-Produkt gehört.
data.orderList.item[].isVisible	Boolean	Gibt an, ob der automatisch gelegte Artikel im Warenkorb sichtbar ist.
data.orderList.item[].itemNumber	String	Artikelnummer.
data.orderList.item[].name	String	Artikelbezeichnung.
data.orderList.item[].oneTimeFee	String	Einmalige Gebühr für diesen Artikel. Nur enthalten, wenn eine Gebühr anfällt.
data.orderList.item[].oneTimeFeeTax	String	Steuer auf die einmalige Gebühr. Nur bei horizontaler Steuerberechnung enthalten.
data.orderList.item[].oneTimeFeeTaxRate	String	Mehrwertsteuersatz auf die einmalige Gebühr.
data.orderList.item[].orgPrice	String	Originalpreis (vor Rabatt).
data.orderList.item[].parentBasketId	String	Warenkorb-ID des übergeordneten Set-Produkts. Nur bei Set-Bestandteilen enthalten.
data.orderList.item[].price	String	Preis pro Stück.
data.orderList.item[].productId	String	Produkt-ID.
data.orderList.item[].quantity	String	Bestellte Menge.
data.orderList.item[].redeemedVoucher	Objekt	Prozentuale Gutscheine, die auf diesen Artikel angewendet wurden. Enthält `voucherDiscount` (String), `voucherRate` (String) und die Liste `vouchers` mit den Feldern `voucherIndex` (Integer), `voucherType` (String: `"absolute"` oder `"percentuale"`), `voucherDiscount` (String), `voucherRate` (String) und optional `voucherDiscountHighPrecission` (String).
data.orderList.item[].singleTotal	String	Gesamtpreis dieses Artikels (Menge × Preis).
data.orderList.item[].tax	String	Steuer auf diesen Artikel. Nur bei horizontaler Steuerberechnung enthalten.
data.orderList.item[].taxAfterDiscount	String	Steuer auf diesen Artikel nach Rabatt. Nur bei horizontaler Steuerberechnung enthalten.
data.orderList.item[].taxId	String	Steuer-ID.
data.orderList.item[].taxRate	String	Mehrwertsteuersatz.
data.orderList.item[].total	String	Endpreis dieses Artikels (inkl. Rabatt etc.).
data.orderList.item[].totalAfterDiscount	String	Endpreis dieses Artikels nach Abzug des Rabatts.
data.orderList.item[].updatedAt	String	Zeitpunkt der letzten Änderung des Warenkorbeintrags (ISO 8601-Format, UTC).
data.orderList.item[].variantId	String	Varianten-ID.
data.orderList.item[].variantSelection[]	Objekt[]	Varianten-Auswahl des Artikels.
data.orderList.item[].variantSelection[].attributeId	String	Name der Varianten-Eigenschaft (z. B. “Size”).
data.orderList.item[].variantSelection[].optionId	String	Gewählte Option (z. B. “M”).
data.orderList.item[].voucher	Objekt	Daten eines gekauften Gutscheins (Kaufgutschein-Produkt). Enthält `chargeId` (String), `productHtmlTemplate` (String), `value` (Float), `ids` (String[], Gutschein-Codes) und `links` (String[], Links zu den Gutschein-PDFs). `ids` und `links` sind nur bei abgeschlossenen Bestellungen befüllt.
data.orderList.item[].weight	Float	Gewicht des Artikels.
data.freeFields	Objekt	Benutzerdefinierte Felder der Bestellung
data.<zahlungsanbieter>	Objekt	Daten des Zahlungsanbieters, z. B. `paypal-checkout` oder `computop-hosted`. Der Inhalt hängt vom jeweiligen Anbieter ab.
data.paypal-checkout.applePayResponseRaw	String	Rohantwort von Apple Pay. Nur bei Express-Checkout mit Apple Pay enthalten.
data.paypal-checkout.executePayPalResponse	String	Antwort von PayPal auf die Ausführung der Zahlung (hexadezimal kodiertes JSON).
data.paypal-checkout.expressCheckout	String	Gibt an, ob die Bestellung per Express-Checkout abgeschlossen wurde (`"true"` oder `"false"`).
data.paypal-checkout.expressCheckoutType	String	Art des Express-Checkouts. Nur bei Express-Checkout enthalten. Mögliche Werte: `"paypal"` `"googlePay"` `"applePay"`
data.paypal-checkout.googlePayResponseRaw	String	Rohantwort von Google Pay. Nur bei Express-Checkout mit Google Pay enthalten.
data.paypal-checkout.orderID	String	ID der Bestellung bei PayPal.
data.paypal-checkout.payerId	String	ID des Zahlers bei PayPal.
data.paypal-checkout.paymentAction	String	Zahlungsaktion. Immer `"CAPTURE"`.
data.paypal-checkout.paymentID	String	ID der Zahlung bei PayPal.
data.paypal-checkout.paymentMode	String	Verwendete PayPal-Zahlungsart. Mögliche Werte: `"PayPal"` `"CreditCard"` `"Invoice"` `"Sepa"` `"PayLater"` `"Bancontact"` `"BLIK"` `"Eps"` `"Giropay"` `"IDeal"` `"MyBank"` `"Przelewy24"` `"SOFORT"` `"ApplePay"` `"GooglePay"` `"UNKNOWN"`
data.paypal-checkout.paymentVault	Objekt	Gespeicherte Zahlungsmethode (Vaulting). Enthält die Felder `vaultId`, `customerId`, `merchantId` und `mailAddress` (jeweils String). Nur enthalten, wenn mit einer gespeicherten Zahlungsmethode bezahlt wurde.
data.paypal-checkout.paypalStatus	String	Status der Zahlung bei PayPal.
data.paypal-checkout.rawAddress	Objekt	Adresse, die PayPal, Apple Pay oder Google Pay beim Express-Checkout übermittelt hat. Enthält die Felder `firstName`, `lastName`, `street`, `zip`, `city` und `country` (jeweils String). `street` enthält Straße und Hausnummer zusammen, `country` ist der ISO-Ländercode. Nur enthalten, wenn eine Adresse übermittelt wurde.
data.vouchers[].id	String	Gutschein-Code.
data.vouchers[].name	String	Name des Gutscheins.
data.vouchers[].charge	String	ID der Gutschein-Charge.
data.vouchers[].value	String	Ursprünglicher Gutscheinwert. Bei prozentualen Gutscheinen mit `%`-Zeichen (z. B. `"10.000000%"`).
data.vouchers[].rest	String	Restwert des Gutscheins nach Einlösung.
data.vouchers[].taxId	String	Steuer-ID für Gutschein.
data.vouchers[].taxRate	Float	Steuersatz für Gutschein.
data.vouchers[].valueUsed	String	Betrag, den der Gutschein zu dieser Bestellung beigetragen hat.

Beispiel

{
    "createdAt": "2025-04-16T13:02:43Z",
    "data": {
        "billAddress": {
            "additionalInfo": "",
            "addressType": "1",
            "businessFax": "",
            "businessPhone": "",
            "city": "asdf",
            "company": "WEBSALE AG",
            "country": "DE",
            "countryName": "Deutschland",
            "custom": null,
            "dateOfBirth": "",
            "department": "",
            "fax": "",
            "firstName": "asdff",
            "lastName": "asdf",
            "mobilePhone": "",
            "phone": "987",
            "salutationCode": "1",
            "salutationText": "Herr",
            "state": "",
            "street": "asdf",
            "streetNumber": "9",
            "taxId": "",
            "titleCode": "2",
            "titleText": "Dr.",
            "zip": "99999"
        },
        "computop-hosted": {},
        "customer": {
            "accountId": 1,
            "accountType": "registered",
            "customerNumber": "",
            "deviceType": 1,
            "email": "root@root.root",
            "ipAddress": "172.18.0.1",
            "platformType": 1
        },
        "dummy": {},
        "freeFields": {
            "agb.checked": "true",
            "agb.merchantText": "agb text here",
            "comment.text": ""
        },
        "general": {
            "dateTime": "2025-04-16T13:02:43Z",
            "orderId": "1300",
            "sessionId": "d25e2c0b739aacdf4d3e55727ea6ffae943ebf15021ac1d6b60ba5f5c5d04582",
            "shopId": "",
            "shopLanguage": "Deutsch",
            "subshopId": "deutsch",
            "testMode": false
        },
        "order": {
            "currencyIso": "EUR",
            "currencySymbol": "€",
            "defaultTaxRate": "0.1900000",
            "delivererId": "hermes",
            "delivererOrderText": "Hermes",
            "deliveryCost": "3.95",
            "deliveryTaxRate": "0.1900000",
            "paymentId": "safepayment",
            "paymentOrderText": "Sichere Zahlungsart",
            "priceType": "gross",
            "referer": "https://myshop.localhost/?wsvc=View&view=confirm.htm",
            "subreferer": "",
            "subtotal": "10.00",
            "tax": "0.63",
            "total": "3.95",
            "totalCommission": "0.00",
            "totalDiscount": "0.00",
            "totalVoucher": "10.00",
            "totalWeight": 0
        },
        "orderList": {
            "item": [
                {
                    "basketId": "9680cda2830c10b063ca",
                    "discount": "0.00",
                    "extraFields": {},
                    "isAutoBasket": false,
                    "isChangeable": true,
                    "isRemovable": true,
                    "isVisible": true,
                    "itemNumber": "8765",
                    "name": "Something2",
                    "orgPrice": "0.00",
                    "price": "5.00",
                    "productId": "143-68071",
                    "quantity": "1.00",
                    "singleTotal": "5.00",
                    "taxId": "19",
                    "taxRate": "0.1900000",
                    "total": "5.00",
                    "variantId": "",
                    "variantSelection": null,
                    "weight": 0
                },
                {
                    "basketId": "0d191c832e46f326fc420dc59aa9facfc69f2fda5a5cad2e26d...",
                    "discount": "0.00",
                    "extraFields": {},
                    "isAutoBasket": true,
                    "isChangeable": false,
                    "isRemovable": false,
                    "isVisible": true,
                    "itemNumber": "12341234",
                    "name": "myProduct",
                    "orgPrice": "0.00",
                    "price": "5.00",
                    "productId": "105-59442",
                    "quantity": "1.00",
                    "singleTotal": "5.00",
                    "taxId": "19",
                    "taxRate": "0.1900000",
                    "total": "5.00",
                    "variantId": "1",
                    "variantSelection": [
                        {
                            "attributeId": "Color",
                            "optionId": "red"
                        },
                        {
                            "attributeId": "Size",
                            "optionId": "M"
                        }
                    ],
                    "weight": 0
                }
            ]
        },
        "paypal-checkout": {
            "executePayPalResponse": "",
            "expressCheckout": "false",
            "orderID": "",
            "paymentAction": "CAPTURE",
            "paymentID": "",
            "paymentMode": "PayPal",
            "paypalStatus": ""
        },
        "shippingAddress": null,
        "vouchers": [
            {
                "charge": "121",
                "id": "93JC-TGGL-KA3M-MRA7",
                "name": "myVoucher",
                "rest": "0.00",
                "taxId": "19",
                "taxRate": 0.19,
                "value": "55.00"
            }
        ]
    },
    "deleted": false,
    "deliveryStatus": {},
    "id": "1300",
    "paymentStatus": 1,
    "processingStatus": 0,
    "subshopId": "deutsch",
    "verificationComment": {},
    "verificationStatus": 0
}

Verwendung der Methoden

GET orders

Diese Methode liefert eine Liste aller Bestellungen aus dem Admin-Interface des Shops.

Beispiel

https://www.<ihr-shop>.de/admin/api/v1/orders

Antwort

{
    "endReached": true,
    "items": [
        {
            "accountId": 1,
            "createdAt": "2024-11-07T17:38:32Z",
            "data": {
                "billAddress": {
                    "country": "DE",
                    "countryName": "Deutschland",
                    "firstName": "asdf",
                    ...
                },
                "computop-hosted": {},
                "customer": {
                    "accountId": 1,
                    "accountType": "registered",
                    "email": "root@root.root",
                    "ipAddress": "172.18.0.1"
                },
                "dummy": {},
                "freeFields": {
                    "agb.checked": "true",
                    "agb.merchantText": "agb text here",
                    "comment.text": ""
                },
                "general": {
                    "dateTime": "2024-11-07T17:38:32Z",
                    "orderId": "820",
                    "sessionId": "79d803076669c8a41874d9d2cd8451f...",
                    "shopId": "myshop",
                    "shopLanguage": "",
                    "subshopId": "deutsch",
                    "testMode": false
                },
                "order": {
                    "currencyIso": "EUR",
                    "currencySymbol": "€",
                    "defaultTaxRate": "0.1900000",
                    "delivererId": "dhl",
                    "delivererOrderText": "DHL",
                    "deliveryCost": "11.00",
                    "deliveryTaxRate": "0.1900000",
                    "paymentId": "bill",
                    "paymentOrderText": "Rechnung",
                    "priceType": "gross",
                    "subtotal": "5.00",
                    "tax": "2.55",
                    "total": "16.00",
                    "totalCommission": "0.00",
                    "totalDiscount": "0.00",
                    "totalVoucher": "0.00"
                },
                "orderList": {
                    "item": [
                        {
                            "basketId": "d0c04a4cb60f708288a2",
                            "freeFields": {
                                "gravur1": "",
                                "gravur2": "",
                                "gravur3": ""
                            },
                            "isAutoBasket": false,
                            "isChangeable": true,
                            "isRemovable": true,
                            "isVisible": true,
                            "itemNumber": "8",
                            "name": "T-Shirt 'Land Rover' in Hellgrau",
                            "price": "5.00",
                            "productId": "105-59442",
                            "quantity": "1.00",
                            "singleTotal": "5.00",
                            "taxId": "19",
                            "taxRate": "0.1900000",
                            "total": "5.00",
                            "variantId": "1",
                            "variantSelection": [
                                {
                                    "attributeId": "555",
                                    "optionId": "foo"
                                },
                                {
                                    "attributeId": "888",
                                    "optionId": "bar"
                                }
                            ]
                        }
                    ]
                },
                "paypal-checkout": {
                    "executePayPalResponse": "",
                    "orderID": "",
                    "paymentAction": "CAPTURE",
                    "paymentID": "",
                    "paymentMode": "PayPal",
                    "paypalStatus": ""
                },
                "shippingAddress": null,
                "vouchers": null
            },
            "deleted": false,
            "deliveryStatus": {},
            "id": "820",
            "isImported": false,
            "payedAt": "2024-11-07T17:38:32Z",
            "paymentStatus": 1,
            "processingStatus": 0,
            "subshopId": "deutsch",
            "updatedAt": "2024-11-07T17:38:32Z",
            "verificationComment": {},
            "verificationStatus": 0,
            "version": 1
        },
        ...
    ],
    "nextPageToken": "Mw",
    "totalCount": 4
}

Filterfelder

createdAt, updatedAt, payedAt, id, subshopId, accountId, processingStatus, paymentStatus, verificationStatus, deleted

Sortierfelder

createdAt, updatedAt, id, processingStatus, paymentStatus, subshopId

Fehlercodes

Fehler	Typ	Grund
401 Unauthorized		Nicht autorisiert: Sie sind nicht angemeldet.
403 Forbidden		Sie verfügen nicht über die erforderlichen Rechte zum Lesen von Benutzern.
400 Bad Request	”invalidValue”
400 Bad Request	”unknownDataField”	Ein Filter- oder Sortierfeld ist ungültig.
400 Bad Request	”unknownOperation”	Ein Filtertyp ist ungültig.
400 Bad Request	”invalidCharacters”	`size` ist keine Ganzzahl. Ein Filterwert ist ungültig.
400 Bad Request	”syntaxError”	`sort` enthält mehr als einen oder keinen ”:“.
503 Service Unavailable	”internalError”	Nicht alle Bestellungen konnten entschlüsselt werden.

GET orders/{orderId}

Diese Methode ruft die Details einer einzelnen Bestellung anhand ihrer eindeutigen Bestell-ID ab.

Beispiel

https://www.<ihr-shop>.de/admin/api/v1/orders/860

Antwort

{
    "createdAt": "2024-11-08T14:36:30Z",
    "data": {
        "billAddress": {
            "businessFax": "",
            "businessPhone": "",
            "city": "asdf",
            "company": "",
            "country": "DE",
            "countryName": "Deutschland",
            "custom": null,
            "dateOfBirth": "",
            "department": "",
            "fax": "",
            "firstName": "asdf",
            "lastName": "asdf",
            "mobilePhone": "",
            "phone": "987",
            "salutationCode": "1",
            "salutationText": "Herr",
            "state": "",
            "street": "asdf",
            "streetNumber": "9",
            "taxId": "",
            "titleCode": "",
            "zip": "99999"
        },
        "computop-hosted": {},
        "customer": {
            "accountId": 1,
            "accountType": "registered",
            "email": "root@root.root",
            "ipAddress": "172.18.0.1"
        },
        "dummy": {},
        "freeFields": {
            "agb.checked": "true",
            "agb.merchantText": "agb text here",
            "comment.text": ""
        },
        "general": {
            "dateTime": "2024-11-08T14:36:30Z",
            "orderId": "860",
            "sessionId": "16be344c872261602e84cd0116e0b7a11a...",
            "shopId": "myshop",
            "shopLanguage": "",
            "subshopId": "deutsch",
            "testMode": false
        },
        "order": {
            "currencyIso": "EUR",
            "currencySymbol": "€",
            "defaultTaxRate": "0.1900000",
            "delivererId": "dhl",
            "delivererOrderText": "DHL",
            "deliveryCost": "11.00",
            "deliveryTaxRate": "0.1900000",
            "paymentId": "prepayment",
            "paymentOrderText": "Vorauskasse",
            "priceType": "gross",
            "subtotal": "8.00",
            "tax": "1.76",
            "total": "19.00",
            "totalCommission": "0.00",
            "totalDiscount": "0.00",
            "totalVoucher": "0.00"
        },
        "orderList": {
            "item": [
                {
                    "basketId": "01ddd733642b89429105",
                    "isAutoBasket": false,
                    "isChangeable": true,
                    "isRemovable": true,
                    "isVisible": true,
                    "itemNumber": "123456",
                    "name": "Tartan-Langarm-Polo in Navy",
                    "price": "8.00",
                    "productId": "106-19021",
                    "quantity": "1.00",
                    "singleTotal": "8.00",
                    "taxId": "zero",
                    "taxRate": "0.0000000",
                    "total": "8.00",
                    "variantId": "",
                    "variantSelection": null
                }
            ]
        },
        "paypal-checkout": {
            "executePayPalResponse": "",
            "orderID": "",
            "paymentAction": "CAPTURE",
            "paymentID": "",
            "paymentMode": "PayPal",
            "paypalStatus": ""
        },
        "shippingAddress": null,
        "vouchers": null
    },
    "deleted": false,
    "deliveryStatus": {},
    "id": "860",
    "paymentStatus": 1,
    "processingStatus": 0,
    "subshopId": "deutsch",
    "verificationComment": {},
    "verificationStatus": 0
}

Fehlercodes

Fehler	Typ	Grund
401 Unauthorized		Man ist kein Administrator und hat keine Berechtigung zum Lesen von Bestelldaten.
404 Not Found		Die Bestellung wurde nicht gefunden.
400 Bad Request	”missing”	`orderId` fehlt.
503 Service Unavailable	”internalError”	Die Bestellung konnte nicht geladen oder nicht entschlüsselt werden.

PUT orders/{orderId}

Diese Methode aktualisiert eine bestehende Bestellung anhand ihrer eindeutigen Bestell-ID. Alle Felder sind optional. Das Feld deliveryStatus soll ein als String serialisiertes Objekt sein. Die Felder verificationComment (String) und verificationTitle (String) werden nur bei Änderung des verificationStatus ausgewertet. Bei jeder Änderung des Verification-Status wird automatisch ein Log-Eintrag mit dem Log-Level Info und der Message-ID order.updateVerificationStatusSuccess erzeugt. Werte für processingStatus: 0 = New
1 = Finished
2 = Deleted
3 = Canceled Werte für verificationStatus: 0 = Default
1 = Test
2 = Fake\

Beispiel

https://www.<ihr-shop>.de/admin/api/v1/orders/188

Request Body

{
    "processingStatus": 3,
    "verificationStatus": 2,
    "verificationComment": "Mein Kommentar",
    "verificationTitle": "Mein Titel",
    "deliveryStatus": "{\"type\":\"global\",\"statusType\":\"tracking\",\"data\":{\"trackingVendorId\":\"\",\"trackingNumber\":\"12345\"}}"
}

Antwort

Bei Erfolg wird die aktualisierte Bestellung zurückgegeben (gleiches Format wie bei GET orders/{orderId}).

{
    "id": "188",
    "subshopId": "deutsch",
    "data": { ... },
    "createdAt": "2025-04-16T13:02:43Z",
    "processingStatus": 3,
    "paymentStatus": 1,
    "deleted": false,
    "deliveryStatus": { ... },
    "verificationComment": {},
    "verificationStatus": 2
}

Fehlercodes

Fehler	Typ	Grund
401 Unauthorized		Nicht autorisiert: Sie sind nicht angemeldet.
403 Forbidden		Sie verfügen nicht über die erforderlichen Rechte zum Lesen von Benutzern.
400 Bad Request		Request body konnte nicht geladen werden. Das Aktualisieren ist fehlgeschlagen.
400 Bad Request	”unknownDataField”	Es wird versucht, ein unbekanntes Feld zu aktualisieren. Erlaubte Felder: `processingStatus`, `verificationStatus`, `deliveryStatus`, `verificationComment`, `verificationTitle`.
400 Bad Request	”invalidFormat”	`processingStatus` ist keine Zahl. `verificationStatus` ist keine Zahl. `deliveryStatus`, `verificationComment` oder `verificationTitle` ist kein String.
400 Bad Request	”invalidValue”	`processingStatus` ∉ [0;3] `verificationStatus` ∉ [0;2]
400 Bad Request	”illegalOperation”
	404 Not Found
503 Service Unavailable	”internalError”	Die Bestellung konnte nach dem Aktualisieren nicht neu geladen werden.

DELETE orders/{orderId}

Diese Methode löscht eine bestehende Bestellung anhand ihrer eindeutigen Bestell-ID.

Beispiel

https://www.<ihr-shop>.de/admin/api/v1/orders/265

Antwort

{
    "success": true
}

Fehlercodes

Fehler	Typ	Grund
401 Unauthorized		Man ist kein Administrator und hat keine Berechtigung zum Löschen von Bestelldaten.
400 Bad Request	”missing”	`orderId` fehlt.
404 Not Found		Die Bestellung wurde nicht gefunden.
503 Service Unavailable	”internalError”	Die Bestellung konnte nicht geladen oder nicht entschlüsselt werden.

Support

Bei technischen Fragen und Hilfestellungen ist unser Support-Team für Sie erreichbar: Zum Kundenportal Bei technischen Fragen und Hilfestellungen ist unser Support-Team für Sie erreichbar: Zum Kundenportal Bitte senden Sie uns eine möglichst detaillierte Beschreibung sowie Screenshots, Requests/Antworten, damit wir Ihre Anfrage zeitnah und zielführend beantworten können.

Schnittstellen

Admin Interface API

Storefront API

Weitere

Unterstützte Methoden

Datenfelder einer Bestellung

Beispiel

Verwendung der Methoden

GET orders

Beispiel

Antwort

Filterfelder

Sortierfelder

Fehlercodes

GET orders/{orderId}

Beispiel

Antwort

Fehlercodes

PUT orders/{orderId}

Beispiel

Request Body

Antwort

Fehlercodes

DELETE orders/{orderId}

Beispiel

Antwort

Fehlercodes

Support

​Unterstützte Methoden

​Datenfelder einer Bestellung

​Beispiel

​Verwendung der Methoden

​GET orders

​Beispiel

​Antwort

​Filterfelder

​Sortierfelder

​Fehlercodes

​GET orders/{orderId}

​Beispiel

​Antwort

​Fehlercodes

​PUT orders/{orderId}

​Beispiel

​Request Body

​Antwort

​Fehlercodes

​DELETE orders/{orderId}

​Beispiel

​Antwort

​Fehlercodes

​Support

Unterstützte Methoden

Datenfelder einer Bestellung

Beispiel

Verwendung der Methoden

GET orders

Beispiel

Antwort

Filterfelder

Sortierfelder

Fehlercodes

GET orders/{orderId}

Beispiel

Antwort

Fehlercodes

PUT orders/{orderId}

Beispiel

Request Body

Antwort

Fehlercodes

DELETE orders/{orderId}

Beispiel

Antwort

Fehlercodes

Support