InPost

Integracja z InPost tworzy przesyłki do paczkomatów InPost przez API ShipX. Podłączasz ją tokenem API i ID organizacji z Managera Paczek InPost.

Integracji InPost możesz dodać dowolnie wiele, także kilka dla tego samego konta - na przykład z innym formatem etykiety, inną paczką albo innym adresem nadawcy. Każda działa osobno.

Jakie przesyłki tworzy

Paczkomat - przesyłka zawsze jedzie do paczkomatu wybranego przez kupującego. Zamówienie musi mieć punkt odbioru - bez niego InPost odrzuci przesyłkę.
Kurier - przesyłki kurierskie nie są obsługiwane.
Zamówienia z Allegro - dostają usługę Paczkomat Allegro, a pozostałe zwykłą usługę Paczkomat.
Pobranie i ubezpieczenie - pobranie z zamówienia, ubezpieczenie z ustawień integracji.
Dowolny kanał sprzedaży - przesyłkę utworzysz dla zamówienia z każdego kanału.

Skąd wziąć token i ID organizacji

Oba znajdziesz w Managerze Paczek InPost. Przygotuj je przed dodaniem integracji:

Zaloguj się do Managera Paczek InPost na manager.paczkomaty.pl.
Przejdź do Moje konto → API i w zakładce API ShipX kliknij Generuj. Skopiuj token.
W zakładce Ustawienia organizacji skopiuj ID organizacji. Pojawi się ono dopiero po wygenerowaniu tokenu.

Podłączenie konta

Zacznij w Ritevo:

Wejdź w Integracje w lewym panelu i kliknij Dodaj integrację w prawym górnym rogu.
W sekcji Przesyłki wybierz kafelek Inpost paczkomat ShipX.
Wpisz Nazwa konta - własną nazwę integracji - oraz wklej Token API ShipX i ID organizacji ShipX.
Uzupełnij pozostałe ustawienia opisane niżej i kliknij Dodaj integrację. Token sprawdzamy od razu w InPost: jeśli jest błędny, zobaczysz błąd zwrócony przez InPost i nic nie zostanie zapisane.

Lista integracji w Ritevo z zaznaczonym przyciskiem Dodaj integrację w prawym górnym rogu

Ekran Dodaj integrację z zaznaczonym kafelkiem Inpost paczkomat ShipX w sekcji Przesyłki

Ekran dodawania integracji InPost z polami Nazwa konta, Token API ShipX, ID organizacji ShipX, gabarytem, formatem etykiety, sposobem nadania i kodem punktu

Ustawienia integracji

Na stronie integracji znajdziesz poniższe pola. Zmiany zapisujesz przyciskiem Zaktualizuj integrację:

Nazwa konta - Twoja własna nazwa integracji.
Domyślny gabaryt paczki - Gabaryt A, Gabaryt B albo Gabaryt C. Domyślnie A.
Format etykiety - A4 PDF, A6 PDF, A6 ZPL, A6 ZPL 300dpi albo A6 EPL. Domyślnie A6 PDF.
Sposób nadania - jak przekazujesz paczki InPost: Odbiór przez kuriera, Nadanie w automacie Paczkomat, Nadanie w oddziale InPost, Nadanie w POK, Nadanie w POP (PaczkoPunkt) albo Nadanie w dowolnym punkcie. Domyślnie odbiór przez kuriera.
Kod punktu nadawczego - kod punktu, w którym nadajesz paczki. Pole jest wymagane przy każdym sposobie nadania.
Zaktualizuj token - podajesz nowy token API ShipX.
Adres nadawcy na etykiecie - dane nadawcy, które przewoźnik drukuje na etykiecie.
Adres odbioru przesyłek przez kuriera - adres, spod którego kurier odbiera paczki. Może być inny niż adres nadawcy na etykiecie - na przykład przy dropshippingu: na etykiecie jest Twój sklep, a kurier odbiera paczkę z hurtowni.
Dodatkowe ubezpieczenie - kwota ubezpieczenia każdej przesyłki: Brak, Wartość zamówienia z dostawą, Wartość zamówienia bez dostawy albo Stała kwota. W Źródło waluty wybierasz walutę zamówienia, walutę kraju dostawy albo stałą walutę.

Szczegóły integracji InPost: ustawienia podstawowe z gabarytem, formatem etykiety, sposobem nadania i kodem punktu oraz adres nadawcy

Karta Adres nadawcy na etykiecie z polami firmy, imienia i nazwiska, adresu, kraju, telefonu i e-maila

Karta Adres odbioru przesyłek przez kuriera z polami firmy, imienia i nazwiska, adresu, kraju, telefonu i e-maila

