Jak wystawiać karty przekazania odpadów z własnej aplikacji przez API BDO — co zintegrować, gdzie testować i ile to kosztuje?

Kto musi wystawiać kartę przekazania odpadów?

Obowiązek ma każdy posiadacz odpadów, który przekazuje je następnemu posiadaczowi — kartę sporządza przed rozpoczęciem transportu. Od 1 stycznia 2025 r. ewidencję prowadzi się dla wszystkich odpadów niebezpiecznych, bez względu na ich ilość. Wytwórcy odpadów komunalnych i rolnicy gospodarujący poniżej 75 ha użytków rolnych ewidencji nie prowadzą, o ile nie podlegają wpisowi do rejestru.

Podstawa: ustawa z dnia 14 grudnia 2012 r. o odpadach, artykuły 66, 67 i 69 (tekst jednolity: Dz.U. 2023 poz. 1587).

Druga podstawa: rozporządzenie Ministra Klimatu i Środowiska z dnia 5 listopada 2024 r. w sprawie rodzajów i ilości odpadów, dla których nie ma obowiązku prowadzenia ewidencji odpadów (Dz.U. 2024 poz. 1644, obowiązuje od 1 stycznia 2025 r.).

Za nieprowadzenie ewidencji albo prowadzenie jej nieterminowo lub niezgodnie ze stanem rzeczywistym grozi administracyjna kara pieniężna nie mniejsza niż 1000 zł i nie wyższa niż 1 000 000 zł (art. 194 tej samej ustawy). Dla projektu aplikacji ważniejsze od widełek jest słowo „nieterminowo”: kolejka wysyłek „na koniec dnia” tworzy naruszenie, nawet gdy dane są poprawne.

Ilu firm w danej branży ten obowiązek realnie dotyczy — liczy inny serwis. Kalendarz pozostałych terminów regulacyjnych prowadzi jego dział terminów.

Jak wygląda interfejs Modułu Integracyjnego BDO?

Specyfikacja środowiska testowego to OpenAPI 3.0.1 z 199 ścieżkami, 250 operacjami i 487 schematami danych w 16 grupach. Grupa „Kpo” ma 18 operacji, grupa „Kpok” — 21 (odczyt pliku swagger.json 10 września 2026).

Mechanizm nazywa się Moduł Integracyjny API BDO i jest wykonany w technologii RESTful; udostępnia go wykonawca systemu, Instytut Ochrony Środowiska-PIB. Prace integracyjne leżą po stronie podmiotu albo producenta oprogramowania — dostawca API nie pisze kodu za integratora.

Uwierzytelnienie ma dwa kroki: operacja zwracająca listę miejsc prowadzenia działalności dla pary identyfikatora i sekretu, potem operacja wydająca token dla wskazanego miejsca. Token wraca z polem opisanym jako liczba sekund do wygaśnięcia, więc aplikacja musi go odnawiać sama.

Wersjonowanie widać w adresach: ścieżki w środowisku testowym mają segment „v1”. Klucze API generuje się w koncie w systemie BDO, wg instrukcji producenta w wersji 1.0 z 14 kwietnia 2023 r.

Godziny w ostatniej kolumnie to policzony scenariusz z sekcji niżej, nie cennik.

Co zmienia się w API od 1 stycznia 2027 roku?

Wykaz zmian dla KPO i KPOK ma 39 pozycji: 18 dla kart przekazania odpadów i 21 dla kart komunalnych. Przy 18 z nich w kolumnie opisu stoi „Zmiana adresu endpointu”, przy jednej „bez zmian”, a pięć pozycji ma kolumnę opisu pustą. Plik opublikowano 21 sierpnia 2026 r., aktualizacja pochodzi z 27 sierpnia 2026 r.

Zmiany nie sprowadzają się do adresów. Doszło 15 nowych nazw pól: sześć opisuje środek transportu, sześć powód odrzucenia karty, trzy powód jej wycofania. Statusy i rodzaje kart stają się typami wyliczeniowymi, a pole „rok” znika z wyszukiwarek kart.

Trzy z tych nazw sprawdziliśmy 10 września 2026 r. wprost w specyfikacji środowiska testowego — pola transportu drogowego, powodu odrzucenia z masy i powodu wycofania z pomyłki już tam są. Kod można więc napisać i przetestować przed terminem, a nie po nim.

Osobnym torem idzie sprawozdawczość: komunikat z 27 sierpnia 2026 r. zapowiada zmiany w publicznym API Modułu Sprawozdawczości i ostrzega, że adresy tej wersji mają w końcówce liczbę 2026.

Ile kosztuje dostęp do API i co trzeba zapłacić obok?

Dostęp kosztuje 0 zł: producent systemu pisze wprost, że korzystanie z API BDO nie jest obowiązkowe i jest udostępniane bezpłatnie wszystkim zainteresowanym podmiotom. Podmiot bez własnego oprogramowania prowadzi ewidencję przez przeglądarkę, w rejestrze BDO.

Obok API stoją opłaty rejestrowe, ale nie dotyczą wszystkich. Opłacie rejestrowej i rocznej podlegają wyłącznie przedsiębiorcy wprowadzający sprzęt elektryczny i elektroniczny, baterie lub akumulatory, pojazdy, opakowania, produkty w opakowaniach, opony oraz oleje smarowe.

Stawki wynoszą 200 zł dla mikroprzedsiębiorców i 800 zł dla pozostałych przedsiębiorców, i tyle samo wynosi opłata roczna. Obowiązują od 1 stycznia 2025 r. Opłaty rocznej nie wnosi się w roku, w którym uiszczono opłatę rejestrową.

