Instrukcja integracji Shopify z Apaczka.pl

Prowadząc sklep na Shopify możesz go łatwo zintegrować z platformą technologiczną Apaczka.pl. Połącz swój sklep z Apaczka.pl, aby zacząć nadawać przesyłki z poziomu swojego sklepu. Poniższa instrukcja przeprowadzi Cię przez integrację w kilku prostych krokach.

WAŻNE!
Do korzystania z z listy punktów doręczenia oraz tworzenia metod nadawczych konieczne jest posiadanie planu:  

• Shopify Grow + wykupiony CCS  
• Shopify Advanced 

Shopify Basic oraz Grow bez CCS nie oferuje opcji udostępniania powyższych funkcjonalności w koszyku sklepu. 

Konfiguracja w Apaczka.pl

Nowy Panel Klienta

Dla kont zarejestrowanych po 17.10.2025

1. Zaloguj się na swoje konto w Apaczka.pl
2. W górnym menu wybierz Integracje i importy, a następnie Integracje API
   i kliknij w przycisk Dodaj integrację w prawym, górnym rogu.
3. Podaj nazwę własną integracji, wybierz platformę, z którą chcesz się zintegrować i zaakceptuj regulamin API. (W przypadku braku integracji na liście wybierz “Inne” lub “Integracja własna”).
4. Wygenerowane klucze posłużą do późniejszej konfiguracji.

Stary Panel Klienta

Dla kont zarejestrowanych po 17.10.2025

1. Zaloguj się do swojego konta na Apaczka.pl
2. Przejdź do zakładki Web API w Panelu Klienta po lewej stronie.
3. Kliknij w przycisk Dodaj integrację.
4. Wprowadź nazwę źródła i kliknij w Zapisz.
   Wygenerowane klucze posłużą do późniejszej konfiguracji.

Konfiguracja w Shopify

Instalacja wtyczki

1. Zainstaluj wtyczkę przechodząc na app store Shopify, korzystając z poniższego przycisku.

Konfiguracja wtyczki

1. Po instalacji zostaniesz automatycznie przeniesiony do okna konfiguracji, gdyby jednak tak się nie stało należy wybrać z lewego menu z sekcji “Aplikacje” wtyczkę “Alsendo Connect” (A), a następnie “Przejdź do konfiguracji” (B).  

2. Wpisz wygenerowane wcześniej klucze API (C), wybierz język aplikacji oraz uzupełnij formularz o domyślne dane.  
3. Zwróć uwagę, że formularz został podzielony na kilka sekcji:
   • Domyślny nadawca (D):
     • Wprowadź wymagane dane, a następnie “Zapisz jako nowy szablon” 
     • Wprowadź nazwę szablonu, jeżeli to główny szablon zaznacz “ustaw jako domyślny szablon” 
     • Celem dodania nowego szablonu ponownie wprowadź dane i wybierz “Zapisz jako nowy szablon”
   • Domyślna paczka (E):
     • Wprowadź wymagane dane a następnie “Zapisz jako nowy szablon” 
     • Wprowadź nazwę szablonu, jeżeli to główny szablon zaznacz “ustaw jako domyślny szablon” 
     • Celem dodania nowego szablonu ponownie wprowadź dane i wybierz “Zapisz jako nowy szablon” 
   •  Domyślne okno czasowe odbioru (F):
     • Możesz włączyć opcję “Odbiór tego samego dnia” aby paczki domyślnie tworzone był na obecny dzień roboczy. W innym wypadku paczka tworzona będzie na dzień następny. 
     • Wskaż domyślny godziny odbioru paczki – weź pod uwagę minimalne dwugodzinne okno czasowe – cześć przewoźników może wymagać większego zakresu. 
     • Zapisz ustawienia czasu odbioru. 

Konfiguracja metod dostawy

Pakiet Basic oraz Grow bez CCS

