KCPosManager — dokumentacja użytkownika

Szybki start

KCPosManager przechowuje centralną listę użytkowników w wybranej bazie głównej, a następnie wysyła ją do baz stanowisk POS.

1

Wskaż bazę główną

Przy pierwszym uruchomieniu wybierz bazę zawierającą tabelę uzytkownicy.

2

Skonfiguruj kasy

W menu Ustawienia dodaj nazwy stanowisk i ścieżki do ich baz.

3

Utwórz użytkowników

Dodaj konta, określ dostęp i zaznacz wymagane uprawnienia.

4

Sprawdź dane

Wyszukaj użytkownika, zweryfikuj numer kasjera i zestaw uprawnień.

5

Programuj kasy

Na zakładce Programowanie zaktualizuj jedną kasę albo wszystkie stanowiska.

6

Zweryfikuj status

Przy każdej bazie powinien pojawić się status Zaktualizowano OK.

Przed pierwszą synchronizacjąWykonaj kopię zapasową bazy głównej i baz stanowisk POS. Program wykonuje bezpośrednie operacje na tabelach baz danych.

Wymagania i pliki programu

Środowisko

system Windows,
dostęp do lokalnych lub sieciowych plików baz,
provider Microsoft Access zgodny z aplikacją Win32,
uprawnienia do odczytu i zapisu baz oraz katalogu programu.

Obsługiwane bazy

*.accdb — Microsoft Access,
*.mdb — Microsoft Access,
*.dan — baza używana przez środowisko KCPos.

Plik konfiguracyjny

Program zapisuje ustawienia w pliku KCPosManager.ini znajdującym się obok pliku EXE. Zapamiętywane są:

ścieżka do bazy głównej,
lista nazw i ścieżek baz stanowisk POS,
pozycja, rozmiar i stan okna.

Przenoszenie programuJeżeli EXE zostanie przeniesiony do innego katalogu bez pliku INI, przy następnym uruchomieniu program ponownie poprosi o wskazanie bazy i konfigurację kas.

Interfejs programu

Obszar	Przeznaczenie
Zakładka Użytkownicy	Lista kont, wyszukiwarka, podgląd danych i uprawnień oraz przyciski Nowy i Edycja.
Zakładka Programowanie	Lista skonfigurowanych kas, wynik ostatniej operacji oraz programowanie wszystkich stanowisk.
Program → Zakończ	Zamyka aplikację po dodatkowym potwierdzeniu.
Ustawienia → Konfiguracja baz danych stanowisko POS	Dodawanie, zmiana i usuwanie ścieżek baz kas.
Ustawienia → Baza danych programu KCPosManager	Zmiana centralnej bazy użytkowników.
Pomoc → O Programie	Wyświetla nazwę produktu, autora i wersję odczytaną z pliku EXE.

Wyszukiwanie i sortowanie

Wyszukiwanie użytkownika

Kliknij pole Wyszukaj użytkownika… nad tabelą.
Wpisz fragment statusu, nazwy, nazwiska, imienia albo kodu.
Wybierz znaleziony wiersz. Panel poniżej pokaże pełne dane i uprawnienia.
Użyj przycisku Wyczyść, aby ponownie pokazać całą listę.

Sortowanie

Kliknij nagłówek kolumny Status, Nazwa, Nazwisko, Imię lub Kod. Ponowne kliknięcie odwraca kierunek sortowania. Początkowo dane są pobierane według numeru kasjera.

Szybka edycjaDwukrotne kliknięcie wiersza otwiera formularz edycji wybranego użytkownika.

Zarządzanie użytkownikami

Dodawanie użytkownika

Na zakładce Użytkownicy kliknij Nowy.
Wprowadź nazwę użytkownika i hasło — oba pola są wymagane.
Opcjonalnie wpisz imię i nazwisko.
Sprawdź zaproponowany numer kasjera.
Wybierz poziom dostępu: Zablokowany, Normalny albo Administrator.
Ustaw uprawnienia ręcznie lub skopiuj je od istniejącego użytkownika.
Kliknij Zapisz.

Pole	Wymaganie	Znaczenie
Nazwa	Wymagana i unikalna	Identyfikator/nazwa użytkownika, np. `101`.
Hasło	Wymagane i unikalne	Hasło nie może być używane przez inne konto.
Imię, nazwisko	Opcjonalne	Dane opisowe ułatwiające identyfikację kasjera.
Numer kasjera	Zalecany unikalny	Klucz używany do dopasowania rekordów podczas programowania kas.
Dostęp	Domyślnie Normalny	Status konta przesyłany do stanowiska POS.

Automatyczny numerDla nowego konta program proponuje pierwszy wolny numer wynikający z luki w istniejącej numeracji. W pustej bazie lub po błędzie zapytania proponowana jest wartość 1.

Limit kontBaza może zawierać maksymalnie 99 użytkowników. Po osiągnięciu limitu program blokuje dodawanie kolejnego konta.

Edycja użytkownika

Zaznacz użytkownika i kliknij Edycja albo kliknij jego wiersz dwukrotnie. Po zapisaniu lista zostanie odświeżona, a zmodyfikowane konto pozostanie wybrane.

