OTM koppeling

Transplan heeft een koppeling om OTM orders in Transplan te importeren. Deze pagina beschrijft hoe de OTM koppeling werkt.

De OTM orders worden in een JSON formaat aangeboden aan Transplan en verwerkt. Er zijn verschillende OTM stromen die ondersteund wordt. Dit zijn o.a. Jumbo, Albert Heijn, Detailresult en Planned Trip Service (PTS) van Ahold.

Voor elke stroom is er een mogelijkheid om deze in Transplan te beheren. De stroom kan aan / uit gezet worden of o.b.v. kenmerken in het OTM bericht kan een specifieke klant / planafdeling / ordersoort gekoppeld worden.

OTM5 inkomende orders

Om de verschillende datastromen vanuit OTM te kunnen beheren is in Transplan het scherm OTM5 inkomende orders beschikbaar (via Transplan - Statische data).

Op dit scherm kan per OTM stroom het volgende ingeregeld worden:

• Filter om o.b.v. een waarde uit het OTM bericht te matchen.

• Klant koppeling

• Sjabloon om een ritomschrijving samen te stellen.

• Orderregel per ritactiviteit

• Planafdeling koppeling

• Routenummer overnemen

• Ordersoort koppeling

• Omschrijving (dit is alleen voor herkenning en om een naam te geven aan een bepaalde stroom).

Bij de velden debiteur, planafdeling en ordersoort kan per stroom de betreffende waarde in Transplan gekoppeld worden.

Wanneer het vinkje Routenummer overnemen is aangevinkt, dan wordt het routenummer van de order/rit overgenomen uit het attribuut customer_data_taskNumber uit het OTM bericht. Als deze waarde geen numerieke waarde bevat, dan blijft het routenummer leeg (NULL) en wordt in de HUB de standaard werking toegepast en wordt het ordernummer als routenummer gevuld bij zowel de order als de rit.

Als de optie orderregel per ritactiviteit aangevinkt is, dan wordt van elke action binnen een stop een orderregel aangemaakt in Transplan. Van de volgende actions wordt dan een orderregel aangemaakt:

• Load action (wordt LA stop in Transplan)

• Unload action (wordt LO stop in Transplan)

• Break action (wordt Pauze in Transplan)

• Wait action (wordt Wachten in Transplan)

In het veld Ritomschrijving sjabloon kan de opbouw van de ritomschrijving ingesteld worden. Hier kan tekst ingevuld worden alsook zogenaamde ‘placeholders' (herkenbaar door de { en } tekens). Deze placeholders worden vervangen door data uit het OTM bericht (indien beschikbaar). Zie Placeholders voor beschikbare placeholders en waar de data uit het OTM bericht wordt gelezen.

Met het veld filtersjabloon en filterwaarde kan bepaald worden o.b.v. data uit het OTM bericht welke mapping wordt toegepast. In het filtersjabloon kunnen dezelfde placeholders toegepast worden als bij de ritomschrijving sjabloon. Bij filterwaarde kan ook een wildcard ( * ) ingevuld worden. Op dit moment ondersteunen we alleen een wildcard aan het einde van de filterwaarde (bijv. RDC*).

Als er geen match gevonden kan worden o.b.v. filtersjabloon en filterwaarde, dan wordt er een standaard een regel aangemaakt. Deze regel wordt standaard op niet actief gezet.

Placeholders

In onderstaande tabel een overzicht met de placeholders die beschikbaar zijn om te gebruiken in de velden filtersjabloon en ritomschrijving sjabloon. Als voor een placeholder geen data gevonden kan worden in het OTM bericht, dan wordt de placeholder vervangen door een lege waarde.