Dokumentace HELIOS Mobile - Příspěvky uživatele [cs]

Zásady ochrany osobních údajů

2024-12-10T14:41:47Z

Wikiadm: Překlad do angličtiny

== Privacy Policy (Zásady ochrany osobních údajů) ==

=== English ===

ALDOR s.r.o. does not collect any personal data or customer-related data in connection with the use of the HELIOS Mobile app.

Data displayed by the HELIOS Mobile client application are transmitted directly to/from the customer's server. In cooperation with the system administrators on the customer side, we take all necessary steps to properly secure this communication channel.

When using the app for electronic sales records (EET), the required data defined by law is sent to the Financial Administration servers.

ALDOR s.r.o. collects anonymous statistical data through the Google Analytics service, which allows us to improve the app and respond promptly to issues.

==== Permissions Used ====

The HELIOS Mobile app uses the following permissions on the Android platform:

===== Device Identity =====

The device identifier for licensing purposes is generated based on several hardware and software identification codes. Some of these codes may be considered sensitive, but the identifier generation process is one-way, and the original codes cannot be deduced from the identifier.

The identifier is created exclusively on the device, and the original codes are not included in any communication.

===== Location =====

The app may log the device's location in specific records if required by the configuration of a particular record handler. Location data is recorded only when explicitly enabled by the configuration.

===== Photos, Media, and Files =====

If customer initialization supports working with attachments, it is possible to attach a photo taken with the device's camera or an existing file from the device's storage.

---

=== Česky ===

Společnost ALDOR s.r.o. neshromažďuje v souvislosti s používáním mobilní aplikace HELIOS Mobile žádné osobní údaje ani data patřící zákazníkům.

Data zobrazovaná klientskou aplikací HELIOS Mobile jsou přenášena přímým kanálem z/na server zákazníka. Ve spolupráci se správci systému na straně zákazníka podnikáme všechny příslušné kroky k tomu, abychom tento komunikační kanál řádně zabezpečili.

V případě využívání aplikace pro elektronickou evidenci tržeb (EET) dochází k odesílání příslušých zákonem definovaných dat na servery Finanční správy.

Společnost ALDOR s.r.o. shromažďuje anonymní statistické údaje, prostřednictvím služby Google Analytics, díky kterým můžeme aplikaci vylepšovat a pružně reagovat na chyby.

==== Využívaná oprávnění ====

Na platformě Android využívá aplikace HELIOS Mobile následující oprávnění:

===== Identita zařízení =====

Identifikátor zařízení pro účely licencování je vytvářen na základě několika identifikačních kódů hardwaru a softwaru. Některé z těchto kódů mohou být považovány za důvěrné, nicméně postup vytváření identifikátoru je jednosměrný a samotné kódy není možné na základě identifikátoru odvodit.

Zároveň dochází k vytváření identifikátoru výhradně na zařízení a samotné kódy nejsou obsaženy v žádné komunikaci.

===== Poloha =====

Aplikace umožňuje v případě potřeby zaznamenávat polohu zařízení do speciálních záznamů. Poloha je zaznamenávána pouze v případě, že to vyžaduje konfigurace konkrétního pořadače záznamů.

===== Fotografie, média a soubory =====

Pokud inicializace zákazníka podporuje práci s přílohami, je možné k záznamu přiložit fotografii pořízenou fotoaparátem zařízení, nebo jiný již existující soubor z paměti zařízení.

Soubor:MobileService 1 5 7 719+78.zip

2024-09-03T08:26:47Z

Wikiadm: Webová služba HELIOS Mobile, verze 1.5.7.719+78 je vyžadována patchem ALDOR_4627 a vyšším. Dále služba vyžaduje instalaci .NET Framework 4.8. Balíček obsahuje i kompletní web.config, který musíte upravit podle vašich parametrů připoje…

Webová služba HELIOS Mobile, verze 1.5.7.719+78 je vyžadována patchem ALDOR_4627 a vyšším. Dále služba vyžaduje instalaci .NET Framework 4.8. Balíček obsahuje i kompletní web.config, který musíte upravit podle vašich parametrů připojení (sekce appSettings) a nastavení webového serveru (podpora HTTP a HTTPS). Instalace se provádí pouhým rozbalením do kořenového adresáře aplikačního poolu, připraveného pro webovou službu, nahráním licenčního souboru .lic, správným nastavením web.config a nastavením práv zápisu u adresářů Log, AttachmentCache a PreSync pro uživatele, pod kterým běží webový server.

Webová služba - download

2024-09-03T08:25:36Z

Wikiadm:

Instalační balíčky webové služby HELIOS Mobile

Archívy obsahují i '''[[Web Config|web.config]]''', který musíte '''upravit podle vašich parametrů připojení'''.

Instalace se provádí pouhým rozbalením do kořenového adresáře aplikačního poolu učeného pro provoz webové služby.

== Instalační balíčky webové služby ==

* [[:Soubor:MobileService 1 5 7 719+78.zip|MobileService 1.5.7.719+78]] ''(7.5.2024)'' '''POZOR, vyžaduje .NET Framework 4.8 a patch ALDOR_4627 nebo vyšší!'''
* [[:Soubor:MobileService 1 5 7 690+50.zip|MobileService 1.5.7.690+50]] ''(14.2.2023)'' '''POZOR, vyžaduje .NET Framework 4.8 a patch ALDOR_462520 nebo vyšší!'''

Webová služba - download

2023-02-14T14:05:45Z

Wikiadm:

Instalační balíčky webové služby HELIOS Mobile

Archívy obsahují i '''[[Web Config|web.config]]''', který musíte '''upravit podle vašich parametrů připojení'''.

Instalace se provádí pouhým rozbalením do kořenového adresáře aplikačního poolu učeného pro provoz webové služby.

== Instalační balíčky webové služby ==

* [[:Soubor:MobileService 1 5 7 690+50.zip|MobileService 1.5.7.690+50]] ''(14.2.2023)'' '''POZOR, vyžaduje .NET Framework 4.8 a patch ALDOR_462520 nebo vyšší!'''
* [[:Soubor:MobileService 1 5 5 679+50.zip|MobileService 1.5.5.679+50]] ''(18.5.2022)'' '''POZOR, vyžaduje .NET Framework 4.8 a patch ALDOR_462220 nebo vyšší!'''

Soubor:MobileService 1 5 7 690+50.zip

2023-02-14T14:03:36Z

Wikiadm: Webová služba HELIOS Mobile, verze 1.5.7.690+50 je vyžadována patchem ALDOR_462520 a vyšším. Dále služba vyžaduje instalaci .NET Framework 4.8. Balíček obsahuje i kompletní web.config, který musíte upravit podle vašich parametrů připo…

Webová služba HELIOS Mobile, verze 1.5.7.690+50 je vyžadována patchem ALDOR_462520 a vyšším. Dále služba vyžaduje instalaci .NET Framework 4.8. Balíček obsahuje i kompletní web.config, který musíte upravit podle vašich parametrů připojení (sekce appSettings) a nastavení webového serveru (podpora HTTP a HTTPS). Instalace se provádí pouhým rozbalením do kořenového adresáře aplikačního poolu, připraveného pro webovou službu, nahráním licenčního souboru .lic, správným nastavením web.config a nastavením práv zápisu u adresářů Log, AttachmentCache a PreSync pro uživatele, pod kterým běží webový server.

Webová služba - download

2022-05-18T08:03:17Z

Wikiadm: /* Instalační balíčky webové služby */

Instalační balíčky webové služby HELIOS Mobile

Archívy obsahují i '''[[Web Config|web.config]]''', který musíte '''upravit podle vašich parametrů připojení'''.

Instalace se provádí pouhým rozbalením do kořenového adresáře aplikačního poolu učeného pro provoz webové služby.

== Instalační balíčky webové služby ==

* [[:Soubor:MobileService 1 5 5 679+50.zip|MobileService 1.5.5.679+50]] ''(18.5.2022)'' '''POZOR, vyžaduje .NET Framework 4.8 a patch ALDOR_462220 nebo vyšší!'''
* [[:Soubor:MobileService 1 5 5 668+49.zip|MobileService 1.5.5.668+49]] ''(31.1.2022)'' '''POZOR, vyžaduje .NET Framework 4.8 a patch ALDOR_462140 nebo vyšší!'''

Soubor:MobileService 1 5 5 679+50.zip

2022-05-18T08:00:21Z

Wikiadm: Webová služba HELIOS Mobile, verze 1.5.5.679+50 vyžaduje patch ALDOR_462220 a vyšší a .NET Framework 4.8. Obsahuje i kompletní web.config, který musíte upravit podle vašich parametrů připojení (sekce appSettings) a nastavení webového ser…

Webová služba HELIOS Mobile, verze 1.5.5.679+50 vyžaduje patch ALDOR_462220 a vyšší a .NET Framework 4.8. Obsahuje i kompletní web.config, který musíte upravit podle vašich parametrů připojení (sekce appSettings) a nastavení webového serveru (podpora HTTP a HTTPS). Instalace se provádí pouhým rozbalením do kořenového adresáře aplikačního poolu, připraveného pro webovou službu.

Soubor:MobileService 1 5 5 668+49.zip

2022-05-18T07:59:18Z

Wikiadm: Webová služba HELIOS Mobile, verze 1.5.5.668+49 vyžaduje patch ALDOR_462140 a vyšší a .NET Framework 4.8. Obsahuje i kompletní web.config, který musíte upravit podle vašich parametrů připojení (sekce appSettings) a nastavení webového ser…

Webová služba HELIOS Mobile, verze 1.5.5.668+49 vyžaduje patch ALDOR_462140 a vyšší a .NET Framework 4.8. Obsahuje i kompletní web.config, který musíte upravit podle vašich parametrů připojení (sekce appSettings) a nastavení webového serveru (podpora HTTP a HTTPS). Instalace se provádí pouhým rozbalením do kořenového adresáře aplikačního poolu, připraveného pro webovou službu.

ACL:Page/Special:Recentchanges

2022-02-21T14:49:44Z

Wikiadm:

