Technische specificaties Tracking & Tracing

GLS Technische specificaties Tracking & Tracing [Versie 1.5]

Netherlands B.V. B.V.

Technische specificaties Tracking & Tracing

Copyright © 2006 GLS Netherlands B.V. Versie 052006 1.5

1


Inleiding .................................................................................................................................................. 3 Technische uitwerking............................................................................................................................ 4 Berekening “CHK-component” ............................................................................................................... 5 Voorbeelden ........................................................................................................................................... 6 Samenstellen van de URL ..................................................................................................................... 8

2


Inleiding In dit document worden de technische specificaties rond de Tracking & Tracing mogelijkheden van GLS toegelicht. Met behulp van een voor uw op maat gemaakte ASP heeft u de sleutel in handen om toegang te krijgen tot de Tracking & Tracing gegevens van uw zendingen op de GLS Tracking & Tracing server. U hoeft geen kennis van de ASP programmeertaal te bezitten om toch gebruik te kunnen maken van deze functionaliteit. Alles wat u hoeft te doen is het genereren van een URL met daarin de aanroep van het ASP-script op de GLS Tracking & Tracing server in combinatie met de zoeksleutel en een correct berekend CHK-component. Deze oplossing kunt u onder andere gebruiken voor Tracking & Tracing: • Vanuit uw eigen website: Uw klanten loggen zich aan op uw website en kijken naar de orderstatus. Is de bewuste zending gescand en komt deze dus voor binnen de systemen van GLS. Dan kunt u in de Internet browser met behulp van de ASP koppeling de scanstatus van uw zending bij GLS laten tonen. • Via e-mail naar uw klanten: Op het moment dat u een order verstuurd naar uw klant kunt u deze direct een e-mail sturen met daarin de URL welke verwijst naar het ASP-script. Vervolgens kan uw klant met behulp van deze koppeling ten alle tijden de voortgang (scan status) van de bezorging door GLS volgen. • Koppeling vanuit uw eigen systeem: Op het moment dat u een label uit uw eigen systeem afdrukt heeft u alle noodzakelijke informatie in huis om uw zendingen te volgen. U kunt op basis van verschillende criteria uw Tracking & Tracing gegevens opvragen. Hierbij kunt u de keuze maken uit het zoeken op GLS documentnummer of op de zendingreferentie. Het GLS documentnummer is de unieke combinatie van het klantnummer, documentnummer en een controlegetal, in totaal veertien posities lang. Zonder GLS documentnummer is correcte verwerking van een zending niet mogelijk. De zendingreferentie is een optionele referentie welke door u kan worden toegekend aan de zending.

3


Technische uitwerking Om gebruik te maken van de ASP, dient u deze aan te roepen met behulp van de volgende drie parameters: • • •

Klantnummer bij GLS1 Zoeksleutel2 CHK-component (controle)3

Op basis van deze gegevens wordt de URL samengesteld waarmee de Tracking & Tracing gegevens van de zending kunnen worden getoond. Stel, u heeft aangegeven dat u met behulp van de zendingreferentie wilt gaan zoeken, u ontvangt van GLS dan de volgende gegevens. •

Naam en locatie van uw ASP-script op de GLS Tracking & Tracing server. Voorbeeld: http://www.tracking.npd.nl/tracking2/cgi-bin/ttlink.asp?

•

Een zogenaamde encryptiecode bestaande uit drie cijfers. Voorbeeld: encryptiecode = 582

Om nu vervolgens een correcte aanroep naar uw zendingen met behulp van het ASP-script te genereren, zult u het volgende moeten doen: Uw neemt uw klantnummer en uw referentie/documentnummer. Voorbeeld: klantnummer: 12345678, referentie: MIJNREF. Deze voegt u samen zodat u een string creëert waarmee u het CHK-component kunt berekenen. cData: ‘12345678MIJNREF’ Let op! Alfanumerieke karakters dienen hierbij altijd in upper case (hoofdletters) te zijn.

1

