Die REST-API erlaubt das direkte Anlegen einer Bestellung über die PRINT LOUNGE. Eine Bestellung kann beliebig viele Bestellpositionen enthalten. Auch umfangreiche Nutzer-, Adress- und Zusatzinformationen können direkt mitgegeben werden.
Endpunkt zur Ausführung von Personalisierungsvorgängen
wide760Parameterübersicht
Bestellebene
Parameter | Typ | Beschreibung |
|---|---|---|
| string | Beschreibung oder Titel der Bestellung |
| string | Externe Referenznummer (z. B. aus eigenem System) |
| string | Individuelle Kennzeichnung, z. B. Projektcode |
| array | Liste zusätzlicher Schlüssel-Wert-Infos (siehe unten) |
| string | Sprachkennung (z. B. |
| string | Fortlaufende Bestellnummer (wird automatisch vergeben) |
| int | Interner Statuscode für Produktionsfortschritt |
| int | Transaktionsgebühr (in Cent, optional) |
| string | Freitext / Bemerkung zur Bestellung |
| object | Versandinformationen (optional) |
| object | Benutzerinformationen (siehe unten) Wird in der API-Anfrage keine ID übertragen, dafür aber ein Benutzername und eine E-Mail-Adresse wird automatisch ein neuer Benutzer angelegt oder ein passender Benutzer mit der hinterlegten E-Mail-Adresse verwendet. |
| int | Bestellstatus ( |
| int | Zahlungsstatus |
| int | Verwendetes Budget (optional) |
| string | Umsatzsteuer-ID (optional) |
Lieferadresse (deliverAddress)
Parameter | Typ | Beschreibung |
|---|---|---|
| string | Firmenzeile 1 |
| string | Firmenzeile 2 |
| string | Länderkürzel (z. B. |
| string | ISO-Code (optional) |
| string | Abteilung |
| string | E-Mail-Adresse |
| string | Faxnummer |
| string | Vorname |
| string | Nachname |
| string | Name gesamt (wenn |
| string | Straße + Hausnummer |
| string | Telefonnummer |
| string | Anrede oder Titel |
| string | Ort |
| string | Postleitzahl |
(Gleiches gilt für invoiceAddress)
Bestellpositionen (items[])
Parameter | Typ | Beschreibung |
|---|---|---|
| int | Artikel-ID |
| string | Artikelnummer |
| array | Array aus |
| object | Personalisierungsdaten, z. B. |
| int | Menge der Position |
| string | Status der Position (z. B. |
| string | Titel / Name der Position |
| int | Gesamtpreis in Cent Dieser Betrag wird automatisch anhand der übertragenen Menge berechnet. Wird eine ungültige Menge übergeben, gibt die API eine Fehlermeldung zurück. |
| int | Typ der Position (1 = regulär etc.) |
Zusatzinfos zur Bestellung (orderInfo[])
Parameter | Typ | Beschreibung |
|---|---|---|
| string | Bezeichnung |
| mixed | Beliebige Daten (z. B. JSON, Text) |
Beispiel-Request
Bei der Anlage einer Bestellposition kann zur Ermittlung des Artikels entweder die ID (article.id), oder aber die Artikelnummer (article.sapNumber) angegeben werden (ab Release 8.20.x verfügbar).
wide760Rückgabe / Response
Das Response-Objekt enthält die vollständige Bestellung, , den HTTP-Statuscode sowie eventuell aufgetretene Fehler. Im Erfolgsfall wird der Statuscode 200 mit leeren Error-Angaben zurückgegeben, im Fehlerfall werden die Fehler möglichst detailliert aufgeführt.
wide760