e-Hurtownia — Podręcznik Przedstawiciela Handlowego
Dokumentacja

Podręcznik Przedstawiciela

Wszystko co musisz wiedzieć żeby sprawnie pracować w systemie — od przeglądania katalogu przez składanie zamówień w imieniu klientów, aż po raportowanie aktywności i zarządzanie zadaniami.

👤 Rola: shop_manager 📋 12 modułów ✓ Plan Pro
🛒

Katalog produktów

[hurt_grid]/katalog/

Główna strona zakupów. Widzisz tu wszystkie produkty hurtowni z cenami i dostępnością. Klienci widzą swoje ceny tierowe — Ty jako rep widzisz ceny katalogowe.

Wyszukiwanie i filtry

  • Pole wyszukiwania — szuka po nazwie produktu, SKU i opisie. Wyniki pojawiają się na bieżąco (AJAX).
  • Filtr kategorii — rozwijana lista kategorii WooCommerce. Kliknięcie filtruje siatkę bez przeładowania strony.
  • Sortowanie — domyślnie według kolejności w sklepie; możliwe sortowanie po nazwie i cenie.

Koszyk AJAX

Produkty dodajesz bezpośrednio z siatki — bez przechodzenia na kartę produktu. Licznik sztuk aktualizuje się w czasie rzeczywistym. Kliknięcie w nazwę lub zdjęcie otwiera pełną kartę produktu z zakładkami i PDF-em.

💡
Pakiety i kapsułki Jeśli admin włączył moduł pakietów — w siatce zobaczysz specjalne karty pakietów z rabatem całościowym. Kapsułki lojalnościowe naliczają się automatycznie przy dodawaniu produktów do koszyka.

Tiery cenowe i rabaty

Na karcie produktu widoczne są progi ilościowe — im większa ilość, tym niższa cena jednostkowa. Tiery są konfigurowane przez administratora per produkt lub globalnie. Rabat dla konkretnego klienta możesz przyznać dopiero na etapie pre-checkoutu.

📦

Składanie zamówień

[hurt_checkout]/zamow/

Pre-checkout to Twoje główne narzędzie do składania zamówień w imieniu klientów. Klient sam nie widzi tej strony — to panel wyłącznie dla repów i adminów.

Jak złożyć zamówienie krok po kroku

1
Skompletuj koszyk w kataloguPrzejdź do /katalog/ i dodaj produkty dla klienta. Koszyk jest wspólny — jeden aktywny koszyk na raz.
2
Kliknij "Przejdź do zamówienia"Przycisk w koszyku przenosi Cię na stronę /zamow/ — tu zaczyna się pre-checkout.
3
Wybierz klientaWyszukiwarka klientów — możesz filtrować między "Moi klienci" a "Wszyscy". Wpisz imię, firmę lub email.
4
Przyznaj rabat (opcjonalnie)Masz przyznany limit rabatowy przez admina (np. 10%). Suwak pozwala przyznać od 0 do Twojego maksimum — z uwzględnieniem rabatów które już są w koszyku (tiery, promocje).
5
Wybierz adres dostawyPokazują się zapisane adresy klienta. Możesz wybrać jeden z listy lub wpisać nowy.
6
Złóż zamówieniePrzycisk "Złóż zamówienie w imieniu klienta" finalizuje zakup. Klient dostaje email z potwierdzeniem. Zamówienie pojawia się w jego historii i w WooCommerce.

Limit rabatowy

⚠️
Łączny rabat nie może przekroczyć progu ustawionego przez admina System zlicza już istniejące rabaty w koszyku (tiery, kupony) i odejmuje je od Twojego limitu. Jeśli produkt ma już 15% rabatu tierowego, a Twój limit to 10% — nie możesz przyznać dodatkowego rabatu, bo łączny przekroczyłby próg całkowity.

Adresy płatnika i dostawy

Po wybraniu klienta pojawiają się dwa dropdowny — adres płatnika (faktura) i adres dostawy. Możesz wybrać jeden z zapisanych adresów klienta lub dodać nowy bezpośrednio z poziomu pre-checkoutu.

