Documentatie
Systeembeheer
Transportopdrachten importeren via de api van FiLogic OpenTMS?
FiLogic OpenTMS biedt een naadloze integratie van transportopdrachten via zijn krachtige API. Met de mogelijkheid om transportopdrachten te importeren die voldoen aan de OpenTripModel standaard, stelt het platform gebruikers in staat om efficiënt en gestructureerd hun logistieke activiteiten te beheren.
Door gebruik te maken van deze functionaliteit kunnen bedrijven moeiteloos hun transportopdrachten synchroniseren met FiLogic OpenTMS, waardoor ze profiteren van een geoptimaliseerde en gestroomlijnde workflow. Met deze robuuste integratie kunnen gebruikers zich richten op het verbeteren van hun operationele processen en het maximaliseren van hun logistieke efficiëntie.
Wat is het OpenTripModel (OTM)?
Het OpenTripModel (OTM) is een gestandaardiseerd datamodel dat wordt gebruikt om transportgerelateerde informatie te structureren en te organiseren. Het is ontworpen om verschillende aspecten van transport, zoals routes, haltes, schema's en modaliteiten, op een consistente en interoperabele manier vast te leggen.
Door het gebruik van OTM kunnen verschillende systemen en platforms naadloos communiceren en informatie uitwisselen, waardoor de uitwisselbaarheid en compatibiliteit tussen verschillende reis- en transporttoepassingen wordt verbeterd. Het biedt een gemeenschappelijke basis voor het uitwisselen en delen van transportinformatie, waardoor het gemakkelijker wordt voor logistieke software om innovatieve oplossingen te creëren die gebaseerd zijn op transportgegevens.
Meer informatie over het OpenTripModel vind je op www.opentripmodel.org. De specificatie vind je op otm5.opentripmodel.org.
De OTM Transportopdracht
Wanneer je een transportopdracht wilt importeren in FiLogic OpenTMS, stuur je een OTM TransportOrder naar de Open API van FiLogic OpenTMS. Een voorbeeld van een OTM TransportOrder vind je hieronder:
{
"id": "962b0f04-ee6a-e66e-742b-3a1121863fb2",
"name": "O-240003",
"creationDate": "2024-03-05T16:01:41.8586983Z",
"consignments": [
{
"associationType": "inline",
"entity": {
"status": "accepted",
"goods": [
{
"associationType": "inline",
"entity": {
"id": "634009a6-b5db-2d7a-e1a1-3a1121863fd3",
"packagingMaterial": "Europallet",
"type": "transportEquipment",
"quantity": 1,
"weight": {
"unit": "KG",
"value": 64
}
}
}
],
"actions": [
{
"associationType": "inline",
"entity": {
"actionType": "load",
"lifecycle": "actual",
"location": {
"associationType": "inline",
"entity": {
"id": "34825a8b-5364-0aa8-9aed-3a112185ed0d",
"name": "UFC Transport",
"type": "customer",
"geoReference": {
"type": "latLonPointGeoReference",
"lat": 52.3546255,
"lon": 4.7850692,
"bearingType": "absolute"
},
"administrativeReference": {
"name": "UFC Transport",
"street": "Akerwateringstraat 115",
"postalCode": "1069GC",
"city": "Amsterdam",
"country": "NL"
}
}
},
"startTime": "2024-03-05T03:00:00Z",
"endTime": "2024-03-05T05:00:00Z",
"id": "e1391754-01b6-9d48-6d92-3a1121863fd3",
"name": "FTHZZY-947"
}
},
{
"associationType": "inline",
"entity": {
"actionType": "unload",
"lifecycle": "actual",
"location": {
"associationType": "inline",
"entity": {
"type": "customer",
"geoReference": {
"type": "latLonPointGeoReference",
"lat": 52.356867,
"lon": 4.6659731,
"bearingType": "absolute"
},
"administrativeReference": {
"name": "AJM Transport",
"street": "Tobias Asserstraat 2",
"postalCode": "2037JA",
"city": "Haarlem",
"country": "NL"
},
"id": "a00caf28-f079-e231-d30b-3a112185ee94",
"name": "AJM Transport"
}
},
"startTime": "2024-03-05T11:00:00Z",
"endTime": "2024-03-05T13:00:00Z",
"id": "5a495df3-4f24-2622-1303-3a1121863fd3",
"name": "RBLKCR-644",
"externalAttributes": {},
"creationDate": "2024-03-27T13:34:33.4701705Z"
}
}
],
"name": "BKO-8602/2",
}
},
{
"associationType": "inline",
"entity": {
"status": "accepted",
"goods": [
{
"associationType": "inline",
"entity": {
"id": "78d78dd6-21bf-a65e-4c0b-3a11218640d4",
"packagingMaterial": "Europallet",
"type": "transportEquipment",
"quantity": 12,
"weight": {
"unit": "KG",
"value": 169
}
}
}
],
"actions": [
{
"associationType": "inline",
"entity": {
"actionType": "load",
"lifecycle": "actual",
"location": {
"associationType": "inline",
"entity": {
"id": "34825a8b-5364-0aa8-9aed-3a112185ed0d",
"name": "UFC Transport",
"type": "customer",
"geoReference": {
"type": "latLonPointGeoReference",
"lat": 52.3546255,
"lon": 4.7850692,
"bearingType": "absolute"
},
"administrativeReference": {
"name": "UFC Transport",
"street": "Akerwateringstraat 115",
"postalCode": "1069GC",
"city": "Amsterdam",
"country": "NL"
}
}
},
"startTime": "2024-03-05T09:00:00Z",
"endTime": "2024-03-05T11:00:00Z",
"id": "d6374aac-8496-ff21-9aef-3a11218640d4",
"name": "MSETDA-363"
}
},
{
"associationType": "inline",
"entity": {
"actionType": "unload",
"lifecycle": "actual",
"location": {
"associationType": "inline",
"entity": {
"id": "a90aebe1-1858-1dd1-d75c-3a112185ed1c",
"name": "Vialis Public Transport B.V.",
"type": "customer",
"geoReference": {
"type": "latLonPointGeoReference",
"lat": 53.2313871,
"lon": 6.6242218,
"bearingType": "absolute"
},
"administrativeReference": {
"name": "Vialis Public Transport B.V.",
"street": "De Waard 5",
"postalCode": "9734CV",
"city": "Groningen",
"country": "NL"
}
}
},
"startTime": "2024-03-05T13:00:00Z",
"endTime": "2024-03-05T15:00:00Z",
"id": "502ede1e-784a-3319-4370-3a11218640d4",
"name": "YFVWXA-534"
}
}
],
"name": "BKO-8602/2"
}
}
]
"actors": [
{
"roles": [ "Consignee" ],
"associationType": "inline",
"entity": {
"locations": [
{
"associationType": "inline",
"entity": {
"id": "34825a8b-5364-0aa8-9aed-3a112185ed0d",
"name": "UFC Transport",
"type": "customer",
"geoReference": {
"type": "latLonPointGeoReference",
"lat": 52.3546255,
"lon": 4.7850692,
"bearingType": "absolute"
},
"administrativeReference": {
"name": "UFC Transport",
"street": "Akerwateringstraat 115",
"postalCode": "1069GC",
"city": "Amsterdam",
"country": "NL"
}
}
}
],
"id": "34825a8b-5364-0aa8-9aed-3a112185ed0d",
"name": "UFC Transport"
}
}
],
"externalAttributes": [
{
"callbackUrl": "https://callback.url",
"callbackHeaders": "Header1=123;Header2=456"
}
]
}
Een voorbeeld json-bestand kun je hier downloaden. Meer technische details over de OTM Transport Order kun je vinden in het developer portal van OTM.
API Endpoint
Wanneer je een geldig OTM Transport Order hebt, stuur je deze naar de API van FiLogic OpenTMS. De endpoint van de transport order web service is:
/api/services/app/TransportOrder/Import
In de header van de HTTP request dien je een tweetal zaken te vermelden:
- Het administratienummer van de FiLogic gebruiker
- Een security token voor toegang tot de administratie van de FiLogic gebruiker
Filogic_opentms_tenantid: 1234
Authorization: Token abcd
Indien het administratienummer en de security token correct zijn, retourneert de API een 200 OK en wordt het bericht op de achtergrond verwerkt en de transportopdracht aangemaakt of bijgewerkt.
Callback Url
In het voorbeeld-bericht dat hierboven is weergegeven, zijn een tweetal external attributes toegevoegd:
"externalAttributes": [
{
"callbackUrl": "https://callback.url",
"callbackHeaders": "Header1=123;Header2=456"
}
]
Met deze external attributes kun je instellen via welk endpoint je terugkoppeling wenst wanneer de transportopdracht wordt gewijzigd. Denk hierbij aan de volgende events:
- Order gewijzigd
- Order geannuleerd
- Order afgeleverd
- POD
Niet gevonden wat je zocht?
We helpen je graag verder
Mail onze supportafdeling:
support@filogic.nl
Testimonials
Star talk
De mening van onze klanten betekent veel voor ons. Wij geloven in samen starten, samen groeien en samen ontwikkelen.
De feedback van onze klanten is dan ook de belangrijste input voor het ontwikkelen van nieuwe functionaliteiten binnen het Filogic TMS. Zo weten we zeker dat het aansluit bij jouw wensen.
“Filogic is een bedrijf waarmee je makkelijk kunt schakelen, via korte lijnen. Direct vanaf het begin hadden we voor 95% een match en het overige deel hebben we samen opgelost. Bij grote partijen merk je dat dit soort dingen vaak lang duren. Bij Filogic is het snel sparren en op korte termijn zaken oplossen. Dit is heel belangrijk voor ons. Het houdt ons in beweging en voorbereid op de toekomst!”
Jack van der Gugten
Hoek Flowers
“Binnen twee maanden was Filogic OpenTMS geïmplementeerd. Mijn planners en chauffeurs raakten al snel gewend aan deze nieuwe manier van werken. Na één maand was iedereen overtuigd en enthousiast. Mijn planners geven aan dat ze zich beter kunnen focussen en flink wat tijd besparen. Dus tegen ondernemers die nog twijfelen wil ik zeggen: probeer het gewoon.”
Theo Bos
MSS Transport
“Op ieder moment en vanaf elke plek heb je toegang tot de juiste informatie. Chauffeurs zien direct op wat voor locatie ze welke order moeten leveren. Ik ben blij dat iedereen met Filogic OpenTMS overweg kan en dat we met z’n allen lekker bezig zijn. Uiteindelijk is het belangrijkste dat het transport goed wordt uitgevoerd en onze opdrachtgevers tevreden zijn.”
Myron Bishaie
Van de Lagemaat Transport
“Met Filogic OpenTMS hebben we een helder overzicht van onze planningen. Dit is erg wenselijk, want er wordt steeds vaker gevraagd wanneer een order wordt geleverd. In het digitale vrachtdossier staat ook precies wat per auto is geladen. En de lay-out van de eCMR ziet er altijd hetzelfde uit. Als één geheel, lekker professioneel.”
Toine Slob
Meever & Meever