Loading...
Wersja demonstracyjna. To środowisko służy do testów i prezentacji systemu Szambook.

Dokumentacja Szambook

Opis najważniejszych procesów dla klientów, operatorów, managerów i administratorów systemu.

Dokumentacja użytkownika

README.md

Ta część dokumentacji opisuje korzystanie z aplikacji Szambook z perspektywy użytkowników biznesowych.

Dla kogo jest ta dokumentacja

  • Klienci składający zamówienia.
  • Operatorzy obsługujący i realizujący zamówienia.
  • Managerowie nadzorujący ofertę i proces operacyjny.
  • Administratorzy zarządzający użytkownikami, rolami i danymi demonstracyjnymi.

Spis treści

Jak rozwijać tę dokumentację

Każda strona powinna odpowiadać na jedno praktyczne pytanie użytkownika, np. "Jak złożyć zamówienie?" albo "Jak administrator blokuje konto?". Gdy aplikacja dostanie nowy ekran lub nowy proces, dodaj osobną sekcję albo nowy plik w tym katalogu.

Pierwsze kroki

getting-started.md

Cel aplikacji

Szambook wspiera proces zamawiania, obsługi i rozliczania usług wywozu szamba. Aplikacja łączy prostą ścieżkę składania zamówienia przez klienta z panelem operacyjnym dla zespołu.

Podstawowe role

Rola Zakres
User Składa zamówienia i widzi swoje dane oraz historię zamówień.
Operator Obsługuje przypisane zamówienia i realizację usług.
Manager Nadzoruje zamówienia oraz ofertę.
Admin Zarządza użytkownikami, rolami, uprawnieniami, danymi demonstracyjnymi i logami.

Typowy przebieg pracy

  1. Użytkownik wybiera ofertę lub składa szybkie zamówienie ze strony głównej.
  2. Aplikacja zbiera dane kontaktowe i adresowe.
  3. Zamówienie trafia do systemu.
  4. Operator lub manager planuje i obsługuje realizację.
  5. Po wykonaniu usługi zamówienie zostaje oznaczone jako zrealizowane.

Gdzie szukać pomocy

Konta i logowanie

accounts-and-login.md

Dostępne metody logowania

Szambook obsługuje lokalne logowanie przez telefon/SMS oraz lokalne logowanie przez email. Ekrany logowania mogą też pokazywać przyciski Google i Facebook. Jeśli zewnętrzny dostawca nie jest skonfigurowany, przycisk pozostaje niedostępny.

Rejestracja

Użytkownik może utworzyć konto, podając numer telefonu albo adres email, zależnie od wybranej ścieżki. Domyślna ścieżka korzysta z numeru telefonu i jednorazowego kodu SMS. Szczegółowy opis znajduje się w dokumencie Rejestracja użytkownika.

Weryfikacja OTP

Kod OTP potwierdza dostęp użytkownika do podanego kanału kontaktu. Jeżeli kod wygasł albo nie dotarł, użytkownik może poprosić o ponowne wysłanie.

Ustawienia konta

Zalogowany użytkownik może przejść do swoich ustawień i zaktualizować dane kontaktowe oraz adresowe. Administrator może zarządzać danymi użytkowników w panelu administracyjnym.

Konto zablokowane

Jeżeli konto zostało zablokowane, użytkownik zobaczy ekran blokady. Odblokowanie konta wykonuje administrator.

Rejestracja użytkownika

rejestracja-uzytkownika.md

Problem biznesowy

Firma odbierająca nieczystości potrzebuje szybkiego sposobu zakładania kont klientów bez długiego formularza i bez ręcznej obsługi przez biuro. Klient często chce po prostu złożyć zlecenie, potwierdzić numer telefonu i wrócić do swoich spraw.

Jak Szambook rozwiązuje ten problem

Domyślna rejestracja w Szambook odbywa się przez numer telefonu i jednorazowe hasło SMS. Dzięki temu konto można utworzyć bez ustawiania hasła na starcie, a firma od razu ma potwierdzony kanał kontaktu do klienta.

Opcjonalnie użytkownik może zarejestrować się zwykłym adresem email. System pokazuje również opcje Google i Facebook, ale te metody wymagają konfiguracji dostawców zewnętrznych. Dopóki konfiguracja nie zostanie uzupełniona, logowanie i rejestracja przez Google/Facebook nie powinny być traktowane jako działające ścieżki produkcyjne.

Domyślna ścieżka: numer telefonu i kod SMS

  1. Użytkownik wybiera rejestrację.
  2. System domyślnie prosi o numer telefonu.
  3. Użytkownik wpisuje numer telefonu i wysyła formularz.
  4. System wysyła jednorazowy kod SMS.
  5. Użytkownik wpisuje kod na ekranie weryfikacji.
  6. System tworzy konto i loguje użytkownika.

Korzyść dla firmy

Rejestracja przez telefon zmniejsza tarcie przy pierwszym kontakcie z klientem. Numer telefonu jest naturalnym kanałem dla potwierdzeń, przypomnień i kontaktu kierowcy przed odbiorem, dlatego firma szybciej przechodzi od zgłoszenia do realizacji.

