API BDO od 1 stycznia 2027: ewidencja KPO, która nie padnie na starym endpoincie
21 sierpnia 2026 r. IOŚ–PIB ogłosił na bdo.mos.gov.pl zmiany API KPO i KPOK od 1 stycznia 2027 r.: endpointy, enumy statusów, pole roku, środki transportu, powody odrzucenia. Dzień wcześniej zapowiedziano serwis BDO.gov 25 sierpnia 19:00–22:00. Firma wywożąca odpady nie potrzebuje slajdu o GOZ. Potrzebuje mostu ze zlecenia do urzędu, który przeżyje nowy kontrakt HTTP.
21 sierpnia 2026 r. Instytut Ochrony Środowiska – PIB opublikował na bdo.mos.gov.pl informację dla integratorów API BDO: od 1 stycznia 2027 r. zmienia się API obsługi Kart Przekazania Odpadów (KPO) i Kart Przekazania Odpadów Komunalnych (KPOK). To nie jest „kolejny webinar o ewidencji”. To jest zmiana adresów części endpointów, nowych endpointów, struktur danych, statusów kart jako typów wyliczeniowych, pola rok w wybranych operacjach oraz nowych pól o środkach transportu i powodach odrzucenia albo wycofania karty. Jeśli Wasza ewidencja KPO przy nowym API BDO siedzi w skrypcie sprzed trzech lat, 1 stycznia nie będzie „aktualizacją abonamentu”. Będzie cichym dniem, w którym karta nie wyjdzie, a auto z gruzem już stoi pod bramą.
Dzień wcześniej, 20 sierpnia 2026 r., ten sam serwis zapowiedział prace serwisowe 25 sierpnia 2026 r. w godz. 19:00–22:00. Trzy godziny, w których dostęp do BDO.gov może być utrudniony. To jest najlepszy argument, jakiego nie kupicie od sprzedawcy „chmury odpadów”: BDO.gov nie jest Waszym panelem operacyjnym. Jest urzędem. Urząd ma okno serwisowe. Wy macie zmianę na budowie, która kończy się o 20:30 i kierowcę, który nie poczeka na komunikat IOŚ. Ewidencja KPO przy nowym API BDO musi umieć pracować obok urzędu: kolejka, szkic karty, zdjęcie, masa, kod — i wysyłka, gdy API wróci. Nie zamiast BDO.gov. Obok.
Ten tekst nie zastępuje artykułu o BDO i ewidencji odpadów w firmie. Tam jest KPO, KEO i panel, który nie kłamie przy WIOŚ. Tutaj dokładamy warstwę, której komunikat z 21 sierpnia nie zostawia w spokoju: czy Wasza integracja przeżyje 1 stycznia 2027 r., gdy endpoint, enum statusu i pole transportu przestaną wyglądać jak w 2025. GESOFT — Paweł Matusiak, Laravel, Vue, Android — buduje taki panel, gdy Excel, gotowy „moduł BDO” i trzy loginy do BDO.gov nie spinają budowy, serwisu terenowego i komunalki. Jeśli integrator z pudełka Wam wystarczy i ma harmonogram do nowego API — zostańcie przy nim. Napiszemy to wprost na kontakt.
Nie zmyślamy taryfikatora WIOŚ i nie obiecujemy, że aplikacja „wystawi KPO za Was, gdy BDO.gov leży”. Nie zastępujemy BDO.gov, WIOŚ, marszałka, księgowości ani KSeF. Nie palimy działającego integratora, jeśli on już trzyma jedną prawdę o karcie i zdąży na 1 stycznia. Piszecie na kontakt: ile miejsc wytwarzania, czy budowa / serwis / komunalka, jaki integrator albo Excel dziś żyje, czy macie API, czy ktoś klika ręcznie w przeglądarce. Oferta wraca w 24 godziny. Jeśli SaaS wystarczy — napiszemy to wprost. Jeśli model jest nietypowy (trzy spółki, jeden pojazd, kody z budowy i z warsztatu w jednym dniu) — mówimy, że potrzebujecie własnego panelu, nie kolejnego abonamentu z doliny.
Co komunikat z 21 sierpnia 2026 r. naprawdę mówi — i czego z tego nie wolno zmyślać
Aktualność ma datę 21 sierpnia 2026 r.. Adresat: integratorzy API BDO. Data cięcia: 1 stycznia 2027 r. Zakres: KPO i KPOK, nie „cały BDO”. Pełny tekst jest na stronie BDO. Komunikat nie mówi, że ewidencja papierowa wraca. Nie mówi, że KEO znika. Nie mówi, ile kart padnie 2 stycznia. Nie mówi, że WIOŚ odłoży kontrole. Kto w ofercie wpisze „obniżymy ryzyko kontroli o 80 procent”, sprzedaje pogodę. Wy kupujecie dossier: który endpoint, która struktura, które pole, który enum. Ewidencja KPO przy nowym API BDO zaczyna się od tej różnicy.
Lista zmian z komunikatu jest konkretna i krótka. Modyfikacje adresów części endpointów — nie wszystkich, części. Dodanie nowych endpointów. Zmiany w strukturach danych przekazywanych i zwracanych. Reprezentacja statusów kart jako typów wyliczeniowych. Zmiany dotyczące pola „rok” w wybranych operacjach. Statusy kart, rodzaje kart i nazwy kolumn sortowania jako enumy. Nowe pola związane m.in. ze środkami transportu oraz powodami odrzucenia i wycofania karty. Szczegółowy wykaz jest w załączonym Excelu: Zmiany-API-ewidencja.xlsx. Środowisko testowe: test-bdo.mos.gov.pl/api/swagger. To są fakty. Reszta — „ile dni trwa migracja w typowej firmie” — nie jest faktem. Nie dopisujemy jej.
Prośba IOŚ do integratorów jest równie krótka: zapoznać się z dokumentacją i dostosować systemy przed 1 stycznia 2027 r. Po tym terminie integracje mają korzystać z API zgodnie z nową specyfikacją. Nie ma w komunikacie vacatio na „pierwszy kwartał, jak się uda”. Nie ma „stary endpoint zostanie do czerwca”. Jeśli Wasz dostawca mówi „zrobimy to w lutym, BDO pewnie da slak”, cytujcie mu datę z komunikatu, nie slajd. Panel KPO przy zmianie API BDO albo ma okno testowe w kalendarzu jesieni 2026, albo jest obietnicą. Obietnica nie wywozi gruzu.
- Źródło: komunikat IOŚ–PIB z 21 sierpnia 2026 r. na bdo.mos.gov.pl, adresowany do integratorów API.
- Cięcie: 1 stycznia 2027 r. — po tej dacie integracje mają iść nową specyfikacją.
- Zakres API: Karty Przekazania Odpadów (KPO) oraz Karty Przekazania Odpadów Komunalnych (KPOK).
- Zmiany: adresy części endpointów, nowe endpointy, struktury request/response, enumy statusów, rodzajów kart i kolumn sortowania, pole „rok”, nowe pola transportu oraz powodów odrzucenia i wycofania.
- Załącznik: plik Excel ze szczegółowym wykazem metod i adresów.
- Test: https://test-bdo.mos.gov.pl/api/swagger/index.html
- Komunikat nie podaje kar WIOŚ, liczby kart ani daty wyłączenia starych endpointów „dla spóźnionych” — nie dopisujemy tego.
- Dzień wcześniej (20 sierpnia) zapowiedziano serwis BDO.gov 25 sierpnia 2026 r., godz. 19:00–22:00.
Te fakty cytujemy z komunikatu. Nie dodajemy „średniego czasu wystawienia KPO w gminie”, „odsetka kart odrzuconych w sierpniu” ani „ile integratorów zdąży”. Tego IOŚ nie napisał. Klimat sierpnia 2026 r. dopowiada coś innego, też z tego serwisu: okno serwisowe we wtorek wieczór i, 17 sierpnia, informacja o rejestracji podmiotów zagranicznych po 12 sierpnia. To są trzy różne reżimy w jednym tygodniu: API, dostępność urzędu, ROP/PPWR. Ewidencja KPO przy nowym API BDO nie załatwia ROP. Nie udaje, że jeden kafelek spina rozporządzenie bateryjne z wywozem gruzu. Rozdziela karty.
25 sierpnia, 19:00–22:00: serwis, który pokazuje, że BDO.gov nie wozi za Was gruzu
Komunikat z 20 sierpnia 2026 r. jest krótki jak kartka na drzwiach urzędu: 25 sierpnia 2026 r., godz. 19:00–22:00, prace związane z utrzymaniem i aktualizacją infrastruktury, możliwe przejściowe utrudnienia, prośba o uwzględnienie terminu w planowaniu pracy. Nie ma w nim obietnicy „system na pewno działa od 22:01”. Nie ma listy endpointów, które padną. Jest okno. Jeśli Wasza zmiana na budowie kończy się o 20:00 i kierowca ma wywieźć 17 05 04, a jedyna ścieżka to klik w BDO.gov, stajecie. To nie jest awaria integratora. To jest brak kolejki po Waszej stronie.
Panel operacyjny nie „omija BDO”. Kolejkuje. Szkic karty, masa, kod, miejsce wytwarzania, pojazd, odbiorca — to żyje u Was, gdy urząd ma okno. Wysyłka idzie, gdy API odpowiada. Jeśli API nie odpowiada, kierowca widzi status szkic, czeka na urząd, nie zielony „wysłane”, bo ktoś wbił to w Excelu z nadzieją. Kłamstwo „wysłane” w serwisie jest gorsze niż czerwony status. Czerwony status da się wyjaśnić inspektorowi. Zielony bez numeru w BDO.gov — nie. Ewidencja KPO przy nowym API BDO uczy się tego na oknie sierpniowym, zanim 1 stycznia zmieni kontrakt z endpointem.
To samo okno jest testem Waszego grafiku, nie tylko API. Jeśli jedyna osoba z loginem do BDO.gov wychodzi o 16:00, a serwis jest wieczorem, nie macie procedury. Macie nadzieję, że „jakoś wejdzie rano”. Rano auto już wyjechało albo stoi drugi dzień. Android w kabinie, z loginem operatora a nie księgowej, jest tańszy niż drugi dzień postoju. Nie zastępuje urzędu. Daje szkic i zdjęcie, gdy urząd śpi. Mechanizm zlecenia w terenie opisujemy też przy aplikacji dla serwisu terenowego — inna branża, ten sam problem: urząd nie pracuje w rytmie Waszej zmiany.
Nie obiecujemy, że GESOFT „utrzyma BDO.gov w czasie serwisu”. Nikt tego nie utrzyma, bo to nie jest Wasz serwer. Obiecujemy kolejkę i status, którego nie wstydzicie się przy kontroli. Jeśli Wasz obecny integrator już to ma — zostańcie. Pytanie na kontakt może brzmieć: „czy nasz gotowiec kolejkuje na okno 25 sierpnia”. Czasem odpowiedź brzmi: tak, nie piszcie kodu. To jest pełnowartościowa oferta. Lepiej usłyszeć ją we wrześniu 2026 niż 2 stycznia, gdy nowy endpoint nie przyjmie starego JSON-a, a serwis z sierpnia już zdążyliście zapomnieć.
17 sierpnia: zagraniczny wprowadzający, PPWR i przedstawiciel — inny reżim, ten sam rejestr
17 sierpnia 2026 r. na bdo.mos.gov.pl ukazała się informacja o rejestracji podmiotów zagranicznych. Wnioski o wpis do Rejestru BDO składane przez podmioty zagraniczne wprowadzające produkty w opakowaniach oraz baterie, złożone po 12 sierpnia 2026 r., będą rozpatrywane z uwzględnieniem obowiązku ustanowienia upoważnionego przedstawiciela do spraw ROP, w przypadkach z prawa UE. Źródło komunikatu: Urząd Marszałkowski Województwa Mazowieckiego. To nie jest KPO. To jest rejestr. Mieszanie rejestru ROP z kartą wywozu gruzu w jednym Excelu jest tym, za co potem płacicie kontrolą, która nie wie, który wiersz oglądać.
Komunikat wskazuje dwie podstawy: art. 56 ust. 3 rozporządzenia Parlamentu Europejskiego i Rady (UE) 2023/1542 z 12 lipca 2023 r. w sprawie baterii oraz art. 45 ust. 3 rozporządzenia (UE) 2025/40 z 19 grudnia 2024 r. w sprawie opakowań i odpadów opakowaniowych (PPWR). Ustanowienie przedstawiciela — w drodze pisemnego upoważnienia. Wniosek o wpis albo wniosek aktualizacyjny, gdy obowiązek istnieje, składa przedstawiciel. Nie dopisujemy, kogo dokładnie obejmuje art. 3 ust. 1 pkt 15 lit. c i d PPWR „na oko”. Czytacie rozporządzenie i kancelarię. Panel trzyma skan upoważnienia i datę. Nie zastępuje kancelarii.
Po co to w artykule o KPO? Bo w sierpniu 2026 r. ten sam portal BDO mówi Wam trzy rzeczy w cztery dni: API od 2027, serwis we wtorek, ROP po 12 sierpnia. Firma, która „ma BDO” jako jeden folder na dysku, zgubi różnicę. Ewidencja KPO przy nowym API BDO jest warstwą wywozu. Rejestr ROP jest warstwą wprowadzania. Jeśli wprowadzacie opakowania i wywozicie gruz, macie dwa dossier. GESOFT nie spina ich w „ESG dashboard”. Spinamy wywóz z API, które się zmienia. ROP zostawiamy kancelarii i wnioskowi w rejestrze — chyba że sami prosicie o teczkę skanów przy CRM dla kancelarii, co jest innym produktem.
- Data komunikatu: 17 sierpnia 2026 r.; próg wniosków: po 12 sierpnia 2026 r.
- Adresat: podmioty zagraniczne wprowadzające produkty w opakowaniach oraz baterie.
- Obowiązek: upoważniony przedstawiciel ROP, gdy wymagają tego przepisy UE.
- Podstawy cytowane przez UMWM: art. 56 ust. 3 rozp. (UE) 2023/1542 (baterie); art. 45 ust. 3 rozp. (UE) 2025/40 (PPWR).
- Forma: pisemne upoważnienie; wniosek składa przedstawiciel.
- To nie jest zmiana API KPO z 21 sierpnia — nie mieszamy reżimów w jednym wierszu ewidencji.
Jeśli nie wprowadzacie opakowań ani baterii z zagranicy, ten rozdział zostawiacie kancelarii konkurencji. Zostaje Wam jedna lekcja: portal BDO.gov jest wspólną skrzynką wielu ustaw. Wasz panel nie może być kopią skrzynki. Musi być wycinkiem: wywóz, karta, pojazd, kod. Im ciaśniejszy wycinek, tym mniejsza szansa, że 1 stycznia 2027 r. zmiana enumu statusu KPO popsuje Wam wniosek ROP, którego ten endpoint w ogóle nie obsługuje. Ciasny wycinek to nie bieda. To świadomy wybór własnego oprogramowania zamiast kombajnu.
Petycja z 3 sierpnia: hałas o BDO, który nie jest specyfikacją API
3 sierpnia 2026 r. na gov.pl/klimat opublikowano petycję w sprawie zmian dotyczących systemu ROP, BDO i obciążeń mikroprzedsiębiorców, z przewidywanym terminem rozpatrzenia 3 listopada 2026 r. Cytujemy istnienie petycji i datę. Nie cytujemy jej jako obowiązującego prawa i nie zgadujemy, co resort odpowie. Panel nie implementuje petycji. Implementuje specyfikację API i kartę, którą WIOŚ może porównać z BDO.gov. Kto buduje roadmapę na petycji, buduje na hałasie. Hałas nie wywozi 17 01 01.
Co musi żyć u Was, a co zostaje w BDO.gov — podział, którego kombajn nie umie
BDO.gov jest rejestrem i ewidencją urzędową. Zostaje. Nie palimy go, nie „zastępujemy chmurą”, nie obiecujemy lustra, które zawsze jest szybsze niż urząd. U Was musi żyć to, czego urząd nie widzi w momencie decyzji na budowie: która ekipa, który kontener, która masa z wagi albo z szacunku, które zdjęcie pryzmy, kto zatwierdził, czy auto wolno wyjechać. Ewidencja KPO przy nowym API BDO jest mostem. Most ma dwa przyczółki. Jeden to karta w BDO.gov. Drugi to zlecenie w panelu. Kto buduje tylko przyczółek urzędowy, klika w przeglądarce i nie ma historii decyzji. Kto buduje tylko przyczółek zlecenia, ma ładne zdjęcia i zero numeru karty.
Integrator z pudełka często umie przyczółek urzędowy: wysłać KPO, pobrać status, pokazać listę. Słabnie na przyczółku zlecenia, gdy model nie jest „jedna spółka, jeden magazyn, jeden kod dziennie”. Budowa ma trzy place, jeden pojazd i kod, który zmienia się po południu, bo ktoś dołożył styropian do gruzu. Serwis terenowy ma olej przepracowany u klienta, nie w Waszej hali. Komunalka ma KPOK, nie KPO. Jeśli pudełko ma jedną kartę „odpad”, 1 stycznia 2027 r. dostanie nowy enum i nadal nie będzie wiedziało, które zlecenie to jest. Nowy endpoint nie naprawia modelu. Naprawia kontrakt HTTP.
Podział, którego bronimy: BDO.gov trzyma kartę i urzędowy status. Panel trzyma zlecenie, zasób, zdjęcie, masę, osobę i id karty po wysyłce. Księgowość trzyma fakturę za wywóz i — od 2026 r. — numer KSeF, jeśli ta faktura idzie przez KSeF. Trzy systemy. Jeden klucz: id zlecenia. Jeśli kluczem jest „nazwa budowy w uwagach”, zgubicie kartę przy zmianie API, bo uwagi nie są enumem. Komunikat z 21 sierpnia jest uprzejmy dla tych, którzy już mają id. Jest brutalny dla tych, którzy mają kolumnę „status (wpisz sam)”.
Nie migrujemy Was z BDO.gov do GESOFT. Nie da się. Nie wolno. Kto sprzedaje „nie musisz już wchodzić do BDO”, sprzedaje ryzyko. Wchodzicie, gdy trzeba: wniosek, opłata, sprawozdanie, korekta, której API Wam nie da. Panel ma Was odciążyć od codziennego klikania karty, nie od urzędu. To jest ta sama uczciwość, którą opisujemy przy oprogramowaniu dla firmy budowlanej: budowy, ekipy, obmiary — i osobno dokument, którego nie wolno udawać w CRM. KPO jest takim dokumentem.
KPO, KPOK, KEO: trzy dokumenty, trzy miejsca, w których stary skrypt pęknie
Komunikat z 21 sierpnia dotyczy KPO i KPOK. KEO — karta ewidencji odpadów — nie jest w tytule tej aktualności. Nie zgadujemy, czy KEO dostanie analogiczną zmianę „przy okazji”. Traktujemy zakres dosłownie. Jeśli integrator w ofercie napisze „zmieniamy całe BDO od 1 stycznia”, pytacie: gdzie to jest w Excelu IOŚ. Ewidencja KPO przy nowym API BDO rozdziela trzy dokumenty w modelu, nawet jeśli dziś klika je ta sama księgowa. KPO jest przekazaniem. KPOK jest przekazaniem komunalnym. KEO jest ewidencją posiadacza. Mieszanie ich w jednej tabeli „odpady” kończy się tym, że nowy endpoint KPOK nadpisuje Wam status KEO, bo kolumna nazywała się tak samo.
KPOK nie jest „KPO z dopiskiem gmina”. Inny dokument, inny endpoint (komunikat zapowiada zmiany dla obu), inny kontrahent, inny reżim. Firma, która wozi i gruz z budowy, i odpady komunalne z umowy z gminą, ma dwa strumienie. Jeden pojazd nie jest argumentem za jedną kartą. Jest argumentem za kartą zasobu i dwiema kartami dokumentu. Panel, który tego nie umie, 1 stycznia dostanie dwa zestawy enumów i jeden wiersz. Wiersz wygra z enumem. Przegracie z WIOŚ, bo w BDO.gov będą dwie historie, a u Was jedna.
KEO zostaje codzienną prawdą posiadacza: przyjęcie, wytworzenie, przekazanie, stan. Nie zastępujemy obowiązku ewidencji w BDO.gov. Doklejamy most: gdy KPO wychodzi, KEO po Waszej stronie wie, że to nie jest „wysłane w komunikatorze”. Wie, że jest id karty albo status błędu. Jeśli dziś KEO uzupełniacie ręcznie dzień później, zmiana API KPO i tak Was złapie — bo przekazanie bez spójnego id jest tym, co nowy enum statusu wyciągnie na wierzch. Nie jako kara. Jako odrzucenie karty, które komunikat właśnie dodaje jako pole.
- KPO — karta przekazania odpadów: komunikat z 21 sierpnia zmienia jej API od 1 stycznia 2027 r.
- KPOK — karta przekazania odpadów komunalnych: ten sam komunikat, osobny dokument, osobne endpointy.
- KEO — karta ewidencji odpadów: nie jest tytułem tej aktualności; nie zgadujemy analogicznej zmiany.
- Nowe pola komunikatu: środki transportu, powody odrzucenia i wycofania — to są pola karty przekazania, nie „uwagi do KEO”.
- Pole „rok” w wybranych operacjach: jeśli Wasz skrypt twardo wkleja rok z zegara serwera, sprawdzacie Excel IOŚ, nie przeczucie.
- Enum statusu zamiast dowolnego napisu: „wysłane?”, „OK”, „do poprawy” przestają być legalnym payloadem.
Jeśli prowadzicie tylko KEO w przeglądarce i KPO wystawia odbierający, ten rozdział i tak Was dotyczy. Nowy API po stronie odbierającego padnie na Waszym błędzie w masie albo kodzie, a powód odrzucenia wróci jako pole, którego dziś nie macie gdzie zapisać. Zapisujcie odrzucenie przy zleceniu, nie w głowie kierowcy. Kierowca za tydzień powie „jakoś poszło”. Pole z komunikatu 21 sierpnia jest po to, żeby „jakoś” miało nazwę.
Budowa, serwis terenowy, komunalka: kto jest wytwórcą, gdy umowa milczy
Ustawa o odpadach mówi wprost o usługach budowy, rozbiórki, remontu, czyszczenia zbiorników, sprzątania, konserwacji i napraw: wytwórcą jest podmiot świadczący usługę, chyba że umowa stanowi inaczej. To nie jest nowość z sierpnia 2026. To jest stały haczyk, na którym WIOŚ wiesza firmy, które „przecież to odpad klienta”. Ewidencja KPO przy nowym API BDO nie rozstrzyga sporu prawnego. Trzyma kto jest wytwórcą na tej karcie i skan aneksu, jeśli przerzucacie obowiązek. Brak aneksu plus karta na klienta, gdy to Wy kucie posadzkę — to nie jest integracja. To jest życzenie.
Na budowie haczyk boli podwójnie: wiele miejsc wytwarzania, podwykonawcy, kontenery „wspólne”, kod, który ktoś wpisuje z pamięci. Panel ekipy — ten sam, który liczy obmiar w oprogramowaniu dla firmy budowlanej — powinien wiedzieć, że wyjazd kontenera to zdarzenie odpadu, nie tylko koszt. Nie palimy programu budowy, jeśli on żyje. Doklejamy zdarzenie: miejsce, kod, masa, zdjęcie, czy wolno jechać. Wysyłka KPO może zostać w biurze. Decyzja „jedź / stój” musi być na bramie. Nowy enum statusu z API nie pomoże, jeśli brama dostała SMS-a „jedź, księgowa kliknie rano”.
Serwis terenowy: olej, filtry, zużyty sprzęt u klienta. Miejsce wytwarzania nie jest Waszą halą. Karta, która zawsze podstawia adres siedziby, kłamie w payloadzie, a nowa struktura API z 2027 r. nie jest od tego łagodniejsza. Android technika — jak w aplikacji dla serwisu terenowego — zbiera adres, zdjęcie i kod na miejscu. Biuro nie zgaduje po fakturze. Jeśli sprzątacie obiekty, ten sam mechanizm jest w aplikacji dla firmy sprzątającej: checklista, zdjęcie, odpad z obiektu. Nie mieszamy tego z KPOK gminy, chyba że naprawdę jesteście komunalką.
Komunalka i KPOK: umowa z gminą, inny dokument, inny endpoint. Jeśli woźcie i „budowlankę”, i komunalne, dwa profile w panelu. Jeden login kierowcy, dwa szablony karty. 1 stycznia 2027 r. oba szablony czytają nowy Excel IOŚ. Żaden nie dziedziczy pól po drugim „bo tak wygodniej”. Wygoda dziedziczenia jest tym, co psuje enum. Enum jest po to, żeby wygoda przestała być payloadem.
Android na budowie: zdjęcie, masa, kod, status — zanim API przyjmie kartę
Kierowca nie wypełnia Swaggera. Kierowca widzi: jedź, stój, zrób zdjęcie, podaj masę z wagi albo z deklu. Ewidencja KPO przy nowym API BDO po stronie Androida jest krótka, bo długa jest po stronie biura. Biuro mapuje enum, endpoint, rok, powód odrzucenia. Kabina mapuje zdarzenie. Jeśli dajecie kierowcy pełny formularz BDO.gov na telefonie, 25 sierpnia o 19:00 i tak staniecie, a 2 stycznia staniecie na polu, którego nie rozumie. Własny ekran z czterema polami przeżyje zmianę API, bo API zmieni się za ekranem, nie na nim.
Zdjęcie nie jest ozdobą. Jest dowodem, że 17 05 04 nie jest workiem z farbą. WIOŚ nie ma obowiązku uwierzyć Waszemu kodowi z pamięci. Zdjęcie z czasem, GPS (jeśli dajecie, z informacją dla załogi) i id zlecenia jest tańsze niż spór. Nie obiecujemy, że zdjęcie „zamyka kontrolę”. Obiecujemy, że macie plik. Retencja według Waszej polityki, nie naszej chmury „na zawsze”. To jest RODO w aplikacjach webowych plus zwykły porządek. Nie budujemy data lake’u z gruzu.
Masa: z wagi, z deklu, z szacunku — trzy jakości, trzy znaczniki. Nowa struktura API nie zwalnia Was z prawdy o masie. Jeśli dziś wklejacie 10 000 kg „bo kontener”, a waga pokazała coś innego, pole odrzucenia z 2027 r. będzie miało na to miejsce. Panel pokazuje rozjazd zanim wyślecie. To nie jest AI. To jest if. If jest tańszy niż korekta karty, której Moduł Potwierdzeń — według komunikatu BDO z 14 lipca 2026 r. — nie planuje dawać jako korekty dokumentów. Cytujemy ten komunikat ostrożnie: dotyczy Modułu Potwierdzeń, nie KPO. Lekcja jest ta sama: korekta bywa trudniejsza niż staranne pierwsze wysłanie.
- Kierowca otwiera zlecenie: miejsce, kod proponowany, czy wolno jechać.
- Zdjęcie pryzmy albo kontenera; znacznik czasu; opcjonalnie GPS po zgodzie i informacji.
- Masa: waga / dekiel / szacunek — osobny znacznik jakości, nie jedna komórka.
- Szkic karty idzie do kolejki biura; kabina widzi „szkic” albo „wysłane + id”, nigdy zielone bez id.
- Odrzucenie z API (nowe pole od 2027) wraca na to samo zlecenie, nie do grupowego czatu.
- Biuro mapuje enum i endpoint; kabina nie widzi Swaggera.
- W oknie serwisu BDO.gov (jak 25 sierpnia 19:00–22:00) szkic czeka; auto nie dostaje fałszywego „wysłane”.
- 2FA i osobny login operatora — księgowa nie pożycza hasła na bramę.
Środki transportu i powody odrzucenia: pola, których Excel „uwagi” nie przeżyje
Komunikat z 21 sierpnia wprost dopisuje nowe pola związane m.in. ze środkami transportu oraz powodami odrzucenia i wycofania karty. To jest zdanie, które zabija kolumnę „uwagi”. Uwagi są stringiem. Nowe API — skoro statusy, rodzaje kart i kolumny sortowania idą do enumów — nie jest miejscem, w którym „ tir / bus / jakoś” przeżyje walidację. Ewidencja KPO przy nowym API BDO musi mieć słownik środka transportu zgodny z Excelem IOŚ, nie z Waszymi przezwiskami aut. Przezwisko może zostać etykietą w panelu. Payload idzie słownikiem.
Powód odrzucenia jest prezentem, którego nie chcecie, dopóki pierwsza karta wróci. Dziś odrzucenie żyje w telefonie: „nie poszło, zrób jeszcze raz”. Jutro będzie polem. Pole da się raportować: ile kart, jaki powód, która ekipa, który kod. To nie jest KPI z doliny. To jest lista, którą pokazujecie szefowi budowy zamiast kłótni. GESOFT nie obiecuje spadku odrzuceń o procent, którego IOŚ nie podał. Obiecuje, że powód nie zginie w czacie. Jeśli Wasz integrator już zwraca powód i zapisuje go przy zleceniu — zostańcie. Pytacie o to na piśmie, zanim zapłacicie za „moduł 2027”.
Wycofanie karty jest osobnym zdarzeniem. Nie jest „usuń wiersz”. Wiersz usunięty w Excelu jest kłamstwem wobec BDO.gov, gdzie karta mogła już dostać numer. Panel oznacza wycofanie, trzyma id, trzyma powód, trzyma kto kliknął. Nowy API to ułatwi, bo sam prosi o pole. Wy utrudnicie to, jeśli dacie kasowanie bez roli. Rola „może wycofać” nie jest biurokracją. Jest tym, co zostaje po kontroli, gdy ktoś „tylko poprawił”.
Środek transportu spina się z kartą pojazdu w panelu floty albo budowy, nie z pamięcią dyspozytora. Jeśli auto pada i jedzie zastępstwo, karta musi umieć zmienić środek przed wysyłką. Po wysyłce jest wycofanie albo korekta w urzędzie, nie cicha podmiana w JSON-ie. Ta dyscyplina jest droższa niż kolumna. Jest tańsza niż dwie karty na ten sam kontener. Dwie karty to nie „dla pewności”. To jest bałagan, który nowy enum statusu pokaże obok siebie na liście.
Statusy jako enum: dlaczego „wysłane?” w komórce przestaje być payloadem
Komunikat powtarza to dwukrotnie, więc nie jest ozdobnikiem: reprezentacja statusów kart jako typów wyliczeniowych; oraz statusy kart, rodzaje kart i nazwy kolumn sortowania jako typy wyliczeniowe. IOŚ mówi integratorom: przestańcie zgadywać stringi. Ewidencja KPO przy nowym API BDO po Waszej stronie też przestaje zgadywać. Mapowanie: enum IOŚ → Wasz status operacyjny (szkic, w kolejce, przyjęte, odrzucone, wycofane). Żadnego „wysłane?”. Żadnego „OK”. Żadnego koloru w Excelu zamiast wartości. Kolor nie wejdzie w JSON.
Rodzaj karty jako enum rozdzieli KPO od KPOK lepiej niż dopisek w tytule zlecenia. Jeśli dziś filtrujecie listę przez `LIKE '%komunal%'`, 1 stycznia filtr padnie na kolumnie sortowania, która też idzie do enumu. To brzmi jak drobiazg dla programisty. Dla dyspozytora to jest lista, której nie umie posortować w piątek. Panel Vue pokazuje etykietę po polsku. API dostaje enum. Etykietę możecie zmienić. Enumu — nie, dopóki IOŚ nie wyda kolejnego Excela.
Pole „rok” w wybranych operacjach jest klasycznym miejscem, gdzie skrypt „działał trzy lata”. Twardy rok z `date('Y')` albo rok z karty, która żyje przez Sylwestra. Komunikat nie opisuje w tekście strony, co się zmienia w polu rok — odsyła do Excela. Zróbcie to: otwórzcie plik, znajdźcie operacje z „rok”, zapiszcie różnicę w zadaniu, nie w głowie. GESOFT nie zgaduje za IOŚ treści komórki. GESOFT wdraża to, co Excel mówi, i testuje na test-bdo.mos.gov.pl. Zgadywanie jest tańsze do grudnia. W styczniu jest droższe niż tydzień testów.
Jeśli nie macie programisty, i tak potrzebujecie kogoś, kto przeczyta Excel i zapyta integratora: które enumy zmieniacie, które endpointy, kiedy na teście. Odpowiedź „zrobimy aktualizację” bez listy jest odmową. Napiszcie to na kontakt — możemy być tą osobą, która czyta Excel i mówi „zostańcie przy nich, ale wymagajcie listy”, albo „oni nie zdążą, stawiamy warstwę”. Warstwa w Laravelu mapuje enum. Nie mapuje nadziei.
Harmonogram do 1 stycznia 2027: test-bdo, Excel, kto klika, kto koduje
Zostało — licząc od 22 sierpnia 2026 r. — cztery miesiące i trochę do cięcia. To nie jest „czasu jest dużo”. To jest sezon sprawozdań, KSeF, który już wszedł w 2026 r., e-Doręczenia dla CEIDG od 1 października 2026 r. i Święta, w których integratorzy znikają. Ewidencja KPO przy nowym API BDO dostaje własne zadanie w kalendarzu, nie „zrobimy po fakturach”. Kto wstawia to po 15 grudnia, ten testuje na produkcji 2 stycznia. Komunikat nie przewiduje środowiska „stary endpoint do marca”. Przewiduje nową specyfikację od 1 stycznia.
Test nie jest slajdem. Jest kontem na test-bdo.mos.gov.pl, zestawem kart KPO i KPOK, które odpowiadają Waszym kodom, i listą, która przechodzi: szkic, wysyłka, status, odrzucenie, wycofanie, środek transportu, rok. Jeśli integrator nie umie Wam dać logów z testu, nie umie Wam dać 1 stycznia. GESOFT w ofercie wpisuje to środowisko jako warunek, nie jako „miły dodatek”. Bez testu nie ma daty go-live. Jest data nadziei.
Podział ról: kto czyta Excel IOŚ (jedna osoba, imię). Kto trzyma słowniki kodów u Was. Kto ma login testowy. Kto akceptuje mapowanie enumów. Kto uczy kierowców, że ekran się nie zmieni, a statusy w biurze tak. Kto ma prawo wycofać kartę. To nie jest Scrum z doliny. To jest lista, bez której 2 stycznia wszyscy dzwonią do księgowej. Księgowa nie jest endpointem.
- Sierpień–wrzesień 2026: Excel IOŚ przeczytany, lista endpointów i enumów u Was na jednej stronie, pytanie do obecnego integratora z terminem odpowiedzi.
- Wrzesień: konto test-bdo, pierwsze KPO i pierwsze KPOK na Waszych kodach, nie na „przykładzie z dokumentacji”.
- Październik: mapowanie środków transportu i powodów odrzucenia; decyzja, czy pudełko zdąży, czy warstwa własna.
- Październik też: e-Doręczenia CEIDG od 1.10.2026 — osobny wątek, osobna skrzynka, nie mieszamy z KPO.
- Listopad: szkolenie biura z nowych statusów; Android bez zmian ekranu albo z jedną nową etykietą.
- Do 15 grudnia: test regresji (szkic, wysyłka, odrzucenie, wycofanie, okno „API nie odpowiada”).
- 1 stycznia 2027: nowa specyfikacja; stary skrypt nie jest planem B, jeśli komunikat nie zostawia starego API.
- Pierwszy tydzień stycznia: dyżur człowieka, nie bota, przy logach odrzuceń.
Jeśli po tej liście widzicie, że integrator milczy, piszecie do nas wcześniej niż 15 grudnia. Oferta w 24 h może brzmieć: „zostańcie, ale wyślijcie im tę checklistę” albo „stawiamy warstwę Laravel + Vue + Android obok, BDO.gov zostaje”. Nie stawiamy warstwy dla sportu. Stawiamy, gdy milczenie integratora jest droższe niż kod. Cennik zależy od liczby miejsc wytwarzania i od tego, czy KPO i KPOK naprawdę oba żyją — nie od hasła „AI w odpadach”. AI nie podpisze Wam enumu.
KSeF, e-Doręczenia i BDO: trzy urzędy, jedna firma, zero „jednego przycisku”
KSeF w 2026 r. już nie jest zapowiedzią z plakatu. Duży podatnik — od 1 lutego 2026 r. (sprzedaż 2024 powyżej 200 mln zł wraz z podatkiem). Szeroki obowiązek — od 1 kwietnia 2026 r. Numer KSeF nie wystawia KPO. Faktura za wywóz nie jest kartą przekazania. Panel może przypiąć numer KSeF do zlecenia wywozu, żebyście nie szukali w dwóch teczkach, ile kosztował ten kontener. Nie może zastąpić KSeF.gov. Szerszy rachunek: KSeF obowiązkowy w aplikacji firmowej. Mieszanie payloadu KSeF z payloadem BDO w jednym JSON-ie jest błędem, który 1 stycznia 2027 r. ukarze oba urzędy naraz.
e-Doręczenia: podmioty niepubliczne wpisane do KRS — obowiązek od 1 kwietnia 2025 r.; CEIDG — od 1 października 2026 r. Decyzja WIOŚ, wezwanie marszałka, korespondencja o rejestrze BDO nie powinny ginąć w skrzynce, której nikt nie otwiera, bo „odpady są w Excelu”. Panel odpadów nie jest skrzynką e-Doręczeń. Może trzymać id wiadomości i skan, gdy ktoś je włoży. Nie może udawać operatora wyznaczonego. Kto Wam sprzeda „wszystko w jednym inboxie: KSeF, BDO, e-Doręczenia, ZUS”, sprzedaje slajd. Slajd nie ma certyfikatu.
Biuro rachunkowe, które obsługuje Wasze KSeF, nie wystawi za Was KPO z budowy o 20:30. Możecie dać mu podgląd statusu karty, jeśli chcecie. Nie musicie. Podgląd to nie login księgowej do BDO.gov na telefonie kierowcy. Login na telefonie kierowcy jest dziurą, nie integracją. Oprogramowanie dla biura rachunkowego jest o portalu klienta i KSeF. Ten artykuł jest o wywozie. Dwa produkty. Jeden NIP nie jest powodem, żeby je spłaszczyć.
W praktyce spinka wygląda tak: zlecenie wywozu ma id. KPO ma id z BDO.gov, gdy wyjdzie. Faktura ma numer KSeF, gdy wyjdzie. Wezwanie ma id e-Doręczeń, gdy przyjdzie. Panel pokazuje trzy id przy zleceniu albo mówi wprost, że trzeciego nie trzyma. Brak trzeciego id jest uczciwszy niż fałszywe „odebrano”. Ewidencja KPO przy nowym API BDO odpowiada za pierwsze dwa w świecie odpadów. Trzecie zostawiacie kancelarii albo osobie od skrzynki. GESOFT może zbudować listę wezwań, jeśli o to poprosicie. Nie zbuduje jej „przy okazji KPO”, bo przy okazji wychodzi złe RODO i złe uprawnienia.
Kontrola WIOŚ: plik, który zgadza się z kartą w BDO.gov, nie z grupą na komunikatorze
Nie zmyślamy liczby kontroli ani średniej kary. Ustawa o odpadach przewiduje administracyjne kary pieniężne — wysokość liczycie z aktu i z decyzji, nie z bloga. Ten tekst nie jest taryfikatorem. Jest checklistą pliku. Inspektor porówna to, co macie na ekranie, z tym, co jest w BDO.gov. Jeśli u Was „wysłane”, a w urzędzie nic, przegrywacie w pierwszej minucie. Ewidencja KPO przy nowym API BDO istnieje po to, żeby ta minuta była nudna: id karty, status enum, masa, kod, środek transportu, kto kliknął.
Komunikator firmowy nie jest ewidencją. Zrzut „OK, jedź” nie jest KPO. Po 1 stycznia 2027 r. jest jeszcze mniej KPO, bo payload bez enumu nie wejdzie. Inspektor nie ma obowiązku czytać Waszego czatu. Ma obowiązek czytać BDO.gov i Wasze dokumenty. Panel eksportuje PDF zdarzeń: szkic, wysyłka, odrzucenie, wycofanie, zdjęcia. Retencja — Wasza polityka. Hasło „trzymamy wszystko w chmurze bezterminowo” jest złym RODO i złym kosztem. Hasło „kasujemy po tygodniu” jest złym dowodem. Ustalacie to z kancelarią, nie z dostawcą slajdów.
Miejsce wytwarzania, które w karcie jest siedzibą, a na zdjęciu jest budową w innym powiecie, jest klasycznym rozjazdem. Nowy API nie naprawi kłamstwa adresu. Ujawni je, jeśli struktury danych są ciaśniejsze. Dlatego Android zbiera miejsce na miejscu. Dlatego umowa z podwykonawcą mówi, kto jest wytwórcą. Dlatego nie wołamy „AI rozpozna kod z zdjęcia” jako obietnicy produkcyjnej. Możemy pomóc z katalogiem kodów i ostrzeżeniem, gdy kod nie pasuje do opisu. Decyzja zostaje ludzka. Inspektor pyta człowieka.
Jeśli kontrola dotyczy magazynu części i olejów w warsztacie, a nie budowy — inny kod, inna karta, ten sam most. Program do warsztatu samochodowego trzyma zlecenie i części. Odpad z zlecenia serwisowego jest zdarzeniem, nie „dodatkiem w uwagach”. Nie palimy programu warsztatu. Doklejamy odpad. WIOŚ nie pyta, czy macie ładny kalendarz napraw. Pyta, czy 13 02 05* ma kartę.
SaaS, integrator, własny panel: kiedy pudełko wystarczy, a kiedy 1 stycznia je zdemaskuje
Pudełko wystarczy, gdy: jedna spółka, jeden typ karty (albo KPO, albo KPOK, nie oba w chaosie), miejsca wytwarzania, które da się słownikować, integrator, który pokazuje Excel IOŚ i logi z test-bdo, kolejka na okno serwisowe, osobne loginy, brak potrzeby Androida na bramie albo Android, który już macie i który przeżyje zmianę za ekranem. Wtedy GESOFT na kontakt napisze: zostańcie. To jest oferta. Nie jest porażką sprzedaży. Jest kosztem, którego Wam nie liczmy.
Własny panel, gdy: trzy spółki i jeden pojazd; budowa plus serwis plus komunalka; wytwórca zależy od aneksu; kod zmienia się w ciągu dnia; kierowca ma jechać, gdy BDO.gov leży; integrator milczy o 1 stycznia; Excel „uwagi” jest jedynym statusem; księgowa pożycza hasło na bramę. Wtedy Laravel + Vue + Android (Paweł Matusiak) stawia most obok tego, co żyje. Nie palimy TMS, ERP, programu budowy. Klucz to id zlecenia. Szerszy rachunek wyboru: gotowy program czy oprogramowanie na zamówienie oraz ile kosztuje aplikacja w Laravelu.
Warstwa w środku: integrator zostaje, my mapujemy nowe API, Wasz ekran nie rusza się 1 stycznia. To jest częsta odpowiedź. Tańsza niż nowy kombajn. Droższa niż nadzieja. Wymaga dostępu do testu i kontraktu, w którym integrator nie trzyma Waszego payloadu jako zakładnika. Jeśli trzyma — to też piszemy w ofercie, jako ryzyko, nie jako hejt. Laravel + Vue.js na panele jest o tym, jak taki most wygląda od środka: nie jako „aplikacja do wszystkiego”, jako panel z dziennikiem zdarzeń i 2FA.
- Pytanie 1: czy integrator pokazał Wam Excel z 21 sierpnia i listę endpointów, które rusza?
- Pytanie 2: czy jest konto test-bdo i log z KPO oraz KPOK na Waszych kodach?
- Pytanie 3: czy statusy są enumem, czy kolumną „wpisz sam”?
- Pytanie 4: czy odrzucenie i wycofanie wracają na zlecenie, czy na czat?
- Pytanie 5: czy środek transportu jest słownikiem, czy przezwiskiem auta?
- Pytanie 6: czy Android (albo brama) umie szkic bez BDO.gov?
- Pytanie 7: czy 25 sierpnia o 19:00 mieliście kolejkę, czy nadzieję?
- Jeśli na cztery z siedmiu jest „nie” — pudełko może nie zdążyć; piszecie na kontakt.
Nie jesteśmy partnerem resellerem BDO.gov. Nie sprzedajemy wpisu do rejestru. Nie jesteśmy IOŚ. Jesteśmy warsztatem, który spina Wasze zlecenie z API, które się zmienia. Jeśli po ofercie pójdziecie do kogoś innego, zabieracie specyfikację mostu. Nie zamykamy danych wywozu jako zakładnika licencji. To jest ta sama zasada, którą trzymamy przy bezpieczeństwie aplikacji Laravel: CSRF, sesje, 2FA, dziennik — nie marketingowy kłódkowy kafelek.
Koszt chaosu: podwójna karta, auto pod bramą, odrzucenie bez nazwy — bez zmyślonych kar
Nie podamy „średniej kary WIOŚ za brak KPO”, bo komunikat z 21 sierpnia jej nie zawiera, a my nie bierzemy liczb z broszur. Koszt, który możecie policzyć u siebie, nie czeka na taryfikator. Auto, które stoi, bo karta nie wyszła. Drugi kurs, bo pierwszy pojechał bez id. Kontener, który wrócił, bo kod był zły. Sobota, w której księgowa klika za trzy dni budowy. To są Wasze stawki, nie nasze. Ewidencja KPO przy nowym API BDO nie zmniejsza stawki zestawu. Zmniejsza liczbę dni, w których stawka idzie w błoto, bo JSON nie przeszedł walidacji.
Podwójna karta jest droższa niż brak karty w krótkim terminie: w BDO.gov są dwa przekazania, u Was jeden kontener. Wyjaśnianie tego jest czasem pracy, której nie zafakturujecie klientowi. Nowe pole wycofania z 2027 r. jest tańsze, jeśli umiecie z niego skorzystać. Jest droższe, jeśli „poprawiacie” drugim wysłaniem. Panel blokuje drugie wysłanie, gdy pierwsze ma id i nie jest wycofane. If. Znowu if. If jest tańszy niż kancelaria.
Odrzucenie bez nazwy kosztuje kłótnię. Odrzucenie z enumem kosztuje poprawkę. Komunikat z 21 sierpnia daje Wam szansę, żeby kłótnia dostała nazwę. Kto nie zapisze pola, zostanie przy kłótni. Kto zapisze i nie nauczy ekipy, zostanie przy kłótni z ładnym logiem. Log bez szkolenia jest ozdobą. Szkolenie biura w listopadzie 2026 r. jest w harmonogramie nie dla HR. Dla 2 stycznia, gdy enum wróci pierwszy raz po realnym wywozie.
Postój pod bramą w oknie serwisu 25 sierpnia jest próbą generalną. Jeśli ten wieczór Was nie boli, albo nie wywozicie wieczorem, albo macie kolejkę. Jeśli boli, 1 stycznia zaboli mocniej, bo oprócz dostępności zmieni się kontrakt. Dwa bóle naraz. Nie spinamy ich w „monitoring 99,9%”. Spinamy w statusie szkic, czeka. Kierowca, który widzi ten status, nie kłamie klientowi „już jedzie w systemie”. Klient może nie lubić prawdy. Inspektor lubi ją bardziej.
Jak rozmawiać z GESOFT: 24 godziny, trzy odpowiedzi, zero slajdu o transformacji odpadów
Piszecie na kontakt. W wiadomości nie potrzebujemy „strategii GOZ 2030”. Potrzebujemy: liczba miejsc wytwarzania; czy budowa / serwis / komunalka / warsztat; czy KPO i KPOK oba żyją; jaki integrator albo Excel dziś żyje; czy jest API, czy klik w przeglądarce; czy ktoś wozi wieczorem; czy 25 sierpnia stanęliście. To wystarczy, żeby w 24 godziny wróciła jedna z trzech odpowiedzi: zostańcie przy pudełku; doklejamy warstwę mapowania API; stawiamy własny most ze zleceniem i Androidem. Ewidencja KPO przy nowym API BDO zaczyna się od tej trójki, nie od makiety kosza.
Odpowiedź „zostańcie przy pudełku” jest pełnowartościowa. Dostajecie ją na piśmie, z listą pytań do integratora (Excel, test-bdo, enum, kolejka, odrzucenie). Nie jesteśmy partnerem tego integratora. Jesteśmy kimś, kto woli, żebyście nie płacili dwa razy. Odpowiedź „warstwa” znaczy: integrator zostaje, my stawiamy Laravel obok, klucz to id karty i id zlecenia. Odpowiedź „własny most” znaczy: klik w przeglądarce nie przeżyje 1 stycznia albo model (trzy spółki, jeden pojazd) nie mieści się w karcie pudełka. Cennik zależy od tego, nie od hasła „cyfrowe BDO”.
Paweł Matusiak. Laravel, Vue, Android. Bez zespołu, który Wam narysuje zielony liść na slajdzie. Z dziennikiem zdarzeń, 2FA i statusem, który umie być czerwony. Jeśli po ofercie wolisz innego dostawcę — idźcie. Zabieracie specyfikację mostu, którą i tak powinniście mieć. Nie zamykamy Was w licencji, która trzyma id kart jako zakładnika. Płacicie za model. Excel zostawiacie, gdy most zacznie działać, nie gdy slajd zacznie się kręcić.
Na koniec, wprost: komunikat z 21 sierpnia 2026 r. jest krótki. Wasz problem nie jest krótki, bo budowa, serwis, KSeF, e-Doręczenia i okno serwisowe BDO.gov siedzą w jednym sezonie. Nie spinamy tego w „jeden system do wszystkiego”. Spinamy zlecenie wywozu z API KPO/KPOK, które się zmienia. Reszta (BDO.gov, WIOŚ, marszałek, FK, KSeF.gov, skrzynka e-Doręczeń) zostaje w swoich urzędach. Kto Wam obieca jeden przycisk zamiast tych urzędów, kłamie. My obiecamy ofertę w 24 h i zdanie, którego nie usłyszycie na konferencji o GOZ: tego Wam nie zbudujemy, bo nie wolno.
Pytania, których nie zadajecie integratorowi — a powinniście, zanim podpiszecie aneks „moduł 2027”
Zanim kupicie „zgodność z API BDO 2027”, zapytajcie o Excel z 21 sierpnia, nie o logo. Czy lista endpointów jest u Was w pliku? Czy KPO i KPOK są osobno? Czy enum statusu jest w bazie, czy w ifach w kodzie, którego nie zobaczycie? Czy pole roku jest zmapowane zgodnie z załącznikiem, nie z zegarem? Czy środek transportu jest słownikiem IOŚ? Czy odrzucenie wraca na zlecenie? Jeśli na którekolwiek słyszycie „to w uwagach”, nie kupujecie zgodności. Kupujecie nadzieję do 31 grudnia. Ewidencja KPO przy nowym API BDO jest mapowaniem albo jest broszurą. Broszurę macie już na bdo.mos.gov.pl.
Zapytajcie, czego nie robią. Czy zastępują BDO.gov? (Jeśli chcą — wychodzicie.) Czy „załatwiają WIOŚ”? (Nikt nie załatwia WIOŚ.) Czy wystawiają KPO, gdy API leży, i oznaczają to jako wysłane? (Jeśli tak — wychodzicie.) Czy migrują Was 31 grudnia? (Źle.) Czy mają 2FA? Czy logują, kto wycofał kartę? Te pytania są ważniejsze niż liczba kafelków. GESOFT odpowiada na nie w ofercie. Inny dostawca też powinien. Jeśli nie umie, nie dlatego że jesteście zbyt mali. Dlatego że most jest dla niego dodatkiem, a dla Was — 2 stycznia.
Cena pudełka bywa niższa na fakturze i wyższa w pracy ręcznej. Druga licencja „na komunalkę”, Excel „na budowę”, SMS „na odrzucenie” — to jest TCO, którego nikt nie wpisze w cennik. Własny panel bywa wyższy na starcie i niższy, gdy trzy reżimy siedzą w jednej bazie. Nie rozstrzygamy tego za Was bez liczb z Waszych miejsc wytwarzania. Dlatego oferta jest po liście miejsc, nie przed. Pięć miejsc i trzy reżimy jest trudniejsze niż czterdzieści kontenerów i jeden kod. Pudełko lubi czterdzieści. My lubimy prawdę o pięciu.
Aneks „moduł 2027” bez daty testu jest aneksem o niczym. Wpisujcie: konto test-bdo do dnia X, log KPO/KPOK do dnia Y, mapowanie enumów w załączniku, dyżur pierwszego tygodnia stycznia. Jeśli integrator nie podpisze dat, GESOFT może być warstwą albo świadkiem na piśmie, że dat nie ma. Świadek też jest usługą. Tanio. Czasem wystarczy, żebyście nie przedłużyli milczenia do grudnia.
Magazyn, kody i masa: słownik, bez którego nowy endpoint i tak Was odrzuci
API z 2027 r. nie nauczy Was kodów odpadów. Kod, który kłamie, przejdzie albo nie — zależnie od walidacji, nie od Waszej intuicji. Słownik kodów u Was jest obowiązkiem posiadacza, nie „modułem AI”. Ewidencja KPO przy nowym API BDO podpowiada kod z karty miejsca i z ostatniego wywozu, nie z czatu. Podpowiedź, którą da się nadpisać. Nadpisanie, które zostawia, kto i dlaczego. Inspektor pyta o kod, nie o model językowy.
Masa bez jakości jest liczbą teatralną. Waga, dekiel, szacunek — trzy znaczniki, o których pisaliśmy przy Androidzie — wracają tu jako słownik biura. Jeśli klient płaci od tony z wagi, a Wy w KPO dajecie dekiel, rozjazd wyjdzie na fakturze KSeF i na karcie jednocześnie. Panel pokazuje oba. Nie „uzgadnia” ich magicznie. Uzgadnianie jest decyzją człowieka, który wie, czy waga była zepsuta. Aplikacja wie, że są dwa źródła. To wystarczy, żeby 2 stycznia nie wysłać dekla jako wagi, bo skrypt brał pierwszą niepustą komórkę.
Magazyn odpadów na placu — pryzma, kontener, wiata — jest miejscem, nie „uwagą”. Program magazynowy w sensie stanów to nie jest WMS od palet z towarem. Jest listą miejsc i stanów, które KEO powinno znać. Nie zastępujemy KEO. Pilnujemy, żeby wywóz z miejsca, którego nie ma w słowniku, nie wyszedł jako karta z adresem siedziby. Nowy endpoint nie pyta, czy pryzma istnieje. Pyta o pola. Pola możecie wypełnić kłamstwem. Panel może Wam utrudnić kłamstwo. Nie może go zabronić za Was.
- Słownik kodów per miejsce wytwarzania, z możliwością nadpisania i logiem kto/dlaczego.
- Trzy jakości masy: waga, dekiel, szacunek — osobno, bez zgadywania pierwszej komórki.
- Miejsce jako karta (adres, gmina, czy budowa, czy hala), nie jako tekst w uwagach.
- Blokada wysyłki, gdy miejsce nie ma kodu albo kod jest niebezpieczny a karta idzie jak bytowy.
- Nie zastępujemy katalogu kodów z przepisów — trzymamy Wasz wycinek, nie cały świat odpadów.
- Podpowiedź z ostatniego wywozu jest pomocą, nie dowodem dla WIOŚ.
- Rozjazd masy KPO vs faktura KSeF — raport, nie automatyczne „uzgodnienie”.
- Pryzma bez karty miejsca nie wychodzi w payloadzie z adresem siedziby.
Jeśli macie już WMS od towaru, nie palimy go, żeby trzymał gruz. Gruz nie jest SKU. Doklejamy listę miejsc odpadów. Kombajn, który udaje, że 17 05 04 to pozycja magazynowa z kodem kreskowym, będzie piękny na demo i martwy na budowie w deszczu. Android w deszczu ma cztery pola. WMS ma sto. 1 stycznia 2027 r. wygrywa ekran, który kierowca użyje, nie ten, który wygrywa przetarg IT.
RODO, logi i kto klika: karta odpadów to nie jest grupa na komunikatorze
Login współdzielony do BDO.gov jest dziurą, którą 1 stycznia nie załata nowy enum. Enum nie wie, kto kliknął. Wie to dziennik po Waszej stronie, jeśli go macie. Ewidencja KPO przy nowym API BDO loguje operatora panelu, nie „konto firmy”. 2FA — jak w uwierzytelnianiu w Laravelu — nie jest ozdobą dla ISO. Jest tym, co zostaje, gdy były pracownik nadal zna hasło z 2024 r. BDO.gov ma swoje konta. Panel ma swoje. Pożyczanie obu na jeden telefon w kabinie jest jednym incydentem, nie dwoma narzędziami.
Zdjęcie pryzmy jest daną, czasem z osobą w kadrze. Informujecie załogę. Nie publikujecie pryzmy na Facebooku firmy „dla transparentności”. Retencja zdjęć — polityka, nie default chmury. To samo RODO, o którym piszemy przy innych panelach. Inspektor odpadów nie jest podstawą, żeby trzymać twarze pracowników pięć lat w folderze „BDO”. Minimalizacja. Eksport na żądanie. Umowa powierzenia, jeśli GESOFT hostuje. Jeśli hostujecie u siebie — też umowa, tylko inna strona.
Uprawnienia: kto szkicuje, kto wysyła, kto wycofuje, kto widzi powód odrzucenia, kto eksportuje PDF dla kontroli. Kierowca nie widzi PESEL-i kontrahenta. Biuro nie musi widzieć GPS-u każdego postoju, jeśli nie jest to potrzebne. Nowy API nie wymaga, żeby wszyscy widzieli wszystko. Wymaga poprawnego payloadu. Payload i podgląd to dwa różne ekrany. Kombajn, który daje wszystkim pełny Swagger, nie jest „transparentny”. Jest głośny.
Audyt, którego nie obiecujemy jako certyfikatu, a robimy jako praktykę: dziennik, hasła, 2FA, kopie, kto ma klucz do test-bdo. Audyt bezpieczeństwa aplikacji PHP jest osobną usługą, gdy macie już panel i nie wiecie, czy most nie cieknie. Przy KPO cieknący most to wyciek kontrahentów i miejsc, nie tylko „wizerunek ESG”. Nie straszymy. Prosimy o osobne loginy zanim ruszysz enum. Enum bez loginu jest nowym sposobem, żeby stare hasło psuło nowe API.
Co zostaje po stronie człowieka: kod, wytwórca, umowa — panel tego nie podpisze za Was
Nowy API od 1 stycznia 2027 r. jest kontraktem maszyn. Klasyfikacja odpadu, wybór wytwórcy, treść aneksu z klientem, decyzja „jedź mimo okna serwisowego” — zostają ludzkie. Ewidencja KPO przy nowym API BDO zapisuje decyzję. Nie podejmuje jej za brygadzistę. Kto obiecuje, że „system sam dobierze kod z zdjęcia i wyśle”, sprzedaje Wam spór z WIOŚ w abonamencie. My sprzedajemy słownik, ostrzeżenie i log. Podpis zostaje Wasz. To jest ta sama granica, której pilnujemy przy tachografie i KSeF: urząd i urządzenie zostają, most nie udaje urzędu.
Umowa z klientem, która milczy o odpadach z remontu, jest bombą z opóźnionym zapłonem. Panel może mieć checkbox „wytwórca zgodnie z umową / zgodnie z ustawą”. Checkbox bez skanu umowy jest ozdobą. Skan bez daty jest ozdobą. Data bez roli, kto zatwierdził aneks, jest ozdobą. Trzy ozdoby wyglądają jak compliance na demo. Na kontroli wyglądają jak nic. Nie jesteśmy kancelarią. Możemy trzymać teczkę aneksów przy CRM. Treść aneksu pisze prawnik. W sierpniu 2026 r. petycja o ROP i BDO nie zastąpi Wam aneksu na budowie.
Kierowca, który ma jechać, bo klient krzyczy, nie jest użytkownikiem Swaggera. Jest użytkownikiem statusu. Jeśli status jest czerwony (brak szkicu, API leży, odrzucenie bez poprawki), panel ma umieć powiedzieć nie. Dyspozytor może nadpisać — z logiem. Bez logu nadpisanie jest czatem. Czat wraca nas do grupy „wywóz_piątek”. Komunikat IOŚ z 21 sierpnia nie zna tej grupy. Zna enum. Wy musicie znać obu: enum w biurze, człowieka na bramie. Brama bez człowieka, który może powiedzieć nie, jest tylko GPS-em.
Szkolenie, które IOŚ i instytut ogłaszają w sierpniu — webinaria o module ewidencji, KPO, KEO, sesja pytań 18 sierpnia — są dla ludzi, nie dla skryptu. Skrypt nie pójdzie na webinar. Księgowa może. Brygadzista raczej nie. Panel, który wymaga webinaru od kierowcy, jest źle zaprojektowany. Panel, który wymaga od biura przeczytania Excela z 21 sierpnia, jest dobrze zaprojektowany. Rozdzielcie te dwie publiczności. Potem dopiero pytajcie GESOFT o ekrany. Ekran bez publiczności jest makietą. Makietę macie w Swaggerze test-bdo.
Wywóz to nie tylko BDO: pojazd, waga, czasem SENT — most nie udaje PUESC
Karta przekazania nie jedzie sama. Jedzie autem. Auto ma rejestrację, kierowcę, czasem tachograf, czasem SENT, zawsze masę. Ewidencja KPO przy nowym API BDO może trzymać rejestrację jako środek transportu — komunikat z 21 sierpnia właśnie to pole dopisuje. Nie może zastąpić SENT w PUESC i nie może zastąpić tachografu. Jeśli woźcie odpady, które SENT obejmuje, PUESC zostaje. Kto Wam sprzeda „BDO+SENT w jednym kafelku bez PUESC”, sprzedaje kłopot na drodze i kłopot w BDO.gov naraz. Rozdzielamy id zlecenia: karta BDO, zgłoszenie SENT, faktura KSeF. Trzy id. Jeden kontener.
Firma transportowa, która wozi Wasz gruz jako podwykonawca, nie staje się przez to Waszym BDO. Wy zostajecie wytwórcą albo posiadaczem — zależnie od umowy i ustawy. Oni zostają przewoźnikiem. Panel pokazuje, czyje to auto (słownik środków transportu) i czyja to karta (Wasz NIP albo NIP odbierającego, zgodnie z rolą). Mieszanie NIP-u przewoźnika z NIP-em wytwórcy w jednym polu „kontrahent” jest błędem, który nowa struktura danych chętnie odrzuci. Oprogramowanie dla firmy transportowej jest o zleceniu drogowym. Tutaj jest o karcie. Jeśli jesteście oboma, dwa moduły, jeden pojazd.
Waga na wyjeździe z budowy bywa inna niż waga u odbierającego. Dwa pomiary, dwa znaczniki, jeden spór. Panel nie rozstrzyga sporu. Trzyma oba. Faktura może iść od tony u odbierającego. KPO może wymagać masy przy przekazaniu. Rozjazd jest normalny. Ukrywanie rozjazdu jest nienormalne. Nowy powód odrzucenia może kiedyś nazwać „masę”. Nie zgadujemy, czy nazwie. Budujemy miejsce na drugą liczbę. Miejsce jest tańsze niż kłótnia na mailu, którego nie znajdziecie za rok.
Nie palimy tachografu, PUESC, wagi mostowej ani BDO.gov, żeby „uprościć wywóz”. Uproszczenie, które gubi urząd, jest komplikacją na kontroli. GESOFT upraszcza ekran kierowcy i mapowanie API. Reszta urzędów zostaje. Jeśli to brzmi mało jak rewolucja GOZ — dobrze. Rewolucja nie wywozi 17 05 04 w deszczu. Wywozi most, który 2 stycznia 2027 r. nadal zna endpoint.
Najczęściej zadawane pytania
- Czy od 1 stycznia 2027 r. KPO wraca do papieru albo znika z BDO.gov?
- Nie. Komunikat IOŚ–PIB z 21 sierpnia 2026 r. dotyczy API obsługi KPO i KPOK: endpointy, struktury, enumy, pole roku, środki transportu, powody odrzucenia i wycofania. Ewidencja zostaje w BDO.gov. Zmienia się kontrakt integratora. Ewidencja KPO przy nowym API BDO dostosowuje most, nie urząd.
- Czy GESOFT zastępuje BDO.gov, WIOŚ albo gotowego integratora?
- Nie z zasady. BDO.gov zostaje urzędem, WIOŚ kontrolą, integrator — jeśli trzyma jedną prawdę o karcie i pokaże Excel oraz test-bdo. Doklejamy most ze zleceniem i Androidem albo mówimy „zostańcie przy pudełku”. Szerszy rachunek: gotowy program czy oprogramowanie na zamówienie. Na kontakt możecie usłyszeć właśnie to.
- Co się zmienia konkretnie w API? Skąd to wiecie?
- Z komunikatu: modyfikacje adresów części endpointów, nowe endpointy, struktury request/response, statusy i rodzaje kart oraz kolumny sortowania jako enumy, pole „rok” w wybranych operacjach, nowe pola środków transportu oraz powodów odrzucenia i wycofania. Szczegół jest w Excelu IOŚ. Test: test-bdo.mos.gov.pl. Nie zgadujemy komórek za IOŚ.
- Jak to się ma do KSeF od lutego i kwietnia 2026 r.?
- KSeF nie wystawia KPO. Numer KSeF może wisieć przy zleceniu wywozu, żeby faktura i karta miały ten sam id. Od 1 lutego 2026 r. duzi (sprzedaż 2024 powyżej 200 mln zł z podatkiem), od 1 kwietnia szeroki obowiązek. Panel nie zastępuje KSeF.gov. Szczegóły: KSeF w aplikacji firmowej.
- Czy okno serwisowe 25 sierpnia 2026 r. jest tym samym co zmiana API 2027?
- Nie. Komunikat z 20 sierpnia zapowiada prace 25 sierpnia 2026 r. w godz. 19:00–22:00 i możliwe utrudnienia dostępu. To jest dostępność urzędu. 1 stycznia 2027 r. to jest nowa specyfikacja. Oba bolą, jeśli nie macie kolejki szkiców. Jedno nie zastępuje drugiego.
- Czy komunikat o podmiotach zagranicznych z 17 sierpnia dotyczy naszej ekipy na budowie?
- Tylko jeśli jesteście zagranicznym wprowadzającym opakowania lub baterie i składacie wniosek do Rejestru BDO po 12 sierpnia 2026 r. Wtedy w grę wchodzi przedstawiciel ROP na podstawie rozp. (UE) 2023/1542 i (UE) 2025/40. Źródło: informacja z 17 sierpnia. Wywóz gruzu to inny reżim. Nie mieszamy go z ROP w jednym wierszu.
- Kto jest wytwórcą odpadów z remontu, jeśli umowa milczy?
- Przy usługach budowy, rozbiórki, remontu, czyszczenia, sprzątania, konserwacji i napraw ustawa o odpadach wskazuje podmiot świadczący usługę, chyba że umowa stanowi inaczej. Panel trzyma tę rolę i skan aneksu. Nie zastępuje kancelarii. Nie wystawia karty „na klienta” bez aneksu tylko dlatego, że tak wygodniej na bramie.
- Czy aplikacja wystawi KPO, gdy BDO.gov leży, i oznaczy to jako wysłane?
- Nie. W oknie serwisowym szkic czeka, status jest czerwony albo „kolejka”, auto nie dostaje zielonego bez id z urzędu. Kłamstwo „wysłane” jest gorsze niż postój. Most kolejkuje. Nie udaje urzędu. To samo przy tachografie i SENT: nie zastępujemy PUESC.
- Jak spiąć to z budową, serwisem terenowym i sprzątaniem w jednej firmie?
- Trzy profile miejsc i kodów, jeden pojazd jeśli tak jest, osobne szablony KPO/KPOK. Mechanizm zlecenia: oprogramowanie dla firmy budowlanej, serwis terenowy, firma sprzątająca. Excel z jednym wierszem „odpad” jest trzema kłamstwami. Własny panel ma trzy karty. SaaS często ma jedną.
- Jak zamówić wycenę i co wraca w 24 godziny?
- Piszecie na kontakt: liczba miejsc wytwarzania, budowa / serwis / komunalka, KPO i KPOK, integrator albo Excel, czy jest API, czy 25 sierpnia stanęliście. GESOFT (Paweł Matusiak) wraca w 24 h jedną z trzech odpowiedzi: zostańcie przy pudełku; warstwa mapowania; własny most. Bez slajdu GOZ. Z listą rzeczy, których nie zastępujemy (BDO.gov, WIOŚ, FK, KSeF.gov, SENT/PUESC).
Opisz projekt