/
[PL] Shopify

[PL] Shopify

 

Poniżej znajduje się dokumentacja do autorskiego rozwiązania InPost Shopify. Zawiera informację o instalacji oraz konfiguracji pluginu.

Wtyczka dostępna jest na App Store Shopify

 

 

Shopify od 1 stycznia 2023 zmieniło zasady przyznawania dostępu dla Carrier Service API co pozwala naszej aplikacji działać dopiero od planu GROW

image-20251211-092633.png

 

Zmiana źródła pobierania danych o punkcie odbioru dla INTEGRACJI → Integracja zewnętrzna – poprawne źródło danych o punkcie odbioru

W przypadku korzystania z aplikacji warto mieć skonfigurowane backup shipping rates (stawki za dostawę) które będą pobierane w przypadku niedostępności stawek generowanych przez aplikację InPost: Setting up backup shipping rates

 

Wtyczka

17.05.2023

Marketplace Shopify

InPost – oficjalna integracja Shopify i Shopify Plus | Shopify App Store

 

! Po instalacji wtyczki należy dodać adres webhook w panelu Manager Paczek:

Manager Paczek → Moje Konto → API → Ustawienia Organizacji → Adres Webhook i podajemy:

https://shop-plugin-api.inpost.pl/api/inpost/webhook

 

! Do poprawnego działania aplikacji InPost wymagana jest aktywacja carrier-calculated shipping

Aktywować CCS można poprzez kontakt z supportem Shopify

Po aktywowaniu należy przeinstalować aplikację InPost

 

Changelog - rozwiń

Changelog:

21.11.2025 → Usunięcie wymagania punktu odbioru dla usługi Paczkomat

→ Usunięcie podziału na Tryby w zakładce Usługi

→ Dodanie checkbox, który wyłącza dublowanie kosztów dostawy dla produktów z różnych lokalizacji

→ Dodanie walidacji w momencie zmiany punktu odbioru (który wybrał klient) na inny (komunikat z potwierdzeniem o zmianie)

→ Filtrowanie przesyłek w zakładce Przesyłki po numerze trackingowym

03.11.2025 → Dodano obsługę punktów InPost na mapie

17.07.2025 → Ułatwienie masowego nadawania przesyłek, poprawa komunikatów dot. błędów przy tworzeniu przesyłki

→ Zakres dat filtrowania - rozbudowa i naprawa filtrów

→ Kupony rabatowe vs darmowa dostawa - dodanie przełącznika w panelu

→ Produkty wirtualne a darmowa dostawa - dodanie przełącznika w panelu

→ Obsługa błędów - poprawa czytelności komunikatów

26.03.2025 → Dodane zostało masowego tworzenie przesyłek

→ Zaktualizowane biblioteki Shopify

→ Dodana waluta EUR

15.11.2024 → Poprawione zostało masowe generowanie etykiet

→ Dodany został format A4 dla usługi InPost Paczkomat 24/7 (generowanie kilku etykiet na jednej stronie)

→ Dodane anulowanie etykiet (po 30 dniach etykieta nie nadana zostaje usunięta z zakładki “Przesyłki”)

→ Dodane zostało stronnicowe w zakładce “Przesyłki”

27.08.2024 → Dodanie usługi COD (pobranie) dla metody dostawy Kurier C2C

→ Dodana edycja danych kupującego (jeśli edytujemy dane w zamówieniu w Shopify - zmienią się też w panelu InPost podczas tworzenia paczki)

→ Udostępnienie możliwości edycji kwoty COD (pobrania) podczas tworzenia przesyłki

31.07.2024 → Dodanie zakładki “wyłączone produkty” , która pozwala wyłączyć metody dostawy InPost w konkretnych produktach

→ Dodanie możliwości wyświetlania punktów Paczkomat/Paczkomat i PaczkoPunk lub sam Paczkopunkt w metodach dostawy InPost Paczkomat

→ Poprawa masowego pobierania etykiet

→ Poprawa filtrowania przesyłek w zakładce “Przesyłki” - zapamiętywanie filtrów

04.06.2024 → Dodanie automatycznego uzupełniania numeru tracking w zamówieniu gdy zostanie zmieniony status zamówienia na “zrealizowany”

18.04.2024 → Dodanie wyświetlania błędów

→ Blokowanie nadmiernej ilości requestów wysyłanych przez sklep

04.01.2024 → Aktualizacja API Shopify w aplikacji

→ Wyłączenie trybu zaawansowanego (geowidget)

→ Zmiana sposobu wyświetlania nazwy usług w koszyku

→ FIX: Etykieta w formacie A6

08.12.2023 → Umieszczenie numeru zamówienia Shopify na etykiecie

31.10.2023 → Dodanie informacji o wymaganym Checkout liquid

→ Zmiana nazwy POP/Paczkomat

25.10.2023 → FIX: Zmieniający się Paczkomat® odbiorczy (po zmianie nadawczego)

05.10.2023 → FIX: Wyszukiwanie Paczkomat po adresie (nie kodzie pocztowym)

 

 

Na tej stronie:

 

Autoryzacja

Środowisko produkcyjne (Produkcja)

Przed przystąpieniem do instalacji należy posiadać dane dostępowe do połączenia z API:

  • Access Token

  • ID organizacji

Pobierz poradnik wyjaśniający jak szybko we własnym zakresie utworzyć dostęp do API ShipX:

https://inpost.pl/sites/default/files/2022-03/instrukcja-konfiguracji-api-shipx.pdf

Środowisko testowe (Sandbox)

Generowanie dostępu

InPost - Manager paczek > zakładka Moje konto > API. 

Aby wygenerować Token i ID organizacji należy uzupełnić wszystkie dane, łącznie z danymi do faktury w zakładce Moje konto > Dane. Do utworzenia przesyłki Paczkomat® niezbędne są środki na koncie, konto doładujesz wirtualnie w zakładce Płatności

Ważne!

  1. Tryb Sandbox dostępny jest tylko wówczas, gdy żadne zamówienie produkcyjne nie zostało jeszcze przeprocesowane przez aplikację

  2. Z uwagi na ograniczenia wyświetlania punktów POP w mapach testowych w aplikacji zostały użyte mapy produkcyjne, aby umożliwić podgląd wyboru domyślnych Paczkomatów lub Paczkopunktów

Aby utworzyć przesyłkę w trybie testowym z nadaniem Paczkomat lub POP, należy podać ręcznie dane

  • Paczkomat: BIA01N, BBI01N

  • Paczkopunkt: POP-JAR4

Testy:

Na środowisku sandbox nie ma możliwości przetestowania wysyłki przesyłek - te opcje dostępne są tylko na produkcji. Wynika to z możliwości API Sandbox

 

Instalacja wtyczki

 

Zainstaluj aplikację ze sklepu Shopify App Store

Kroki:

  • Zaloguj się do Shopify App Store

  • Znajdź aplikację Inpost, a następnie kliknij ją

  • Na stronie oferty aplikacji kliknij Dodaj aplikację

  • Aby autoryzować korzystanie z aplikacji, kliknij opcję Zainstaluj aplikację w panelu administracyjnym Shopify

Po zainstalowaniu aplikacji możesz ją przeglądać i wykorzystywać na stronie Aplikacje w panelu administracyjnym Shopify.

Więcej informacji:Instalowanie aplikacji

 

Po instalacji w panelu sklepu pojawi się aplikacja po lewej stronie:

 

image-20251120-093105.png