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
- List przewozowy z zamówienia — dostawa pod adres w Polsce z pobraniem i deklarowaną wartością, pojedynczo lub zbiorczo.
- Etykieta — PDF z karty zamówienia lub z „Przesyłek”.
- Usuwanie listu przewozowego — dopóki do paczki nie zamówiono kuriera.
- Statusy paczek — co 10 minut; według Twojej tabeli kodów zmienia się stan paczki i status zamówienia.
- Środowisko testowe — pierwsze listy przewozowe możesz wystawić w sandboksie DHL24.
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.
- Zaloguj się do DHL24 na konto powiązane z umową.
- Otwórz stronę „Integracje”, sekcję „Klucze APIv2 / API PS”: tam jest klucz i reset hasła.
- 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)”.
1
Użytkownik i hasło2
Numer klienta (SAP)3
Produkt domyślny4
Środowisko testowe (sandbox)5
Nadawca- „Użytkownik” i „Hasło” — login i hasło DHL24 WebAPI.
- „Numer klienta (SAP)” — Twój numer klienta DHL24.
- „Produkt domyślny” — usługa DHL, z którą powstaje list przewozowy, tutaj przesyłka krajowa (AH).
- „Środowisko testowe (sandbox)” — zapytania idą na testowy serwer DHL zamiast produkcyjnego.
- „Nadawca” — firma i adres drukowane na każdym liście przewozowym jako nadawca.
| Pole | Co 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.
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ć
1
Adres odbiorcy2
Waga całkowita, kg3
Deklarowana wartość, zł4
Opis przesyłki5
Dostawa zwrotna (odbiorca)- „Kod pocztowy”, „Miejscowość”, „Ulica” i „Nr domu” — adres odbiorcy z zamówienia.
- „Waga całkowita, kg” — waga paczki, pobrana z zamówienia.
- „Deklarowana wartość, zł” — zadeklarowana wartość paczki, z sumy zamówienia.
- „Opis przesyłki” — opis zawartości, złożony z pozycji zamówienia.
- „Dostawa zwrotna (odbiorca)” — pobranie; „Niepotrzebna”, bo zamówienie jest już opłacone.
| Pole | Co jest od razu | Co sprawdzić |
|---|---|---|
| „Nazwisko”, „Imię”, „Telefon”, „E-Mail” | klient z zamówienia | bez 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ść”, cm | puste | puste — pójdzie 30 × 20 × 10 cm |
| „Deklarowana wartość, zł” | suma zamówienia | na tę kwotę DHL ubezpiecza paczkę; wyczyszczone pole też da sumę zamówienia |
| „Opis przesyłki” | kategoria produktu, bez niej — lista produktów | obowią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.
- Potwierdź „Usunąć list przewozowy ‹numer› u przewoźnika?”.
- 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.
- Po pierwszych paczkach otwórz „Podgląd listu przewozowego”: w „Szczegóły API” wiersz StatusCode to kod DHL, Status — jego opis.
- Podłączenie DHL → „Ustawienia powiadomień” → „Statusy dostawy”. W kolumnie „Kod (nazwa) na stronie (API)” wpisz kod przy swoim statusie; kilka kodów — po przecinku.
- 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 dostawy | Stan 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 wpisany | Nieznany — paczka trafia do filtra „Problemy” |
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
| Co widzisz | Dlaczego tak jest | Co 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”.
- Uzyskaj login i hasło WebAPIDHL24 → Integracje
- Wpisz klucz, numer SAP i adres nadawcyUsługi zewnętrzne i integracje → DHL Parcel
- Wpisz kody statusów DHLTamże, „Ustawienia powiadomień”
- Wystaw list przewozowyKarta zamówienia, sekcja „Dostawa”
- Wydrukuj etykietę„Podgląd listu przewozowego” lub „Przesyłki”
- W razie potrzeby usuń list przewozowy„Podgląd listu przewozowego” lub „Przesyłki”
Powiązane tematy
- Jeśli chcesz widzieć paczki wszystkich przewoźników na jednej liście — Przesyłki.
- Jeśli listy przewozowe trzeba wystawić do dziesiątek zamówień — listy przewozowe zbiorczo.
- Jeśli nie masz umowy z DHL, a potrzebujesz paczek DHL — Apaczka.
- Jeśli wysyłasz innym przewoźnikiem — jak wystawić list przewozowy z zamówienia.
