Prezentowanie punktów odbioru

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:

Opis

Opcja

functions

payment_available

location_247

Opis

Opcja

functions

payment_available

location_247

Prezentowanie punktów odbioru dla zamówień opłaconych z góry

config='parcelCollect'

parcel_collect

Prezentowanie punktów odbioru dla zamówień pobraniowych

config='parcelCollectPayment'

parcel_collect

Prezentowanie punktów odbioru dla zamówień Paczka w Weekend

config='parcelCollect247'

parcel_collect

Prezentowanie punktów nadań

config='parcelSend'

parcel_send

 

Szczegółowa dokumentacja znajduje się na stronie https://dokumentacja-inpost.atlassian.net/wiki/spaces/PL/pages/50069505

 

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:

1 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:

 

Paczkomaty InPost

Pola wyświetlane

Pola w API

Paczkomat

Jeśli "partner_id":0 ustaw "Paczkomat"

Nazwa Paczkomatu

"name": "WAW94A"

Dane adresowe

"address": {
         "line1": "Czerska 8/10",
    "line2": "00-732 Warszawa"

Dostępność punktu

"opening_hours": "24/7"

Najbliższy paczkomat

"recommended_low_interest_box_machines_list": [  
               "WAW54N",                 "WAW20H",                 "WAW251M",                 "WAW561M"  
           ],

Pin

Dedykowane piny znajdują się w dolnej części artykułu.

 

 

 


Szczegóły Paczkomatu

Pola wyświetlane

Pola w API

Nazwa Paczkomatu

"partner_id": 0 = "Paczkomat" +  "name": "WAW94A"

Dane adresowe

"address": {
       "line1": "Czerska 8/10",
    "line2": "00-732 Warszawa"

Zdjęcie

"image_url": "https://static.easypack24.net/points/pl/images/WAW94A.jpg"

Położenie

"location_description": "Przy biurowcu Agory"

Dostępny

"opening_hours": "24/7"

Formy płatności

"payment_point_descr": "Płatność w Paczkomacie kartą płatniczą lub BLIKIEM oraz internetowo aplikacją InPost Mobile i PayByLink"

Najbliższy paczkomat

"recommended_low_interest_box_machines_list": [  
         "WAW54N",                 "WAW20H",                 "WAW251M",                 "WAW561M"  
           ],

Strefa ułatwionego dostępu

"easy_access_zone": true
Więcej informacji znajdziesz na stronie
https://inpost.pl/aktualnosci-paczkomatyr-inpost-strefa-ulatwionego-dostepu-dla-osob-niewysokich

 

 


PaczkoPunkt

Pola wyświetlane

Pola w API

PaczkoPunkt

Jeśli "partner_id": 33 ustaw "PaczkoPunkt"

Nazwa PaczkoPunktu

"name": "POP-WAW206"

Dane adresowe

 "address": {
         "line1": "Kierbedzia 8 LOK. U301",
         "line2": "00-728 Warszawa"

Godziny otwarcia

"opening_hours": "PN-PT 10-18 SB 10-14"

Szczegóły dostępności

Jeśli "partner_id": 33 dodaj "Sprawdź dostępność w niedziele i święta"

Pin

Dedykowane piny znajdują się w dolnej części artykułu.


 

Szczegóły PaczkoPunktu

Szczegóły PaczkoPunktu

Pola wyświetlane

Pola w API

PaczkoPunkt

Jeśli "partner_id": 33 ustaw "PaczkoPunkt"

Dane adresowe

 "address": {
                "line1": "Kierbedzia 8 LOK. U301",
                "line2": "00-728 Warszawa"

Nazwa PaczkoPunktu

"name": "POP-WAW206"

Zdjęcie

"image_url": "https://static.easypack24.net/points/pl/images/POP-WAW206.jpg"

Położenie

"location_description": "EKOPARTY"

Dostępność

"opening_hours": "PN-PT 10-18 SB 10-14"

Formy płatności

"payment_point_descr": "Płatność kartą płatniczą w PaczkoPunkcie, a także internetowo aplikacją InPost Mobile oraz PayByLink"

Szczegóły dostępności

Jeśli "partner_id": 33 dodaj "Sprawdź dostępność w niedziele i święta"

Strefa ułatwionego dostępu

"easy_access_zone": true
Więcej informacji znajdziesz na stronie https://inpost.pl/aktualnosci-paczkomatyr-inpost-strefa-ulatwionego-dostepu-dla-osob-niewysokich

 





 

 

 

 

Piny do pobrania

Nazwa, rozszerzenie

Piny do pobrania

Nazwa, rozszerzenie

Paczkomat Geo.png

Paczkomat max.png

Paczkomat min.png

PaczkoPunkt Geo.png

PaczkoPunkt max.png

PaczkoPunkt min.png

 

Paczkomat max.pdf

Paczkomat min.pdf

PaczkoPunkt max.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:

    1 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ć parametrem limit:

    1 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)

    1 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:

    1 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ą:

    1 curl -X GET https://api-shipx-pl.easypack24.net/v1/points?type=parcel_locker -H 'Content-Type: application/json'
  • Pobranie tylko fizycznych paczkomatów:

    1 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ą:

    1 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

    1 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

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