+
Kliknij "+ Dodaj płatnika" lub "+ Dodaj adres dostawy"Przycisk otwiera formularz z polami adresowymi — firma, ulica, kod pocztowy, miasto, kraj.
2
Wypełnij pola i zapiszNowy adres zostaje zapisany w książce adresowej klienta i od razu pojawia się na liście jako wybrany.
3
Adres dostępny też w CRMKażdy adres dodany podczas zamawiania jest widoczny w profilu klienta w /moi-klienci/ — nie trzeba go wpisywać drugi raz.
💡
Przydatne w terenie Klient podaje nowy adres magazynu podczas rozmowy — wpisujesz go od razu w trakcie składania zamówienia, bez wychodzenia do CRM.

Płatności odroczone

Jeśli klient ma przyznaną płatność odroczoną (np. 14 lub 30 dni), na pre-checkoucie pojawi się opcja "Przelew — termin X dni". W przypadku zaległości opcja znika i klient musi zapłacić natychmiast. O wyjątek od tej zasady możesz wnioskować do Księgowego.

👥

Moi klienci (CRM)

[hurt_klienci]/moi-klienci/

Panel CRM to Twoja baza klientów 360°. Widzisz tylko klientów przypisanych do Ciebie jako opiekun. Możesz tu zarządzać danymi, historią zamówień, notatkami i adresami.

Lista klientów

  • Wyszukiwarka — szukaj po nazwie firmy, imieniu, emailu lub NIP-ie.
  • Tagi CRM — możesz przypisać dowolne tagi do klienta (np. "VIP", "nowy", "ryzyko rezygnacji"). Tagi są widoczne na liście i w profilu.
  • Eksport CSV — pobierz historię zamówień wybranego klienta do pliku CSV.

Profil klienta 360°

Kliknięcie w klienta otwiera jego profil. Znajdziesz tu:

ZakładkaCo zawiera
📋 Dane firmyNazwa, NIP, adres, kontakt. Dane pobrane z GUS przy rejestracji.
📦 Historia zamówieńWszystkie zamówienia klienta z datą, wartością i statusem. Kliknięcie otwiera szczegóły w WooCommerce.
📝 NotatkiPrywatne notatki repa — widoczne tylko dla Ciebie i admina. Zapisuj ustalenia po rozmowach.
🏷 TagiDodawanie i usuwanie tagów CRM. Pole tekstowe + Enter lub kliknięcie przycisku.
📍 Adresy dostawyLista zapisanych adresów klienta. Możesz dodać nowy adres lub usunąć istniejący.
💰 Rabat klientaDo wglądu — widzisz jaki rabat ma klient: indywidualny, grupowy i progowy. Efektywny (najwyższy) jest wyróżniony. Zmiana rabatu indywidualnego lub przypisania do grupy należy do administratora.
ℹ️
Skąd pochodzi rabat klienta? System stosuje zasadę max(indywidualny, grupowy, progowy) — klient zawsze dostaje najwyższy z dostępnych rabatów. W profilu zobaczysz wszystkie trzy wartości naraz, żebyś wiedział dlaczego klient ma taki a nie inny rabat i czy warto rozmawiać o grupie lub progu.

Wniosek o wyjątek płatności

Jeśli klient ma zablokowaną opcję płatności odroczonej (zaległości), możesz wnioskować o jednorazowy wyjątek. Otwórz profil klienta → przycisk "Wnioskuj o wyjątek" → wpisz uzasadnienie (wymagane) → wniosek trafia do panelu księgowego. Po zatwierdzeniu klient może złożyć jedno zamówienie na odroczenie.

➕

Dodaj klienta

[hurt_dodaj_klienta]/dodaj-klienta/

Formularz do rejestrowania nowych klientów B2B. W odróżnieniu od publicznego formularza rejestracji — konto zakładane przez repa jest od razu aktywne, bez czekania na zatwierdzenie przez admina.

Rejestracja przez NIP