Statusy dostępu

Zablokowany

Kod statusu 1. Konto jest przekazywane do kas jako zablokowane.

Normalny

Kod statusu 2. Standardowe konto kasjera.

Administrator

Kod statusu 10. Konto administracyjne KCPos.

Uprawnienia użytkownika

Uprawnienia są przechowywane jako 50-pozycyjny zestaw flag. Formularz pozwala zarządzać nimi bez znajomości technicznego zapisu.

Narzędzia zbiorcze

Zaznacz/Odznacz Wszystko — jednocześnie zmienia wszystkie widoczne uprawnienia.
Kopiuj uprawnienia z… — wybierz użytkownika z listy i kliknij Kopiuj uprawnienia. Kopiowane są wyłącznie uprawnienia; dane osobowe, hasło, status i numer kasjera pozostają bez zmian.

Kasa i szuflada

Otwarcie szuflady po paragonie
Otwarcie szuflady przy wpłacie/wypłacie
Otwarcie szuflady klawiszem „SZUFLADA”
Podgląd stanu kasy
Wpłata do kasy
Wypłata z kasy
Wypłata CASHBACK
Otwarcie szuflady po zapłacie rachunku (KC-EP)

Sprzedaż i towary

Wejście na listę towarów
Informacja o towarze (F5)
Anulowanie pozycji na paragonie
Anulowanie paragonu
Przeniesienie do bufora
Wyciągnięcie pozycji z bufora
System kaucyjny

Zmiany i raporty

Wykonywanie raportu dobowego na drukarce fiskalnej
Zakończenie pracy kasjera / zamknięcie zmiany
Otwarcie zamkniętej zmiany każdego kasjera
Otwarcie zamkniętej zmiany tylko własnej
Rozliczenia zmian archiwalnych
Raport o kasjerach
Raport „Paragony anulowane”
Raport „Opakowania zwrotne”

Funkcje dodatkowe

Modyfikowanie kursu euro
Wejście na listę użytkowników
Wejście na listę doładowań telefonicznych
Usunięcie pozycji z kolejki wysyłek DRS
APos — rabat pracowniczy
APos — udzielanie rabatów

Konfiguracja baz danych

Baza główna KCPosManager

Wybierz Ustawienia → Baza danych programu KCPosManager.
Wskaż właściwy plik bazy.
Po udanym połączeniu program zapamięta ścieżkę i ponownie wczyta użytkowników.

Zmiana bazy głównejTo właśnie z tej bazy dane są wysyłane do kas. Przed programowaniem upewnij się, że na zakładce Użytkownicy widoczny jest właściwy zestaw kont.

Bazy stanowisk POS

Wybierz Ustawienia → Konfiguracja baz danych stanowisko POS.
Podaj czytelną nazwę stanowiska, np. Kasa 01.
Wpisz ścieżkę lub użyj przycisku …, aby wskazać plik.
Kliknij Dodaj do listy.
Powtórz czynność dla pozostałych kas i kliknij Zapisz.

Kliknięcie pozycji na liście przepisuje jej nazwę i ścieżkę do pól edycyjnych. Aby usunąć wpis, zaznacz go, kliknij Usuń ścieżkę, potwierdź operację, a następnie zapisz listę.

Ścieżki siecioweUżytkownik systemu Windows uruchamiający program musi mieć dostęp do wskazanego udziału oraz prawo modyfikowania pliku bazy.

Programowanie kas

Baza głównaCentralna tabela użytkowników

→

DopasowanieWedług pola UzKod

→

Bazy kasAktualizacja i dodanie kont

Programowanie wszystkich kas

Otwórz zakładkę Programowanie. Lista baz zostanie odświeżona z pliku INI.
Kliknij Programuj kasy (Wszystkie).
Potwierdź aktualizację wszystkich widocznych kas.
Po zakończeniu sprawdź kolumnę Status przy każdym stanowisku.

Programowanie pojedynczej kasy

Kliknij prawym przyciskiem wybrane stanowisko i wybierz Programuj tę kasę.

Co dokładnie wykonuje synchronizacja?

Etap	Działanie
Kontrola pliku	Program sprawdza, czy plik docelowej bazy istnieje.
Aktualizacja	Rekordy o zgodnym `UzKod` otrzymują aktualny status, nazwę, hasło, nazwisko, imię i uprawnienia.
Dodawanie	Użytkownicy z bazy głównej, których `UzKod` nie występuje na kasie, są dopisywani.
Usuwanie	Standardowa synchronizacja nie usuwa użytkowników istniejących tylko w bazie kasy.

Usuwanie wszystkich użytkowników z kasy

Kliknij kasę prawym przyciskiem i wybierz Usuń użytkowników. Po zaakceptowaniu ostrzeżenia tabela użytkowników w tej bazie zostanie całkowicie wyczyszczona.

Operacja nieodwracalna z poziomu programuUsuwanie kasuje wszystkie rekordy użytkowników wskazanej kasy. Natychmiast po nim wykonaj programowanie tej kasy, aby ponownie wgrać aktualne konta. Kopia zapasowa jest jedynym prostym sposobem przywrócenia poprzedniego stanu.

