Różnice

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

--- pl:mr_arve_kassa [2025/05/16 10:12] – [Wydruk faktura] karolina
+++ pl:mr_arve_kassa [2025/05/19 09:49] (aktualna) – [Wydruk paragon] karolina
@@ Linia 294: / Linia 294: @@
 ===== Wydruk faktura =====
-| Tag | Znaczenie na wydruku | Pole Directo | 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**  |||
-| buyer required | object (definitions-buyer_obj) |  |  |
+| **number required**  | string [ 1 .. 56 ] charactersNumer faktury  | **Faktura sprzedaży (dokument)**  |
-| recipient | object (recipient_obj)Odbiorca faktury |  |  |
+| **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  |
-| seller | object (seller_obj)Wystawiający fakturę. |  |  |
+| **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  |
-| options | object (options_obj)Opcje wydruku faktury. |  |  |
+| **payment_form**  | string [ 1 .. 20 ] charactersForma płatności.  | Jeśli był termin z typem **Płatność kartą**, wtedy Karta, w innym wypadku - **Gotowka**  |
-| itemsrequired | Array of article (object) or advance (object) or advance_return (object) (items) [ 1 .. 255 ] itemsLista pozycji faktury |  |  |
+| **paid**  | string [ 1 .. 29 ] charactersNapis drukowany przy etykiecie 'Zapłacono' pod SUMĄ faktury.  | **Razem (dokument)**  |
-| payments | Array of cash (object) or card (object) or cheque (object) or coupon (object) or other (object) or credit (object) or account (object) or currency (object) or transfer (object) or mobile (object) or voucher (object) (payments) [ 1 .. 16 ] itemsFormy płatności jakimi zostanie opłacona faktura. |  |  |
+|  **buyer required**  |||
-| summaryrequired | object (definitions-summary_obj)Podsumowanie faktury, zawiera wartość faktury, wpłatę, rabat/narzut itp. |  |  |
+| **name required**  | string [ 1 .. 256 ] charactersNazwa kupującego.  | **Nazwa (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 fakturą. |  |  |
+| **id_type**  | stringEnum: "nip" "regon" "pesel"Typ numeru identyfikacyjnego nabywcy.  | Zawsze **nip**  |
-| additional_info | Array of objects (additional_info_array) non-emptyDodatkowe informacje do wydrukowania na fakturze. |  |  |
+| **id required**  | string [ 1 .. 16 ] charactersNumer identyfikacyjny nabywcy.  | **Numer VAT (dokument)**  |
-| system_info | object (definitions-system_info_obj)Informacje z systemu sprzedaży. |  |  |
+| **label_type**  | stringEnum: "recipient" "buyer"Wybór etykiety: nabywca lub odbiorca.  | Zawsze - recipient  |
-| device_control | object (definitions-device_control_obj)Rozkazy sterowania urządzeniem. |  |  |
+| **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 |
+| **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**  |