Rejestracja przez email

Rejestracja przez email jest dostępna jako alternatywa dla użytkowników, którzy wolą używać poczty elektronicznej. Przepływ pozostaje podobny: użytkownik podaje email, system wysyła kod lub link weryfikacyjny, a konto zostaje utworzone po potwierdzeniu.

Google i Facebook

Przyciski Google i Facebook mogą być widoczne na ekranie konta, ale wymagają konfiguracji po stronie aplikacji i dostawcy:

  • Google wymaga ClientId i ClientSecret.
  • Facebook wymaga AppId i AppSecret.
  • Adresy callback muszą być zarejestrowane u dostawcy.

Jeżeli konfiguracja nie jest gotowa, użytkownik powinien korzystać z rejestracji telefonem albo emailem.

Komunikaty i sytuacje wyjątkowe

Sytuacja Oczekiwane zachowanie
Numer telefonu jest już używany System informuje, że użytkownik z tym numerem już istnieje.
Email jest już używany System informuje, że użytkownik z tym adresem email już istnieje.
Kod SMS nie dotarł Użytkownik może poprosić o ponowne wysłanie kodu.
Kod jest niepoprawny System nie tworzy konta i pozwala ponowić próbę.
Google/Facebook nie są skonfigurowane Użytkownik nie powinien przejść skutecznie przez zewnętrzną rejestrację.

Rekomendowana komunikacja z klientem

W materiałach sprzedażowych warto podkreślać, że klient może rozpocząć współpracę z firmą bez rozmowy telefonicznej z biurem. System prowadzi go przez rejestrację, potwierdza kontakt i pozwala szybciej złożyć zamówienie.

Oferty

offers.md

Czym jest oferta

Oferta opisuje usługę dostępną w systemie, np. wariant wywozu szamba. Oferta może być widoczna dla klientów albo ukryta przed standardowymi użytkownikami.

Przeglądanie ofert

Użytkownik widzi aktywne oferty dostępne do zamówienia. Role administracyjne mogą widzieć szerszy zestaw ofert, w tym pozycje przygotowywane lub nieaktywne.

Na stronie głównej system może dodatkowo wyświetlać informację o aktywnych programach lojalnościowych. Jeżeli administrator albo manager włączy rabaty, klient zobaczy przy cenniku komunikat o zniżce dla klientów z umową albo o rabacie przy co N-tym wywozie.

Tworzenie i edycja ofert

Tworzenie oraz edycja ofert wymaga odpowiednich uprawnień. Zwykle wykonuje je administrator lub manager.

Dobre praktyki opisu oferty

  • Nazwa powinna jasno mówić, czego dotyczy usługa.
  • Cena i zakres usługi powinny być zrozumiałe dla klienta.
  • Nieaktywne lub testowe oferty nie powinny być widoczne dla zwykłych użytkowników.

Zamówienia

orders.md

Składanie zamówienia

Użytkownik może złożyć zamówienie z poziomu strony głównej albo przez wybór konkretnej oferty. Formularz zbiera dane kontaktowe, adresowe i informacje potrzebne do realizacji usługi.

Jeżeli dla zalogowanego klienta działa program lojalnościowy, system pokazuje w panelu klienta oraz na stronie ofert komunikat o aktywnej albo nadchodzącej zniżce. Dotyczy to programu stałego dla klientów z podpisaną umową albo programu częstotliwościowego dla powracających klientów.

Historia zamówień

Zalogowany użytkownik widzi swoje zamówienia. Role operacyjne i zarządcze mogą widzieć zamówienia zgodnie ze swoimi uprawnieniami.

Statusy zamówień

Status zamówienia opisuje etap procesu. Dokumentacja statusów powinna być rozszerzana razem ze zmianami w OrderStatus w kodzie aplikacji.

Status Znaczenie
Nowe Zamówienie zostało złożone i czeka na obsługę firmy.
W realizacji Zlecenie przyjęte do wykonania, widoczne na liście kierowcy.
Wykonane Wykonanie zostało zatwierdzone; można zapisać potwierdzenie fotograficzne.
Zakończone Zlecenie zamknięte w procesie obsługi firmy.
Anulowane Zamówienie zostało anulowane.

Realizacja zamówienia

Operator lub osoba z uprawnieniem do edycji zamówień może aktualizować dane realizacji. Po wykonaniu usługi zamówienie powinno zostać oznaczone jako zrealizowane.

Przycisk Zrealizuj otwiera ekran potwierdzenia z możliwością dodania zdjęcia pustego zbiornika. Na obsługiwanym telefonie przycisk aparatu umożliwia zrobienie zdjęcia; po zatwierdzeniu realizacji fotografia zostaje przypisana do zamówienia. Manager i klient mogą otworzyć ją z kolumny Potwierdzenie. Dzięki temu potwierdzenie wykonania usługi jest dostępne razem z jej statusem i historią. Zdjęcie jest opcjonalne. Szczegóły opisuje panel kierowcy.

