Webhooki

Zakładka Webhooki pozwala na ustawienie specjalnych adresów, na które będą przekazywane informacje o wykonanych akcjach do zewnętrznej usługi.

Dostępne opcje

Oto lista dostępnych opcji wraz z krótkim objaśnieniem.

Webhook po złożeniu zamówienia

Określa adres URL, na który zostanie wysłane żądanie typu POST z informacjami o zamówieniu w formacie JSON.

Przycisk Wyślij testowe żądanie pozwala sprawdzić, czy podany adres poprawnie odbiera dane - jeszcze przed złożeniem prawdziwego zamówienia. Dodatkowo przy każdym zamówieniu na liście zamówień dostępny jest przycisk Wyślij webhook, który pozwala ponownie wysłać dane konkretnego zamówienia.

Wskazówka

Podczas dokonywania integracji, prosimy wziąć pod uwagę fakt, że nie oferujemy wersjonowania struktury danych w webhookach. A co za tym idzie - w zwracanych danych mogą pojawić się nowe zmienne. Poleganie na strukturze danych 1:1 może prowadzić do błędów w przyszłości. Najbezpieczniejszym wyjściem jest pobieranie każdej zmiennej z ciągu JSON osobno a nie np. zakładanie, że obiekt address nie zostanie uzupełniony o dodatkowe informacje w przyszłości.

Przykładowy format danych wysłany przez webhook.

{
   "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":"Komentarz do zamówienia",
      "address":{
         "parcel_locker":null,
         "is_company":"0",
         "company_name":null,
         "company_nip":null,
         "name":"Jan Kowalski",
         "street":"ul. Jaśminowa 9",
         "postcode":"12-345",
         "city":"Kraków",
         "country":"Polska"
      }
   },
   "payment_percentage":null,
   "payment_percentage_price":null,
   "cart":{
      "1":{
         "total_price":"123.45",
         "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"
            }
         ]
      }
   },
   "delivery":{
      "id":"2",
      "name":"Odbiór osobisty (Płatność online)",
      "price":"15.00"
   },
   "coupon":{
      "code":null,
      "price":null
   },
   "services":{
      "photo_correction":"0",
      "photo_correction_price":null

}