Token API InPost – jak go wygenerować i gdzie go wkleić
Mateusz Piotrowicz
Mateusz Piotrowicz
Technical & Logistics Expert
Token API InPost – jak go wygenerować i gdzie go wkleić
Token InPost to klucz, który pozwala sklepowi, wtyczce albo systemowi do obsługi sprzedaży tworzyć przesyłki na Twoim koncie w InPost – bez logowania do panelu i ręcznego przepisywania danych. Bez tokenu integracja po prostu nie zadziała: nie wygeneruje etykiety, nie pobierze statusu i nie pokaże mapy Paczkomatów. To jeden z pierwszych kroków przy podłączaniu InPost do sklepu, a jednocześnie częste źródło problemów, gdy token jest wygenerowany na niewłaściwym koncie albo bez numeru umowy kurierskiej.
W tym artykule pokazujemy krok po kroku, jak wygenerować token API ShipX w Managerze Paczek, czym różni się od tokenu Geowidgetu, gdzie najczęściej się go wkleja – w Wysyłam z Allegro, w systemie do obsługi sprzedaży i we wtyczkach sklepów – oraz co zrobić, gdy integracja zwraca błąd autoryzacji.
Token InPost – czym jest i do czego służy
W ekosystemie InPost funkcjonują dwa rodzaje tokenów, które łatwo pomylić. Token API ShipX daje dostęp do tworzenia przesyłek, pobierania etykiet i statusów – to klucz poufny, który powinien znać tylko serwer integracji. Token Geowidgetu służy do wyświetlania mapy punktów w koszyku sklepu – jest publiczny i przypisany do konkretnych domen. W większości integracji potrzebujesz pierwszego, a jeśli sklep pokazuje mapę Paczkomatów – także drugiego.
Cecha | Token API ShipX | Token Geowidgetu |
Do czego służy | Tworzenie przesyłek, etykiety, statusy | Mapa punktów w koszyku |
Gdzie się go generuje | Manager Paczek – zakładka API, API ShipX | Manager Paczek – sekcja Geowidget |
Czy jest poufny | Tak – daje dostęp do nadawania na Twój koszt | Nie – jest widoczny w kodzie strony |
Ograniczenia | Bez numeru umowy kurierskiej tylko Paczkomaty | Działa na wskazanych domenach |
Ile można mieć | Do 10 tokenów na konto | Według ustawień w panelu |
Szerzej o tym, co można zrobić przez API, piszemy w artykule ShipX API InPost – jak zintegrować wysyłki z własnym systemem.
Jak wygenerować token API ShipX krok po kroku
Według dokumentacji InPost token generuje się w Managerze Paczek na koncie firmowym. Zanim zaczniesz, upewnij się, że masz dostęp do właściwego konta – tego, na które mają być rozliczane przesyłki.
Zaloguj się do Managera Paczek na koncie firmowym.
Przejdź do ustawień konta i uzupełnij dane adresowe oraz dane do faktury. Bez kompletnych danych generowanie tokenu może być niedostępne.
Otwórz zakładkę API i wybierz API ShipX.
Kliknij opcję generowania tokenu. System zapyta o numer umowy kurierskiej – podaj go, jeśli chcesz nadawać przesyłki kurierskie.
Po wygenerowaniu skopiuj token (opcja pokazania tokenu) oraz ID organizacji widoczne w danych konta.
Wklej token w ustawieniach integracji i wykonaj testowe utworzenie przesyłki.
Wykres – kolejne kroki generowania tokenu API ShipX. [#chart:ip17]
[#uwaga] Według dokumentacji token wygenerowany bez numeru umowy kurierskiej pozwala tworzyć tylko przesyłki do Paczkomatów. Jeśli integracja tworzy przesyłki paczkomatowe, ale zwraca błąd przy kurierze, najczęstszą przyczyną jest właśnie token bez umowy. Rozwiązaniem jest wygenerowanie nowego tokenu z numerem umowy.
Token i ID organizacji – po co oba
Wiele integracji prosi nie tylko o token, ale też o ID organizacji. Według dokumentacji ShipX identyfikator organizacji jest częścią ścieżki zapytań przy tworzeniu przesyłek – token mówi, kto się łączy, a ID organizacji wskazuje, na którym koncie mają powstawać przesyłki. ID organizacji znajdziesz w danych konta w Managerze Paczek. Jeśli integracja zwraca błąd braku dostępu mimo poprawnego tokenu, sprawdź, czy ID organizacji pochodzi z tego samego konta.
Testowanie w sandboxie
Zanim podłączysz token produkcyjny, warto sprawdzić integrację w środowisku testowym. Dokumentacja InPost opisuje osobny, sandboxowy Manager Paczek, w którym zakładasz konto testowe, generujesz token testowy i tworzysz przesyłki bez prawdziwych opłat. To dobry moment, żeby sprawdzić: tworzenie przesyłek do Paczkomatu i kurierem, pobieranie etykiet w docelowym formacie, wyświetlanie mapy punktów w koszyku i aktualizację statusów zamówień.
Pamiętaj, że konto i token z sandboxu nie działają na produkcji – po zakończeniu testów trzeba w integracji przełączyć adres API i podmienić token na produkcyjny. Pomylenie środowisk to jeden z najczęstszych powodów, dla których „wszystko działało na testach, a nie działa w sklepie”.
Kiedy wygenerować nowy token
Podpisujesz umowę kurierską – stary token bez numeru umowy nie obsłuży kuriera, więc potrzebny jest nowy.
Zmieniasz system lub wtyczkę – nowy system dostaje własny token, a stary unieważniasz.
Kończysz współpracę z zewnętrznym wykonawcą – jeśli znał token, wygeneruj nowy i podmień go w integracjach.
Podejrzewasz wyciek – np. token trafił do publicznego repozytorium albo przesyłki pojawiają się bez Twojej wiedzy.
Porządkujesz konta – przy przenoszeniu wysyłek na inne konto lub organizację tokeny trzeba wygenerować na nowym koncie.
Token InPost to klucz, który pozwala sklepowi, wtyczce albo systemowi do obsługi sprzedaży tworzyć przesyłki na Twoim koncie w InPost – bez logowania do panelu i ręcznego przepisywania danych. Bez tokenu integracja po prostu nie zadziała: nie wygeneruje etykiety, nie pobierze statusu i nie pokaże mapy Paczkomatów. To jeden z pierwszych kroków przy podłączaniu InPost do sklepu, a jednocześnie częste źródło problemów, gdy token jest wygenerowany na niewłaściwym koncie albo bez numeru umowy kurierskiej.
W tym artykule pokazujemy krok po kroku, jak wygenerować token API ShipX w Managerze Paczek, czym różni się od tokenu Geowidgetu, gdzie najczęściej się go wkleja – w Wysyłam z Allegro, w systemie do obsługi sprzedaży i we wtyczkach sklepów – oraz co zrobić, gdy integracja zwraca błąd autoryzacji.
Token InPost – czym jest i do czego służy
W ekosystemie InPost funkcjonują dwa rodzaje tokenów, które łatwo pomylić. Token API ShipX daje dostęp do tworzenia przesyłek, pobierania etykiet i statusów – to klucz poufny, który powinien znać tylko serwer integracji. Token Geowidgetu służy do wyświetlania mapy punktów w koszyku sklepu – jest publiczny i przypisany do konkretnych domen. W większości integracji potrzebujesz pierwszego, a jeśli sklep pokazuje mapę Paczkomatów – także drugiego.
Cecha | Token API ShipX | Token Geowidgetu |
Do czego służy | Tworzenie przesyłek, etykiety, statusy | Mapa punktów w koszyku |
Gdzie się go generuje | Manager Paczek – zakładka API, API ShipX | Manager Paczek – sekcja Geowidget |
Czy jest poufny | Tak – daje dostęp do nadawania na Twój koszt | Nie – jest widoczny w kodzie strony |
Ograniczenia | Bez numeru umowy kurierskiej tylko Paczkomaty | Działa na wskazanych domenach |
Ile można mieć | Do 10 tokenów na konto | Według ustawień w panelu |
Szerzej o tym, co można zrobić przez API, piszemy w artykule ShipX API InPost – jak zintegrować wysyłki z własnym systemem.
Jak wygenerować token API ShipX krok po kroku
Według dokumentacji InPost token generuje się w Managerze Paczek na koncie firmowym. Zanim zaczniesz, upewnij się, że masz dostęp do właściwego konta – tego, na które mają być rozliczane przesyłki.
Zaloguj się do Managera Paczek na koncie firmowym.
Przejdź do ustawień konta i uzupełnij dane adresowe oraz dane do faktury. Bez kompletnych danych generowanie tokenu może być niedostępne.
Otwórz zakładkę API i wybierz API ShipX.
Kliknij opcję generowania tokenu. System zapyta o numer umowy kurierskiej – podaj go, jeśli chcesz nadawać przesyłki kurierskie.
Po wygenerowaniu skopiuj token (opcja pokazania tokenu) oraz ID organizacji widoczne w danych konta.
Wklej token w ustawieniach integracji i wykonaj testowe utworzenie przesyłki.
Wykres – kolejne kroki generowania tokenu API ShipX. [#chart:ip17]
[#uwaga] Według dokumentacji token wygenerowany bez numeru umowy kurierskiej pozwala tworzyć tylko przesyłki do Paczkomatów. Jeśli integracja tworzy przesyłki paczkomatowe, ale zwraca błąd przy kurierze, najczęstszą przyczyną jest właśnie token bez umowy. Rozwiązaniem jest wygenerowanie nowego tokenu z numerem umowy.
Token i ID organizacji – po co oba
Wiele integracji prosi nie tylko o token, ale też o ID organizacji. Według dokumentacji ShipX identyfikator organizacji jest częścią ścieżki zapytań przy tworzeniu przesyłek – token mówi, kto się łączy, a ID organizacji wskazuje, na którym koncie mają powstawać przesyłki. ID organizacji znajdziesz w danych konta w Managerze Paczek. Jeśli integracja zwraca błąd braku dostępu mimo poprawnego tokenu, sprawdź, czy ID organizacji pochodzi z tego samego konta.
Testowanie w sandboxie
Zanim podłączysz token produkcyjny, warto sprawdzić integrację w środowisku testowym. Dokumentacja InPost opisuje osobny, sandboxowy Manager Paczek, w którym zakładasz konto testowe, generujesz token testowy i tworzysz przesyłki bez prawdziwych opłat. To dobry moment, żeby sprawdzić: tworzenie przesyłek do Paczkomatu i kurierem, pobieranie etykiet w docelowym formacie, wyświetlanie mapy punktów w koszyku i aktualizację statusów zamówień.
Pamiętaj, że konto i token z sandboxu nie działają na produkcji – po zakończeniu testów trzeba w integracji przełączyć adres API i podmienić token na produkcyjny. Pomylenie środowisk to jeden z najczęstszych powodów, dla których „wszystko działało na testach, a nie działa w sklepie”.
Kiedy wygenerować nowy token
Podpisujesz umowę kurierską – stary token bez numeru umowy nie obsłuży kuriera, więc potrzebny jest nowy.
Zmieniasz system lub wtyczkę – nowy system dostaje własny token, a stary unieważniasz.
Kończysz współpracę z zewnętrznym wykonawcą – jeśli znał token, wygeneruj nowy i podmień go w integracjach.
Podejrzewasz wyciek – np. token trafił do publicznego repozytorium albo przesyłki pojawiają się bez Twojej wiedzy.
Porządkujesz konta – przy przenoszeniu wysyłek na inne konto lub organizację tokeny trzeba wygenerować na nowym koncie.
- Analiza obecnego procesu nadawania paczek
- Integracja InPost z Base, sklepem i marketplace'ami
- Plan automatyzacji etykiet i statusów
Gdzie wkleić token InPost
Miejsce wklejenia tokenu zależy od tego, z jakiego narzędzia nadajesz paczki. Zasada jest zawsze ta sama: token trafia do ustawień narzędzia, które ma tworzyć przesyłki w Twoim imieniu, a nie do miejsca, w którym klient wybiera dostawę. Jeśli korzystasz z kilku narzędzi jednocześnie – np. sklepu, Allegro i systemu magazynowego – każde z nich potrzebuje własnej konfiguracji. Poniżej najczęstsze przypadki.
Wykres – najczęstsze miejsca, w których wkleja się token InPost. [#chart:ip17b]
Wysyłam z Allegro
Jeśli chcesz nadawać przesyłki InPost w programie Wysyłam z Allegro na podstawie własnej umowy z przewoźnikiem, według pomocy Allegro potrzebujesz konta firmowego, umowy z InPost i tokenu ShipX z Managera Paczek. Token wkleja się w ustawieniach Wysyłam z Allegro, w sekcji integracji z InPost. Zasady programu opisujemy w artykule Wysyłam z Allegro – jak działa i ile kosztuje.
System do obsługi sprzedaży
W systemach takich jak Base token wkleja się w konfiguracji przewoźnika InPost – zwykle razem z ID organizacji. Po zapisaniu ustawień integracja może tworzyć przesyłki, pobierać etykiety i aktualizować statusy. Konfigurację krok po kroku opisujemy w poradniku BaseLinker InPost – Paczkomaty i nadawanie z panelu Base, a ogólne zasady podłączania przewoźników – w tekście kurierzy w BaseLinkerze.
Wtyczka w sklepie internetowym
Moduły InPost dla platform sklepowych, takich jak WooCommerce czy PrestaShop, mają w ustawieniach pola na token ShipX, ID organizacji i często osobne pole na token Geowidgetu. Po wklejeniu kluczy warto wykonać testowe zamówienie i sprawdzić, czy mapa punktów się wyświetla, a przesyłka tworzy się poprawnie. Integrację sklepów z systemem do obsługi sprzedaży opisujemy w tekstach BaseLinker WooCommerce i BaseLinker PrestaShop, a konfigurację wtyczek InPost dla poszczególnych platform omawiamy w kolejnych artykułach z tej serii.
Mapa Paczkomatów w koszyku
Token Geowidgetu generuje się w osobnej sekcji Managera Paczek, podając domeny, na których mapa ma działać. To token publiczny – jest widoczny w kodzie strony, więc nie daje dostępu do tworzenia przesyłek. Jeśli mapa nie wyświetla się po przeniesieniu sklepu na nową domenę, najczęściej trzeba dodać ją do ustawień tokenu.
Najczęstsze problemy z tokenem
Problem | Prawdopodobna przyczyna | Co zrobić |
Błąd autoryzacji przy każdej przesyłce | Token skopiowany niepełny lub z dodatkowymi znakami | Skopiuj token ponownie, bez spacji na początku i końcu |
Paczkomaty działają, kurier nie | Token bez numeru umowy kurierskiej | Wygeneruj nowy token z numerem umowy |
Przesyłki trafiają na inne konto | Token z innego konta lub organizacji | Sprawdź, na którym koncie wygenerowano token |
Test działa, produkcja nie | Token z sandboxu użyty na produkcji (lub odwrotnie) | Użyj tokenu ze środowiska, do którego łączy się integracja |
Mapa nie wyświetla się | Token ShipX zamiast Geowidgetu lub brak domeny | Wygeneruj token Geowidgetu i dodaj domenę |
[#tip] Dla każdego systemu korzystającego z InPost wygeneruj osobny token i opisz go w notatkach – np. „sklep”, „Allegro”, „magazyn”. Według dokumentacji na jednym koncie możesz mieć do 10 tokenów. Gdy zmieniasz system albo podejrzewasz wyciek, unieważniasz tylko jeden token, a pozostałe integracje działają dalej.
Bezpieczeństwo tokenu
Token API ShipX działa jak hasło do nadawania przesyłek na Twój koszt. Każdy, kto go zna, może tworzyć etykiety obciążające Twoje konto. Dlatego nie wysyłaj go otwartym tekstem w mailach do wielu osób, nie wklejaj w publicznych repozytoriach kodu i nie umieszczaj w kodzie wykonywanym w przeglądarce. Jeśli zlecasz konfigurację zewnętrznej firmie, po zakończeniu prac rozważ wygenerowanie nowego tokenu.
Warto też pamiętać, kto w firmie ma dostęp do konta w Managerze Paczek. Według regulaminu aplikacji adresu e-mail konta nie da się zmienić – dlatego konto firmowe najlepiej zakładać na adres, do którego dostęp nie zniknie wraz z odejściem jednego pracownika. Więcej o panelu nadawcy piszemy w przewodniku Manager Paczek InPost, a o automatycznym drukowaniu etykiet po utworzeniu przesyłki – w tekście drukowanie etykiet w BaseLinkerze.
[#przyklad] Sklep sprzedaje we własnym sklepie na WooCommerce i na Allegro, a zamówienia obsługuje w systemie do obsługi sprzedaży. W Managerze Paczek generuje trzy tokeny: jeden z numerem umowy kurierskiej dla systemu sprzedażowego, jeden dla Wysyłam z Allegro i jeden testowy w sandboxie. Do koszyka sklepu generuje osobny token Geowidgetu dla domeny sklepu. Gdy po roku zmienia agencję obsługującą sklep, unieważnia tylko token używany przez wtyczkę i generuje nowy.
[#checklista] Token InPost bez problemów: właściwe konto firmowe w Managerze Paczek; kompletne dane adresowe i do faktury; numer umowy kurierskiej przy generowaniu; skopiowany token i ID organizacji; osobne tokeny dla różnych systemów; token Geowidgetu z poprawną domeną; testowa przesyłka po konfiguracji; token przechowywany poza publicznym kodem.
Najczęściej zadawane pytania
Gdzie znaleźć token InPost?
Token API ShipX generuje się w Managerze Paczek, w ustawieniach konta – w zakładce API, w sekcji API ShipX. Po wygenerowaniu możesz go wyświetlić opcją pokazania tokenu.
Dlaczego token nie pozwala nadać przesyłki kurierskiej?
Według dokumentacji token wygenerowany bez numeru umowy kurierskiej obsługuje tylko przesyłki do Paczkomatów. Trzeba wygenerować nowy token i podać numer umowy.
Ile tokenów można mieć w Managerze Paczek?
Dokumentacja wskazuje, że na jednym koncie można mieć do 10 tokenów API ShipX. Warto używać osobnych tokenów dla różnych systemów.
Czym różni się token ShipX od tokenu Geowidgetu?
Token ShipX daje dostęp do tworzenia przesyłek i jest poufny. Token Geowidgetu służy do wyświetlania mapy punktów w koszyku, jest publiczny i przypisany do domen sklepu.
Gdzie wkleić token w Wysyłam z Allegro?
Według pomocy Allegro token ShipX z Managera Paczek wkleja się w ustawieniach Wysyłam z Allegro, w sekcji integracji z InPost. Wymagane jest konto firmowe i umowa z InPost.
Czy token z sandboxu zadziała na produkcji?
Nie. Środowisko testowe i produkcyjne mają osobne konta i osobne tokeny. Token musi pochodzić z tego samego środowiska, do którego łączy się integracja.
Co zrobić ze starym tokenem po zmianie systemu?
Podmień token we wszystkich integracjach, które z niego korzystały, i usuń nieużywane tokeny w ustawieniach API w Managerze Paczek. Jeśli nie masz pewności, czy dany token jest jeszcze gdzieś używany, najpierw sprawdź konfigurację wszystkich podłączonych narzędzi, a w razie wątpliwości skontaktuj się z obsługą InPost.
Podsumowanie
Token InPost generujesz w Managerze Paczek, w zakładce API – po uzupełnieniu danych konta i z numerem umowy kurierskiej, jeśli chcesz nadawać kurierem. Wklejasz go w Wysyłam z Allegro, w systemie do obsługi sprzedaży albo we wtyczce sklepu, a do mapy w koszyku generujesz osobny token Geowidgetu. Najwięcej problemów powodują token bez umowy, pomylone środowiska i token z niewłaściwego konta. Jeśli dopiero zaczynasz wysyłki, zajrzyj do przewodnika InPost dla firm – jak zacząć.
Wdrażamy i obsługujemy wysyłki InPost – podłączamy tokeny, konfigurujemy integracje i testujemy cały proces od zamówienia do etykiety, żeby wysyłki działały od pierwszego dnia. Sprawdź naszą usługę wdrożenia Base i automatyzacji wysyłek.
Gdzie wkleić token InPost
Miejsce wklejenia tokenu zależy od tego, z jakiego narzędzia nadajesz paczki. Zasada jest zawsze ta sama: token trafia do ustawień narzędzia, które ma tworzyć przesyłki w Twoim imieniu, a nie do miejsca, w którym klient wybiera dostawę. Jeśli korzystasz z kilku narzędzi jednocześnie – np. sklepu, Allegro i systemu magazynowego – każde z nich potrzebuje własnej konfiguracji. Poniżej najczęstsze przypadki.
Wykres – najczęstsze miejsca, w których wkleja się token InPost. [#chart:ip17b]
Wysyłam z Allegro
Jeśli chcesz nadawać przesyłki InPost w programie Wysyłam z Allegro na podstawie własnej umowy z przewoźnikiem, według pomocy Allegro potrzebujesz konta firmowego, umowy z InPost i tokenu ShipX z Managera Paczek. Token wkleja się w ustawieniach Wysyłam z Allegro, w sekcji integracji z InPost. Zasady programu opisujemy w artykule Wysyłam z Allegro – jak działa i ile kosztuje.
System do obsługi sprzedaży
W systemach takich jak Base token wkleja się w konfiguracji przewoźnika InPost – zwykle razem z ID organizacji. Po zapisaniu ustawień integracja może tworzyć przesyłki, pobierać etykiety i aktualizować statusy. Konfigurację krok po kroku opisujemy w poradniku BaseLinker InPost – Paczkomaty i nadawanie z panelu Base, a ogólne zasady podłączania przewoźników – w tekście kurierzy w BaseLinkerze.
Wtyczka w sklepie internetowym
Moduły InPost dla platform sklepowych, takich jak WooCommerce czy PrestaShop, mają w ustawieniach pola na token ShipX, ID organizacji i często osobne pole na token Geowidgetu. Po wklejeniu kluczy warto wykonać testowe zamówienie i sprawdzić, czy mapa punktów się wyświetla, a przesyłka tworzy się poprawnie. Integrację sklepów z systemem do obsługi sprzedaży opisujemy w tekstach BaseLinker WooCommerce i BaseLinker PrestaShop, a konfigurację wtyczek InPost dla poszczególnych platform omawiamy w kolejnych artykułach z tej serii.
Mapa Paczkomatów w koszyku
Token Geowidgetu generuje się w osobnej sekcji Managera Paczek, podając domeny, na których mapa ma działać. To token publiczny – jest widoczny w kodzie strony, więc nie daje dostępu do tworzenia przesyłek. Jeśli mapa nie wyświetla się po przeniesieniu sklepu na nową domenę, najczęściej trzeba dodać ją do ustawień tokenu.
Najczęstsze problemy z tokenem
Problem | Prawdopodobna przyczyna | Co zrobić |
Błąd autoryzacji przy każdej przesyłce | Token skopiowany niepełny lub z dodatkowymi znakami | Skopiuj token ponownie, bez spacji na początku i końcu |
Paczkomaty działają, kurier nie | Token bez numeru umowy kurierskiej | Wygeneruj nowy token z numerem umowy |
Przesyłki trafiają na inne konto | Token z innego konta lub organizacji | Sprawdź, na którym koncie wygenerowano token |
Test działa, produkcja nie | Token z sandboxu użyty na produkcji (lub odwrotnie) | Użyj tokenu ze środowiska, do którego łączy się integracja |
Mapa nie wyświetla się | Token ShipX zamiast Geowidgetu lub brak domeny | Wygeneruj token Geowidgetu i dodaj domenę |
[#tip] Dla każdego systemu korzystającego z InPost wygeneruj osobny token i opisz go w notatkach – np. „sklep”, „Allegro”, „magazyn”. Według dokumentacji na jednym koncie możesz mieć do 10 tokenów. Gdy zmieniasz system albo podejrzewasz wyciek, unieważniasz tylko jeden token, a pozostałe integracje działają dalej.
Bezpieczeństwo tokenu
Token API ShipX działa jak hasło do nadawania przesyłek na Twój koszt. Każdy, kto go zna, może tworzyć etykiety obciążające Twoje konto. Dlatego nie wysyłaj go otwartym tekstem w mailach do wielu osób, nie wklejaj w publicznych repozytoriach kodu i nie umieszczaj w kodzie wykonywanym w przeglądarce. Jeśli zlecasz konfigurację zewnętrznej firmie, po zakończeniu prac rozważ wygenerowanie nowego tokenu.
Warto też pamiętać, kto w firmie ma dostęp do konta w Managerze Paczek. Według regulaminu aplikacji adresu e-mail konta nie da się zmienić – dlatego konto firmowe najlepiej zakładać na adres, do którego dostęp nie zniknie wraz z odejściem jednego pracownika. Więcej o panelu nadawcy piszemy w przewodniku Manager Paczek InPost, a o automatycznym drukowaniu etykiet po utworzeniu przesyłki – w tekście drukowanie etykiet w BaseLinkerze.
[#przyklad] Sklep sprzedaje we własnym sklepie na WooCommerce i na Allegro, a zamówienia obsługuje w systemie do obsługi sprzedaży. W Managerze Paczek generuje trzy tokeny: jeden z numerem umowy kurierskiej dla systemu sprzedażowego, jeden dla Wysyłam z Allegro i jeden testowy w sandboxie. Do koszyka sklepu generuje osobny token Geowidgetu dla domeny sklepu. Gdy po roku zmienia agencję obsługującą sklep, unieważnia tylko token używany przez wtyczkę i generuje nowy.
[#checklista] Token InPost bez problemów: właściwe konto firmowe w Managerze Paczek; kompletne dane adresowe i do faktury; numer umowy kurierskiej przy generowaniu; skopiowany token i ID organizacji; osobne tokeny dla różnych systemów; token Geowidgetu z poprawną domeną; testowa przesyłka po konfiguracji; token przechowywany poza publicznym kodem.
Najczęściej zadawane pytania
Gdzie znaleźć token InPost?
Token API ShipX generuje się w Managerze Paczek, w ustawieniach konta – w zakładce API, w sekcji API ShipX. Po wygenerowaniu możesz go wyświetlić opcją pokazania tokenu.
Dlaczego token nie pozwala nadać przesyłki kurierskiej?
Według dokumentacji token wygenerowany bez numeru umowy kurierskiej obsługuje tylko przesyłki do Paczkomatów. Trzeba wygenerować nowy token i podać numer umowy.
Ile tokenów można mieć w Managerze Paczek?
Dokumentacja wskazuje, że na jednym koncie można mieć do 10 tokenów API ShipX. Warto używać osobnych tokenów dla różnych systemów.
Czym różni się token ShipX od tokenu Geowidgetu?
Token ShipX daje dostęp do tworzenia przesyłek i jest poufny. Token Geowidgetu służy do wyświetlania mapy punktów w koszyku, jest publiczny i przypisany do domen sklepu.
Gdzie wkleić token w Wysyłam z Allegro?
Według pomocy Allegro token ShipX z Managera Paczek wkleja się w ustawieniach Wysyłam z Allegro, w sekcji integracji z InPost. Wymagane jest konto firmowe i umowa z InPost.
Czy token z sandboxu zadziała na produkcji?
Nie. Środowisko testowe i produkcyjne mają osobne konta i osobne tokeny. Token musi pochodzić z tego samego środowiska, do którego łączy się integracja.
Co zrobić ze starym tokenem po zmianie systemu?
Podmień token we wszystkich integracjach, które z niego korzystały, i usuń nieużywane tokeny w ustawieniach API w Managerze Paczek. Jeśli nie masz pewności, czy dany token jest jeszcze gdzieś używany, najpierw sprawdź konfigurację wszystkich podłączonych narzędzi, a w razie wątpliwości skontaktuj się z obsługą InPost.
Podsumowanie
Token InPost generujesz w Managerze Paczek, w zakładce API – po uzupełnieniu danych konta i z numerem umowy kurierskiej, jeśli chcesz nadawać kurierem. Wklejasz go w Wysyłam z Allegro, w systemie do obsługi sprzedaży albo we wtyczce sklepu, a do mapy w koszyku generujesz osobny token Geowidgetu. Najwięcej problemów powodują token bez umowy, pomylone środowiska i token z niewłaściwego konta. Jeśli dopiero zaczynasz wysyłki, zajrzyj do przewodnika InPost dla firm – jak zacząć.
Wdrażamy i obsługujemy wysyłki InPost – podłączamy tokeny, konfigurujemy integracje i testujemy cały proces od zamówienia do etykiety, żeby wysyłki działały od pierwszego dnia. Sprawdź naszą usługę wdrożenia Base i automatyzacji wysyłek.
Mateusz Piotrowicz
Technical & Logistics Expert
Optymalizuje logistykę, magazyn i wysyłki sprzedawców. Skupia się na kosztach i terminowości dostaw.
Optymalizuje logistykę, magazyn i wysyłki sprzedawców. Skupia się na kosztach i terminowości dostaw.
Wdrożenie Base – automatyzacja wysyłek
Mateusz i nasz zespół pomogą Ci wdrożyć to na Twoim koncie – bez zobowiązań.
- Analiza Twojego konta i obecnych działań
- Konkretny plan poprawek do wdrożenia
- Bezpłatna konsultacja – bez zobowiązań
Przeczytaj także
Więcej porad z naszej bazy wiedzy – przesuń, aby zobaczyć kolejne artykuły.
Masz pytania? Chętnie porozmawiamy!
Masz pytania? Chętnie porozmawiamy!
Masz pytania? Chętnie porozmawiamy!
Bartłomiej Stokłosa
CEO & Founder
"Jeżeli czegoś nie da się zrobić, potrzebny jest ktoś, kto o tym nie wie – przyjdzie i to zrobi."
Bartłomiej Stokłosa
CEO & Founder
"Jeżeli czegoś nie da się zrobić, potrzebny jest ktoś, kto o tym nie wie – przyjdzie i to zrobi."