Jak AI może pilnować wysyłek w Apaczce i Epace i co robić, gdy paczka stoi bez ruchu?

Tak, AI można podłączyć bezpośrednio do Apaczki i Epaki przez ich REST API i od razu pracować na danych ze wszystkich kurierów jednocześnie. W praktyce AI wyłapuje paczki stojące bez ruchu od kilku dni, przygotowuje projekt reklamacji do ręcznego zatwierdzenia i odpowiada klientom na pytania o status przesyłki bez angażowania pracownika. Efekt jest najlepiej widoczny tam, gdzie firma wysyła kilkadziesiąt lub więcej paczek dziennie i regularnie obsługuje pobrania.

Jeden panel, wielu kurierów: czym jest broker kurierski i dlaczego to inny punkt startowy

Apaczka i Epaka to brokerzy kurierski. Zamawianie przesyłki, drukowanie etykiety, śledzenie, obsługa pobrań i składanie reklamacji odbywa się przez jedną platformę, niezależnie od tego, który przewoźnik jedzie z daną paczką. DHL, DPD, GLS, InPost, Poczta Polska, UPS, FedEx i inni są dostępni z jednego miejsca.

Z perspektywy integracji z AI to robi konkretną różnicę. Gdybyście chcieli obsłużyć każdego kuriera osobno, potrzebowalibyście osobnej umowy z DHL, osobnego API DPD, osobnego procesu reklamacji w GLS i innego formatu danych dla każdego z nich. Z brokerem macie jeden model danych, jeden klucz dostępowy i jeden format odpowiedzi. AI czyta to samo pole ze statusem bez względu na to, czy paczka jedzie DHL-em, GLS-em czy InPostem. Jeden punkt zamiast sześciu.

Obie platformy obsługują też pobrania (COD). To szczególnie ważne dla firm sprzedających na rynek krajowy, gdzie część klientów nadal płaci przy odbiorze. Broker zbiera zwroty gotówki od kurierów i rozlicza je zbiorczo: zamiast śledzić osobno, ile wpłynęło z DHL-a, ile z DPD, macie jeden widok całości. I właśnie ten widok całości AI potrafi sprawdzać automatycznie, bez ręcznego zestawiania kolumn w Excelu.

Jak fizycznie wygląda podłączenie: API, klucze, co dostajemy i czego nie

Obie platformy udostępniają REST API. To oficjalny, dokumentowany kanał integracji, przeznaczony do podłączania zewnętrznych systemów, nie żaden obejściowy import pliku.

Apaczka używa REST API w wersji 2. Uwierzytelnianie działa przez parę: app_id (identyfikator aplikacji) i app_secret (klucz tajny). Każde zapytanie podpisuje się algorytmem HMAC-SHA256, co oznacza, że klucz nie wędruje jawnie w żądaniu, tylko jako podpis cyfrowy. Klucze generujecie w panelu Apaczki, w sekcji dotyczącej integracji lub API. Przy niektórych planach dostęp jest aktywny od razu, przy innych trzeba odezwać się do opiekuna konta.

Epaka działa podobnie: REST API z kluczem API przekazywanym w nagłówku zapytania. Klucz i dokumentację znajdziecie w ustawieniach konta, w zakładce integracji. Epaka ma też gotowe wtyczki do WooCommerce, Shopera, PrestaShop i Baselinker, ale te wtyczki nie zastępują API przy integracjach z AI: działają w innym celu (nadawanie paczek z panelu sklepu), a AI potrzebuje bezpośredniego dostępu do danych o statusach, kosztach i pobraniach.

Gdy podpinamy API u klienta, przez jedno połączenie dostajemy:

• Listę zamówień z polami: numer zamówienia w Apaczce lub Epace, numer śledzenia, identyfikator przewoźnika (service_id lub service_name, np. DHL, DPD, GLS), aktualny status, data nadania, data ostatniej zmiany statusu
• Dane o pobraniach: kwota COD, waluta, status zwrotu pobrania
• Historię statusów dla konkretnej przesyłki, z datą każdego skanu
• Cennik usług do porównywania kosztów między przewoźnikami dla konkretnych parametrów przesyłki
• Dane o reklamacjach: numer, status, przewoźnik, kwota roszczenia, data złożenia

Czego API nie daje bez dodatkowej pracy: pełna historia trackingu od strony kuriera jest zależna od tego, jak często Apaczka i Epaka synchronizują dane z systemami przewoźników, więc zdarzają się opóźnienia między faktycznym skanem a widocznym statusem. Faktury za usługi są dostępne w panelu w PDF, ale ich pobieranie przez API bywa ograniczone. Sam obieg dokumentów reklamacyjnych ma też swoje granice po stronie API: status reklamacji AI odczyta, ale złożenie nowej odbywa się przez panel brokera lub kontakt z supportem.

