Track & Trace webhook

Via de Track&Trace webhook is het mogelijk om automatisch real-time updates te ontvangen over de status van jouw pakketten. Zodra er iets wijzigt in de status van een van je pakketten, (bv als het pakket is bezorgt, de bezorger onderweg is, de ontvanger getekend heeft voor ontvangst etc.), dan maakt de webhook koppeling het mogelijk om hier automatisch een bericht van te krijgen

Hoe kan ik gebruik maken van de webhook koppeling ?

Als je gebruik wilt maken van onze webhook dan dien je aan jouw kant een webserver te hebben geconfigureerd welke direct benaderbaar is vanaf het internet. Als je deze URL aan GLS doorgeeft dan versturen wij je real-time updates voor al je pakketten. We doen dit d.m.v. een HTTP post waarin we een JSON bestand in de body van het HTTP request meesturen. Dit JSON bestand bevat alle details van 1 pakket.

Voor elke update van elk pakket sturen we je dus een HTTP request met het JSON bestand van dat pakket. Het is belangrijk dat je dit snel afhandelt en een HTTP status code 200 teruggeeft. Gebeurt dit niet dan proberen we het nog een aantal maal met steeds langere tussen periodes. Lukt het na een paar dagen nog niet dan wordt de webhook gestopt. Je zult dan contact moeten opnemen met GLS om aan te geven dat je webserver het weer doet, en dan zullen we de transmissie hervatten

Pakket- en Handtekeningen webhooks

GLS biedt twee webhooks aan, een webhook voor het ontvangen van updates betreffende pakket details en een webhook voor het ontvangen van handtekeningen. Je kan zelf kiezen welke je hiervan wel/niet wilt ontvangen. Indien je beide wilt gebruiken dan dien je voor beide een aparte URL aan GLS door te geven.

De Pakket updates webhook verstuurt real-time updates over de pakket details, zoals b.v. de huidige status van het pakket (ontvangen, onderweg, afgeleverd,...)

De handtekeningen webhook verstuurd de handtekening die een ontvanger geeft bij ontvangst van een pakket. Deze handtekening wordt in de vorm van een .png plaatje doorgegeven aan de webhook

JSON Documentatie

Wil je meer weten hoe het JSON bestand er precies uitziet en welke informatie je kan verwachten ?

Download dan deze pdf, welke de complete JSON structuur beschrijft

Voorbeeld JSON van Pakket update

Hieronder vindt je een voorbeeld hoe de JSON van een pakket update eruit ziet. Voor meer informatie zie de PDF hierboven

POST https://yourserver.com/yoururl
{
  "id":"12345678901234.ABCDEFGH",
  "CustNo":"12345678",
  "ParcelNo":"12345678901234",
  "UniqueNo":"12345678",
  "ShipmentParcelNo":"12345678901234",
  "ShipmentUniqueNo":"ABCDEFGH",
  "GpNo":"987654321098",
  "JobDate":"2024-04-29T22:00:00Z",
  "InitialDate":"2024-04-29T22:00:00Z",
  "Events":[
   {
      "EventId":"2404300000NWFA",
      "EventNo":0,
      "ReasonNo":100,
      "DescriptionNL":"Aangekondigd bij GLS",
      "DescriptionEN":"The parcel data was entered into the GLS IT system; the parcel was not yet handed over to GLS.",
      "Country":"NL",
      "CountryName":"Nederland",
      "Depot":"NL0100",
      "DepotName":"Hub Utrecht",
      "Date":"2024-04-30T13:22:40.229Z",
      "IsPhysical":false
    },
    {
      "EventId":"2404300000YPEF",
      "EventNo":0,
      "ReasonNo":0,
      "DescriptionNL":"Pakket ontvangen door GLS",
      "DescriptionEN":"The parcel was handed over to GLS.",
      "Country":"NL",
      "CountryName":"Nederland",
      "Depot":"NL8000",
      "DepotName":"Zwolle",
      "Date":"2024-04-30T19:01:51.725Z",
      "IsPhysical":true
    },
    {
      "EventId":"24043000012PDS",
      "EventNo":90,
      "ReasonNo":155,
      "DescriptionNL":"Bericht - Email aankondiging FlexDelivery",
      "DescriptionEN":"Email with delivery advice notification",
      "Country":"-",
      "CountryName":"",
      "Depot":"GLS001",
      "DepotName":"-",
      "Date":"2024-04-30T19:23:31Z",
      "IsPhysical":false
    },
    {
      "EventId":"2405010000BU0T",
      "EventNo":26,
      "ReasonNo":928,
      "DescriptionNL":"Wegzettoestemming op hetzelfde adres",
      "DescriptionEN":"Shipment locked/Grant deposit permission",
      "Country":"DE",
      "CountryName":"Duitsland",
      "Depot":"DE 870",
      "DepotName":"Schaafheim DE 870",
      "Date":"2024-05-01T07:33:13Z",
      "IsPhysical":false
    },
    {
      "EventId":"2405020000ANFF",
      "EventNo":2,
      "ReasonNo":0,
      "DescriptionNL":"Aangekomen op GLS depot",
      "DescriptionEN":"The parcel has reached the parcel center.",
      "Country":"DE",
      "CountryName":"Duitsland",
      "Depot":"DE 050",
      "DepotName":"RUP Köln DE 050",
      "Date":"2024-05-02T08:51:43Z",
      "IsPhysical":true
    },
    {
      "EventId":"2405030000D4G8",
      "EventNo":11,
      "ReasonNo":0,
      "DescriptionNL":"Onderweg - geladen voor aflevering",
      "DescriptionEN":"The parcel is expected to be delivered during the day.",
      "Country":"DE",
      "CountryName":"Duitsland",
      "Depot":"DE 870",
      "DepotName":"Schaafheim DE 870",
      "Date":"2024-05-03T05:54:29Z",
      "IsPhysical":true
    }
  ],
  "Addresses":[ ],
  "Length":52.0,
  "Height":7.0,
  "Width":25.0,
  "SuppliedWeight":1.0,
  "WeightedWeight":0.85,
  "Product":"EuroBusinessSmallParcel",
  "CustomerReference":"2243126324035714",
  "State":"OutForDelivery",
  "SubState":"None",
  "Eta":{
    "StartTime":"2024-05-02T11:51:43Z",
    "EndTime":"2024-05-02T13:51:43Z",
    "Stops":5,
    "Latitude":null,
    "Longitude":null
  }, 
  "Ndis":[
     {
        "Type":"SPICHPCLNUM",
        "Number":"994010486088977391
     }
  ], 
  "FinalLocCode":"DE 870",
  "DeliveryCountry":"",
  "DeliveryZipcode":"",
  "DeliveryName":"",
  "StopId":"",
  "StopIdDateTime":0,
  "Uri":"https://test.gls-info.nl//track-and-trace?parcelno=12345678901234&zipcode=63599",
  "CarrierIntegrator":"some carrier",
  "_ts":1714720563
}