Karta Dodatkowe ubezpieczenie z polami Typ ubezpieczenia i Źródło waluty

Tworzenie przesyłek

Przesyłkę tworzysz z zamówienia na dwa sposoby:

Ręcznie - w szczegółach zamówienia, w karcie Przesyłki, kliknij przycisk z nazwą integracji InPost. Przyciski widzisz tylko dla aktywnych integracji, które pasują do zamówienia.
Automatycznie - krokiem Utwórz przesyłkę w akcjach dla zamówień.

Dane przesyłki bierzemy z zamówienia:

Odbiorca - adres dostawy z zamówienia oraz telefon i e-mail kupującego.
Punkt odbioru - punkt wybrany przez kupującego, jeśli zamówienie go ma.
Pobranie - kwota do zapłaty z zamówienia, gdy metoda płatności to Płatność przy odbiorze.
Paczka - jedna przesyłka to zawsze jedna paczka.

W tej samej karcie każda przesyłka ma numer śledzenia, stan i datę utworzenia. Stany:

W trakcie tworzenia - przewoźnik jeszcze tworzy przesyłkę. Sprawdzamy ją co kilka sekund. Jeśli przewoźnik nie potwierdzi przesyłki w ciągu 24 godzin, kończy się ona błędem.
Utworzona pomyślnie - przesyłka jest u przewoźnika i ma numer śledzenia.
Błąd podczas tworzenia - przewoźnik nie przyjął przesyłki. Przy stanie widzisz powód, a przy błędzie przewoźnika także jego komunikat.

Etykietę utworzonej przesyłki pobierzesz przyciskiem Pobierz w karcie Przesyłki. Drukujesz ją na dwa sposoby - na komputerze z drukarką musi wtedy działać aplikacja Ritevo Printer:

Ręcznie - w karcie Przesyłki kliknij Drukuj i wybierz drukarkę.
Automatycznie - krokiem Wydrukuj etykietę przesyłki w akcjach dla zamówień. Krok drukuje etykietę ostatniej przesyłki ze stanem Utworzona pomyślnie - przesyłki w trakcie tworzenia i z błędem pomija.

Druk etykiet najlepiej zaplanować po kolei, jako dwie akcje:

Pierwsza akcja - kończy się krokiem Utwórz przesyłkę.
Druga akcja - startuje wyzwalaczem Stworzono przesyłkę, ma warunek Status przesyłki jest z wartością Utworzona pomyślnie i jeden krok Wydrukuj etykietę przesyłki. Dzięki temu każda nowa przesyłka od razu drukuje swoją etykietę - także gdy zamówienie ma kilka paczek.

Jak przesyłka trafia do InPost

Potwierdzenie - InPost tworzy przesyłkę w tle, więc najpierw ma ona stan W trakcie tworzenia. Gdy InPost nada numer śledzenia, zmienia się na Utworzona pomyślnie.
Numer śledzenia - numer przesyłki InPost. Ten sam numer jest na etykiecie.
Anulowanie w InPost - przesyłka anulowana w InPost w trakcie tworzenia kończy się błędem.

Wymaga ponownego połączenia

Ten stan pojawia się, gdy InPost przestał akceptować token - na przykład po wygenerowaniu nowego tokenu w Managerze Paczek. Do czasu podania nowego tokenu nie utworzysz przesyłek ani nie pobierzesz etykiet.

W Managerze Paczek InPost skopiuj aktualny token z zakładki API ShipX.
Na stronie integracji kliknij Zaktualizuj token, wklej go w polu Nowy token API ShipX i zatwierdź. Sprawdzamy go w InPost tak samo jak przy dodawaniu - poprawny odświeży połączenie, a ustawienia zostają bez zmian.

Dół strony integracji InPost z przyciskami Zaktualizuj token i Zaktualizuj integrację

Okno Zaktualizuj token w integracji InPost z polem Nowy token API ShipX

Usunięcie integracji

Usuń integrację wyłącza integrację w Ritevo. Przesyłki utworzone wcześniej zostają w zamówieniach i u przewoźnika. Przywróć integrację włącza ją z powrotem.

Czego integracja nie robi

Nie zamawia podjazdu kuriera.
Nie anuluje przesyłek.
Nie śledzi przesyłki po jej utworzeniu - stan doręczenia sprawdzasz u przewoźnika.
Nie przekazuje numeru śledzenia do kanału sprzedaży.
Nie tworzy przesyłek z kilkoma paczkami.
Nie tworzy przesyłek kurierskich - tylko do paczkomatów.