Instrukcja uruchomienia usługi KurJerzyAPI dla OsCommerce 2.2
Spis treści Wstęp...3 Instalacja...3 Ustawienia...3 Zamówienie kuriera...5
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.
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.
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.