Het is mogelijk om orders tussen (Transpas) klanten uit te wisselen volgens de TLN definitie. Dit is hier beschreven.
Vervolgens kunnen er echter ook statussen,tijden en POD’s worden uitgewisseld tussen deze partijen. Zodat de uitbestede orders in de planning worden bijgewerkt met de gerealiseerde status en tijd, en de afgetekende vrachtbrief zichtbaar wordt.
In dit artikel wordt het exporteren van de statussen beschreven. Het ontvangen van de statussen, is hier beschreven.
¶ EDI Provider
- Ga naar het scherm EDI Providers in Transpas.
- Maak een nieuwe EDI Provider aan voor de statusexport.
- Onder het tabblad Afleverstatussen (Delivery / Afleverstatussen) definieer je welke statussen geëxporteerd moeten worden:
- Vul voor elke status een afleverstatuscode in.
- Kies de richting Export.
Als dezelfde status naar meerdere partijen moet worden geëxporteerd maar onder een andere statuscode, maak dan aparte EDI Providers aan voor die partijen.
¶ Statussen
Alleen statussen waarvan aangegeven staat dat deze geëxporteerd mogen worden, worden door de export verwerkt.
- Ga naar het scherm Afleverstatussen.
- Zet bij de statussen die geëxporteerd moeten worden, het veld Exporteren op “Ja”.
- Als een bepaalde status alleen moet gelden voor sommige opdrachtgevers, gebruik dan het tabblad Opdrachtgevers binnen het scherm Afleverstatussen. Voeg de relevante opdrachtgever(s) toe en zet voor die combinatie het veld Exporteren op “Ja”.
¶ Queue
-
Open het scherm Queues en maak een nieuwe queue aan, bijvoorbeeld genaamd TLN Statusexport.
-
Kies als verwerkactie de actie 2390 – TLN Status export (of de relevante TLN‑exportactie in jouw versie van Transpas).
-
Selecteer de zojuist aangemaakte EDI Provider.
-
Bij Te behandelen queueitemtype kies je een itemtype dat hoort bij statusupdates, bijvoorbeeld Zendingstatus of Status.
- Als dat type niet bestaat, moet je het eerst aanmaken in het scherm Queueitem types.
¶ Partijen
De gemaakte queue kan vervolgens worden ingericht per klant zodat de statussen ook werkelijk worden verstuurd:
Voeg op het tabblad Queue partijen de partijen (klanten) toe naar welke de statussen moeten worden verzonden:
- Partijtype: Relatie
- Partij-omschrijving: Gekozen klant
- Medium: File (voorkeur, i.c.m. Ftp server) of Email
- Doelmap: Locatie waar statusbestand moet worden neergezet
- Bedrijf: Het bedrijf waaruit de zendingen komen
- (Optioneel) EDI Provider: Indien eerder een aparte EDI Provider is aangemaakt, vul deze dan hier in
Op tabblad Settings kan worden aangegeven van welk documenttype er documenten (POD's) moeten worden meegestuurd. Zoals onderstaand voorbeeld. Vul in het veld Waarde het documenttypenr in.
¶ Exportqueue
Wanneer er een status wordt aangemaakt in Transpas, moet deze status in de aangemaakte queue terecht komen zodat deze kan worden verwerkt en verzonden (indien het een te exporteren status betreft). Hiervoor wordt een exportqueue gebruikt.
-
Ga naar het scherm Exportqueues.
-
Controleer of er al een queue bestaat van het type Cargo status logs.
- Zo niet: maak er een aan.
- Stel in dat Type = Cargo status logs, en Doelqueue = de eerder aangemaakte queue voor de statusexport.
- Stel Doelqueue itemtype in als hetzelfde type als het Te behandelen queueitemtype van de queue.
-
Op het tabblad General van de exportqueue:
- Maak een regel aan met Tabel = Cargo status log
- Stel Modification statements in op slechts INSERT (alleen nieuwe records worden geëxporteerd).
-
Op het tabblad Fields (meestal in hetzelfde scherm) voeg je toe welke velden in het exportbestand moeten komen, bijvoorbeeld:
- CargoStatusLognr
- DeliveryStatus
- (en eventueel andere relevante velden zoals datum/tijd, EDI referentie, etc.)
De volledige export queue ziet er dan bijvoorbeeld als volgt uit:
¶ Activeren
Er staat nu nog een geel driehoekje vooraan de regel van de exportqueue.
Dit betekent dat de exportqueue nog niet is geïnitialiseerd.
Druk daarvoor op de groene pijltjes bovenin het scherm. 
De exportqueue is nu actief. Zet ook de queue op Actief = Ja.
De statusexport is nu in zijn geheel actief.
Zodra er een afleverstatus, die gemarkeerd staat als te exporteren, wordt toegevoegd aan een zending, en de klant is toegevoegd als partij, wordt er een status xml gegenereerd die wordt verstuurd naar de betreffende partij.
¶ Output
Met de TLN statusexport wordt een xml-bestand gemaakt.
Hieronder een voorbeeld van hoe dit bestand er uit komt te zien.
| dateTime | Standaard type AT. Toont de datum en het tijdstip van de status. |
| id | Unieke nummer van de zending. Bij type NOC is dit de EDI referentie van de zending. Bij type SHP is de EDI referentie leeg en wordt hier het legnr ingevuld. |
| status | De (aflever)statuscode. |
¶ Optioneel
Onderstaande velden worden meegegeven indien gevuld.
| name | Waarde uit veld Cmr getekend door van de zending |
| signature | Gekoppelde POD (in base64 formaat) |
| note | Waarde uit het veld Informatie van de afleverstatus |
| senderid | Code van de afzender. Vastgelegd bij de EDI provider, op het tabblad Relatie. Veld Relatiecode |
| receiverid | Code van de ontvanger. Vastgelegd bij de EDI provider, tabblad Relatie. Veld Mijn ext. code bij relatie |
¶ 🎯 Uitleg: destination queueitemtypes & exportqueues
-
Queueitem types: Dit zijn de types van items die in een queue behandeld worden. Voor statusexport is dit vaak een type zoals Zendingstatus, DeliveryStatus, of een specifieke naam binnen jouw inrichting. Deze types zorgen ervoor dat alleen de juiste soort gegevens in de queue belanden.
-
Doelqueue / Doelqueueitemtype: de queue waar de items naartoe gaan om geëxporteerd te worden. In de instellingen van de exportqueue geef je aan welke queue het doel is én welk itemtype gebruikt wordt om te exporteren.
-
Exportqueue in het algemeen:
De exportqueue is het proces dat gegevens uit Transpas verzamelt en klaarmaakt voor verzending (export). Hij “luistert” naar nieuwe statusmeldingen (in de logtabel, bv.Cargo status log), creëert XML of het gewenste bestandsformaat, en plaatst dit bestand in de queue of op de opgegeven bestemming (FTP, file share, etc.).
Zie apart artikel over Exportqueue's
¶ ✅ Samenvatting & best practices
- Zorg dat statussen in Afleverstatussen correct zijn ingesteld met Exporteren = Ja.
- Per klant/partij nagaan wie welke statussen wil ontvangen.
- Controleer of queueitemtypes correct zijn gedefinieerd.
- Test de export met een paar zendingen om zeker te zijn dat alles werkt zoals verwacht (XML structuur, POD meegegeven, tijdstippen etc.).
- Documenteer welke EDI Providers, klanten, statussen en exportqueues actief zijn, zodat bij storingen snel duidelijk is wat waar fout gaat.