Płatność

Proces checkout może przekierowywać użytkownika przez płatność oraz odbierać powiadomienia płatnicze. Szczegóły integracji technicznej są opisane w integrations.

Rabaty lojalnościowe w zamówieniu

System oblicza rabat automatycznie w chwili finalizacji zamówienia. W zamówieniu zapisywana jest końcowa kwota, procent rabatu, źródło rabatu oraz cena pierwotna przed obniżką.

Jeżeli klient ma podpisaną umowę na regularny wywóz i jednocześnie kwalifikuje się do rabatu częstotliwościowego, pierwszeństwo ma rabat wynikający z umowy.

Automatyczna faktura po realizacji

Szambook wspiera automatyczną księgowość dla firm realizujących wywóz nieczystości. Po oznaczeniu zamówienia jako Zakończone przez managera lub administratora system może utworzyć fakturę w popularnej platformie księgowej fakturownia.pl. Dzięki temu manager nie musi ręcznie przepisywać danych klienta, adresu realizacji, kwoty usługi ani informacji o płatności.

Ta funkcjonalność pomaga uporządkować rozliczenia po każdym wywozie. Firma może podpiąć elektroniczną kasę fiskalną do swojego procesu księgowego albo ją pominąć, jeżeli każdy klient otrzymuje fakturę. Integracja z fakturownia.pl pozwala traktować zakończenie usługi jako naturalny moment wygenerowania dokumentu sprzedaży.

Kierowca oznacza usługę jako Wykonane i może dodać zdjęcie pustego zbiornika. Następnie manager lub administrator oznacza zamówienie jako Zakończone. Dopiero ten etap uruchamia wystawienie faktury na podstawie danych zamówienia i zapis linku do dokumentu. Brak e-maila lub błąd integracji powoduje ostrzeżenie, a status i zdjęcie pozostają zapisane. Jeżeli w danych klienta znajduje się adres e-mail, faktura może zostać wysłana do klienta przez fakturownia.pl. Dla zamówień założonych tylko na numer telefonu firma powinna uzupełnić adres e-mail klienta albo udostępnić fakturę innym kanałem operacyjnym.

Korzyść biznesowa jest prosta: mniej pracy administracyjnej po każdej realizacji, mniejsze ryzyko pomyłek w danych faktury i szybsze przekazanie dokumentu klientowi.

Panel administratora

admin-panel.md

Zakres panelu

Panel administratora służy do utrzymania systemu i obsługi danych pomocniczych.

Najważniejsze zadania

  • Zarządzanie użytkownikami.
  • Konfiguracja programów lojalnościowych.
  • Nadawanie i odbieranie ról.
  • Zarządzanie uprawnieniami użytkowników.
  • Blokowanie i odblokowywanie kont.
  • Usuwanie kont użytkowników.
  • Wgrywanie i usuwanie danych demonstracyjnych.
  • Przeglądanie i pobieranie logów.

Programy lojalnościowe

Administrator lub manager może otworzyć ekran programów lojalnościowych i skonfigurować dwa automatyczne rabaty:

  • Program częstotliwościowy, czyli zniżkę co N-ty zakończony wywóz klienta.
  • Program stały, czyli rabat dla klientów z podpisaną umową na regularny wywóz.

Rabat stały ma priorytet nad programem częstotliwościowym. Jeżeli klient spełnia oba warunki, system stosuje tylko rabat wynikający z umowy.

Flaga umowy u klienta

Warunek dla programu stałego jest zapisany na koncie użytkownika jako informacja o podpisanej umowie na regularny wywóz. Administrator lub manager może ustawić tę flagę podczas edycji danych użytkownika.

Role systemowe

Rola Przeznaczenie
Admin Pełna administracja systemem.
Manager Nadzór operacyjny nad ofertami i zamówieniami.
Operator Obsługa procesu realizacji.
User Standardowy użytkownik składający zamówienia.

Dane demonstracyjne

Konto administratora z konfiguracji Admin działa niezależnie od flagi demo. Przy uruchomieniu system tworzy je, jeśli go brakuje, oraz uzupełnia jego rolę i wymagane uprawnienia. Istniejące hasło pozostaje zachowane. Dzięki temu wyłączenie demonstracji pozostawia możliwość zalogowania do zwykłego panelu administracyjnego.

Administrator może załadować dane demonstracyjne do testów i prezentacji. Po zakończeniu prezentacji dane demonstracyjne można usunąć z panelu.

Tryb demonstracyjny pomaga odróżnić prezentację systemu od codziennej pracy firmy. Ustawienie Demo:Enabled w appsettings.json ma domyślnie wartość true, co ułatwia pracę deweloperską. W tym trybie strona pokazuje baner demonstracyjny, przykładowe loginy na obu ekranach logowania i sekcję Demo dane dostępną wyłącznie administratorowi.

Dla instancji klienta administrator wdrożenia ustawia Demo:Enabled na false. Znikają baner, loginy i odnośnik do sekcji demonstracyjnej, a serwer blokuje wgrywanie i usuwanie danych demo również przez wcześniej otwarty formularz. Pozostałe funkcje systemu działają według dotychczasowych uprawnień.

