Príprava prostredia
Predtým, ako začnete s vývojom, je potrebné nastaviť eKasa prostredie.
1. Stiahnite si eKasa aplikáciu
- V prípade, ak integrujete eKasa cez webové API rozhranie, stiahnite si najnovšiu verziu API služby z oficiálneho webu ekasa.ninedigit.sk.
- V prípade, ak integrujete eKasu cez .NET knižnicu, knižnicu stiahnete z webu nuget.org.
2. Pripojte úložisko
K počítaču pripojte chránené dátové úložisko.
Tip
V prípade, ak ešte fyzické úložisko nemáte zaobstarané, v nastaveniach aplikácie môžete zvoliť tzv. "in memory úložisko". Ide o fiktívne úložisko určené pre účely vývoja bez nutnosti mať k počítaču pripojené skutočné CHDÚ.
Pred skutočným nasadením dôrazne odporúčame otestovať integráciu so skutočným - hardvérovým chráneným dátovým úložiskom.
3. Vložte inicializačný balík
Pre spojazdnenie eKasy je potrebné do úložiska nahrať dvojicu XML súborov - identifikačné a autentifikačné údaje, ktoré spoločne označujeme ako inicializačný balík.
Inicializačný balík teda obsahuje:
- Identifikačné údaje: XML súbor obsahujúci údaje podnikateľa, ako napríklad názov spoločnosti, adresu sídla či adresu prevádzky.
- Autentifikačné údaje: XML súbor obsahujúci podpisový certifikát podnikateľa, ktorý eKasa aplikácia používa pri podpisovaní dokladov. Majú trvácnosť 2 roky, preto je ich potrebné pravideľne nanovo sťahovať z eKasa zóny dostupnej na webe finančnej správy.
V prípade, ak si želáte používať úložisko výhradne na vývojárske účely, je vhodné použiť takzvaný Integračný inicializačný balík, ktorý obsahuje údaje fiktívneho podnikateľského subjektu.
Ak do úložiska vložíte integračný inicializačný balík, teda XML údaje určené pre integračné prostredie, úložisko bude trvalo určené výhradne pre integračné prostredie systému eKasa. Analogicky, ak do úložiska vložíte produkčný inicializačný balík, teda XML súbory obsahujúce údaje skutočného podnikateľského subjektu, úložisko sa navždy zviaže s týmto subjektom, a je ho možné používať výhradne na produkčnom prostredí systému eKasa.
Úložisko s vloženými integračnými XML súbormi označujeme ako vývojárske úložisko.
Inicializačný balík (XML súbory s autentifikačnými a identifikačnými údajmi) určený pre integračné (testovacie) prostredie eKasy, spolu s pokynmi na jeho vloženie nájdete v SDK balíku.
Tip
Niektoré súčasti eKasy môžu byť spoplatnené. Pre vývojárske úložiská však platí, že všetky vstavané funkcionality systému eKasa majú automaticky aktivované k dispozícii úplne bezplatne.
4. Vyvíjajte
S pripojeným a správne nakonfigurovaným úložiskom je možné začať s integráciou podľa ďalších článkov tejto dokumentácie.