Jak AI połączone z BDO pilnuje kart przekazania odpadów, ewidencji i sprawozdań rocznych?

AI podłączone do BDO może w czasie rzeczywistym sprawdzać status każdej Karty Przekazania Odpadów, zestawiać masy z dokumentami WZ i alarmować, gdy transport szykuje się do wyjazdu bez zatwierdzonej karty. Integracja jest możliwa przez oficjalne API BDO: klucz generuje użytkownik główny konta, uprawnienia nadaje się kontu technicznemu. Magazynier pyta asystenta AI o status karty przez telefon, a kierownik dostaje powiadomienie, zanim pojazd wyjedzie za bramę.

Co BDO przechowuje i jakie dane ma AI do dyspozycji

BDO to nie tylko rejestr podmiotów z numerem rejestrowym widocznym na fakturach. W codziennej pracy firmy pracuje tam kilka modułów: ewidencja odpadów z kartami KPO (Karta Przekazania Odpadów), KPOK (Karta Przekazania Odpadów Komunalnych) i KEO (Karta Ewidencji Odpadów), plus moduł sprawozdawczości rocznej.

Każda KPO zawiera konkretne pola: kod odpadu według katalogu (np. 15 01 06 dla zmieszanych opakowań, 12 01 01 dla wiórów żelaznych i stalowych), masę w Mg, dane przekazującego, przewoźnika i odbiorcy oraz status. Statusy są cztery: planowana, zatwierdzona, potwierdzenie przejęcia, potwierdzenie dostarczenia. Transport może wyjechać wyłącznie z kartą w statusie "zatwierdzona". To zasada, którą łatwo przeoczyć przy dużej rotacji transportów.

Przez API AI odczytuje:

• aktywne karty KPO z ich statusami i datami wystawienia
• masy odpadów przypisane do konkretnych kodów
• wpisy KEO z dowolnego okresu z ewidencji
• dane przewoźników i odbiorców podpiętych do kart
• kody odpadów z katalogu BDO
• terminy i okresy objęte sprawozdaniem rocznym

Czego API nie zwróci: danych rejestrowych zmienianych przez urząd, historii logowań ani dokumentów złożonych poza modułem ewidencji.

Jak wygląda podłączenie AI do BDO od strony technicznej

BDO udostępnia REST API. Dokumentacja jest dostępna w portalu BDO po zalogowaniu, bez konieczności kontaktu z urzędem. Żeby AI mogła z niego korzystać, potrzebne są trzy rzeczy.

Po pierwsze: konto w rejestrze BDO z rolą użytkownika głównego, czyli tzw. "Zarządzającego". Tylko ta rola może wygenerować klucz API i nadać uprawnienia osobnemu kontu technicznemu przeznaczonemu do integracji.

Po drugie: klucz API. Generuje się go z poziomu ustawień konta w portalu BDO. Klucz trafia do konfiguracji serwera, który obsługuje asystenta AI. Nie do arkusza, nie do skrzynki mailowej pracownika.

Po trzecie: zakres uprawnień przyznany kontu technicznemu. Można ograniczyć dostęp wyłącznie do odczytu albo dać uprawnienia do wystawiania i potwierdzania kart. Typowy zakres dla firmy produkcyjnej: odczyt kart KPO i wpisów KEO, potwierdzanie przejęcia po stronie odbiorcy, odczyt katalogu kodów.

Jedno ograniczenie: API BDO to interfejs do modułu ewidencji, nie do pełnego portalu. Złożenie sprawozdania rocznego przez API nie jest dziś standardową ścieżką. Sprawozdanie przygotowujemy z danych ewidencji, AI je zestawia i weryfikuje, ale zatwierdzenie i wysyłkę robi człowiek przez portal BDO lub kwalifikowany podpis elektroniczny.

Trzy miejsca, gdzie AI robi realną robotę każdego dnia

Pierwsze: status karty przed wyjazdem. U jednego klienta, firmy zajmującej się obróbką metali kolorowych, kierowca przed każdym wyjazdem pisał na grupowym czacie "czy karta jest zatwierdzona?". Ktoś z biura sprawdzał w BDO. Zdarzało się, że karta stała na statusie "planowana", a pojazd już wyjeżdżał. Po integracji magazynier wpisuje numer KPO albo numer zlecenia do asystenta i dostaje odpowiedź: aktualny status, masa, odbiorca, data ważności. Trwa to kilka sekund.