1. Aby ustawić metody wysyłki należy z menu bocznego wybrać “Alsendo Connect”, a następnie “Dostawa”. (A) 
2. Skonfiguruj domyślne punkty nadawcze (B). 
3. Sekcja metod wysyłki jest wyłączona ze względu na brak odpowiedniego planu. 
4. Metody wysyłki możesz dodać w ustawieniach Shopify -> wysyłka i dostawa -> edytując profile dostaw (będą to metody nie powiązane z Apaczką) – konieczna wycena i wybór przewoźnika podczas nadania zlecenia.  

Pakiet Grow + CCS oraz Advance

1. Aby ustawić metody wysyłki należy z menu bocznego wybrać “Alsendo Connect”, a następnie “Dostawa”(A).
   •  Metody wysyłki -> Dodaj przewoźnika (B). 
   • Wprowadź nazwę własną – wyświetlana w checkout sklepu. 
   • Wybierz usługę kurierską, która zostanie przypisana do utworzonej metody. 
   • Wprowadź cenę za usługę dostawy. 
   • Punkty odbioru – zaznacz, jeżeli jest to metoda z dostawą do punktu. Klient dostanie listę punktów doręczenia w okolicy (standardowo zaznacza się automatycznie, jeśli usługa jest “do punktu”). 
   • Domyślny kod punktu nadania – uzupełnij, jeśli nadasz paczkę samodzielnie w punkcie. 
   • Wprowadź przewoźnika dedykowanym przyciskiem po prawej stronie. 
   • Zapisz zmiany przyciskiem “Zapisz” (C). 

2. Sekcja “Domyślne punkty nadawcze” przeznaczona jest dla planu Basic oraz Grow bez CCS. Proszę ją pominąć.  
3. Przejdź do ustawień sklepu -> Wybierz “Wysyłka i dostawa” -> W edycji profilów dostaw, musisz włączyć opcje wysyłki z Alsendo Shipping. 
4. Dla danej strefy wysyłki wybierz “Dodaj opcje wysyłki” (D). W Typ wstawki wskaż “Obliczanie przez przewoźnika lub aplikację” (E) jako “Przewoźnika lub aplikację” wskaż Alsendo Shipping (E). Wskaż usługi wysyłkowe, które chcesz udostępnić (F). 
5. Gdy wszystko zostało wprowadzone wybierz “Gotowe” (G), a następnie zapisz zmiany na stronie ustawień.  

Nadanie zlecenia

Masowe nadawanie zleceń

1. Przejdź do zakładki Zamówienia (A) 
2. Zaznacz zlecenia, które chcesz zrealizować. 
3. Z paska akcji wybierz trzy kropeczki (B) ,a nastepnie “Alsendo Bulk Send” (C). 

4. Na oknie, które się wyświetli możesz zweryfikować wprowadzone dane oraz przypisać odpowiedni szablon paczki. 
5. Gdy wszystkie dane się zgadzają wybierz “Wyślij wszystkie zamówienia” (D)

Pojedyncze nadawanie zleceń

1. Przejdź do zamówień oraz otwórz szczegóły zamówienia. 
2. W sekcji “Blok” dodaj nowy “Alsendo-Full-Shipping” (A). 

3. Gdy blok zostanie dodany pojawi się przycisk “Utwórz zlecenie wysyłki”. 
4. Jego wybranie otworzy formularz nadawczy. 
5. Dane w formularzu zostaną uzupełnione informacjami podanymi w momencie konfiguracji wtyczki (dane nadawcze oraz szablony paczki). 
6. Jeżeli wszystkie dane uzupełnione są poprawnie w dolnej części ekranu dostępny jest przycisk “Sprawdź opcje wysyłki” (B) 

7. Jeżeli metody zostały dodane za pośrednictwem naszego modułu, a do metody została przypisana usługa, wycena nastąpi dla tej usługi. W przypadku tworzenia metod z poziomu ustawień Shopify (dla planów Basic oraz Grow bez CCS) nastąpi pełna wycena. 
8. Po wybraniu odpowiedniej usługi wystarczy wybrać “Wyślij zamówienie” (C).

6. Po utworzeniu zamówienia dostępne będzie posumowanie z możliwością pobrania listu lub anulowania zlecenia (D).