get https://www.your-shop.de/api/v1/Orders/
Hier können Sie die Daten einer Bestellung abrufen.
Identifier
Parameter | Wert | Beschreibung |
---|---|---|
id | int | die Id des Objekts oder ggf Bestellnummer |
Parameter
Name | Wert | Beschreibung |
---|---|---|
useOrderNrAsId | bool | der Identifier ist eine BestellNr |
Response Parameter
Es wird ein Array von Datensätzen mit folgenden Parametern zurückgeben:
Name | Beschreibung | Anmerkungen | Wert |
---|---|---|---|
id | Die ID des Objekts. | int | |
location | Die REST URL zum Abrufen des Objekts. | string | |
order_number | die Bestellnummer | string | |
order_number_extern | die externe Bestellnummer | string | |
channel_number | die externe Kanalnummer | string | |
notice_customer | die Kundenbemerkung der Bestellung | string | |
notice_order | die Adminbemerkung der Bestellung | string | |
customer_id | die Kundennummer | int | |
customer_email | die E-Mail-Adresse | string | |
customer_location | die URL, um Details zu der Kundendaten abzurufen | string | |
date | das Bestelldatum | YYYY-MM-DD | date |
custgroup_id | die interne ID der Kundengruppe | int | |
custgroup_name | die Bezeichnung der Kundengruppe | string | |
orderstatus_id | die interne ID der Statusstufe | int | |
orderstatus_name | die Bezeichnung der Statusstufe | string | |
orderstatus_intern_id | die ID des internen Status (benutzt bei erweiterter Warenwirtschaft) | 0 – offen, 1 – versendet, 2 – storniert, 3 -teil-versendet; sonst -1 – undefined | int |
orderstatus_intern_name | die Bezeichnung des internen Status (benutzt bei erweiterter Warenwirtschaft) | offen, versendet, storniert, teil-versendet; sonst undefined | string |
delivery_salutation | die Anrede der Versandadresse | string | |
delivery_firstname | der Vorname der Versandadresse | string | |
delivery_lastname | der Nachname der Versandadresse | string | |
delivery_company | die Firma der Versandadresse | string | |
delivery_addition | der Zusatzeintrag zur Adresse der Versandadresse | string | |
delivery_street | die Straße der Versandadresse | string | |
delivery_streetnr | die Hausnummer der Versandadresse | string | |
delivery_zip | die PLZ der Versandadresse | string | |
delivery_city | der Ort der Versandadresse | string | |
delivery_state | das Bundesland der Versandadresse | string | |
delivery_country | das Land der Versandadresse | string | |
delivery_country_iso2 | der ISO2-Code des Landes der Versandadresse | string | |
delivery_country_iso3 | der ISO3-Code des Landes der Versandadresse | string | |
bill_salutation | die Kundenanrede der Rechnungsadresse | string | |
bill_firstname | der Vorname der Rechnungsadresse | string | |
bill_lastname | der Nachname der Rechnungsadresse | string | |
bill_company | die Firma der Rechnungsadresse | string | |
bill_addition | der Zusatzeintrag zur Adresse der Rechnungsadresse | string | |
bill_street | die Straße der Rechnungsadresse | string | |
bill_street_nr | die Hausnummer der Rechnungsadresse | string | |
bill_zip | die PLZ der Rechnungsadresse | string | |
bill_city | der Ort der Rechnungsadresse | string | |
bill_state | das Bundesland der Rechnungsadresse | string | |
bill_country | das Land der Rechnungsadresse | string | |
bill_country_iso2 | der ISO2-Code des Landes der Rechnungsadresse | string | |
bill_country_iso3 | der ISO3-Code des Landes der Rechnungsadresse | string | |
shipping_name | die Bezeichnung der Versandart | string | |
shipping_price | die Versandkosten | float | |
shipping_tax_rate | der Steuersatz der Versandart | float | |
billing_name | die Bezeichnung der Zahlungsart | string | |
billing_price | die Zahlungsartkosten | float | |
billing_tax_rate | der Steuersatz der Zahlungsart | float | |
billing_modul | die Bezeichnung des Moduls der Zahlungsart | string | |
billing_notice | die Bemerkung zur Zahlungsart | string | |
price_exclude_tax | 0 = Preise sind inkl. Steuer – 1 = Preise sind exkl. Steuer | bool | |
vat_number | Ust-IdNr des Kunden, wenn in der Bestellung angewendet | string | |
currency_name | die Währung der Bestellung | string | |
currency_iso | der ISO-Code der Währung | string | |
order_type_id | die interne ID des Bestelltyps | int | |
order_type_name | die Bezeichnung des Bestelltyps | string | |
multishop_id | Die ID des Multishops falls gesetzt | int | |
is_offer | 1 = die Bestellung ist als Angebot deklariert, sonst 0 | bool | |
total_amount_include_tax | Gesamtsumme inkl. Steuern | float | |
total_amount_exclude_tax | Gesamtsumme exkl. Steuern | float | |
total_details_amount_include_tax | Summe Bestellpositionen der Bestellung inkl. Steuern | float | |
total_details_amount_exclude_tax | Summe Bestellpositionen der Bestellung exkl. Steuern | float | |
shipping_weight | Das Versandgewicht der Bestellung | float | |
tax | Daten zu den Steuersätzen (s.u.) | array | |
voucher | Daten zu den Gutscheinen (s.u.) | array | |
rabatt | wenn Rabatt existiert, dann ist dieser Parameter gesetzt (s.u.) | array | |
details | Daten zu den Bestellpositionen (s.u.) | array | |
bills | die id und location der bestehenden Rechnungen |
tax
Ein oder mehrere Arrays mit folgenden Datensätzen:
Name | Beschreibung | Wert |
---|---|---|
tax_rate | der Steuersatz | float |
tax_notice | die Bezeichnung inkl. oder exkl. | string |
tax_amount | der Steuerbetrag | float |
voucher
Ein oder mehrere Arrays mit folgenden Datensätzen:
Name | Beschreibung | Wert |
---|---|---|
voucher_type | 0 = Rabattgutschein, 1 = Wertgutschein | bool |
voucher_number | die Gutscheinnummer | string |
voucher_number_text | die Gutscheinnummer, ggf mit Hinweis auf Hersteller | string |
voucher_discount | der Gutscheinprozentsatz | float |
voucher_amount | der Gutscheinbetrag | float |
rabatt
Sofern vorhanden, dann folgende Datensätze:
Name | Beschreibung | Wert |
---|---|---|
discount | der Rabattprozentsatz | float |
amount | der Rabattbetrag | float |
details
Ein oder mehrere Arrays mit folgenden Datensätzen:
Name | Beschreibung | Wert |
---|---|---|
detail_id | die interne iD | int |
detailstatus_intern_id | die ID des internen Status (benutzt bei erweiterter Warenwirtschaft; 0 – offen, 1 – versendet, 2 – storniert; sonst -1 – undefined) | int |
artikel_nr | die Artikelnummer | string |
order_nr | die Bestellnummer | string |
name | der Artikelname | string |
company | die Firma | string |
size_name | die Größenbezeichnung | string |
color_name | die Farbbezeichnung | string |
availability | die Verfügbarkeitsbezeichnung | string |
description | die Beschreibung | string |
quantity | die Bestellmenge | int |
amount | der Einzelpreis | float |
amount_quantity | der Mengenpreis | float |
total_amount | der Gesamtpreis | float |
artikel_type | 0 – normaler Artikel, 1 – virtueller Artikel, 2 – Bundle, 3 – Gutschein | int |
quantity_return | die retournierte Menge | int |
extern_item_number | die externe Positionsnummer | string |
bundles | Wenn artikel_type = 2 ist sind hier die Daten zu den gebundleten Artikeln aufgeführt. | array |
details | Die Bestellmerkmale, sofern vorhanden. | array |
location | die URL zum Abrufen der Details, sofern es ein Shopartikel ist | string |
bundles
Ein oder mehrere Arrays mit folgenden Datensätzen:
Name | Beschreibung | Wert |
---|---|---|
name | der Artikelname | string |
variation_name | der Variantenname komplett | string |
artikel_nr | die Artikelnummer | string |
size_name | die Größenbezeichnung | string |
color_name | die Farbbezeichnung | string |
quantity | die Bundlemenge | int |
quantity_details | die Bundlemenge * die Menge der Bestellpostition | int |
location | die URL zum Abrufen der Details, sofern es ein Shopartikel ist | string |
details
Ein oder mehrere Arrays mit folgenden Datensätzen:
Name | Bescheibung | Wert |
---|---|---|
name | der Name des Bestellmerkmals | string |
value | der Wert des Bestellmerkmals | string |
price_info | Preis mit Währung | string |
price_quantity | Zusatz-Preis | float |
shipping
Versandinformationen, wenn die Position versendet ist
Bescheibung | Wert | |
---|---|---|
date | Versanddatum | date |
shipping_service | Transportdienst | string |
shipping_method | Versandart | string |
tracking_number | Sendungsnummer | string |
tracking_link | Tracking Link | string |
bills
Ein oder mehrere Arrays mit folgenden Datensätzen:
Name | Beschreibung | Wert |
---|---|---|
id | Die ID des Objekts. | int |
location | Die REST URL zum Abrufen des Objekts. | string |