Ganci web

La scheda Webhooks permette di impostare indirizzi speciali a cui inviare le informazioni sulle azioni eseguite al servizio esterno.

Opzioni disponibili

Ecco l’elenco delle opzioni disponibili con una breve spiegazione.

Webhook dopo l’ordine

Specifica l’indirizzo URL a cui verrà inviata una richiesta di tipo POST con informazioni sull’ordine in formato JSON.

Suggerimento

Quando si esegue l’integrazione, si tenga conto del fatto che non offriamo il versioning della struttura dei dati nei webhook. Di conseguenza, nei dati restituiti potrebbero comparire nuove variabili. Affidarsi a una struttura di dati 1:1 può portare a errori in futuro. L’opzione più sicura è quella di recuperare ogni variabile dalla stringa JSON separatamente e di non dare per scontato, ad esempio, che l’oggetto indirizzo non sarà popolato con informazioni aggiuntive in futuro.

esempio di formato dei dati inviati dal 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": "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"
      }
   ]
}