1
Wpisz NIP firmySystem odpytuje GUS (REGON) i automatycznie wypełnia nazwę firmy, adres siedziby i formę prawną.
2
Uzupełnij dane kontaktoweImię i nazwisko osoby kontaktowej, email (będzie loginiem), telefon. Email musi być unikalny w systemie.
3
Przypisz opiekunaDomyślnie Ty. Możesz zmienić na innego repa jeśli zakładasz konto dla kolegi.
4
Kliknij "Utwórz konto"Klient dostaje email z linkiem do ustawienia hasła. Konto jest od razu aktywne — może się zalogować i zamówić.
ℹ️
Klient zarejestrowany przez ten formularz pojawi się od razu na liście "Moi klienci" — nie trzeba czekać na zatwierdzenie przez administratora.
📈

Klienci przy progu

[hurt_turnover_watch]/klienci-przy-progu/
🔑
Dostępne gdy admin aktywuje moduł Rabaty progowe (plan Business lub addon).

Operacyjna lista Twoich klientów posortowana według odległości od następnego progu rabatowego. Widok zaprojektowany jako argument sprzedażowy — widzisz od razu do kogo zadzwonić, żeby domknąć obrót przed końcem okresu.

Co widzisz w tabeli

KolumnaCo oznacza i jak używać
FirmaNazwa klienta — kliknięcie otwiera profil w CRM.
Obrót bieżącySuma netto zakupów z aktualnego okna czasowego (np. ostatnie 3 miesiące). Licznik rośnie w czasie rzeczywistym przy każdym nowym zamówieniu.
PostępPasek wizualizujący ile procent drogi do następnego progu zostało przebyte. Zielony = blisko.
Brakuje do proguNajważniejsza kolumna. Konkretna kwota netto dzieląca klienta od następnego rabatu — idealny argument w rozmowie: „Jeszcze 2 400 zł i przechodzisz na 8%."
Aktualny rabatRabat progowy który klient ma w tym miesiącu (przyznany na podstawie poprzedniego okresu). Może być 0% jeśli klient nie osiągnął żadnego progu.

Filtry i sortowanie

  • Osiągnięty próg — klienci którzy już zdobyli rabat. Warto do nich dzwonić żeby utrzymać obrót.
  • Blisko progu — klienci w zasięgu jednego lub dwóch zamówień od następnej zniżki. Priorytet sprzedażowy.
  • Bez obrotu — klienci nieaktywni w bieżącym oknie. Okazja do reaktywacji.
  • Domyślnie widzisz tylko swoich klientów. Admin ma możliwość podglądu wszystkich.

Jak używać w praktyce

1
Wejdź w filtr "Blisko progu"Posortuj po kolumnie "Brakuje do progu" rosnąco — na górze lista klientów których jedno zamówienie może przeskoczyć próg.
2
Zadzwoń z konkretną liczbąPowiedz klientowi dokładnie ile brakuje i jaką zniżkę zyska. Klient sam się motywuje — nie musisz nic oferować extra.
3
Złóż zamówienie przez pre-checkoutKlient decyduje się od razu — otwierasz /zamow/ i składasz zamówienie zanim odłożysz telefon.
4
Rabat aktywuje się od następnego miesiącaSystem automatycznie przelicza obrót na początku nowego miesiąca i przyznaje rabat. Klient nie musi nic robić.
⚠️
Pamiętaj o oknie czasowym Jeśli admin ustawił okno 3-miesięczne, liczy się obrót z ostatnich 3 pełnych miesięcy — nie tylko bieżący miesiąc. Sprawdź w panelu admina jaki okres obowiązuje, żeby podawać klientom właściwy kontekst.
🏆

Rabat progowy — widok klienta

Każdy klient widzi swój status rabatowy bezpośrednio w Moje konto → Rabaty progowe. Oznacza to, że klient sam rozumie skąd pochodzi jego rabat i co musi zrobić żeby zdobyć następny poziom — bez dzwonienia do Ciebie po wyjaśnienia.

Co widzi klient na swoim koncie

