Track&Trace SOAP¶

Podstawy¶

Track&Trace¶

Śledzenie przesyłki jest możliwe na podstawie numeru paczki GLS albo własnego numeru referencyjnego nadawcy.

Poszczególne metody zostały opisane w dalszej części tej dokumentacji.

Web Service¶

GLS korzysta z protokołu SOAP w wersji 1.1. Podstawowa komunikacja odbywa się przez HTTP lub HTTPS. Poszczególne metody odpytywania o status przesyłki są udostępniane w postaci pliku WSDL (Web Services Description Language).

Metody¶

Dostępne są trzy metody służące do określenia statusu przesyłki.

Dwa parametry — username oraz password — są wymagane. W zwracanym strumieniu elementy ErrorCode oraz ErrorDscr wskazują, czy zapytanie do usługi zakończyło się powodzeniem, czy zwrócono informację o błędzie.

Tak wygląda pozytywna odpowiedź:

[...]
  <ErrorCode>0</ErrorCode>
  <ErrorDscr>OK</ErrorDscr>
[...]

Tak może wyglądać komunikat błędu, np. przy nieprawidłowym logowaniu:

[...]
  <ErrorCode>502</ErrorCode>
  <ErrorDscr>Authentication Error</ErrorDscr>
[...]

Pełna lista wszystkich kodów (błędów) znajduje się w dalszej części dokumentacji.

GetTuDetail¶

Ta metoda zwraca szczegółowe informacje o przesyłce na podstawie numeru paczki GLS — parametr RefValue — bez cyfry kontrolnej.

Za pomocą parametrów ParamCode (LangCode) oraz ParamValue można przełączyć język wyników wyszukiwania (DE = niemiecki, EN = angielski).

GetTuDetail Struktura żądania¶

Typowy strumień zapytania do usługi ma następującą strukturę, gdzie ? jest symbolem zastępczym dla przekazywanej wartości:

GetTuDetail Przykład żądania¶

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:trac="http://gls-group.eu/Tracking/">
  <soapenv:Header/>
  <soapenv:Body>
    <trac:TuDetailsRequest>
      <trac:RefValue>55123456789</trac:RefValue>
      <trac:Credentials>
        <trac:UserName>2760123456</trac:UserName>
        <trac:Password>Rght355Xh</trac:Password>
      </trac:Credentials>
      <!--Zero or more repetitions:-->
      <trac:Parameters>
        <trac:ParamCode>LangCode</trac:ParamCode>
        <trac:ParamValue>EN</trac:ParamValue>
      </trac:Parameters>
    </trac:TuDetailsRequest>
  </soapenv:Body>
</soapenv:Envelope>

GetTuDetail Parametry odpowiedzi¶

Dla przejrzystości opisano tylko najważniejsze parametry strumienia odpowiedzi. Pozostałe parametry są w większości samo-opisujące się.

Podsumowanie:

• Wyszukiwanie na podstawie numeru paczki GLS bez cyfry kontrolnej (jedenaście cyfr)
• Zwracane są pełne szczegóły przesyłki

GetTuList¶

Ta metoda zwraca informacje o paczkach z zadanego okresu — DateFrom – DateTo. Zawiera najnowszy status paczek w sieci GLS.

Parametr RefValue umożliwia wyszukiwanie również na podstawie numeru paczki GLS (bez cyfry kontrolnej). Za pomocą parametru CustomRef możliwe jest wyszukiwanie na podstawie własnego numeru referencyjnego klienta.

GetTuList Struktura żądania¶

Typowy strumień zapytania do usługi ma następującą strukturę, gdzie ? jest symbolem zastępczym dla przekazywanej wartości:

GetTuList Przykład żądania¶

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:trac="http://gls-group.eu/Tracking/">
  <soapenv:Header/>
  <soapenv:Body>
    <trac:TuListRequest>
      <trac:DateFrom>
        <trac:Year>2012</trac:Year>
        <trac:Month>2</trac:Month>
        <trac:Day>22</trac:Day>
        <trac:Hour>0</trac:Hour>
        <trac:Minut>0</trac:Minut>
      </trac:DateFrom>
      <trac:DateTo>
        <trac:Year>2012</trac:Year>
        <trac:Month>2</trac:Month>
        <trac:Day>22</trac:Day>
        <trac:Hour>23</trac:Hour>
        <trac:Minut>30</trac:Minut>
      </trac:DateTo>
      <trac:Credentials>
        <trac:UserName>2760123456</trac:UserName>
        <trac:Password>Rght355Xh</trac:Password>
      </trac:Credentials>
      <trac:Parameters>
        <trac:ParamCode>LangCode</trac:ParamCode>
        <trac:ParamValue>EN</trac:ParamValue>
      </trac:Parameters>
    </trac:TuListRequest>
  </soapenv:Body>
</soapenv:Envelope>

GetTuList Parametry odpowiedzi¶

Dla przejrzystości opisano tylko najważniejsze parametry strumienia odpowiedzi. Pozostałe parametry są w większości samo-opisujące się.

Podsumowanie:

• Wyszukiwanie paczki (paczek) w zadanym okresie czasu
• Wyszukiwanie na podstawie numeru paczki GLS bez cyfry kontrolnej (jedenaście cyfr)
• Wyszukiwanie na podstawie własnego numeru referencyjnego klienta

GetTuPOD*¶

Ta metoda zwraca zakodowany obraz „potwierdzenia doręczenia” (proof of delivery), czyli podpis odbiorcy.

*Uwaga: ze względu na ograniczenia prawne ta metoda nie jest dostępna we wszystkich krajach GLS (np. we Francji).

GetTuPOD Struktura żądania¶

Typowy strumień zapytania do usługi ma następującą strukturę, gdzie ? jest symbolem zastępczym dla przekazywanej wartości:

GetTuPOD Parametry odpowiedzi¶

Dla przejrzystości opisano tylko najważniejsze parametry strumienia odpowiedzi. Pozostałe parametry są w większości samo-opisujące się.

Podsumowanie:

• Zwraca podpis odbiorcy

Kody błędów i opis¶

Przegląd¶

Za pomocą elementów ErrorCode oraz ErrorDscr usługa zwraca do systemu ERP nadawcy ewentualne komunikaty o błędach.

Kody¶