Różnice

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

--- pl:mr_arve_kassa [2025/05/19 09:42] – przywrócono poprzednią wersję (2025/05/16 11:18) karolina
+++ pl:mr_arve_kassa [2025/05/19 09:49] (aktualna) – [Wydruk paragon] karolina
@@ Linia 294: / Linia 294: @@
 ===== Wydruk faktura =====
-| Tag                | Znaczenie na wydruku                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 | Nazwa pola                                                                                                                                                                                                                                                                                                                                               |
+| Tag  | Znaczenie na wydruku  | Nazwa pola  |
-| info required      | object (info_obj)Informacje o fakturze, takie jak: numer, ilość kopii, data sprzedaży itp.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |                                                                                                                                                                                                                                                                                                                                                          |
+|  **info required**  |||
-| number required    | string [ 1 .. 56 ] charactersNumer faktury                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           | **Faktura sprzedaży (dokument)**                                                                                                                                                                                                                                                                                                                         |
+| **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_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                                                                                                                                                                                                                                                                                                                                      |
+| **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.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            | **Razem (dokument)**                                                                                                                                                                                                                                                                                                                                     |
+| **paid**  | string [ 1 .. 29 ] charactersNapis drukowany przy etykiecie 'Zapłacono' pod SUMĄ faktury.  | **Razem (dokument)**  |
-| buyer required     | object (definitions-buyer_obj)                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |                                                                                                                                                                                                                                                                                                                                                          |
+|  **buyer required**  |||
-| name required      | string [ 1 .. 256 ] charactersNazwa kupującego.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      | **Nazwa (dokument)**                                                                                                                                                                                                                                                                                                                                     |
+| **name required**  | string [ 1 .. 256 ] charactersNazwa kupującego.  | **Nazwa (dokument)**  |
-| id_type            | stringEnum: "nip" "regon" "pesel"Typ numeru identyfikacyjnego nabywcy.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               | Zawsze **nip**                                                                                                                                                                                                                                                                                                                                           |
+| **id_type**  | stringEnum: "nip" "regon" "pesel"Typ numeru identyfikacyjnego nabywcy.  | Zawsze **nip**  |
-| idrequired         | string [ 1 .. 16 ] charactersNumer identyfikacyjny nabywcy.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          | **Numer VAT (dokument)**                                                                                                                                                                                                                                                                                                                                 |
+| **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.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    | Ulica, Miasto, Kod pocztowy **(dokument)**                                                                                                                                                                                                                                                                                                               |
+| **address required**  | Array of strings (address_array) [ 1 .. 8 ] items [ items <= 64 characters ]Linie adresu nabywcy.  | Ulica, Miasto, Kod pocztowy **(dokument)**  |
-| itemsrequired      | Array of article (object) or advance (object) or advance_return (object) (items) [ 1 .. 255 ] itemsLista pozycji faktury                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |                                                                                                                                                                                                                                                                                                                                                          |
+|  **items required ** [ 1 .. 255 ] itemsLista pozycji faktury  |||
-| article            | object (definitions-article_obj)                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     | Zawsze                                                                                                                                                                                                                                                                                                                                                   |
+| **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”.  | **Nazwa w wierszu - 29 symboli (dokument) **                                                                                                                                                                                                                                                                                                             |
+| **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”                                                                                                                                                                                                                                                                                                                                                                                                                                                              | 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 z wierszu **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 z wierszu **Razem (dokument)**                                                                                                                                                                                                                                                                                                                      |
+| **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)**                                                                                                                                                                                                                                                                                                                      |
+| **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 Jednostka (4 symbole) (dokument)**                                                                                                                                                                                                                                                                                                                |
+| **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)**  |
-| summaryrequired    | object (definitions-summary_obj)Podsumowanie faktury, zawiera wartość faktury, wpłatę, rabat/narzut itp.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |                                                                                                                                                                                                                                                                                                                                                          |
+|  **summary required **Podsumowanie faktury, zawiera wartość faktury, wpłatę, rabat/narzut itp.  |||
-| totalrequired      | 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**                                                                                                                                                                                                                                                                                                                        |
+| **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**                                                                                                                                                                                                                                                                                                                        |
+| **pay_inrequired**  | string <regex> d{0,9}(\.\d{0,2})?$Wartość wpłat do faktury.  | Pole nagłówku dokumentu **Razem**  |
-| system_info        | object (definitions-system_info_obj)Informacje z systemu sprzedaży.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |                                                                                                                                                                                                                                                                                                                                                          |
+|  **system_info **nformacje z systemu sprzedaży.  |||
-| 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.  |
+| **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     | object (definitions-device_control_obj)Rozkazy sterowania urządzeniem.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |                                                                                                                                                                                                                                                                                                                                                          |
+|  **device_control **Rozkazy sterowania urządzeniem.  |||
-| open_drawer        | booleanOtwarcie szuflady po zakończeniu faktury.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     | Zawsze **false**                                                                                                                                                                                                                                                                                                                                         |
+| **open_drawer**  | boolean Otwarcie szuflady po zakończeniu faktury.  | Zawsze **false**  |
-| paper_cut          | stringEnum: "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**  |