Paczkomaty InPost

Zakładka Paczkomaty InPost pozwala na podstawową integrację z Paczkomatami w zakresie opłacania paczek i generowania etykiet,

Panel integracji z Paczkomatami InPost

Informacja

Integracja działa zarówno przy płatności online, jak i płatności przy odbiorze. Minimalne dane jakie musimy gromadzić od klientów, aby móc wygenerować etykietę, to adres e-mail oraz polski numer telefonu. Zamówienia realizowane są wyłącznie na terytorium Polski.

Dostępne opcje

Oto lista dostępnych opcji wraz z krótkim objaśnieniem.

Integracja InPost

Określa, czy integracja z InPost jest aktywna. Jeśli jest aktywna, to na liście zamówień pokaże się dodatkowy przycisk, który pozwoli na wygenerowanie etykiety dla danego zamówienia. Aby było to możliwe, musisz mieć aktywne konto BASIC lub PRO, a rodzajem dostawy wybranym przez klienta muszą być Paczkomaty InPost.

Tryb testowy

Określa, czy integracja działa w trybie testowym, czy nie. W trybie testowym możesz przetestować działanie całego systemu, ale wymaga to posiadania specjalnego konta, które można założyć tutaj: https://sandbox-manager.paczkomaty.pl/

Informacja

Jeśli używasz konta testowego, to pamiętaj że dane dostępowe z „normalnego konta” nie będą działać (i na odwrót) - miej to na uwadze.

ID Organizacji

Jest to numer przyznawany przez InPost w Managerze Paczek. Możesz go znaleźć po zalogowaniu w zakładce: „Moje konto > API > Ustawienia organizacji”

ID Organizacji w panelu Managera Paczek InPost
TOKEN API

Jest to ciąg znaków generowany przez InPost w Managerze Paczek. Możesz go znaleźć po zalogowaniu w zakładce: „Moje konto > API > API ShipX”. Jeśli jeszcze nie masz wygenerowanego TOKENU API, to możesz zajrzeć do instrukcji, która szczegółowo opisuje cały proces: https://inpost.pl/sites/default/files/2022-03/instrukcja-konfiguracji-api-shipx.pdf

TOKEN API w panelu Managera Paczek InPost
Domyślny rozmiar paczki

Określa jaki będzie domyślny rozmiar paczki, którą utworzysz.

Domyślny sposób nadania paczki

Określa w jaki sposób zostanie nadana paczka.

  • Nadanie w dowolnym punkcie - Nadajesz przesyłkę samodzielnie w dowolnym Paczkomacie lub PaczkoPunkcie.

  • Odbiór przez Kuriera - Opcja dodatkowo płatna. Kurier przyjeżdża i odbiera od Ciebie paczki. Zlecenie odbioru paczek musisz utworzyć bezpośrednio w Managerze Paczek InPost.

Domyślny typ etykiety

Określa jaki rodzaj etykiety będzie wygenerowany dla paczki.

Domyślny rozmiar etykiety

Określa jaki domyślny rodzaj etykiety będzie wygenerowany dla paczki.

Token Geowidgetu

Własny token mapy Paczkomatów InPost (Geowidget v5), który klient widzi w sklepie podczas wyboru punktu odbioru. Sposób jego wygenerowania opisujemy w sekcji Mapa Paczkomatów (Geowidget).

Mapa Paczkomatów (Geowidget)

Podczas składania zamówienia klient wybiera Paczkomat lub PaczkoPunkt na mapie InPost wyświetlanej w Twoim sklepie. Po wpisaniu własnego tokenu Geowidgetu sklep ładuje nową mapę InPost (Geowidget v5). Bez tokenu sklep nadal działa i korzysta ze starej mapy, dlatego tę część konfiguracji możesz wykonać w dowolnym momencie.

Informacja

Token Geowidgetu jest niezależny od opcji Integracja InPost, Tryb testowy oraz danych ID Organizacji i TOKEN API - możesz go zapisać także wtedy, gdy nie generujesz etykiet w Foto.Guru. Nowa mapa ładuje się wyłącznie dla licencji BASIC lub PRO.

