Pobrania COD w integracjach - rozliczenia i uzgadnianie płatności

Technical Implementation Expert
Pobrania COD w integracjach - rozliczenia i uzgadnianie płatności
Pobrania COD w integracjach to dwa zadania: przekazanie przewoźnikowi poprawnej kwoty pobrania przy tworzeniu przesyłki i późniejsze dopasowanie przelewów od przewoźnika do zamówień w sklepie. Uzgadnianie płatności za pobraniem polega na tym, że każdy wpływ z pobrania zostaje przypisany do konkretnego zamówienia, a zamówienia bez wpływu po ustalonym terminie trafiają na listę do wyjaśnienia. Bez takiej automatyzacji sklep wie, ile paczek wysłał za pobraniem, ale nie wie, za które z nich naprawdę dostał pieniądze.
W tym wpisie pokazujemy, jak zaprojektować rozliczanie pobrań od strony integracji: skąd brać kwotę pobrania, jakie dane przewoźnika są potrzebne do uzgadniania, jak dopasowywać przelewy do zamówień i jak wychwytywać rozbieżności. Opieramy się na przykładzie InPost, ale zasady dotyczą każdego przewoźnika i agregatora, który obsługuje pobrania.
[#wazne] W skrócie: przy pobraniach COD integracja musi wysłać do przewoźnika kwotę zgodną z aktualnym zamówieniem, zapisać numer przesyłki przy zamówieniu, a po doręczeniu dopasować przelew od przewoźnika do zamówienia po numerze przesyłki, referencji lub kwocie. Zamówienia bez wpływu po terminie wynikającym z regulaminu przewoźnika powinny trafiać na listę rozbieżności. Programiści Vinson budują takie rozliczenia w sklepach, integratorach i połączeniach z systemami księgowymi.
Czym jest uzgadnianie pobrań COD w integracjach sklepu
Pobranie (ang. cash on delivery, COD) to usługa, w której przewoźnik przyjmuje od odbiorcy zapłatę za towar przy odbiorze paczki i przekazuje ją sprzedawcy. Uzgadnianie pobrań to proces, w którym sklep porównuje kwoty, które powinien otrzymać, z tymi, które faktycznie wpłynęły, i oznacza każde zamówienie jako rozliczone, oczekujące albo rozbieżne. W małym sklepie robi się to ręcznie na podstawie wyciągu z banku. Przy kilkuset przesyłkach za pobraniem miesięcznie ręczne porównywanie zajmuje godziny i łatwo w nim o pomyłkę.
Od strony integracji cykl pobrania zaczyna się w momencie tworzenia przesyłki, a kończy dopiero wtedy, gdy przelew zostanie dopasowany do zamówienia, a zamówienie zaksięgowane jako opłacone. Pomiędzy tymi punktami jest kilka dni, w których pieniądze są u przewoźnika. Poniżej pełny cykl.
[#chart:wpr70a]
Każdy z tych kroków powinien zostawiać ślad w zamówieniu: kwotę pobrania wysłaną do przewoźnika, numer przesyłki, datę doręczenia, datę i kwotę wpływu oraz status rozliczenia. Dopiero komplet tych danych pozwala zautomatyzować uzgadnianie i odpowiedzieć na pytanie klienta lub księgowej bez przeszukiwania kilku systemów.
Jak przewoźnik rozlicza pobrania - terminy, limity i opłaty
Zasady przekazywania pobrań określa regulamin przewoźnika i umowa. Na przykład InPost na swojej stronie o pobraniach podaje, że pieniądze trafiają na konto nadawcy w ciągu 5 dni roboczych od opłacenia przesyłki przez odbiorcę, a w praktyce często w ciągu dwóch dni. Ta sama strona wskazuje, że odbiorca może zapłacić w paczkomacie przez Pay by Link lub BLIK, a kurierowi gotówką lub BLIK-iem. Maksymalna kwota pobrania dla usług Allegro miniKurier24 i Kurier24 InPost to według tej strony 5 000 zł, a dopłata za pobranie wynosi 3,61 zł dla Paczkomatu 24/7 InPost i 2,50 zł dla usług Allegro miniKurier24 i Kurier24 InPost (stan na październik 2026 - sprawdź aktualny cennik i regulamin InPost).
Dla integracji ważniejsze od samych stawek jest to, jak wyglądają przelewy. Przed zaprojektowaniem uzgadniania trzeba ustalić u każdego przewoźnika lub agregatora kilka rzeczy:
| Element rozliczenia | Co sprawdzić | Znaczenie dla integracji |
|---|---|---|
| Termin przekazania | Ile dni roboczych od doręczenia lub zapłaty | Po tym czasie brak wpływu to rozbieżność |
| Forma przelewu | Jeden przelew na przesyłkę czy przelew zbiorczy | Przelew zbiorczy wymaga specyfikacji |
| Tytuł przelewu | Czy zawiera numer przesyłki lub referencję | Główny klucz do dopasowania |
| Specyfikacja | Plik lub raport z listą przesyłek w przelewie | Źródło danych dla przelewów zbiorczych |
| Limit kwoty | Maksymalne pobranie dla usługi | Reguła blokująca zbyt wysokie pobrania |
| Opłaty | Dopłata za pobranie i sposób jej pobierania | Wpływ może być niższy niż kwota pobrania |
Ostatni wiersz bywa źródłem fałszywych rozbieżności. Jeśli przewoźnik potrąca opłaty z przekazywanej kwoty, a nie fakturuje ich osobno, wpływ będzie niższy niż kwota pobrania i prosty algorytm uzna każde takie zamówienie za niedopłacone. Sposób rozliczania opłat trzeba więc sprawdzić w umowie i odwzorować w regułach uzgadniania.
- Wycena zadania w 24 h w dni robocze
- Integracje, API, feedy i poprawki w sklepie
- Rozliczenie godzinowe albo za projekt
Konsultację poprowadzi Łukasz Palej, Technical Implementation Expert

Łukasz Palej
Technical Implementation Expert
Wsparcie programistyczne dla e-commerce
Łukasz i nasz zespół pomogą Ci wdrożyć to na Twoim koncie - bez zobowiązań.
- Analiza Twojego konta i obecnych działań
- Konkretny plan poprawek do wdrożenia
- Bezpłatna konsultacja – bez zobowiązań

Przeczytaj także
Więcej porad z naszej bazy wiedzy - przesuń, aby zobaczyć kolejne artykuły.
Wybierz dogodny termin w kalendarzu - bez wymiany maili w tę i z powrotem.
