Webhaken

Die Registerkarte Webhooks erlaubt es Ihnen, spezielle Adressen einzurichten, an die die Informationen über durchgeführte Aktionen an den externen Dienst übermittelt werden.

Verfügbare Optionen

Hier ist die Liste der verfügbaren Optionen mit einer kurzen Erläuterung.

Webhook nach Bestellung

Spezifiziert die URL-Adresse, an die eine Anfrage vom Typ POST mit Bestellinformationen im JSON-Format gesendet wird.

Tip

Bitte beachten Sie bei der Integration, dass wir keine Versionierung der Datenstruktur in Webhooks anbieten. Dies hat zur Folge, dass neue Variablen in den zurückgegebenen Daten auftauchen können. Sich auf eine 1:1-Datenstruktur zu verlassen, kann in der Zukunft zu Fehlern führen. Die sicherste Option ist es, jede Variable aus dem JSON-String separat abzurufen und nicht davon auszugehen, dass z.B. das Adresse-Objekt nicht in der Zukunft mit zusätzlichen Informationen gefüllt wird.

Beispiel für das Datenformat, das vom Webhook gesendet wird.

{
   "encoded_id":"123-456-789",
   "number":"123/03/2020",
   "total_price":"138.45",
   "total_copies": "3",
   "total_photos": "2",
   "buyer":{
      "email": "test@email.com",
      "phone": "+48 000 000 000",
      "comment": "Comment on order",
      "address":{
         "parcel_locker":null,
         "is_company": "0",
         "company_name":null,
         "company_nip":null,
         "name": "Jan Kowalski",
         "street": "9 Jasmine Street",
         "postcode": "12-345",
         "city": "Cracow",
         "country": "Poland"
      }
   },
   "delivery":{
      "id": "2",
      "name": "Personal collection (Online payment)",
      "price": "15.00"
   },
   "coupon":{
      "code":null,
      "price":null
   },
   "items":[
      {
         "size_id": "3",
         "size_folder":"13x18",
         "file_name":"Photo101.jpg",
         "copies": "1",
         "paper": "matte",
         "price": "23.25"
      },
      {
         "size_id": "1",
         "size_folder":"9x13",
         "file_name":"Photo022.jpg",
         "copies": "2",
         "paper": "glossy",
         "price": "50.10"
      }
   ]
}