Jakie dane wyciągamy i do czego się naprawdę nadają

Z perspektywy AI najcenniejsze są trzy zestawy danych.

Statusy przesyłek z datą ostatniej zmiany. Każda paczka ma pole z aktualnym statusem i timestamp ostatniej aktualizacji. Typowe statusy to: nadana, odebrana przez kuriera, w transporcie, dostarczona, zwrot do nadawcy, problem. AI codziennie przegląda listę i wyłapuje przesyłki, gdzie data ostatniej zmiany statusu jest stara, a paczka nie jest oznaczona jako dostarczona. Typowo wygląda to tak, że przesyłka utknęła w statusie in_transit od czterech dni, nikt tego nie zauważył, bo nikt ręcznie nie sprawdzał listy, a klient za chwilę zadzwoni zniecierpliwiony.

Dane o pobraniach. Pola cod_value i status zwrotu COD pokazują, czy gotówka od kuriera już wpłynęła. U jednego klienta handlującego elektroniką zajmowało sporo czasu ręczne zestawianie, które pobrania z tygodnia są już rozliczone, a które czekają. AI robi to automatycznie: pobiera listę przesyłek z typem COD, sprawdza status zwrotu i generuje zestawienie "nierozliczone pobrania starsze niż N dni". Żadnego liczenia w głowie ani dopasowywania kolumn.

Koszty według przewoźnika. API cennika pozwala AI zestawiać realne koszty usług dla konkretnych parametrów. Mając historię wysyłek z ostatniego miesiąca, AI może pokazać, ile faktycznie zapłaciliście za każdego kuriera i przy jakich parametrach jeden przewoźnik wychodził taniej od drugiego. To nie jest porada ogólna: to konkretne dane z Waszych własnych wysyłek, z Waszymi adresami dostawy i Waszą strukturą paczek.

Co robi AI krok po kroku: paczki, klienci, reklamacje, koszty

Paczki stojące bez ruchu. Każdego rana AI pobiera przez API listę aktywnych przesyłek i filtruje te, gdzie status nie zmienił się od ponad określonej liczby dni (tę granicę ustawiacie sami), a paczka nie jest dostarczona. Wynik trafia do pracownika jako gotowa lista z numerem śledzenia, przewoźnikiem i ostatnim statusem. Pracownik od razu wie, z którym kurierem się kontaktować i w jakiej sprawie. Bez AI ta lista powstawałaby ręcznie, o ile w ogóle ktoś miał na nią czas w natłoku bieżących spraw.

Odpowiedzi klientom o status paczki. Klient pisze e-mail lub wiadomość: "gdzie jest moja paczka, numer zamówienia 1234". AI pobiera numer śledzenia przez API na podstawie numeru zamówienia z Waszego systemu, sprawdza aktualny status i historię statusów, formułuje odpowiedź po polsku. Brzmi to mniej więcej tak: "Paczka jest u kuriera DHL od wtorku, ostatni skan w Łodzi w środę rano, spodziewany czas dostawy to dzisiaj lub jutro." Pracownik widzi tę propozycję, zatwierdza i wysyła. Albo, gdy firma zdecyduje, AI wysyła automatycznie dla prostych statusów. Tutaj nie ma wymyślania: odpowiedź wynika wprost z danych z API.

Przygotowanie projektu reklamacji. Gdy paczka jest uszkodzona lub zaginęła, reklamacja do kuriera wymaga podania konkretnych danych: numeru przesyłki, daty nadania, service_id (który przewoźnik), opisu zdarzenia, wartości towaru. AI zbiera te pola z API Apaczki lub Epaki i przygotowuje wypełniony projekt. Pracownik sprawdza, dopisuje opis zdarzenia, jeśli brakuje szczegółów z biura, i zatwierdza. Złożenie do kuriera odbywa się przez panel brokera. AI nie składa reklamacji samodzielnie: decyzja powinna być po stronie człowieka, szczególnie gdy chodzi o kwoty odszkodowania.

Porównanie kosztów przewoźników. Co miesiąc AI pobiera historię zamówień z API, grupuje je według service_name, sumuje koszty i liczy średnią dla różnych zakresów wag i typów dostawy. Wynik: tabela z Waszymi własnymi danymi, która pokazuje, gdzie płacicie więcej i przy jakich parametrach. Żadnych fikcyjnych liczb: liczby z Waszych własnych wysyłek.

Jak to wygląda w praktyce: scenariusz z biura

Firma wysyła kilkadziesiąt paczek dziennie przez Apaczkę. W środę rano przychodzą dwie wiadomości od klientów. Pierwsza: pytanie o paczkę zamówioną tydzień temu, brak kontaktu z kurierem. Druga: paczka dotarła uszkodzona, klient chce reklamację.

