Page Comparison

Aby poprawnie umożliwić Klientowi wybór Paczkomatu oraz zaciągnąć dane, które później będą służyć do utworzenia przesyłki, można skorzystać z dwóch rozwiązań:

• Geowidget

• Zasób Points w API ShipX

Zalecanym rozwiązaniem jest korzystanie z Geowidgetu. W przypadku gdy Klient nie ma możliwość skorzystania z tej funkcjonalności, dopuszcza się użycie listy punktów, autorskiego Geowidgetu wykonanych na podstawie zasobu Points w API ShipX.

Zachęcamy Cię do zapoznania się z dedykowanym materiałem wspierającym, dotyczącym poprawnej implementacji usług InPost. Gromadzi on w jednym miejscu informacje w zakresie aktualnego brandingu InPost, wytyczne odnośnie implementacji przyjaznego wyszukiwania Paczkomatów i PaczkoPunktów oraz dobre praktyki, warte stosowania przy budowaniu pozytywnego user experience wśród Kupujących online. Poradnikiem znajduje się na stronie Poradnik skutecznej implementacji dostaw InPost w koszyku e-commerce.

Geowidget

Geowidget v5 to lokalizator i selektor punktów zaprojektowany przez InPost.

Jego główne zadania to:

•  Wyświetlanie mapy z punktami o różnych typach (np. paczkomaty, paczkopunkty)

•  Dostarczenie informacji o tych punktach i umożliwienie integracji z zewnętrznymi systemami Klientów

Jest to oprogramowanie typu widget. Oznacza to, że cały kod i przetwarzanie odbywa się na serwerach InPost. Klienci zewnętrzni dołączają tylko link do tego kodu i określają konfigurację, która będzie używana w ich systemach.

Geowidget posiada dedykowane konfiguracje dla opcji dostaw w koszyku:

Przykłady integracji

Środowisko produkcyjne: https://geowidget.inpost.pl/examples/index.html

Środowisko testowe: https://sandbox-easy-geowidget-sdk.easypack24.net/examples/index.html

Przykłady geowidgetu

Środowisko produkcyjne: https://geowidget.inpost.pl/
Środowisko produkcyjne: https://sandbox-easy-geowidget-sdk.easypack24.net/

Zasób Points

Zasób Points jest dostępny w API ShipX.  Zasób ten skierowany jest do Klientów,  którzy chcą na podstawie API stworzyć swoją wersję Geowidgetu, zaproponować listy z  punktami odbioru, gdy nie mają technicznej możliwości skorzystania z Geowidgetu InPost.

Ta opcja umożliwia:

• Pobieranie informacji na temat lokalizacji, w których dostępne są usługi firmy InPost. Punktami mogą być:  maszyny samoobsługowe (Paczkomat) lub paczkopunkty;

• Pobieranie paczkomatów na podstawie współrzędnych - można również podać maksymalną odległość, w jakiej znajdują się punkty od punktu relatywnego oraz nanieść te współrzędne na mapę Google.

W praktyce kiedy użytkownik wpisze np. nazwę miejscowości, lub kod pocztowy, Points wyszukuje Paczkomaty przypisane do niego, zwraca ich współrzędne i następnie na ich podstawie można umieścić je na mapie np. Google.

Dobre Praktyki

Poniżej przedstawiamy listę parametrów w których zawarte są ważne informacje dla klienta. Informacje pochodzące z tych parametrów należy umieścić w informacjach podstawowych, szczegółach (informacjach dodatkowych) paczkomatu.

Poniższe informacje zostały pobrane za pomocą zapytania:

curl -X GET https://api.inpost.pl/v1/points?name=WAW94A -H 'Content-Type: application/json'

Poniżej przedstawiamy listę parametrów z których należy pobrać informację i zamieścić w informacjach podstawowych:

Piny do pobrania	Nazwa, rozszerzenie
	Paczkomat Geo.png
	Paczkomat max.png
	Paczkomat min.png
	PaczkoPunkt Geo.png
	PaczkoPunkt max.png
	PaczkoPunkt min.png
View file name Paczkomat max.pdf	Paczkomat max.pdf
View file name Paczkomat min.pdf	Paczkomat min.pdf
View file name PaczkoPunkt max.pdf	PaczkoPunkt max.pdf
View file name PaczkoPunkt min.pdf	PaczkoPunkt min.pdf
	Paczkomat max.svg
	Paczkomat min.svg
	PaczkoPunkt max.svg
	PaczkoPunkt min.svg

Przykładowe zapytania

• W zasobie Points istnieje możliwość pobrania najbliższych Paczkomatów od punktu relatywnego na podstawie współrzędnych:
  

  Code Block
  language json
  curl -X GET https://api-shipx-pl.easypack24.net/v1/points?relative_point=52.21472%2C20.95547 -H 'Content-Type: application/json'

• Liczbę punktów można ograniczyć parametremlimit:
  

  Code Block
  language json
  curl -X GET https://api-shipx-pl.easypack24.net/v1/points?relative_point=52.21472%2C20.95547&limit=3 -H 'Content-Type: application/json'

• Liczbę punktów można ograniczyć parametrem max_distance(podajemy w metrach)
  

  Code Block
  language json
  curl -X GET https://api-shipx-pl.easypack24.net/v1/points?relative_point=52.21472%2C20.95547&max_distance=800 -H 'Content-Type: application/json'

• Pobieranie najbliższych punktów dla kodu pocztowego:
  

  Code Block
  language json
  curl -X GET https://api-shipx-pl.easypack24.net/v1/points?relative_post_code=37-200&type=parcel_locker -H 'Content-Type: application/json'

• Pobranie wszystkich fizycznych paczkomatów i paczkopunktów do których można nadać przesyłkę paczkomatową:
  

  Code Block
  language json
  curl -X GET https://api-shipx-pl.easypack24.net/v1/points?type=parcel_locker -H 'Content-Type: application/json'

• Pobranie tylko fizycznych paczkomatów:
  

  Code Block
  language json
  curl -X GET https://api-shipx-pl.easypack24.net/v1/points?type=parcel_locker_only -H 'Content-Type: application/json'

• Pobranie paczkopunktów do których można nadać przesyłkę paczkomatową:
  

  Code Block
  language json
  curl -X GET https://api-shipx-pl.easypack24.net/v1/points?type=parcel_locker_superpop -H 'Content-Type: application/json'

• Pobranie punktów które obsługują przesyłki COD
  

  Code Block
  language json
  curl -X GET https://api-shipx-pl.easypack24.net/v1/points?payment_available=true -H 'Content-Type: application/json'

• Pobranie punktów które są dostępne 24/7, dedykowane dla usługi Paczka w Weekend
  

  Code Block
  language json
  curl -X GET https://api-shipx-pl.easypack24.net/v1/points?location_247=true -H 'Content-Type: application/json'