{{#access: assigned to = Group/Admini | actions = *}}
{{#access: assigned to = Group/Helios | actions = read}}
{{#manage rights: assigned to = User:Wikiadm}}

ACL:Page/Special:IntraACL

2022-02-21T14:37:29Z

Wikiadm:

ACL:Page/Special:IntraACL

2022-02-21T14:37:14Z

Wikiadm: Založena nová stránka s textem „{{#access: assigned to = Group/Admini | actions = *}} {{#manage rights: assigned to = User:Wikiadm}}“

ACL:Page/Speciální:Poslední změny

2022-02-21T14:36:36Z

Wikiadm:

ACL:Page//Speciální:IntraACL

2022-02-21T14:35:45Z

Wikiadm:

ACL:Page//Speciální:IntraACL

2022-02-21T14:35:32Z

Wikiadm: Založena nová stránka s textem „{{#access: assigned to = Group/Admini | actions = *}} {{#manage rights: assigned to = User:Wikiadm, Group/Admini}}“

ACL:Page/Speciální:Speciální stránky

2022-02-21T14:32:20Z

Wikiadm:

ACL:Page/Special:Specialpages

2022-02-21T14:31:37Z

Wikiadm:

ACL:Category/Správa Wiki

2022-02-21T14:30:48Z

Wikiadm:

ACL:Category/Aktualizace webové služby

2022-02-21T14:30:12Z

Wikiadm:

{{#access: assigned to = Group/Helios | actions = read}}
{{#access: assigned to = User:Wikiadm | actions = *, manage}}
{{#manage rights: assigned to = User:Wikiadm}}

ACL:Category/Aktualizace webové služby

2022-02-21T14:29:37Z

Wikiadm:

{{#access: assigned to = Group/Helios | actions = read}}
{{#access: assigned to = User:Wikiadm = *, manage}}
{{#manage rights: assigned to = User:Wikiadm}}

ACL:Category/Aktualizace HELIOS Green

2022-02-21T14:29:07Z

Wikiadm:

{{#access: assigned to = Group/Helios | actions = read}}
{{#access: assigned to = User:Wikiadm | actions = *, manage}}
{{#manage rights: assigned to = User:Wikiadm}}

ACL:Namespace/Template

2022-02-21T14:28:38Z

Wikiadm:

{{#access: assigned to = Group/Helios, Group/Hosti | actions = read}}
{{#access: assigned to = User:Wikiadm | actions = *}}
{{#manage rights: assigned to = User:Wikiadm}}

ACL:Namespace/Talk

2022-02-21T14:27:22Z

Wikiadm:

{{#access: assigned to = Group/Helios | actions = edit, read}}
{{#access: assigned to = User:Wikiadm | actions = *}}
{{#access: assigned to = Group/Hosti | actions = read}}
{{#manage rights: assigned to = User:Wikiadm}}

ACL:Namespace/Talk

2022-02-21T14:26:49Z

Wikiadm:

{{#access: assigned to = Group/Helios | actions = edit, read}}
{{#access: assigned to = User:Wikiadmi | actions = *}}
{{#access: assigned to = Group/Hosti | actions = read}}
{{#manage rights: assigned to = User:Wikiadm}}

ACL:Namespace/Main

2022-02-21T14:25:58Z

Wikiadm:

{{#access: assigned to = Group/Helios, Group/Hosti | actions = read}}
{{#access: assigned to = User:Wikiadm | actions = *}}
{{#manage rights: assigned to = User:Wikiadm}}

ACL:Namespace/File

2022-02-21T14:25:28Z

Wikiadm:

{{#access: assigned to = Group/Helios, Group/Hosti | actions = read}}
{{#access: assigned to = User:Wikiadm | actions = *}}
{{#manage rights: assigned to = User:Wikiadm}}

ACL:Namespace/Category

2022-02-21T14:24:42Z

Wikiadm:

{{#access: assigned to = Group/Helios, Group/Hosti | actions = read}}
{{#access: assigned to = User:Wikiadm | actions = *}}
{{#manage rights: assigned to = User:Wikiadm}}

ACL:Category/HELIOS Mobile

2022-02-21T14:15:22Z

Wikiadm:

{{#access: assigned to = Group/Helios, Group/Hosti | actions = read}}
{{#access: assigned to = User:Wikiadm | actions = *, manage}}
{{#manage rights: assigned to = User:Wikiadm}}

ACL:Namespace/ACL

2022-02-21T14:11:52Z

Wikiadm:

ACL:Category/HELIOS Mobile

2022-02-21T13:49:04Z

Wikiadm:

{{#access: assigned to = Group/Helios, Group/Hosti | actions = read}}
{{#access: assigned to = Group/Admini | actions = *, manage}}
{{#manage rights: assigned to = User:Wikiadm, Group/Admini}}

ACL:Category/HELIOS Mobile

2022-02-21T13:47:45Z

Wikiadm:

{{#access: assigned to = Group/Helios, Group/Hosti | actions = read}}
{{#access: assigned to = Group/Admini | actions = *, manage}}

ACL:Group/Helios

2022-02-21T13:33:37Z

Wikiadm:

{{#member: members = User:Host, User:Klient, User:Rfiala, User:Elektrodesign, User:Vap, User:Asseco, User:Osobr, User:Apigos, User:Jsvaton, User:Pkukla, User:Kturek, User:D2Bsk, User:Breno, User:INO, User:ZCZ, User:ZSK, User:Mucek, User:Biovendor, User:Honeywell, User:Lif, User:Bohemiaenergy, User:Ct}}
{{#manage group: assigned to = Group/Admini}}

ACL:Page/Special:Recentchanges

2022-02-04T11:26:57Z

Wikiadm:

ACL:Page/Special:Recentchanges

2022-02-04T11:21:42Z

Wikiadm:

{{#access: assigned to = Group/Helios, Group/Hosti | actions = read}}
{{#access: assigned to = Group/Admini | actions = *}}
{{#manage rights: assigned to = User:Wikiadm, Group/Admini}}

ACL:Page/Special:Recentchanges

2022-02-04T11:18:42Z

Wikiadm:

{{#access: assigned to = Group/Admini, Group/Helios | actions = *}}
{{#manage rights: assigned to = User:Wikiadm, Group/Admini}}

ACL:Page/Special:Recentchanges

2022-02-04T11:17:50Z

Wikiadm:

ACL:Page/Special:Recentchanges

2022-02-04T11:17:16Z

Wikiadm:

{{#access: assigned to = Group/Admini | actions = *}}
{{#manage rights: assigned to = User:Wikiadm, Group/Admini, Group/Helios}}

ACL:Page/Special:Recentchanges

2022-02-04T11:16:17Z

Wikiadm:

ACL:Page/Speciální:Poslední změny

2022-02-04T11:13:52Z

Wikiadm:

Šablony účtenek

2022-01-10T15:12:29Z

Wikiadm: /* Přehled DPH */

Záznamy třídy Šablona účtenky (1400171) slouží pro definici vzhledu a obsahu účtenky tisknuté terminály.

Atribut název je na zařízení zobrazen v menu (pokud je k dispozici více tiskových šablon).

Atribut EET režim nastavuje, zda má být před tiskem prováděna evidence do EET, popř. zda má o tomto rozhodovat uživatel (hodnota Dotaz).

Šablona XML pak obsahuje XML definici formátu účtenky, který je dále popsán.

{{Sample|Příklad jednoduché účtenky:}}
<code xml>
<?xml version="1.0" encoding="utf-8"?>
<template>
<center>
<text>Společnost a.s.</text>
 
</center>
<line/>
<entriesHeader/>
<entries/>
<line/>
<vatRatesHeader/>
<vatRates/>
<line/>
<right>
<high>
<entriesTotal label="Celkem: "/>
</high>
</right>
<line/>
</template>
</code>

== Text ==
Statický text musí být vždy uzavřený v elementu <code><text></code>. Volný text není podporován.

{{Sample|Příklad:}}
<code xml>
<text>Text</text>
</code>
Pokud je text delší než zbývající místo na aktuálním řádku účtenky, automaticky dochází k přetečení na další řádek, není ale brán ohled na jednotlivá slova.

Vynucené odřádkování je možné provést elementem <code> </code>.

{{Sample|Příklad:}}
<code xml>
<text>První</text>
 
<text>Druhý</text>
</code>

=== Zarovnání ===
Zarovnání textu a obrázků na účtence je možné ovlivnit jedním z následujících elementů.
<code xml>
<left>
<text>Levé</text>
</left>
<center>
<text>Střed</text>
</center>
<right>
<text>Pravé</text>
</right>
</code>
Pokud se tiskárna aktuálně nenachází na novém prázdném řádku, dojde k ukončení aktuálního řádku.

=== Styl textu ===
==== Tučný ====
Pro použití tučného řezu písma stačí vložit příslušný obsah do elementu <code></code>.

{{Sample|Příklad:}}
<code xml>

<text>Tučný text</text>

</code>

==== Podtržený ====
K dispozici jsou dva elementy pro podtržený text. Klasické podtržení pomocí <code></code> a výraznější <code><u2></code> pro podtržení s dvounásobnou tloušťkou čáry.

{{Sample|Příklad:}}
<code xml>

<text>Podtržený text</text>

<u2>
<text>Dvojitě podtržený text</text>
</u2>
</code>

==== Inverzní ====
Pro tisk v inverzním režimu (černé pozadí, bílý text) stačí použít element <code><invert></code>.

{{Sample|Příklad:}}
<code xml>
<invert>
<text>Inverzní text</text>
</invert>
</code>

=== Řádkování ===
Velikost vertikálních mezer mezi jednotlivými řádky je možné ovlivnit jejich uzavřením v elementu <code><spacing value="##"></code>, kde hodnota atributu <code>value</code> udává nový rozestup mezi řádky. Hodnota je vyjádřena v bodech, kdy jeden bod obvykle odpovídá 0,125 mm. Výchozí hodnota je 30 bodů (3,75 mm).

{{Sample|Příklad:}}
<spacing value="50">
<text>První</text> 
<text>Druhý</text> 
<text>Třetí</text> 
</spacing>

=== Velikost ===
Velikost znaků textu (a veškerého tištěného obsahu) na účtence je možné zdvojnásobit v obou směrech.

Pro široký tisk (dvounásobná šířka) slouží element <code><wide></code>.

{{Sample|Příklad:}}
<code xml>
<wide>
<text>Široký text</text>
</wide>
</code>

Pro vysoký tisk (dvounásobná výška) slouží element <code><high></code>.

{{Sample|Příklad:}}
<code xml>
<high>
<text>Vysoký text</text>
</high>
</code>

Pro velký tisk (dvounásobná výška i šířka) slouží element <code><big></code>.

{{Sample|Příklad:}}
<code xml>
<big>
<text>Velký text</text>
</big>
</code>

Pokud potřebujeme dočasně v některém z předešlých bloků použít standardní velikost, použijeme element <code><normal></code>.

{{Sample|Příklad:}}
<code xml>
<big>
<text>Velký text</text>
<normal>
<text>Malý text</text>
</normal>
<text>Velký text 2</text>
</big>
</code>

== Oddělovací prvky ==
Tyto prvky jsou ideální pro vizuální oddělení jednotlivých sekcí účtenky.

=== Čáry ===
V základu jsou k dispozici tři druhy čar. Obyčejná (<code><line/></code>), tlustá (<code><thickLine/></code>) a dvojitá (<code><doubleLine/></code>).

{{Sample|Příklad:}}
<code xml>
<text>První sekce</text>
<line/>
<text>Druhá sekce</text>
<thickLine/>
<text>Třetí sekce</text>
<doubleLine/>
<text>Poslední sekce</text>
</code>

Všechny tyto čáry je možné vytisknout v čárkovaném provedení pomocí atributu <code>dashed</code>. Tento atribut podporuje základní <code>true/false</code> hodnoty, je možné použít i pokročilý režim zápisu, kdy sekvencí kladných a záporných čísel oddělených dvojtečkou můžeme zadefinovat poměr vzoru čáry (kladné číslo) a mezery (záporné číslo).

{{Sample|Příklad:}}
<code xml>
<text>První sekce</text>
<line dashed="19:-7"/>
<text>Druhá sekce</text>
</code>

Hodnota <code>19:-7</code> použitá v příkladu říká, že na 19 bodech šířky bude vytištěn vzor zvolené čáry (v tomto případě základní čára) a poté bude na 7 bodů přerušena mezerou. Čísel může být v zápisu libovolné množství, například <code>19:-7:3:-7</code> bude mít za následek čerchovanou čáru.

==== Vlastní čáry ====

Základní oddělovací čára (<code><line/></code>), může být parametrizována vlastním vzorem.

{{Sample|Příklad:}}
<code xml>
<text>První sekce</text>
<line pattern="3C3C"/>
<text>Druhá sekce</text>
</code>

Hodnota atributu je hexadecimálním zápisem vzoru čáry, číslo musí být zarovnané vždy na násobek 8 bitů.
Pokud převedeme číslo za našeho příkladu do binárního zápisu, získáme vertikální vzor čáry, který tiskárna horizontálně opakuje.

<code text>
3C3C = 0011110000111100
</code>

Dva horní body budou bílé, pod nimi čtyři body černé, následně čtyři body bílé a tak dále. Vytištěním příkladu bychom dostali dvounásobnou tlustou čáru. Pro tvorbu vlastních čar je vhodné použít [http://www.binaryhexconverter.com/binary-to-hex-converter převodník z binárního zápisu do hexadecimálního].

=== Znakový oddělovač ===
Element <code><separator text="="/></code> slouží k vyplnění celé řádky opakováním řetězce z atributu <code>text</code>. Atribut může obsahovat libovolně dlouhý řetězec. Výchozí hodnota atributu je <code>—</code>.

{{Sample|Příklad:}}
<code xml>
<text>První sekce</text>
<separator/>
<text>Druhá sekce</text>
</code>

== Obrázky ==
Pomocí elementu <code><img></code> je možné na účtenku vytisknout libovolný obrázek, například logo společnosti.

{{Sample|Příklad:}}
<code xml>
<img bw="true">
data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAWIAAABcCAAAAABxMODPAAAACXBIWXMAAAsTA
AALEwEAmpwYAAADGGlDQ1BQaG90b3Nob3AgSUNDIHByb2ZpbGUAAHjaY2BgnuDo4uTKJMDAUFBUUuQYgexI
…
…
…
goAAAANSUhwexg9iRg7iSdZ6jksHjaY2NDIHB2ZpbGUAAgtoCuj/wYA6GdORYwNqUoAAAAASUVORK5CYII=
</img>
</code>

Data obrázku jsou obsažena uvnitř elementu. Jedná se data kódovaná v Base64 a jsou podporovány standardní formáty obrázků (PNG, JPEG, GIF, BMP). Způsob zápisu je obdobný jako například v případě CSS (data uri). Pro převod souboru obrázku na Base64 řetězec je nutné použít příslušný [http://www.base64-image.de/ konvertor].

Volitelný atribut <code>bw</code> nastavuje způsob převodu obrázku do tiskových dat. Pokud je nastaven na <code>true</code> je každý nebílý (není brán ohled na průhlednost) bod vytisknut jako černý, v opačném případě se snaží aplikace převést barvy do černobílé podoby pomocí ditheringu.

== Podmíněný blok ==
Pro vytvoření účtenky, jejíž obsah se dynamicky mění na základě aktuálních okolností tisku, je užitečný podmíněný blok uzavřený do elementu <code><if key="identifikátor podmínky"></code> nebo v negované alternativě <code><ifNot key="identifikátor podmínky"></code>.

Atribut <code>key</code> obsahuje identifikátor podmínky, aktuálně podporované podmínky jsou:
* '''eet''' – pro účtenku byla zaevidována tržba (bez ohledu na její odeslání),
* '''eet_online''' – tržba byla úspěšně odeslána na server Finanční správy (máme k dispozici FIK),
* '''partial_payment''' – součet ceny položek je menší je větší než celková částka EET (zákazník zaplatil pouze část),
* '''dic_poverujiciho''' – na tržbě bylo vyplněno DIČ pověřujícího poplatníka.

{{Sample|Příklad (EET patička účtenky - kde chybějící FIK nemá za následek prázdný řádek):}}
<code xml>
<if flag="eet_online">
<eet value="fik" label="FIK: "/>
 
</if>
<eet value="bkp" label="BKP: "/>
 
<ifNot flag="eet_online">
<eet value="pkp"label="PKP: "/>
 
</ifNot>
<eet value="rezim" label="Režim tržby: "/>
</code>

== Hodnoty ==
Kromě statického textu je možné na účtence používat i dynamické hodnoty z tisknutého záznamu.

=== EET ===
Data týkající se příslušné EET tržby je možné získat pomocí elementu <code><eet value="identifikátor hodnoty" label="popisek"/></code>.

Atribut <code>value</code> je identifikátor hodnoty a může nabývat těchto hodnot:
* '''dat_trzby''' – datum tržby v plném formátu (DD.MM.YYYY hh:mm:ss),
* '''dat_trzby2''' – datum tržby ve formátu se zkráceným rokem (DD.MM.YY hh:mm:ss),
* '''porad_cis''' – pořadové číslo účtenky,
* '''id_provoz''' – označení provozovny,
* '''id_pokl''' – označení pokladního zařízení,
* '''dic_popl''' – DIČ poplatníka,
* '''dic_poverujiciho''' – DIČ pověřujícího poplatníka,
* '''rezim''' – režim evidované tržby (nabývá hodnot "Běžný" nebo "Zjednodušený"),
* '''celk_trzba''' – celková částka tržby,
* '''pkp''' – podpisový kód poplatníka
* '''bkp''' – bezpečnostní kód poplatníka,
* '''fik''' – fiskální identifikační kód.

Atribut <code>label</code> může voltelně obsahovat popisek, který bude vytištěn před hodnotu.

Pokud hodnota není k dispozici (je prázdná), je tisk hodnoty vynechán, a to včetně popisku. K dispozici nemusí být například fiskální identifikační kód, pokud se nepodařilo odeslat tržbu na servery Finanční správy.

{{Sample|Příklad:}}
<code xml>
<eet value="dic_popl" label="DIČ: "/> 
<eet value="id_provoz" label="Provozovna: "/> 
<eet value="id_pokl" label="Pokladna: "/> 
<eet value="porad_cis" label="Číslo dokladu: "/> 
<eet value="dat_trzby_2" label="Datum tržby: "/> 
</code>

=== Položky ===
Pro tisk tabulky s přehledem položek tisknutého záznamu slouží elementy <code><entries/></code> a <code><entriesHeader/></code>. První z elementů tiskne obsah tabulky, druhý pak záhlaví tabulky. Toto rozdělení bylo zvoleno pro lepší možnosti formátování účtenky (např. použitím oddělovače mezi tabulkou a jejím záhlavím).

{{Sample|Příklad:}}
<code xml>
<entriesHeader/>
<entries/>
</code>
Má za následek tento výstup:
<pre>
Kč
ZUBR Gold <11 20x0,5 1081,74 C
100 x 10,82
ZUBR Premium <12 20x0, 984,46 C
80 x 12,31
Lahev 0,5l 540,00 D
180 x 3,00
DOMICIL UNIV prázdný 0 900,00 D
9 x 100,00
</pre>

První řádek obsahuje název položky, celkovou cenu a písmeno určující sazbu DPH. Druhý řádek pak obsahuje počet a jednotkovou cenu.

Element <code><entries/></code> může voletelně obsahovat atribut <code>vat</code>, jehož výchozí hodnota je <code>true</code>, v tomto režimu jsou tisknuty ceny včetně DPH, pro tisk cen bez DPH je nutné nastavit hodnotu <code>false</code>.

==== Suma ====

Element <code><entriesTotal label="popisek"/></code> je ekvivalentem eet hodnoty <code>celk_trzba</code> pro situace, kdy neprovádíme EET, nebo dochází k částečné úhradě dokladu (pak se tyto dvě hodnoty liší).

=== Přehled DPH ===
Tabulku se souhrnem všech na záznamu použitých sazeb DPH, která zároveň slouží jako legenda k tabulce položek (písmena na konci řádků) vytiskneme pomocí elementů <code><vatRates/></code> a <code><vatRatesHeader/></code>. Stejně tedy jako v případě položek je záhlaví odděleno od obsahu do vlastního elementu.

{{Sample|Příklad:}}
<code xml>
<vatRatesHeader/>
<vatRates/>
</code>
Má za následek tento výstup:
<pre>
% Základ Daň Celkem
C 21 1707,60 358,60 2066,20
D 0 1440,00 0,00 1440,00
</pre>

První sloupec obsahuje písmeno reprezentující sazbu v tabulce položek, dále následuje procentuální sazba, cena základ, samotná daň a celkový součet. Pokud je tisknutelná oblast účtenky příliš úzká, nebo pokud pracujeme s velkými částkami, dojde k vynechání sloupce Daň nebo Základ.

Tabulka přehledu DPH může mít dva různé datové zdroje. Zdroj dat je možné nastavit pomocí atributu <code>source</code>, ten může nabývat těchto hodnot:
* '''auto''' (výchozí) – pokud jsou k dispozici EET data, jsou použity hodnoty z EET tržby, v opačném případě jsou hodnoty vypočteny z položek,
* '''eet''' – jsou použity hodnoty z EET tržby,
* '''entries''' – hodnoty jsou vypočteny z položek.

Atribut musí být nastaven na obou elementech (tedy i na záhlaví).

Rozdílný zdroj je důležitý například, pokud chceme na účtence zobrazit detaily částečné úhrady.

{{Sample|Příklad dynamické účtenky s podporou pro částečnou úhradu:}}
<code xml>
<entriesHeader/>
<entries/>
<line/>
<vatRatesHeader source="entries"/>
<vatRates source="entries"/>
<line/>
<right>
<if flag="partial_payment">
<entriesTotal label="Celkem: "/>
</if>
<ifNot flag="partial_payment">
<high>
<eet value="celk_trzba" label="Celkem: "/>
</high>
</ifNot>
</right>
<line/>
<if flag="partial_payment">
<text>Platba:</text>
 
<line/>
<vatRatesHeader source="eet"/>
<vatRates source="eet"/>
<line/>
<right>
<high>
<eet value="celk_trzba" label="Zaplaceno: "/>
</high>
</right>
<line/>
</if>
</code>

== Hlavička ==
Pokud je nutné odlišit účtenky nad rámec EET hodnot (například rozdílné logo, či údaje společnosti), je možné použít hlavičkovou šablonu v UDA atributu „Hlavička účtenky Mobile“. Atribut má stejnou syntaxi zápisu jako běžné šablony účtenky.

Pro vložení do šablony hlavičky slouží element <code><header/></code>.

Šablony účtenek

2022-01-10T15:10:27Z

Wikiadm: /* Položky */

Záznamy třídy Šablona účtenky (1400171) slouží pro definici vzhledu a obsahu účtenky tisknuté terminály.

Atribut název je na zařízení zobrazen v menu (pokud je k dispozici více tiskových šablon).

Atribut EET režim nastavuje, zda má být před tiskem prováděna evidence do EET, popř. zda má o tomto rozhodovat uživatel (hodnota Dotaz).

Šablona XML pak obsahuje XML definici formátu účtenky, který je dále popsán.

{{Sample|Příklad jednoduché účtenky:}}
<code xml>
<?xml version="1.0" encoding="utf-8"?>
<template>
<center>
<text>Společnost a.s.</text>
 
</center>
<line/>
<entriesHeader/>
<entries/>
<line/>
<vatRatesHeader/>
<vatRates/>
<line/>
<right>
<high>
<entriesTotal label="Celkem: "/>
</high>
</right>
<line/>
</template>
</code>

== Text ==
Statický text musí být vždy uzavřený v elementu <code><text></code>. Volný text není podporován.

{{Sample|Příklad:}}
<code xml>
<text>Text</text>
</code>
Pokud je text delší než zbývající místo na aktuálním řádku účtenky, automaticky dochází k přetečení na další řádek, není ale brán ohled na jednotlivá slova.

Vynucené odřádkování je možné provést elementem <code> </code>.

{{Sample|Příklad:}}
<code xml>
<text>První</text>
 
<text>Druhý</text>
</code>

=== Zarovnání ===
Zarovnání textu a obrázků na účtence je možné ovlivnit jedním z následujících elementů.
<code xml>
<left>
<text>Levé</text>
</left>
<center>
<text>Střed</text>
</center>
<right>
<text>Pravé</text>
</right>
</code>
Pokud se tiskárna aktuálně nenachází na novém prázdném řádku, dojde k ukončení aktuálního řádku.

=== Styl textu ===
==== Tučný ====
Pro použití tučného řezu písma stačí vložit příslušný obsah do elementu <code></code>.

{{Sample|Příklad:}}
<code xml>

<text>Tučný text</text>

</code>

==== Podtržený ====
K dispozici jsou dva elementy pro podtržený text. Klasické podtržení pomocí <code></code> a výraznější <code><u2></code> pro podtržení s dvounásobnou tloušťkou čáry.

{{Sample|Příklad:}}
<code xml>

<text>Podtržený text</text>

<u2>
<text>Dvojitě podtržený text</text>
</u2>
</code>

==== Inverzní ====
Pro tisk v inverzním režimu (černé pozadí, bílý text) stačí použít element <code><invert></code>.

{{Sample|Příklad:}}
<code xml>
<invert>
<text>Inverzní text</text>
</invert>
</code>

=== Řádkování ===
Velikost vertikálních mezer mezi jednotlivými řádky je možné ovlivnit jejich uzavřením v elementu <code><spacing value="##"></code>, kde hodnota atributu <code>value</code> udává nový rozestup mezi řádky. Hodnota je vyjádřena v bodech, kdy jeden bod obvykle odpovídá 0,125 mm. Výchozí hodnota je 30 bodů (3,75 mm).

{{Sample|Příklad:}}
<spacing value="50">
<text>První</text> 
<text>Druhý</text> 
<text>Třetí</text> 
</spacing>

=== Velikost ===
Velikost znaků textu (a veškerého tištěného obsahu) na účtence je možné zdvojnásobit v obou směrech.

Pro široký tisk (dvounásobná šířka) slouží element <code><wide></code>.

{{Sample|Příklad:}}
<code xml>
<wide>
<text>Široký text</text>
</wide>
</code>

Pro vysoký tisk (dvounásobná výška) slouží element <code><high></code>.

{{Sample|Příklad:}}
<code xml>
<high>
<text>Vysoký text</text>
</high>
</code>

Pro velký tisk (dvounásobná výška i šířka) slouží element <code><big></code>.

{{Sample|Příklad:}}
<code xml>
<big>
<text>Velký text</text>
</big>
</code>

Pokud potřebujeme dočasně v některém z předešlých bloků použít standardní velikost, použijeme element <code><normal></code>.

{{Sample|Příklad:}}
<code xml>
<big>
<text>Velký text</text>
<normal>
<text>Malý text</text>
</normal>
<text>Velký text 2</text>
</big>
</code>

== Oddělovací prvky ==
Tyto prvky jsou ideální pro vizuální oddělení jednotlivých sekcí účtenky.

=== Čáry ===
V základu jsou k dispozici tři druhy čar. Obyčejná (<code><line/></code>), tlustá (<code><thickLine/></code>) a dvojitá (<code><doubleLine/></code>).

{{Sample|Příklad:}}
<code xml>
<text>První sekce</text>
<line/>
<text>Druhá sekce</text>
<thickLine/>
<text>Třetí sekce</text>
<doubleLine/>
<text>Poslední sekce</text>
</code>

Všechny tyto čáry je možné vytisknout v čárkovaném provedení pomocí atributu <code>dashed</code>. Tento atribut podporuje základní <code>true/false</code> hodnoty, je možné použít i pokročilý režim zápisu, kdy sekvencí kladných a záporných čísel oddělených dvojtečkou můžeme zadefinovat poměr vzoru čáry (kladné číslo) a mezery (záporné číslo).

{{Sample|Příklad:}}
<code xml>
<text>První sekce</text>
<line dashed="19:-7"/>
<text>Druhá sekce</text>
</code>

Hodnota <code>19:-7</code> použitá v příkladu říká, že na 19 bodech šířky bude vytištěn vzor zvolené čáry (v tomto případě základní čára) a poté bude na 7 bodů přerušena mezerou. Čísel může být v zápisu libovolné množství, například <code>19:-7:3:-7</code> bude mít za následek čerchovanou čáru.

==== Vlastní čáry ====

Základní oddělovací čára (<code><line/></code>), může být parametrizována vlastním vzorem.

{{Sample|Příklad:}}
<code xml>
<text>První sekce</text>
<line pattern="3C3C"/>
<text>Druhá sekce</text>
</code>

Hodnota atributu je hexadecimálním zápisem vzoru čáry, číslo musí být zarovnané vždy na násobek 8 bitů.
Pokud převedeme číslo za našeho příkladu do binárního zápisu, získáme vertikální vzor čáry, který tiskárna horizontálně opakuje.

<code text>
3C3C = 0011110000111100
</code>

Dva horní body budou bílé, pod nimi čtyři body černé, následně čtyři body bílé a tak dále. Vytištěním příkladu bychom dostali dvounásobnou tlustou čáru. Pro tvorbu vlastních čar je vhodné použít [http://www.binaryhexconverter.com/binary-to-hex-converter převodník z binárního zápisu do hexadecimálního].

=== Znakový oddělovač ===
Element <code><separator text="="/></code> slouží k vyplnění celé řádky opakováním řetězce z atributu <code>text</code>. Atribut může obsahovat libovolně dlouhý řetězec. Výchozí hodnota atributu je <code>—</code>.

{{Sample|Příklad:}}
<code xml>
<text>První sekce</text>
<separator/>
<text>Druhá sekce</text>
</code>

== Obrázky ==
Pomocí elementu <code><img></code> je možné na účtenku vytisknout libovolný obrázek, například logo společnosti.

{{Sample|Příklad:}}
<code xml>
<img bw="true">
data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAWIAAABcCAAAAABxMODPAAAACXBIWXMAAAsTA
AALEwEAmpwYAAADGGlDQ1BQaG90b3Nob3AgSUNDIHByb2ZpbGUAAHjaY2BgnuDo4uTKJMDAUFBUUuQYgexI
…
…
…
goAAAANSUhwexg9iRg7iSdZ6jksHjaY2NDIHB2ZpbGUAAgtoCuj/wYA6GdORYwNqUoAAAAASUVORK5CYII=
</img>
</code>

Data obrázku jsou obsažena uvnitř elementu. Jedná se data kódovaná v Base64 a jsou podporovány standardní formáty obrázků (PNG, JPEG, GIF, BMP). Způsob zápisu je obdobný jako například v případě CSS (data uri). Pro převod souboru obrázku na Base64 řetězec je nutné použít příslušný [http://www.base64-image.de/ konvertor].

Volitelný atribut <code>bw</code> nastavuje způsob převodu obrázku do tiskových dat. Pokud je nastaven na <code>true</code> je každý nebílý (není brán ohled na průhlednost) bod vytisknut jako černý, v opačném případě se snaží aplikace převést barvy do černobílé podoby pomocí ditheringu.

== Podmíněný blok ==
Pro vytvoření účtenky, jejíž obsah se dynamicky mění na základě aktuálních okolností tisku, je užitečný podmíněný blok uzavřený do elementu <code><if key="identifikátor podmínky"></code> nebo v negované alternativě <code><ifNot key="identifikátor podmínky"></code>.

Atribut <code>key</code> obsahuje identifikátor podmínky, aktuálně podporované podmínky jsou:
* '''eet''' – pro účtenku byla zaevidována tržba (bez ohledu na její odeslání),
* '''eet_online''' – tržba byla úspěšně odeslána na server Finanční správy (máme k dispozici FIK),
* '''partial_payment''' – součet ceny položek je menší je větší než celková částka EET (zákazník zaplatil pouze část),
* '''dic_poverujiciho''' – na tržbě bylo vyplněno DIČ pověřujícího poplatníka.

{{Sample|Příklad (EET patička účtenky - kde chybějící FIK nemá za následek prázdný řádek):}}
<code xml>
<if flag="eet_online">
<eet value="fik" label="FIK: "/>
 
</if>
<eet value="bkp" label="BKP: "/>
 
<ifNot flag="eet_online">
<eet value="pkp"label="PKP: "/>
 
</ifNot>
<eet value="rezim" label="Režim tržby: "/>
</code>

== Hodnoty ==
Kromě statického textu je možné na účtence používat i dynamické hodnoty z tisknutého záznamu.

=== EET ===
Data týkající se příslušné EET tržby je možné získat pomocí elementu <code><eet value="identifikátor hodnoty" label="popisek"/></code>.

Atribut <code>value</code> je identifikátor hodnoty a může nabývat těchto hodnot:
* '''dat_trzby''' – datum tržby v plném formátu (DD.MM.YYYY hh:mm:ss),
* '''dat_trzby2''' – datum tržby ve formátu se zkráceným rokem (DD.MM.YY hh:mm:ss),
* '''porad_cis''' – pořadové číslo účtenky,
* '''id_provoz''' – označení provozovny,
* '''id_pokl''' – označení pokladního zařízení,
* '''dic_popl''' – DIČ poplatníka,
* '''dic_poverujiciho''' – DIČ pověřujícího poplatníka,
* '''rezim''' – režim evidované tržby (nabývá hodnot "Běžný" nebo "Zjednodušený"),
* '''celk_trzba''' – celková částka tržby,
* '''pkp''' – podpisový kód poplatníka
* '''bkp''' – bezpečnostní kód poplatníka,
* '''fik''' – fiskální identifikační kód.

Atribut <code>label</code> může voltelně obsahovat popisek, který bude vytištěn před hodnotu.

Pokud hodnota není k dispozici (je prázdná), je tisk hodnoty vynechán, a to včetně popisku. K dispozici nemusí být například fiskální identifikační kód, pokud se nepodařilo odeslat tržbu na servery Finanční správy.

{{Sample|Příklad:}}
<code xml>
<eet value="dic_popl" label="DIČ: "/> 
<eet value="id_provoz" label="Provozovna: "/> 
<eet value="id_pokl" label="Pokladna: "/> 
<eet value="porad_cis" label="Číslo dokladu: "/> 
<eet value="dat_trzby_2" label="Datum tržby: "/> 
</code>

=== Položky ===
Pro tisk tabulky s přehledem položek tisknutého záznamu slouží elementy <code><entries/></code> a <code><entriesHeader/></code>. První z elementů tiskne obsah tabulky, druhý pak záhlaví tabulky. Toto rozdělení bylo zvoleno pro lepší možnosti formátování účtenky (např. použitím oddělovače mezi tabulkou a jejím záhlavím).

{{Sample|Příklad:}}
<code xml>
<entriesHeader/>
<entries/>
</code>
Má za následek tento výstup:
<pre>
Kč
ZUBR Gold <11 20x0,5 1081,74 C
100 x 10,82
ZUBR Premium <12 20x0, 984,46 C
80 x 12,31
Lahev 0,5l 540,00 D
180 x 3,00
DOMICIL UNIV prázdný 0 900,00 D
9 x 100,00
</pre>

První řádek obsahuje název položky, celkovou cenu a písmeno určující sazbu DPH. Druhý řádek pak obsahuje počet a jednotkovou cenu.

Element <code><entries/></code> může voletelně obsahovat atribut <code>vat</code>, jehož výchozí hodnota je <code>true</code>, v tomto režimu jsou tisknuty ceny včetně DPH, pro tisk cen bez DPH je nutné nastavit hodnotu <code>false</code>.

==== Suma ====

Element <code><entriesTotal label="popisek"/></code> je ekvivalentem eet hodnoty <code>celk_trzba</code> pro situace, kdy neprovádíme EET, nebo dochází k částečné úhradě dokladu (pak se tyto dvě hodnoty liší).

=== Přehled DPH ===
Tabulku se souhrnem všech na záznamu použitých sazeb DPH, která zároveň slouží jako legenda k tabulce položek (písmena na konci řádků) vytiskneme pomocí elementů <code><vatRates/></code> a <code><vatRatesHeader/></code>. Stejně tedy jako v případě položek je záhlaví odděleno od obsahu do vlastního elementu.

{{Sample|Příklad:}}
<code xml>
<vatRatesHeader/>
<vatRates/>
</code>
Má za následek tento výstup:
<pre>
% Základ Daň Celkem
C 21 1707,60 358,60 2066,20
D 0 1440,00 0,00 1440,00
</pre>

První sloupec obsahuje písmeno reprezentující sazbu v tabulce položek, dále následuje procentuelní sazba, cena základ, samotná daň a celkový součet. Pokud je tisknutelná oblast účtenky příliš úzká, nebo pokud pracujeme s velkými částkami, dojde k vynechání sloupce Daň nebo Základ.

Tabulka přehledu DPH může mít dva různé datové zdroje. Zdroj dat je možné nastavit pomocí atributu <code>source</code>, ten může nabývat těchto hodnot:
* '''auto''' (výchozí) – pokud jsou k dispozici EET data, jsou použity hodnoty z EET tržby, v opačném případě jsou hodnoty vypočteny z položek,
* '''eet''' – jsou použity hodnoty z EET tržby,
* '''entries''' – hodnoty jsou vypočteny z položek.

Atribut musí být nastaven na obou elementech (tedy i na záhlaví).

Rozdílný zdroj je důležitý například, pokud chceme na účtence zobrazit detaily částečné úhrady.

{{Sample|Příklad dynamické účtenky s podporou pro částečnou úhradu:}}
<code xml>
<entriesHeader/>
<entries/>
<line/>
<vatRatesHeader source="entries"/>
<vatRates source="entries"/>
<line/>
<right>
<if flag="partial_payment">
<entriesTotal label="Celkem: "/>
</if>
<ifNot flag="partial_payment">
<high>
<eet value="celk_trzba" label="Celkem: "/>
</high>
</ifNot>
</right>
<line/>
<if flag="partial_payment">
<text>Platba:</text>
 
<line/>
<vatRatesHeader source="eet"/>
<vatRates source="eet"/>
<line/>
<right>
<high>
<eet value="celk_trzba" label="Zaplaceno: "/>
</high>
</right>
<line/>
</if>
</code>

== Hlavička ==
Pokud je nutné odlišit účtenky nad rámec EET hodnot (například rozdílné logo, či údaje společnosti), je možné použít hlavičkovou šablonu v UDA atributu „Hlavička účtenky Mobile“. Atribut má stejnou syntaxi zápisu jako běžné šablony účtenky.

Pro vložení do šablony hlavičky slouží element <code><header/></code>.

Šablony účtenek

2022-01-10T15:09:05Z

Wikiadm: /* Položky */

Záznamy třídy Šablona účtenky (1400171) slouží pro definici vzhledu a obsahu účtenky tisknuté terminály.

Atribut název je na zařízení zobrazen v menu (pokud je k dispozici více tiskových šablon).

Atribut EET režim nastavuje, zda má být před tiskem prováděna evidence do EET, popř. zda má o tomto rozhodovat uživatel (hodnota Dotaz).

Šablona XML pak obsahuje XML definici formátu účtenky, který je dále popsán.

{{Sample|Příklad jednoduché účtenky:}}
<code xml>
<?xml version="1.0" encoding="utf-8"?>
<template>
<center>
<text>Společnost a.s.</text>
 
</center>
<line/>
<entriesHeader/>
<entries/>
<line/>
<vatRatesHeader/>
<vatRates/>
<line/>
<right>
<high>
<entriesTotal label="Celkem: "/>
</high>
</right>
<line/>
</template>
</code>

== Text ==
Statický text musí být vždy uzavřený v elementu <code><text></code>. Volný text není podporován.

{{Sample|Příklad:}}
<code xml>
<text>Text</text>
</code>
Pokud je text delší než zbývající místo na aktuálním řádku účtenky, automaticky dochází k přetečení na další řádek, není ale brán ohled na jednotlivá slova.

Vynucené odřádkování je možné provést elementem <code> </code>.

{{Sample|Příklad:}}
<code xml>
<text>První</text>
 
<text>Druhý</text>
</code>

=== Zarovnání ===
Zarovnání textu a obrázků na účtence je možné ovlivnit jedním z následujících elementů.
<code xml>
<left>
<text>Levé</text>
</left>
<center>
<text>Střed</text>
</center>
<right>
<text>Pravé</text>
</right>
</code>
Pokud se tiskárna aktuálně nenachází na novém prázdném řádku, dojde k ukončení aktuálního řádku.

=== Styl textu ===
==== Tučný ====
Pro použití tučného řezu písma stačí vložit příslušný obsah do elementu <code></code>.

{{Sample|Příklad:}}
<code xml>

<text>Tučný text</text>

</code>

==== Podtržený ====
K dispozici jsou dva elementy pro podtržený text. Klasické podtržení pomocí <code></code> a výraznější <code><u2></code> pro podtržení s dvounásobnou tloušťkou čáry.

{{Sample|Příklad:}}
<code xml>

<text>Podtržený text</text>

<u2>
<text>Dvojitě podtržený text</text>
</u2>
</code>

==== Inverzní ====
Pro tisk v inverzním režimu (černé pozadí, bílý text) stačí použít element <code><invert></code>.

{{Sample|Příklad:}}
<code xml>
<invert>
<text>Inverzní text</text>
</invert>
</code>

=== Řádkování ===
Velikost vertikálních mezer mezi jednotlivými řádky je možné ovlivnit jejich uzavřením v elementu <code><spacing value="##"></code>, kde hodnota atributu <code>value</code> udává nový rozestup mezi řádky. Hodnota je vyjádřena v bodech, kdy jeden bod obvykle odpovídá 0,125 mm. Výchozí hodnota je 30 bodů (3,75 mm).

{{Sample|Příklad:}}
<spacing value="50">
<text>První</text> 
<text>Druhý</text> 
<text>Třetí</text> 
</spacing>

=== Velikost ===
Velikost znaků textu (a veškerého tištěného obsahu) na účtence je možné zdvojnásobit v obou směrech.

Pro široký tisk (dvounásobná šířka) slouží element <code><wide></code>.

{{Sample|Příklad:}}
<code xml>
<wide>
<text>Široký text</text>
</wide>
</code>

Pro vysoký tisk (dvounásobná výška) slouží element <code><high></code>.

{{Sample|Příklad:}}
<code xml>
<high>
<text>Vysoký text</text>
</high>
</code>

Pro velký tisk (dvounásobná výška i šířka) slouží element <code><big></code>.

{{Sample|Příklad:}}
<code xml>
<big>
<text>Velký text</text>
</big>
</code>

Pokud potřebujeme dočasně v některém z předešlých bloků použít standardní velikost, použijeme element <code><normal></code>.

{{Sample|Příklad:}}
<code xml>
<big>
<text>Velký text</text>
<normal>
<text>Malý text</text>
</normal>
<text>Velký text 2</text>
</big>
</code>

== Oddělovací prvky ==
Tyto prvky jsou ideální pro vizuální oddělení jednotlivých sekcí účtenky.

=== Čáry ===
V základu jsou k dispozici tři druhy čar. Obyčejná (<code><line/></code>), tlustá (<code><thickLine/></code>) a dvojitá (<code><doubleLine/></code>).

{{Sample|Příklad:}}
<code xml>
<text>První sekce</text>
<line/>
<text>Druhá sekce</text>
<thickLine/>
<text>Třetí sekce</text>
<doubleLine/>
<text>Poslední sekce</text>
</code>

Všechny tyto čáry je možné vytisknout v čárkovaném provedení pomocí atributu <code>dashed</code>. Tento atribut podporuje základní <code>true/false</code> hodnoty, je možné použít i pokročilý režim zápisu, kdy sekvencí kladných a záporných čísel oddělených dvojtečkou můžeme zadefinovat poměr vzoru čáry (kladné číslo) a mezery (záporné číslo).

{{Sample|Příklad:}}
<code xml>
<text>První sekce</text>
<line dashed="19:-7"/>
<text>Druhá sekce</text>
</code>

Hodnota <code>19:-7</code> použitá v příkladu říká, že na 19 bodech šířky bude vytištěn vzor zvolené čáry (v tomto případě základní čára) a poté bude na 7 bodů přerušena mezerou. Čísel může být v zápisu libovolné množství, například <code>19:-7:3:-7</code> bude mít za následek čerchovanou čáru.

==== Vlastní čáry ====

Základní oddělovací čára (<code><line/></code>), může být parametrizována vlastním vzorem.

{{Sample|Příklad:}}
<code xml>
<text>První sekce</text>
<line pattern="3C3C"/>
<text>Druhá sekce</text>
</code>

Hodnota atributu je hexadecimálním zápisem vzoru čáry, číslo musí být zarovnané vždy na násobek 8 bitů.
Pokud převedeme číslo za našeho příkladu do binárního zápisu, získáme vertikální vzor čáry, který tiskárna horizontálně opakuje.

<code text>
3C3C = 0011110000111100
</code>

Dva horní body budou bílé, pod nimi čtyři body černé, následně čtyři body bílé a tak dále. Vytištěním příkladu bychom dostali dvounásobnou tlustou čáru. Pro tvorbu vlastních čar je vhodné použít [http://www.binaryhexconverter.com/binary-to-hex-converter převodník z binárního zápisu do hexadecimálního].

=== Znakový oddělovač ===
Element <code><separator text="="/></code> slouží k vyplnění celé řádky opakováním řetězce z atributu <code>text</code>. Atribut může obsahovat libovolně dlouhý řetězec. Výchozí hodnota atributu je <code>—</code>.

{{Sample|Příklad:}}
<code xml>
<text>První sekce</text>
<separator/>
<text>Druhá sekce</text>
</code>

== Obrázky ==
Pomocí elementu <code><img></code> je možné na účtenku vytisknout libovolný obrázek, například logo společnosti.

{{Sample|Příklad:}}
<code xml>
<img bw="true">
data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAWIAAABcCAAAAABxMODPAAAACXBIWXMAAAsTA
AALEwEAmpwYAAADGGlDQ1BQaG90b3Nob3AgSUNDIHByb2ZpbGUAAHjaY2BgnuDo4uTKJMDAUFBUUuQYgexI
…
…
…
goAAAANSUhwexg9iRg7iSdZ6jksHjaY2NDIHB2ZpbGUAAgtoCuj/wYA6GdORYwNqUoAAAAASUVORK5CYII=
</img>
</code>

Data obrázku jsou obsažena uvnitř elementu. Jedná se data kódovaná v Base64 a jsou podporovány standardní formáty obrázků (PNG, JPEG, GIF, BMP). Způsob zápisu je obdobný jako například v případě CSS (data uri). Pro převod souboru obrázku na Base64 řetězec je nutné použít příslušný [http://www.base64-image.de/ konvertor].

Volitelný atribut <code>bw</code> nastavuje způsob převodu obrázku do tiskových dat. Pokud je nastaven na <code>true</code> je každý nebílý (není brán ohled na průhlednost) bod vytisknut jako černý, v opačném případě se snaží aplikace převést barvy do černobílé podoby pomocí ditheringu.

== Podmíněný blok ==
Pro vytvoření účtenky, jejíž obsah se dynamicky mění na základě aktuálních okolností tisku, je užitečný podmíněný blok uzavřený do elementu <code><if key="identifikátor podmínky"></code> nebo v negované alternativě <code><ifNot key="identifikátor podmínky"></code>.

Atribut <code>key</code> obsahuje identifikátor podmínky, aktuálně podporované podmínky jsou:
* '''eet''' – pro účtenku byla zaevidována tržba (bez ohledu na její odeslání),
* '''eet_online''' – tržba byla úspěšně odeslána na server Finanční správy (máme k dispozici FIK),
* '''partial_payment''' – součet ceny položek je menší je větší než celková částka EET (zákazník zaplatil pouze část),
* '''dic_poverujiciho''' – na tržbě bylo vyplněno DIČ pověřujícího poplatníka.

{{Sample|Příklad (EET patička účtenky - kde chybějící FIK nemá za následek prázdný řádek):}}
<code xml>
<if flag="eet_online">
<eet value="fik" label="FIK: "/>
 
</if>
<eet value="bkp" label="BKP: "/>
 
<ifNot flag="eet_online">
<eet value="pkp"label="PKP: "/>
 
</ifNot>
<eet value="rezim" label="Režim tržby: "/>
</code>

== Hodnoty ==
Kromě statického textu je možné na účtence používat i dynamické hodnoty z tisknutého záznamu.

=== EET ===
Data týkající se příslušné EET tržby je možné získat pomocí elementu <code><eet value="identifikátor hodnoty" label="popisek"/></code>.

Atribut <code>value</code> je identifikátor hodnoty a může nabývat těchto hodnot:
* '''dat_trzby''' – datum tržby v plném formátu (DD.MM.YYYY hh:mm:ss),
* '''dat_trzby2''' – datum tržby ve formátu se zkráceným rokem (DD.MM.YY hh:mm:ss),
* '''porad_cis''' – pořadové číslo účtenky,
* '''id_provoz''' – označení provozovny,
* '''id_pokl''' – označení pokladního zařízení,
* '''dic_popl''' – DIČ poplatníka,
* '''dic_poverujiciho''' – DIČ pověřujícího poplatníka,
* '''rezim''' – režim evidované tržby (nabývá hodnot "Běžný" nebo "Zjednodušený"),
* '''celk_trzba''' – celková částka tržby,
* '''pkp''' – podpisový kód poplatníka
* '''bkp''' – bezpečnostní kód poplatníka,
* '''fik''' – fiskální identifikační kód.

Atribut <code>label</code> může voltelně obsahovat popisek, který bude vytištěn před hodnotu.

Pokud hodnota není k dispozici (je prázdná), je tisk hodnoty vynechán, a to včetně popisku. K dispozici nemusí být například fiskální identifikační kód, pokud se nepodařilo odeslat tržbu na servery Finanční správy.

{{Sample|Příklad:}}
<code xml>
<eet value="dic_popl" label="DIČ: "/> 
<eet value="id_provoz" label="Provozovna: "/> 
<eet value="id_pokl" label="Pokladna: "/> 
<eet value="porad_cis" label="Číslo dokladu: "/> 
<eet value="dat_trzby_2" label="Datum tržby: "/> 
</code>

=== Položky ===
Pro tisk tabulky s přehledem položek tisknutého záznamu slouží elementy <code><entries/></code> a <code><entriesHeader/></code>. První z elementů tiskne obsah tabulky, druhý pak záhlaví tabulky. Toto rozdělení bylo zvoleno pro lepší možnosti formátování účtenky. (např. použitím oddělovače mezi tabulkou a jejím záhlavím)

{{Sample|Příklad:}}
<code xml>
<entriesHeader/>
<entries/>
</code>
Má za následek tento výstup:
<pre>
Kč
ZUBR Gold <11 20x0,5 1081,74 C
100 x 10,82
ZUBR Premium <12 20x0, 984,46 C
80 x 12,31
Lahev 0,5l 540,00 D
180 x 3,00
DOMICIL UNIV prázdný 0 900,00 D
9 x 100,00
</pre>

První řádek obsahuje název položky, celkovou cenu a písmeno určující sazbu DPH. Druhý řádek pak obsahuje počet a jednotkovou cenu.

Element <code><entries/></code> může voletelně obsahovat atribut <code>vat</code>, jehož výchozí hodnota je <code>true</code>, v tomto režimu jsou tisknuty ceny včetně DPH, pro tisk cen bez DPH je nutné nastavit hodnotu <code>false</code>.

==== Suma ====

Element <code><entriesTotal label="popisek"/></code> je ekvivalentem eet hodnoty <code>celk_trzba</code> pro situace, kdy neprovádíme EET, nebo dochází k částečné úhradě dokladu (pak se tyto dvě hodnoty liší).

=== Přehled DPH ===
Tabulku se souhrnem všech na záznamu použitých sazeb DPH, která zároveň slouží jako legenda k tabulce položek (písmena na konci řádků) vytiskneme pomocí elementů <code><vatRates/></code> a <code><vatRatesHeader/></code>. Stejně tedy jako v případě položek je záhlaví odděleno od obsahu do vlastního elementu.

{{Sample|Příklad:}}
<code xml>
<vatRatesHeader/>
<vatRates/>
</code>
Má za následek tento výstup:
<pre>
% Základ Daň Celkem
C 21 1707,60 358,60 2066,20
D 0 1440,00 0,00 1440,00
</pre>

První sloupec obsahuje písmeno reprezentující sazbu v tabulce položek, dále následuje procentuelní sazba, cena základ, samotná daň a celkový součet. Pokud je tisknutelná oblast účtenky příliš úzká, nebo pokud pracujeme s velkými částkami, dojde k vynechání sloupce Daň nebo Základ.

Tabulka přehledu DPH může mít dva různé datové zdroje. Zdroj dat je možné nastavit pomocí atributu <code>source</code>, ten může nabývat těchto hodnot:
* '''auto''' (výchozí) – pokud jsou k dispozici EET data, jsou použity hodnoty z EET tržby, v opačném případě jsou hodnoty vypočteny z položek,
* '''eet''' – jsou použity hodnoty z EET tržby,
* '''entries''' – hodnoty jsou vypočteny z položek.

Atribut musí být nastaven na obou elementech (tedy i na záhlaví).

Rozdílný zdroj je důležitý například, pokud chceme na účtence zobrazit detaily částečné úhrady.

{{Sample|Příklad dynamické účtenky s podporou pro částečnou úhradu:}}
<code xml>
<entriesHeader/>
<entries/>
<line/>
<vatRatesHeader source="entries"/>
<vatRates source="entries"/>
<line/>
<right>
<if flag="partial_payment">
<entriesTotal label="Celkem: "/>
</if>
<ifNot flag="partial_payment">
<high>
<eet value="celk_trzba" label="Celkem: "/>
</high>
</ifNot>
</right>
<line/>
<if flag="partial_payment">
<text>Platba:</text>
 
<line/>
<vatRatesHeader source="eet"/>
<vatRates source="eet"/>
<line/>
<right>
<high>
<eet value="celk_trzba" label="Zaplaceno: "/>
</high>
</right>
<line/>
</if>
</code>

== Hlavička ==
Pokud je nutné odlišit účtenky nad rámec EET hodnot (například rozdílné logo, či údaje společnosti), je možné použít hlavičkovou šablonu v UDA atributu „Hlavička účtenky Mobile“. Atribut má stejnou syntaxi zápisu jako běžné šablony účtenky.

Pro vložení do šablony hlavičky slouží element <code><header/></code>.

Šablony účtenek

2022-01-10T15:08:43Z

Wikiadm: /* EET */

Záznamy třídy Šablona účtenky (1400171) slouží pro definici vzhledu a obsahu účtenky tisknuté terminály.

Atribut název je na zařízení zobrazen v menu (pokud je k dispozici více tiskových šablon).

Atribut EET režim nastavuje, zda má být před tiskem prováděna evidence do EET, popř. zda má o tomto rozhodovat uživatel (hodnota Dotaz).

Šablona XML pak obsahuje XML definici formátu účtenky, který je dále popsán.

{{Sample|Příklad jednoduché účtenky:}}
<code xml>
<?xml version="1.0" encoding="utf-8"?>
<template>
<center>
<text>Společnost a.s.</text>
 
</center>
<line/>
<entriesHeader/>
<entries/>
<line/>
<vatRatesHeader/>
<vatRates/>
<line/>
<right>
<high>
<entriesTotal label="Celkem: "/>
</high>
</right>
<line/>
</template>
</code>

== Text ==
Statický text musí být vždy uzavřený v elementu <code><text></code>. Volný text není podporován.

{{Sample|Příklad:}}
<code xml>
<text>Text</text>
</code>
Pokud je text delší než zbývající místo na aktuálním řádku účtenky, automaticky dochází k přetečení na další řádek, není ale brán ohled na jednotlivá slova.

Vynucené odřádkování je možné provést elementem <code> </code>.

{{Sample|Příklad:}}
<code xml>
<text>První</text>
 
<text>Druhý</text>
</code>

=== Zarovnání ===
Zarovnání textu a obrázků na účtence je možné ovlivnit jedním z následujících elementů.
<code xml>
<left>
<text>Levé</text>
</left>
<center>
<text>Střed</text>
</center>
<right>
<text>Pravé</text>
</right>
</code>
Pokud se tiskárna aktuálně nenachází na novém prázdném řádku, dojde k ukončení aktuálního řádku.

=== Styl textu ===
==== Tučný ====
Pro použití tučného řezu písma stačí vložit příslušný obsah do elementu <code></code>.

{{Sample|Příklad:}}
<code xml>

<text>Tučný text</text>

</code>

==== Podtržený ====
K dispozici jsou dva elementy pro podtržený text. Klasické podtržení pomocí <code></code> a výraznější <code><u2></code> pro podtržení s dvounásobnou tloušťkou čáry.

{{Sample|Příklad:}}
<code xml>

<text>Podtržený text</text>

<u2>
<text>Dvojitě podtržený text</text>
</u2>
</code>

==== Inverzní ====
Pro tisk v inverzním režimu (černé pozadí, bílý text) stačí použít element <code><invert></code>.

{{Sample|Příklad:}}
<code xml>
<invert>
<text>Inverzní text</text>
</invert>
</code>

=== Řádkování ===
Velikost vertikálních mezer mezi jednotlivými řádky je možné ovlivnit jejich uzavřením v elementu <code><spacing value="##"></code>, kde hodnota atributu <code>value</code> udává nový rozestup mezi řádky. Hodnota je vyjádřena v bodech, kdy jeden bod obvykle odpovídá 0,125 mm. Výchozí hodnota je 30 bodů (3,75 mm).

{{Sample|Příklad:}}
<spacing value="50">
<text>První</text> 
<text>Druhý</text> 
<text>Třetí</text> 
</spacing>

=== Velikost ===
Velikost znaků textu (a veškerého tištěného obsahu) na účtence je možné zdvojnásobit v obou směrech.

Pro široký tisk (dvounásobná šířka) slouží element <code><wide></code>.

{{Sample|Příklad:}}
<code xml>
<wide>
<text>Široký text</text>
</wide>
</code>

Pro vysoký tisk (dvounásobná výška) slouží element <code><high></code>.

{{Sample|Příklad:}}
<code xml>
<high>
<text>Vysoký text</text>
</high>
</code>

Pro velký tisk (dvounásobná výška i šířka) slouží element <code><big></code>.

{{Sample|Příklad:}}
<code xml>
<big>
<text>Velký text</text>
</big>
</code>

Pokud potřebujeme dočasně v některém z předešlých bloků použít standardní velikost, použijeme element <code><normal></code>.

{{Sample|Příklad:}}
<code xml>
<big>
<text>Velký text</text>
<normal>
<text>Malý text</text>
</normal>
<text>Velký text 2</text>
</big>
</code>

== Oddělovací prvky ==
Tyto prvky jsou ideální pro vizuální oddělení jednotlivých sekcí účtenky.

=== Čáry ===
V základu jsou k dispozici tři druhy čar. Obyčejná (<code><line/></code>), tlustá (<code><thickLine/></code>) a dvojitá (<code><doubleLine/></code>).

{{Sample|Příklad:}}
<code xml>
<text>První sekce</text>
<line/>
<text>Druhá sekce</text>
<thickLine/>
<text>Třetí sekce</text>
<doubleLine/>
<text>Poslední sekce</text>
</code>

Všechny tyto čáry je možné vytisknout v čárkovaném provedení pomocí atributu <code>dashed</code>. Tento atribut podporuje základní <code>true/false</code> hodnoty, je možné použít i pokročilý režim zápisu, kdy sekvencí kladných a záporných čísel oddělených dvojtečkou můžeme zadefinovat poměr vzoru čáry (kladné číslo) a mezery (záporné číslo).

{{Sample|Příklad:}}
<code xml>
<text>První sekce</text>
<line dashed="19:-7"/>
<text>Druhá sekce</text>
</code>

Hodnota <code>19:-7</code> použitá v příkladu říká, že na 19 bodech šířky bude vytištěn vzor zvolené čáry (v tomto případě základní čára) a poté bude na 7 bodů přerušena mezerou. Čísel může být v zápisu libovolné množství, například <code>19:-7:3:-7</code> bude mít za následek čerchovanou čáru.

==== Vlastní čáry ====

Základní oddělovací čára (<code><line/></code>), může být parametrizována vlastním vzorem.

{{Sample|Příklad:}}
<code xml>
<text>První sekce</text>
<line pattern="3C3C"/>
<text>Druhá sekce</text>
</code>

Hodnota atributu je hexadecimálním zápisem vzoru čáry, číslo musí být zarovnané vždy na násobek 8 bitů.
Pokud převedeme číslo za našeho příkladu do binárního zápisu, získáme vertikální vzor čáry, který tiskárna horizontálně opakuje.

<code text>
3C3C = 0011110000111100
</code>

Dva horní body budou bílé, pod nimi čtyři body černé, následně čtyři body bílé a tak dále. Vytištěním příkladu bychom dostali dvounásobnou tlustou čáru. Pro tvorbu vlastních čar je vhodné použít [http://www.binaryhexconverter.com/binary-to-hex-converter převodník z binárního zápisu do hexadecimálního].

=== Znakový oddělovač ===
Element <code><separator text="="/></code> slouží k vyplnění celé řádky opakováním řetězce z atributu <code>text</code>. Atribut může obsahovat libovolně dlouhý řetězec. Výchozí hodnota atributu je <code>—</code>.

{{Sample|Příklad:}}
<code xml>
<text>První sekce</text>
<separator/>
<text>Druhá sekce</text>
</code>

== Obrázky ==
Pomocí elementu <code><img></code> je možné na účtenku vytisknout libovolný obrázek, například logo společnosti.

{{Sample|Příklad:}}
<code xml>
<img bw="true">
data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAWIAAABcCAAAAABxMODPAAAACXBIWXMAAAsTA
AALEwEAmpwYAAADGGlDQ1BQaG90b3Nob3AgSUNDIHByb2ZpbGUAAHjaY2BgnuDo4uTKJMDAUFBUUuQYgexI
…
…
…
goAAAANSUhwexg9iRg7iSdZ6jksHjaY2NDIHB2ZpbGUAAgtoCuj/wYA6GdORYwNqUoAAAAASUVORK5CYII=
</img>
</code>

Data obrázku jsou obsažena uvnitř elementu. Jedná se data kódovaná v Base64 a jsou podporovány standardní formáty obrázků (PNG, JPEG, GIF, BMP). Způsob zápisu je obdobný jako například v případě CSS (data uri). Pro převod souboru obrázku na Base64 řetězec je nutné použít příslušný [http://www.base64-image.de/ konvertor].

Volitelný atribut <code>bw</code> nastavuje způsob převodu obrázku do tiskových dat. Pokud je nastaven na <code>true</code> je každý nebílý (není brán ohled na průhlednost) bod vytisknut jako černý, v opačném případě se snaží aplikace převést barvy do černobílé podoby pomocí ditheringu.

== Podmíněný blok ==
Pro vytvoření účtenky, jejíž obsah se dynamicky mění na základě aktuálních okolností tisku, je užitečný podmíněný blok uzavřený do elementu <code><if key="identifikátor podmínky"></code> nebo v negované alternativě <code><ifNot key="identifikátor podmínky"></code>.

Atribut <code>key</code> obsahuje identifikátor podmínky, aktuálně podporované podmínky jsou:
* '''eet''' – pro účtenku byla zaevidována tržba (bez ohledu na její odeslání),
* '''eet_online''' – tržba byla úspěšně odeslána na server Finanční správy (máme k dispozici FIK),
* '''partial_payment''' – součet ceny položek je menší je větší než celková částka EET (zákazník zaplatil pouze část),
* '''dic_poverujiciho''' – na tržbě bylo vyplněno DIČ pověřujícího poplatníka.

{{Sample|Příklad (EET patička účtenky - kde chybějící FIK nemá za následek prázdný řádek):}}
<code xml>
<if flag="eet_online">
<eet value="fik" label="FIK: "/>
 
</if>
<eet value="bkp" label="BKP: "/>
 
<ifNot flag="eet_online">
<eet value="pkp"label="PKP: "/>
 
</ifNot>
<eet value="rezim" label="Režim tržby: "/>
</code>

== Hodnoty ==
Kromě statického textu je možné na účtence používat i dynamické hodnoty z tisknutého záznamu.

=== EET ===
Data týkající se příslušné EET tržby je možné získat pomocí elementu <code><eet value="identifikátor hodnoty" label="popisek"/></code>.

Atribut <code>value</code> je identifikátor hodnoty a může nabývat těchto hodnot:
* '''dat_trzby''' – datum tržby v plném formátu (DD.MM.YYYY hh:mm:ss),
* '''dat_trzby2''' – datum tržby ve formátu se zkráceným rokem (DD.MM.YY hh:mm:ss),
* '''porad_cis''' – pořadové číslo účtenky,
* '''id_provoz''' – označení provozovny,
* '''id_pokl''' – označení pokladního zařízení,
* '''dic_popl''' – DIČ poplatníka,
* '''dic_poverujiciho''' – DIČ pověřujícího poplatníka,
* '''rezim''' – režim evidované tržby (nabývá hodnot "Běžný" nebo "Zjednodušený"),
* '''celk_trzba''' – celková částka tržby,
* '''pkp''' – podpisový kód poplatníka
* '''bkp''' – bezpečnostní kód poplatníka,
* '''fik''' – fiskální identifikační kód.

Atribut <code>label</code> může voltelně obsahovat popisek, který bude vytištěn před hodnotu.

Pokud hodnota není k dispozici (je prázdná), je tisk hodnoty vynechán, a to včetně popisku. K dispozici nemusí být například fiskální identifikační kód, pokud se nepodařilo odeslat tržbu na servery Finanční správy.

{{Sample|Příklad:}}
<code xml>
<eet value="dic_popl" label="DIČ: "/> 
<eet value="id_provoz" label="Provozovna: "/> 
<eet value="id_pokl" label="Pokladna: "/> 
<eet value="porad_cis" label="Číslo dokladu: "/> 
<eet value="dat_trzby_2" label="Datum tržby: "/> 
</code>

=== Položky ===
Pro tisk tabluky s přehledem položek tisknutého záznamu slouží elementy <code><entries/></code> a <code><entriesHeader/></code>. První z elementů tiskne obsah tabulky, druhý pak záhlaví tabulky. Toto rozdělení bylo zvoleno pro lepší možnosti formátování účtenky. (např. použitím oddělovače mezi tabulkou a jejím záhlavím)

{{Sample|Příklad:}}
<code xml>
<entriesHeader/>
<entries/>
</code>
Má za následek tento výstup:
<pre>
Kč
ZUBR Gold <11 20x0,5 1081,74 C
100 x 10,82
ZUBR Premium <12 20x0, 984,46 C
80 x 12,31
Lahev 0,5l 540,00 D
180 x 3,00
DOMICIL UNIV prázdný 0 900,00 D
9 x 100,00
</pre>

První řádek obsahuje název položky, celkovou cenu a písmeno určující sazbu DPH. Druhý řádek pak obsahuje počet a jednotkovou cenu.

Element <code><entries/></code> může voletelně obsahovat atribut <code>vat</code>, jehož výchozí hodnota je <code>true</code>, v tomto režimu jsou tisknuty ceny včetně DPH, pro tisk cen bez DPH je nutné nastavit hodnotu <code>false</code>.

==== Suma ====

Element <code><entriesTotal label="popisek"/></code> je ekvivalentem eet hodnoty <code>celk_trzba</code> pro situace, kdy neprovádíme EET, nebo dochází k částečné úhradě dokladu (pak se tyto dvě hodnoty liší).

=== Přehled DPH ===
Tabulku se souhrnem všech na záznamu použitých sazeb DPH, která zároveň slouží jako legenda k tabulce položek (písmena na konci řádků) vytiskneme pomocí elementů <code><vatRates/></code> a <code><vatRatesHeader/></code>. Stejně tedy jako v případě položek je záhlaví odděleno od obsahu do vlastního elementu.

{{Sample|Příklad:}}
<code xml>
<vatRatesHeader/>
<vatRates/>
</code>
Má za následek tento výstup:
<pre>
% Základ Daň Celkem
C 21 1707,60 358,60 2066,20
D 0 1440,00 0,00 1440,00
</pre>

První sloupec obsahuje písmeno reprezentující sazbu v tabulce položek, dále následuje procentuelní sazba, cena základ, samotná daň a celkový součet. Pokud je tisknutelná oblast účtenky příliš úzká, nebo pokud pracujeme s velkými částkami, dojde k vynechání sloupce Daň nebo Základ.

Tabulka přehledu DPH může mít dva různé datové zdroje. Zdroj dat je možné nastavit pomocí atributu <code>source</code>, ten může nabývat těchto hodnot:
* '''auto''' (výchozí) – pokud jsou k dispozici EET data, jsou použity hodnoty z EET tržby, v opačném případě jsou hodnoty vypočteny z položek,
* '''eet''' – jsou použity hodnoty z EET tržby,
* '''entries''' – hodnoty jsou vypočteny z položek.

Atribut musí být nastaven na obou elementech (tedy i na záhlaví).

Rozdílný zdroj je důležitý například, pokud chceme na účtence zobrazit detaily částečné úhrady.

{{Sample|Příklad dynamické účtenky s podporou pro částečnou úhradu:}}
<code xml>
<entriesHeader/>
<entries/>
<line/>
<vatRatesHeader source="entries"/>
<vatRates source="entries"/>
<line/>
<right>
<if flag="partial_payment">
<entriesTotal label="Celkem: "/>
</if>
<ifNot flag="partial_payment">
<high>
<eet value="celk_trzba" label="Celkem: "/>
</high>
</ifNot>
</right>
<line/>
<if flag="partial_payment">
<text>Platba:</text>
 
<line/>
<vatRatesHeader source="eet"/>
<vatRates source="eet"/>
<line/>
<right>
<high>
<eet value="celk_trzba" label="Zaplaceno: "/>
</high>
</right>
<line/>
</if>
</code>

== Hlavička ==
Pokud je nutné odlišit účtenky nad rámec EET hodnot (například rozdílné logo, či údaje společnosti), je možné použít hlavičkovou šablonu v UDA atributu „Hlavička účtenky Mobile“. Atribut má stejnou syntaxi zápisu jako běžné šablony účtenky.

Pro vložení do šablony hlavičky slouží element <code><header/></code>.

Šablony účtenek

2022-01-10T15:06:47Z

Wikiadm: /* Vlastní čáry */

Záznamy třídy Šablona účtenky (1400171) slouží pro definici vzhledu a obsahu účtenky tisknuté terminály.

Atribut název je na zařízení zobrazen v menu (pokud je k dispozici více tiskových šablon).

Atribut EET režim nastavuje, zda má být před tiskem prováděna evidence do EET, popř. zda má o tomto rozhodovat uživatel (hodnota Dotaz).

Šablona XML pak obsahuje XML definici formátu účtenky, který je dále popsán.

{{Sample|Příklad jednoduché účtenky:}}
<code xml>
<?xml version="1.0" encoding="utf-8"?>
<template>
<center>
<text>Společnost a.s.</text>
 
</center>
<line/>
<entriesHeader/>
<entries/>
<line/>
<vatRatesHeader/>
<vatRates/>
<line/>
<right>
<high>
<entriesTotal label="Celkem: "/>
</high>
</right>
<line/>
</template>
</code>

== Text ==
Statický text musí být vždy uzavřený v elementu <code><text></code>. Volný text není podporován.

{{Sample|Příklad:}}
<code xml>
<text>Text</text>
</code>
Pokud je text delší než zbývající místo na aktuálním řádku účtenky, automaticky dochází k přetečení na další řádek, není ale brán ohled na jednotlivá slova.

Vynucené odřádkování je možné provést elementem <code> </code>.

{{Sample|Příklad:}}
<code xml>
<text>První</text>
 
<text>Druhý</text>
</code>

=== Zarovnání ===
Zarovnání textu a obrázků na účtence je možné ovlivnit jedním z následujících elementů.
<code xml>
<left>
<text>Levé</text>
</left>
<center>
<text>Střed</text>
</center>
<right>
<text>Pravé</text>
</right>
</code>
Pokud se tiskárna aktuálně nenachází na novém prázdném řádku, dojde k ukončení aktuálního řádku.

=== Styl textu ===
==== Tučný ====
Pro použití tučného řezu písma stačí vložit příslušný obsah do elementu <code></code>.

{{Sample|Příklad:}}
<code xml>

<text>Tučný text</text>

</code>

==== Podtržený ====
K dispozici jsou dva elementy pro podtržený text. Klasické podtržení pomocí <code></code> a výraznější <code><u2></code> pro podtržení s dvounásobnou tloušťkou čáry.

{{Sample|Příklad:}}
<code xml>

<text>Podtržený text</text>

<u2>
<text>Dvojitě podtržený text</text>
</u2>
</code>

==== Inverzní ====
Pro tisk v inverzním režimu (černé pozadí, bílý text) stačí použít element <code><invert></code>.

{{Sample|Příklad:}}
<code xml>
<invert>
<text>Inverzní text</text>
</invert>
</code>

=== Řádkování ===
Velikost vertikálních mezer mezi jednotlivými řádky je možné ovlivnit jejich uzavřením v elementu <code><spacing value="##"></code>, kde hodnota atributu <code>value</code> udává nový rozestup mezi řádky. Hodnota je vyjádřena v bodech, kdy jeden bod obvykle odpovídá 0,125 mm. Výchozí hodnota je 30 bodů (3,75 mm).

{{Sample|Příklad:}}
<spacing value="50">
<text>První</text> 
<text>Druhý</text> 
<text>Třetí</text> 
</spacing>

=== Velikost ===
Velikost znaků textu (a veškerého tištěného obsahu) na účtence je možné zdvojnásobit v obou směrech.

Pro široký tisk (dvounásobná šířka) slouží element <code><wide></code>.

{{Sample|Příklad:}}
<code xml>
<wide>
<text>Široký text</text>
</wide>
</code>

Pro vysoký tisk (dvounásobná výška) slouží element <code><high></code>.

{{Sample|Příklad:}}
<code xml>
<high>
<text>Vysoký text</text>
</high>
</code>

Pro velký tisk (dvounásobná výška i šířka) slouží element <code><big></code>.

{{Sample|Příklad:}}
<code xml>
<big>
<text>Velký text</text>
</big>
</code>

Pokud potřebujeme dočasně v některém z předešlých bloků použít standardní velikost, použijeme element <code><normal></code>.

{{Sample|Příklad:}}
<code xml>
<big>
<text>Velký text</text>
<normal>
<text>Malý text</text>
</normal>
<text>Velký text 2</text>
</big>
</code>

== Oddělovací prvky ==
Tyto prvky jsou ideální pro vizuální oddělení jednotlivých sekcí účtenky.

=== Čáry ===
V základu jsou k dispozici tři druhy čar. Obyčejná (<code><line/></code>), tlustá (<code><thickLine/></code>) a dvojitá (<code><doubleLine/></code>).

{{Sample|Příklad:}}
<code xml>
<text>První sekce</text>
<line/>
<text>Druhá sekce</text>
<thickLine/>
<text>Třetí sekce</text>
<doubleLine/>
<text>Poslední sekce</text>
</code>

Všechny tyto čáry je možné vytisknout v čárkovaném provedení pomocí atributu <code>dashed</code>. Tento atribut podporuje základní <code>true/false</code> hodnoty, je možné použít i pokročilý režim zápisu, kdy sekvencí kladných a záporných čísel oddělených dvojtečkou můžeme zadefinovat poměr vzoru čáry (kladné číslo) a mezery (záporné číslo).

{{Sample|Příklad:}}
<code xml>
<text>První sekce</text>
<line dashed="19:-7"/>
<text>Druhá sekce</text>
</code>

Hodnota <code>19:-7</code> použitá v příkladu říká, že na 19 bodech šířky bude vytištěn vzor zvolené čáry (v tomto případě základní čára) a poté bude na 7 bodů přerušena mezerou. Čísel může být v zápisu libovolné množství, například <code>19:-7:3:-7</code> bude mít za následek čerchovanou čáru.

==== Vlastní čáry ====

Základní oddělovací čára (<code><line/></code>), může být parametrizována vlastním vzorem.

{{Sample|Příklad:}}
<code xml>
<text>První sekce</text>
<line pattern="3C3C"/>
<text>Druhá sekce</text>
</code>

Hodnota atributu je hexadecimálním zápisem vzoru čáry, číslo musí být zarovnané vždy na násobek 8 bitů.
Pokud převedeme číslo za našeho příkladu do binárního zápisu, získáme vertikální vzor čáry, který tiskárna horizontálně opakuje.

<code text>
3C3C = 0011110000111100
</code>

Dva horní body budou bílé, pod nimi čtyři body černé, následně čtyři body bílé a tak dále. Vytištěním příkladu bychom dostali dvounásobnou tlustou čáru. Pro tvorbu vlastních čar je vhodné použít [http://www.binaryhexconverter.com/binary-to-hex-converter převodník z binárního zápisu do hexadecimálního].

=== Znakový oddělovač ===
Element <code><separator text="="/></code> slouží k vyplnění celé řádky opakováním řetězce z atributu <code>text</code>. Atribut může obsahovat libovolně dlouhý řetězec. Výchozí hodnota atributu je <code>—</code>.

{{Sample|Příklad:}}
<code xml>
<text>První sekce</text>
<separator/>
<text>Druhá sekce</text>
</code>

== Obrázky ==
Pomocí elementu <code><img></code> je možné na účtenku vytisknout libovolný obrázek, například logo společnosti.

{{Sample|Příklad:}}
<code xml>
<img bw="true">
data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAWIAAABcCAAAAABxMODPAAAACXBIWXMAAAsTA
AALEwEAmpwYAAADGGlDQ1BQaG90b3Nob3AgSUNDIHByb2ZpbGUAAHjaY2BgnuDo4uTKJMDAUFBUUuQYgexI
…
…
…
goAAAANSUhwexg9iRg7iSdZ6jksHjaY2NDIHB2ZpbGUAAgtoCuj/wYA6GdORYwNqUoAAAAASUVORK5CYII=
</img>
</code>

Data obrázku jsou obsažena uvnitř elementu. Jedná se data kódovaná v Base64 a jsou podporovány standardní formáty obrázků (PNG, JPEG, GIF, BMP). Způsob zápisu je obdobný jako například v případě CSS (data uri). Pro převod souboru obrázku na Base64 řetězec je nutné použít příslušný [http://www.base64-image.de/ konvertor].

Volitelný atribut <code>bw</code> nastavuje způsob převodu obrázku do tiskových dat. Pokud je nastaven na <code>true</code> je každý nebílý (není brán ohled na průhlednost) bod vytisknut jako černý, v opačném případě se snaží aplikace převést barvy do černobílé podoby pomocí ditheringu.

== Podmíněný blok ==
Pro vytvoření účtenky, jejíž obsah se dynamicky mění na základě aktuálních okolností tisku, je užitečný podmíněný blok uzavřený do elementu <code><if key="identifikátor podmínky"></code> nebo v negované alternativě <code><ifNot key="identifikátor podmínky"></code>.

Atribut <code>key</code> obsahuje identifikátor podmínky, aktuálně podporované podmínky jsou:
* '''eet''' – pro účtenku byla zaevidována tržba (bez ohledu na její odeslání),
* '''eet_online''' – tržba byla úspěšně odeslána na server Finanční správy (máme k dispozici FIK),
* '''partial_payment''' – součet ceny položek je menší je větší než celková částka EET (zákazník zaplatil pouze část),
* '''dic_poverujiciho''' – na tržbě bylo vyplněno DIČ pověřujícího poplatníka.

{{Sample|Příklad (EET patička účtenky - kde chybějící FIK nemá za následek prázdný řádek):}}
<code xml>
<if flag="eet_online">
<eet value="fik" label="FIK: "/>
 
</if>
<eet value="bkp" label="BKP: "/>
 
<ifNot flag="eet_online">
<eet value="pkp"label="PKP: "/>
 
</ifNot>
<eet value="rezim" label="Režim tržby: "/>
</code>

== Hodnoty ==
Kromě statického textu je možné na účtence používat i dynamické hodnoty z tisknutého záznamu.

=== EET ===
Data týkající se příslušné EET tržby je možné získat pomocí elementu <code><eet value="identifikátor hodnoty" label="popisek"/></code>.

Atribut <code>value</code> je identifikátor hodnoty a může nabývat těchto hodnot:
* '''dat_trzby''' – datum tržby v plném formátu (DD.MM.YYYY hh:mm:ss),
* '''dat_trzby2''' – datum tržby ve formátu se zkráceným rokem (DD.MM.YY hh:mm:ss),
* '''porad_cis''' – pořadové číslo účtenky,
* '''id_provoz''' – označení provozovny,
* '''id_pokl''' – označení pokladního zařízení,
* '''dic_popl''' – DIČ poplatníka,
* '''dic_poverujiciho''' – DIČ pověřujícího poplatníka,
* '''rezim''' – režim evidované tržby (nabývá hodnot "Běžný" nebo "Zjednodušený"),
* '''celk_trzba''' – celková částka tržby,
* '''pkp''' – podpisový kód poplatníka
* '''bkp''' – bezpečnostní kód poplatníka,
* '''fik''' – fiskální identifikační kód.

Atribut <code>label</code> může voltelně obsahovat popisek, který bude vytištěn před hodnotu.

Pokud hodnota není k dispozici (je prázdná), je tisk hodnoty vynechán a to včetně popisku. K dispozici nemusí být například fiskální identifikační kód, pokud se nepodařilo odeslat tržbu na servery Finanční správy.

{{Sample|Příklad:}}
<code xml>
<eet value="dic_popl" label="DIČ: "/> 
<eet value="id_provoz" label="Provozovna: "/> 
<eet value="id_pokl" label="Pokladna: "/> 
<eet value="porad_cis" label="Číslo dokladu: "/> 
<eet value="dat_trzby_2" label="Datum tržby: "/> 
</code>

=== Položky ===
Pro tisk tabluky s přehledem položek tisknutého záznamu slouží elementy <code><entries/></code> a <code><entriesHeader/></code>. První z elementů tiskne obsah tabulky, druhý pak záhlaví tabulky. Toto rozdělení bylo zvoleno pro lepší možnosti formátování účtenky. (např. použitím oddělovače mezi tabulkou a jejím záhlavím)

{{Sample|Příklad:}}
<code xml>
<entriesHeader/>
<entries/>
</code>
Má za následek tento výstup:
<pre>
Kč
ZUBR Gold <11 20x0,5 1081,74 C
100 x 10,82
ZUBR Premium <12 20x0, 984,46 C
80 x 12,31
Lahev 0,5l 540,00 D
180 x 3,00
DOMICIL UNIV prázdný 0 900,00 D
9 x 100,00
</pre>

První řádek obsahuje název položky, celkovou cenu a písmeno určující sazbu DPH. Druhý řádek pak obsahuje počet a jednotkovou cenu.

Element <code><entries/></code> může voletelně obsahovat atribut <code>vat</code>, jehož výchozí hodnota je <code>true</code>, v tomto režimu jsou tisknuty ceny včetně DPH, pro tisk cen bez DPH je nutné nastavit hodnotu <code>false</code>.

==== Suma ====

Element <code><entriesTotal label="popisek"/></code> je ekvivalentem eet hodnoty <code>celk_trzba</code> pro situace, kdy neprovádíme EET, nebo dochází k částečné úhradě dokladu (pak se tyto dvě hodnoty liší).

=== Přehled DPH ===
Tabulku se souhrnem všech na záznamu použitých sazeb DPH, která zároveň slouží jako legenda k tabulce položek (písmena na konci řádků) vytiskneme pomocí elementů <code><vatRates/></code> a <code><vatRatesHeader/></code>. Stejně tedy jako v případě položek je záhlaví odděleno od obsahu do vlastního elementu.

{{Sample|Příklad:}}
<code xml>
<vatRatesHeader/>
<vatRates/>
</code>
Má za následek tento výstup:
<pre>
% Základ Daň Celkem
C 21 1707,60 358,60 2066,20
D 0 1440,00 0,00 1440,00
</pre>

První sloupec obsahuje písmeno reprezentující sazbu v tabulce položek, dále následuje procentuelní sazba, cena základ, samotná daň a celkový součet. Pokud je tisknutelná oblast účtenky příliš úzká, nebo pokud pracujeme s velkými částkami, dojde k vynechání sloupce Daň nebo Základ.

Tabulka přehledu DPH může mít dva různé datové zdroje. Zdroj dat je možné nastavit pomocí atributu <code>source</code>, ten může nabývat těchto hodnot:
* '''auto''' (výchozí) – pokud jsou k dispozici EET data, jsou použity hodnoty z EET tržby, v opačném případě jsou hodnoty vypočteny z položek,
* '''eet''' – jsou použity hodnoty z EET tržby,
* '''entries''' – hodnoty jsou vypočteny z položek.

Atribut musí být nastaven na obou elementech (tedy i na záhlaví).

Rozdílný zdroj je důležitý například, pokud chceme na účtence zobrazit detaily částečné úhrady.

{{Sample|Příklad dynamické účtenky s podporou pro částečnou úhradu:}}
<code xml>
<entriesHeader/>
<entries/>
<line/>
<vatRatesHeader source="entries"/>
<vatRates source="entries"/>
<line/>
<right>
<if flag="partial_payment">
<entriesTotal label="Celkem: "/>
</if>
<ifNot flag="partial_payment">
<high>
<eet value="celk_trzba" label="Celkem: "/>
</high>
</ifNot>
</right>
<line/>
<if flag="partial_payment">
<text>Platba:</text>
 
<line/>
<vatRatesHeader source="eet"/>
<vatRates source="eet"/>
<line/>
<right>
<high>
<eet value="celk_trzba" label="Zaplaceno: "/>
</high>
</right>
<line/>
</if>
</code>

== Hlavička ==
Pokud je nutné odlišit účtenky nad rámec EET hodnot (například rozdílné logo, či údaje společnosti), je možné použít hlavičkovou šablonu v UDA atributu „Hlavička účtenky Mobile“. Atribut má stejnou syntaxi zápisu jako běžné šablony účtenky.

Pro vložení do šablony hlavičky slouží element <code><header/></code>.

Šablony účtenek

2022-01-10T15:05:41Z

Wikiadm: /* Čáry */

Záznamy třídy Šablona účtenky (1400171) slouží pro definici vzhledu a obsahu účtenky tisknuté terminály.

Atribut název je na zařízení zobrazen v menu (pokud je k dispozici více tiskových šablon).

Atribut EET režim nastavuje, zda má být před tiskem prováděna evidence do EET, popř. zda má o tomto rozhodovat uživatel (hodnota Dotaz).

Šablona XML pak obsahuje XML definici formátu účtenky, který je dále popsán.

{{Sample|Příklad jednoduché účtenky:}}
<code xml>
<?xml version="1.0" encoding="utf-8"?>
<template>
<center>
<text>Společnost a.s.</text>
 
</center>
<line/>
<entriesHeader/>
<entries/>
<line/>
<vatRatesHeader/>
<vatRates/>
<line/>
<right>
<high>
<entriesTotal label="Celkem: "/>
</high>
</right>
<line/>
</template>
</code>

== Text ==
Statický text musí být vždy uzavřený v elementu <code><text></code>. Volný text není podporován.

{{Sample|Příklad:}}
<code xml>
<text>Text</text>
</code>
Pokud je text delší než zbývající místo na aktuálním řádku účtenky, automaticky dochází k přetečení na další řádek, není ale brán ohled na jednotlivá slova.

Vynucené odřádkování je možné provést elementem <code> </code>.

{{Sample|Příklad:}}
<code xml>
<text>První</text>
 
<text>Druhý</text>
</code>

=== Zarovnání ===
Zarovnání textu a obrázků na účtence je možné ovlivnit jedním z následujících elementů.
<code xml>
<left>
<text>Levé</text>
</left>
<center>
<text>Střed</text>
</center>
<right>
<text>Pravé</text>
</right>
</code>
Pokud se tiskárna aktuálně nenachází na novém prázdném řádku, dojde k ukončení aktuálního řádku.

=== Styl textu ===
==== Tučný ====
Pro použití tučného řezu písma stačí vložit příslušný obsah do elementu <code></code>.

{{Sample|Příklad:}}
<code xml>

<text>Tučný text</text>

</code>

==== Podtržený ====
K dispozici jsou dva elementy pro podtržený text. Klasické podtržení pomocí <code></code> a výraznější <code><u2></code> pro podtržení s dvounásobnou tloušťkou čáry.

{{Sample|Příklad:}}
<code xml>

<text>Podtržený text</text>

<u2>
<text>Dvojitě podtržený text</text>
</u2>
</code>

==== Inverzní ====
Pro tisk v inverzním režimu (černé pozadí, bílý text) stačí použít element <code><invert></code>.

{{Sample|Příklad:}}
<code xml>
<invert>
<text>Inverzní text</text>
</invert>
</code>

=== Řádkování ===
Velikost vertikálních mezer mezi jednotlivými řádky je možné ovlivnit jejich uzavřením v elementu <code><spacing value="##"></code>, kde hodnota atributu <code>value</code> udává nový rozestup mezi řádky. Hodnota je vyjádřena v bodech, kdy jeden bod obvykle odpovídá 0,125 mm. Výchozí hodnota je 30 bodů (3,75 mm).

{{Sample|Příklad:}}
<spacing value="50">
<text>První</text> 
<text>Druhý</text> 
<text>Třetí</text> 
</spacing>

=== Velikost ===
Velikost znaků textu (a veškerého tištěného obsahu) na účtence je možné zdvojnásobit v obou směrech.

Pro široký tisk (dvounásobná šířka) slouží element <code><wide></code>.

{{Sample|Příklad:}}
<code xml>
<wide>
<text>Široký text</text>
</wide>
</code>

Pro vysoký tisk (dvounásobná výška) slouží element <code><high></code>.

{{Sample|Příklad:}}
<code xml>
<high>
<text>Vysoký text</text>
</high>
</code>

Pro velký tisk (dvounásobná výška i šířka) slouží element <code><big></code>.

{{Sample|Příklad:}}
<code xml>
<big>
<text>Velký text</text>
</big>
</code>

Pokud potřebujeme dočasně v některém z předešlých bloků použít standardní velikost, použijeme element <code><normal></code>.

{{Sample|Příklad:}}
<code xml>
<big>
<text>Velký text</text>
<normal>
<text>Malý text</text>
</normal>
<text>Velký text 2</text>
</big>
</code>

== Oddělovací prvky ==
Tyto prvky jsou ideální pro vizuální oddělení jednotlivých sekcí účtenky.

=== Čáry ===
V základu jsou k dispozici tři druhy čar. Obyčejná (<code><line/></code>), tlustá (<code><thickLine/></code>) a dvojitá (<code><doubleLine/></code>).

{{Sample|Příklad:}}
<code xml>
<text>První sekce</text>
<line/>
<text>Druhá sekce</text>
<thickLine/>
<text>Třetí sekce</text>
<doubleLine/>
<text>Poslední sekce</text>
</code>

Všechny tyto čáry je možné vytisknout v čárkovaném provedení pomocí atributu <code>dashed</code>. Tento atribut podporuje základní <code>true/false</code> hodnoty, je možné použít i pokročilý režim zápisu, kdy sekvencí kladných a záporných čísel oddělených dvojtečkou můžeme zadefinovat poměr vzoru čáry (kladné číslo) a mezery (záporné číslo).

{{Sample|Příklad:}}
<code xml>
<text>První sekce</text>
<line dashed="19:-7"/>
<text>Druhá sekce</text>
</code>

Hodnota <code>19:-7</code> použitá v příkladu říká, že na 19 bodech šířky bude vytištěn vzor zvolené čáry (v tomto případě základní čára) a poté bude na 7 bodů přerušena mezerou. Čísel může být v zápisu libovolné množství, například <code>19:-7:3:-7</code> bude mít za následek čerchovanou čáru.

==== Vlastní čáry ====

Základní oddělovací čára (<code><line/></code>), může být parametrizována vlastním vzorem.

{{Sample|Příklad:}}
<code xml>
<text>První sekce</text>
<line pattern="3C3C"/>
<text>Druhá sekce</text>
</code>

Hodnota atributu je hexadecimálním zápisem vzoru čáry, číslo musí být zarovnané vždy na násobek 8 bitů.
Pokud převedeme číslo za našeho příkhladu do binárního zápisu, získáme vertikální vzor čáry, který tiskárna horizontálně opakuje.

<code text>
3C3C = 0011110000111100
</code>

Dva horní body budou bílé, pod nimi čtyři body černé, následně čtyři body bílé a tak dále. Vytištěním příkladu bychom dostali dvounásobnou tlustou čáru. Pro tvorbu vlastních čar je vhodné použít [http://www.binaryhexconverter.com/binary-to-hex-converter převodník z binárního zápisu do hexadecimálního].

=== Znakový oddělovač ===
Element <code><separator text="="/></code> slouží k vyplnění celé řádky opakováním řetězce z atributu <code>text</code>. Atribut může obsahovat libovolně dlouhý řetězec. Výchozí hodnota atributu je <code>—</code>.

{{Sample|Příklad:}}
<code xml>
<text>První sekce</text>
<separator/>
<text>Druhá sekce</text>
</code>

== Obrázky ==
Pomocí elementu <code><img></code> je možné na účtenku vytisknout libovolný obrázek, například logo společnosti.

{{Sample|Příklad:}}
<code xml>
<img bw="true">
data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAWIAAABcCAAAAABxMODPAAAACXBIWXMAAAsTA
AALEwEAmpwYAAADGGlDQ1BQaG90b3Nob3AgSUNDIHByb2ZpbGUAAHjaY2BgnuDo4uTKJMDAUFBUUuQYgexI
…
…
…
goAAAANSUhwexg9iRg7iSdZ6jksHjaY2NDIHB2ZpbGUAAgtoCuj/wYA6GdORYwNqUoAAAAASUVORK5CYII=
</img>
</code>

Data obrázku jsou obsažena uvnitř elementu. Jedná se data kódovaná v Base64 a jsou podporovány standardní formáty obrázků (PNG, JPEG, GIF, BMP). Způsob zápisu je obdobný jako například v případě CSS (data uri). Pro převod souboru obrázku na Base64 řetězec je nutné použít příslušný [http://www.base64-image.de/ konvertor].

Volitelný atribut <code>bw</code> nastavuje způsob převodu obrázku do tiskových dat. Pokud je nastaven na <code>true</code> je každý nebílý (není brán ohled na průhlednost) bod vytisknut jako černý, v opačném případě se snaží aplikace převést barvy do černobílé podoby pomocí ditheringu.

== Podmíněný blok ==
Pro vytvoření účtenky, jejíž obsah se dynamicky mění na základě aktuálních okolností tisku, je užitečný podmíněný blok uzavřený do elementu <code><if key="identifikátor podmínky"></code> nebo v negované alternativě <code><ifNot key="identifikátor podmínky"></code>.

Atribut <code>key</code> obsahuje identifikátor podmínky, aktuálně podporované podmínky jsou:
* '''eet''' – pro účtenku byla zaevidována tržba (bez ohledu na její odeslání),
* '''eet_online''' – tržba byla úspěšně odeslána na server Finanční správy (máme k dispozici FIK),
* '''partial_payment''' – součet ceny položek je menší je větší než celková částka EET (zákazník zaplatil pouze část),
* '''dic_poverujiciho''' – na tržbě bylo vyplněno DIČ pověřujícího poplatníka.

{{Sample|Příklad (EET patička účtenky - kde chybějící FIK nemá za následek prázdný řádek):}}
<code xml>
<if flag="eet_online">
<eet value="fik" label="FIK: "/>
 
</if>
<eet value="bkp" label="BKP: "/>
 
<ifNot flag="eet_online">
<eet value="pkp"label="PKP: "/>
 
</ifNot>
<eet value="rezim" label="Režim tržby: "/>
</code>

== Hodnoty ==
Kromě statického textu je možné na účtence používat i dynamické hodnoty z tisknutého záznamu.

=== EET ===
Data týkající se příslušné EET tržby je možné získat pomocí elementu <code><eet value="identifikátor hodnoty" label="popisek"/></code>.

Atribut <code>value</code> je identifikátor hodnoty a může nabývat těchto hodnot:
* '''dat_trzby''' – datum tržby v plném formátu (DD.MM.YYYY hh:mm:ss),
* '''dat_trzby2''' – datum tržby ve formátu se zkráceným rokem (DD.MM.YY hh:mm:ss),
* '''porad_cis''' – pořadové číslo účtenky,
* '''id_provoz''' – označení provozovny,
* '''id_pokl''' – označení pokladního zařízení,
* '''dic_popl''' – DIČ poplatníka,
* '''dic_poverujiciho''' – DIČ pověřujícího poplatníka,
* '''rezim''' – režim evidované tržby (nabývá hodnot "Běžný" nebo "Zjednodušený"),
* '''celk_trzba''' – celková částka tržby,
* '''pkp''' – podpisový kód poplatníka
* '''bkp''' – bezpečnostní kód poplatníka,
* '''fik''' – fiskální identifikační kód.

Atribut <code>label</code> může voltelně obsahovat popisek, který bude vytištěn před hodnotu.

Pokud hodnota není k dispozici (je prázdná), je tisk hodnoty vynechán a to včetně popisku. K dispozici nemusí být například fiskální identifikační kód, pokud se nepodařilo odeslat tržbu na servery Finanční správy.

{{Sample|Příklad:}}
<code xml>
<eet value="dic_popl" label="DIČ: "/> 
<eet value="id_provoz" label="Provozovna: "/> 
<eet value="id_pokl" label="Pokladna: "/> 
<eet value="porad_cis" label="Číslo dokladu: "/> 
<eet value="dat_trzby_2" label="Datum tržby: "/> 
</code>

=== Položky ===
Pro tisk tabluky s přehledem položek tisknutého záznamu slouží elementy <code><entries/></code> a <code><entriesHeader/></code>. První z elementů tiskne obsah tabulky, druhý pak záhlaví tabulky. Toto rozdělení bylo zvoleno pro lepší možnosti formátování účtenky. (např. použitím oddělovače mezi tabulkou a jejím záhlavím)

{{Sample|Příklad:}}
<code xml>
<entriesHeader/>
<entries/>
</code>
Má za následek tento výstup:
<pre>
Kč
ZUBR Gold <11 20x0,5 1081,74 C
100 x 10,82
ZUBR Premium <12 20x0, 984,46 C
80 x 12,31
Lahev 0,5l 540,00 D
180 x 3,00
DOMICIL UNIV prázdný 0 900,00 D
9 x 100,00
</pre>

První řádek obsahuje název položky, celkovou cenu a písmeno určující sazbu DPH. Druhý řádek pak obsahuje počet a jednotkovou cenu.

Element <code><entries/></code> může voletelně obsahovat atribut <code>vat</code>, jehož výchozí hodnota je <code>true</code>, v tomto režimu jsou tisknuty ceny včetně DPH, pro tisk cen bez DPH je nutné nastavit hodnotu <code>false</code>.

==== Suma ====

Element <code><entriesTotal label="popisek"/></code> je ekvivalentem eet hodnoty <code>celk_trzba</code> pro situace, kdy neprovádíme EET, nebo dochází k částečné úhradě dokladu (pak se tyto dvě hodnoty liší).

=== Přehled DPH ===
Tabulku se souhrnem všech na záznamu použitých sazeb DPH, která zároveň slouží jako legenda k tabulce položek (písmena na konci řádků) vytiskneme pomocí elementů <code><vatRates/></code> a <code><vatRatesHeader/></code>. Stejně tedy jako v případě položek je záhlaví odděleno od obsahu do vlastního elementu.

{{Sample|Příklad:}}
<code xml>
<vatRatesHeader/>
<vatRates/>
</code>
Má za následek tento výstup:
<pre>
% Základ Daň Celkem
C 21 1707,60 358,60 2066,20
D 0 1440,00 0,00 1440,00
</pre>

První sloupec obsahuje písmeno reprezentující sazbu v tabulce položek, dále následuje procentuelní sazba, cena základ, samotná daň a celkový součet. Pokud je tisknutelná oblast účtenky příliš úzká, nebo pokud pracujeme s velkými částkami, dojde k vynechání sloupce Daň nebo Základ.

Tabulka přehledu DPH může mít dva různé datové zdroje. Zdroj dat je možné nastavit pomocí atributu <code>source</code>, ten může nabývat těchto hodnot:
* '''auto''' (výchozí) – pokud jsou k dispozici EET data, jsou použity hodnoty z EET tržby, v opačném případě jsou hodnoty vypočteny z položek,
* '''eet''' – jsou použity hodnoty z EET tržby,
* '''entries''' – hodnoty jsou vypočteny z položek.

Atribut musí být nastaven na obou elementech (tedy i na záhlaví).

Rozdílný zdroj je důležitý například, pokud chceme na účtence zobrazit detaily částečné úhrady.

{{Sample|Příklad dynamické účtenky s podporou pro částečnou úhradu:}}
<code xml>
<entriesHeader/>
<entries/>
<line/>
<vatRatesHeader source="entries"/>
<vatRates source="entries"/>
<line/>
<right>
<if flag="partial_payment">
<entriesTotal label="Celkem: "/>
</if>
<ifNot flag="partial_payment">
<high>
<eet value="celk_trzba" label="Celkem: "/>
</high>
</ifNot>
</right>
<line/>
<if flag="partial_payment">
<text>Platba:</text>
 
<line/>
<vatRatesHeader source="eet"/>
<vatRates source="eet"/>
<line/>
<right>
<high>
<eet value="celk_trzba" label="Zaplaceno: "/>
</high>
</right>
<line/>
</if>
</code>

== Hlavička ==
Pokud je nutné odlišit účtenky nad rámec EET hodnot (například rozdílné logo, či údaje společnosti), je možné použít hlavičkovou šablonu v UDA atributu „Hlavička účtenky Mobile“. Atribut má stejnou syntaxi zápisu jako běžné šablony účtenky.

Pro vložení do šablony hlavičky slouží element <code><header/></code>.

Šablony účtenek

2022-01-10T15:04:50Z

Wikiadm: /* Čáry */

Záznamy třídy Šablona účtenky (1400171) slouží pro definici vzhledu a obsahu účtenky tisknuté terminály.

Atribut název je na zařízení zobrazen v menu (pokud je k dispozici více tiskových šablon).

Atribut EET režim nastavuje, zda má být před tiskem prováděna evidence do EET, popř. zda má o tomto rozhodovat uživatel (hodnota Dotaz).

Šablona XML pak obsahuje XML definici formátu účtenky, který je dále popsán.

{{Sample|Příklad jednoduché účtenky:}}
<code xml>
<?xml version="1.0" encoding="utf-8"?>
<template>
<center>
<text>Společnost a.s.</text>
 
</center>
<line/>
<entriesHeader/>
<entries/>
<line/>
<vatRatesHeader/>
<vatRates/>
<line/>
<right>
<high>
<entriesTotal label="Celkem: "/>
</high>
</right>
<line/>
</template>
</code>

== Text ==
Statický text musí být vždy uzavřený v elementu <code><text></code>. Volný text není podporován.

{{Sample|Příklad:}}
<code xml>
<text>Text</text>
</code>
Pokud je text delší než zbývající místo na aktuálním řádku účtenky, automaticky dochází k přetečení na další řádek, není ale brán ohled na jednotlivá slova.

Vynucené odřádkování je možné provést elementem <code> </code>.

{{Sample|Příklad:}}
<code xml>
<text>První</text>
 
<text>Druhý</text>
</code>

=== Zarovnání ===
Zarovnání textu a obrázků na účtence je možné ovlivnit jedním z následujících elementů.
<code xml>
<left>
<text>Levé</text>
</left>
<center>
<text>Střed</text>
</center>
<right>
<text>Pravé</text>
</right>
</code>
Pokud se tiskárna aktuálně nenachází na novém prázdném řádku, dojde k ukončení aktuálního řádku.

=== Styl textu ===
==== Tučný ====
Pro použití tučného řezu písma stačí vložit příslušný obsah do elementu <code></code>.

{{Sample|Příklad:}}
<code xml>

<text>Tučný text</text>

</code>

==== Podtržený ====
K dispozici jsou dva elementy pro podtržený text. Klasické podtržení pomocí <code></code> a výraznější <code><u2></code> pro podtržení s dvounásobnou tloušťkou čáry.

{{Sample|Příklad:}}
<code xml>

<text>Podtržený text</text>

<u2>
<text>Dvojitě podtržený text</text>
</u2>
</code>

==== Inverzní ====
Pro tisk v inverzním režimu (černé pozadí, bílý text) stačí použít element <code><invert></code>.

{{Sample|Příklad:}}
<code xml>
<invert>
<text>Inverzní text</text>
</invert>
</code>

=== Řádkování ===
Velikost vertikálních mezer mezi jednotlivými řádky je možné ovlivnit jejich uzavřením v elementu <code><spacing value="##"></code>, kde hodnota atributu <code>value</code> udává nový rozestup mezi řádky. Hodnota je vyjádřena v bodech, kdy jeden bod obvykle odpovídá 0,125 mm. Výchozí hodnota je 30 bodů (3,75 mm).

{{Sample|Příklad:}}
<spacing value="50">
<text>První</text> 
<text>Druhý</text> 
<text>Třetí</text> 
</spacing>

=== Velikost ===
Velikost znaků textu (a veškerého tištěného obsahu) na účtence je možné zdvojnásobit v obou směrech.

Pro široký tisk (dvounásobná šířka) slouží element <code><wide></code>.

{{Sample|Příklad:}}
<code xml>
<wide>
<text>Široký text</text>
</wide>
</code>

Pro vysoký tisk (dvounásobná výška) slouží element <code><high></code>.

{{Sample|Příklad:}}
<code xml>
<high>
<text>Vysoký text</text>
</high>
</code>

Pro velký tisk (dvounásobná výška i šířka) slouží element <code><big></code>.

{{Sample|Příklad:}}
<code xml>
<big>
<text>Velký text</text>
</big>
</code>

Pokud potřebujeme dočasně v některém z předešlých bloků použít standardní velikost, použijeme element <code><normal></code>.

{{Sample|Příklad:}}
<code xml>
<big>
<text>Velký text</text>
<normal>
<text>Malý text</text>
</normal>
<text>Velký text 2</text>
</big>
</code>

== Oddělovací prvky ==
Tyto prvky jsou ideální pro vizuální oddělení jednotlivých sekcí účtenky.

=== Čáry ===
V základu jsou k dispozici tři druhy čar. Obyčejná (<code><line/></code>), tlustá (<code><thickLine/></code>) a dvojitá (<code><doubleLine/></code>).

{{Sample|Příklad:}}
<code xml>
<text>První sekce</text>
<line/>
<text>Druhá sekce</text>
<thickLine/>
<text>Třetí sekce</text>
<doubleLine/>
<text>Poslední sekce</text>
</code>

Všechny tyto čáry je možné vytisknout v čárkovaném provedení pomocí atributu <code>dashed</code>. Tento atribut podporuje základní <code>true/false</code> hodnoty, je možné použít i pokročilý režim zápisu, kdy sekvencí kladných a záporných čísel oddělených dvojtečkou můžeme zadefinovat poměr vzoru čáry (kladné číslo) a mezery (záporné číslo).

{{Sample|Příklad:}}
<code xml>
<text>První sekce</text>
<line dashed="19:-7"/>
<text>Druhá sekce</text>
</code>

Hodnota <code>19:-7</code> použitá v příkladu říká, že na 19 bodech šířky bude vytištěn vzor zvolené čáry (v tomto případě základní čára) a poté bude na 7 bodů přerušena mezerou. Čísel může být v zápisu libovolné množství, například <code>19:-7:3:-7</code> bude mít za následek čerchovanou čáru.

==== Vlastní čáry ====

Základní oddělovací čára (<code><line/></code>), může být parametrizována vlastním vzorem.

{{Sample|Příklad:}}
<code xml>
<text>První sekce</text>
<line pattern="3C3C"/>
<text>Druhá sekce</text>
</code>

Hodnota atributu je hexadecimálním zápisem vzoru čáry, číslo musí být zarovnané vždy na násobek 8 bitů.
Pokud převedeme číslo za našeho příkhladu do binárního zápisu, získáme vertikální vzor čáry, který tiskárna horizontálně opakuje.

<code text>
3C3C = 0011110000111100
</code>

Dva horní body budou bílé, pod nimi čtyři body černé, následně čtyři body bílé a tak dále. Vytištěním příkladu bychom dostali dvounásobnou tlustou čáru. Pro tvorbu vlastních čar je vhodné použít [http://www.binaryhexconverter.com/binary-to-hex-converter převodník z binárního zápisu do hexadecimálního].

=== Znakový oddělovač ===
Element <code><separator text="="/></code> slouží k vyplnění celé řádky opakováním řetězce z atributu <code>text</code>. Atribut může obsahovat libovolně dlouhý řetězec. Výchozí hodnota atributu je <code>—</code>.

{{Sample|Příklad:}}
<code xml>
<text>První sekce</text>
<separator/>
<text>Druhá sekce</text>
</code>

== Obrázky ==
Pomocí elementu <code><img></code> je možné na účtenku vytisknout libovolný obrázek, například logo společnosti.

{{Sample|Příklad:}}
<code xml>
<img bw="true">
data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAWIAAABcCAAAAABxMODPAAAACXBIWXMAAAsTA
AALEwEAmpwYAAADGGlDQ1BQaG90b3Nob3AgSUNDIHByb2ZpbGUAAHjaY2BgnuDo4uTKJMDAUFBUUuQYgexI
…
…
…
goAAAANSUhwexg9iRg7iSdZ6jksHjaY2NDIHB2ZpbGUAAgtoCuj/wYA6GdORYwNqUoAAAAASUVORK5CYII=
</img>
</code>

Data obrázku jsou obsažena uvnitř elementu. Jedná se data kódovaná v Base64 a jsou podporovány standardní formáty obrázků (PNG, JPEG, GIF, BMP). Způsob zápisu je obdobný jako například v případě CSS (data uri). Pro převod souboru obrázku na Base64 řetězec je nutné použít příslušný [http://www.base64-image.de/ konvertor].

Volitelný atribut <code>bw</code> nastavuje způsob převodu obrázku do tiskových dat. Pokud je nastaven na <code>true</code> je každý nebílý (není brán ohled na průhlednost) bod vytisknut jako černý, v opačném případě se snaží aplikace převést barvy do černobílé podoby pomocí ditheringu.

== Podmíněný blok ==
Pro vytvoření účtenky, jejíž obsah se dynamicky mění na základě aktuálních okolností tisku, je užitečný podmíněný blok uzavřený do elementu <code><if key="identifikátor podmínky"></code> nebo v negované alternativě <code><ifNot key="identifikátor podmínky"></code>.

Atribut <code>key</code> obsahuje identifikátor podmínky, aktuálně podporované podmínky jsou:
* '''eet''' – pro účtenku byla zaevidována tržba (bez ohledu na její odeslání),
* '''eet_online''' – tržba byla úspěšně odeslána na server Finanční správy (máme k dispozici FIK),
* '''partial_payment''' – součet ceny položek je menší je větší než celková částka EET (zákazník zaplatil pouze část),
* '''dic_poverujiciho''' – na tržbě bylo vyplněno DIČ pověřujícího poplatníka.

{{Sample|Příklad (EET patička účtenky - kde chybějící FIK nemá za následek prázdný řádek):}}
<code xml>
<if flag="eet_online">
<eet value="fik" label="FIK: "/>
 
</if>
<eet value="bkp" label="BKP: "/>
 
<ifNot flag="eet_online">
<eet value="pkp"label="PKP: "/>
 
</ifNot>
<eet value="rezim" label="Režim tržby: "/>
</code>

== Hodnoty ==
Kromě statického textu je možné na účtence používat i dynamické hodnoty z tisknutého záznamu.

=== EET ===
Data týkající se příslušné EET tržby je možné získat pomocí elementu <code><eet value="identifikátor hodnoty" label="popisek"/></code>.

Atribut <code>value</code> je identifikátor hodnoty a může nabývat těchto hodnot:
* '''dat_trzby''' – datum tržby v plném formátu (DD.MM.YYYY hh:mm:ss),
* '''dat_trzby2''' – datum tržby ve formátu se zkráceným rokem (DD.MM.YY hh:mm:ss),
* '''porad_cis''' – pořadové číslo účtenky,
* '''id_provoz''' – označení provozovny,
* '''id_pokl''' – označení pokladního zařízení,
* '''dic_popl''' – DIČ poplatníka,
* '''dic_poverujiciho''' – DIČ pověřujícího poplatníka,
* '''rezim''' – režim evidované tržby (nabývá hodnot "Běžný" nebo "Zjednodušený"),
* '''celk_trzba''' – celková částka tržby,
* '''pkp''' – podpisový kód poplatníka
* '''bkp''' – bezpečnostní kód poplatníka,
* '''fik''' – fiskální identifikační kód.

Atribut <code>label</code> může voltelně obsahovat popisek, který bude vytištěn před hodnotu.

Pokud hodnota není k dispozici (je prázdná), je tisk hodnoty vynechán a to včetně popisku. K dispozici nemusí být například fiskální identifikační kód, pokud se nepodařilo odeslat tržbu na servery Finanční správy.

{{Sample|Příklad:}}
<code xml>
<eet value="dic_popl" label="DIČ: "/> 
<eet value="id_provoz" label="Provozovna: "/> 
<eet value="id_pokl" label="Pokladna: "/> 
<eet value="porad_cis" label="Číslo dokladu: "/> 
<eet value="dat_trzby_2" label="Datum tržby: "/> 
</code>

=== Položky ===
Pro tisk tabluky s přehledem položek tisknutého záznamu slouží elementy <code><entries/></code> a <code><entriesHeader/></code>. První z elementů tiskne obsah tabulky, druhý pak záhlaví tabulky. Toto rozdělení bylo zvoleno pro lepší možnosti formátování účtenky. (např. použitím oddělovače mezi tabulkou a jejím záhlavím)

{{Sample|Příklad:}}
<code xml>
<entriesHeader/>
<entries/>
</code>
Má za následek tento výstup:
<pre>
Kč
ZUBR Gold <11 20x0,5 1081,74 C
100 x 10,82
ZUBR Premium <12 20x0, 984,46 C
80 x 12,31
Lahev 0,5l 540,00 D
180 x 3,00
DOMICIL UNIV prázdný 0 900,00 D
9 x 100,00
</pre>

První řádek obsahuje název položky, celkovou cenu a písmeno určující sazbu DPH. Druhý řádek pak obsahuje počet a jednotkovou cenu.

Element <code><entries/></code> může voletelně obsahovat atribut <code>vat</code>, jehož výchozí hodnota je <code>true</code>, v tomto režimu jsou tisknuty ceny včetně DPH, pro tisk cen bez DPH je nutné nastavit hodnotu <code>false</code>.

==== Suma ====

Element <code><entriesTotal label="popisek"/></code> je ekvivalentem eet hodnoty <code>celk_trzba</code> pro situace, kdy neprovádíme EET, nebo dochází k částečné úhradě dokladu (pak se tyto dvě hodnoty liší).

=== Přehled DPH ===
Tabulku se souhrnem všech na záznamu použitých sazeb DPH, která zároveň slouží jako legenda k tabulce položek (písmena na konci řádků) vytiskneme pomocí elementů <code><vatRates/></code> a <code><vatRatesHeader/></code>. Stejně tedy jako v případě položek je záhlaví odděleno od obsahu do vlastního elementu.

{{Sample|Příklad:}}
<code xml>
<vatRatesHeader/>
<vatRates/>
</code>
Má za následek tento výstup:
<pre>
% Základ Daň Celkem
C 21 1707,60 358,60 2066,20
D 0 1440,00 0,00 1440,00
</pre>

První sloupec obsahuje písmeno reprezentující sazbu v tabulce položek, dále následuje procentuelní sazba, cena základ, samotná daň a celkový součet. Pokud je tisknutelná oblast účtenky příliš úzká, nebo pokud pracujeme s velkými částkami, dojde k vynechání sloupce Daň nebo Základ.

Tabulka přehledu DPH může mít dva různé datové zdroje. Zdroj dat je možné nastavit pomocí atributu <code>source</code>, ten může nabývat těchto hodnot:
* '''auto''' (výchozí) – pokud jsou k dispozici EET data, jsou použity hodnoty z EET tržby, v opačném případě jsou hodnoty vypočteny z položek,
* '''eet''' – jsou použity hodnoty z EET tržby,
* '''entries''' – hodnoty jsou vypočteny z položek.

Atribut musí být nastaven na obou elementech (tedy i na záhlaví).

Rozdílný zdroj je důležitý například, pokud chceme na účtence zobrazit detaily částečné úhrady.

{{Sample|Příklad dynamické účtenky s podporou pro částečnou úhradu:}}
<code xml>
<entriesHeader/>
<entries/>
<line/>
<vatRatesHeader source="entries"/>
<vatRates source="entries"/>
<line/>
<right>
<if flag="partial_payment">
<entriesTotal label="Celkem: "/>
</if>
<ifNot flag="partial_payment">
<high>
<eet value="celk_trzba" label="Celkem: "/>
</high>
</ifNot>
</right>
<line/>
<if flag="partial_payment">
<text>Platba:</text>
 
<line/>
<vatRatesHeader source="eet"/>
<vatRates source="eet"/>
<line/>
<right>
<high>
<eet value="celk_trzba" label="Zaplaceno: "/>
</high>
</right>
<line/>
</if>
</code>

== Hlavička ==
Pokud je nutné odlišit účtenky nad rámec EET hodnot (například rozdílné logo, či údaje společnosti), je možné použít hlavičkovou šablonu v UDA atributu „Hlavička účtenky Mobile“. Atribut má stejnou syntaxi zápisu jako běžné šablony účtenky.

Pro vložení do šablony hlavičky slouží element <code><header/></code>.

Šablony účtenek

2022-01-10T15:03:06Z

Wikiadm: /* Čáry */

Záznamy třídy Šablona účtenky (1400171) slouží pro definici vzhledu a obsahu účtenky tisknuté terminály.

Atribut název je na zařízení zobrazen v menu (pokud je k dispozici více tiskových šablon).

Atribut EET režim nastavuje, zda má být před tiskem prováděna evidence do EET, popř. zda má o tomto rozhodovat uživatel (hodnota Dotaz).

Šablona XML pak obsahuje XML definici formátu účtenky, který je dále popsán.

{{Sample|Příklad jednoduché účtenky:}}
<code xml>
<?xml version="1.0" encoding="utf-8"?>
<template>
<center>
<text>Společnost a.s.</text>
 
</center>
<line/>
<entriesHeader/>
<entries/>
<line/>
<vatRatesHeader/>
<vatRates/>
<line/>
<right>
<high>
<entriesTotal label="Celkem: "/>
</high>
</right>
<line/>
</template>
</code>

== Text ==
Statický text musí být vždy uzavřený v elementu <code><text></code>. Volný text není podporován.

{{Sample|Příklad:}}
<code xml>
<text>Text</text>
</code>
Pokud je text delší než zbývající místo na aktuálním řádku účtenky, automaticky dochází k přetečení na další řádek, není ale brán ohled na jednotlivá slova.

Vynucené odřádkování je možné provést elementem <code> </code>.

{{Sample|Příklad:}}
<code xml>
<text>První</text>
 
<text>Druhý</text>
</code>

=== Zarovnání ===
Zarovnání textu a obrázků na účtence je možné ovlivnit jedním z následujících elementů.
<code xml>
<left>
<text>Levé</text>
</left>
<center>
<text>Střed</text>
</center>
<right>
<text>Pravé</text>
</right>
</code>
Pokud se tiskárna aktuálně nenachází na novém prázdném řádku, dojde k ukončení aktuálního řádku.

=== Styl textu ===
==== Tučný ====
Pro použití tučného řezu písma stačí vložit příslušný obsah do elementu <code></code>.

{{Sample|Příklad:}}
<code xml>

<text>Tučný text</text>

</code>

==== Podtržený ====
K dispozici jsou dva elementy pro podtržený text. Klasické podtržení pomocí <code></code> a výraznější <code><u2></code> pro podtržení s dvounásobnou tloušťkou čáry.

{{Sample|Příklad:}}
<code xml>

<text>Podtržený text</text>

<u2>
<text>Dvojitě podtržený text</text>
</u2>
</code>

==== Inverzní ====
Pro tisk v inverzním režimu (černé pozadí, bílý text) stačí použít element <code><invert></code>.

{{Sample|Příklad:}}
<code xml>
<invert>
<text>Inverzní text</text>
</invert>
</code>

=== Řádkování ===
Velikost vertikálních mezer mezi jednotlivými řádky je možné ovlivnit jejich uzavřením v elementu <code><spacing value="##"></code>, kde hodnota atributu <code>value</code> udává nový rozestup mezi řádky. Hodnota je vyjádřena v bodech, kdy jeden bod obvykle odpovídá 0,125 mm. Výchozí hodnota je 30 bodů (3,75 mm).

{{Sample|Příklad:}}
<spacing value="50">
<text>První</text> 
<text>Druhý</text> 
<text>Třetí</text> 
</spacing>

=== Velikost ===
Velikost znaků textu (a veškerého tištěného obsahu) na účtence je možné zdvojnásobit v obou směrech.

Pro široký tisk (dvounásobná šířka) slouží element <code><wide></code>.

{{Sample|Příklad:}}
<code xml>
<wide>
<text>Široký text</text>
</wide>
</code>

Pro vysoký tisk (dvounásobná výška) slouží element <code><high></code>.

{{Sample|Příklad:}}
<code xml>
<high>
<text>Vysoký text</text>
</high>
</code>

Pro velký tisk (dvounásobná výška i šířka) slouží element <code><big></code>.

{{Sample|Příklad:}}
<code xml>
<big>
<text>Velký text</text>
</big>
</code>

Pokud potřebujeme dočasně v některém z předešlých bloků použít standardní velikost, použijeme element <code><normal></code>.

{{Sample|Příklad:}}
<code xml>
<big>
<text>Velký text</text>
<normal>
<text>Malý text</text>
</normal>
<text>Velký text 2</text>
</big>
</code>

== Oddělovací prvky ==
Tyto prvky jsou ideální pro vizuální oddělení jednotlivých sekcí účtenky.

=== Čáry ===
V základu jsou k dispozici tři druhy čar. Obyčejná (<code><line/></code>), tlustá (<code><thickLine/></code>) a dvojitá (<code><doubleLine/></code>).

{{Sample|Příklad:}}
<code xml>
<text>První sekce</text>
<line/>
<text>Druhá sekce</text>
<thickLine/>
<text>Třetí sekce</text>
<doubleLine/>
<text>Poslední sekce</text>
</code>

Všechny tyto čáry je možné vytisknout v čárkovaném provední pomocí atributu <code>dashed</code>. Tento atribut podporuje základní <code>true/false</code> hodnoty, je možné použít i pokročilý režim zápisu, kdy sekvencí kladných a záporných čísel oddělených dvojtečkou můžeme zadefinovat poměr vzrou čáry (kladné číslo) a mezery (záporné číslo).

{{Sample|Příklad:}}
<code xml>
<text>První sekce</text>
<line dashed="19:-7"/>
<text>Druhá sekce</text>
</code>

Hodnota <code>19:-7</code> použitá v příkladu říká, že na 19 bodech šířky bude vytištěn vzor zvolené čáry (v tomto případě základní čára) a poté bude na 7 bodů přerušena mezerou. Čísel může být v zápisu libovolné množství, například <code>19:-7:3:-7</code> bude mít za následek čerchovanou čáru.

==== Vlastní čáry ====

Základní oddělovací čára (<code><line/></code>), může být parametrizována vlastním vzorem.

{{Sample|Příklad:}}
<code xml>
<text>První sekce</text>
<line pattern="3C3C"/>
<text>Druhá sekce</text>
</code>

Hodnota atributu je hexadecimálním zápisem vzoru čáry, číslo musí být zarovnané vždy na násobek 8 bitů.
Pokud převedeme číslo za našeho příkhladu do binárního zápisu, získáme vertikální vzor čáry, který tiskárna horizontálně opakuje.

<code text>
3C3C = 0011110000111100
</code>

Dva horní body budou bílé, pod nimi čtyři body černé, následně čtyři body bílé a tak dále. Vytištěním příkladu bychom dostali dvounásobnou tlustou čáru. Pro tvorbu vlastních čar je vhodné použít [http://www.binaryhexconverter.com/binary-to-hex-converter převodník z binárního zápisu do hexadecimálního].

=== Znakový oddělovač ===
Element <code><separator text="="/></code> slouží k vyplnění celé řádky opakováním řetězce z atributu <code>text</code>. Atribut může obsahovat libovolně dlouhý řetězec. Výchozí hodnota atributu je <code>—</code>.

{{Sample|Příklad:}}
<code xml>
<text>První sekce</text>
<separator/>
<text>Druhá sekce</text>
</code>

== Obrázky ==
Pomocí elementu <code><img></code> je možné na účtenku vytisknout libovolný obrázek, například logo společnosti.

{{Sample|Příklad:}}
<code xml>
<img bw="true">
data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAWIAAABcCAAAAABxMODPAAAACXBIWXMAAAsTA
AALEwEAmpwYAAADGGlDQ1BQaG90b3Nob3AgSUNDIHByb2ZpbGUAAHjaY2BgnuDo4uTKJMDAUFBUUuQYgexI
…
…
…
goAAAANSUhwexg9iRg7iSdZ6jksHjaY2NDIHB2ZpbGUAAgtoCuj/wYA6GdORYwNqUoAAAAASUVORK5CYII=
</img>
</code>

Data obrázku jsou obsažena uvnitř elementu. Jedná se data kódovaná v Base64 a jsou podporovány standardní formáty obrázků (PNG, JPEG, GIF, BMP). Způsob zápisu je obdobný jako například v případě CSS (data uri). Pro převod souboru obrázku na Base64 řetězec je nutné použít příslušný [http://www.base64-image.de/ konvertor].

Volitelný atribut <code>bw</code> nastavuje způsob převodu obrázku do tiskových dat. Pokud je nastaven na <code>true</code> je každý nebílý (není brán ohled na průhlednost) bod vytisknut jako černý, v opačném případě se snaží aplikace převést barvy do černobílé podoby pomocí ditheringu.

== Podmíněný blok ==
Pro vytvoření účtenky, jejíž obsah se dynamicky mění na základě aktuálních okolností tisku, je užitečný podmíněný blok uzavřený do elementu <code><if key="identifikátor podmínky"></code> nebo v negované alternativě <code><ifNot key="identifikátor podmínky"></code>.

Atribut <code>key</code> obsahuje identifikátor podmínky, aktuálně podporované podmínky jsou:
* '''eet''' – pro účtenku byla zaevidována tržba (bez ohledu na její odeslání),
* '''eet_online''' – tržba byla úspěšně odeslána na server Finanční správy (máme k dispozici FIK),
* '''partial_payment''' – součet ceny položek je menší je větší než celková částka EET (zákazník zaplatil pouze část),
* '''dic_poverujiciho''' – na tržbě bylo vyplněno DIČ pověřujícího poplatníka.

{{Sample|Příklad (EET patička účtenky - kde chybějící FIK nemá za následek prázdný řádek):}}
<code xml>
<if flag="eet_online">
<eet value="fik" label="FIK: "/>
 
</if>
<eet value="bkp" label="BKP: "/>
 
<ifNot flag="eet_online">
<eet value="pkp"label="PKP: "/>
 
</ifNot>
<eet value="rezim" label="Režim tržby: "/>
</code>

== Hodnoty ==
Kromě statického textu je možné na účtence používat i dynamické hodnoty z tisknutého záznamu.

=== EET ===
Data týkající se příslušné EET tržby je možné získat pomocí elementu <code><eet value="identifikátor hodnoty" label="popisek"/></code>.

Atribut <code>value</code> je identifikátor hodnoty a může nabývat těchto hodnot:
* '''dat_trzby''' – datum tržby v plném formátu (DD.MM.YYYY hh:mm:ss),
* '''dat_trzby2''' – datum tržby ve formátu se zkráceným rokem (DD.MM.YY hh:mm:ss),
* '''porad_cis''' – pořadové číslo účtenky,
* '''id_provoz''' – označení provozovny,
* '''id_pokl''' – označení pokladního zařízení,
* '''dic_popl''' – DIČ poplatníka,
* '''dic_poverujiciho''' – DIČ pověřujícího poplatníka,
* '''rezim''' – režim evidované tržby (nabývá hodnot "Běžný" nebo "Zjednodušený"),
* '''celk_trzba''' – celková částka tržby,
* '''pkp''' – podpisový kód poplatníka
* '''bkp''' – bezpečnostní kód poplatníka,
* '''fik''' – fiskální identifikační kód.

Atribut <code>label</code> může voltelně obsahovat popisek, který bude vytištěn před hodnotu.

Pokud hodnota není k dispozici (je prázdná), je tisk hodnoty vynechán a to včetně popisku. K dispozici nemusí být například fiskální identifikační kód, pokud se nepodařilo odeslat tržbu na servery Finanční správy.

{{Sample|Příklad:}}
<code xml>
<eet value="dic_popl" label="DIČ: "/> 
<eet value="id_provoz" label="Provozovna: "/> 
<eet value="id_pokl" label="Pokladna: "/> 
<eet value="porad_cis" label="Číslo dokladu: "/> 
<eet value="dat_trzby_2" label="Datum tržby: "/> 
</code>

=== Položky ===
Pro tisk tabluky s přehledem položek tisknutého záznamu slouží elementy <code><entries/></code> a <code><entriesHeader/></code>. První z elementů tiskne obsah tabulky, druhý pak záhlaví tabulky. Toto rozdělení bylo zvoleno pro lepší možnosti formátování účtenky. (např. použitím oddělovače mezi tabulkou a jejím záhlavím)

{{Sample|Příklad:}}
<code xml>
<entriesHeader/>
<entries/>
</code>
Má za následek tento výstup:
<pre>
Kč
ZUBR Gold <11 20x0,5 1081,74 C
100 x 10,82
ZUBR Premium <12 20x0, 984,46 C
80 x 12,31
Lahev 0,5l 540,00 D
180 x 3,00
DOMICIL UNIV prázdný 0 900,00 D
9 x 100,00
</pre>

První řádek obsahuje název položky, celkovou cenu a písmeno určující sazbu DPH. Druhý řádek pak obsahuje počet a jednotkovou cenu.

Element <code><entries/></code> může voletelně obsahovat atribut <code>vat</code>, jehož výchozí hodnota je <code>true</code>, v tomto režimu jsou tisknuty ceny včetně DPH, pro tisk cen bez DPH je nutné nastavit hodnotu <code>false</code>.

==== Suma ====

Element <code><entriesTotal label="popisek"/></code> je ekvivalentem eet hodnoty <code>celk_trzba</code> pro situace, kdy neprovádíme EET, nebo dochází k částečné úhradě dokladu (pak se tyto dvě hodnoty liší).

=== Přehled DPH ===
Tabulku se souhrnem všech na záznamu použitých sazeb DPH, která zároveň slouží jako legenda k tabulce položek (písmena na konci řádků) vytiskneme pomocí elementů <code><vatRates/></code> a <code><vatRatesHeader/></code>. Stejně tedy jako v případě položek je záhlaví odděleno od obsahu do vlastního elementu.

{{Sample|Příklad:}}
<code xml>
<vatRatesHeader/>
<vatRates/>
</code>
Má za následek tento výstup:
<pre>
% Základ Daň Celkem
C 21 1707,60 358,60 2066,20
D 0 1440,00 0,00 1440,00
</pre>

První sloupec obsahuje písmeno reprezentující sazbu v tabulce položek, dále následuje procentuelní sazba, cena základ, samotná daň a celkový součet. Pokud je tisknutelná oblast účtenky příliš úzká, nebo pokud pracujeme s velkými částkami, dojde k vynechání sloupce Daň nebo Základ.

Tabulka přehledu DPH může mít dva různé datové zdroje. Zdroj dat je možné nastavit pomocí atributu <code>source</code>, ten může nabývat těchto hodnot:
* '''auto''' (výchozí) – pokud jsou k dispozici EET data, jsou použity hodnoty z EET tržby, v opačném případě jsou hodnoty vypočteny z položek,
* '''eet''' – jsou použity hodnoty z EET tržby,
* '''entries''' – hodnoty jsou vypočteny z položek.

Atribut musí být nastaven na obou elementech (tedy i na záhlaví).

Rozdílný zdroj je důležitý například, pokud chceme na účtence zobrazit detaily částečné úhrady.

{{Sample|Příklad dynamické účtenky s podporou pro částečnou úhradu:}}
<code xml>
<entriesHeader/>
<entries/>
<line/>
<vatRatesHeader source="entries"/>
<vatRates source="entries"/>
<line/>
<right>
<if flag="partial_payment">
<entriesTotal label="Celkem: "/>
</if>
<ifNot flag="partial_payment">
<high>
<eet value="celk_trzba" label="Celkem: "/>
</high>
</ifNot>
</right>
<line/>
<if flag="partial_payment">
<text>Platba:</text>
 
<line/>
<vatRatesHeader source="eet"/>
<vatRates source="eet"/>
<line/>
<right>
<high>
<eet value="celk_trzba" label="Zaplaceno: "/>
</high>
</right>
<line/>
</if>
</code>

== Hlavička ==
Pokud je nutné odlišit účtenky nad rámec EET hodnot (například rozdílné logo, či údaje společnosti), je možné použít hlavičkovou šablonu v UDA atributu „Hlavička účtenky Mobile“. Atribut má stejnou syntaxi zápisu jako běžné šablony účtenky.

Pro vložení do šablony hlavičky slouží element <code><header/></code>.

Šablony účtenek

2022-01-10T15:01:54Z

Wikiadm: /* Velikost */

Záznamy třídy Šablona účtenky (1400171) slouží pro definici vzhledu a obsahu účtenky tisknuté terminály.

Atribut název je na zařízení zobrazen v menu (pokud je k dispozici více tiskových šablon).

Atribut EET režim nastavuje, zda má být před tiskem prováděna evidence do EET, popř. zda má o tomto rozhodovat uživatel (hodnota Dotaz).

Šablona XML pak obsahuje XML definici formátu účtenky, který je dále popsán.

{{Sample|Příklad jednoduché účtenky:}}
<code xml>
<?xml version="1.0" encoding="utf-8"?>
<template>
<center>
<text>Společnost a.s.</text>
 
</center>
<line/>
<entriesHeader/>
<entries/>
<line/>
<vatRatesHeader/>
<vatRates/>
<line/>
<right>
<high>
<entriesTotal label="Celkem: "/>
</high>
</right>
<line/>
</template>
</code>

== Text ==
Statický text musí být vždy uzavřený v elementu <code><text></code>. Volný text není podporován.

{{Sample|Příklad:}}
<code xml>
<text>Text</text>
</code>
Pokud je text delší než zbývající místo na aktuálním řádku účtenky, automaticky dochází k přetečení na další řádek, není ale brán ohled na jednotlivá slova.

Vynucené odřádkování je možné provést elementem <code> </code>.

{{Sample|Příklad:}}
<code xml>
<text>První</text>
 
<text>Druhý</text>
</code>

=== Zarovnání ===
Zarovnání textu a obrázků na účtence je možné ovlivnit jedním z následujících elementů.
<code xml>
<left>
<text>Levé</text>
</left>
<center>
<text>Střed</text>
</center>
<right>
<text>Pravé</text>
</right>
</code>
Pokud se tiskárna aktuálně nenachází na novém prázdném řádku, dojde k ukončení aktuálního řádku.

=== Styl textu ===
==== Tučný ====
Pro použití tučného řezu písma stačí vložit příslušný obsah do elementu <code></code>.

{{Sample|Příklad:}}
<code xml>

<text>Tučný text</text>

</code>

==== Podtržený ====
K dispozici jsou dva elementy pro podtržený text. Klasické podtržení pomocí <code></code> a výraznější <code><u2></code> pro podtržení s dvounásobnou tloušťkou čáry.

{{Sample|Příklad:}}
<code xml>

<text>Podtržený text</text>

<u2>
<text>Dvojitě podtržený text</text>
</u2>
</code>

==== Inverzní ====
Pro tisk v inverzním režimu (černé pozadí, bílý text) stačí použít element <code><invert></code>.

{{Sample|Příklad:}}
<code xml>
<invert>
<text>Inverzní text</text>
</invert>
</code>

=== Řádkování ===
Velikost vertikálních mezer mezi jednotlivými řádky je možné ovlivnit jejich uzavřením v elementu <code><spacing value="##"></code>, kde hodnota atributu <code>value</code> udává nový rozestup mezi řádky. Hodnota je vyjádřena v bodech, kdy jeden bod obvykle odpovídá 0,125 mm. Výchozí hodnota je 30 bodů (3,75 mm).

{{Sample|Příklad:}}
<spacing value="50">
<text>První</text> 
<text>Druhý</text> 
<text>Třetí</text> 
</spacing>

=== Velikost ===
Velikost znaků textu (a veškerého tištěného obsahu) na účtence je možné zdvojnásobit v obou směrech.

Pro široký tisk (dvounásobná šířka) slouží element <code><wide></code>.

{{Sample|Příklad:}}
<code xml>
<wide>
<text>Široký text</text>
</wide>
</code>

Pro vysoký tisk (dvounásobná výška) slouží element <code><high></code>.

{{Sample|Příklad:}}
<code xml>
<high>
<text>Vysoký text</text>
</high>
</code>

Pro velký tisk (dvounásobná výška i šířka) slouží element <code><big></code>.

{{Sample|Příklad:}}
<code xml>
<big>
<text>Velký text</text>
</big>
</code>

Pokud potřebujeme dočasně v některém z předešlých bloků použít standardní velikost, použijeme element <code><normal></code>.

{{Sample|Příklad:}}
<code xml>
<big>
<text>Velký text</text>
<normal>
<text>Malý text</text>
</normal>
<text>Velký text 2</text>
</big>
</code>

== Oddělovací prvky ==
Tyto prvky jsou ideální pro vizuální oddělení jednotlivých sekcí účtenky.

=== Čáry ===
V základu jsou k dispozici tři druhy čar. Obyčejná (<code><line/></code>), tlustá (<code><thickLine/></code>) a dvojitá (<code><doubleLine/></code>).

{{Sample|Příklad:}}
<code xml>
<text>První sekce</text>
<line/>
<text>Druhá sekce</text>
<thickLine/>
<text>Třetí sekce</text>
<doubleLine/>
<text>Poslední sekce</text>
</code>

Všechny tyto čáry je možné vytisknout v čárkovaném provedné pomocí atributu <code>dashed</code>. Tento atribut podporuje základní <code>true/false</code> hodnoty, je možné použít i pokročilý režim zápisu, kdy sekvencí kladných a záporných čísel oddělených dvoutečkou můžeme zadefinovat poměr vzrou čáry (kladné číslo) a mezery (záporné číslo).

{{Sample|Příklad:}}
<code xml>
<text>První sekce</text>
<line dashed="19:-7"/>
<text>Druhá sekce</text>
</code>

Hodnota <code>19:-7</code> použitá v příkladu říká, že na 19 bodech šířky bude vytištěn vzor zvolené čáry (v tomto případě základní čára) a poté bude na 7 bodů přerušena mezerou. Čísel může být v zápisu libovolné množství, například <code>19:-7:3:-7</code> bude mít za následek čerchovanou čáru.

==== Vlastní čáry ====

Základní oddělovací čára (<code><line/></code>), může být parametrizována vlastním vzorem.

{{Sample|Příklad:}}
<code xml>
<text>První sekce</text>
<line pattern="3C3C"/>
<text>Druhá sekce</text>
</code>

Hodnota atributu je hexadecimálním zápisem vzoru čáry, číslo musí být zarovnané vždy na násobek 8 bitů.
Pokud převedeme číslo za našeho příkhladu do binárního zápisu, získáme vertikální vzor čáry, který tiskárna horizontálně opakuje.

<code text>
3C3C = 0011110000111100
</code>

Dva horní body budou bílé, pod nimi čtyři body černé, následně čtyři body bílé a tak dále. Vytištěním příkladu bychom dostali dvounásobnou tlustou čáru. Pro tvorbu vlastních čar je vhodné použít [http://www.binaryhexconverter.com/binary-to-hex-converter převodník z binárního zápisu do hexadecimálního].

=== Znakový oddělovač ===
Element <code><separator text="="/></code> slouží k vyplnění celé řádky opakováním řetězce z atributu <code>text</code>. Atribut může obsahovat libovolně dlouhý řetězec. Výchozí hodnota atributu je <code>—</code>.

{{Sample|Příklad:}}
<code xml>
<text>První sekce</text>
<separator/>
<text>Druhá sekce</text>
</code>

== Obrázky ==
Pomocí elementu <code><img></code> je možné na účtenku vytisknout libovolný obrázek, například logo společnosti.

{{Sample|Příklad:}}
<code xml>
<img bw="true">
data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAWIAAABcCAAAAABxMODPAAAACXBIWXMAAAsTA
AALEwEAmpwYAAADGGlDQ1BQaG90b3Nob3AgSUNDIHByb2ZpbGUAAHjaY2BgnuDo4uTKJMDAUFBUUuQYgexI
…
…
…
goAAAANSUhwexg9iRg7iSdZ6jksHjaY2NDIHB2ZpbGUAAgtoCuj/wYA6GdORYwNqUoAAAAASUVORK5CYII=
</img>
</code>

Data obrázku jsou obsažena uvnitř elementu. Jedná se data kódovaná v Base64 a jsou podporovány standardní formáty obrázků (PNG, JPEG, GIF, BMP). Způsob zápisu je obdobný jako například v případě CSS (data uri). Pro převod souboru obrázku na Base64 řetězec je nutné použít příslušný [http://www.base64-image.de/ konvertor].

Volitelný atribut <code>bw</code> nastavuje způsob převodu obrázku do tiskových dat. Pokud je nastaven na <code>true</code> je každý nebílý (není brán ohled na průhlednost) bod vytisknut jako černý, v opačném případě se snaží aplikace převést barvy do černobílé podoby pomocí ditheringu.

== Podmíněný blok ==
Pro vytvoření účtenky, jejíž obsah se dynamicky mění na základě aktuálních okolností tisku, je užitečný podmíněný blok uzavřený do elementu <code><if key="identifikátor podmínky"></code> nebo v negované alternativě <code><ifNot key="identifikátor podmínky"></code>.

Atribut <code>key</code> obsahuje identifikátor podmínky, aktuálně podporované podmínky jsou:
* '''eet''' – pro účtenku byla zaevidována tržba (bez ohledu na její odeslání),
* '''eet_online''' – tržba byla úspěšně odeslána na server Finanční správy (máme k dispozici FIK),
* '''partial_payment''' – součet ceny položek je menší je větší než celková částka EET (zákazník zaplatil pouze část),
* '''dic_poverujiciho''' – na tržbě bylo vyplněno DIČ pověřujícího poplatníka.

{{Sample|Příklad (EET patička účtenky - kde chybějící FIK nemá za následek prázdný řádek):}}
<code xml>
<if flag="eet_online">
<eet value="fik" label="FIK: "/>
 
</if>
<eet value="bkp" label="BKP: "/>
 
<ifNot flag="eet_online">
<eet value="pkp"label="PKP: "/>
 
</ifNot>
<eet value="rezim" label="Režim tržby: "/>
</code>

== Hodnoty ==
Kromě statického textu je možné na účtence používat i dynamické hodnoty z tisknutého záznamu.

=== EET ===
Data týkající se příslušné EET tržby je možné získat pomocí elementu <code><eet value="identifikátor hodnoty" label="popisek"/></code>.

Atribut <code>value</code> je identifikátor hodnoty a může nabývat těchto hodnot:
* '''dat_trzby''' – datum tržby v plném formátu (DD.MM.YYYY hh:mm:ss),
* '''dat_trzby2''' – datum tržby ve formátu se zkráceným rokem (DD.MM.YY hh:mm:ss),
* '''porad_cis''' – pořadové číslo účtenky,
* '''id_provoz''' – označení provozovny,
* '''id_pokl''' – označení pokladního zařízení,
* '''dic_popl''' – DIČ poplatníka,
* '''dic_poverujiciho''' – DIČ pověřujícího poplatníka,
* '''rezim''' – režim evidované tržby (nabývá hodnot "Běžný" nebo "Zjednodušený"),
* '''celk_trzba''' – celková částka tržby,
* '''pkp''' – podpisový kód poplatníka
* '''bkp''' – bezpečnostní kód poplatníka,
* '''fik''' – fiskální identifikační kód.

Atribut <code>label</code> může voltelně obsahovat popisek, který bude vytištěn před hodnotu.

Pokud hodnota není k dispozici (je prázdná), je tisk hodnoty vynechán a to včetně popisku. K dispozici nemusí být například fiskální identifikační kód, pokud se nepodařilo odeslat tržbu na servery Finanční správy.

{{Sample|Příklad:}}
<code xml>
<eet value="dic_popl" label="DIČ: "/> 
<eet value="id_provoz" label="Provozovna: "/> 
<eet value="id_pokl" label="Pokladna: "/> 
<eet value="porad_cis" label="Číslo dokladu: "/> 
<eet value="dat_trzby_2" label="Datum tržby: "/> 
</code>

=== Položky ===
Pro tisk tabluky s přehledem položek tisknutého záznamu slouží elementy <code><entries/></code> a <code><entriesHeader/></code>. První z elementů tiskne obsah tabulky, druhý pak záhlaví tabulky. Toto rozdělení bylo zvoleno pro lepší možnosti formátování účtenky. (např. použitím oddělovače mezi tabulkou a jejím záhlavím)

{{Sample|Příklad:}}
<code xml>
<entriesHeader/>
<entries/>
</code>
Má za následek tento výstup:
<pre>
Kč
ZUBR Gold <11 20x0,5 1081,74 C
100 x 10,82
ZUBR Premium <12 20x0, 984,46 C
80 x 12,31
Lahev 0,5l 540,00 D
180 x 3,00
DOMICIL UNIV prázdný 0 900,00 D
9 x 100,00
</pre>

První řádek obsahuje název položky, celkovou cenu a písmeno určující sazbu DPH. Druhý řádek pak obsahuje počet a jednotkovou cenu.

Element <code><entries/></code> může voletelně obsahovat atribut <code>vat</code>, jehož výchozí hodnota je <code>true</code>, v tomto režimu jsou tisknuty ceny včetně DPH, pro tisk cen bez DPH je nutné nastavit hodnotu <code>false</code>.

==== Suma ====

Element <code><entriesTotal label="popisek"/></code> je ekvivalentem eet hodnoty <code>celk_trzba</code> pro situace, kdy neprovádíme EET, nebo dochází k částečné úhradě dokladu (pak se tyto dvě hodnoty liší).

=== Přehled DPH ===
Tabulku se souhrnem všech na záznamu použitých sazeb DPH, která zároveň slouží jako legenda k tabulce položek (písmena na konci řádků) vytiskneme pomocí elementů <code><vatRates/></code> a <code><vatRatesHeader/></code>. Stejně tedy jako v případě položek je záhlaví odděleno od obsahu do vlastního elementu.

{{Sample|Příklad:}}
<code xml>
<vatRatesHeader/>
<vatRates/>
</code>
Má za následek tento výstup:
<pre>
% Základ Daň Celkem
C 21 1707,60 358,60 2066,20
D 0 1440,00 0,00 1440,00
</pre>

První sloupec obsahuje písmeno reprezentující sazbu v tabulce položek, dále následuje procentuelní sazba, cena základ, samotná daň a celkový součet. Pokud je tisknutelná oblast účtenky příliš úzká, nebo pokud pracujeme s velkými částkami, dojde k vynechání sloupce Daň nebo Základ.

Tabulka přehledu DPH může mít dva různé datové zdroje. Zdroj dat je možné nastavit pomocí atributu <code>source</code>, ten může nabývat těchto hodnot:
* '''auto''' (výchozí) – pokud jsou k dispozici EET data, jsou použity hodnoty z EET tržby, v opačném případě jsou hodnoty vypočteny z položek,
* '''eet''' – jsou použity hodnoty z EET tržby,
* '''entries''' – hodnoty jsou vypočteny z položek.

Atribut musí být nastaven na obou elementech (tedy i na záhlaví).

Rozdílný zdroj je důležitý například, pokud chceme na účtence zobrazit detaily částečné úhrady.

{{Sample|Příklad dynamické účtenky s podporou pro částečnou úhradu:}}
<code xml>
<entriesHeader/>
<entries/>
<line/>
<vatRatesHeader source="entries"/>
<vatRates source="entries"/>
<line/>
<right>
<if flag="partial_payment">
<entriesTotal label="Celkem: "/>
</if>
<ifNot flag="partial_payment">
<high>
<eet value="celk_trzba" label="Celkem: "/>
</high>
</ifNot>
</right>
<line/>
<if flag="partial_payment">
<text>Platba:</text>
 
<line/>
<vatRatesHeader source="eet"/>
<vatRates source="eet"/>
<line/>
<right>
<high>
<eet value="celk_trzba" label="Zaplaceno: "/>
</high>
</right>
<line/>
</if>
</code>

== Hlavička ==
Pokud je nutné odlišit účtenky nad rámec EET hodnot (například rozdílné logo, či údaje společnosti), je možné použít hlavičkovou šablonu v UDA atributu „Hlavička účtenky Mobile“. Atribut má stejnou syntaxi zápisu jako běžné šablony účtenky.

Pro vložení do šablony hlavičky slouží element <code><header/></code>.

Šablony účtenek

2022-01-10T14:54:14Z

Wikiadm: /* Řádkování */

Záznamy třídy Šablona účtenky (1400171) slouží pro definici vzhledu a obsahu účtenky tisknuté terminály.

Atribut název je na zařízení zobrazen v menu (pokud je k dispozici více tiskových šablon).

Atribut EET režim nastavuje, zda má být před tiskem prováděna evidence do EET, popř. zda má o tomto rozhodovat uživatel (hodnota Dotaz).

Šablona XML pak obsahuje XML definici formátu účtenky, který je dále popsán.

{{Sample|Příklad jednoduché účtenky:}}
<code xml>
<?xml version="1.0" encoding="utf-8"?>
<template>
<center>
<text>Společnost a.s.</text>
 
</center>
<line/>
<entriesHeader/>
<entries/>
<line/>
<vatRatesHeader/>
<vatRates/>
<line/>
<right>
<high>
<entriesTotal label="Celkem: "/>
</high>
</right>
<line/>
</template>
</code>

== Text ==
Statický text musí být vždy uzavřený v elementu <code><text></code>. Volný text není podporován.

{{Sample|Příklad:}}
<code xml>
<text>Text</text>
</code>
Pokud je text delší než zbývající místo na aktuálním řádku účtenky, automaticky dochází k přetečení na další řádek, není ale brán ohled na jednotlivá slova.

Vynucené odřádkování je možné provést elementem <code> </code>.

{{Sample|Příklad:}}
<code xml>
<text>První</text>
 
<text>Druhý</text>
</code>

=== Zarovnání ===
Zarovnání textu a obrázků na účtence je možné ovlivnit jedním z následujících elementů.
<code xml>
<left>
<text>Levé</text>
</left>
<center>
<text>Střed</text>
</center>
<right>
<text>Pravé</text>
</right>
</code>
Pokud se tiskárna aktuálně nenachází na novém prázdném řádku, dojde k ukončení aktuálního řádku.

=== Styl textu ===
==== Tučný ====
Pro použití tučného řezu písma stačí vložit příslušný obsah do elementu <code></code>.

{{Sample|Příklad:}}
<code xml>

<text>Tučný text</text>

</code>

==== Podtržený ====
K dispozici jsou dva elementy pro podtržený text. Klasické podtržení pomocí <code></code> a výraznější <code><u2></code> pro podtržení s dvounásobnou tloušťkou čáry.

{{Sample|Příklad:}}
<code xml>

<text>Podtržený text</text>

<u2>
<text>Dvojitě podtržený text</text>
</u2>
</code>

==== Inverzní ====
Pro tisk v inverzním režimu (černé pozadí, bílý text) stačí použít element <code><invert></code>.

{{Sample|Příklad:}}
<code xml>
<invert>
<text>Inverzní text</text>
</invert>
</code>

=== Řádkování ===
Velikost vertikálních mezer mezi jednotlivými řádky je možné ovlivnit jejich uzavřením v elementu <code><spacing value="##"></code>, kde hodnota atributu <code>value</code> udává nový rozestup mezi řádky. Hodnota je vyjádřena v bodech, kdy jeden bod obvykle odpovídá 0,125 mm. Výchozí hodnota je 30 bodů (3,75 mm).

{{Sample|Příklad:}}
<spacing value="50">
<text>První</text> 
<text>Druhý</text> 
<text>Třetí</text> 
</spacing>

=== Velikost ===
Velikost znaků textu (a veškerého tištěného obsahu) na účtence je možné zdvounásobit v obou směrech.

Pro široký tisk (dvounásobná šířka) slouží element <code><wide></code>.

{{Sample|Příklad:}}
<code xml>
<wide>
<text>Široký text</text>
</wide>
</code>

Pro vysoký tisk (dvounásobná výška) slouží element <code><high></code>.

{{Sample|Příklad:}}
<code xml>
<high>
<text>Vysoký text</text>
</high>
</code>

Pro velký tisk (dvounásobná výška i šířka) slouží element <code><big></code>.

{{Sample|Příklad:}}
<code xml>
<big>
<text>Velký text</text>
</big>
</code>

Pokud potřebujeme dočasně v některém z předešlých bloků použít standardní velikost, použijeme element <code><normal></code>.

{{Sample|Příklad:}}
<code xml>
<big>
<text>Velký text</text>
<normal>
<text>Malý text</text>
</normal>
<text>Velký text 2</text>
</big>
</code>

== Oddělovací prvky ==
Tyto prvky jsou ideální pro vizuální oddělení jednotlivých sekcí účtenky.

=== Čáry ===
V základu jsou k dispozici tři druhy čar. Obyčejná (<code><line/></code>), tlustá (<code><thickLine/></code>) a dvojitá (<code><doubleLine/></code>).

{{Sample|Příklad:}}
<code xml>
<text>První sekce</text>
<line/>
<text>Druhá sekce</text>
<thickLine/>
<text>Třetí sekce</text>
<doubleLine/>
<text>Poslední sekce</text>
</code>

Všechny tyto čáry je možné vytisknout v čárkovaném provedné pomocí atributu <code>dashed</code>. Tento atribut podporuje základní <code>true/false</code> hodnoty, je možné použít i pokročilý režim zápisu, kdy sekvencí kladných a záporných čísel oddělených dvoutečkou můžeme zadefinovat poměr vzrou čáry (kladné číslo) a mezery (záporné číslo).

{{Sample|Příklad:}}
<code xml>
<text>První sekce</text>
<line dashed="19:-7"/>
<text>Druhá sekce</text>
</code>

Hodnota <code>19:-7</code> použitá v příkladu říká, že na 19 bodech šířky bude vytištěn vzor zvolené čáry (v tomto případě základní čára) a poté bude na 7 bodů přerušena mezerou. Čísel může být v zápisu libovolné množství, například <code>19:-7:3:-7</code> bude mít za následek čerchovanou čáru.

==== Vlastní čáry ====

Základní oddělovací čára (<code><line/></code>), může být parametrizována vlastním vzorem.

{{Sample|Příklad:}}
<code xml>
<text>První sekce</text>
<line pattern="3C3C"/>
<text>Druhá sekce</text>
</code>

Hodnota atributu je hexadecimálním zápisem vzoru čáry, číslo musí být zarovnané vždy na násobek 8 bitů.
Pokud převedeme číslo za našeho příkhladu do binárního zápisu, získáme vertikální vzor čáry, který tiskárna horizontálně opakuje.

<code text>
3C3C = 0011110000111100
</code>

Dva horní body budou bílé, pod nimi čtyři body černé, následně čtyři body bílé a tak dále. Vytištěním příkladu bychom dostali dvounásobnou tlustou čáru. Pro tvorbu vlastních čar je vhodné použít [http://www.binaryhexconverter.com/binary-to-hex-converter převodník z binárního zápisu do hexadecimálního].

=== Znakový oddělovač ===
Element <code><separator text="="/></code> slouží k vyplnění celé řádky opakováním řetězce z atributu <code>text</code>. Atribut může obsahovat libovolně dlouhý řetězec. Výchozí hodnota atributu je <code>—</code>.

{{Sample|Příklad:}}
<code xml>
<text>První sekce</text>
<separator/>
<text>Druhá sekce</text>
</code>

== Obrázky ==
Pomocí elementu <code><img></code> je možné na účtenku vytisknout libovolný obrázek, například logo společnosti.

{{Sample|Příklad:}}
<code xml>
<img bw="true">
data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAWIAAABcCAAAAABxMODPAAAACXBIWXMAAAsTA
AALEwEAmpwYAAADGGlDQ1BQaG90b3Nob3AgSUNDIHByb2ZpbGUAAHjaY2BgnuDo4uTKJMDAUFBUUuQYgexI
…
…
…
goAAAANSUhwexg9iRg7iSdZ6jksHjaY2NDIHB2ZpbGUAAgtoCuj/wYA6GdORYwNqUoAAAAASUVORK5CYII=
</img>
</code>

Data obrázku jsou obsažena uvnitř elementu. Jedná se data kódovaná v Base64 a jsou podporovány standardní formáty obrázků (PNG, JPEG, GIF, BMP). Způsob zápisu je obdobný jako například v případě CSS (data uri). Pro převod souboru obrázku na Base64 řetězec je nutné použít příslušný [http://www.base64-image.de/ konvertor].

Volitelný atribut <code>bw</code> nastavuje způsob převodu obrázku do tiskových dat. Pokud je nastaven na <code>true</code> je každý nebílý (není brán ohled na průhlednost) bod vytisknut jako černý, v opačném případě se snaží aplikace převést barvy do černobílé podoby pomocí ditheringu.

== Podmíněný blok ==
Pro vytvoření účtenky, jejíž obsah se dynamicky mění na základě aktuálních okolností tisku, je užitečný podmíněný blok uzavřený do elementu <code><if key="identifikátor podmínky"></code> nebo v negované alternativě <code><ifNot key="identifikátor podmínky"></code>.

Atribut <code>key</code> obsahuje identifikátor podmínky, aktuálně podporované podmínky jsou:
* '''eet''' – pro účtenku byla zaevidována tržba (bez ohledu na její odeslání),
* '''eet_online''' – tržba byla úspěšně odeslána na server Finanční správy (máme k dispozici FIK),
* '''partial_payment''' – součet ceny položek je menší je větší než celková částka EET (zákazník zaplatil pouze část),
* '''dic_poverujiciho''' – na tržbě bylo vyplněno DIČ pověřujícího poplatníka.

{{Sample|Příklad (EET patička účtenky - kde chybějící FIK nemá za následek prázdný řádek):}}
<code xml>
<if flag="eet_online">
<eet value="fik" label="FIK: "/>
 
</if>
<eet value="bkp" label="BKP: "/>
 
<ifNot flag="eet_online">
<eet value="pkp"label="PKP: "/>
 
</ifNot>
<eet value="rezim" label="Režim tržby: "/>
</code>

== Hodnoty ==
Kromě statického textu je možné na účtence používat i dynamické hodnoty z tisknutého záznamu.

=== EET ===
Data týkající se příslušné EET tržby je možné získat pomocí elementu <code><eet value="identifikátor hodnoty" label="popisek"/></code>.

Atribut <code>value</code> je identifikátor hodnoty a může nabývat těchto hodnot:
* '''dat_trzby''' – datum tržby v plném formátu (DD.MM.YYYY hh:mm:ss),
* '''dat_trzby2''' – datum tržby ve formátu se zkráceným rokem (DD.MM.YY hh:mm:ss),
* '''porad_cis''' – pořadové číslo účtenky,
* '''id_provoz''' – označení provozovny,
* '''id_pokl''' – označení pokladního zařízení,
* '''dic_popl''' – DIČ poplatníka,
* '''dic_poverujiciho''' – DIČ pověřujícího poplatníka,
* '''rezim''' – režim evidované tržby (nabývá hodnot "Běžný" nebo "Zjednodušený"),
* '''celk_trzba''' – celková částka tržby,
* '''pkp''' – podpisový kód poplatníka
* '''bkp''' – bezpečnostní kód poplatníka,
* '''fik''' – fiskální identifikační kód.

Atribut <code>label</code> může voltelně obsahovat popisek, který bude vytištěn před hodnotu.

Pokud hodnota není k dispozici (je prázdná), je tisk hodnoty vynechán a to včetně popisku. K dispozici nemusí být například fiskální identifikační kód, pokud se nepodařilo odeslat tržbu na servery Finanční správy.

{{Sample|Příklad:}}
<code xml>
<eet value="dic_popl" label="DIČ: "/> 
<eet value="id_provoz" label="Provozovna: "/> 
<eet value="id_pokl" label="Pokladna: "/> 
<eet value="porad_cis" label="Číslo dokladu: "/> 
<eet value="dat_trzby_2" label="Datum tržby: "/> 
</code>

=== Položky ===
Pro tisk tabluky s přehledem položek tisknutého záznamu slouží elementy <code><entries/></code> a <code><entriesHeader/></code>. První z elementů tiskne obsah tabulky, druhý pak záhlaví tabulky. Toto rozdělení bylo zvoleno pro lepší možnosti formátování účtenky. (např. použitím oddělovače mezi tabulkou a jejím záhlavím)

{{Sample|Příklad:}}
<code xml>
<entriesHeader/>
<entries/>
</code>
Má za následek tento výstup:
<pre>
Kč
ZUBR Gold <11 20x0,5 1081,74 C
100 x 10,82
ZUBR Premium <12 20x0, 984,46 C
80 x 12,31
Lahev 0,5l 540,00 D
180 x 3,00
DOMICIL UNIV prázdný 0 900,00 D
9 x 100,00
</pre>

První řádek obsahuje název položky, celkovou cenu a písmeno určující sazbu DPH. Druhý řádek pak obsahuje počet a jednotkovou cenu.

Element <code><entries/></code> může voletelně obsahovat atribut <code>vat</code>, jehož výchozí hodnota je <code>true</code>, v tomto režimu jsou tisknuty ceny včetně DPH, pro tisk cen bez DPH je nutné nastavit hodnotu <code>false</code>.

==== Suma ====

Element <code><entriesTotal label="popisek"/></code> je ekvivalentem eet hodnoty <code>celk_trzba</code> pro situace, kdy neprovádíme EET, nebo dochází k částečné úhradě dokladu (pak se tyto dvě hodnoty liší).

=== Přehled DPH ===
Tabulku se souhrnem všech na záznamu použitých sazeb DPH, která zároveň slouží jako legenda k tabulce položek (písmena na konci řádků) vytiskneme pomocí elementů <code><vatRates/></code> a <code><vatRatesHeader/></code>. Stejně tedy jako v případě položek je záhlaví odděleno od obsahu do vlastního elementu.

{{Sample|Příklad:}}
<code xml>
<vatRatesHeader/>
<vatRates/>
</code>
Má za následek tento výstup:
<pre>
% Základ Daň Celkem
C 21 1707,60 358,60 2066,20
D 0 1440,00 0,00 1440,00
</pre>

První sloupec obsahuje písmeno reprezentující sazbu v tabulce položek, dále následuje procentuelní sazba, cena základ, samotná daň a celkový součet. Pokud je tisknutelná oblast účtenky příliš úzká, nebo pokud pracujeme s velkými částkami, dojde k vynechání sloupce Daň nebo Základ.

Tabulka přehledu DPH může mít dva různé datové zdroje. Zdroj dat je možné nastavit pomocí atributu <code>source</code>, ten může nabývat těchto hodnot:
* '''auto''' (výchozí) – pokud jsou k dispozici EET data, jsou použity hodnoty z EET tržby, v opačném případě jsou hodnoty vypočteny z položek,
* '''eet''' – jsou použity hodnoty z EET tržby,
* '''entries''' – hodnoty jsou vypočteny z položek.

Atribut musí být nastaven na obou elementech (tedy i na záhlaví).

Rozdílný zdroj je důležitý například, pokud chceme na účtence zobrazit detaily částečné úhrady.

{{Sample|Příklad dynamické účtenky s podporou pro částečnou úhradu:}}
<code xml>
<entriesHeader/>
<entries/>
<line/>
<vatRatesHeader source="entries"/>
<vatRates source="entries"/>
<line/>
<right>
<if flag="partial_payment">
<entriesTotal label="Celkem: "/>
</if>
<ifNot flag="partial_payment">
<high>
<eet value="celk_trzba" label="Celkem: "/>
</high>
</ifNot>
</right>
<line/>
<if flag="partial_payment">
<text>Platba:</text>
 
<line/>
<vatRatesHeader source="eet"/>
<vatRates source="eet"/>
<line/>
<right>
<high>
<eet value="celk_trzba" label="Zaplaceno: "/>
</high>
</right>
<line/>
</if>
</code>

== Hlavička ==
Pokud je nutné odlišit účtenky nad rámec EET hodnot (například rozdílné logo, či údaje společnosti), je možné použít hlavičkovou šablonu v UDA atributu „Hlavička účtenky Mobile“. Atribut má stejnou syntaxi zápisu jako běžné šablony účtenky.

Pro vložení do šablony hlavičky slouží element <code><header/></code>.

Šablony účtenek

2022-01-10T14:52:50Z

Wikiadm: /* Text */

Záznamy třídy Šablona účtenky (1400171) slouží pro definici vzhledu a obsahu účtenky tisknuté terminály.

Atribut název je na zařízení zobrazen v menu (pokud je k dispozici více tiskových šablon).

Atribut EET režim nastavuje, zda má být před tiskem prováděna evidence do EET, popř. zda má o tomto rozhodovat uživatel (hodnota Dotaz).

Šablona XML pak obsahuje XML definici formátu účtenky, který je dále popsán.

{{Sample|Příklad jednoduché účtenky:}}
<code xml>
<?xml version="1.0" encoding="utf-8"?>
<template>
<center>
<text>Společnost a.s.</text>
 
</center>
<line/>
<entriesHeader/>
<entries/>
<line/>
<vatRatesHeader/>
<vatRates/>
<line/>
<right>
<high>
<entriesTotal label="Celkem: "/>
</high>
</right>
<line/>
</template>
</code>

== Text ==
Statický text musí být vždy uzavřený v elementu <code><text></code>. Volný text není podporován.

{{Sample|Příklad:}}
<code xml>
<text>Text</text>
</code>
Pokud je text delší než zbývající místo na aktuálním řádku účtenky, automaticky dochází k přetečení na další řádek, není ale brán ohled na jednotlivá slova.

Vynucené odřádkování je možné provést elementem <code> </code>.

{{Sample|Příklad:}}
<code xml>
<text>První</text>
 
<text>Druhý</text>
</code>

=== Zarovnání ===
Zarovnání textu a obrázků na účtence je možné ovlivnit jedním z následujících elementů.
<code xml>
<left>
<text>Levé</text>
</left>
<center>
<text>Střed</text>
</center>
<right>
<text>Pravé</text>
</right>
</code>
Pokud se tiskárna aktuálně nenachází na novém prázdném řádku, dojde k ukončení aktuálního řádku.

=== Styl textu ===
==== Tučný ====
Pro použití tučného řezu písma stačí vložit příslušný obsah do elementu <code></code>.

{{Sample|Příklad:}}
<code xml>

<text>Tučný text</text>

</code>

==== Podtržený ====
K dispozici jsou dva elementy pro podtržený text. Klasické podtržení pomocí <code></code> a výraznější <code><u2></code> pro podtržení s dvounásobnou tloušťkou čáry.

{{Sample|Příklad:}}
<code xml>

<text>Podtržený text</text>

<u2>
<text>Dvojitě podtržený text</text>
</u2>
</code>

==== Inverzní ====
Pro tisk v inverzním režimu (černé pozadí, bílý text) stačí použít element <code><invert></code>.

{{Sample|Příklad:}}
<code xml>
<invert>
<text>Inverzní text</text>
</invert>
</code>

=== Řádkování ===
Velikost vertikálních mezer mezi jednotlivými řádky je možné ovlivnit jejich uzavřením v elementu <code><spacing value="##"></code>, kde hodnota atributu <code>value</code> udává nový rozestup mezi řádky. Hodntoa je vyjádřena v bodech, kdy jeden bod obvykle odpovídá 0,125 mm. Výchozí hodnota je 30 bodů (3,75 mm).

{{Sample|Příklad:}}
<spacing value="50">
<text>První</text> 
<text>Druhý</text> 
<text>Třetí</text> 
</spacing>

=== Velikost ===
Velikost znaků textu (a veškerého tištěného obsahu) na účtence je možné zdvounásobit v obou směrech.

Pro široký tisk (dvounásobná šířka) slouží element <code><wide></code>.

{{Sample|Příklad:}}
<code xml>
<wide>
<text>Široký text</text>
</wide>
</code>

Pro vysoký tisk (dvounásobná výška) slouží element <code><high></code>.

{{Sample|Příklad:}}
<code xml>
<high>
<text>Vysoký text</text>
</high>
</code>

Pro velký tisk (dvounásobná výška i šířka) slouží element <code><big></code>.

{{Sample|Příklad:}}
<code xml>
<big>
<text>Velký text</text>
</big>
</code>

Pokud potřebujeme dočasně v některém z předešlých bloků použít standardní velikost, použijeme element <code><normal></code>.

{{Sample|Příklad:}}
<code xml>
<big>
<text>Velký text</text>
<normal>
<text>Malý text</text>
</normal>
<text>Velký text 2</text>
</big>
</code>

== Oddělovací prvky ==
Tyto prvky jsou ideální pro vizuální oddělení jednotlivých sekcí účtenky.

=== Čáry ===
V základu jsou k dispozici tři druhy čar. Obyčejná (<code><line/></code>), tlustá (<code><thickLine/></code>) a dvojitá (<code><doubleLine/></code>).

{{Sample|Příklad:}}
<code xml>
<text>První sekce</text>
<line/>
<text>Druhá sekce</text>
<thickLine/>
<text>Třetí sekce</text>
<doubleLine/>
<text>Poslední sekce</text>
</code>

Všechny tyto čáry je možné vytisknout v čárkovaném provedné pomocí atributu <code>dashed</code>. Tento atribut podporuje základní <code>true/false</code> hodnoty, je možné použít i pokročilý režim zápisu, kdy sekvencí kladných a záporných čísel oddělených dvoutečkou můžeme zadefinovat poměr vzrou čáry (kladné číslo) a mezery (záporné číslo).

{{Sample|Příklad:}}
<code xml>
<text>První sekce</text>
<line dashed="19:-7"/>
<text>Druhá sekce</text>
</code>

Hodnota <code>19:-7</code> použitá v příkladu říká, že na 19 bodech šířky bude vytištěn vzor zvolené čáry (v tomto případě základní čára) a poté bude na 7 bodů přerušena mezerou. Čísel může být v zápisu libovolné množství, například <code>19:-7:3:-7</code> bude mít za následek čerchovanou čáru.

==== Vlastní čáry ====

Základní oddělovací čára (<code><line/></code>), může být parametrizována vlastním vzorem.

{{Sample|Příklad:}}
<code xml>
<text>První sekce</text>
<line pattern="3C3C"/>
<text>Druhá sekce</text>
</code>

Hodnota atributu je hexadecimálním zápisem vzoru čáry, číslo musí být zarovnané vždy na násobek 8 bitů.
Pokud převedeme číslo za našeho příkhladu do binárního zápisu, získáme vertikální vzor čáry, který tiskárna horizontálně opakuje.

<code text>
3C3C = 0011110000111100
</code>

Dva horní body budou bílé, pod nimi čtyři body černé, následně čtyři body bílé a tak dále. Vytištěním příkladu bychom dostali dvounásobnou tlustou čáru. Pro tvorbu vlastních čar je vhodné použít [http://www.binaryhexconverter.com/binary-to-hex-converter převodník z binárního zápisu do hexadecimálního].

=== Znakový oddělovač ===
Element <code><separator text="="/></code> slouží k vyplnění celé řádky opakováním řetězce z atributu <code>text</code>. Atribut může obsahovat libovolně dlouhý řetězec. Výchozí hodnota atributu je <code>—</code>.

{{Sample|Příklad:}}
<code xml>
<text>První sekce</text>
<separator/>
<text>Druhá sekce</text>
</code>

== Obrázky ==
Pomocí elementu <code><img></code> je možné na účtenku vytisknout libovolný obrázek, například logo společnosti.

{{Sample|Příklad:}}
<code xml>
<img bw="true">
data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAWIAAABcCAAAAABxMODPAAAACXBIWXMAAAsTA
AALEwEAmpwYAAADGGlDQ1BQaG90b3Nob3AgSUNDIHByb2ZpbGUAAHjaY2BgnuDo4uTKJMDAUFBUUuQYgexI
…
…
…
goAAAANSUhwexg9iRg7iSdZ6jksHjaY2NDIHB2ZpbGUAAgtoCuj/wYA6GdORYwNqUoAAAAASUVORK5CYII=
</img>
</code>

Data obrázku jsou obsažena uvnitř elementu. Jedná se data kódovaná v Base64 a jsou podporovány standardní formáty obrázků (PNG, JPEG, GIF, BMP). Způsob zápisu je obdobný jako například v případě CSS (data uri). Pro převod souboru obrázku na Base64 řetězec je nutné použít příslušný [http://www.base64-image.de/ konvertor].

Volitelný atribut <code>bw</code> nastavuje způsob převodu obrázku do tiskových dat. Pokud je nastaven na <code>true</code> je každý nebílý (není brán ohled na průhlednost) bod vytisknut jako černý, v opačném případě se snaží aplikace převést barvy do černobílé podoby pomocí ditheringu.

== Podmíněný blok ==
Pro vytvoření účtenky, jejíž obsah se dynamicky mění na základě aktuálních okolností tisku, je užitečný podmíněný blok uzavřený do elementu <code><if key="identifikátor podmínky"></code> nebo v negované alternativě <code><ifNot key="identifikátor podmínky"></code>.

Atribut <code>key</code> obsahuje identifikátor podmínky, aktuálně podporované podmínky jsou:
* '''eet''' – pro účtenku byla zaevidována tržba (bez ohledu na její odeslání),
* '''eet_online''' – tržba byla úspěšně odeslána na server Finanční správy (máme k dispozici FIK),
* '''partial_payment''' – součet ceny položek je menší je větší než celková částka EET (zákazník zaplatil pouze část),
* '''dic_poverujiciho''' – na tržbě bylo vyplněno DIČ pověřujícího poplatníka.

{{Sample|Příklad (EET patička účtenky - kde chybějící FIK nemá za následek prázdný řádek):}}
<code xml>
<if flag="eet_online">
<eet value="fik" label="FIK: "/>
 
</if>
<eet value="bkp" label="BKP: "/>
 
<ifNot flag="eet_online">
<eet value="pkp"label="PKP: "/>
 
</ifNot>
<eet value="rezim" label="Režim tržby: "/>
</code>

== Hodnoty ==
Kromě statického textu je možné na účtence používat i dynamické hodnoty z tisknutého záznamu.

=== EET ===
Data týkající se příslušné EET tržby je možné získat pomocí elementu <code><eet value="identifikátor hodnoty" label="popisek"/></code>.

Atribut <code>value</code> je identifikátor hodnoty a může nabývat těchto hodnot:
* '''dat_trzby''' – datum tržby v plném formátu (DD.MM.YYYY hh:mm:ss),
* '''dat_trzby2''' – datum tržby ve formátu se zkráceným rokem (DD.MM.YY hh:mm:ss),
* '''porad_cis''' – pořadové číslo účtenky,
* '''id_provoz''' – označení provozovny,
* '''id_pokl''' – označení pokladního zařízení,
* '''dic_popl''' – DIČ poplatníka,
* '''dic_poverujiciho''' – DIČ pověřujícího poplatníka,
* '''rezim''' – režim evidované tržby (nabývá hodnot "Běžný" nebo "Zjednodušený"),
* '''celk_trzba''' – celková částka tržby,
* '''pkp''' – podpisový kód poplatníka
* '''bkp''' – bezpečnostní kód poplatníka,
* '''fik''' – fiskální identifikační kód.

Atribut <code>label</code> může voltelně obsahovat popisek, který bude vytištěn před hodnotu.

Pokud hodnota není k dispozici (je prázdná), je tisk hodnoty vynechán a to včetně popisku. K dispozici nemusí být například fiskální identifikační kód, pokud se nepodařilo odeslat tržbu na servery Finanční správy.

{{Sample|Příklad:}}
<code xml>
<eet value="dic_popl" label="DIČ: "/> 
<eet value="id_provoz" label="Provozovna: "/> 
<eet value="id_pokl" label="Pokladna: "/> 
<eet value="porad_cis" label="Číslo dokladu: "/> 
<eet value="dat_trzby_2" label="Datum tržby: "/> 
</code>

=== Položky ===
Pro tisk tabluky s přehledem položek tisknutého záznamu slouží elementy <code><entries/></code> a <code><entriesHeader/></code>. První z elementů tiskne obsah tabulky, druhý pak záhlaví tabulky. Toto rozdělení bylo zvoleno pro lepší možnosti formátování účtenky. (např. použitím oddělovače mezi tabulkou a jejím záhlavím)

{{Sample|Příklad:}}
<code xml>
<entriesHeader/>
<entries/>
</code>
Má za následek tento výstup:
<pre>
Kč
ZUBR Gold <11 20x0,5 1081,74 C
100 x 10,82
ZUBR Premium <12 20x0, 984,46 C
80 x 12,31
Lahev 0,5l 540,00 D
180 x 3,00
DOMICIL UNIV prázdný 0 900,00 D
9 x 100,00
</pre>

První řádek obsahuje název položky, celkovou cenu a písmeno určující sazbu DPH. Druhý řádek pak obsahuje počet a jednotkovou cenu.

Element <code><entries/></code> může voletelně obsahovat atribut <code>vat</code>, jehož výchozí hodnota je <code>true</code>, v tomto režimu jsou tisknuty ceny včetně DPH, pro tisk cen bez DPH je nutné nastavit hodnotu <code>false</code>.

==== Suma ====

Element <code><entriesTotal label="popisek"/></code> je ekvivalentem eet hodnoty <code>celk_trzba</code> pro situace, kdy neprovádíme EET, nebo dochází k částečné úhradě dokladu (pak se tyto dvě hodnoty liší).

=== Přehled DPH ===
Tabulku se souhrnem všech na záznamu použitých sazeb DPH, která zároveň slouží jako legenda k tabulce položek (písmena na konci řádků) vytiskneme pomocí elementů <code><vatRates/></code> a <code><vatRatesHeader/></code>. Stejně tedy jako v případě položek je záhlaví odděleno od obsahu do vlastního elementu.

{{Sample|Příklad:}}
<code xml>
<vatRatesHeader/>
<vatRates/>
</code>
Má za následek tento výstup:
<pre>
% Základ Daň Celkem
C 21 1707,60 358,60 2066,20
D 0 1440,00 0,00 1440,00
</pre>

První sloupec obsahuje písmeno reprezentující sazbu v tabulce položek, dále následuje procentuelní sazba, cena základ, samotná daň a celkový součet. Pokud je tisknutelná oblast účtenky příliš úzká, nebo pokud pracujeme s velkými částkami, dojde k vynechání sloupce Daň nebo Základ.

Tabulka přehledu DPH může mít dva různé datové zdroje. Zdroj dat je možné nastavit pomocí atributu <code>source</code>, ten může nabývat těchto hodnot:
* '''auto''' (výchozí) – pokud jsou k dispozici EET data, jsou použity hodnoty z EET tržby, v opačném případě jsou hodnoty vypočteny z položek,
* '''eet''' – jsou použity hodnoty z EET tržby,
* '''entries''' – hodnoty jsou vypočteny z položek.

Atribut musí být nastaven na obou elementech (tedy i na záhlaví).

Rozdílný zdroj je důležitý například, pokud chceme na účtence zobrazit detaily částečné úhrady.

{{Sample|Příklad dynamické účtenky s podporou pro částečnou úhradu:}}
<code xml>
<entriesHeader/>
<entries/>
<line/>
<vatRatesHeader source="entries"/>
<vatRates source="entries"/>
<line/>
<right>
<if flag="partial_payment">
<entriesTotal label="Celkem: "/>
</if>
<ifNot flag="partial_payment">
<high>
<eet value="celk_trzba" label="Celkem: "/>
</high>
</ifNot>
</right>
<line/>
<if flag="partial_payment">
<text>Platba:</text>
 
<line/>
<vatRatesHeader source="eet"/>
<vatRates source="eet"/>
<line/>
<right>
<high>
<eet value="celk_trzba" label="Zaplaceno: "/>
</high>
</right>
<line/>
</if>
</code>

== Hlavička ==
Pokud je nutné odlišit účtenky nad rámec EET hodnot (například rozdílné logo, či údaje společnosti), je možné použít hlavičkovou šablonu v UDA atributu „Hlavička účtenky Mobile“. Atribut má stejnou syntaxi zápisu jako běžné šablony účtenky.

Pro vložení do šablony hlavičky slouží element <code><header/></code>.

Podpisy

2022-01-10T14:32:51Z

Wikiadm: /* Konfigurace podpisu */

HELIOS Mobile pro Android podporuje ověření záznamu podpisem. Podpis se v mobilní aplikaci zadává dotykovým perem a ukládá jako dynamický vztah. Ke každému podpisu existuje definice podpisu, která vymezuje atributy a vztahy, které budou podpisem kontrolovány. Jejich změna na záznamu způsobí znevalidnění podpisu.

==Konfigurace podpisu==

'''1. Dynamický vztah pro podpis'''

Pro třídu, resp. pořadač, jehož záznamy se budou ověřovat podpisem, je třeba vytvořit nový dynamický vztah.
* ''Typ vztahu:'' Subjekt – Subjekt
* ''Relace vztahu:'' 1:1
* ''Pořadač vpravo:'' Podpisy

'''2. Definice podpisu'''

V pořadači Definice podpisů je třeba založit nový záznam s definicí podpisu.
* ''Vztah podpisu:'' vztah, vytvořený v kroku 1.
* ''Rozlišení:'' rozlišení v jakém se bude ukládat Obrázek podpisu
* ''Kontrolované atributy:'' atributy, jejichž změna na záznamu způsobí znevalidnění podpisu
* ''Kontrolované vztahy:'' statické a dynamické vztahy, jejichž změna způsobí znevalidnění podpisu

[[Soubor:Definicepodpisu.jpg]]

'''3. Přidání dynamického vztahu pro podpisy do inicializace'''

V Inicializaci mobilních zařízení je třeba u pořadače, jehož záznamy se budou ověřovat podpisem, přidat dynamický vztah, vytvořený v kroku 1.
V Konfiguraci tohoto dynamického vztahu je třeba vybrat odpovídající Definici podpisu (viz krok 2)

[[Soubor:Podpis-DV.jpg]]

'''4. Přidání pořadače Podpisy do inicializace'''

Do inicializace mobilních zařízení je třeba také přidat pořadač Podpisy a u něj přidat Vztah příloh Obrázek podpisu

[[Soubor:Podpisy.jpg]]

Gadgety

2022-01-10T14:28:34Z

Wikiadm:

Gadgety jsou informační panely, které lze umístit na hlavní stránku aplikace – dashboard (nástěnku).

==Práce s gadgety v mobilní aplikaci==
[[Soubor:gadgety.jpg]]

Vysvětlivky:
# Návrat na úvodní obrazovku (dashboard s gadgety)
# Rozbalit gadget
# Sbalit gadget
# Nastavení gadgetů

Do mobilního zařízení se inicializují všechny '''aktivní''' gadgety z HELIOS Green. Uživatel má možnost si na mobilním zařízení zvolit, které gadgety chce na úvodní obrazovce vidět a která ne.

[[Soubor:Gadget-konf.jpg]]

Pokud není gadget do mobilního zařízení synchronizován, upozorní na to a je potřeba pro jeho zobrazení spustit synchronizaci běžným způsobem.

[[Soubor:Gadget-synchro.jpg]]

==Konfigurace gadgetů v HELIOS Mobile==
V konfiguraci inicializace zařízení na záložce '''Vztahy''' lze vybrat gadgety, které se budou zobrazovat všem namapovaným uživatelům ve výchozím stavu.

[[Soubor:Dashboard.jpg]]

Gadgety musí být v HELIOS Green nastaveny jako '''aktivní''' a musí mít '''namapované uživatele''', kterým se mají na zařízení zobrazit.

Výchozí pořadí gadgetů na zařízení je možno nastavit na záznamech '''Mapování uživatelů Gadgetů'''

[[Soubor:Gadget-definicwe.jpg]]

Aby se gadgety v aplikaci vůbec zobrazily, musí být v inicializaci mobilního zařízení zaškrtnuta volba '''Dashboard'''

[[Soubor:Dashboard2.jpg]]