Webhooks

La pestaña Webhooks permite configurar direcciones especiales a las que se enviará la información sobre las acciones realizadas al servicio externo.

Opciones disponibles

Aquí está la lista de opciones disponibles con una breve explicación.

Webhook tras solicitud

Especifica la dirección URL a la que se enviará una solicitud de tipo POST con la información del pedido en formato JSON.

Truco

Al realizar la integración, por favor, tenga en cuenta el hecho de que no ofrecemos versionado de la estructura de datos en webhooks. Como resultado, pueden aparecer nuevas variables en los datos devueltos. Confiar en una estructura de datos 1:1 puede dar lugar a errores en el futuro. La opción más segura es recuperar cada variable de la cadena JSON por separado y no, por ejemplo, suponer que el objeto address no se rellenará con información adicional en el futuro.

ejemplo de formato de datos enviados por 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"
      }
   ]
}