Transcon Express Partner biedt de mogelijkheid om op een REST API/webhook transportorders te ontvangen die een TMS-eigenaar aan u uitbesteedt, en om statusupdates terug te sturen.
Deze pagina bevat in stappen de technische uitleg om (eenmalig) aan te melden en de webhook in te stellen. Daarna volgt een uitleg hoe een orderbericht eruit ziet en welke statussen er doorgegeven kunnen worden.
Basis URL:
https://transcon.nl/api/v1/express
https://transcon.nl/api/v1/express
Snel starten? Gebruik dan de Postman collectie of de n8n workflow:
Liever naar de niet technische uitleg?
klik hier
klik hier
Aanmelden
Het aanmelden gebeurt eenmalig met een sleutel, een partnernummer en een naam. Deze gegevens ontvangt u van de TMS-eigenaar. De sleutel wordt bij het aanmelden als bearer token gebruikt.
Authorization: Bearer dfafa342dfsadf...
/onboarding
{ "partnerNr": "11111", "partnerName": "Apada" }
Er komt een token terug, deze token gebruikt u, ook weer als bearer token, in alle andere aanroepen:
{ "token": "persoonlijke-token" }
Instellingen: webhook configureren
Na het aanmelden ontvangt u de toegekende orders op een webhook. U kunt deze webhook zelf instellen via een JSON POST naar het settings-endpoint.
In de instellingen geeft u de URL op van de webhook waarop de orderberichten gepost mogen worden, samen met een token of een gebruikersnaam-/wachtwoordcombinatie. Bij gebruik van een token worden de berichten verstuurd met dit token als bearer token. Bij gebruik van een gebruikersnaam-/wachtwoordcombinatie wordt basic authentication toegepast met deze gegevens.
De technische contactgegevens worden gebruikt om contact op te nemen als orderberichten niet verwerkt kunnen worden.
/settings
Authorization: Bearer persoonlijke-token
{ "webhook": { "url": "https://example.com/webhook", "token": "your-webhook-token", "username": "webhook-user", "password": "secure-password-123" }, "technicalContact": { "name": "Jan Jansen", "email": "tech@example.com" } }
Retour: http code 200 (OK) of 401 (Unauthorized)
Orders en statussen
Transportorder ontvangen
U bent nu klaar om een order te ontvangen. Als de planner een order aan u uitbesteed wordt deze naar de webhook verstuurd in het volgende formaat:
{ "account": { "number": "1", "name": "Apada" }, "transportOrder": [ { "reference": "113168", "pickup": { "address": { "name": "Noordelijke Productie BV", "address": "Productieweg", "number": "75", "postalCode": "1013 AB", "city": "Amsterdam", "countryCode": "NL", "contact": "Jan de Vries", "email": "j.devries@noordproductie.nl", "phone": "+31 20 1234567" }, "date": "2026-04-05", "timeBegin": "07:00:00", "timeEnd": "08:30:00", "instructions": "Gebruik oostelijke laadplein. Beveiligingspas vereist." }, "delivery": { "address": { "name": "Centrale Distributie Nederland", "address": "Industrieterrein West", "number": "350", "postalCode": "3044 AB", "city": "Rotterdam", "countryCode": "NL", "contact": "Maria Jansen", "email": "m.jansen@centraledistributie.nl", "phone": "+31 10 9876543" }, "date": "2026-04-06", "timeBegin": "11:00:00", "timeEnd": "13:30:00", "instructions": "Dock 12 gereserveerd. Kraanbediende staat klaar." }, "goods": [ { "count": 2, "type": "Euro pallet", "length": 120, "width": 80, "height": 220, "weight": 1200, "description": "Industriële machineonderdelen - zware apparatuur", "barcode": [ "NL001122334", "NL001122335" ] }, { "count": 3, "type": "Kist", "length": 80, "width": 60, "height": 45, "weight": 35, "description": "Precisiegereedschap en accessoires", "barcode": [ "NL556677889", "NL556677890", "NL556677891" ] } ] } ] }
Als uw webhook geen 2xx-response teruggeeft, probeert Transcon het bericht een uur lang elke 60 seconden opnieuw aan te bieden. Daarna volgt een e-mail op het technische contactadres.
Retourberichten
We gaan er vanuit dat u de order hebt ontvangen en verwerkt. De TMS-eigenaar verwacht nu statusupdates over de order in retourberichten. Geen enkel retourbericht is verplicht, maar hoe meer berichten, hoe beter uw opdrachtgever op de hoogte is van de voortgang. In alle berichten staat een orderNo, deze dient gelijk te zijn aan de reference van de originele order. De reference in het retourbericht mag u zelf bepalen, bijvoorbeeld uw ordernummer.
Bevestiging van verwerking
Bevestiging dat u de order hebt ontvangen.
{ "header": { "type": "Confirmation", "timestamp": "2026-04-21T16:34:36.4941474+02:00", "reference": "TO-2026-001", "orderNo": 113168 } }
Acceptatie
Bevestiging dat u de order hebt geaccepteerd.
{ "header": { "type": "Accepted", "timestamp": "2026-04-21T16:34:38.3956996+02:00", "reference": "TO-2026-001", "orderNo": 113168 } }
Planning / verwachtte aankomst
Bericht dat de order is ingepland, indien mogelijk met een track & trace link.
Als alleen het ophalen nog maar is ingepland mag het delivery deel leeg zijn
{ "header": { "type": "Eta", "timestamp": "2026-04-21T16:34:38.8628699+02:00", "reference": "TO-2026-001", "orderNo": 113168 }, "pickup": { "date": "2026-04-22", "timeWindowBegin": "09:00:00", "timeWindowEnd": "11:00:00" }, "delivery": { "date": "2026-04-23", "timeWindowBegin": "14:00:00", "timeWindowEnd": "16:00:00" }, "trackAndTraceUrl": "https://tracker.nu/3sgdsd2" }
Scans
Bericht dat de goederen zijn gescand, bijvoorbeeld bij laden, overslag of afleveren.
De timestamp is het tijdstip van de verwerking, datetimeScanned is het tijdstip van de scan zelf.
{ "header": { "type": "Scan", "timestamp": "2026-04-21T16:07:31.9672604+02:00", "reference": "TO-2026-001", "orderNo": 113168 }, "dateTimeScanned": "2026-04-21T16:07:31+02:00", "type": 2, "barcode": "NL556677891", "location": { "city": "Wezep", "countryCode": "NL", "position": { "latitude": 52.4571, "longitude": 5.9984 } } }
Ophalen gereed
Bericht dat ophalen van de goederen is afgerond.
{ "header": { "type": "PickupCompleted", "timestamp": "2026-04-21T16:34:39.4591111+02:00", "reference": "TO-2026-001", "orderNo": 113168 }, "dateTimeCompleted": "2026-04-21T16:34:39+02:00", "successful": true }
Levering gereed
Bericht dat de levering van de goederen is afgerond. Als er een ontvanger is ingevuld staat deze bij acceptedBy, als er een handtekening is gezet staat deze als base64 PNG bij signature.
{ "header": { "type": "DeliveryCompleted", "timestamp": "2026-04-21T16:34:39.9937597+02:00", "reference": "TO-2026-001", "orderNo": 113168 }, "dateTimeCompleted": "2026-04-21T16:34:39+02:00", "acceptedBy": "Marcel", "signature": "iVBORw0KGgoAAAANSUhEUgAA.....Vc2UAxwAAAABJRU5ErkJggg==", "successful": true }
Versiebeheer
Wijzigingen die niet “breaking” zijn worden onder dezelfde versie (/v1/) gedaan. Als er wijzigingen zijn die ook aanpassing van de versturende partij eisen wordt dat onder een nieuw endpoint (/v2/ ..) gedaan.