Pozycje

Wystawianie faktur bez katalogu pozycji prowadzi do literówek, rozjazdów w nazwach usług i niekontrolowanych zmian cen. Ekran Pozycje porządkuje te dane w jednej tabeli: nazwa towaru lub usługi, jednostka miary, cena netto i stawka VAT.

Lista jest celowo kompaktowa. Operator może dodać nową pozycję bez opuszczania tabeli, edytować istniejący rekord w miejscu albo usunąć pozycję z menu wiersza. Dostępne są filtry po nazwie, jednostce, cenie netto i VAT, liczba rekordów na stronie oraz grupowanie po pierwszej literze.

Słownik jest dostępny z obszaru sprzedaży, ale znajduje się w menu Słowniki, bo jego dane są wykorzystywane szerzej: w fakturach wychodzących, proformach i definicjach faktur cyklicznych.

Pozycja katalogowa nie jest zapisywana, jeżeli nie spełnia reguł wymaganych później przez dokument sprzedażowy. Nazwa jest wymagana i ograniczona długością, jednostka miary musi być zgodna ze słownikiem KSeF, stawka VAT musi być rozpoznawalna, a cena netto nie może być ujemna.

Przy zapisie system normalizuje jednostkę i stawkę VAT oraz zaokrągla cenę netto do dwóch miejsc po przecinku. To ma znaczenie, bo te same dane trafiają później do edytora pozycji faktury i do XML generowanego dla dokumentów sprzedażowych.

Dostępne stawki obejmują typowe VAT 23, 8 i 5 procent, warianty zerowe, zwolnienie, odwrotne obciążenie oraz przypadki niepodlegające opodatkowaniu. Jednostki pochodzą ze wspólnego słownika KSeF, więc formularz ogranicza błędy jeszcze przed etapem walidacji dokumentu.

Edytor pozycji dokumentu korzysta z wyszukiwania katalogu podczas wpisywania nazwy. Dla krótkiej listy pokazuje kilka najlepszych podpowiedzi, a w razie potrzeby pozwala rozwinąć większy wynik. Wybranie pozycji przenosi do wiersza dokumentu nazwę, jednostkę, cenę netto i stawkę VAT.

To przyspiesza pracę, ale nie blokuje operatora. Jeżeli trzeba wystawić jednorazową usługę, można ją wpisać ręcznie. Po zapisie dokumentu mechanizm synchronizacji może dopisać poprawne, kompletne wiersze do katalogu, o ile mają nazwę, jednostkę i stawkę zgodną z KSeF.

Takie rozwiązanie łączy wygodę słownika z elastycznością sprzedaży: katalog pomaga utrzymać standard, ale nie staje się przeszkodą w wystawieniu nietypowego dokumentu.

Pozycje można zaimportować z CSV. Import rozpoznaje polskie i angielskie nagłówki, między innymi nazwę, jednostkę, VAT, cenę netto oraz opcjonalne ID. Plik musi zawierać nazwę, jednostkę i VAT; cena netto jest opcjonalna i przy braku wartości przyjmowana jako zero.

Podczas importu system waliduje każdą pozycję. Wiersze bez nazwy, z nieznaną jednostką, nieobsługiwaną stawką VAT albo ujemną ceną netto są pomijane z ostrzeżeniem. Istniejące pozycje są wyszukiwane po ID albo po kombinacji nazwy, jednostki i VAT, dzięki czemu import może aktualizować ceny bez tworzenia duplikatów.

Po zakończeniu operator widzi liczbę dodanych, zaktualizowanych i pominiętych rekordów oraz listę ostrzeżeń. To pozwala używać importu jako normalnego narzędzia utrzymania cennika, a nie jednorazowej migracji.

Pozycje są technicznie prostszym ekranem niż faktury, ale ich jakość wpływa na wiele miejsc w systemie. Spójna nazwa usługi, poprawna jednostka KSeF, stała stawka VAT i aktualna cena ograniczają liczbę poprawek przy fakturach, proformach oraz dokumentach cyklicznych.

W implementacji widać kilka ważnych decyzji: szybka edycja bez dialogu, filtrowanie bez przeładowywania całego modułu, import z ostrzeżeniami, walidacja domenowa w use case, normalizacja danych przed zapisem i integracja z edytorem wierszy faktury. To pokazuje, że nawet słownik został potraktowany jako element procesu sprzedaży, a nie osobna tabela administracyjna.