Różnice

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

--- pl:mr_arve_kassa [2025/05/16 10:50] – [Wydruk faktura] karolina
+++ pl:mr_arve_kassa [2025/05/19 09:49] (aktualna) – [Wydruk paragon] karolina
@@ Linia 293: / Linia 293: @@
 ===== Wydruk faktura =====
+| Tag  | Znaczenie na wydruku  | Nazwa pola  |
+|  **info required**  |||
+| **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**  |
+| **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.  | **Nazwa (dokument)**  |
+| **id_type**  | stringEnum: "nip" "regon" "pesel"Typ numeru identyfikacyjnego nabywcy.  | Zawsze **nip**  |
+| **id required**  | string [ 1 .. 16 ] charactersNumer identyfikacyjny nabywcy.  | **Numer VAT (dokument)**  |
+| **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)**  |
+|  **items required ** [ 1 .. 255 ] itemsLista pozycji faktury  |||
+| **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) **  |
+| **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 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.  | 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 **  |
+|  **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**  |
+===== Wydruk paragon =====
 | Tag | Znaczenie na wydruku | Nazwa pola |
-| info required | object (info_obj)Informacje o fakturze, takie jak: numer, ilość kopii, data sprzedaży itp. |   |
+| **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. |   |
-| number required | string [ 1 .. 56 ] charactersNumer faktury | **Faktura sprzedaży (dokument)** |
+| **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**  |
-| 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 |
+| **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  |
-| 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 |
+| **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**  |
-| payment_form | string [ 1 .. 20 ] charactersForma płatności. | Jeśli był termin z typem **Płatność kartą**, wtedy Karta, w innym wypadku - **Gotowka** |
+| **price required** | string <regex> \d{0,9}(\.\d{0,2})?$Cena sprzedawanego towaru | Pole z wierszu **Razem (dokument)**  |
-| paid | string [ 1 .. 29 ] charactersNapis drukowany przy etykiecie 'Zapłacono' pod SUMĄ faktury. | **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)**  |
-| buyer required | object (definitions-buyer_obj) |  |
+| **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) **  |
-| name required | string [ 1 .. 256 ] charactersNazwa kupującego. | **Nazwa (dokument)** |
+| **summary required** | object (Summary)Podsumowanie paragonu, zawiera wartość paragonu, wpłatę, rabat/narzut itp. |   |
-| id_type | stringEnum: "nip" "regon" "pesel"Typ numeru identyfikacyjnego nabywcy. | Zawsze **nip** |
+| **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**  |
-| idrequired | string [ 1 .. 16 ] charactersNumer identyfikacyjny nabywcy. | **Numer VAT (dokument)** |
+| **pay_inrequired** | string <regex> \d{0,9}(\.\d{0,2})?$Wartość wpłat do paragonu. | Pole nagłówku dokumentu **Razem**  |
-| label_type | stringEnum: "recipient" "buyer"Wybór etykiety: nabywca lub odbiorca. | Zawsze - recipient |
+| **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 |   |
-| address required | Array of strings (address_array) [ 1 .. 8 ] items [ items <= 64 characters ]Linie adresu nabywcy. | Ulica, Miasto, Kod pocztowy **(dokument)** |
+| **textline** | object (Textline)Linia tekstowa wydruku niefiskalnego. |   |
-| itemsrequired | Array of article (object) or advance (object) or advance_return (object) (items) [ 1 .. 255 ] itemsLista pozycji faktury |   |
+| **system_info** | object (System Info)Informacje z systemu sprzedaży. |   |
-| article | object (definitions-article_obj) | Zawsze  |
+| **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.  |
-| 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) ** |
+| **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**  |
-| 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 |
+| **device_control** | Rozkazy sterowania urządzeniem. |   |
-| 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** |
+| **open_drawer** | boolean Czy po wydruku paragonu ma się otworzyć szuflada | Zawsze **false**  |
-| price required | string <regex> ^\d{0,9}(\.\d{0,2})?$Cena sprzedawanego towaru | Pole z wierszu **Razem (dokument)** |
+| **paper_cut** | string Enum: "none" "full" "part" Możliwość wykonania odcięcia papieru w dwóch trybach całkowity lub częściowy | Zawsze **full**  |
-| 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)**  |
-| summaryrequired | object (definitions-summary_obj)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** |
-| 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. |  |
-| 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 ** |
-| device_control | object (definitions-device_control_obj)Rozkazy sterowania urządzeniem. |  |
-| open_drawer | booleanOtwarcie 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** |