Elbuz tworzy przesyłkę InPost prosto z zamówienia: paczkomat dobiera się z adresu klienta, numer śledzenia sam trafia do zamówienia, a etykietę drukujesz z karty.
Kiedy to się przyda:
- Klienci wybierają paczkomat na stronie lub w marketplace — kod punktu z adresu zamówienia sam trafia do formularza.
- Zamówienia płatne przy odbiorze — kwota pobrania jest brana z zamówienia.
- Paczka nie mieści się w paczkomacie — ten sam rekord wyśle ją kurierem InPost na adres.
- Musisz wiedzieć, gdzie jest paczka — co 10 minut status InPost odświeża się w zamówieniu i w rejestrze „Przesyłki”.
Od czego zacząć: utwórz token ShipX w Managerze Paczek → wpisz go razem z ID organizacji w Elbuz.
Co potrafi InPost w Elbuz
- Przesyłka z zamówienia — do paczkomatu lub kurierem, z pobraniem i deklarowaną wartością.
- Dobór paczkomatu — po kodzie punktu w adresie zamówienia albo z list „Województwo” → „Miejscowość” → „Punkt InPost”.
- Etykieta PDF — z karty zamówienia i z rejestru „Przesyłki”, bez logowania do Managera Paczek.
- Statusy paczek — co 10 minut; zamówienie w wybranych statusach samo przechodzi na Twój status.
Jak podłączyć InPost: token ShipX i ID organizacji
Skąd wziąć token ShipX i ID organizacji
Token daje Elbuz dostęp do Twojej organizacji w InPost: przesyłek, etykiet i punktów. Tworzy się go w Managerze Paczek.
- Zaloguj się do Managera Paczek i otwórz „Moje Konto”.
- Sprawdź, czy dane firmy i dane do faktury są uzupełnione: bez nich token się nie utworzy.
- Na karcie API rozwiń „API ShipX” i kliknij „Generuj”. Do samych paczkomatów numer umowy nie jest potrzebny; do kuriera InPost poprosi o numer klienta z umowy kurierskiej.
- Skopiuj token przyciskiem „Pokaż token”. ID organizacji znajdziesz na karcie „Ustawienia organizacji”.
Instrukcja InPost krok po kroku, z ilustracjami — instrukcja konfiguracji API ShipX (PDF).
Gdzie wpisać token w Elbuz
Gdzie: „Usługi zewnętrzne i integracje” → grupa „Dostawa” → InPost.
- Włącz „Aktywność”.
- Wklej token w pole „Token”. Zapisany klucz jest pokazywany jako kropki; puste pole go nie kasuje.
- Wpisz „ID organizacji” w bloku „Parametry InPost (ShipX)”. Bez niego przesyłka się nie utworzy.
- Wybierz „Sposób nadawania przesyłek”: „Paczkomat”, „Odbiór przez kuriera (dispatch order)” lub „Punkt nadania (POP)”. Przy „Domyślnie (z umowy)” InPost weźmie sposób z umowy.
1
Token2
ID organizacji3
Sposób nadawania przesyłek4
Środowisko testowe- Token — tu wpisuje się token organizacji; po zapisaniu jest pokazywany jako kropki.
- ID organizacji — identyfikator z konta w Managerze Paczek.
- Sposób nadawania przesyłek — jak przekazujesz paczki; domyślny wynika z umowy.
- Środowisko testowe — przełącznik do testów na środowisku testowym InPost.
Formularz zapisuje się sam przy każdej zmianie pola, przycisku „Zapisz” nie ma. Token nie jest sprawdzany przy zapisie: błąd klucza pokaże dopiero pierwszy list przewozowy.
„Środowisko testowe (sandbox)” przełącza Elbuz na piaskownicę ShipX. Token do niej jest osobny, z Sandbox Managera; paczki z piaskownicy nigdzie nie jadą.
Listę paczkomatów Elbuz pobiera sam, klucz nie jest do tego potrzebny. Tabela „Słowniki przewoźnika” w rekordzie pokazuje, ile jest punktów i kiedy je zaktualizowano; aktualizacja odbywa się co noc.
Jak wysłać zamówienie przez InPost
Gdzie: karta zamówienia → „Sposób dostawy” = InPost → sekcja „Dostawa” → „Utwórz list przewozowy” („Edytuj list przewozowy”, jeśli formularz był już otwierany).
Formularz bierze odbiorcę, kwotę i wagę z zamówienia. Tobie zostaje sprawdzenie punktu, gabarytu i pobrania.
1
Sposób wysyłki2
Punkt InPost3
Gabaryt paczki4
Dostawa zwrotna (odbiorca)5
Przycisk tworzenia listu przewozowego- Sposób wysyłki — wybrany jest Paczkomat.
- Punkt InPost — listy województw, miejscowości i punktów odbioru.
- Gabaryt paczki — gabaryty A, B i C; wybrany jest B.
- Dostawa zwrotna (odbiorca) — kwota pobrania od odbiorcy.
- Utwórz list przewozowy — wysyła żądanie do InPost.
Paczkomat: punkt i gabaryt
Elbuz szuka kodu paczkomatu w adresie zamówienia (w postaci KRA01A lub POP-WAW762) i sprawdza go w słowniku InPost. Jeśli go znajdzie, w formularzu są już wybrane województwo, miasto i punkt.
Jeśli nie znajdzie — wybierz punkt z list „Województwo” → „Miejscowość” → „Punkt InPost”. Na liście są tylko działające punkty, które wydają paczki.
| Gabaryt | Wymiary z opakowaniem | Waga |
|---|---|---|
| A | 8 × 38 × 64 cm | do 25 kg |
| B (domyślnie) | 19 × 38 × 64 cm | do 25 kg |
| C | 41 × 38 × 64 cm | do 25 kg |
Do paczkomatu telefon i e-mail odbiorcy są obowiązkowe: na nie InPost wysyła kod odbioru. Elbuz skraca telefon do 9 cyfr, odrzucając prefiks +48.
Kurier InPost na adres
Wybierz „Kurier InPost”: zamiast punktu pojawi się blok „Adres” („Miejscowość”, „Kod pocztowy”, „Ulica”, „Nr domu”) i wymiary „Długość, cm”, „Szerokość, cm”, „Wysokość, cm”. Bez wymiarów Elbuz przekaże 30 × 20 × 10 cm.
Kurier InPost na umowie przyjmuje paczkę do 50 kg, z najdłuższym bokiem do 120 cm i sumą boków do 220 cm. Odbiorca — tylko w Polsce.
Pobranie i deklarowana wartość
„Dostawa zwrotna (odbiorca)” jest ustawiona na „Pieniądze”, jeśli zamówienie nie jest opłacone, a płatność następuje przy odbiorze. Kwota to suma zamówienia bez przeliczania waluty: jeśli zamówienie nie jest w złotych, wpisz kwotę w zł w polu „Kwota, zł”.
Pobranie do paczkomatu — do 5 000 zł. InPost przelewa pieniądze na rachunek z umowy lub z Managera Paczek w ciągu pięciu dni roboczych od zapłaty.
„Deklarowana wartość, zł” — kwota, na jaką InPost ubezpiecza paczkę, według swojego cennika.
Co się dzieje po kliknięciu „Utwórz list przewozowy”
- Elbuz sprawdza, czy w zamówieniu nie ma jeszcze numeru: podwójne kliknięcie nie utworzy drugiego listu.
- Wysyła przesyłkę do InPost i czeka do 12 sekund na numer śledzenia: InPost nie nadaje go od razu.
- Zapisuje numer w polu „Numer listu przewozowego”, a link „Utwórz list przewozowy” znika z karty.
Jeśli w ciągu 12 sekund numeru nie ma, do zamówienia trafi wewnętrzny numer przesyłki InPost — krótka liczba. Statusy i druk działają także z nim.
Formularz zapamiętuje wpisane dane w zamówieniu: po zamknięciu okna wartości zostają. Listy przewozowe do kilku zamówień naraz — przyciskiem „Utwórz list przewozowy (dostawa)” na liście zamówień; punkt jest brany z adresu, gabaryt — B.
Druk etykiety i anulowanie
„Drukuj” przy numerze w podglądzie listu przewozowego albo „Drukuj list przewozowy” w „Przesyłkach” otwiera etykietę PDF. Elbuz pobiera ją z InPost sam: token nie trafia do przeglądarki, logowanie do Managera Paczek nie jest potrzebne.
Etykiety InPost drukują się pojedynczo: kilka jednym przyciskiem — tylko w Nova Poshta.
Anulować ani zmienić przesyłki InPost z Elbuz nie można. Anuluj ją w Managerze Paczek, a numer w polu zamówienia „Numer listu przewozowego” wyczyść ręcznie — wtedy list przewozowy można utworzyć ponownie.
Jak Elbuz śledzi paczkę InPost
Co 10 minut Elbuz pyta InPost o stan paczek — do 100 listów przewozowych na przebieg, najpierw te, które najdłużej nie były sprawdzane. Nazwę statusu InPost podaje po polsku, tak jak na swojej stronie: „Umieszczona w automacie Paczkomat (odbiorczym).”.
Kody InPost z tabeli poniżej Elbuz sam wpisuje w oknie „Statusy dostawy” rekordu InPost — na ich podstawie w „Przesyłkach” pojawia się stan „W punkcie odbioru”, „Doręczona” lub „Odmowa”. Kod spoza tabeli daje stan „Nieznany”. Jak oznaczyć statusy zamówienia, które zmieniają się same, opisuje artykuł o statusach przewoźnika.
| Status dostawy Elbuz | Kody InPost | Stan w „Przesyłkach” |
|---|---|---|
| Oczekiwanie od nadawcy | created, confirmed | Utworzona |
| Zebrane | dispatched_by_sender, taken_by_courier, dispatched_by_sender_to_pok | Utworzona |
| W drodze | adopted_at_sorting_center, sent_from_sorting_center, adopted_at_target_branch | W drodze |
| Wydany kurierowi | out_for_delivery, out_for_delivery_to_address | W drodze |
| W miejscu docelowym | ready_to_pickup, ready_to_pickup_from_pok, pickup_reminder_sent | W punkcie odbioru |
| Dostarczono | delivered | Doręczona |
| Odrzucenie | rejected_by_receiver, returned_to_sender, pickup_time_expired | Odmowa |
Kody wpisuje się po przecinku w kolumnie „Kod (nazwa) na stronie (API)”; komórka mieści do 80 znaków, więc wpisuj główne kody, a nie wszystkie 53.
1
Kod (nazwa) na stronie (API)2
W miejscu docelowym3
Dostarczono- Kod (nazwa) na stronie (API) — kody statusów InPost, które Elbuz przypisuje do każdego statusu dostawy.
- W miejscu docelowym — paczka czeka na odbiór: ready_to_pickup, ready_to_pickup_from_pok i pickup_reminder_sent.
- Dostarczono — do tego statusu przypisany jest tylko kod delivered.
Elbuz odpytuje paczkę, dopóki zamówienie nie ma 60 dni albo dopóki jest w wybranym statusie; kod ze stanu „Doręczona” kończy odpytywanie wcześniej. Status zamówienia, dostawy i płatności zmienia się tylko w zamówieniach w wybranych statusach, w pozostałych odświeża się jedynie stan paczki.
W paczkomacie paczka czeka 48 godzin, w PaczkoPunkcie — 72. Po 36 godzinach InPost przypomina odbiorcy, a jeśli paczka nie zostanie odebrana, wraca do nadawcy.
W „Przesyłkach” przycisk „Śledź na stronie przewoźnika” otwiera stronę inpost.pl/sledzenie-przesylek z numerem paczki, a „SMS do odbiorcy” — okno wiadomości do klienta.
Scenariusze
Codzienne zamówienia do paczkomatów
Klient wybiera paczkomat na stronie, kod punktu przychodzi w adresie zamówienia. Zaznacz zamówienia na liście → „Utwórz list przewozowy (dostawa)”: listy tworzą się zbiorczo z gabarytem B. Etykiety drukuj z „Przesyłek”.
Zamówienia za pobraniem
Zamówienie nieopłacone, płatność przy odbiorze — formularz sam ustawia „Pieniądze” i kwotę zamówienia. Gdy klient odbierze paczkę, w „Przesyłkach” stan zmieni się na „Doręczona”, a InPost przeleje pieniądze zgodnie z umową.
Duża paczka kurierem
Wybierz „Kurier InPost”, sprawdź adres, wpisz wagę i wymiary. Pamiętaj o limicie kuriera: do 50 kg i 220 cm sumy boków.
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 rekordzie InPost nie ma tokenu albo „Aktywność” jest wyłączona | Wpisz token i włącz rekord (gdzie wpisać token) |
| „Error: organization_id is required (API settings)” | Nie wpisano ID organizacji | Weź je w Managerze Paczek, karta „Ustawienia organizacji” (skąd je wziąć) |
| „Error: email is required for recipient (parcel locker)” | W zamówieniu nie ma e-maila odbiorcy, a paczkomat go wymaga | Wpisz e-mail w pole „E-mail” formularza (paczkomat) |
| „Error: target_point is required (parcel locker)” | Punkt nie jest wybrany, a kod paczkomatu w adresie nie został rozpoznany | Wybierz „Województwo” → „Miejscowość” → „Punkt InPost” (paczkomat) |
| Listy „Województwo” i „Punkt InPost” są puste | Słownik punktów nie był aktualizowany od ponad trzech dni | Napisz do wsparcia Elbuz: bez słownika nie wybierzesz paczkomatu |
| W „Przesyłkach” stan „Nieznany” | InPost zwrócił kod, którego nie ma w tabeli, albo kod został usunięty ze „Statusów dostawy” | Dopisz kod do właściwego statusu (statusy) |
Najczęstsze pytania
Ile kosztuje integracja z InPost?
Elbuz nie pobiera opłat za przesyłki, etykiety ani statusy. Za przesyłki płacisz InPost według jego cennika lub umowy.
Czy potrzebna jest umowa z InPost?
Do paczkomatów token tworzy się na koncie Managera Paczek z danymi firmy. Do kuriera InPost wymaga numeru klienta z umowy kurierskiej (token ShipX).
Dlaczego w zamówieniu jest krótka liczba, a nie numer śledzenia?
InPost nie zdążył nadać numeru w ciągu 12 sekund, więc Elbuz zapisał wewnętrzny numer przesyłki. Statusy i druk działają także z nim (po utworzeniu).
Czy można zamówić kuriera InPost z Elbuz?
Nie, przycisku zamówienia kuriera dla InPost nie ma. Sposób przekazywania paczek ustawia „Sposób nadawania przesyłek” w rekordzie InPost; odbiór przez kuriera zamawia się w Managerze Paczek.
Czy można wysłać paczkę InPost za granicę?
Nie, Elbuz tworzy przesyłki InPost tylko do odbiorców w Polsce.
Statusy przychodzą po polsku — czy tak ma być?
Tak, nazwę statusu podaje InPost. Stan w „Przesyłkach” i Twój status dostawy Elbuz pokazuje w języku interfejsu, według kodu (kody InPost).
Gdzie to jest i kto ma dostęp
- Menu
- Panel klienta → Ustawienia systemu → Inne ustawienia → Usługi zewnętrzne i integracje → Dostawa → InPost
- 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 — „Tworzenie listu przewozowego”; paczki — „Przesyłki”
- Przygotuj
- konto w Managerze Paczek z danymi firmy; do kuriera — umowę z InPost
- Utwórz token ShipX i weź ID organizacjiManager Paczek
- Wpisz token i ID organizacjiUsługi zewnętrzne i integracje → InPost
- Wpisz kody InPost w „Statusy dostawy”Tamże, „Ustawienia powiadomień”
- Utwórz przesyłkęKarta zamówienia, sekcja „Dostawa”
- Wydrukuj etykietęPodgląd listu przewozowego lub „Przesyłki”
Powiązane tematy
- Jeśli chcesz widzieć paczki wszystkich przewoźników na jednej liście — rejestr „Przesyłki”.
- Jeśli zamówienie przyszło z Allegro i trzeba je wysłać etykietą Allegro — Wysyłam z Allegro w Elbuz.
- Jeśli listy przewozowe trzeba utworzyć do dziesiątek zamówień — listy przewozowe zbiorczo.
- Jeśli status zamówienia ma się zmieniać sam według statusu paczki — statusy przewoźnika.
- Jeśli klient ma wybrać paczkomat InPost w koszyku Twojego sklepu — to dostawa w sklepie Elbuz CMS.
