Webhook

You can specify a webhook URL in the 2nd step (Pre-order a delivery). An HTTPS POST will then be made for each of the following events (event):

  • state_changed : change of delivery status
  • slot_updated : change of the day or time of delivery
  • address_updated : change of address

The different statuses that can trigger the event state_changed: pre_ordered, confirmed, picked_up, pick_up_failed, delivered, delivery_failed, package_return and canceled

Header HTTP

By default we don’t have any specific header. If you want to secure your endpoint, it is possible to send us one (or more) key-value pair that we will add into the header of each call.

SSL Certificate

The specified URL must use a valid SSL certificate.

{
  "delivery": {
    "uuid": "dabf2570-1e2c-4cc2-9293-28cad7444c41",
    "primary_order_reference": "12345",
    "secondary_order_reference": "",
    "packaging": {
      "global_description": "",
      "packaging_ref": "",
      "width": 10,
      "length": 10,
      "height": 10,
      "weight": 10,
      "packets_quantity": 5,
      "packets": []
    },
    "route": [
      {
        "type": "pickup",
        "location": {
          "type": "store",
          "society": "Lambda",
          "name": "John DOE",
          "first_name": "John",
          "last_name": "DOE",
          "line1": "271 rue de Solférino",
          "line2": "",
          "postal_code": "59000",
          "city": "Lille",
          "country": "France",
          "additional_informations": "",
          "primary_phone": "0707070707",
          "secondary_phone": "",
          "email": "john.doe@lambda.com",
          "store_code": "123"
        },
        "calendar": {
          "starts_at": "2018-10-10T15:00:00Z",
          "ends_at": "2018-10-10T17:00:00Z"
        }
      },
      {
        "type": "shipping",
        "location": {
          "type": "address",
          "society": "",
          "name": "Will SMITH",
          "first_name": "Will",
          "last_name": "SMITH",
          "line1": "2 Avenue des Saules",
          "line2": "BATIMENT Doge",
          "postal_code": "59160",
          "city": "LILLE",
          "country": "FRANCE",
          "additional_informations": "Euratechnologies",
          "primary_phone": "0606060606",
          "secondary_phone": "",
          "email": "will.smith@colisweb.com"
        },
        "calendar": {
          "starts_at": "2018-10-10T15:00:00Z",
          "ends_at": "2018-10-10T17:00:00Z"
        }
      }
    ],
    "status": {
      "global": "delivered",
      "pickup_problems": [],
      "shipping_problems": []
    },
    "post_purchase_url": "https://sandbox.api.colisweb.com/p/dabf2570-1e2c-4cc2-9293-28cad7444c41",
    "required_skills": []
  },
  "event": "state_changed"
}