{"id":12604,"date":"2024-12-30T08:30:42","date_gmt":"2024-12-30T07:30:42","guid":{"rendered":"https:\/\/pomoc.comarch.pl\/cee\/640\/?post_type=ht_kb&p=12604"},"modified":"2025-05-28T15:49:08","modified_gmt":"2025-05-28T13:49:08","slug":"wprowadzenie-interfejs-wysylkowy-dhl","status":"publish","type":"ht_kb","link":"https:\/\/pomoc.comarch.pl\/cee\/640\/index.php\/documentation\/wprowadzenie-interfejs-wysylkowy-dhl\/","title":{"rendered":"Wprowadzenie: Interfejs wysy\u0142kowy DHL"},"content":{"rendered":"

Rozszerzenie Interfejs wysy\u0142kowy DHL<\/em> s\u0142u\u017cy do po\u0142\u0105czenia Comarch ERP Enterprise z API wysy\u0142kowym klienta biznesowego DHL. API mo\u017ce by\u0107 u\u017cywane do przesy\u0142ania danych wysy\u0142kowych do DHL, przesy\u0142ania numer\u00f3w przesy\u0142ek do Comarch ERP Enterprise i pobierania etykiet wysy\u0142kowych.<\/p>\n

Uwaga<\/div>
Obecnie integracja Comrach ERP Enterprise z DHL jest dost\u0119pna wy\u0142\u0105cznie na niemieckiej wersji systemu.<\/div><\/section>\n

Interfejs API wysy\u0142ki do klienta biznesowego<\/h3>\n

DHL Business Customer Shipping API umo\u017cliwia zarz\u0105dzanie przesy\u0142kami oraz zakup etykiet wysy\u0142kowych online i jest zwykle przeznaczony dla nadawc\u00f3w o wolumenie ponad 200 przesy\u0142ek rocznie. Dla klient\u00f3w biznesowych DHL, kt\u00f3rzy nie maj\u0105 konta klienta biznesowego DHL (EKP) i maj\u0105 wolumen wysy\u0142ek mniejszy ni\u017c 200 przesy\u0142ek rocznie, etykiety wysy\u0142kowe s\u0105 tworzone za po\u015brednictwem interfejsu API wysy\u0142ki dla klient\u00f3w indywidulanych.<\/p>\n

Interfejs API wysy\u0142ki do klienta biznesowego przejmuje kontrol\u0119:<\/p>\n

    \n
  • Przygotowywanie list\u00f3w przewozowych dla wysy\u0142ek krajowych i mi\u0119dzynarodowych<\/li>\n
  • Tworzenie dokument\u00f3w eksportowych<\/li>\n
  • Rezerwacja lub anulowanie zlecenia odbioru przesy\u0142ki z wybranego przez u\u017cytkownika miejsca wyjazdu i dostawy do wybranego przez u\u017cytkownika miejsca przeznaczenia<\/li>\n
  • Pobieranie etykiet<\/li>\n<\/ul>\n

    Aplikacja tworzy wywo\u0142anie CreateShipmentDD. Jest to wywo\u0142anie operacji, za pomoc\u0105 kt\u00f3rej tworzone s\u0105 przesy\u0142ki i odpowiednie etykiety DHL Paket.<\/p>\n

    Je\u015bli dane zlecenia s\u0105 prawid\u0142owe, tj. je\u015bli u\u017cytkownik posiada odpowiednie uprawnienia, us\u0142uga zwraca numer przesy\u0142ki i dane przesy\u0142ki dla ka\u017cdego zlecenia przesy\u0142ki w wywo\u0142aniu. Adresy URL odnosz\u0105 si\u0119 do gotowych do druku etykiet w formacie pdf. Wraz z odpowiedzi\u0105 z API, wszystkie \u017c\u0105dane przesy\u0142ki s\u0105 tworzone i tymczasowo przechowywane. Pod koniec dnia automatyczne zadanie przetwarzania przetwarza wszystkie zbuforowane przesy\u0142ki i przekazuje je do odpowiedniego systemu produkcyjnego DHL w celu ostatecznej rezerwacji.<\/p>\n

    Konfiguracja<\/h3>\n

    Aplikacja Konfiguracja interfejsu wysy\u0142kowego DHL<\/em> s\u0142u\u017cy do zarz\u0105dzania danymi dost\u0119pu do interfejsu API.<\/p>\n

    Dane dost\u0119pu<\/h4>\n

    Aby korzysta\u0107 z interfejsu API Business Customer Shipping Test, potrzebne s\u0105 dane uwierzytelniaj\u0105ce dla aplikacji. Ponadto wymagane jest konto u\u017cytkownika w portalu dla klient\u00f3w biznesowych DHL
    \noraz numer EKP do przypisania wykorzystywanych produkt\u00f3w wysy\u0142kowych. Poni\u017cej znajduj\u0105 si\u0119 linki, z kt\u00f3rych u\u017cytkownik powinien skorzysta\u0107:<\/p>\n

    DE: https:\/\/www.dhl.de\/de\/geschaeftskunden\/paket.html<\/p>\n

    PL: brak integracji<\/p>\n

    EN: brak integracji<\/p>\n

    FR: brak integracji<\/p>\n\n\n\n\n\n\n\n\n\n\n
    Parametr<\/strong><\/td>\nWarto\u015b\u0107<\/strong><\/td>\nSandbox (system testowy)<\/strong><\/td>\n<\/tr>\n
    Nazwa u\u017cytkownika<\/td>\nNazwa u\u017cytkownika nadawcyW tym miejscu nale\u017cy wprowadzi\u0107 nazw\u0119 u\u017cytkownika, kt\u00f3ra mo\u017cna zobaczy\u0107 po zalogowaniu si\u0119 do portalu.<\/td>\nsandy_sandbox<\/td>\n<\/tr>\n
    Has\u0142o u\u017cytkownika<\/td>\nHas\u0142o konta u\u017cytkownika, odpowiada has\u0142u u\u017cytkownika w portalu klienta biznesowego DHL.<\/td>\npass<\/td>\n<\/tr>\n
    Klucz APITen klucz identyfikuje aplikacj\u0119 DHL<\/td>\nk4ENa3onMJsBJFYWMo6OBwUvyAbujN0M<\/td>\n<\/tr>\n
    Uwierzytelnienie adresu URL<\/td>\nhttps:\/\/apieu.dhl.com\/parcel\/de \/account\/auth\/ropc\/v1\/<\/td>\nhttps:\/\/apisandbox.dhl.com\/parcel\/de \/account\/auth\/ropc\/v1\/<\/td>\n<\/tr>\n
    Webservice wysy\u0142ki paczek URL<\/td>\nhttps:\/\/apieu.dhl.com\/parcel\/de \/shipping\/v2\/<\/td>\nhttps:\/\/apisandbox.dhl.com\/parcel\/de \/shipping\/v2\/<\/td>\n<\/tr>\n
    \u015acie\u017cka przechowywania etykiety paczki<\/td>\n[\u015bcie\u017cka w kstore]<\/td>\n<\/tr>\n
    Dane banku do pobrania<\/td>\n[wybrane dane banku]<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n

    Przewo\u017anik<\/h4>\n

    Tylko te zam\u00f3wienia dostawy s\u0105 przekazywane do DHL, dla kt\u00f3rych w polu przewo\u017anika w zam\u00f3wieniu sprzeda\u017cy wprowadzono warto\u015b\u0107 DHL.<\/em><\/p>\n

    Warunki wysy\u0142ki<\/h4>\n

    Parametry wysy\u0142ki mo\u017cna zdefiniowa\u0107 w aplikacji Warunki wysy\u0142ki<\/em>. W tym celu nale\u017cy aktywowa\u0107 widok Interfejsy wysy\u0142ki.<\/em><\/p>\n

    Je\u015bli zam\u00f3wienia maj\u0105 by\u0107 wysy\u0142ane z warunkami wysy\u0142ki DHL, jako przewo\u017anika nale\u017cy wpisa\u0107 DHL.<\/p>\n

    Kod produktu identyfikuje us\u0142ug\u0119 wysy\u0142ki, kt\u00f3ra ma zosta\u0107 u\u017cyta.<\/p>\n\n\n\n\n\n\n
    Us\u0142uga wysy\u0142ki<\/strong><\/td>\nKod produktu<\/strong><\/td>\n<\/tr>\n
    DHL Paket<\/td>\nV01PAK<\/td>\n<\/tr>\n
    DHL Paket International<\/td>\nV53WPAK<\/td>\n<\/tr>\n
    DHL Europapaket<\/td>\nV54EPAK<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n

    Odpowiedni numer rozliczeniowy nale\u017cy wprowadzi\u0107 w polu Numer klienta<\/em>. Sk\u0142ada si\u0119 on z numeru EKP otrzymanego od DHL oraz 4-cyfrowego kodu identyfikuj\u0105cego produkt.<\/p>\n

    Procesy<\/h3>\n

    Dane wysy\u0142kowe przesy\u0142ane do DHL zasadniczo pochodz\u0105 ze zlecenia dostawy. S\u0105 one przesy\u0142ane automatycznie po utworzeniu dokument\u00f3w dostawy. Mo\u017cliwe jest r\u00f3wnie\u017c r\u0119czne zainicjowanie transferu.<\/p>\n

    Poni\u017csza tabela zawiera przegl\u0105d danych dotycz\u0105cych wysy\u0142ki i zarz\u0105dzania nimi w Comarch ERP Enterprise:<\/p>\n\n\n\n\n\n\n\n\n
    Nadawca<\/strong><\/td>\nOrganizacja logistyki magazynowej w zleceniu dostawy, odpowiada partnerowi dostawy w zam\u00f3wieniu sprzeda\u017cy.<\/strong><\/td>\n<\/tr>\n
    Odbiorca<\/td>\nPartner w zleceniu dostawy, odpowiada odbiorcy wysy\u0142ki w zam\u00f3wieniu sprzeda\u017cy.<\/td>\n<\/tr>\n
    Artyku\u0142<\/td>\nPozycje w zleceniu dostawy, ilo\u015b\u0107 odpowiada liczbie w kolumnie Dostarczona\/potwierdzona ilo\u015b\u0107.<\/em><\/td>\n<\/tr>\n
    Waga paczki<\/td>\nWaga zlecenia dostawy; w przypadku przesy\u0142ek zapakowanych przenoszone s\u0105 wagi jednostek warstwowych.<\/td>\n<\/tr>\n
    Opcja wysy\u0142ki – kod produktu<\/td>\nProdukt w zak\u0142adce Opcje wysy\u0142ki w zam\u00f3wieniu sprzeda\u017cy.<\/em><\/td>\n<\/tr>\n
    Opcja wysy\u0142ki – us\u0142uga dodatkowa<\/td>\nUs\u0142uga w zak\u0142adce Opcje wysy\u0142ki w zam\u00f3wieniu sprzeda\u017cy.<\/em> Us\u0142ugi COD (za pobraniem) i HI<\/em> (wy\u017csze ubezpieczenie) s\u0105 obecnie obs\u0142ugiwane w tym miejscu.<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n

    Eksport danych listu przewozowego do interfejsu wysy\u0142ki<\/h4>\n

    Istniej\u0105 3 miejsca w Comarch ERP Enterprise, w kt\u00f3rych dane wysy\u0142ki s\u0105 przekazywane do interfejsu API wysy\u0142ki klienta biznesowego.<\/p>\n

      \n
    1. Automatycznie podczas tworzenia potwierdzenia dostawy dla zlecenia dostawy<\/li>\n
    2. Poprzez akcj\u0119 [Eksportuj dane dokumentu dostawy do interfejsu wysy\u0142ki<\/strong>] w aplikacji Zlecenia dostawy<\/em>.<\/li>\n
    3. Poprzez akcj\u0119 [Eksportuj dane dokumentu dostawy do interfejsu wysy\u0142kowego<\/strong>] w aplikacji Lista: Interfejsy wysy\u0142kowe<\/em>.<\/li>\n<\/ol>\n

      Je\u015bli eksport zosta\u0142 przeprowadzony bez b\u0142\u0119d\u00f3w, dane dostawy s\u0105 wy\u015bwietlane w zak\u0142adce Dane wysy\u0142ki<\/em>. Dost\u0119p do etykiety wysy\u0142kowej mo\u017cna uzyska\u0107, klikaj\u0105c \u0142\u0105cze prawym przyciskiem myszy.<\/p>\n

      Etykieta wysy\u0142kowa jest r\u00f3wnie\u017c automatycznie pobierana i zapisywana w KStore. Jest tam dost\u0119pna do wydrukowania.<\/p>\n

      Je\u015bli eksport nie powi\u00f3d\u0142 si\u0119, w\u00f3wczas zostanie wy\u015bwietlony komunikat o b\u0142\u0119dzie zawieraj\u0105cy komunikat o b\u0142\u0119dzie zwr\u00f3cony przez interfejs API Business Customer Shipping.<\/p>\n","protected":false},"author":28,"comment_status":"closed","ping_status":"closed","template":"","format":"standard","meta":{"footnotes":""},"class_list":["post-12604","ht_kb","type-ht_kb","status-publish","format-standard","hentry","ht_kb_category-dhl"],"_links":{"self":[{"href":"https:\/\/pomoc.comarch.pl\/cee\/640\/index.php\/wp-json\/wp\/v2\/ht_kb\/12604","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/pomoc.comarch.pl\/cee\/640\/index.php\/wp-json\/wp\/v2\/ht_kb"}],"about":[{"href":"https:\/\/pomoc.comarch.pl\/cee\/640\/index.php\/wp-json\/wp\/v2\/types\/ht_kb"}],"author":[{"embeddable":true,"href":"https:\/\/pomoc.comarch.pl\/cee\/640\/index.php\/wp-json\/wp\/v2\/users\/28"}],"replies":[{"embeddable":true,"href":"https:\/\/pomoc.comarch.pl\/cee\/640\/index.php\/wp-json\/wp\/v2\/comments?post=12604"}],"version-history":[{"count":9,"href":"https:\/\/pomoc.comarch.pl\/cee\/640\/index.php\/wp-json\/wp\/v2\/ht_kb\/12604\/revisions"}],"predecessor-version":[{"id":31910,"href":"https:\/\/pomoc.comarch.pl\/cee\/640\/index.php\/wp-json\/wp\/v2\/ht_kb\/12604\/revisions\/31910"}],"wp:attachment":[{"href":"https:\/\/pomoc.comarch.pl\/cee\/640\/index.php\/wp-json\/wp\/v2\/media?parent=12604"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}