Integracja z Apaczka

Integracja z Apaczka rozszerza system o możliwość składania i obsługi zleceń transportowych u wielu przewoźników z poziomu jednego panelu. Umożliwia porównywanie ofert (cena, czas doręczenia, typ usługi) oraz automatyzuje proces tworzenia przesyłek i śledzenia statusów bez konieczności logowania do zewnętrznego serwisu.

Dlaczego Apaczka?

Kluczowe korzyści:

  • Dostęp do szerokiego wachlarza przewoźników w jednym miejscu.
  • Dynamiczne filtrowanie listy produktów na podstawie wybranych dodatków (najpierw wybierasz dodatki – potem widzisz tylko zgodne usługi).
  • Możliwość definiowania wielu opakowań w jednym zleceniu.
  • Standaryzowany kreator – spójny z innymi integracjami TMS.
  • Automatyczne śledzenie i aktualizacja statusów przesyłek w Business Central.
  • Obsługa powszechnych usług dodatkowych (ubezpieczenia, pobranie, punkty nadania / odbioru, doręczenia specjalne).

Wymagania wstępne

Do rozpoczęcia korzystania wymagane jest aktywne konto Apaczka oraz dane integracyjne (Identyfikator aplikacji / Sekret). Uprawnienia API muszą być aktywowane w panelu Apaczka.

Konfiguracja

  1. Otwórz stronę: TMS | Ustawienia.
  2. W sekcji 🔗 Integracje zewnętrzne wybierz: Apaczka.
  3. Ustaw pole Tryb testowy (w środowiskach sandbox zalecane: Włączony).
  4. Wybierz Domyślna usługa logistyczna – np. TMS (ustawienie startowe używane w kreatorze jeśli brak innego wyboru).
  5. Wybierz Preferowany typ płatności – najczęściej: Faktura zbiorcza.
  6. Wprowadź Identyfikator aplikacji: np. 234234_xTOxlv7DTFeWefliG7SmEov.
  7. Wprowadź Sekret aplikacji (wartość dostępna w panelu Apaczka – przechowuj bezpiecznie).
  8. Kliknij Weryfikuj ustawienia aby przetestować autoryzację.
Podpowiedź

Tryb testowy pozwala tworzyć zlecenia bez kosztów – używaj go w środowisku Sandbox. W produkcji wyłącz go po zakończonych testach.

Proces zamawiania

Nowe zlecenie możesz utworzyć z dokumentu sprzedaży, wydania magazynowego albo z listy istniejących zleceń transportowych.

Etapy kreatora Apaczka:

  1. Dane adresowe (nadawca, odbiorca, dane kontaktowe, adresy).
  2. Opakowania (możesz dodać dowolną liczbę wierszy – każdy wiersz to osobna paczka / element przesyłki).
  3. Dodatki (wybierasz usługi dodatkowe – lista produktów później pokaże tylko zgodne oferty).
  4. Produkt (wyszukanie i wybór właściwej usługi przewoźnika zgodnej z parametrami paczek i dodatków).
  5. Informacje dodatkowe (referencje, instrukcje, opcjonalne pola specyficzne dla przewoźnika / produktu).
  6. Podsumowanie (zatwierdzenie i złożenie zlecenia).
Ważne

W przeciwieństwie do integracji GlobKurier – w Apaczka kolejność jest: Dodatki -> Produkt. Dodatek może ograniczyć zbiór dostępnych usług, więc wybierasz go wcześniej.

Statusy i śledzenie

Statusy przesyłek są synchronizowane automatycznie zgodnie z harmonogramem (lub na żądanie). Dostępna jest oś zdarzeń (czas, lokalizacja, opis). Różnice w nazewnictwie statusów Apaczka są mapowane do standardu TMS.

Dodatki (usługi dodatkowe)

Przykładowe kategorie dostępnych dodatków:

  • Ubezpieczenie
  • Pobranie (COD)
  • Doręczenie / Nadanie w punkcie
  • Powiadomienia (SMS / e-mail)
  • Zwrot dokumentów / opakowań
  • Przedziały czasowe doręczenia

Zachowanie specyficzne dla Apaczka:

  1. Wybór dodatków następuje PRZED pobraniem listy produktów.
  2. Lista produktów filtruje się dynamicznie – pokazuje tylko usługi zgodne z zestawem aktualnie zaznaczonych dodatków.
  3. Zmiana zestawu dodatków wymaga ponownego wyszukania usług (system robi to automatycznie po zatwierdzeniu zmian).
  4. Kolizje (wykluczające się dodatki) są walidowane w czasie rzeczywistym.
Podpowiedź

Jeśli liczba wyników jest mała – spróbuj ograniczyć liczbę wybranych dodatków i przeszukaj ponownie.

Wiele wierszy opakowań

Apaczka pozwala na dodanie wielu pozycji opakowań. Każdy wiersz zawiera wymiary, wagę oraz ilość sztuk. System sumuje parametry tam, gdzie wymagane (np. weryfikacja limitów całkowitej wagi), a jednocześnie zachowuje szczegóły do etykiet.

Informacja

Usunięcie lub zmiana pojedynczego wiersza może wymagać odświeżenia listy produktów (jeżeli zmiana wpływa na spełnianie warunków dodatków lub przewoźników).

Najczęstsze problemy

Problem Rozwiązanie
Błąd autoryzacji Sprawdź Identyfikator / Sekret oraz czy tryb testowy odpowiada danym. Zweryfikuj aktywację API w panelu Apaczka.
Brak produktów po wybraniu dodatków Usuń część dodatków i wyszukaj ponownie – mogły zawęzić listę do zera. Sprawdź parametry paczek.
Brak etykiety po złożeniu Upewnij się, że zlecenie zostało poprawnie zarejestrowane i zaakceptowane. Spróbuj pobrać etykietę ponownie z karty zlecenia.
Statusy nie aktualizują się Uruchom ręcznie akcję aktualizacji lub sprawdź log błędów integracji (np. limit zapytań).
Odmowa przyjęcia parametrów Zweryfikuj wymiary / wagę pojedynczych paczek – niektóre produkty mają restrykcje jednostkowe oraz sumaryczne.

Dobre praktyki

  • Zacznij w trybie testowym i porównaj wyniki z panelem Apaczka, zanim przełączysz produkcję.
  • Utrzymuj minimalny zestaw dodatków – każdy dodatkowy warunek zawęża listę produktów.