Przełączenie trybu nie usuwa istniejących kont ani zamówień. Jeśli dane pokazowe mają zostać usunięte, zrób to jawną operacją w sekcji Demo dane przed wyłączeniem trybu demonstracyjnego.

Usuwanie danych demo zachowuje konta z rolą Admin i ich zamówienia, także gdy takie konto ma przykładowy adres demonstracyjny.

Logowanie do prezentacji

Prezentujący może od razu pokazać pracę klienta, operatora i managera, korzystając z domyślnego logowania telefonem. Po załadowaniu danych demo dostępne są konta z hasłem 123:

Rola Telefon E-mail
Klient 000000001 user@demo.com
Operator 000000002 operator@demo.com
Menadżer 000000003 manager@demo.com

Można również wpisać telefon z prefiksem +48. Wybierz Zaloguj hasłem; numery służą do demonstracji, a nie do odbierania SMS-ów. Karta na stronie logowania pokazuje telefon, e-mail i hasło każdego konta.

W starszej bazie system uzupełni brakujące numery tych kont przy uruchomieniu z włączonym demo. Zachowa hasła, zamówienia, własne numery i konta z rolą Admin. Dzięki temu nie trzeba ponownie wgrywać danych prezentacji. Jeśli administrator zmienił dane logowania, obowiązują jego ustawienia.

Jeśli wpiszesz adres e-mail w polu telefonu, pojawi się komunikat Zmień typ logowania na maila. Kliknij go, aby przejść do formularza e-mail. Podpowiedź działa również poza trybem demo i ułatwia powrót do właściwego formularza.

Zasady bezpieczeństwa

  • Nie udostępniaj konta administratora innym osobom.
  • Po prezentacji usuń dane demonstracyjne, jeżeli środowisko ma dalej służyć do pracy.
  • Realne sekrety konfiguracyjne przechowuj poza repozytorium.

FAQ

faq.md

Nie mogę się zalogować. Co zrobić?

Sprawdź, czy wybrana została właściwa metoda logowania: telefon/SMS albo email. Jeżeli używasz OTP, poproś o ponowne wysłanie kodu.

Nie widzę oferty, którą widzi administrator.

Standardowy użytkownik widzi tylko oferty przeznaczone do składania zamówień. Oferty robocze lub nieaktywne mogą być widoczne tylko dla ról administracyjnych.

Kto może zmienić status zamówienia?

Zmiana statusu zależy od uprawnień. Operacje na zamówieniach wykonują role operacyjne lub administracyjne.

Gdzie są dane testowe?

Dane demonstracyjne są zarządzane w panelu administratora. Ich dokładna lista jest opisana w głównym pliku README.

Jak zgłosić brak w dokumentacji?

Dodaj wpis do właściwego pliku w docs/user/pl albo utwórz nową stronę, jeśli temat jest większy.

Panel kierowcy: fotograficzne potwierdzenie realizacji

panel-kierowcy.md

Po wykonaniu wywozu firma potrzebuje jasnego potwierdzenia, że zbiornik został opróżniony. Kierowca może dołączyć zdjęcie bezpośrednio do zlecenia, zamiast przesyłać je osobno przez komunikator. Dzięki temu manager i klient znajdą status usługi oraz fotografię w jednym miejscu.

Jak zakończyć zlecenie ze zdjęciem

  1. Zaloguj się jako kierowca/operator i otwórz Zamówienia. Na telefonie zlecenia są przedstawione jako karty z adresem i przyciskiem Zrealizuj.
  2. Przy odpowiednim zleceniu wybierz Zrealizuj. Sprawdź klienta, usługę i adres na ekranie potwierdzenia.
  3. Naciśnij przycisk z ikoną aparatu Zrób zdjęcie pustego zbiornika. Na obsługiwanym telefonie uruchomi się aparat; w zależności od urządzenia przeglądarka może też pokazać wybór źródła zdjęcia. Na komputerze wybierzesz plik.
  4. Zrób zdjęcie i zatwierdź je w telefonie. Na stronie pojawi się podgląd. Możesz wybrać inny plik albo użyć Usuń wybrane zdjęcie przed zapisaniem.
  5. Naciśnij Potwierdź realizację. Status zmieni się na Wykonane, a zdjęcie zostanie zapisane przy zleceniu. Płatność zostanie oznaczona jako opłacona. Faktura jest wystawiana dopiero przy późniejszym oznaczeniu zamówienia jako Zakończone przez managera lub administratora.
  6. Po zapisie skorzystaj z linku Zobacz zapisane zdjęcie. Wykonane zlecenie znika z listy zadań oczekujących na realizację.

Samo wybranie zdjęcia pokazuje podgląd; zapis następuje po zatwierdzeniu realizacji. Anulowanie formularza pozostawia zlecenie bez zmian. Zdjęcie jest opcjonalne — można zakończyć usługę także bez niego.

