Jak to działaPrzewoźnikKierowcaMieszkaniecGminaOczyszczalniaPrzepisyTechnicznie Drukuj / PDF

Jak działa SzamboPRO

SzamboPRO łączy w jednym systemie pięć stron: mieszkańca z szambem, firmę wywozową, jej kierowcę, oczyszczalnię ze stacją zlewną i urząd gminy. Każdy metr sześcienny ma zapisane miejsce odbioru (adres, GPS, zdjęcie licznika, podpis klienta) i miejsce zlania (stacja, kwit, potwierdzenie stacji).

KtoGdzie się logujeCo dostaje
Mieszkaniec/rejestracja raz, potem /moje numerem telefonu i kodem SMSumowę, zamawianie jednym kliknięciem albo automatycznie, potwierdzenia do kontroli gminy
Firma wywozowa/ → login i hasło, panel /panelzlecenia, trasy, bilans litrów, alarmy, sprawozdania art. 9o, przetargi, konkurencja
Kierowca/kierowca na telefonie lub tablecie, PINkursy po kolei, nawigacja, odbiór, zlew - działa bez zasięgu
Gmina/ → login urzędu (zatwierdzany ręcznie)ewidencja szamb, plan kontroli, protokoły, sprawozdania firm, sprawozdanie roczne
Oczyszczalnia/ → login stacjipotwierdzanie zlewów, pochodzenie ścieków z gmin, raport miesięczny
Obieg jednego wywozu: zamówienie (telefon, SMS, portal albo automat) → zlecenie w planie dnia → kierowca: „Jestem”, licznik, podpis → SMS z potwierdzeniem do mieszkańca → zlew na stacji, a stacja potwierdza ilość → bilans litrów wieczorem → wywóz trafia do sprawozdania kwartalnego gminy.

Instrukcja dla firmy wywozowej

Start

  1. Załóż konto na /rejestracja → „Firma wywozowa”. Zaznacz gminy, w których masz zezwolenie, i dodaj pierwszy wóz. Masz 30 dni za darmo.
  2. W „Flota i zezwolenia” uzupełnij numery zezwoleń, daty ważności i stacje zlewne wskazane w zezwoleniu. System pozwoli kierowcy zlewać tylko tam.
  3. Klientów dodasz ręcznie („Klienci i umowy” → „Nowy klient”) albo zaimportujesz z Excela. Klienci mogą się też zapisać sami przez stronę.
  4. Daj kierowcom PIN-y. Aplikacja kierowcy to strona /kierowca, którą można dodać do ekranu głównego telefonu jak zwykłą aplikację.

Codziennie

Kontrola kursów „na lewo”

Sprawozdania do gmin (art. 9o)

Zakładka „Sprawozdania do gmin” liczy dla każdej gminy osobno wszystkie pozycje z ustawy. „Podgląd i druk” daje wydruk do podpisu, a „Złóż elektronicznie” wysyła sprawozdanie do gminy, która korzysta z SzamboPRO. Na pulpicie widzisz termin, a po jego upływie wyliczoną karę.

Rynek

Przetargi: wyniki monitora ogłoszeń (Biuletyn Zamówień Publicznych, platformy zakupowe, BIP-y gmin). Konkurencja: firmy z zezwoleniami. Gminy - kontakty: 89 urzędów z adresami e-mail i gotowym wnioskiem o informację publiczną.

Instrukcja dla kierowcy

  1. Otwórz /kierowca i wpisz swój PIN. Na Androidzie: menu przeglądarki → „Dodaj do ekranu głównego”.
  2. Kursy są w kolejności trasy. „Nawiguj” otwiera mapę Google z adresem.
  3. Na miejscu naciśnij „Jestem - odbiór”: wpisz ilość z licznika, zrób zdjęcie licznika, wybierz płatność, a klient podpisuje się palcem.
  4. „Zakończ odbiór” zapisuje GPS i wysyła klientowi SMS z ilością, kwotą i linkiem do potwierdzenia.
  5. Gdy beczka jest pełna w 75%, aplikacja przypomni o zlewie. „Zlewam na stacji”: wybierz stację (tylko te z zezwolenia), wpisz ilość i numer kwitu, zrób zdjęcie kwitu.
  6. Bez zasięgu wszystko zapisuje się w telefonie i wysyła samo po odzyskaniu sieci. Nie ma ryzyka podwójnego zapisu.