ElementCo pokazujeTwoja rola
🆕 Hero — aktualny rabatDuży procent rabatu obowiązującego w tym miesiącu. Zielony gdy > 0%. Pod spodem: „Za obrót styczeń–marzec 2026: 34 500 zł"Brak — nalicza się automatycznie.
📈 Obrót z okresuSuma netto z bieżącego okna z etykietą zakresu dat.Motywuj klienta do rozmowy o progu — ma konkretną liczbę przed oczami.
▮ Pasek postępuWizualizacja obrotu względem następnego progu.Pokaż klientowi widok Moje konto podczas wizyty — pasek robi robotę sprzedażową za Ciebie.
💡 Callout "brakuje"„Brakuje X zł do Y%" — pojawia się gdy klient nie osiągnął jeszcze najwyższego progu.Użyj tej liczby w rozmowie telefonicznej — mówisz to samo co system.
📋 Tabela progówWszystkie skonfigurowane progi z zaznaczeniem osiągniętych (✓).Klient widzi do czego dąży bez pytania Ciebie.

Kiedy rabat progowy jest aktywny

Rabat przyznawany jest raz na miesiąc na początku nowego okresu rozliczeniowego, na podstawie obrotu z poprzedniego okna. Obowiązuje przez cały miesiąc — niezależnie od tego ile klient zamówi w tym czasie.

ℹ️
Przykład Klient zamówił w Q1 łącznie 28 000 zł netto (okno 3-miesięczne, próg 25 000 zł = 5%). W kwietniu automatycznie dostaje 5% rabatu na wszystkie zamówienia — bez żadnej akcji z Twojej strony.

Jak rabat progowy współpracuje z innymi rabatami

System zawsze stosuje max(indywidualny, grupowy, progowy) — klient dostaje najwyższy z dostępnych. Rabaty się nie sumują.

SytuacjaEfektywny rabat
Indywidualny 5%, grupowy 3%, progowy 8%8% (progowy)
Indywidualny 10%, grupowy 3%, progowy 8%10% (indywidualny)
Indywidualny 0%, grupowy 5%, progowy 0%5% (grupowy)
Wszystkie 0% (np. nowy klient)0% — cena katalogowa
💡
Praktyczna wskazówka Jeśli klient pyta dlaczego jego rabat się nie zmienił mimo wzrostu obrotu — sprawdź w CRM czy nie ma wyższego rabatu indywidualnego, który "zasłania" rabat progowy.
💬

Komunikator

[hurt_chat]/komunikator/

Wbudowany system wiadomości między Tobą, klientami i adminem. Zastępuje email w codziennej komunikacji operacyjnej — pytania o produkty, potwierdzenia zamówień, reklamacje.

Co widzisz jako rep

  • Wątki swoich klientów — widzisz konwersacje tylko z klientami przypisanymi do Ciebie. Admin widzi wszystkie wątki.
  • Licznik nieprzeczytanych — ikona 💬 w menu (shortcode [hurt_chat_badge]) pokazuje liczbę nowych wiadomości. Aktualizuje się automatycznie.
  • Powiadomienia push — jeśli zainstalowałeś aplikację PWA na telefonie, dostaniesz powiadomienie o nowej wiadomości nawet gdy masz zamkniętą przeglądarkę.

Badge w menu

Shortcode [hurt_chat_badge url="/komunikator/"] wyświetla pływającą ikonkę z licznikiem. Wstaw go w nagłówku strony lub w menu bocznym — kliknięcie przenosi bezpośrednio do komunikatora.

📊

Moje wyniki

[hurt_moje_wyniki]/moje-wyniki/
🔑
Dostępne od planu Pro.

Dashboard Twoich własnych statystyk sprzedaży. Widzisz tylko swoje dane — admin może w tym samym module przełączać się między repami.

Dostępne metryki

MetrykaOpis
💰 Obroty WCSuma zamówień złożonych przez Twoich klientów w wybranym okresie (zliczone z WooCommerce).
📦 Liczba zamówieńIlość zamówień w okresie — z podziałem na statusy (completed / processing).
👥 Ranking klientówKtórzy klienci kupili najwięcej — pomocne przy planowaniu wizyt i priorytetyzacji kontaktów.
📈 Wykres miesięcznyTrend sprzedaży miesiąc do miesiąca. Widoczny gdy filtrujesz po roku.