Na telefonie przycisk Pełna lista i szczegóły rozwija dotychczasową tabelę zamówień. Pozwala sprawdzić pozostałe dane i skorzystać z edycji, jeśli konto ma odpowiednie uprawnienie.

Gdzie znaleźć potwierdzenie

Manager lub administrator zobaczy miniaturę w kolumnie Potwierdzenie na liście zamówień. Klient widzi fotografię przy swoim zamówieniu. Kliknięcie miniatury otwiera pełne zdjęcie. Przy potwierdzeniu widnieje data dodania.

Zdjęcia są dostępne po zalogowaniu: dla managera, administratora, klienta będącego właścicielem zamówienia oraz kierowcy, który dodał potwierdzenie. W przypadku zlecenia ponownie przyjętego do realizacji mogą je również obejrzeć operatorzy obsługujący listę przyjętych zadań.

Osoba z prawem edycji może też dołączyć zdjęcie w formularzu Edytuj, ustawiając status Wykonane lub Zakończone. Zapisane potwierdzenie pozostaje przy zleceniu; ponowna edycja nie zastępuje go innym plikiem.

Rozmiar, format i błędy

Obsługiwane są JPG/JPEG, PNG i WebP do 10 MB oraz 40 megapikseli. System przygotowuje kopię JPEG o dłuższym boku do 2048 pikseli i usuwa dodatkowe dane aparatu, w tym informacje EXIF o lokalizacji.

Jeśli plik jest niepoprawny, za duży lub zapis nie powiedzie się, zlecenie nie zostanie oznaczone jako wykonane przez tę próbę. Popraw problem, wybierz zdjęcie ponownie i zatwierdź formularz. Jeśli inna osoba zdążyła już zmienić zlecenie, wróć do listy i sprawdź jego aktualny status.

Brak e-maila klienta nie blokuje potwierdzenia wykonania usługi. Manager uzupełnia dane przed rozliczeniem. Przy statusie Zakończone brak e-maila lub awaria fakturowania powoduje ostrzeżenie; zapisany status i zdjęcie pozostają zachowane.

Programy lojalnościowe

programy-lojalnosciowe.md

Cel funkcji

Programy lojalnościowe pozwalają automatycznie obniżać cenę wywozu dla wybranych klientów. Funkcja działa bez ręcznej zmiany ceny w zamówieniu, dlatego firma może nagradzać stałych klientów bez dodatkowej pracy operatora.

Dla firmy asenizacyjnej oznacza to prostsze utrzymanie klientów długoterminowych. Manager ustawia reguły raz, a system sam rozpoznaje, czy klientowi przysługuje rabat przy składaniu zamówienia.

Dostępne programy

Program częstotliwościowy

Ten program przyznaje zniżkę co N-ty zakończony wywóz klienta. Wartość N oraz procent rabatu ustawia administrator albo manager. Program sprawdza historię zakończonych zamówień i pomaga zachęcać klientów do regularnych powrotów.

Klient nie musi pamiętać o kodzie rabatowym. System sam liczy, który kolejny wywóz kwalifikuje się do rabatu, i pokazuje obniżkę w checkoutcie, kiedy przychodzi odpowiedni moment.

Stały program dla klientów z umową

Stały program daje rabat klientom, którzy mają podpisaną umowę na regularny wywóz. Warunek jest zapisany na koncie użytkownika jako flaga Podpisana umowa na stały wywóz.

To rozwiązanie jest przeznaczone dla klientów długoterminowych, którzy korzystają z usług cyklicznie na podstawie stałej umowy. Klient nie musi wpisywać kodu rabatowego ani prosić obsługi o indywidualną cenę. Jeżeli spełnia warunki programu, zniżka nalicza się automatycznie na każdy wywóz.

Zasada priorytetu

Jeżeli klient spełnia warunki obu programów, system stosuje tylko program stały. Rabat z umowy jest sprawdzany przed rabatem częstotliwościowym.

Przykład: jeżeli klient z umową kwalifikuje się do stałego rabatu 10% i jednocześnie wypada mu rabat częstotliwościowy 5%, system zastosuje rabat 10% z umowy.

Konfiguracja programu częstotliwościowego

Program częstotliwościowy konfiguruje użytkownik z rolą Admin albo Manager. Na ekranie programów lojalnościowych dostępne są:

  • przełącznik ON/OFF, który włącza lub wyłącza program,
  • pole Co ile wywozów przysługuje zniżka, które określa częstotliwość rabatu,
  • pole Wysokość zniżki procentowej, które określa procent obniżki dla wywozu objętego promocją.

Gdy program jest włączony, pola konfiguracji są aktywne, zniżki mogą być naliczane automatycznie, a informacja o promocji może być widoczna na stronie głównej. Zalogowany użytkownik może też widzieć w panelu informację o przyszłej zniżce.

Gdy program jest wyłączony, pola Co ile wywozów przysługuje zniżka oraz Wysokość zniżki procentowej są zablokowane, rabaty nie są naliczane, a informacje promocyjne nie są pokazywane klientom. Zapisane wartości pozostają w systemie i mogą zostać ponownie użyte po włączeniu programu.

