Instrukcja uruchomienia usługi KurJerzyAPI dla OsCommerce 2.2

Instrukcja uruchomienia usługi KurJerzyAPI
dla OsCommerce 2.2
Instrukcja uruchomienia usługi KurJerzyAPI dla OsCommerce 2.2
Spis treści
Wstęp........................................................................3
Instalacja....................................................................3
Ustawienia..................................................................3
Zamówienie kuriera........................................................5
iTBross | ul. Dąbrowszczaków 1/103 | 80-374 Gdańsk | NIP 5842358236 | REGON 220900466
email: [email protected]
Instrukcja uruchomienia usługi KurJerzyAPI dla OsCommerce 2.2
Wstęp
Szybkie zamawianie kuriera za pośrednictwem serwisu KurJerzy.pl w sklepach
OsCommerce 2.2 występuje w postaci modułu wysyłkowego (Moduły -> Wysyłka).
Korzystanie z funkcjonalności modułu DHL – KurJerzy wymaga prawidłowej instalacji
oraz konfiguracji, która opisana jest w poniższych punktach.
Instalacja
Instalacja modułu DHL – KurJerzy odbywa się w sposób analogiczny jak ma to miejsce
przy uruchamianiu innych modułów OsCommerce. Proces instalacji jest następujący:
1. Pobranie plików instalacyjnych z zakładki OsCommerce na stronie
https://www.kurjerzy.pl/narzedzia/sklepy oraz rozpakowanie ich w folderze
lokalnym
2. Przegranie plików do odpowiednich katalogów sklepu na serwerze
3. Wprowadzenie zmian w plikach sklepu zgodnie z wytycznymi znajdującymi się w
załączniku (plik o nazwie zmiany.txt)
4. Zalogowanie się do panelu administracyjnego sklepu oraz aktywowanie
(+instalacja) modułu DHL – KurJerzy w zakładce Moduły -> Wysyłka
Ustawienia
Dwa pierwsze pola Klucz API, Pin API oznaczone kolorem czerwonym dotyczą
konfiguracji platformy. Dane te dostępne są po rejestracji w Panelu Klienta > Narzędzia
> KurJerzyAPI. Pola podświetlone kolorem zielonym dotyczą danych nadawcy oraz
wartości domyślnych przesyłki. Pole oznaczone kolorem niebieskim definiuje tabelę
stawek widoczną dla klientów, np. „10:20,100:50” oznacza, iż dla przesyłek o wadze do
10kg cena będzie wynosić 20 zł netto, natomiast dla przesyłek do 100kg cena będzie
równa 50 zł netto.
iTBross | ul. Dąbrowszczaków 1/103 | 80-374 Gdańsk | NIP 5842358236 | REGON 220900466
email: [email protected]
Instrukcja uruchomienia usługi KurJerzyAPI dla OsCommerce 2.2
iTBross | ul. Dąbrowszczaków 1/103 | 80-374 Gdańsk | NIP 5842358236 | REGON 220900466
email: [email protected]
Instrukcja uruchomienia usługi KurJerzyAPI dla OsCommerce 2.2
Zamówienie kuriera
Zamówienie kuriera możliwe jest po kliknięciu w link utwórz etykietę w widoku danych
zamówienia (obszar oznaczony kolorem czerwonym na poniższym rysunku). Użytkownik
zostaje przeniesiony na stronę zlecania wysyłki.
Zlecanie wysyłki odbywa się poprzez prawidłowe wypełnienie danych formularza jak
zostało to ukazane na poniższym rysunku. Dane odbiorcy powinny zostać przepisane z
danych zamówienia sklepowego podobnie jak pola zdefiniowane w konfiguracji zostaną
wypełnione domyślnymi wartościami (Wymiary, Zawartość). Szczegóły odbioru
definiują dzień oraz godziny odbioru przesyłki przez kuriera. Dane przesyłki pozwalają
na określenie usługi (Produkt) oraz danych szczegółowych wysyłki takich jak ilość
przesyłek, waga jednej przesyłki, wymiar jednej przesyłki, zawartość wszystkich
przesyłek, wartość wszystkich przesyłek oraz opcji wysyłki „za pobraniem” gdy pole
Pobranie będzie zawierało wartość większą niż zero. Ważne jest aby wypełnić wartość
pobrania w przypadku gdy klient wybierze formę płatności przy odbiorze.
iTBross | ul. Dąbrowszczaków 1/103 | 80-374 Gdańsk | NIP 5842358236 | REGON 220900466
email: [email protected]
Instrukcja uruchomienia usługi KurJerzyAPI dla OsCommerce 2.2
Po kliknięciu w przycisk Generuj zamówienie dane wysyłki zostaną przekazane do
serwisu KurJerzy.pl, następnie dokonywana jest walidacja tych danych oraz gdy nie
zawierają żadnych błędów, Lista zleceń wysłanych będzie zawierała wpisy z
wygenerowanych listów przewozowych co pokazane jest na poniższym rysunku.
Kliknięcie w odnośnik drukuj oznaczony kolorem czerwonym pozwala na pobrania listu
przewozowego w formacie PDF.
iTBross | ul. Dąbrowszczaków 1/103 | 80-374 Gdańsk | NIP 5842358236 | REGON 220900466
email: [email protected]