Drugie: zestawienie mas z dokumentami WZ. AI pobiera z BDO masę odpadów z kart KPO za dany miesiąc i zestawia z dokumentami WZ wystawionymi w tym samym czasie. Niezgodności, np. WZ na 2,4 Mg, a KPO potwierdza 2,1 Mg, trafiają do raportu dla osoby odpowiedzialnej za ewidencję. Zanim ktoś usiądzie do korekty, wie już, gdzie dokładnie szukać.

Trzecie: szkic sprawozdania rocznego. AI pobiera wszystkie wpisy KEO z danego roku, grupuje po kodach odpadów, zlicza masy, sprawdza, czy każda karta ma komplet statusów łącznie z "potwierdzeniem dostarczenia". Wynik to gotowy szkic do weryfikacji, nie dokument do złożenia od ręki. Osoba z uprawnieniami przegląda i zatwierdza, bo ona odpowiada prawnie. Czas przygotowania skraca się z kilku godzin do kilkudziesięciu minut.

Dzień kontroli WIOŚ: jak wygląda to przy kompletnej ewidencji

Inspektor WIOŚ (Wojewódzkiego Inspektoratu Ochrony Środowiska) przyjeżdża do firmy produkcyjno-transportowej. Pyta o ewidencję odpadów z ostatnich dwóch lat. W firmie bez integracji ktoś siada do portalu BDO, klika przez kolejne ekrany, wyciąga karty jedna po drugiej, liczy masy ręcznie, szuka potwierdzeń.

Przy działającej integracji kierownik produkcji mówi do asystenta: "Zestawienie kart KPO za 2024 i 2025 dla kodów z grupy 12 01 i 15 01, z informacją o kompletności statusów". AI odpytuje API, agreguje dane i zwraca zestawienie w kilkadziesiąt sekund: które karty mają wszystkie cztery statusy, które zatrzymały się na "zatwierdzona" bez potwierdzenia dostarczenia, jakie masy przypadają na poszczególne kody odpadów.

Inspektor pyta też o przewoźników. Czy mają aktywne numery rejestrowe BDO? Każda karta KPO zawiera numer BDO przewoźnika. AI sprawdza, czy numery z kart zgadzają się z wpisami w rejestrze. Odpowiedź jest natychmiastowa.

Firma nie boi się tej wizyty. Bo przez ostatnie dwa lata nie było transportu bez zatwierdzonej karty i nie ma niezgodności między ewidencją a dokumentami magazynowymi.

Faktury kontrahentów bez numeru BDO: błąd, który zwykle wychodzi za późno

Prawo nakłada obowiązek umieszczania numeru rejestrowego BDO na dokumentach sprzedaży przez podmioty wpisane do rejestru. Problem polega na tym, że faktury od kontrahentów sprawdza się zwykle dopiero wtedy, gdy ktoś zapyta. Albo podczas kontroli.

AI weryfikuje przy każdej fakturze od kontrahenta przewozowego lub zbierającego odpady, czy numer BDO widoczny na dokumencie istnieje i jest aktywny w rejestrze. Wystarczy dodać tę weryfikację do procesu przyjęcia faktury. Jeśli numer jest nieaktywny, brakuje go albo nie zgadza się z zakresem działalności w rejestrze, asystent oznacza fakturę do wyjaśnienia, zanim trafi do księgowości.

Typowo wygląda to tak, że przez kilka miesięcy wszystko gra, a potem do firmy wpada faktura od nowego podwykonawcy bez numeru BDO albo z numerem wygasłego wpisu. Bez automatycznej weryfikacji przechodzi przez system i pojawia się jako problem w dniu kontroli.

Od czego zaczynamy

Pierwszy krok: sprawdź, czy konto BDO Twojej firmy ma aktywną rolę "Zarządzający" i czy ktoś ma dostęp do ustawień konta w portalu. Bez tego nie wygenerujemy klucza API.

Drugi krok: krótka inwentaryzacja procesów. Ile kart KPO wystawia firma miesięcznie? Kto potwierdza odbiór po stronie odbiorcy? Kto sprawdza faktury od przewoźników przed przekazaniem do księgowości? Gdzie są niezgodności, które teraz wyjaśnia się telefonem lub mailem?

Na tej podstawie dopasowujemy zakres integracji: czy wystarczy odczyt i alerty, czy AI ma też potwierdzać przejęcie po stronie odbiorcy, czy włączamy weryfikację faktur. Resztą zajmujemy się my.

Umów się na bezpłatny audyt, żeby zobaczyć, jak to wygląda konkretnie dla Twojej firmy i jakie procesy mają sens jako pierwsze. Możesz też sprawdzić realne wdrożenia i zobaczyć, jak podobne integracje działają u innych firm produkcyjnych i transportowych.