Príprava prostredia

Integrujem cez

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:

  1. v záložke Úložisko zvoľte Model úložiska: In-Memory,
  2. 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.

  1. 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.
  2. Zvoľte model úložiska Vo webovom rozhraní služby alebo v konfigurácii klienta (.NET) podľa pripojeného CHDÚ.
  3. 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:

  1. V osobnej internetovej zóne na portáli finančnej správy podá žiadosť o pridelenie kódu pokladnice eKasa.
  2. Daňový úrad pridelí kód pokladnice a v eKasa zóne sprístupní inicializačný balík.
  3. Podnikateľ si balík stiahne. Výsledkom sú dva XML súbory a heslo, ktoré si zvolí pri sťahovaní.
  4. 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.

Kam ďalej

Esc

↑↓ výberEnter otvoriťEsc zavrieť

Chýba vám niečo v dokumentácii?

Napíšte nám, s čím potrebujete pomôcť. Ozveme sa do pár hodín.

Údaje použijeme len na odpoveď. Viac v ochrane osobných údajov.