Jak AI obsługuje wysyłki przez Orlen Paczkę, Packetę i Pocztex, gdy masz trzech przewoźników naraz?

Tak, to działa i nie jest to projekt na pół roku. Orlen Paczka, Packeta i Pocztex mają programowe API, przez które można pobierać statusy przesyłek, generować etykiety i zaciągać dane do rozliczeń. Firmie, która wysyła jednocześnie do klientów w Polsce, Czechach i na Węgrzech, AI daje jeden obraz z trzech różnych paneli: bez osobnego logowania, bez ręcznego przepisywania numerów i bez czekania, aż ktoś ręcznie odświeży stronę przewoźnika.

Jak wyglądają API Orlen Paczki, Packety i Pocztexu i co naprawdę można z nich wyciągnąć?

Każdy z tych trzech przewoźników ma inne podejście do integracji. Warto to wiedzieć zanim zaczniemy cokolwiek budować.

Orlen Paczka udostępnia REST API dla klientów z aktywnym kontem biznesowym. Klucz API generujemy w panelu klienta, w sekcji Integracje. Przez API możemy tworzyć przesyłki i pobierać numer listu przewozowego, ściągać aktualny status konkretnej paczki, generować etykiety w PDF i pobierać raporty nadań zbiorczych. Statusy mają czytelne kody: CREATED, IN_TRANSIT, IN_SORTATION_CENTER, READY_FOR_PICKUP, DELIVERED, RETURN_IN_PROGRESS. Rozliczenia pobrań i zestawienia finansowe są dostępne w panelu klienta jako pliki CSV lub XLSX, a nie bezpośrednio przez API. To oznacza, że do automatycznego rozliczania pobrań trzeba ściągać te pliki cyklicznie i przetwarzać je skryptem.

Packeta (dawniej Zásilkovna) ma dobrze udokumentowane REST API dostępne pod adresem api.packeta.com. Klucz autoryzacyjny, który w dokumentacji Packety nosi nazwę API password, generujemy w panelu klienta. Przez API tworzymy przesyłki funkcją createPacket, pobieramy historię zdarzeń śledzenia przez getPacketTracking, a zbiorcze manifesty nadań obsługuje createShipmentPackets. Packeta to naturalny wybór do Czech, Słowacji i Węgier: gęsta sieć Pickup Points (parcelshopy pod marką Packeta Box albo Z-Box) i czytelne API. Zwroty oznaczone są flagą isReturn w odpowiedzi. Rozliczenia pobrań Packeta udostępnia przez endpoint getPaymentInstructions, który zwraca informację o kwocie, numerze przesyłki i dacie przelewu. To znacząco ułatwia automatyczne zestawianie wpłat z zamówieniami.

Pocztex, czyli usługa kurierska Poczty Polskiej, to osobny świat. Poczta Polska udostępnia platformę EPP (Elektroniczna Platforma Pocztowa), przez którą klienci biznesowi nadają przesyłki, generują etykiety i pobierają statusy. EPP obsługuje interfejs SOAP do pełnej integracji systemowej, a nowsze połączenia działają też przez REST. Do dostępu potrzebna jest umowa z Pocztą Polską i konto klienta biznesowego z nadanymi uprawnieniami do API. Statusy przesyłek dostępne są też przez publiczne API śledzenia, ale pełne dane: zdarzenia, lokalizacja, kolejne próby doręczenia, są wyłącznie dla klientów z umową. Reklamacje można składać przez platformę EPP albo przez formularz w portalu klienta, a odpowiedź przychodzi w terminie do 30 dni od złożenia.

Czego producenci nie udostępniają przez API: pełnej historii rozmów z klientami końcowymi, danych innych nadawców, wewnętrznych kart trasy kuriera. To normalne ograniczenie każdego API przewoźnika. Dane, które są dostępne, wystarczają do wszystkiego opisanego dalej.

Co AI widzi, gdy przesyłka utknęła w sortowni od dwóch dni?

U jednego klienta, który wysyłał kilkaset paczek tygodniowo przez dwóch przewoźników, problem wyglądał tak: paczka przez trzy doby miała status IN_SORTATION_CENTER w Orlen Paczce. Nikt tego nie zauważył, bo w panelu wszystko wyglądało jak zwykle. Klient napisał reklamację bezpośrednio na Allegro, sprzedawca dostał obniżoną ocenę, a paczka dotarła następnego dnia.

AI podłączone do API przewoźnika sprawdza statusy co godzinę i oznacza przesyłki, które nie zmieniły statusu przez zdefiniowany czas. Przykładowo: każda paczka z kodem IN_SORTATION_CENTER przez ponad 48 godzin trafia automatycznie do listy "do sprawdzenia". AI nie dzwoni do kuriera. Generuje zestawienie z numerami, ostatnim zdarzeniem i datą zatrzymania, które ląduje rano u koordynatora wysyłek albo trafia do systemu zadań firmy jako ticket.