Co ile wywozów przysługuje zniżka

Parametr Co ile wywozów przysługuje zniżka określa, co który wywóz klienta będzie objęty rabatem.

Wartość Znaczenie
0 Zniżka częstotliwościowa wyłączona.
1 Każdy wywóz jest objęty zniżką.
2 Co drugi wywóz jest objęty zniżką.
3 Co trzeci wywóz jest objęty zniżką.
4 Co czwarty wywóz jest objęty zniżką.
5 Co piąty wywóz jest objęty zniżką.

Wartość musi być liczbą całkowitą równą 0 lub większą. Wartość 0 oznacza, że częstotliwościowy rabat nie daje realnej zniżki, nawet jeśli program jest włączony.

Konfiguracja stałego programu

Stały program lojalnościowy konfiguruje użytkownik z rolą Admin albo Manager. Na ekranie programów lojalnościowych dostępne są:

  • przełącznik ON/OFF, który włącza lub wyłącza program,
  • pole Wysokość stałej zniżki procentowej, które określa rabat dla klienta z aktywną umową.

Gdy program jest włączony, pole wysokości zniżki jest aktywne, a system może naliczać rabat kwalifikującym się klientom. Gdy program jest wyłączony, pole zniżki jest zablokowane, rabaty nie są naliczane, a komunikaty o stałej zniżce nie powinny być pokazywane klientowi.

Wyłączenie programu nie usuwa informacji o podpisanej umowie z kont klientów. Dzięki temu manager może czasowo zatrzymać naliczanie rabatów i później ponownie włączyć program bez ponownego oznaczania klientów.

Wysokość stałej zniżki

Wysokość stałej zniżki procentowej określa, o ile tańszy będzie każdy wywóz klienta z podpisaną umową. Dozwolony zakres to 0-100%.

Wartość Znaczenie
0 Brak realnej zniżki.
5 Każdy wywóz tańszy o 5%.
10 Każdy wywóz tańszy o 10%.
20 Każdy wywóz tańszy o 20%.
100 Pełna zniżka, czyli wywóz darmowy.

Przykład: jeżeli stała zniżka wynosi 10%, a standardowa cena wywozu to 300 zł, klient z podpisaną umową zapłaci 270 zł.

Flaga umowy przy kliencie

Admin albo manager może oznaczyć klienta jako osobę z podpisaną umową na stały wywóz. Flaga jest widoczna przy użytkowniku, na przykład na liście użytkowników, w szczegółach konta, w edycji danych klienta albo podczas obsługi zamówienia.

W praktyce oznaczenie ma dwa stany:

Stan Znaczenie
TAK Klient ma podpisaną umowę. Jeżeli stały program jest włączony i rabat jest większy niż 0%, system nalicza zniżkę na każdy wywóz.
NIE Klient nie ma podpisanej umowy. System nie nalicza stałej zniżki, nawet gdy program jest włączony.

Dla nowego klienta domyślnym stanem powinno być NIE. Zmianę flagi może wykonać tylko admin albo manager.

Kiedy system nalicza stały rabat

Stały rabat jest naliczany automatycznie, gdy wszystkie warunki są spełnione:

  • stały program lojalnościowy jest włączony,
  • wysokość stałej zniżki jest większa niż 0%,
  • klient ma ustawioną flagę Podpisana umowa na stały wywóz,
  • zamówienie jest składane dla tego klienta.

Jeżeli którykolwiek warunek nie jest spełniony, stały rabat nie zostanie naliczony.

Gdzie klient widzi informację o rabacie

  • Na stronie głównej przy cenniku może pojawić się komunikat o aktywnych promocjach.
  • W checkoutcie zalogowany użytkownik widzi procent rabatu, jeżeli kwalifikuje się do zniżki.
  • W zapisanym zamówieniu system przechowuje cenę przed rabatem i po rabacie.
  • Zalogowany klient z podpisaną umową powinien widzieć w swoim panelu informację o stałej zniżce, np. Masz podpisaną umowę na stały wywóz. Każdy Twój wywóz jest tańszy o 10%.

Informacja o promocji na stronie głównej

Sekcja promocyjna na stronie głównej może informować wszystkich odwiedzających, także niezalogowanych, że firma nagradza regularne zamówienia. To pomaga pokazać wartość korzystania z platformy zamiast jednorazowego kontaktu telefonicznego.

Dla programu częstotliwościowego sekcja jest widoczna, gdy:

  • program częstotliwościowy jest włączony,
  • parametr Co ile wywozów przysługuje zniżka jest większy od 0,
  • parametr Wysokość zniżki procentowej jest większy od 0.

Przykładowa treść:

Program lojalnościowy dla stałych klientów

Korzystasz regularnie z wywozu szamba? W szambook.pl automatycznie nagradzamy stałych klientów. Co 3. wywóz otrzymasz automatyczną zniżkę w wysokości 10%. Nie musisz wpisywać żadnego kodu rabatowego.

