↑↓ wybierzEnter otwórzEsc zamknij

    1. Elbuz
    2. Firmy kurierskie w Elbuz

    DHL Parcel Polska w Elbuz: listy przewozowe DHL24 z zamówienia i statusy

    5 min czytaniaZaktualizowano

    Elbuz nadaje paczkę DHL Parcel Polska prosto z karty zamówienia, otwiera etykietę PDF i co 10 minut pobiera status przesyłki. Nie musisz logować się do DHL24 przy każdej wysyłce.

    Kiedy to się przyda:

    • Wysyłasz po Polsce na umowie z DHL — odbiorca, adres, waga i kwota pobrania trafiają do listu z zamówienia.
    • Klient płaci przy odbiorze — dla nieopłaconego zamówienia za pobraniem kwota wpisuje się sama.
    • Klienci czekają na paczkę rano — produkt DHL Domestic 09 lub Domestic 12 wybierasz raz, w podłączeniu.
    • Menedżerowie nie mają dostępu do DHL24 — etykietę i status paczki otwierają w Elbuz.

    Od czego zacząć: uzyskaj klucz WebAPI w DHL24 → wpisz go w rekordzie DHL w Elbuz.

    Co potrafi DHL Parcel Polska w Elbuz

    Zamówienie kuriera, dostawa do punktów DHL i zmiana listu przewozowego — w DHL24.

    Jak podłączyć DHL24 WebAPI

    Skąd wziąć login i hasło WebAPI DHL24

    Login i hasło WebAPI to osobny klucz, a nie dane logowania do panelu DHL24. DHL wydaje klucze tylko klientom z aktywną umową i numerem SAP.

    1. Zaloguj się do DHL24 na konto powiązane z umową.
    2. Otwórz stronę „Integracje”, sekcję „Klucze APIv2 / API PS”: tam jest klucz i reset hasła.
    3. Jeśli sekcja jest pusta, poproś o dostęp formularzem pomocy technicznej DHL24, temat „WebAPI - uzyskanie dostępu”.

    Numer klienta SAP to siedmiocyfrowy numer płatnika z umowy. Na ten numer DHL wystawia faktury za paczki nadane z Elbuz.

    Aby sprawdzić działanie bez prawdziwych wysyłek, zarejestruj się na sandbox.dhl24.com.pl: sandbox wydaje osobny login i hasło. Opis WebAPI jest w dokumentacji DHL24; do pracy w Elbuz nie jest potrzebny.

    Gdzie wpisać klucz w Elbuz

    Gdzie: „Usługi zewnętrzne i integracje”, grupa „Dostawa” → rekord „DHL Parcel (Polska, DHL24)”.

    Formularz podłączenia DHL Parcel (Polska, DHL24): login WebAPI, numer klienta, produkt domyślny, przełącznik sandboksu i blok nadawcy
    1Użytkownik i hasło
    2Numer klienta (SAP)
    3Produkt domyślny
    4Środowisko testowe (sandbox)
    5Nadawca
    1. „Użytkownik” i „Hasło” — login i hasło DHL24 WebAPI.
    2. „Numer klienta (SAP)” — Twój numer klienta DHL24.
    3. „Produkt domyślny” — usługa DHL, z którą powstaje list przewozowy, tutaj przesyłka krajowa (AH).
    4. „Środowisko testowe (sandbox)” — zapytania idą na testowy serwer DHL zamiast produkcyjnego.
    5. „Nadawca” — firma i adres drukowane na każdym liście przewozowym jako nadawca.
    PoleCo wpisać
    „Użytkownik”, „Hasło”login i hasło WebAPI
    „Numer klienta (SAP)”numer płatnika z umowy; bez niego list przewozowy nie powstanie
    „Produkt domyślny”„Przesyłka krajowa (AH)” — zwykła dostawa; „Domestic 09” i „Domestic 12” — doręczenie do 9:00 lub do 12:00. „Connect (EK, międzynarodowa)” jest na liście, ale odbiorca z Elbuz jest zawsze w Polsce
    „Środowisko testowe (sandbox)”włącz dla klucza z sandboksu; do pracy — wyłącz
    Blok „Nadawca”nazwa, kod pocztowy, miasto, ulica, numer domu, osoba kontaktowa, telefon, e-mail; pierwsze cztery są obowiązkowe
    „Aktywność”włącz

    Pól „Token”, „Link do serwera API” i „API ver” dla DHL nie wypełniasz. Przycisku „Zapisz” nie ma: każda zmiana pola zapisuje się od razu.

    Po zapisaniu hasło jest widoczne jako kropki. Puste pole go nie kasuje; aby je zmienić, wpisz nowe w miejsce starego.

    Przy zapisie klucz nie jest sprawdzany. Błędny klucz wyjdzie dopiero przy pierwszym liście przewozowym — w treści błędu od DHL. Klucz z sandboksu działa tylko przy włączonym „Środowisko testowe (sandbox)”, produkcyjny — tylko przy wyłączonym.

    Jak wystawić list przewozowy DHL z zamówienia

    Sposób dostawy w zamówieniu musi być „DHL Parcel (PL)”. Przy sposobie „DHL” link „Utwórz list przewozowy” się nie pojawia.

    Gdzie: karta zamówienia → „Dostawa” → „Utwórz list przewozowy”. Jeśli formularz był już otwierany, link nazywa się „Edytuj list przewozowy”.

    Co formularz wypełni sam i co sprawdzić

    Formularz tworzenia listu przewozowego DHL Parcel (PL): odbiorca, adres, parametry przesyłki i dostawa zwrotna
    1Adres odbiorcy
    2Waga całkowita, kg
    3Deklarowana wartość, zł
    4Opis przesyłki
    5Dostawa zwrotna (odbiorca)
    1. „Kod pocztowy”, „Miejscowość”, „Ulica” i „Nr domu” — adres odbiorcy z zamówienia.
    2. „Waga całkowita, kg” — waga paczki, pobrana z zamówienia.
    3. „Deklarowana wartość, zł” — zadeklarowana wartość paczki, z sumy zamówienia.
    4. „Opis przesyłki” — opis zawartości, złożony z pozycji zamówienia.
    5. „Dostawa zwrotna (odbiorca)” — pobranie; „Niepotrzebna”, bo zamówienie jest już opłacone.
    PoleCo jest od razuCo sprawdzić
    „Nazwisko”, „Imię”, „Telefon”, „E-Mail”klient z zamówieniabez telefonu DHL nie przyjmie listu przewozowego
    „Kod pocztowy”, „Miejscowość”, „Ulica”adres dostawy z zamówienia„Nr domu” i „Nr mieszkania” są puste — wpisz je, jeśli numeru nie ma w polu ulicy
    „Waga całkowita, kg”waga produktów × ilośćpuste — w liście pójdzie 1 kg
    „Długość”, „Szerokość”, „Wysokość”, cmpustepuste — pójdzie 30 × 20 × 10 cm
    „Deklarowana wartość, zł”suma zamówieniana tę kwotę DHL ubezpiecza paczkę; wyczyszczone pole też da sumę zamówienia
    „Opis przesyłki”kategoria produktu, bez niej — lista produktówobowiązkowe; do DHL trafi 100 znaków
    „Dostawa zwrotna (odbiorca)”„Pieniądze” na sumę zamówienia, jeśli nie jest opłacone, a płatność to pobranie; w innym razie „Niepotrzebna”klient zapłacił kartą, a płatności nie odnotowano — ustaw „Niepotrzebna”

    Kwoty w formularzu są w złotych. Jeśli zamówienie jest w innej walucie, popraw kwotę pobrania i deklarowaną wartość ręcznie.

    Nadawcę, numer SAP i produkt formularz bierze z podłączenia. Numer zamówienia trafia do paczki jako referencja, odbiorca jest zawsze w Polsce. Data nadania — dziś, w sobotę i niedzielę — najbliższy poniedziałek.

    Co się dzieje po „Utwórz list przewozowy”

    • Numer paczki DHL trafia do pola „Numer listu przewozowego”, pojawia się „Utworzono list przewozowy nr ‹numer›”. Tego samego numeru DHL używa do śledzenia.
    • W karcie zamiast „Utwórz list przewozowy” jest „Podgląd listu przewozowego”.
    • Drugi list przewozowy do tego samego zamówienia nie powstanie: „List przewozowy już utworzony: ‹numer› — pominięto.”
    • Jeśli DHL odmówił, pojawi się „Error:” z przyczyną; formularz zostaje otwarty, a jego wartości są zapisane w zamówieniu.
    • Jeśli w sposobie dostawy „DHL Parcel (PL)” wypełniono „Link do śledzenia przesyłki”, w zamówieniu zapisze się też link do śledzenia.

    Listy przewozowe do dziesiątek zamówień naraz — „Utwórz list przewozowy (dostawa)” na liście zamówień, więcej: listy przewozowe zbiorczo.

    Etykieta i podgląd listu przewozowego

    Gdzie: karta zamówienia → „Podgląd listu przewozowego” → przycisk drukowania; albo „Przesyłki” → wiersz → „Drukuj list przewozowy”.

    Elbuz sam pobiera z DHL etykietę BLP w PDF i otwiera ją w nowej karcie; hasło WebAPI nie trafia do przeglądarki. Jeśli DHL odmówił, w karcie pojawi się „print error:” z przyczyną. W „Przesyłkach” etykiety DHL drukuje się pojedynczo.

    „Podgląd listu przewozowego” za każdym razem pyta DHL o status: u góry — „Status:” z tekstem DHL, na dole — „Szczegóły API” z kodem statusu.

    Usuwanie listu przewozowego

    Gdzie: karta zamówienia → „Podgląd listu przewozowego” → „Usuń list przewozowy”; albo „Przesyłki” → wiersz → „Usuń list przewozowy”. Potrzebne jest uprawnienie do tworzenia listów przewozowych.

    1. Potwierdź „Usunąć list przewozowy ‹numer› u przewoźnika?”.
    2. DHL usuwa paczkę, z karty znikają numer i link do śledzenia → „List przewozowy usunięty. Zamówienie można wysłać ponownie.”

    DHL usuwa paczkę, dopóki nie zamówiono do niej kuriera (dokumentacja DHL24). W przeciwnym razie Elbuz pokaże „Przewoźnik nie usunął listu przewozowego:” z odpowiedzią DHL — najpierw anuluj kuriera w DHL24. Paczki, którą śledzenie widzi już w drodze lub doręczoną, Elbuz nie proponuje usunąć.

    Statusy paczek DHL

    Elbuz pyta DHL o każdą paczkę co 10 minut, do 100 paczek na przebieg. Śledzone są zamówienia z ostatnich 60 dni i zamówienia w zaznaczonych statusach. Wszystkie paczki widać w „Przesyłkach”.

    Kody statusów DHL

    Stan paczki Elbuz ustala według Twojej tabeli kodów. Kodów DHL program sam nie wpisuje, a pełnej listy DHL nie publikuje.

    1. Po pierwszych paczkach otwórz „Podgląd listu przewozowego”: w „Szczegóły API” wiersz StatusCode to kod DHL, Status — jego opis.
    2. Podłączenie DHL → „Ustawienia powiadomień” → „Statusy dostawy”. W kolumnie „Kod (nazwa) na stronie (API)” wpisz kod przy swoim statusie; kilka kodów — po przecinku.
    3. Aby status zamówienia lub płatności zmieniał się sam, tak samo wypełnij „Statusy zamówienia” i „Statusy płatności”. Zaznacz statusy zamówień w bloku „Statusy zamówień, dla których sprawdzać status przesyłki w firmie kurierskiej”.
    Twój status dostawyStan w „Przesyłkach”
    „Oczekiwanie od nadawcy”, „Zebrane”Utworzona
    „W drodze”, „W urzędzie celnym”, „Wydany kurierowi”W drodze
    „W miejscu docelowym”W punkcie odbioru
    „Dostarczono”, „Częściowo dostarczone”Doręczona — Elbuz przestaje pytać DHL o tę paczkę
    „Odrzucenie”Odmowa
    kod nie jest wpisanyNieznany — paczka trafia do filtra „Problemy”
    Dopóki kod doręczenia DHL nie jest wpisany w „Dostarczono”, Elbuz pyta DHL o paczkę przez całe 60 dni, a w „Przesyłkach” ma ona stan „Nieznany”.

    Gdy status zamówienia zmienił się według kodu, w historii zamówienia zapisuje się „Zmienił się status dostawy: ‹kod› ‹tekst› #‹numer›”. Przycisk „Śledź na stronie przewoźnika” dla DHL Parcel Polska odpowiada „Ten przewoźnik nie ma publicznej strony śledzenia.”

    Co zostaje w DHL24

    • Zmiana listu przewozowego — w DHL24; z Elbuz list można tylko usunąć i wystawić od nowa.
    • Zamówienie kuriera — w DHL24 albo w ramach stałego odbioru z umowy.
    • Dostawa do punktu lub automatu DHL i wysyłki za granicę — Elbuz nadaje paczki DHL tylko na adres w Polsce.

    Scenariusze

    Pierwsze podłączenie przez sandbox

    Sytuacja. Umowa z DHL jest świeżo podpisana, a chcesz sprawdzić listy przewozowe bez prawdziwych paczek.

    Co zrobić. Zarejestruj się na sandbox.dhl24.com.pl, wpisz testowy login i hasło, włącz „Środowisko testowe (sandbox)” i wystaw list do testowego zamówienia. Potem wpisz produkcyjny login i hasło w miejsce testowych i wyłącz sandbox.

    Efekt. Błędy w adresie nadawcy czy numerze SAP zobaczysz przed pierwszą prawdziwą wysyłką.

    Codzienna wysyłka

    Sytuacja. Rano masz 30 zamówień ze sposobem dostawy „DHL Parcel (PL)”.

    Co zrobić. Zaznacz je na liście zamówień → „Utwórz list przewozowy (dostawa)”. Potem w „Przesyłkach” wydrukuj etykiety pojedynczo i przekaż paczki kurierowi DHL.

    Efekt. Numery paczek są w zamówieniach, a stan każdej paczki aktualizuje się sam.

    Pobranie i przedpłata na przemian

    Sytuacja. Część zamówień opłacono kartą, za część klienci zapłacą przy odbiorze.

    Co zrobić. Odnotowuj płatność w zamówieniu przed utworzeniem listu przewozowego.

    Efekt. Nieopłacone za pobraniem pójdą z kwotą pobrania, opłacone — bez niej.

    Co zrobić, gdy coś pójdzie nie tak

    Najczęstsze problemy
    Co widziszDlaczego tak jestCo zrobić
    „Firma kurierska nie jest podłączona: uzupełnij ustawienia API tej firmy…” w oknie listu przewozowego Nie wpisano hasła albo wyłączono „Aktywność” Wpisz login i hasło WebAPI, włącz „Aktywność” (gdzie wpisać)
    W karcie zamówienia nie ma ani „Utwórz list przewozowy”, ani „Edytuj list przewozowy” Sposób dostawy to „DHL”, a nie „DHL Parcel (PL)” Zmień sposób dostawy na „DHL Parcel (PL)” (list przewozowy z zamówienia)
    „Error: login/password is required (API settings)” Nie wpisano loginu WebAPI Wypełnij „Użytkownik” w podłączeniu
    „Error: account_number is required (API settings)” Nie wpisano numeru klienta SAP Wypełnij „Numer klienta (SAP)” w podłączeniu
    „Error: sender address is required (API settings)” W bloku „Nadawca” brakuje nazwy, kodu pocztowego, miasta lub ulicy Uzupełnij adres nadawcy w podłączeniu
    „Error: phone is required for recipient” (albo postcode, city, street) W zamówieniu brakuje telefonu lub adresu odbiorcy Wpisz je w formularzu listu przewozowego i utwórz go ponownie
    „Error: content is required for shipment” Puste pole „Opis przesyłki” Wpisz, co jest w paczce
    „Error:” z odmową autoryzacji od DHL Błędny klucz WebAPI albo klucz z sandboksu przy wyłączonym „Środowisko testowe (sandbox)” lub odwrotnie Porównaj klucz w DHL24 i przełącznik sandboksu (klucz WebAPI)
    Paczki DHL w „Przesyłkach” mają stan „Nieznany” Kody DHL nie są wpisane w „Statusy dostawy” Wpisz kody (kody statusów)
    „List przewozowy już utworzony: ‹numer› — pominięto.”, choć paczkę usunięto w DHL24 Paczkę usunięto w DHL24, a nie z Elbuz — w zamówieniu został jej numer Wyczyść pole „Numer listu przewozowego” i utwórz list ponownie; w przyszłości usuwaj z Elbuz (usuwanie)

    Najczęstsze pytania

    Ile kosztuje integracja z DHL?

    Elbuz nie pobiera opłat za listy przewozowe ani statusy. Za paczki płacisz DHL według swojej umowy, na numer klienta SAP.

    Czy mogę wysłać paczkę DHL do punktu lub automatu?

    Z Elbuz — nie, tylko na adres odbiorcy. Paczkę do punktu DHL nadaje się w DHL24 albo przez Apaczkę.

    Czy mogę wysłać DHL za granicę?

    Nie: w liście przewozowym z Elbuz odbiorca jest zawsze w Polsce. Paczki międzynarodowe nadawaj w DHL24.

    Czy mogę zamówić kuriera DHL z Elbuz?

    Nie. Kuriera zamawia się w DHL24 albo umawia z DHL stały odbiór.

    Hasło w formularzu wyświetla się jako kropki — czy jest zapisane?

    Tak: kropki pojawiają się tylko wtedy, gdy hasło jest zapisane. Puste pole go nie kasuje.

    Dlaczego status w Elbuz jest opóźniony względem DHL?

    Elbuz pyta DHL co 10 minut i bierze do 100 paczek na przebieg. Bieżący status pokazuje „Podgląd listu przewozowego” — on pyta DHL za każdym razem.

    Gdzie to jest i kto ma dostęp

    Menu
    Panel klienta → Ustawienia systemu → Inne ustawienia → Usługi zewnętrzne i integracje → Dostawa
    Inne wejścia
    Słowniki → Dokumenty → Przesyłki → „Przewoźnicy”; karta zamówienia → sekcja „Dostawa”
    Uprawnienia
    podłączenie — „API i tokeny dostępu”; list przewozowy — okno „Tworzenie listu przewozowego”; paczki — „Przesyłki”
    Przygotuj
    umowę z DHL Parcel Polska, numer klienta SAP, login i hasło WebAPI

    List przewozowy można wystawić tylko do zamówienia, które użytkownik widzi zgodnie z ustawieniem „Czyje dane”.

    1. Uzyskaj login i hasło WebAPIDHL24 → Integracje
    2. Wpisz klucz, numer SAP i adres nadawcyUsługi zewnętrzne i integracje → DHL Parcel
    3. Wpisz kody statusów DHLTamże, „Ustawienia powiadomień”
    4. Wystaw list przewozowyKarta zamówienia, sekcja „Dostawa”
    5. Wydrukuj etykietę„Podgląd listu przewozowego” lub „Przesyłki”
    6. W razie potrzeby usuń list przewozowy„Podgląd listu przewozowego” lub „Przesyłki”

    Powiązane tematy

    Czy ten artykuł był pomocny?

    Brakuje funkcji? Napisz do nas.

    Dodamy ją za darmo, jeśli przyda się też innym.

    Jeśli potrzebujesz jej tylko ty — umówimy się osobno.

    Spis treści

    Zaproponuj usprawnienie

    Wypróbuj Elbuz za darmo