Filtrowanie

Możesz filtrować dane po miesiącu (wybierz rok i miesiąc) lub po roku (widzisz wtedy pełny trend roczny z wykresem). Dane ładują się przez AJAX — zmiana filtru nie przeładowuje strony.

📝

Raporty aktywności

[hurt_raport]/raporty/
🔑
Dostępne od planu Pro. Admin widzi raporty wszystkich repów.

Tutaj rejestrujesz swoją aktywność — każdy telefon, spotkanie, wysłaną ofertę. To Twój dziennik pracy widoczny dla przełożonego w dashboardzie zarządczym.

Typy zdarzeń

TypKiedy używać
📞 TelefonKażda rozmowa telefoniczna z klientem lub prospektem.
🤝 SpotkanieWizyta u klienta, spotkanie stacjonarne lub online.
📄 OfertaWysłanie oferty cenowej lub wyceny.
📸 Nowy kontaktPierwszy kontakt z nowym prospektem — tworzy wpis w pipeline.
📦 Zamówienie poza systememZamówienie złożone poza hurtownią (telefon, email, EDI). Wpisz wartość ręcznie — pojawi się w statystykach jako "Poza systemem".
⚠️ ReklamacjaZgłoszenie reklamacyjne od klienta — rejestruj dla celów analitycznych.

Pipeline prospektów

Obok zakładki raportów masz zakładkę Prospekty — listę potencjalnych klientów których prowadzisz do rejestracji. Każdy prospekt ma status:

StatusZnaczenie
NowyŚwieży kontakt, jeszcze bez ustaleń.
W kontakcieTrwa rozmowa, zainteresowany ale niezarejestrowany.
Do rejestracjiUstalono warunki, czeka na założenie konta.
ZarejestrowanyProspekt stał się klientem — sukces.
OdrzuconyProspekt zrezygnował lub nie był odpowiedni.
ℹ️
Prospekt tworzysz automatycznie przy raporcie typu "Nowy kontakt" — wpisz nazwę firmy i dane kontaktowe. Możesz też dodać prospekta ręcznie z zakładki Prospekty bez tworzenia raportu.

Jak dodać raport

1
Wybierz typ zdarzeniaKliknij jeden z przycisków (Telefon, Spotkanie, Oferta itd.).
2
Przypisz do klienta lub prospektaWyszukaj istniejącego klienta lub wpisz nową firmę — zostanie automatycznie dodana do pipeline'u jako prospekt.
3
Wpisz notatkę (opcjonalnie)Krótkie podsumowanie rozmowy — co ustalono, co do zrobienia. Widoczne w historii kontaktów klienta.
4
ZapiszRaport pojawia się w Twojej historii i w dashboardzie prezesa/admina.

📍 Lokalizacja GPS przy raporcie

🔑
Dostępne gdy admin aktywuje moduł Lokalizacja raportów w panelu systemowym.

Jeśli moduł GPS jest aktywny, przy zapisywaniu raportu system prosi o pozwolenie na dostęp do lokalizacji telefonu. Po zaakceptowaniu w tabeli raportów (widok admina i Twój) pojawia się link do Google Maps pokazujący gdzie byłeś w momencie zapisu.

ScenariuszCo się dzieje
✓ Pozwoliłeś na GPSRaport zapisuje się z lokalizacją. W tabeli pojawia się ikona 📍 z linkiem do Google Maps.
✗ Odmówiłeś GPSRaport zapisuje się normalnie, bez lokalizacji. Nie blokuje wysłania raportu.
Brak sygnału GPSSystem informuje o błędzie lokalizacji. Raport zapisuje się bez współrzędnych.
⚠️
Ważne Dane lokalizacyjne widzi admin i przełożony. Są przechowywane przez okres ustawiony przez administratora (zazwyczaj 30–90 dni), po czym usuwane automatycznie. Wyrażenie zgody na GPS jest dobrowolne przy każdym raporcie.
🗺️

Planowanie trasy

[hurt_planner]/planowanie-trasy/
🔑
Dostępne od planu Business lub jako addon do planu Pro.