Jeżeli program jest wyłączony, wartość częstotliwości wynosi 0 albo wysokość rabatu wynosi 0%, sekcja promocyjna nie powinna być wyświetlana dla tego programu.

Informacja w panelu zalogowanego użytkownika

Zalogowany użytkownik powinien widzieć w swoim panelu informację o tym, kiedy będzie przysługiwać mu kolejna zniżka i jaka będzie jej wysokość. Komunikat zależy od historii zakończonych wywozów klienta oraz aktualnej konfiguracji programu.

Przykłady komunikatów:

  • Twój 3. wywóz będzie tańszy o 10%.
  • Do kolejnej zniżki pozostały Ci 2 wywozy. Twój kolejny rabat wyniesie 10%.
  • Ten wywóz jest objęty programem lojalnościowym. Otrzymujesz 10% zniżki.

Komunikat o przyszłej zniżce jest widoczny, gdy użytkownik jest zalogowany, program częstotliwościowy jest włączony, częstotliwość jest większa od 0, a wysokość rabatu jest większa od 0%.

Przykłady programu częstotliwościowego

Konfiguracja Efekt
ON, co 1 wywóz, 5% Każdy wywóz klienta jest tańszy o 5%.
ON, co 2 wywozy, 10% Co drugi wywóz klienta jest tańszy o 10%.
ON, co 3 wywozy, 15% Co trzeci wywóz klienta jest tańszy o 15%.
OFF, co 3 wywozy, 15% Zniżki nie są naliczane, a informacje promocyjne nie są wyświetlane.

Kto zarządza ustawieniami

Programy lojalnościowe konfiguruje administrator albo manager. Ustawienia obejmują:

  • włączenie lub wyłączenie programu,
  • wysokość zniżki procentowej,
  • wartość N dla programu częstotliwościowego,
  • flagę podpisanej umowy na koncie klienta.

Ważne ograniczenia

  • Rabat jest liczony automatycznie tylko dla zalogowanego użytkownika, dla którego system może sprawdzić historię zamówień albo flagę umowy.
  • Program stały wymaga poprawnie ustawionej informacji o podpisanej umowie na koncie klienta.
  • Program częstotliwościowy wymaga poprawnej historii zakończonych wywozów klienta.
  • Zmiana wysokości rabatu wpływa na kolejne zamówienia. Zamówienia już zapisane zachowują rabat, który został naliczony w chwili ich utworzenia.

Inteligentne przypomnienia SMS

przypomnienia-sms.md

Klient często przypomina sobie o wywozie dopiero wtedy, gdy zbiornik jest pełny. Szambook proponuje kolejny termin na podstawie wykonanych usług. Firma może w ten sposób przypomnieć o sobie stałym klientom, a klient decyduje, kiedy zamówić usługę.

Włączenie przez klienta

W Moich danych zaznacz Chcę otrzymywać przypomnienia SMS na numer z mojego konta i zapisz. Potrzebny jest poprawny polski numer komórkowy. W każdej chwili możesz odznaczyć tę opcję. Zmiana numeru telefonu wyłącza przypomnienia do ponownego włączenia na koncie.

Wiadomość zawiera propozycję terminu i link. Po zalogowaniu na swoje konto możesz przejść do formularza, sprawdzić dane i zmienić datę. Zamówienie powstaje dopiero po zatwierdzeniu formularza. Sam SMS, otwarcie linku i przeglądanie propozycji nie zamawiają usługi. Jeżeli masz już aktywne zamówienie, strona przypomnienia kieruje do jego sprawdzenia.

Ustawienia firmy

Admin i Manager otwierają Panel administracyjny → Przypomnienia SMS. Dostępne są:

  • włączenie przypomnień;
  • tryb próbny: zapisywanie symulacji bez wysyłki;
  • opóźnienie od prognozowanego terminu, od 0 do 365 dni;
  • godziny wysyłki w strefie czasowej firmy, np. 9–18; końcowa godzina jest wyłączona z przedziału;
  • odstęp między przypomnieniami, od 1 do 90 dni;
  • limit od 1 do 5 prób do kolejnego wywozu.

Domyślnie przypomnienia są wyłączone, tryb próbny włączony, godziny to 9–18, odstęp 7 dni, a limit 2 próby. W demo system symuluje tylko automatyczne przypomnienia o wywozie. SMS-y z kodami logowania i rejestracji oraz powiadomieniami o zamówieniach są wysyłane normalnie, jeśli skonfigurowano operatora SMS i podano prawidłowy numer. Administrator wdrożenia musi wcześniej ustawić publiczny adres strony firmy i zapewnić działanie aplikacji IIS w tle.

Jak wyznaczany jest termin

System bierze pod uwagę ostatnie 12 różnych dni realizacji z maksymalnie 50 ostatnich wykonanych/zakończonych zleceń klienta. Wylicza średni odstęp i dodaje go do ostatniego wywozu. Wymagane są co najmniej dwa różne dni. Anulowane, niewykonane i przyszłe realizacje nie służą do prognozy.