Komunikaty i rozwiązywanie problemów

Komunikat lub status	Znaczenie i działanie
Oczekuje…	Dla tej bazy nie rozpoczęto jeszcze operacji w bieżącym widoku.
Przetwarzanie…	Trwa połączenie i wykonywanie zapytań.
Zaktualizowano OK	Aktualizacja istniejących i dodanie brakujących użytkowników zakończyły się powodzeniem.
Wyczyszczono dane	Wszyscy użytkownicy zostali usunięci ze wskazanej kasy.
BŁĄD: Brak pliku bazy!	Popraw ścieżkę w konfiguracji baz i sprawdź dostępność dysku lub udziału sieciowego.
Błąd połączenia z bazą	Sprawdź format pliku, uprawnienia, blokadę bazy oraz dostępność właściwego providera Access.
Wymagane jest wskazanie bazy danych	Program nie ma zapisanej poprawnej bazy głównej. Wskaż plik, aby kontynuować.
Lista baz jest pusta	Dodaj stanowiska w menu Ustawienia.
Limit użytkowników osiągnięty	Baza zawiera już 99 kont. Usuń nieużywane konto bezpośrednio w prawidłowym procesie administracyjnym przed dodaniem kolejnego.
Użytkownik o tej nazwie już istnieje	Wybierz inną, unikalną nazwę.
To hasło jest już używane	Każdy użytkownik musi mieć inne hasło.

Błąd tylko na jednej kasieJeżeli inne stanowiska aktualizują się poprawnie, najpierw porównaj ścieżkę, dostęp sieciowy i strukturę tabeli uzytkownicy w problematycznej bazie.

Bezpieczeństwo i dobre praktyki

Wykonuj kopie zapasowe przed programowaniem wielu kas i przed czyszczeniem tabeli użytkowników.
Nie uruchamiaj równocześnie kilku kopii KCPosManager na tych samych bazach.
Przed synchronizacją upewnij się, że żaden proces nie wykonuje konserwacji lub przebudowy bazy.
Chroń dostęp do bazy głównej, baz kas oraz pliku INI zawierającego ich lokalizacje.
Hasła są polami danych kopiowanymi pomiędzy bazami. Dostęp do plików baz powinny mieć wyłącznie upoważnione osoby.
Po zmianie użytkownika lub uprawnień zaprogramuj wszystkie stanowiska, które mają otrzymać zmianę.
Po zakończeniu sprawdź status każdej kasy — komunikat końcowy operacji nie oznacza, że wszystkie stanowiska zakończyły się sukcesem.

Najczęstsze pytania

Czy programowanie usuwa konta, których nie ma w bazie głównej?

Nie. Standardowa synchronizacja aktualizuje pasujące konta i dodaje brakujące. Nadmiarowe konta w bazie kasy pozostają bez zmian. Aby uzyskać dokładną kopię listy, można najpierw użyć krytycznej operacji „Usuń użytkowników”, a następnie natychmiast zaprogramować kasę.

Po czym użytkownicy są dopasowywani pomiędzy bazami?

Po numerze kasjera zapisanym w polu UzKod. Dlatego numery powinny być unikalne i spójne.

Czy mogę wysłać dane tylko do jednej kasy?

Tak. Na zakładce Programowanie kliknij wybraną kasę prawym przyciskiem i użyj polecenia „Programuj tę kasę”.

Czy anulowanie okna konfiguracji zapisuje zmiany?

Nie. Lista stanowisk jest zapisywana dopiero po użyciu przycisku „Zapisz”.

Dlaczego nowy użytkownik nie może zostać zapisany?

Najczęstsze przyczyny to brak nazwy lub hasła, powtórzona nazwa, hasło używane przez inne konto albo osiągnięcie limitu 99 użytkowników.

Gdzie program pamięta ustawienia?

W pliku KCPosManager.ini obok programu. Znajdują się tam ścieżki baz oraz ustawienia okna.

Informacje techniczne

Technologia

Delphi 10.3 Rio, Win32
VCL
FireDAC
sterownik Microsoft Access
DevExpress TcxGrid

Główne dane

tabela: uzytkownicy
identyfikator: id
klucz synchronizacji: uzkod
uprawnienia: ciąg 50 flag
statusy: 1, 2, 10

Sekcje pliku INI

[Konfiguracja]
SciezkaBazy=C:\Dane\baza_glowna.dan

[BazyZdalne]
Kasa 01=\\SERWER\KCPos\Kasa01\baza.dan
Kasa 02=\\SERWER\KCPos\Kasa02\baza.dan

[GUI]
Maximized=False
Top=100
Left=100
Width=808
Height=885

Przykład pokazuje format ustawień. Rzeczywiste ścieżki zależą od instalacji. Zaleca się zmieniać konfigurację z poziomu programu, nie przez ręczną edycję INI.

Pola synchronizowane do kas

Status, Nazwa, Haslo, Nazwisko, Imie, Uprawnienia oraz UzKod dla nowych rekordów. Aktualizacja istniejących rekordów nie zmienia ich identyfikatora id.