Rozszerzenie Interfejs wysyłkowy DHL służy do połączenia Comarch ERP Enterprise z API wysyłkowym klienta biznesowego DHL. API może być używane do przesyłania danych wysyłkowych do DHL, przesyłania numerów przesyłek do Comarch ERP Enterprise i pobierania etykiet wysyłkowych.
Interfejs API wysyłki do klienta biznesowego
DHL Business Customer Shipping API umożliwia zarządzanie przesyłkami oraz zakup etykiet wysyłkowych online i jest zwykle przeznaczony dla nadawców o wolumenie ponad 200 przesyłek rocznie. Dla klientów biznesowych DHL, którzy nie mają konta klienta biznesowego DHL (EKP) i mają wolumen wysyłek mniejszy niż 200 przesyłek rocznie, etykiety wysyłkowe są tworzone za pośrednictwem interfejsu API wysyłki dla klientów indywidulanych.
Interfejs API wysyłki do klienta biznesowego przejmuje kontrolę:
- Przygotowywanie listów przewozowych dla wysyłek krajowych i międzynarodowych
- Tworzenie dokumentów eksportowych
- Rezerwacja lub anulowanie zlecenia odbioru przesyłki z wybranego przez użytkownika miejsca wyjazdu i dostawy do wybranego przez użytkownika miejsca przeznaczenia
- Pobieranie etykiet
Aplikacja tworzy wywołanie CreateShipmentDD. Jest to wywołanie operacji, za pomocą której tworzone są przesyłki i odpowiednie etykiety DHL Paket.
Jeśli dane zlecenia są prawidłowe, tj. jeśli użytkownik posiada odpowiednie uprawnienia, usługa zwraca numer przesyłki i dane przesyłki dla każdego zlecenia przesyłki w wywołaniu. Adresy URL odnoszą się do gotowych do druku etykiet w formacie pdf. Wraz z odpowiedzią z API, wszystkie żądane przesyłki są tworzone i tymczasowo przechowywane. Pod koniec dnia automatyczne zadanie przetwarzania przetwarza wszystkie zbuforowane przesyłki i przekazuje je do odpowiedniego systemu produkcyjnego DHL w celu ostatecznej rezerwacji.
Konfiguracja
Aplikacja Konfiguracja interfejsu wysyłkowego DHL służy do zarządzania danymi dostępu do interfejsu API.
Dane dostępu
Aby korzystać z interfejsu API Business Customer Shipping Test, potrzebne są dane uwierzytelniające dla aplikacji. Wymagane jest również konto użytkownika i powiązany numer EKP (numer klienta DHL). Warto odwiedzić stronę https://www.dhl.de/de/geschaeftskunden/paket.html.
| Parametr | Wartość | Sandbox (system testowy) |
| Nazwa użytkownika | Nazwa użytkownika nadawcy
W tym miejscu należy wprowadzić nazwę użytkownika, która można zobaczyć po zalogowaniu się do portalu. |
sandy_sandbox |
| Hasło użytkownika | Hasło konta użytkownika, odpowiada hasłu użytkownika w portalu klienta biznesowego DHL. | pass |
| Klucz API
Ten klucz identyfikuje aplikację DHL |
k4ENa3onMJsBJFYWMo6OBwUvyAbujN0M | |
| Uwierzytelnienie adresu URL | https://apieu.dhl.com/parcel/de /account/auth/ropc/v1/ | https://apisandbox.dhl.com/parcel/de /account/auth/ropc/v1/ |
| Webservice wysyłki paczek URL | https://apieu.dhl.com/parcel/de /shipping/v2/ | https://apisandbox.dhl.com/parcel/de /shipping/v2/ |
| Ścieżka przechowywania etykiety paczki | [ścieżka w kstore] | |
| Dane banku do pobrania | [wybrane dane banku] | |
Przewoźnik
Tylko te zamówienia dostawy są przekazywane do DHL, dla których w polu przewoźnika w zamówieniu sprzedaży wprowadzono wartość DHL.
Warunki wysyłki
Parametry wysyłki można zdefiniować w aplikacji Warunki wysyłki. W tym celu należy aktywować widok Interfejsy wysyłki.
Jeśli zamówienia mają być wysyłane z warunkami wysyłki DHL, jako przewoźnika należy wpisać DHL.
Kod produktu identyfikuje usługę wysyłki, która ma zostać użyta.
| Usługa wysyłki | Kod produktu |
| DHL Paket | V01PAK |
| DHL Paket International | V53WPAK |
| DHL Europapaket | V54EPAK |
Odpowiedni numer rozliczeniowy należy wprowadzić w polu Numer klienta. Składa się on z numeru EKP otrzymanego od DHL oraz 4-cyfrowego kodu identyfikującego produkt.
Procesy
Dane wysyłkowe przesyłane do DHL zasadniczo pochodzą ze zlecenia dostawy. Są one przesyłane automatycznie po utworzeniu dokumentów dostawy. Możliwe jest również ręczne zainicjowanie transferu.
Poniższa tabela zawiera przegląd danych dotyczących wysyłki i zarządzania nimi w Comarch ERP Enterprise:
| Nadawca | Organizacja logistyki magazynowej w zleceniu dostawy, odpowiada partnerowi dostawy w zamówieniu sprzedaży. |
| Odbiorca | Partner w zleceniu dostawy, odpowiada odbiorcy wysyłki w zamówieniu sprzedaży. |
| Artykuł | Pozycje w zleceniu dostawy, ilość odpowiada liczbie w kolumnie Dostarczona/potwierdzona ilość. |
| Waga paczki | Waga zlecenia dostawy; w przypadku przesyłek zapakowanych przenoszone są wagi jednostek warstwowych. |
| Opcja wysyłki – kod produktu | Produkt w zakładce Opcje wysyłki w zamówieniu sprzedaży. |
| Opcja wysyłki – usługa dodatkowa | Usługa w zakładce Opcje wysyłki w zamówieniu sprzedaży. Usługi COD (za pobraniem) i HI (wyższe ubezpieczenie) są obecnie obsługiwane w tym miejscu. |
Eksport danych listu przewozowego do interfejsu wysyłki
Istnieją 3 miejsca w Comarch ERP Enterprise, w których dane wysyłki są przekazywane do interfejsu API wysyłki klienta biznesowego.
- Automatycznie podczas tworzenia potwierdzenia dostawy dla zlecenia dostawy
- Poprzez akcję [Eksportuj dane dokumentu dostawy do interfejsu wysyłki] w aplikacji Zlecenia dostawy.
- Poprzez akcję [Eksportuj dane dokumentu dostawy do interfejsu wysyłkowego] w aplikacji Lista: Interfejsy wysyłkowe.
Jeśli eksport został przeprowadzony bez błędów, dane dostawy są wyświetlane w zakładce Dane wysyłki. Dostęp do etykiety wysyłkowej można uzyskać, klikając łącze prawym przyciskiem myszy.
Etykieta wysyłkowa jest również automatycznie pobierana i zapisywana w KStore. Jest tam dostępna do wydrukowania.
Jeśli eksport nie powiódł się, wówczas zostanie wyświetlony komunikat o błędzie zawierający komunikat o błędzie zwrócony przez interfejs API Business Customer Shipping.
