Na začiatku vývoja nepotrebujete žiadny hardvér. eKasu nainštalujete, prepnete do integračného prostredia s úložiskom In-Memory a doklady sa budú „tlačiť“ do PDF. So skutočným úložiskom a tlačiarňou integráciu vyskúšate až pred nasadením.
Integračné a produkčné prostredie
Finančná správa prevádzkuje systém eKasa v dvoch prostrediach:
| Integračné | Produkčné | |
|---|---|---|
| Na čo slúži | vývoj a testovanie | ostrá prevádzka |
| Podnikateľ | fiktívny, so sadou údajov od finančnej správy | skutočný, s údajmi z jeho registrácie pokladnice |
| Tržby | nepočítajú sa | evidujú sa |
Celý vývoj prebieha v integračnom prostredí. Do produkčného prostredia sa dostane až pokladnica u podnikateľa.
Rýchly štart bez hardvéru
1. Nainštalujte eKasu
Demo verziu pre Android môžete nainštalovať na ľubovoľné zariadenie s Androidom. Funguje len v integračnom prostredí.
2. Zapnite In-Memory úložisko a integračné prostredie
Otvorte webové rozhranie služby. Na počítači so službou je na adrese http://localhost:3010, na Androide na adrese
zariadenia s portom 3010. Rozhranie je rovnaké na všetkých platformách. V menu Systém → Nastavenia:
- v záložke Úložisko zvoľte Model úložiska: In-Memory,
- v záložke eKasa klient zvoľte Prostredie: Integračné.
Pri knižnici sa služba ani jej webové rozhranie neinštalujú. Model úložiska In-Memory a integračné prostredie nastavíte v konfigurácii klienta:
- v aplikácii Portos eKasa Servis (Windows), ktorá nastavenia uloží do súboru. Vaša aplikácia ho potom načíta, ako popisuje Konfigurácia,
- alebo priamo v kóde:
var configuration = new ClientConfiguration
{
Storage = new StorageConfiguration { StorageModel = StorageModel.InMemory },
EKasaClient = new EKasaClientConfiguration { Environment = EKasaEnvironment.Playground }
};
var client = new Client(configuration);
In-Memory úložisko má inicializačný balík už vložený, nič ďalšie netreba. K počítaču nepripájate úložisko ani tlačiareň. Údaje drží len v pamäti, takže reštartom služby alebo vašej aplikácie sa všetky zaregistrované doklady vymažú.
3. Pošlite prvý doklad
Zaregistrujte doklad podľa článku Registrácia dokladu. In-Memory úložisko ho namiesto tlače uloží ako PDF súbor. Rovnako uloží aj nefiškálny doklad. Predvolený priečinok:
| Systém | Priečinok s PDF |
|---|---|
| Windows | C:\ProgramData\NineDigit\Portos.eKasa\receipts |
| macOS, Linux | /etc/NineDigit/Portos.eKasa/receipts |
Priečinok zmeníte vo webovom rozhraní v nastaveniach v záložke Tlač, časť Elektronický doklad, pole
Výstupný adresár. Pri .NET knižnici je to vlastnosť Printers.Pdf.OutputDirectory v konfigurácii klienta.
Vzhľad PDF je takmer totožný s papierovým dokladom, preto si na ňom overíte aj rozloženie vlastných textov.
Na platobnom termináli s Androidom In-Memory úložisko netlačí do PDF, ale na vstavanú tlačiareň terminálu.
Či doklad prijal systém eKasa, overíte na stránke finančnej správy pre integračné prostredie iekasa.financnasprava.sk/opd, napríklad naskenovaním QR kódu z dokladu.
Test so skutočným úložiskom a tlačiarňou
Pred nasadením integráciu vyskúšajte so skutočným úložiskom CHDÚ a tlačiarňou. Až tak overíte papierovú tlač a situácie, ktoré In-Memory nenasimuluje, napríklad chýbajúci papier alebo otvorený kryt tlačiarne.
- Zapojte hardvér Úložisko pripojte k počítaču alebo tabletu a tlačiareň k úložisku, nie priamo k počítaču (pozri Úložisko a zostavy). Vo Windows sa úložisko musí v Správcovi zariadení zobraziť ako COM port, inak doinštalujte ovládač USB.
- Zvoľte model úložiska Vo webovom rozhraní služby alebo v konfigurácii klienta (.NET) podľa pripojeného CHDÚ.
- Vložte inicializačný balík Do úložiska vložte integračný inicializačný balík, postup je nižšie.
Ako sa pri ktorom úložisku tlačí:
| Úložisko | Výsledok tlače |
|---|---|
| In-Memory | doklady aj nefiškálne doklady do PDF (na termináli na vstavanú tlačiareň) |
| CHDÚ s inicializačným balíkom | doklady aj nefiškálne doklady na tlačiareň |
| CHDÚ bez inicializačného balíka | len nefiškálne doklady na tlačiareň |
Bez inicializačného balíka teda vytlačíte aspoň nefiškálny doklad, čo stačí na overenie pripojenia tlačiarne.
Inicializačný balík
Inicializačný balík sú údaje podnikateľa, ktoré eKasa potrebuje na registráciu dokladov:
- identifikačné údaje: XML súbor s údajmi podnikateľa, napríklad názov, adresa sídla a prevádzky,
- autentifikačné údaje: XML súbor s podpisovým certifikátom, ktorým eKasa podpisuje doklady, a heslo k nemu. Platia 2 roky, potom si ich podnikateľ znova stiahne z eKasa zóny na webe finančnej správy.
Vložením balíka sa úložisko natrvalo zviaže s prostredím. Úložisko s integračným balíkom (takzvané vývojárske úložisko) zostane navždy len pre integračné prostredie. Úložisko s produkčným balíkom sa navždy zviaže s daným podnikateľom a produkčným prostredím.
Integračný balík s údajmi fiktívneho podnikateľa si stiahnete ako ekasa-integracny-balik.zip. Obsahuje všetky tri sady integračného prostredia (pozri nižšie), každú ako dva XML súbory. Pre vývojárske úložiská sú všetky funkcie eKasy bezplatné.
Balík vložíte vo webovom rozhraní služby: v menu Subjekty kliknite na Nový subjekt, pretiahnite do okna oba XML súbory jednej sady, ako heslo zadajte kód pokladnice a uložte. Pri .NET knižnici použijete aplikáciu Portos eKasa Servis alebo vlastné rozhranie.
Produkčný balík si zabezpečuje sám podnikateľ, teda váš zákazník, alebo vy, ak pokladnicu vyvíjate pre vlastnú prevádzku. Postup:
- V osobnej internetovej zóne na portáli finančnej správy podá žiadosť o pridelenie kódu pokladnice eKasa.
- Daňový úrad pridelí kód pokladnice a v eKasa zóne sprístupní inicializačný balík.
- Podnikateľ si balík stiahne. Výsledkom sú dva XML súbory a heslo, ktoré si zvolí pri sťahovaní.
- Balík vloží do eKasy pred prvým použitím pokladnice.
Celý postup ukazuje oficiálny videonávod finančnej správy:
Krok za krokom s obrázkami ho popisuje aj návod Nová on-line pokladnica v dokumentácii Portos. Podrobnosti nájdete na stránkach podpory finančnej správy: Pridelenie kódu pokladnici eKasa a eKasa zóna na portáli FS.
Kódy pokladníc integračného prostredia
Finančná správa poskytuje pre integračné prostredie tieto sady identifikačných a autentifikačných údajov:
| Sada | Kód pokladnice | DIČ |
|---|---|---|
| č. 1 | 88812345678900001 |
1234567890 |
| č. 2 | 88812345604850001 |
1029867938 |
| č. 3 | 88812345606470001 |
1029867938 |
Heslo k autentifikačným údajom je zhodné s kódom pokladnice.
Úložisko je viazané na jedno DIČ. Do jedného úložiska preto môžete vložiť sadu č. 1, do druhého sadu č. 2 alebo č. 3.
Prostredie (integračné alebo produkčné) eKasa určuje automaticky podľa kódu pokladnice: kódy začínajúce na
888123456 patria integračnému prostrediu, ostatné produkčnému. Sady č. 2 a 3 rozpoznáva eKasa od verzie 8.0.1,
staršie verzie len sadu č. 1.
Android: inštalácia a diagnostika
Demo verziu pre Android nainštalujete aj cez adb z počítača, ku ktorému je zariadenie pripojené USB káblom:
# zoznam pripojených zariadení
adb devices
# inštalácia a odinštalovanie (ID zariadenia zo zoznamu)
adb -s <ID> install <stiahnutý-súbor>.apk
adb -s <ID> uninstall com.ninedigit.ekasa.android
Logy eKasy stiahnete na Androide aj na počítači ako ZIP súbor. Vo webovom rozhraní je to v menu Systém → Údržba, riadok Súbory denníka, tlačidlo Archivovať. Rovnaký súbor vráti aj API:
GET {server_address}/api/v1/logs
Ak hľadáte chybu, priložte tento súbor k otázke na našu podporu. Pri .NET knižnici zapisuje logy vaša aplikácia, pozri Logovanie.