Generowanie tokenu w Managerze Paczek

Zaloguj się do Managera Paczek InPost (https://manager.paczkomaty.pl/) i przejdź do zakładki „Moje konto > API”. Na dole strony znajdziesz sekcję „Geowidget” - kliknij w niej przycisk „Generuj”.

Sekcja Geowidget w panelu Managera Paczek InPost

W oknie, które się pojawi, w polu „Dozwolone domeny” wpisz domeny, pod którymi działa Twój sklep (bez https://). Lista domen, które musisz wpisać, jest wyświetlona w panelu Foto.Guru pod polem Token Geowidgetu - zazwyczaj jest to app.foto.guru, a jeśli korzystasz z własnej domeny, to również ona. Następnie kliknij „Generuj”.

Ostrzeżenie

Mapa otworzy się wyłącznie pod domenami wpisanymi do tokenu. Jeśli pominiesz domenę sklepu, klient nie będzie mógł wybrać Paczkomatu.

Okno generowania tokenu Geowidgetu z polem Dozwolone domeny

Wygenerowany token pojawi się na liście tokenów do Geowidgetu. Kliknij „Kopiuj”, a następnie wklej go w panelu Foto.Guru w pole Token Geowidgetu i zapisz zmiany.

Kopiowanie wygenerowanego tokenu Geowidgetu

Sprawdzanie zapisanego tokenu

Przy zapisie token jest sprawdzany. Jeśli nie pochodzi z Managera Paczek InPost, wygasł, albo nie zawiera domeny sklepu, zobaczysz komunikat błędu, a token nie zostanie zapisany.

Po zapisaniu pod polem Token Geowidgetu wyświetli się stan tokenu:

  • produkcyjny lub testowy (sandbox) - środowisko, z którego pochodzi token. Token z konta testowego (https://sandbox-manager.paczkomaty.pl/) ładuje w sklepie testową mapę, więc do normalnej sprzedaży użyj tokenu z konta produkcyjnego.

  • lista domen przypisanych do tokenu,

  • ostrzeżenie wygasł wraz z datą, jeśli token stracił ważność. Sklep wraca wtedy do starej mapy - wygeneruj nowy token w Managerze Paczek i zapisz go ponownie,

  • ostrzeżenie o brakującej domenie sklepu, np. gdy po zapisaniu tokenu podłączyłeś własną domenę. Wygeneruj wtedy nowy token ze wszystkimi domenami.

Generowanie etykiet dla zamówienia

Jeśli integracja z Paczkomatami InPost jest włączona, to przy zamówieniach złożonych z opcją dostawy za pośrednictwem Paczkomatu zostanie dodany nowy przycisk, który umożliwi opłacenie i wygenerowanie etykiety.

Dodatkowe przyciski w panelu zamówień

Pomarańczowy kolor przycisku oznacza, że etykieta jeszcze nie została opłacona i wygenerowana, natomiast kolor zielony, że została opłacona. Jeśli chcesz, możesz w każdej chwili pobrać już opłaconą etykietę, np. wybierając inny typ i format.

Opłacanie i generowanie etykiety

Po kliknięciu na pomarańczowy przycisk (z boxem), załaduje się okno z zaznaczonymi domyślnymi opcjami odnośnie ustawień paczki i etykiety.

Jeśli rozsądnie ustawiliśmy domyślne opcje, zazwyczaj wystarczy po prostu kliknąć „Opłać i wygeneruj etykietę”, aby proces się rozpoczął. Jeśli nie będzie błędów, to etykieta powinna zostać pobrana lub wyświetlona automatycznie.

W przypadku błędów, zostaną one wyświetlone w oknie.

Opłacanie i generowanie etykiety

Ponowne pobieranie etykiety

Jeśli z jakichś powodów chcesz zmienić format etykiety, lub pobrać ją ponownie, to po kliknięciu na już opłaconą etykietę (zielony przycisk z boxem), możesz ją ponownie pobrać, wybierając pożądany format, lub pozostając przy domyślnych ustawieniach.

Pobieranie etykiety