Przy Packecie to samo: AI pobiera getPacketTracking dla wszystkich aktywnych przesyłek i szuka tych, gdzie ostatnie zdarzenie ma datę starszą niż ustalony próg, a status to nie "delivered". Zwroty z flagą isReturn trafiają do osobnej listy razem z datą zwrotu, numerem przesyłki i nazwiskiem odbiorcy. Koordynator zamiast szukać po trzech panelach dostaje gotową tabelę do działania.

Trzy przewoźniki, Polska, Czechy i Węgry: jak wygląda jeden dzień wysyłek z AI?

Wyobraź sobie sklep z akcesoriami kuchennymi, który wysyła do polskich klientów przez Orlen Paczkę (bo klienci zamawiają odbiór w punktach Ruch i ORLEN), do Czech i Słowacji przez Packetę (bo tam klienci oczekują odbioru w Packeta Box), a do klientów na Węgrzech przez Pocztex Kurier 48 z wynegocjowaną stawką na platformie EPP. W jednym dniu wychodzi trzydzieści nadań: część krajowych, część zagranicznych, różne gabaryty, kilka zamówień z pobraniem.

Bez AI wygląda to tak. Magazynier drukuje etykiety z trzech różnych paneli, ktoś ręcznie aktualizuje statusy w arkuszu, a w razie pytania od klienta trzeba wejść na trzy strony śledzenia. Przy skoku zamówień w sezonie to potrafi być pół godziny szukania każdego ranka.

Z AI wygląda to inaczej. Nadania tworzone są przez API wszystkich trzech przewoźników z jednego miejsca. Dane zamówienia: adres, waga, wymiary, wartość pobrania, wchodzą do systemu, AI przypisuje przewoźnika według reguły (kraj dostawy, typ przesyłki, wybór klienta przy kasie), tworzy przesyłkę w API i pobiera etykietę. Etykiety trafiają do jednego wydruku zbiorczego dla magazynu. Wieczorem AI zaciąga statusy wszystkich nadań z tego dnia, zestawia z zamówieniami i generuje raport: ile dostarczono, ile jest w transporcie, ile wymaga uwagi. Koordynator widzi to rano bez logowania do trzech paneli.

Klient, który pisze "kiedy dotrze moja paczka", dostaje odpowiedź bez angażowania pracownika. AI sprawdza numer zamówienia, wyciąga aktualny status z API właściwego przewoźnika i odpowiada: "Twoja paczka jest w centrum sortowania w Pradze od wczoraj wieczór, szacowany czas dostawy jutro do 18:00." Jeśli pojawia się opóźnienie powyżej normy, AI zaznacza sprawę i pyta klienta, czy chce, żeby skontaktował się z nim pracownik.

Reklamacja z numerem i dowodami: gdzie AI naprawdę skraca czas?

Składanie reklamacji do przewoźnika to praca, której nikt nie lubi. Trzeba zebrać: numer przesyłki, datę nadania, wartość towaru, dowód nadania (etykieta lub potwierdzenie z API), dowód wartości (faktura zakupu lub sprzedaży) i opis szkody albo braku dostarczenia. Przy kilku reklamacjach miesięcznie to jeszcze do wytrzymania. Przy kilkunastu to godziny zbierania dokumentów rozsianych po folderach i skrzynkach.

AI ma dostęp do tych danych w systemie: numer przesyłki z zamówienia, data nadania z API przewoźnika, wartość towaru z zamówienia, etykieta pobrana w momencie nadania. Gdy koordynator oznaczy przesyłkę jako "problem: reklamacja", AI przygotowuje projekt pisma według wzoru wymaganego przez danego przewoźnika. Do Orlen Paczki inne pola i inny formularz niż do Pocztexu przez platformę EPP. AI wypełnia automatycznie wszystko, co ma z systemu, a koordynator dopisuje tylko opis uszkodzenia. Pismo gotowe do weryfikacji i wysłania w kilka minut zamiast szukania numerów w trzech miejscach.

Przy Pocztexie termin odpowiedzi na reklamację to 30 dni od złożenia. AI pilnuje tego terminu: jeśli odpowiedź nie wpłynęła, generuje przypomnienie i projekt ponaglenia z datą złożenia pierwotnego pisma. Przy Packecie analogicznie: termin reklamacyjny jest określony w regulaminie, AI go śledzi i alarmuje, zanim upłynie.

