logo

API: order_message

>> zurück zur Liste aller Schnittstellen

Beschreibung Versand einer Nachricht an den Kunden
URL https://api.booklooker.de/2.0/order_message?token=REST_API_TOKEN
REST_API_TOKEN = Der von der Authentifizierung zurückgelieferte Token.
Methode PUT
Version 2.0

Parameter

Name Beschreibung Optional? Default-Wert
orderId Interne booklooker orderId der Bestellung, wird von der Schnittstelle order zurückgeliefert. Nein –
messageType

Art der Nachricht, mögliche Werte

WertBeschreibung
PAYMENT_INFORMATIONZahlungsinformationen senden
PAYMENT_REMINDERZahlungserinnerung senden
SHIPPING_NOTICEVersandmitteilung senden
Nein –
additionalText Zusätzlicher Text, der in die Nachricht aufgenommen wird Ja –

Rückgabe

Status Rückgabewert Beschreibung
OK Zurückgegeben wird der Nachrichtentext, der an den Kunden per Mail versandt wurde.
NOK INVALID_ORDERID Der Parameter orderId fehlt oder ist nicht korrekt angegeben.
NOK INVALID_MESSAGE_TYPE Der Parameter messageType fehlt oder ist nicht korrekt angegeben.
NOK NOT_FOUND Die orderId wurde nicht gefunden.
NOK NO_RECIPIENT Es ist kein Handelspartner für diesen Verkauf eingetragen.
NOK NO_ARTICLES Alle im Verkauf enthaltenen Artikel sind storniert.
NOK ALREADY_SENT Die Nachricht dieses Typs wurde bereits versandt (nur bei Versandmitteilungen).
NOK TIME_RESTRICTION Zeitliche Beschränkungen verhindern den Versand der Nachricht. Es gelten folgende Regeln:
  • Zahlungsinformationen können nur alle 7 Tage verschickt werden.
  • Zahlungserinnerungen können nur alle 7 Tage verschickt werden.
  • Eine Zahlungserinnerung kann frühestens am 7. Tag nach der Bestellung verschickt werden.
NOK ENCODING_ERROR Die Rückgabe enthält ungültige Zeichen.
NOK INVALID_INTERFACE Es wurde eine ungültige Schnittstelle verwendet.
NOK INVALID_REQUEST_METHOD Die Schnittstelle wurde mit einer ungültigen HTTP-Methode aufgerufen.
NOK QUOTA_EXCEEDED Die maximale Anzahl Abfragen/Minute wurde überschritten.
NOK SERVER_DOWN Aufgrund von Wartungsarbeiten ist die REST API momentan nicht verfügbar.
NOK TEMPORARILY_BLOCKED Der Zugang wurde vorübergehend gesperrt, bitte wenden Sie sich an unseren Kundensupport.
NOK TOKEN_EXPIRED Der Token ist nicht mehr gültig, eine erneute Authentifizierung ist notwendig.
NOK TOKEN_MISSING Der Token ist leer oder nicht vorhanden.
NOK TOKEN_UNKNOWN Der Token wurde nicht gefunden.