Integracje / Orlen Paczka, Packeta, Pocztex
Transport, spedycja i magazyn
Integracja AI: Orlen Paczka, Packeta, Pocztex
Podłączamy API Orlen Paczki, Packety i Pocztexu: statusy przesyłek, raporty nadań i dane o pobraniach trafiają do jednego miejsca. Asystent wykrywa paczki zatrzymane w sortowni, zestawia nierozliczone pobrania i przygotowuje projekt reklamacji z danymi z systemu.
Po prezentacji do 2 tygodni testów, z dostępem tego samego dnia. Płacicie dopiero po decyzji.
Co podłączamy
Zaczynamy od odczytu danych. Zapis i akcje w systemie Orlen Paczka, Packeta, Pocztex włączamy dopiero wtedy, gdy sami tego chcecie.
CzytamySześć kodów statusowych: CREATED, IN_TRANSIT, IN_SORTATION_CENTER, READY_FOR_PICKUP, DELIVERED, RETURN_IN_PROGRESS z datą zmiany
AsystentWykrywa przesyłki z kodem IN_SORTATION_CENTER bez zmiany przez ponad 48 godzin i dołącza je do porannego raportu z numerem i datą zatrzymania
CzytamyHistoria zdarzeń: data, typ, lokalizacja; flaga isReturn odróżniająca zwroty od dostarczeń dla każdej przesyłki
AsystentSegreguje przesyłki zwrotne do osobnej listy z datą, numerem i odbiorcą; szuka paczek bez aktywności powyżej ustalonego progu
CzytamyZestawienia pobrań z panelu klienta: numer przesyłki, kwota pobrania i data wpływu środków do nadawcy
AsystentPrzetwarza pliki cyklicznie, zestawia z zamówieniami oznaczonymi jako pobranie i buduje listę pozycji bez potwierdzenia wpłaty
CzytamyKwota rozliczenia, numer przesyłki i data przelewu z każdego cyklu rozliczeniowego Packety
AsystentPorównuje daty i kwoty z oczekiwanymi pobraniami z zamówień i wskazuje pozycje, dla których przelew jeszcze nie wpłynął
CzytamyStatusy z historią zdarzeń, lokalizacja, kolejne próby doręczenia, raporty finansowe z sekcji rozliczeń EPP
AsystentŁączy dane z raportami pozostałych przewoźników i generuje tygodniowe zestawienie nierozliczonych pobrań do weryfikacji z księgowością
CzytamyFormularze reklamacyjne Pocztexu z wymaganymi polami, termin odpowiedzi 30 dni od złożenia pisma
AsystentWypełnia projekt reklamacji danymi z systemu i pilnuje 30-dniowego terminu, generując projekt ponaglenia przed jego upływem
CzytamyNumer listu przewozowego, etykieta PDF pobrana w chwili nadania, data i godzina stworzenia przesyłki w API
AsystentZbiera etykiety z trzech przewoźników do jednego wydruku zbiorczego dla magazynu i zapisuje numer nadania do zamówienia
O co pytają w praktyce
Po polsku, jak koledze z pracy. Asystent odpowiada na danych z Waszego programu, a nie z ogólnej wiedzy.
- „Które paczki utknęły w sortowni i wymagają sprawdzenia?”
- „Jakie pobrania z ubiegłego tygodnia jeszcze nie wróciły na konto?”
- „Kiedy Packeta przeleje pobranie z zamówienia numer X?”
- „Czy projekt reklamacji do Orlen Paczki dla tej przesyłki jest gotowy?”
Co się zmienia
Koordynator wysyłek zamiast logować się do trzech paneli rano dostaje jedno zestawienie: opóźnienia, nierozliczone pobrania i przesyłki do reklamacji.
Asystent działa na Waszym serwerze, na Waszych uprawnieniach. Każdy odczyt i każda akcja zostawiają ślad w logu. Program zostaje tam, gdzie jest, razem z historią danych i nawykami zespołu.
O programie
Orlen Paczka, Packeta i Pocztex to trzy odrębne platformy kurierskie z osobnymi panelami, cennikami i cyklami rozliczeniowymi. Orlen Paczka obsługuje punkty odbioru w sieci ORLEN i Ruch w Polsce. Packeta, działająca wcześniej pod nazwą Zásilkovna, specjalizuje się w rynkach Czech, Słowacji i Węgier z siecią punktów Packeta Box i Z-Box. Pocztex to usługa kurierska Poczty Polskiej dla klientów biznesowych z umową.
Każdy z przewoźników trzyma dane inaczej: statusy i etykiety dostępne przez REST API Orlen Paczki i Packety, pełne dane Pocztexu przez platformę EPP w trybie SOAP i REST. Rozliczenia pobrań Orlen Paczki trafiają do plików CSV i XLSX pobieranych z panelu klienta, nie przez API. Firma wysyłająca do Polski, Czech i Węgier naraz prowadzi zazwyczaj trzy osobne logowania i ręcznie przepisuje statusy do arkusza.
Gdzie to działa najlepiej
Koordynator wysyłek
Wtorek rano. Paczka przez trzecią dobę z rzędu pokazuje IN_SORTATION_CENTER w Orlen Paczce. Koordynator nie sprawdzał panelu od wczoraj, a klient już napisał do obsługi z pytaniem o termin dostawy.
Z asystentem: Asystent oznaczył przesyłkę w nocy. Rano w zestawieniu jest numer, data zatrzymania i ostatnie zdarzenie. Koordynator reaguje bez wchodzenia do panelu i odpowiada klientowi w ciągu minuty.
Pracownik magazynu
Trzydzieści nadań w jednym dniu: część przez Orlen Paczkę do polskich odbiorców, część przez Packetę do Czech i Słowacji, kilka przez Pocztex na Węgry. Do tej pory drukowanie etykiet z trzech paneli, po kolei, jedno po drugim.
Z asystentem: Asystent pobiera etykiety z API wszystkich trzech przewoźników i przygotowuje jeden zbiorczy plik do wydruku. Pracownik drukuje raz i pakuje bez przeskakiwania między zakładkami.
Właściciel sklepu
Koniec miesiąca. Packeta przelewa pobrania dwa razy w miesiącu, Orlen Paczka raz w tygodniu, Pocztex według osobnego harmonogramu. Księgowość widzi kwoty zbiorcze, ale nikt nie zestawił, które konkretne zamówienia zostały rozliczone.
Z asystentem: Asystent zestawia dane z getPaymentInstructions, raportów CSV Orlen Paczki i platformy EPP. Właściciel dostaje tabelę: zamówienie, oczekiwana kwota pobrania, status przelewu od przewoźnika.
Jak się łączymy
Orlen Paczka i Packeta działają przez REST API: klucz generujemy w panelu klienta Orlen Paczki (sekcja Integracje) i w panelu Packety jako API password. Pocztex łączymy przez platformę EPP z interfejsem SOAP, nowsze połączenia obsługuje też REST. Każde połączenie wymaga aktywnej umowy biznesowej z danym przewoźnikiem. Statusy pobieramy cyklicznie w trybie odczytu. Tworzenie przesyłek i nadań to zapis: asystent proponuje dane, pracownik zatwierdza.
Portal z plikami, bazami i historią rozmów stoi na serwerze klienta. Do modelu AI trafia polecenie i fragmenty potrzebne do odpowiedzi, bez trenowania cudzych modeli na danych klienta. Klucze API i API password przechowujemy zaszyfrowane, puste pole w formularzu znaczy bez zmian, a klucze nie trafiają do logów ani treści rozmów.
Czego potrzebujemy od Was
- Aktywne konto biznesowe z podpisaną umową u każdego z przewoźników: Orlen Paczka, Packeta, Pocztex
- Klucz API Orlen Paczki z sekcji Integracje w panelu klienta i API password z panelu Packety
- Dostęp do platformy EPP Pocztexu z uprawnieniami do API po stronie Poczty Polskiej
- Osoba w firmie do weryfikacji projektów reklamacji i zestawień pobrań przed wysłaniem
- System zamówień z polem kraj dostawy, waga, wymiary i oznaczenie, czy zamówienie jest pobraniem
Czego asystent nie robi
- Nie składa reklamacji samodzielnie: przygotowuje projekt pisma, opis szkody weryfikuje i wysyła pracownik
- Nie tworzy przesyłek bez potwierdzenia: proponuje dane nadania i przypisanie przewoźnika, decyzję podejmuje pracownik
- Nie sprawdza wyciągu bankowego: zestawia dane z raportów przewoźników, nie z faktycznych wpływów na konto firmy
- Nie ma dostępu do kart trasy kuriera, danych innych nadawców ani rozmów z klientami końcowymi przewoźnika
Częste pytania
Co się dzieje, gdy panel Orlen Paczki zmieni format pliku CSV z pobraniami?
Format pliku CSV z rozliczeniami może zmienić się przy aktualizacjach systemu Orlen Paczki. W takiej sytuacji skrypt przetwarzający raporty wymaga dostosowania. Budujemy go tak, żeby nagłówki kolumn były konfigurowalne, a zmiana formatu to aktualizacja skryptu, nie budowa od nowa.
Czy asystent obsługuje zwroty z zagranicy, gdy klient w Czechach odsyła paczkę?
Tak. Packeta oznacza przesyłki zwrotne flagą isReturn w odpowiedzi getPacketTracking. Asystent wykrywa zwrot i dopisuje go do osobnej listy z datą, numerem i nazwiskiem odbiorcy. Dalsze kroki: przyjęcie zwrotu do magazynu i ewentualny zwrot środków klientowi obsługuje pracownik po informacji od asystenta.
Jak szybko asystent wykrywa, że paczka utknęła w sortowni?
Statusy Orlen Paczki i Packety pobieramy co godzinę. Progi alarmowe, na przykład brak zmiany statusu przez 48 godzin, ustala firma. Przy Pocztexie częstotliwość zależy od ustawień połączenia z EPP. Oznaczona paczka trafia do raportu przy najbliższym odświeżeniu, nie czekamy do kolejnego dnia roboczego.
Czy można podłączyć tylko jednego z trzech przewoźników, bez pozostałych?
Tak. Każdy przewoźnik działa jako osobna integracja. Jeśli firma wysyła tylko przez Orlen Paczkę i Packetę, podłączamy te dwa API. Pocztex dodajemy później, gdy pojawi się potrzeba, bez przebudowy pozostałych połączeń. Zakres ustalamy przed wdrożeniem na podstawie tego, przez kogo firma faktycznie wysyła.
Jak zaczynamy
- Bezpłatna prezentacja. Mówicie, na czym pracujecie i co Was korkuje. Mówimy wprost, czy da się to spiąć, a jeśli nie ma czego automatyzować, też to powiemy.
- Do 2 tygodni testów. Dostęp do portalu tego samego dnia, podłączenie w trybie odczytu, sprawdzacie na własnych danych.
- Rozszerzanie. Kolejne moduły i akcje dokładamy, gdy zespół ufa temu, co dostaje. W abonamencie jest wdrożenie, integracja, szkolenie i opieka.
Inne programy: transport, spedycja i magazyn
Orlen Paczka, Packeta, Pocztex jest znakiem towarowym swojego właściciela. Nie jesteśmy z nim powiązani ani przez niego autoryzowani. Nazwy używamy wyłącznie po to, żeby wskazać, z jakim programem integrujemy asystenta.