Różnice

Różnice między wybraną wersją a wersją aktualną.

--- pl:mr_arve_kassa [2025/05/16 12:32] – [Płatność kartą] karolina
+++ pl:mr_arve_kassa [2025/05/19 09:49] (aktualna) – [Wydruk paragon] karolina
@@ Linia 50: / Linia 50: @@
 Klient wprowadza kartę, kod PIN, przycisk OK, po czym z terminala serwera przychodzi potwierdzenie płatności kartą, które klient odrywa, naciska przycisk OK na terminalu i zostaje wydrukowany paragon klienta, a następnie wydruk paragonu z kasy fiskalnej. Potwierdzenie odbioru gotówki następuje automatycznie na terminalu.
 === Wielokrotna płatność ===
@@ Linia 297: / Linia 296: @@
 | Tag  | Znaczenie na wydruku  | Nazwa pola  |
 |  **info required**  |||
-| **number required**  | string [ 1 .. 56 ] charactersNumer faktury  | Pole nagłówka dokumentu** Faktura sprzedaży**  |
+| **number required**  | string [ 1 .. 56 ] charactersNumer faktury  | **Faktura sprzedaży (dokument)**  |
 | **date_of_sell**  | string <regex> ([0-9]{2})([:/\-.]{1})([0-9]{2})([:/\-.]{1})(...Show patternData sprzedaży. Dopuszczalne formaty: 'dd:MM:yyyy', 'dd/MM/yyyy', 'dd-MM-yyyy'.  | Faktyczna data dnia  |
 | **date_of_payment**  | string <regex> ([0-9]{2})([:/\-.]{1})([0-9]{2})([:/\-.]{1})(...Show patternData płatności. Dopuszczalne formaty: 'dd:MM:yyyy', 'dd/MM/yyyy', 'dd-MM-yyyy'.  | Faktyczna data dnia  |
-| **payment_form**  | string [ 1 .. 20 ] charactersForma płatności.  | Jeśli był termin z typem **Płatność kartą**, wtedy **Karta**, w innym wypadku - **Gotowka**  |
+| **payment_form**  | string [ 1 .. 20 ] charactersForma płatności.  | Jeśli był termin z typem **Płatność kartą**, wtedy Karta, w innym wypadku - **Gotowka**  |
-| **paid**  | string [ 1 .. 29 ] charactersNapis drukowany przy etykiecie 'Zapłacono' pod SUMĄ faktury.  | Pole nagłówka dokumentu **Razem **  |
+| **paid**  | string [ 1 .. 29 ] charactersNapis drukowany przy etykiecie 'Zapłacono' pod SUMĄ faktury.  | **Razem (dokument)**  |
 |  **buyer required**  |||
-| **name required**  | string [ 1 .. 256 ] charactersNazwa kupującego.  | Pole nagłówka dokumentu **Nazwa **  |
+| **name required**  | string [ 1 .. 256 ] charactersNazwa kupującego.  | **Nazwa (dokument)**  |
 | **id_type**  | stringEnum: "nip" "regon" "pesel"Typ numeru identyfikacyjnego nabywcy.  | Zawsze **nip**  |
-| **id required**  | string [ 1 .. 16 ] charactersNumer identyfikacyjny nabywcy.  | Pole nagłówka dokumentu **Numer VAT **  |
+| **id required**  | string [ 1 .. 16 ] charactersNumer identyfikacyjny nabywcy.  | **Numer VAT (dokument)**  |
-| **label_type**  | stringEnum: "recipient" "buyer"Wybór etykiety: nabywca lub odbiorca.  | Zawsze - **recipient**  |
+| **label_type**  | stringEnum: "recipient" "buyer"Wybór etykiety: nabywca lub odbiorca.  | Zawsze - recipient  |
-| **address required**  | Array of strings (address_array) [ 1 .. 8 ] items [ items <= 64 characters ]Linie adresu nabywcy.  | Pola nagłówka dokumentu: Ulica, Miasto, Kod pocztowy  |
+| **address required**  | Array of strings (address_array) [ 1 .. 8 ] items [ items <= 64 characters ]Linie adresu nabywcy.  | Ulica, Miasto, Kod pocztowy **(dokument)**  |
 |  **items required ** [ 1 .. 255 ] itemsLista pozycji faktury  |||
-| **article**  | object (definitions-article_obj)  | Zawsze **article**  |
+| **article**  | object (definitions-article_obj)  | Zawsze  |
-| **name required**  | string [ 1 .. 60 ] charactersNazwa towaru/usługi która jest sprzedawana w trakcie transakcji. Nazwa towaru ma szczególne własności, podczas sprzedaży. Drukarka fiskalna dokonuje wyznaczenia nazwy fiskalnej która to ignoruje wielkości liter oraz spacje i większość znaków specjalnych. Nazwa fiskalna w połączeniu ze stawką podatkową muszą zachować się tak, aby spełniać zasadę schodka podatkowego. Obniżać stawki można dowoli, podwyższać również, obniżać po podwyższeniu, natomiast po obniżeniu nie wolno podwyższyć stawki PTU. Pomimo wyznaczenia nazwy fiskalnej na fakturze jest drukowana „Nazwa towaru/usługi”.  | Pole wiersza dokumentu** Nazwa  - //29 symboli**//  |
+| **name required**  | string [ 1 .. 60 ] charactersNazwa towaru/usługi która jest sprzedawana w trakcie transakcji. Nazwa towaru ma szczególne własności, podczas sprzedaży. Drukarka fiskalna dokonuje wyznaczenia nazwy fiskalnej która to ignoruje wielkości liter oraz spacje i większość znaków specjalnych. Nazwa fiskalna w połączeniu ze stawką podatkową muszą zachować się tak, aby spełniać zasadę schodka podatkowego. Obniżać stawki można dowoli, podwyższać również, obniżać po podwyższeniu, natomiast po obniżeniu nie wolno podwyższyć stawki PTU. Pomimo wyznaczenia nazwy fiskalnej na fakturze jest drukowana „Nazwa towaru/usługi”.  | **Nazwa w wierszu - 29 symboli (dokument) **  |
-| **ptu required**  | string = 1 charactersSymbol stawki podatkowej może przyjąć wartości stawek od A do G. Specjalne własności stawki w połączeniu z nazwą towarową są opisane w polu „name”  | Wartość z kartoteki ''Kody VAT'', pole **PTU TOWARÓW NA PARAGONIE, **jeśli puste - wartość A  |
+| **ptu required**  | string = 1 charactersSymbol stawki podatkowej może przyjąć wartości stawek od A do G. Specjalne własności stawki w połączeniu z nazwą towarową są opisane w polu „name”  | Z kartoteki Kody VAT, pole **PTU TOWARÓW NA PARAGONIE, **jeśli puste - wartość A  |
-| **quantity required**  | string <regex>\d{0,9}(\.\d{0,6})?$Ilość sprzedawanego towaru z precyzją do 6 miejsc po przecinku  | Pole wiersza dokumentu **Ilość, (bez znaku minus)**  |
+| **quantity required**  | string <regex>\d{0,9}(\.\d{0,6})?$Ilość sprzedawanego towaru z precyzją do 6 miejsc po przecinku  | Pole z wierszu **Ilość, bez znaku minus**  |
-| **price required**  | string <regex>\d{0,9}(\.\d{0,2})?$Cena sprzedawanego towaru  | Pole wiersza dokumentu **Razem **  |
+| **price required**  | string <regex>\d{0,9}(\.\d{0,2})?$Cena sprzedawanego towaru  | Pole z wierszu **Razem (dokument)**  |
-| **value required**  | string <regex>\d{0,9}(\.\d{0,2})?$Wartość kontrolna równa „quantity” x „price”. Metoda zaokrąglania wartości towaru opisana jest w protokole komunikacyjnym Novitus  | Pole wiersza dokumentu **Razem**  |
+| **value required**  | string <regex>\d{0,9}(\.\d{0,2})?$Wartość kontrolna równa „quantity” x „price”. Metoda zaokrąglania wartości towaru opisana jest w protokole komunikacyjnym Novitus  | Pole z wierszu **Razem (dokument)**  |
-| **unit**  | string [ 1 .. 4 ] charactersJednostka miary drukowana obok ilości sprzedawanego towaru. Może przyjąć wartości takie jak „szt.” lub „kg”  | Pole wiersza dokumentu** Jednostka (4 pierwsze symbole) **  |
+| **unit**  | string [ 1 .. 4 ] charactersJednostka miary drukowana obok ilości sprzedawanego towaru. Może przyjąć wartości takie jak „szt.” lub „kg”  | **Pole Jednostka (4 symbole) (dokument)**  |
 |  **summary required **Podsumowanie faktury, zawiera wartość faktury, wpłatę, rabat/narzut itp.  |||
 | **total required**  | string <regex> d{0,9}(\.\d{0,2})?$Kontrolna wartość faktury zawierająca wartość wszystkich pozycji faktury. Wartość ta uwzględnia rabaty narzuty do pozycji, zaliczki, kaucje jeżeli istnieją.  | Pole nagłówku dokumentu **Razem**  |
 | **pay_inrequired**  | string <regex> d{0,9}(\.\d{0,2})?$Wartość wpłat do faktury.  | Pole nagłówku dokumentu **Razem**  |
 |  **system_info **nformacje z systemu sprzedaży.  |||
-| **Cashier_name**  | string [ 1 .. 32 ] charactersNazwa kasjera która będzie widniała w stopce faktury.  | Według ustawienie systemowe - ''Empifis drukuje tylko imię kasjera''. Jeśli wybór **KOD **- to drukuje kod użytkownika, który potwierdza paragon. Jeśli wybór **PEŁNA NAZWA **- nazwa z kartoteki użytkownika, który uzupełniony w polu nagłówka dokumentu **Sprzedawca**,  jeśli nie zapełnione, to nazwa użytkownika który potwierdza dokument. Jeśli wybór **Imię**, pobiera pierwszą wartość pola **Nazwa (**wartość do pierwszej spacji) z kartoteki użytkownika, który uzupełniony w polu nagłówka dokumentu **Sprzedawca**,  jeśli nie zapełnione, to nazwa użytkownika który potwierdza dokument.  |
+| **Cashier_name**  | string [ 1 .. 32 ] charactersNazwa kasjera która będzie widniała w stopce faktury.  | Ustawienie systemowe - ''Empifis drukuje tylko imię kasjera''. Jeśli wybór KOD - to drukuje kod użytkownika, który potwierdza paragon. W innym wypadku -jeśli sprzedawca jest uzupełniony, to nazwa tego użytkownika, jeśli nie zapełnione, to nazwa użytkownika który potwierdza. Jeśli wybór Imię, bierze pierwszą wartość nazwy do pierwszej spacji.  |
-| **cash_number**  | string [ 1 .. 8 ] charactersNumer kasy który będzie widoczny w stopce faktury.  | Z kartoteki użytkownika, który potwierdza paragon, pole **Lokalizacje**  |
+| **cash_number**  | string [ 1 .. 8 ] charactersNumer kasy który będzie widoczny w stopce faktury.  | Z kartoteki użytkownika, który potwierdza paragon, pole **Lokalizacje **  |
 |  **device_control **Rozkazy sterowania urządzeniem.  |||
 | **open_drawer**  | boolean Otwarcie szuflady po zakończeniu faktury.  | Zawsze **false**  |
-| **paper_cut**  | string Enum: "none" "full" "part" Możliwość wykonania odcięcia papieru w dwóch trybach całkowity lub częściowy.  | Zawsze **full**  |
+| **paper_cut**  | string Enum: "none" "full" "part"Możliwość wykonania odcięcia papieru w dwóch trybach całkowity lub częściowy.  | Zawsze **full**  |
+===== Wydruk paragon =====
+| Tag | Znaczenie na wydruku | Nazwa pola |
+| **items required**  Array of article (object) or advance (object) or advance_return (object) or container (object) or container_return (object) (Items) [ 1 .. 255 ] items Lista pozycji paragonowych |||
+| **article** | Pozycja sprzedaży towaru. |   |
+| **name required** | string [ 1 .. 60 ] characters Nazwa towaru/usługi która jest sprzedawana w trakcie transakcji. Nazwa towaru ma szczególne własności, podczas sprzedaży. Drukarka fiskalna dokonuje wyznaczenia nazwy fiskalnej która to ignoruje wielkości liter oraz spacje i większość znaków specjalnych. Nazwa fiskalna w połączeniu ze stawką podatkową muszą zachować się tak, aby spełniać zasadę schodka podatkowego. Obniżać stawki można dowoli, podwyższać również, obniżać po podwyższeniu, natomiast po obniżeniu nie wolno podwyższyć stawki PTU. Pomimo wyznaczenia nazwy fiskalnej na paragonie jest drukowana „Nazwa towaru/usługi” | Pole nagłówka dokumentu **Nazwa**  |
+| **ptu required** | string = 1 charactersSymbol stawki podatkowej może przyjąć wartości stawek od A do G. Specjalne własności stawki w połączeniu z nazwą towarową są opisane w polu „name” | Z kartoteki Kody VAT, pole **PTU TOWARÓW NA PARAGONIE, **jeśli puste - wartość A  |
+| **quantity required** | string <regex>  \d{0,9}(\.\d{0,6})?$Ilość sprzedawanego towaru z precyzją do 6 miejsc po przecinku | Pole z wierszu **Ilość, bez znaku minus**  |
+| **price required** | string <regex> \d{0,9}(\.\d{0,2})?$Cena sprzedawanego towaru | Pole z wierszu **Razem (dokument)**  |
+| **value required** | string <regex> \d{0,9}(\.\d{0,2})?$Wartość kontrolna równa „quantity” x „price”. Metoda zaokrąglania wartości towaru opisana jest w protokole komunikacyjnym Novitus | Pole z wierszu **Razem (dokument)**  |
+| **unit** | string [ 1 .. 4 ] charactersJednostka miary drukowana obok ilości sprzedawanego towaru. Może przyjąć wartości takie jak „szt.” lub „kg” | Pole wierszu dokumentu** Jednostka (4 pierwsze symbole) **  |
+| **summary required** | object (Summary)Podsumowanie paragonu, zawiera wartość paragonu, wpłatę, rabat/narzut itp. |   |
+| **total required** | string <regex> \d{0,9}(\.\d{0,2})?$Kontrolna wartość paragonu zawierająca wartość wszystkich pozycji paragonowych. Wartość ta uwzględnia rabaty narzuty do pozycji, zaliczki, kaucje jeżeli istnieją. | Pole nagłówku dokumentu **Razem**  |
+| **pay_inrequired** | string <regex> \d{0,9}(\.\d{0,2})?$Wartość wpłat do paragonu. | Pole nagłówku dokumentu **Razem**  |
+| **printout_lines** | Array of textline (object) or barcode (object) or qrcode (object) or special_line (object) or graphic (object) or ascii_art (object) (Printout Lines) [ 1 .. 50 ] itemsLinie wydruku w części niefiskalnej. Umożliwia drukowanie dodatkowych informacji pod paragonem |   |
+| **textline** | object (Textline)Linia tekstowa wydruku niefiskalnego. |   |
+| **system_info** | object (System Info)Informacje z systemu sprzedaży. |   |
+| **cashier_name** | string [ 1 .. 32 ] characters. Nazwa kasjera która będzie widniała w stopce paragonu | Ustawienie systemowe - ''Empifis drukuje tylko imię kasjera''. Jeśli wybór KOD - to drukuje kod użytkownika, który potwierdza paragon. W innym wypadku -jeśli sprzedawca jest uzupełniony, to nazwa tego użytkownika, jeśli nie zapełnione, to nazwa użytkownika który potwierdza. Jeśli wybór Imię, bierze pierwszą wartość nazwy do pierwszej spacji.  |
+| **cash_number** | string [ 1 .. 8 ] characters Numer kasy który będzie widoczny w stopce paragonu | Z kartoteki użytkownika, który potwierdza paragon, pole **Lokalizacje**  |
+| **device_control** | Rozkazy sterowania urządzeniem. |   |
+| **open_drawer** | boolean Czy po wydruku paragonu ma się otworzyć szuflada | Zawsze **false**  |
+| **paper_cut** | string Enum: "none" "full" "part" Możliwość wykonania odcięcia papieru w dwóch trybach całkowity lub częściowy | Zawsze **full**  |