Instrukcja integracji PrestaShop 8 z Apaczka.pl

Prowadząc sklep na PrestaShop 8 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

Obsługiwane wersja PrestaShop – 1.7.8+ oraz 8
Obsługiwana wersja PHP – 7.4+

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 przed 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. (W przypadku braku integracji na liście wybierz “Inne” lub “Integracja własna”) 
   Wygenerowane klucze posłużą do późniejszej konfiguracji. 

Konfiguracja w PrestaShop

Instalacja wtyczki

1. Pobierz wtyczkę z naszej platformy.

2. W panelu administracyjnym PrestaShop przejdź do zakładki: ULEPSZENIA → Moduły → Menedżer modułów (A).
3. Wybierz “Załaduj moduł” (B), a następnie wybierz plik z wtyczką.
   Gdy moduł zostanie zainstalowany przejdź do konfiguracji (C).

Konfiguracja wtyczki

1. Przejdź do swojego panelu administracyjnego PrestaShop (A)
   Alsendo → Konfiguracja 
2. Wpisz wygenerowane wcześniej klucze API oraz uzupełnij formularz o domyślne dane (B) 
3. Zwróć uwagę, że formularz został podzielony na kilka sekcji: 
   • domyślny adres nadawcy, 
   • ustawienia wysyłki, 
   • domyślne godziny odbioru, 
   • ustawienia dodatkowe. 
4. Uzupełnij sekcje zgodnie ze swoimi preferencjami. (C) Pamiętaj o zapisywaniu danych po uzupełnieniu każdej sekcji, w innym wypadku wpisane wcześniej dane nie zostają zapisane.  

Szablony we wtyczce

1. W konfiguracji wtyczki w sekcji zarówno danych nadawcy jak i ustawienia wysyłki widnieje opcja “Wybierz szablon” 
2. Celem dodania nowego szablonu rozwiń listę i wybierz “Nowy szablon”, wprowadź nowe dane a następnie zapisz zmiany. 
3. Wprowadź nową nazwę szablonu i zapisz. 
4. Jeżeli chcesz, aby szablon ustawiony został jako domyślny, wybierz go z listy rozwijanej (A) “Wybierz szablon” a następnie wciśnij “Ustaw jako domyślny” (B) (jeżeli brakuje tego przycisku oznacza to, że szablon już jest domyślny). 

Tworzenie metod nadawczych

1. Przejdź do swojego panelu administracyjnego PrestaShop (A) 
   Alsendo → Metody wysyłki 
2. W celu dodania przewoźników wybierz “Dodaj metodę” (B)
3. Uzupełnij nazwę metody (będzie ona wyświetlana w koszyku sklepu), wybierz dedykowaną usługę, która zostanie przypisana do metody, wprowadź cenę i w przypadku usług z doręczeniem do punktu włącz checkbox “Mapa”. 
4. Zapisz zmiany dla każdej dodanej usługi. (C) Będą one już widoczne w koszyku sklepu. 

Wysyłka zleceń

Szybkie nadanie zlecenia: 

1. W szczegółach zlecenia (A) dostępna jest sekcja “Wysyłka Alsendo” (B), zawarte w niej są wszystkie informacje wprowadzone w module oraz informacje na temat wybranego szablonu przesyłki. 
2. Jeżeli wszystkie dane się zgadzają oraz został wybrany odpowiedni szablon można nadać paczkę przyciskiem “Szybka wysyłka” (C). 
3. Jeżeli wszystkie dane zostały wprowadzone poprawnie widoczne będzie podsumowanie z widoczną usługą, kwotą wysyłki, numer listu przewozowego oraz możliwością pobrania listu i anulowania paczki.

Nadanie pełnym formularzem:

1. Jeżeli konieczne jest wprowadzenie dokładnych zmian w adresie można skorzystać ze szczegółowego widoku nadania. W szczegółach zlecenia pod sekcją “Wysyłka Alsendo” widoczny jest przycisk “Utwórz przesyłkę” (widoczny na zrzucie ekranu powyżej), po jego wybraniu otworzy się szczegółowy formularz nadawczy. 
2. Można wprowadzić zmiany zarówno w danych nadawcy/odbiorcy, szczegółach paczki, ale również sposobie nadania, godzinie i dniu nadania lub wybrać inną usługę przewoźnika.  
3. Gdy zmiany zostaną wprowadzone można je zapisać celem nadania w późniejszym terminie już poprawionego zlecenia lub nadać je od razu przyciskiem “Wyślij przesyłkę” (A). 
4. Jeżeli wszystko przebiegło prawidłowo zostaniemy przekierowani do podsumowania z widoczną usługą, kwotą wysyłki, numer listu przewozowego oraz możliwością pobrania listu i anulowania paczki.

Masowe nadawanie zleceń:

1. W zakładce “Zamówienia” zaznaczamy zlecenia, które chcemy zrealizować. 
2. Wybieramy widoczny nad zleceniami przycisk “Wyślij przez Alsendo”, zostaniemy przeniesieni do okna masowego nadawania zleceń.  

3. Z tego poziomu możemy edytować jedynie szablon przesyłki który zostanie zastosowany do konkretnego zlecenia. (A) 
4. Jeżeli wszystko się zgadza wybieramy “Wyślij wszystkie zamówienia”. (B) 
5. W kolumnie “Komunikat/Akcja” pojawi się podsumowanie. Dla zrealizowanych zleceń będzie możliwość pobrania listu przewozowego oraz anulowania zlecenia, w przypadku błędu wyświetli się komunikat z informacją co należy poprawić (konieczne nadanie poprzez pełny formularz).