Bez AI: pracownik loguje się do panelu Apaczki, szuka numeru zamówienia, przechodzi do śledzenia, formułuje odpowiedź dla pierwszego klienta, potem szuka szablonu reklamacyjnego dla drugiego, wypełnia go ręcznie, kompletuje dane przesyłki z kilku miejsc.

Z AI: system pobiera dane przez API dla obydwu spraw w kilka sekund. Dla pierwszej przesyłki AI widzi, że paczka stoi w statusie in_transit od pięciu dni bez aktualizacji i przygotowuje dwa dokumenty: propozycję odpowiedzi dla klienta i sugestię zgłoszenia do Apaczki. Dla drugiej AI przygotowuje projekt reklamacji z wypełnionymi polami: numer przesyłki, data nadania, service_id, wartość zamówienia z systemu sprzedażowego. Pracownik przegląda obydwie propozycje, poprawia opis zdarzenia dla reklamacji, zatwierdza. Obie sprawy zamknięte w kilka minut zamiast kilkudziesięciu.

To właśnie ten typ pracy, gdzie AI nie zastępuje decyzji, ale zdejmuje z pracownika żmudne szukanie i przepisywanie danych między zakładkami. Jak wygląda efekt przy firmach, które przez to przeszły: realne wdrożenia.

Skrzynka pobrań i otwarte reklamacje: dwa miejsca, które warto pilnować regularnie

Pobrania to temat, który przy kilkudziesięciu paczkach tygodniowo łatwo wymyka się spod kontroli. Broker zbiera zwroty gotówki od kurierów i rozlicza je zbiorczo. API Apaczki i Epaki daje dostęp do statusów zwrotów COD. AI może co tydzień przeglądać listę przesyłek z pobraniem i oznaczać te, przy których zwrot nie wpłynął w oczekiwanym czasie. Nie chodzi o alarmowanie za każdym razem: chodzi o to, żeby żadne pobranie nie "zgubiło się" w natłoku przesyłek i nie czekało tygodniami bez sprawdzenia.

Otwarte reklamacje działają podobnie. Reklamacja złożona dwa tygodnie temu i bez odpowiedzi od kuriera to sygnał do podbicia sprawy. AI monitoruje statusy reklamacji i wysyła pracownikowi przypomnienie, gdy czas oczekiwania przekracza standard danego przewoźnika. Obydwa mechanizmy są stosunkowo proste technicznie: to regularne odpytywanie API i porównywanie dat. Wartość jest w tym, że dzieje się to automatycznie i bez angażowania uwagi pracownika każdego ranka.

Od czego zaczyna się wdrożenie

Zanim AI cokolwiek zrobi, potrzebujecie kilku rzeczy po stronie konta i systemu:

• Klucze API aktywne w koncie Apaczki lub Epaki: w panelu konta przejdźcie do sekcji integracji i wygenerujcie app_id oraz app_secret (Apaczka) albo klucz API (Epaka). Przy niektórych planach trzeba aktywować dostęp przez opiekuna konta brokera.
• Numer zamówienia jako wspólny klucz: żeby AI mogło łączyć dane z Apaczki ze Waszym systemem sprzedażowym (ERP, sklep, CRM), numer zamówienia z systemu musi być przekazywany do Apaczki przy nadawaniu paczki. Jeśli nie jest, integracja działa, ale tylko po stronie przesyłek, bez powiązania z konkretnymi zamówieniami klientów i bez możliwości automatycznego odpowiadania na pytania "gdzie jest moje zamówienie".
• Zakres startowy: na początku warto skupić się na jednej funkcji, np. codziennej liście paczek bez ruchu. To prosty i szybki do wdrożenia punkt, który od razu daje widoczny efekt, bez ryzyka dla bieżących operacji wysyłkowych.

Integracja z API Apaczki lub Epaki nie jest projektem na tygodnie. Zazwyczaj pierwsze dane AI ma już na pierwszym spotkaniu technicznym, a gotowe narzędzie do monitorowania przesyłek powstaje w kilka dni roboczych. Złożoność rośnie, gdy chcecie połączyć dane z kilku systemów jednocześnie: Apaczka plus system sprzedażowy plus komunikacja z klientem przez e-mail albo czat. Ale można zaczynać od jednego punktu i dokładać kolejne wtedy, gdy jeden już działa.

Jeśli wysyłacie paczki przez Apaczkę lub Epakę i zastanawiacie się, co AI realnie odciążyłoby Wasz zespół, umówcie się na 15 minut rozmowy. Sprawdzimy razem, co ma sens przy Waszej skali wysyłek i które dane z API Waszego konta nadają się do automatyzacji od pierwszego dnia.