Podstawa: rozporządzenie Ministra Klimatu i Środowiska z dnia 18 grudnia 2024 r. w sprawie wysokości stawek opłaty rejestrowej oraz opłaty rocznej (Dz.U. 2024 poz. 1901).

To rozróżnienie łatwo przeoczyć. Warsztat, który tylko wytwarza odpady niebezpieczne, jest w rejestrze BDO i wystawia KPO, ale opłaty rocznej nie płaci — moduł przypominający o niej wszystkim najemcom pokazywałby nieprawdę większości z nich.

Ile godzin kosztuje własna integracja i kiedy wygrywa z gotowcem?

W policzonym scenariuszu integracja zamyka się w 172 godzinach, czyli 25 800 zł netto. Zakres wynika z odczytu specyfikacji, a nie z przeczucia: 18 operacji w grupie KPO, 23 pola w żądaniu tworzącym kartę, siedem statusów karty w typie wyliczeniowym. Założenia stoją osobno, żeby dało się je podważyć.

• Założenie 1. Aplikacja obsługuje wytwórcę odpadów w roli przekazującego — nie transportującego i nie przejmującego.
• Założenie 2. Godzina pracy kosztuje 150 zł netto. Publicznego cennika stawek godzinowych integratorów BDO nie znaleźliśmy na dzień 10 września 2026 — to jawne założenie, nie stawka rynkowa.
• Założenie 3. Po wdrożeniu warstwa integracji zjada 2 godziny miesięcznie, czyli 24 godziny rocznie.

Po drugiej stronie stoi gotowiec kupowany osobno dla każdego podmiotu. W cenniku eBDO.pl moduł KPO to 220 zł netto rocznie na miejsce prowadzenia działalności, a pakiet startowy 330 zł netto jednorazowo (odczyt 10 września 2026) — rok pierwszy dla jednego podmiotu kosztuje 550 zł netto.

Próg wychodzi z prostego dzielenia: 25 800 zł podzielone przez 550 zł to 46,9, więc własna integracja zaczyna się bronić od 47 obsługiwanych podmiotów. Poniżej tej liczby gotowiec jest tańszy i nie ma z czym dyskutować.

Ten rachunek obejmuje wyłącznie warstwę integracji. Miesięczny koszt działania samej aplikacji przy 50 płacących firmach liczy osobny artykuł tego serwisu, a koszt zbudowania aplikacji — rachunek na policzpomysl.pl.

Co już jest na rynku z integracją BDO?

10 września 2026 r. sprawdziliśmy cztery polskie produkty deklarujące integrację z BDO. Trzy mają publiczny cennik na stronie producenta, czwarty opisuje model rozliczenia słowami, bez kwoty. Nie sprzedajemy żadnego z porównywanych systemów i nie ma tu linków afiliacyjnych.

Przegląd obejmuje podmioty trzecie; wydawcy tego serwisu nie oceniamy (patrz stopka). Wszystkie cztery pozycje to materiały sprzedawców usług — deklaracja integracji pochodzi od producenta, nie z niezależnego testu.

Gotowiec wygrywa w trzech sytuacjach: gdy obsługiwanych podmiotów jest mniej niż 47, gdy ewidencja jest jedyną potrzebną funkcją i gdy nikt nie chce brać na siebie dostosowania kodu do zmian z 1 stycznia 2027 r. Ta sama logika w innej kategorii oprogramowania — rezerwacje w salonie.

Jakie błędy powtarzają się w integracjach i gdzie leży granica licencyjna?

Sześć pułapek wynika wprost z dokumentacji i bazy wiedzy producenta systemu, odczytanych 10 września 2026 r. Każda kosztuje później poprawki, a dwie potrafią wywrócić projekt danych.

• Odpytywanie słownika kodów przy każdej karcie. Dokumentacja prosi wprost o zapisanie pobranej listy kodów odpadów w lokalnej bazie i korzystanie z tej metody możliwie rzadko.
• Poleganie na schemacie zamiast na walidacji serwera. W żądaniu tworzącym KPO żadne z 23 pól nie jest oznaczone jako wymagane, więc komplet reguł zna dopiero odpowiedź systemu.
• Poprawianie masy po potwierdzeniu przejęcia. Masę zmienia wystawca, gdy karta ma status „planowana”, „zatwierdzona” albo „odrzucona”; przy złej masie przejmujący ma odrzucić kartę z podaniem przyczyny.
• Zbiorcza karta za miesiąc. Nie ma takiej możliwości od 1 stycznia 2020 r., gdy uchylono art. 69 ust. 5 ustawy o odpadach.
• Pomijanie przewozu między własnymi magazynami. Kartę wystawia się także wtedy — wskazują na to art. 69 oraz art. 71a ustawy o odpadach.
• Brak trybu awarii. Przy awarii systemu dokumenty powstają poza BDO, kierowca wozi kartę papierową, a dane wprowadza się do bazy niezwłocznie po ustaniu awarii, nie później niż w 30 dni (art. 67 ust. 7, 9 i 11 ustawy o odpadach).

Granica licencyjna jest krótka i twarda. Klucze API generuje podmiot we własnym koncie w systemie BDO, a token dostępowy wydawany jest na wskazane miejsce prowadzenia działalności — jedna aplikacja nie trzyma jednego klucza dla wszystkich najemców.

Wyjątek producent opisuje wąsko: klucze dla organizacji i podmiotów pośredniczących mają im umożliwić składanie sprawozdań za podmioty, dla których są do tego zobowiązane.

Jest też granica, której API nie przesunie. Kierujący środkiem transportu ma obowiązek posiadać w trakcie transportu potwierdzenie wygenerowane z bazy (art. 69 ustawy o odpadach). Aplikacja musi więc umieć oddać kierowcy dokument, nie tylko wysłać dane.