Narzędzie do planowania trasy wizyt u klientów. Zaznaczasz klientów których chcesz odwiedzić, układasz kolejność przystanków i jednym kliknięciem otwierasz optymalną trasę w Google Maps — bez ręcznego wpisywania adresów.

Jak zaplanować trasę

1
Wejdź na stronę Planowanie trasyDomyślnie widzisz Moich klientów — tylko tych przypisanych do Ciebie. Przełącz na Wszyscy klienci gdy chcesz odwiedzić klienta kolegi.
2
Wyszukaj i dodaj klientówUżyj wyszukiwarki lub przewijaj posortowaną listę (miasto → nazwa). Kliknij + przy kliencie — trafia do panelu trasy po prawej stronie. Pierwszy 30 klientów widocznych domyślnie, pozostali po kliknięciu "Pokaż więcej".
3
Ułóż kolejność przystankówW panelu trasy (prawa strona) przeciągnij przystanki w dowolną kolejność. Na telefonie używasz strzałek ↑↓ zamiast przeciągania. Każdy przystanek ma numer — Google Maps respektuje tę kolejność.
4
Ustaw punkt startowy (opcjonalnie)Wpisz adres startowy lub kliknij 📍 Moja lokalizacja — GPS przeglądarki wypełni pole automatycznie. Bez punktu startowego Google Maps ustawi optymalny start samodzielnie.
5
Kliknij "Otwórz trasę w Google Maps"Maps otwiera się w nowej karcie z wszystkimi przystankami w Twojej kolejności. Możesz tam jeszcze zmienić kolejność lub dodać nawigację głosową.

Wskazówki praktyczne

SytuacjaCo zrobić
Chcesz odwiedzić klienta kolegiPrzełącz toggle na Wszyscy klienci. Adresy wszystkich klientów są dostępne.
Klient nie pojawia się na liścieBrak adresu w systemie — uzupełnij go w profilu klienta w CRM przed planowaniem.
Maks. 10 przystankówOgraniczenie Google Maps dla bezpłatnych URL. Jeśli masz więcej klientów — zaplanuj trasę w dwóch turach.
Chcesz zacząć od konkretnego miastaWpisz miasto lub adres jako punkt startowy — Maps poprowadzi trasę od tego miejsca.
Dodałeś klienta przez pomyłkęKliknij ✕ przy przystanku w panelu trasy — wraca na listę jako dostępny do dodania.
ℹ️
Trasy nie są zapisywane Planer to jednorazowe narzędzie — otwierasz Maps, jedziesz, koniec. Jeśli chcesz powtórzyć tę samą trasę następnym razem — zaznacz tych samych klientów i kliknij ponownie.
✅

Zadania

[hurt_tasks]/zadania/
🔑
Dostępne od planu Pro. Admin widzi zadania wszystkich repów.

Prosta lista zadań do zarządzania własną pracą — follow-upy, przypomnienia, rzeczy do zrobienia z klientami.

Dodawanie zadania

Wpisz tytuł zadania i kliknij + Dodaj. Przycisk ⚙️ Więcej opcji rozwija dodatkowe pola:

PoleOpis
📝 NotatkaSzczegóły zadania — co dokładnie trzeba zrobić, ustalenia z klientem.
👤 KlientPrzypisz zadanie do konkretnego klienta z Twojej listy. Ułatwia filtrowanie per klient.
⏰ AlertData i godzina przypomnienia. Jeśli masz PWA na telefonie — dostaniesz powiadomienie push.
🔥 PriorytetNormalny / Ważny / Pilny. Pilne zadania wyróżnione są kolorem na liście.

Statusy i priorytety

  • Kliknięcie w checkbox oznacza zadanie jako zrobione — trafia na koniec listy z przekreśleniem.
  • Kliknięcie w tytuł zadania otwiera tryb edycji — możesz zmienić wszystkie pola.
  • Zadania sortowane są: najpierw Pilne → Ważne → Normalne, w ramach priorytetu według daty alertu.
  • Zadania przeterminowane (alert w przeszłości, niezrobione) wyróżnione są czerwonym oznaczeniem.