Instrukcja integracji Apaczka.pl z OpenCart

Prowadząc sklep na OpenCart 4 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.

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 OpenCart

Instalacja wtyczki

1. Pobierz wtyczkę z naszej platformy. (WAŻNE – po pobraniu zmień nazwę na “alsendo.ocmod” bez dodatkowych znaków lub dopisków, w innym wypadku moduł nie zainstaluje się prawidłowo). 

2. W panelu administracyjnym OpenCart przejdź do zakładki: Extensions → Installer 
3. W prawym górnym rogu dostępny jest przycisk “Upload” (A), po jego wciśnięciu konieczne będzie wybranie pobranego wcześniej modułu. 
4. Po wgraniu modułu pojawi się on na liście zainstalowanych aplikacji. Po prawej stronie modułu dostępny będzie zielony przycisk “Install”, wciśnij go, aby dokonać instalacji. (B)

5. Gdy instalacja dobiegnie końca przejdź do Extensions -> Extensions, a z listy dostępnych typów wybierz “Modules”. (A) Widoczny tam będzie moduł “Alsendo” ponownie wybierz zielony przycisk “Install”. (B)

Konfiguracja wtyczki

1. Po poprawnej instalacji, w menu bocznym pojawiła się nowa zakładka “Alsendo”, w celu konfiguracji w sekcji tej wybierz Konfiguracja wtyczki → Konfiguracja wtyczki (jeżeli jej nie widać, odśwież stronę). (A) 
2. Zwróć uwagę, że formularz został podzielony na kilka sekcji: 
   • dane nadawcy, 
   • Ustawienia przesyłki 
   • ustawienia dodatkowe 
3. Uzupełnij sekcje zgodnie ze swoimi preferencjami. Pamiętaj o zapisywaniu danych po uzupełnieniu każdej sekcji, w innym wypadku wpisane wcześniej dane nie zostają zapisane. (B,C,D) 

Szablony we wtyczce

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

Tworzenie metod nadawczych

1. Przejdź zakładki „Alsendo” -> Konfiguracja wtyczki -> Ustawienia wysyłek (A)
2. W celu dodania przewoźników wybierz “Dodaj metodę dostawy”. (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ę. 
4. Zapisz zmiany, będą one już widoczne w koszyku sklepu. (C)
5. Po zapisaniu pamiętaj o “Mapowaniu płatności” i przypisaniu konkretnych metod płatności dla metod dostaw. (D)

Wysyłka zleceń

Szybkie nadanie zlecenia: 

1. W szczegółach zlecenia dostępna jest sekcja “Wysyłka Alsendo” (A) 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 “Zamów przesyłkę”. (B)
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 “przejdź do pełnego formularza” (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 “Zamów 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 „Sales” -> “Orders” zaznaczamy zlecenia, które chcemy zrealizować. (A)
2. Wybieramy widoczny w prawym górnym rogu przycisk “Nadaj z Alsendo” (ciemno niebieska ciężarówka], zostaniemy przeniesieni do okna masowego nadawania zleceń. (B)

3. Z tego poziomu możemy edytować szablony nadawcy oraz przesyłki, które zostaną zastosowane do konkretnego zlecenia. 
4. Jeżeli wszystko się zgadza wybieramy “Masowa wysyłka” w prawym górnym rogu (ciemno niebieska ciężarówka). (A)
5. W kolumnie “Status zlecenia” pojawi się podsumowanie. Dla zrealizowanych zleceń będzie możliwość pobrania listu przewozowego oraz anulowania zlecenia (B), w przypadku błędu wyświetli się komunikat z informacją co należy poprawić. 

Dopasuj ofertę

Chcesz otrzymać ofertę dopasowaną do Twojego biznesu? Wypełnij formularz. Oddzwonimy do 24h.

Ile paczek wysyłasz miesięcznie?*

do 2020-50powyżej 50

Ile palet wysyłasz miesięcznie?*

nie wysyłam1-55-20powyżej 20
Wyrażam zgodę na otrzymywanie informacji handlowych o produktach i usługach ofertowanych przez Alsendo sp. z o.o. z siedzibą w Warszawie za pośrednictwem następujących kanałów komunikacji: e-mail, SMS, połączenia telefoniczne.(więcej) Wyrażona zgoda może zostać wycofana w dowolnym momencie, ale przetwarzanie, którego dokonano na jej podstawie przed wycofaniem pozostaje zgodne z prawem. Więcej informacji na temat przetwarzania danych osobowych, w tym przysługujących Ci praw, znajduje się w naszej Polityce prywatności.

Dziękujemy! Formularz został wysłany

Oddzwonimy do 24h.