Case study · Logistyka
Rozliczanie paczek z kurierami w firmie fulfillment
Firma fulfillment pakuje i wysyła zamówienia wielu sklepów internetowych, a każdego klienta rozlicza za wysłane paczki. Finanse liczyły je ręcznie co miesiąc. Zbudowaliśmy panel, który bierze paczki z BaseLinkera, sprawdza je z przesyłkami na kontach Apaczki i InPostu i pokazuje, co trzeba wyjaśnić, zanim pozycja trafi na fakturę.
- ok. 420 paczek dziennie
- ponad 140 kont kurierskich z BaseLinkera ze stanem weryfikacji
- ok. 96% zleceń z Apaczki z parą w pierwszym sprawdzeniu
Rozliczanie paczek w firmie fulfillment w skrócie
Rozliczanie paczek z kurierami w firmie fulfillment to liczenie, ile paczek wysłał każdy klient magazynu, i sprawdzanie tej liczby z przesyłkami, które widzi przewoźnik, zanim trafi ona na fakturę. W tym wdrożeniu liczbę paczek daje BaseLinker, a API Apaczki i InPost ShipX ją kontrolują: przesyłka łączy się z paczką tylko po numerze, a każda bez pary ma podany powód.
Klient.
Firma fulfillment (3PL), która pakuje i wysyła zamówienia wielu sklepów internetowych przez kilku przewoźników.
Cel.
Rozliczenie każdego klienta za paczki, a nie zamówienia, bez ręcznego liczenia i bez pozycji, których przewoźnik nie potwierdza.
Zakres.
Nocne pobieranie paczek i przesyłek, dopasowanie po numerze, weryfikacja kont kurierskich, rozliczenie per klient, harmonogramy rozliczeń.
Integracje.
BaseLinker API, InPost ShipX API, Apaczka API, Freshdesk, Make i n8n.
Przed i po wdrożeniu
Przed: Finanse liczą paczki klientów ręcznie co miesiąc
Po wdrożeniu: Liczba paczek per klient w panelu, za dowolny okres
Przed: Liczone zamówienia, choć zamówienie bywa w kilku paczkach
Po wdrożeniu: System liczy paczki, nie zamówienia
Przed: Nie wiadomo, czy przewoźnik widzi te same przesyłki
Po wdrożeniu: Przesyłki z kont Apaczki i InPostu porównane z paczkami z BaseLinkera
Przed: Anulowana etykieta może trafić na fakturę klienta
Po wdrożeniu: Anulowana etykieta przy paczce trafia do listy „Do sprawdzenia”
Przed: Paczka bez kodu klienta w BaseLinkerze nie należy do nikogo
Po wdrożeniu: Paczka bez klienta dostaje uwagę z podpowiedzią
Przed: Dane do rozliczenia przygotowywane ręcznie dla każdego klienta
Po wdrożeniu: Harmonogram klienta wysyła je do Make i n8n
BaseLinker mówi, ile paczek było. API przewoźników sprawdza, czy to się zgadza.
Jak działa system krok po kroku
Nocne pobranie paczek z BaseLinkera
O 02:00 system pobiera paczki zamówień w statusie „Wysłane” z ostatnich 45 dni, także zamówień niepotwierdzonych. Na ten czas wstrzymuje inne odpytywanie BaseLinkera, żeby nie przekroczyć limitu tokenu. Przerwany przebieg system ponawia, najpóźniej do 3 godzin po starcie.
Daty nadania i doręczenia
Z historii statusów przesyłek w BaseLinkerze system zapisuje datę nadania (pierwsze zdarzenie po utworzeniu etykiety) i datę doręczenia. Rozliczenie można liczyć po dacie zamówienia, nadania albo doręczenia.
Przesyłki z kont przewoźników
Zaraz potem pobiera przesyłki z kont Apaczki i InPost ShipX z ostatnich 14 dni: numer, usługę, status, gabaryt, wagę, wymiary i pobranie. Niepełne pobranie z InPostu kończy się błędem widocznym na ekranie.
Dopasowanie po numerze przesyłki
Przesyłka łączy się z paczką z BaseLinkera tylko po numerze, zapisanym wielkimi literami i bez spacji. Numer zamówienia z opisu przesyłki niczego nie przypina, tylko wyjaśnia, dlaczego pary brak.
Weryfikacja kont kurierskich
Każde konto kurierskie z BaseLinkera dostaje stan: Potwierdzone, Poza wglądem albo Częściowo. Przesyłki do wyjaśnienia trafiają do listy „Do sprawdzenia” z instrukcją przy każdej grupie.
Rozliczenie i wysyłka
Panel liczy paczki per klient i rodzaj przesyłki, z eksportem do Excela. Harmonogram każdego klienta wysyła dane okresu rozliczenia do scenariuszy w Make i n8n.
Co zespół finansów ma w panelu
Przesyłki.
Wszystkie paczki z wyszukiwarką po zamówieniu, numerze przesyłki, odbiorcy, zamawiającym, telefonie i e-mailu, także u przewoźnika.
Rozliczenie per klient.
Paczki klienta w okresie z podziałem na przewoźników i rodzaje przesyłek, z eksportem do Excela.
Paczki na umowach.
Przesyłki z kont firmy per klient, np. paczkomat A, B, C i kurier, z uwagą przy każdej przesyłce bez pary.
Weryfikacja przesyłek.
Stan każdego konta kurierskiego, werdykt dla okresu i lista „Do sprawdzenia” z instrukcją.
Harmonogramy.
Dzień rozliczenia każdego klienta, automat wysyłek, ręczna wysyłka z potwierdzeniem i historia.
Dostępy i dopasowania.
Klucze przewoźników tylko dla administratora oraz przypisanie magazynów, źródeł zamówień i firm z Freshdeska do klientów.
Integracje w tym wdrożeniu
BaseLinker API
Paczki zamówień, historia statusów przesyłek i kody klientów. Źródło liczby paczek. BaseLinker API →
InPost ShipX
Przesyłki z konta InPost z gabarytem A, B, C i liczbą paczek. Integracja InPost ShipX API →
Apaczka
Zlecenia z konta Apaczki z wagą, wymiarami i pobraniem, podpisane HMAC. Integracja Apaczka API →
Freshdesk
Firmy z Freshdeska przypisane do klientów, ID firmy w danych rozliczenia. Integracja Freshdesk →
Make i n8n
Dane okresu rozliczenia z harmonogramu klienta trafiają do scenariuszy. Make → n8n →
Django, Next.js i MySQL
Backend z nocnym harmonogramem, panel dla zespołu i baza paczek.
Wyzwanie: ile paczek wysłał każdy klient magazynu?
Firma fulfillment przyjmuje towar sklepów internetowych, pakuje ich zamówienia i wysyła je przez kilku przewoźników. Każdego klienta rozlicza co miesiąc za wysłane paczki. Jesienią 2026 r. wychodziło średnio ok. 420 paczek dziennie, a w bazie było ok. 155 tys. zamówień i ok. 71 tys. paczek.
Paczki szły przez konta firmy w Apaczce, InPoście i BL Paczce, ale też przez konta kurierskie samych klientów. Finanse liczyły paczki ręcznie, a nikt nie sprawdzał ich z tym, co widzi przewoźnik. Anulowana etykieta, zamówienie w kilku paczkach albo paczka bez kodu klienta mogły dać złą liczbę na fakturze.
Ten sam klient korzysta też z dashboardu magazynowego, który opisujemy osobno. Tu chodzi wyłącznie o rozliczenia paczek.
Rozwiązanie: BaseLinker jako źródło, przewoźnicy jako kontrola
Pierwsza decyzja: liczba paczek pochodzi z BaseLinkera, bo każde zamówienie tam jest, niezależnie od konta wysyłki. Liczenie tylko z kont przewoźników zaniżyłoby wynik o paczki z kont klientów. API Apaczki i InPost ShipX służą do kontroli i wykrywania braków.
Druga decyzja: przesyłka z konta przewoźnika łączy się z paczką tylko po numerze przesyłki. Każda przesyłka kończy z jednym wynikiem: dopasowana, anulowana u przewoźnika, zamówienie ma w BaseLinkerze inną etykietę, zamówienia nie ma w synchronizacji albo brak numeru zamówienia. Lepiej pokazać brak pary z powodem, niż zgadywać.
- Stan konta, nie paczki: konto kurierskie na umowie, którą widzą klucze API firmy, ma potwierdzone wszystkie paczki, a konto spoza kluczy żadnej. Panel pokazuje to jako Potwierdzone, Poza wglądem albo Częściowo.
- Gabaryty i rodzaje: paczkomat A, B, C i kurier z InPost ShipX, a dla paczkomatów zamawianych przez Apaczkę gabaryt z najmniejszego wymiaru.
- Podstawa daty: rozliczenie po dacie zamówienia, nadania albo doręczenia, z datami z historii statusów w BaseLinkerze.
- Harmonogramy: każdy klient ma dzień rozliczenia. Gdy kilku klientów ma ten sam dzień, pierwsza wysyłka idzie od razu, a kolejne co 15 minut. Archiwizacja klienta wyłącza jego harmonogramy.
- Dostępy: klucze przewoźników wpisuje administrator, a ich wartości nie wracają do przeglądarki.
Efekty wdrożenia
Panel zastąpił ręczne liczenie paczek przez finanse. Liczba paczek per klient jest dostępna za dowolny okres, z eksportem do Excela, a przesyłki, które wymagają wyjaśnienia, są zebrane w jednym miejscu.
- Apaczka: w pierwszym sprawdzeniu ok. 96% zleceń z dwóch tygodni miało parę po numerze. Każde z pozostałych miało powód, najczęściej anulowanie u przewoźnika.
- Konta kurierskie: ponad 140 kont z BaseLinkera dostało stan (październik 2026). 55 jest potwierdzonych w całości, 88 jest poza wglądem kluczy API firmy.
- Luka w synchronizacji: zamówienia niepotwierdzone w BaseLinkerze mogły mieć status „Wysłane” i etykietę, a domyślne pobieranie zamówień ich nie zwracało. Teraz synchronizacja pobiera je osobnym przebiegiem.
- Paczki bez klienta: niecały 1% paczek z 45 dni nie miało kodu klienta w BaseLinkerze. Teraz każda dostaje uwagę z podpowiedzią ze źródła zamówienia.
- Daty przewoźników: pierwszy przebieg uzupełnił daty nadania i doręczenia dla ok. 11 tys. paczek z 30 dni.
Dla kogo jest takie wdrożenie?
Podobny system sprawdza się w firmach fulfillment i 3PL, które rozliczają klientów za paczki, oraz w sklepach z wieloma kontami kurierskimi, które chcą wiedzieć, czy faktura przewoźnika zgadza się z wysyłkami. Więcej o tym obszarze przeczytasz na stronie automatyzacja magazynu i logistyki, a o pracy na koncie BaseLinkera na stronie wsparcie BaseLinker.
Chcesz rozliczać paczki bez ręcznego liczenia?
Napisz, czym zajmuje się Twoja firma i co chcesz usprawnić.
Wrócimy z konkretną propozycją, a nie z ogólną prezentacją.
Co dzieje się dalej
- Odpisujemy w ciągu 1 dnia roboczego.
- Umawiamy 30-minutową rozmowę.
- Przygotowujemy propozycję i wycenę.
Najczęstsze pytania
Jak rozliczyć klientów firmy fulfillment za wysłane paczki?
Najpewniej z systemu zamówień, sprawdzonego z danymi przewoźników. W tym wdrożeniu liczbę paczek per klient daje BaseLinker, bo każde zamówienie tam jest, niezależnie od konta wysyłki. API Apaczki i InPostu potwierdza paczki z kont firmy, a każda przesyłka bez pary trafia do listy „Do sprawdzenia” z powodem.
Dlaczego liczyć paczki, a nie zamówienia?
Bo jedno zamówienie może wyjść w kilku paczkach, a każda paczka to osobna przesyłka u przewoźnika i osobna pozycja w rozliczeniu. Liczenie zamówień zaniża wynik. Dlatego system zapisuje każdą paczkę z jej numerem przesyłki osobno.
Jak dopasować przesyłki kuriera do zamówień w BaseLinkerze?
Po numerze przesyłki, i tylko po nim. Numer z konta przewoźnika i numer paczki w BaseLinkerze zapisujemy wielkimi literami i bez spacji, a para powstaje, gdy są identyczne. Dopasowanie po numerze zamówienia z opisu, odbiorcy czy dacie odrzuciliśmy, bo może przypiąć obcą przesyłkę, a to oznacza błędną fakturę.
Co, jeśli klient magazynu wysyła przez własne konto kurierskie?
Wtedy jego paczki są w BaseLinkerze i liczą się w rozliczeniu, ale przewoźnik ich nie potwierdzi, bo firma nie ma dostępu do jego konta. Panel oznacza takie konto jako „Poza wglądem”: to brak dostępu, a nie błąd. Dopasowanie jest cechą konta, a nie pojedynczej paczki.
Skąd wiadomo, że pobrano wszystkie przesyłki z API przewoźnika?
Trzeba to sprawdzać przy każdym pobraniu. Przy InPost ShipX system porównuje liczbę pobranych przesyłek z liczbą, którą podaje API, i przy różnicy kończy pobieranie błędem widocznym w panelu. Przy Apaczce nauczyliśmy się tego na produkcji: lista zleceń nie była ułożona ściśle po dacie i pierwsza wersja pobrała 315 z 1170 przesyłek z dwóch tygodni. Teraz pobieranie kończy się dopiero na stronie, na której wszystkie zlecenia są starsze niż zakres.
Czy limit API BaseLinkera nie zablokuje takiego systemu?
Może, jeśli kilka procesów odpytuje ten sam token naraz. Dlatego nocne pobranie paczek wstrzymuje na swój czas inne zapytania do BaseLinkera we wszystkich procesach, a zadania dodatkowe, np. uzupełnianie danych wstecz, idą z niskim limitem zapytań na minutę. Gdy BaseLinker mimo to zablokuje token, system zapisuje blokadę i czeka do jej końca, zamiast ją przedłużać kolejnymi zapytaniami.
Czy podobny system zadziała w innym magazynie?
Tak, jeśli zamówienia i numery przesyłek są w jednym systemie, a przewoźnicy dają API. Zmieniają się źródła i reguły, np. kod klienta w zamówieniu, a schemat zostaje: paczki z systemu zamówień, kontrola u przewoźnika, rozliczenie per klient. Jeśli dopiero wybierasz system do magazynu, zobacz też Today FMS.