Prognoza jest szacunkiem z historii konta, a nie pomiarem zbiornika ani rezerwacją terminu w grafiku firmy. Zamówienia z różnych adresów tego samego konta są obecnie liczone razem. Przy braku historii system nie podaje wymyślonego terminu i nie wysyła przypomnienia. Jeśli prognozowana data już minęła, SMS proponuje następny dzień.

Przypomnienia są pomijane dla zablokowanych kont, klientów bez włączonej opcji, niepoprawnych numerów oraz klientów z zamówieniem Nowe lub W realizacji. Kolejny wykonany wywóz rozpoczyna nowy cykl przypomnień.

Historia wysyłek

Panel pokazuje ostatnie 100 prób z datą UTC, klientem, numerem, proponowanym terminem, treścią i wynikiem. Przyjęty przez operatora oznacza przyjęcie SMS-a do wysyłki, a nie potwierdzenie odczytu lub dostarczenia. Przy błędzie albo braku pewnego wyniku próba jest zachowana i nie jest natychmiast ponawiana. Wszystkie próby wykorzystują limit danego cyklu. Symulacje mają osobny limit, więc test nie zużywa limitu rzeczywistych wiadomości.

System ogranicza wysyłkę do jednej próby na numer dziennie. Długa wiadomość może być rozliczana przez operatora jako kilka części SMS; limit dotyczy przypomnień. Link traci aktualność po kolejnym wykonanym wywozie albo po 90 dniach.

Własna strona dla firmy asenizacyjnej

strona-dla-firm.md

Firma asenizacyjna potrzebuje miejsca, w którym klient znajdzie ofertę, dane kontaktowe i możliwość zamówienia usługi. Szambook łączy taką stronę z systemem obsługi zleceń. Dzięki temu firma prezentuje własną markę i porządkuje zamówienia w jednym narzędziu.

Oferta i system Twojej firmy

szambook.pl przedstawia korzyści, funkcje i pakiety dla firm asenizacyjnych. Przycisk Zobacz demo prowadzi do oddzielnego systemu demonstracyjnego.

Docelowa strona firmy służy jej własnym klientom. To na niej znajdują się oferta wywozu, zamówienia oraz konta i panele użytkowników. Logowanie i administracja należą do tego systemu.

Wybór pakietu

Pakiet Cena Dla kogo
Subdomena (Standard) 199 zł netto / miesiąc za firmę Własna strona pod adresem twoja-firma.szambook.pl.
Własna domena 249 zł netto / miesiąc za firmę Firma korzystająca ze swojego adresu, np. twoja-firma.pl.
Własny szablon UI Wycena indywidualna Firma potrzebująca indywidualnego wyglądu strony i interfejsu.

Pakiet Standard obejmuje zamówienia i płatności online, panel zespołu i historię zleceń, integrację z Fakturownia.pl oraz automatyczne rabaty lojalnościowe. Własna domena obejmuje funkcje Subdomeny i podłączenie adresu firmy. Zakres i koszt własnego szablonu UI ustalamy indywidualnie.

Oferta dla pierwszych firm

Pierwsza firma partnerska w pakiecie Subdomena otrzymuje uruchomienie i 60 dni pilotażu za 0 zł. Następnie abonament wynosi 99 zł netto miesięcznie przez 12 miesięcy. Konfiguracja w tym pakiecie jest bezpłatna dla pierwszych trzech firm.

Indywidualne modyfikacje i nowe integracje mają osobną wycenę. SMS-y, abonament Fakturowni i prowizje operatora płatności są płatne osobno. Integracje wymagają konfiguracji dostawców. Warunki oferty potwierdzimy podczas kontaktu.

Jak zgłosić swoją firmę

  1. Wybierz Wypróbuj, aby poznać rozwiązanie dla swojej firmy, albo Wybierz pakiet, aby zgłosić chęć zamówienia wdrożenia.
  2. Podaj nazwę firmy i opcjonalnie obszar działania.
  3. Możesz dodać logo PNG, JPG lub WebP do 2 MB. Podgląd pokazuje nazwę, logo i proponowany adres.
  4. Wybierz pakiet i zaproponuj adres. Możesz wskazać własną domenę. Dostępność adresu potwierdzimy podczas kontaktu.
  5. Podaj osobę do kontaktu, e-mail i telefon. Opcjonalnie opisz potrzeby firmy.
  6. Kliknij Wyślij zgłoszenie. Po zapisaniu zobaczysz potwierdzenie z numerem zgłoszenia.

Zgłoszenie pozwala przygotować rozmowę o Twojej firmie i dobrać zakres wdrożenia. Skontaktujemy się w sprawie kolejnych kroków. Formularz nie uruchamia płatnej usługi ani nie tworzy automatycznie gotowej strony.

Jeśli formularz zgłasza błąd

Popraw wskazane pola i wyślij formularz ponownie. Dane tekstowe zostają na stronie; plik logo należy wybrać ponownie. Jeśli zapis się nie powiedzie, ponów próbę lub użyj adresu e-mail w sekcji Kontakt.

GÓRA