Pompa ma czujnik. Każde jej włączenie jest widoczne u szefa z miejscem i godziną.

Dla właściciela szamba - instrukcja i regulamin

Rejestracja (raz)

  1. Wejdź na /rejestracja → „Mieszkaniec”. Podaj numer telefonu i wpisz kod z SMS.
  2. Podaj adres, pojemność szamba i liczbę domowników. Możesz też zapisać lokalizację, stojąc przy szambie.
  3. Wybierz firmę z zezwoleniem w Twojej gminie (widać cenę za m³).
  4. Wybierz sposób zamawiania: automatycznie przed zapełnieniem (system liczy dopływ i zamawia wóz 2–5 dni wcześniej), stały cykl (co 14–90 dni) albo sam zamawiam (przypomnienie SMS).
  5. Zaakceptuj regulamin. Umowa z firmą zawiera się od razu i jest widoczna w portalu.

Później

Na /moje widzisz szacowane zapełnienie, termin zamówionego wywozu, umowę i wszystkie potwierdzenia. Automatyczne zamawianie włączysz lub wyłączysz w każdej chwili.

Kontrola z gminy

Gmina sprawdza umowę i dowody opłat za wywóz (art. 6 ust. 1 i 5a ustawy o utrzymaniu czystości i porządku w gminach). Pokaż je na telefonie albo wydrukuj z portalu. Każde potwierdzenie ma datę, ilość, pojazd, zezwolenie i stację zlewną.

Regulamin usługi (skrót)

  1. Zamówienia: portal, SMS, telefon, automatycznie. Termin do 2 dni roboczych.
  2. Ilość według licznika pojazdu (zdjęcie w systemie). Cena za m³ z umowy, nie wyższa niż górna stawka uchwalona przez radę gminy.
  3. Nieczystości trafiają wyłącznie do stacji zlewnej wskazanej w zezwoleniu gminy.
  4. Dane osobowe przetwarza firma wywozowa jako administrator w celu wykonania umowy i obowiązków prawnych (art. 6 ust. 1 lit. b i c RODO). Firma przekazuje gminie adres nieruchomości w sprawozdaniu kwartalnym (art. 9o).
  5. Reklamacje: 14 dni od wywozu.

Instrukcja dla urzędu gminy

  1. Zgłoś konto na /rejestracja → „Urząd gminy”. Potwierdzamy je telefonicznie z urzędem.
  2. Ewidencja (art. 3 ust. 3): zaimportuj dotychczasową ewidencję z Excela (CSV). Firmy z SzamboPRO uzupełniają ją z każdego wywozu: umowa, data, ilość.
  3. Plan kontroli (art. 6 ust. 5a–5aa): nieruchomości z punktacją. Najwyżej są adresy bez umowy, bez wywozów i takie, które wywożą dużo mniej ścieków, niż wynika ze zużycia wody albo liczby osób. Zaznacz i zaplanuj, wydrukuj protokół, wpisz wynik.
  4. Sprawozdania firm (art. 9o): złożone elektronicznie trafiają tu same. Przeglądasz, przyjmujesz albo odsyłasz do poprawy z uwagą.
  5. Sprawozdanie roczne (art. 3 ust. 5): 9 pozycji ustawy liczy się samo z ewidencji, sprawozdań i kontroli. Drukujesz albo zapisujesz jako PDF i wysyłasz do WIOŚ i RZGW Wód Polskich do 30 kwietnia.
  6. Przewoźnicy i zezwolenia (art. 7 ust. 6b): elektroniczna ewidencja zezwoleń z datami ważności.
Gmina widzi tylko nieruchomości ze swojego terenu i dane, które przewoźnik i tak musi jej przekazać w sprawozdaniu.

Instrukcja dla oczyszczalni (stacji zlewnej)

  1. Stacja zlewna: lista zlewów zgłoszonych przez kierowców (firma, wóz, ilość, numer kwitu) i wozy w drodze z ładunkiem.
  2. „Potwierdź”: wpisz ilość z przepływomierza stacji albo odrzuć ładunek z uwagą (np. ścieki przemysłowe niezgłoszone jako przemysłowe).
  3. Potwierdzona ilość wraca do bilansu litrów przewoźnika i do jego sprawozdania. Rozbieżności widzą obie strony.
  4. Pochodzenie ścieków: z których gmin są ścieki przyjęte w miesiącu (art. 7 ust. 6c: stacja musi spełniać wymagania dla aglomeracji, z której pochodzą nieczystości).
  5. Raport miesięczny: według przewoźników i gmin, do rozliczeń i sprawozdawczości.

