Różnice

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

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