Dit is uw klantnummer bij GLS. U kunt deze opvragen uw account manager op uw GLS depot. (http://www.glsnetherlands.com/index.cfm?sel_contentid=10) 2 Afhankelijk van uw wens kan dit het GLS documentnummer of uw zendingreferentie zijn. Hierbij geldt de parameter NDOC als wordt gezocht op documentnummer en VREF als wordt gezocht op basis van de referentie. 3 Met deze parameter wordt de URL beveiligd zodat hiermee kan worden gecontroleerd of de aanvrager recht heeft op gebruik van het script.

4


Berekening “CHK-component” Om de informatie voor in de URL compleet te kunnen maken dient vervolgens het CHK-component te worden berekend. Dit is een standaardberekening op basis van een aantal variabelen. In onderstaand diagram wordt uitgelegd welke stappen te volgen om het CHK-component correct te kunnen berekenen. Beslissingsdiagram “berekening CHK-component” Zolang nPos =< Lengte (cData)

nAsc =Asciiwaarde van het karakter op positie nPos nAsc >= 65 .AND. nAsc <= 90 True

False nAsc = nAsc -64

nAsc >=48 .AND. nAsc <= 57 True

False

nAsc = nAsc - 21

nChk =nChk + (nPos * nAsc)

nPos = nPos + 1

Checkcomponent = nChk + uwEncryptiekode

5


Voorbeelden VB-Script (ASP): Let op! 1. Zorg ervoor dat er alleen cijfers en letters in de string aanwezig zijn. (Leestekens en spaties zijn niet toegestaan) 2. Gebruik VREF óf NDOC als zoeksleutel voor respectievelijk uw zendingreferentie of GLS documentnummer <% cNPDVerladerNummer = “12345678” cUwOrderNummer = “123456” nUwEncryptieCode = 324 nControleGetal=NPDInternetChecksum(cNPDVerladerNummer & cUwOrderNummer) + nUwEncryptieCode cURL = “http://www.tracking.npd.nl/Tracking2/cgi-bin/ttlink.asp?” cURL = cURL & “NVRL=" & cNPDVerladerNummer cURL = cURL & "&VREF=" & cUwOrderNummer cURL = cURL & "&CHK=" & nControleGetal ‘ ************ ‘ * Result: ‘ * cURL= http://www.tracking.npd.nl/Tracking2/cgi-bin/ttlink.asp?NVRL=12345678&VREF=123456&CHK=3622 ‘ ************ Response.Redirect( cURL ) Function NPDInternetChecksum(cData) Dim nPos Dim nChk Dim nAsc For nPos = 1 To Len(cData) nAsc = Asc(Mid(cData, nPos, 1)) If nAsc >= 65 And nAsc <= 90 Then nAsc = nAsc - 64 ElseIf nAsc >= 48 And nAsc <= 57 Then nAsc = nAsc - 47 + 26 End If nChk = nChk + (nPos * nAsc) Next NPDInternetChecksum =nChk End Function %>

6


PHP-Script: Let op! 3. Zorg ervoor dat er alleen cijfers en letters in de string aanwezig zijn. (Leestekens en spaties zijn niet toegestaan) 4. Gebruik VREF óf NDOC als zoeksleutel voor respectievelijk uw zendingreferentie of GLS documentnummer = 65 && $nAsc <= 90) $nAsc = $nAsc - 64; elseif ($nAsc >= 48 && $nAsc <= 57) $nAsc = $nAsc - 21; $nChk = $nChk + (($i + 1) * $nAsc); } return $nChk; } $nControleGetal = NPDInternetChecksum ($cNPDVerladerNummer . $cUwOrderNummer); $nControleGetal += $nUwEncryptieCode; $cURL = "http://www.tracking.npd.nl/Tracking2/cgi-bin/ttlink.asp?"; $cURL .= "NVRL=" . $cNPDVerladerNummer ; $cURL .= "&NDOC=" . $cUwOrderNummer; $cURL .= "&CHK=" . $nControleGetal; echo $cURL; ?>

7


Samenstellen van de URL Nu kunt u met behulp van deze gegevens de URL samenstellen, u begint hierbij met de locatie van het ASP-script. Het resultaat hiervan ziet er als volgt uit: http://www.tracking.npd.nl/tracking2/cgi-bin/ttlink.asp? Hierna volgen de drie componenten: NVRL NDOC/VREF4 CHK

= NVRL=12345678& = VREF=MIJNREF& = CHK=2637

Deze gegevens samengesteld levert uiteindelijk de volgende URL op: http://www.tracking.npd.nl/tracking2/cgi-bin/ttlink.asp?NVRL=12345678&VREF=MIJNREF&CHK=2637

Met behulp van de hiervoor uitgewerkte URL kunnen vervolgens de Tracking & Tracing gegevens worden opgehaald van de GLS Tracking & Tracing server. De gebruiker heeft hierbij de mogelijkheid te klikken op de URL of kan deze kopiëren naar de adresbalk in de internet browser. Het aanroepen van de link kan een aantal verschillende resultaten opleveren. Hieronder worden de mogelijke resultaten benoemt: •

De gebruiker ziet in de internet browser een overzicht van de zendinggegevens met hiervan de laatst gemaakte scans bij GLS.

•

De gebruiker ontvangt in de browser de melding: “Geen document of referentie voor klantnummer 12345678 gevonden!”. De technische aanroep van de ASP is gelukt en het juiste CHK-component is gebruikt. Echter, er zijn met behulp van de zoekgegevens in de link klantnummer, documentnummer/referentie géén tracking-gegevens gevonden. Dit betekent dat er bij GLS geen Tracking & Tracing gegevens aanwezig zijn op basis van de opgegeven criteria”.

•

De gebruiker ontvangt in de browser de melding: “Geen gegevens gevonden!“. De berekening van het Checkcomponent is niet correct. Op het scherm staat de volgende informatie:nCheck=2441 CHK=2637 nCheck is de waarde die de ASP verwachtte, maar in plaats daarvan werd de waarde van CHK gebruikt.

4

Afhankelijk van uw wens kan dit het GLS documentnummer of uw zendingreferentie zijn. Hierbij geldt de parameter NDOC als wordt gezocht op documentnummer en VREF als wordt gezocht op basis van de referentie.

8

Technische specificaties Tracking & Tracing

Recommend Documents