Przepisy, które obsługuje system

PrzepisCo mówiGdzie w systemie
art. 5 ust. 1 pkt 3a-3b, art. 6 ust. 1właściciel gromadzi nieczystości w szambie i ma umowę oraz dowody opłatportal mieszkańca, potwierdzenia
art. 6 ust. 2rada gminy ustala górne stawki opłatgminy → maks. stawka
art. 6 ust. 5a–5aawójt kontroluje umowy i dowody, co najmniej raz na 2 lata według planugmina: plan kontroli, protokół
art. 6 ust. 6, art. 6agmina organizuje wywóz u osób bez umowy, może przejąć obowiązekprzetargi, zlecenia źródła GMINA
art. 7, 8, 9zezwolenie wójta, wskazane stacje zlewne, maks. 10 lat; cofnięcie za brak sprawozdaniaflota i zezwolenia, terminy
art. 7 ust. 6cnieczystości tylko do oczyszczalni spełniającej wymagania dla aglomeracjidozwolone stacje u kierowcy, alarm
art. 9osprawozdanie kwartalne przewoźnika do końca miesiąca po kwartalesprawozdania do gmin
art. 9xbkary: 300 zł/dzień spóźnienia (maks. 90 dni), 200–5000 zł nierzetelne, 1000–10 000 zł zła stacjaterminy, alarmy
art. 3 ust. 3, 5, 6ewidencja elektroniczna gminy, sprawozdanie roczne do WIOŚ i Wód Polskich do 30 kwietniagmina: ewidencja, roczne
Prawo wodne art. 86–87aglomeracje wyznacza rada gminynieruchomość: w aglomeracji tak/nie

Tekst: Dz.U. 2025 poz. 733 (wersja ujednolicona Kancelarii Sejmu z 3.08.2026) i Dz.U. 2026 poz. 1335. Do szamb nie stosuje się ustawy o odpadach (art. 2 pkt 8), więc wywóz do biogazowni nie jest dozwolony.

Dokumentacja techniczna

Architektura: rdzeń u dostawcy, dane u klienta

Logika systemu (sprawozdania, bilans, alarmy, prognoza, plan kontroli) działa wyłącznie na serwerze dostawcy, czyli w rdzeniu. U klienta, np. w urzędzie gminy, działa tylko węzeł danych. Przechowuje dane klienta zaszyfrowane (AES-256-GCM) hasłem, które zna tylko klient, i rozmawia wyłącznie z rdzeniem przez TLS 1.3 z obustronnymi certyfikatami. Rdzeń trzyma kopię danych tylko w pamięci RAM, a każdą zmianę zapisuje na węźle przed odpowiedzią. Licencje są podpisane kluczem Ed25519. Klient zawsze może wyeksportować swoje dane, także bez ważnej licencji.

Uruchomienie

Wymaga Node.js 22.13 lub nowszego, bez instalowania dodatkowych pakietów (baza SQLite jest wbudowana w Node).

npm run demo      # baza z danymi pokazowymi (dane/szambopro.db)
npm start         # serwer na http://localhost:8090
npm test          # testy (9)
npm run przetargi # skan przetargów do dane/przetargi.json

Zmienne: PORT, SZAMBO_DANE (katalog bazy i zdjęć), SZAMBO_DEMO=0 (wyłącza pokazywanie kodu SMS na ekranie, wymagane na produkcji), SZAMBO_KLUCZ_CZUJNIKA, SZAMBO_DZIS (tylko do pokazów).

Czujnik pompy

Lokalizator GPS z wejściem cyfrowym (np. Teltonika FMB920) podpięty do sygnału pracy pompy albo wału odbioru mocy. Platforma lokalizatora wysyła zdarzenie HTTP:

POST /api/czujnik/pompa   nagłówek X-Klucz-Czujnika: …
{ "rejestracja": "BZA 12345", "start": "2026-11-10 11:18:00", "koniec": "2026-11-10 11:31:00", "lat": 52.99, "lon": 22.37 }

Bezpieczeństwo i RODO

Bramka SMS

Wszystkie SMS-y (kody, potwierdzenia, przypomnienia, alarmy) trafiają do tabeli wiadomosci ze statusem W_KOLEJCE. Podpięcie operatora (np. SMSAPI) to jeden moduł wysyłający kolejkę.