Der hier beschriebene Ansatz ermöglicht es eine Bestellung via REST in brandbox anzulegen und entsprechende Session-Artikel mit dieser zu verknüpfen.
...
| Info |
|---|
Hierfür werden zwingend Session Artikel IDs benötigt. Diese werden bspw. von einem Editor mit einer Fremdsystem-Referenz übermittelt. |
| URL | https://[brandbox System-URL]/rest/v4/request/shop/order/create/ | |
|---|---|---|
| Method | POST | |
| Header | content-type | form-data, x-www-form-urlencoded, etc. |
authorization | Durch Authentifizierung bereitgestellter Access-Token | |
| Body | delivery[salutation] | Persönliche Anrede für Lieferadresse |
delivery[firstname] | Vorname für Lieferadresse | |
delivery[lastname] | Nachname für Lieferadresse | |
delivery[company] | Optionaler Firmenname für Lieferadresse | |
delivery[street] | Straßenname für Lieferadresse | |
delivery[houseNumber] | Hausnummer für Lieferadresse | |
delivery[city] | Stadt- bzw. Ortsname für Lieferadresse | |
delivery[postcode] | Postleitzahl für Lieferadresse | |
delivery[country] | Land der Lieferadresse als ISO 639-1 Code (in Großbuchstaben, bspw. DE) | |
delivery[preferred] | Bevorzugtes Lieferdatum als UNIX-Zeitstempel | |
invoice[salutation] | Persönliche Anrede für Rechnungsadresse | |
invoice[firstname] | Vorname für Rechnungsadresse | |
invoice[lastname] | Nachname für Rechnungsadresse | |
invoice[company] | Optionales Firmenname für Rechnungsadresse | |
invoice[street] | Straßenname für Rechnungsadresse | |
invoice[houseNumber] | Hausnummer für Rechnungsadresse | |
invoice[city] | Stadt- bzw. Ortsname für Rechnungsadresse | |
invoice[postcode] | Postleitzahl für Rechnungsadresse | |
invoice[country] | Land der Rechnungsadresse als ISO 639-1 Code (in Großbuchstaben, bspw. DE) | |
note | Optionale Notiz für Bestellung | |
phone | Optionale Telefonnummer für Bestellung | |
fax | Optionale Faxnummer für Bestellung | |
vatno | Optionale Umsatzsteuernummer für Bestellung | |
articles[0] | Alle Session Artikel IDs für diese Bestellung. | |
articles[1] | ||
articles[2] | ||
articles[3] | ||
articles[...] | ||
quantities[0] | Die Bestellmengen für die im Parameter articles[] übergebenen Artikel. Der Index dieses Parameters ist hierbei analog zu dem Index in articles[]. | |
quantities[1] | ||
quantities[2] | ||
quantities[3] | ||
quantities[...] | ||
brandbox antwortet auf diese Anfrage entweder mit einer Fehlermeldung im Fehlerfall oder einem JSON-Objekt welches die übergebenen Parameter und die Eigenschaft order enthält. Darin ist die eindeutige ID dieser Bestellung enthalten.
...
Befinden sich Druckartikel in einer Bestellung, so können die Druckdaten für eine Bestellung über eine REST-Anfrage generiert werden.
| URL | https://[brandbox System-URL]/rest/v4/request/shop/order/createOrderPrintFiles/ | |
|---|---|---|
| Method | POST | |
| Header | content-type | form-data, x-www-form-urlencoded, etc. |
authorization | Durch Authentifizierung bereitgestellter Access-Token | |
| Body | orderID | Eindeutige ID der Bestellung |
force | Ist dieser Parameter auf 1 gesetzt, so werden die Druckdaten erneut generiert. | |
brandbox antwortet auf diese Anfrage entweder mit einer Fehlermeldung im Fehlerfall oder einem JSON-Objekt welches die Eigenschaft files besitzt. Darin befinden sich alle Druckartikel. Als Index wird die entsprechende Session Artikel ID genutzt, als Wert ein Dateischlüssel.
...
Die in Schritt 3 erhalten Dateischlüssel können genutzt werden um die entsprechende Druckdatei abzurufen. Hierzu muss eine GET-Anfrage an brandbox gestellt werden.
| URL | https://[brandbox System-URL]/rest/v4/request/security/download/download/ | |
|---|---|---|
| Method | GET | |
| Header | content-type | form-data, x-www-form-urlencoded, etc. |
authorization | Durch Authentifizierung bereitgestellter Access-Token | |
| Parameter | downloadFile | Der in Schritt 3 erhaltene Dateischlüssel |
encrypted | Dieser Parameter muss auf 1 gesetzt werden. Hierdurch wird angegeben, dass der genutzt Wert in downloadFile zunächst entschlüsselt werden muss. | |
Beispiel
Mithilfe des kostenlosen Tools Postman (https://www.screencast.com/t/sOLSb6HfW19) kann dieses Szenario durchgespielt werden.
...