Pobrania i rozliczenia: skąd się biorą niezgodności?

Pobranie to sytuacja, w której klient płaci kurierowi przy odbiorze, a pieniądze wracają do nadawcy z opóźnieniem i po odjęciu prowizji oraz opłaty za usługę. Przy kilku przewoźnikach i kilkudziesięciu pobraniach miesięcznie zestawienie "co wróciło, a co nie" łatwo wylatuje z głowy.

Packeta udostępnia endpoint getPaymentInstructions, który zwraca informację o rozliczeniu pobrań: kwota, numer przesyłki, data przelewu. Orlen Paczka rozlicza pobrania raportami CSV dostępnymi w panelu klienta. Pocztex przez platformę EPP ma raporty finansowe w sekcji rozliczeń. AI ściąga te dane cyklicznie, zestawia z zamówieniami oznaczonymi jako pobranie i generuje tabelę niezgodności: zamówienia, dla których oczekujemy przelewu, ale jeszcze nie wpłynął. Gotowe zestawienie do weryfikacji z księgowością raz w tygodniu.

Typowo wygląda to tak, że część pobrań z danego miesiąca czeka na przelew dłużej niż wynikałoby z regulaminu. Bez automatycznego zestawienia te przypadki łatwo przegapić, bo jeden przewoźnik przelewa raz w tygodniu, inny dwa razy w miesiącu, a księgowość sprawdza tylko zbiorcze kwoty, nie poszczególne przesyłki.

Porównanie kosztów przewoźników per trasa: jak to liczyć bez arkusza kalkulacyjnego?

Trzy przewoźniki to trzy różne cenniki. Orlen Paczka ma swoją taryfę dla punktów i kuriera domowego. Packeta ma stawki dla Czech, Słowacji i Węgier, osobno dla parcelshopów i kuriera Door-to-Door. Pocztex Kurier 48 ma stawki z umowy EPP, do których dochodzą dopłaty paliwowe i strefowe. Każdy liczy inaczej paczki o niestandardowych wymiarach i każdy ma inny próg gabarytowy.

AI może zestawiać te stawki dla konkretnego zamówienia. Gdy wpada zamówienie z adresem na Węgrzech i wagą 3 kg, AI sprawdza, ile wyniesie wysyłka przez Packetę (kurier domowy albo Packeta Box) i ile przez Pocztex Kurier 48. Wynik to konkretna kwota per trasa, a nie tabela ogólna. Na tej podstawie koordynator albo automat dobiera przewoźnika zgodnie z zasadami firmy.

Różnica widoczna jest dopiero na konkretnych trasach i wolumenach. Jeden klient, który wysyłał do Czech wyłącznie kurierem domowym, po takim zestawieniu przeszedł częściowo na Packeta Box przy zamówieniach na niższe kwoty: klient i tak wybierał odbiór w punkcie przy kasie, a cena wysyłki wychodziła niższa. To nie jest teoria: wyniki zestawienia AI zależą od aktualnej umowy z przewoźnikiem, ale samo narzędzie można uruchomić na własnych danych od razu.

Od czego zaczynamy, gdy firma ma już InPost i chce dołożyć kolejnych przewoźników?

Większość firm, które do nas trafiają, ma już InPost i jakiś system do zarządzania zamówieniami: Baselinker, własny panel sklepu albo ERP z modułem logistyki. Dołożenie Orlen Paczki, Packety i Pocztexu to nie przełącznik, ale też nie projekt na miesiące.

Zaczynamy od trzech rzeczy. Po pierwsze: umowy biznesowe z każdym z przewoźników, bo bez umowy nie ma dostępu do pełnego API. Po drugie: klucze API. Orlen Paczka i Packeta generujemy samodzielnie w panelach klientów. Pocztex wymaga konfiguracji konta na platformie EPP z pomocą opiekuna ze strony Poczty Polskiej. Po trzecie: lista tego, co firma chce śledzić: same statusy, etykiety, reklamacje, pobrania, raporty zbiorcze? Warto to ustalić przed integracją, bo zakres wpływa na czas wdrożenia.

Potem podłączamy AI krok po kroku. Najpierw statusy i odpowiadanie na pytania klientów. Potem automatyczne wykrywanie opóźnień. Potem reklamacje i pobrania. Każdy krok daje już konkretną wartość zanim przejdziemy do następnego. Firma od razu widzi, co zyskała, zamiast czekać na "gotowy system".

Jeśli wysyłacie do kilku krajów i chcecie mieć jeden obraz zamiast kilku paneli, sprawdźcie, jak to wygląda u firm, które już to robią: realne wdrożenia. Albo opowiedzcie nam o swoim przypadku na 15 minutach rozmowy.