# Príprava prostredia

> Ako rozbehnúť eKasu na vývoj: integračné prostredie, In-Memory úložisko bez hardvéru, test so skutočným úložiskom a tlačiarňou, inicializačný balík a Android.

Zdroj: https://ekasa.ninedigit.sk/docs/environment-setup

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

- [HTTP API](https://ekasa.ninedigit.sk/na-prevzatie): Služba pre Windows, macOS a Linux, alebo demo verzia pre Android.
- [.NET knižnica](https://www.nuget.org/packages/NineDigit.eKasa): NuGet balík NineDigit.eKasa pridáte priamo do svojho projektu.

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

**HTTP API:**

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é**.

**.NET knižnica:**

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](https://ekasa.ninedigit.sk/docs/dotnet/configuration),
- alebo priamo v kóde:

```csharp
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](https://ekasa.ninedigit.sk/docs/receipt-registration). In-Memory úložisko ho namiesto
tlače uloží ako PDF súbor. Rovnako uloží aj [nefiškálny doklad](https://ekasa.ninedigit.sk/docs/nonfiscal-receipt). 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](https://iekasa.financnasprava.sk/opd/#!/check), 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](https://ekasa.ninedigit.sk/docs/storage-and-hardware)). Vo Windows sa úložisko musí v Správcovi zariadení
   zobraziť ako COM port, inak doinštalujte [ovládač USB](https://ekasa.ninedigit.sk/docs/storage-and-hardware#ovladac-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](https://ekasa.ninedigit.sk/docs/nonfiscal-receipt), č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](https://ekasa.ninedigit.sk/files/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:

[Video: Návod, ako si aktivovať novú eKasu (Finančná správa, 2:13)](https://www.youtube.com/watch?v=6g3hSudohPU)

Krok za krokom s obrázkami ho popisuje aj návod [Nová on-line pokladnica](https://docs.portos.sk/ekasa/nova-on-line-pokladnica)
v dokumentácii Portos. Podrobnosti nájdete na stránkach podpory finančnej správy:
[Pridelenie kódu pokladnici eKasa](https://podpora.financnasprava.sk/579037-Pridelenie-k%C3%B3du-pokladnici-eKasa)
a [eKasa zóna na portáli FS](https://podpora.financnasprava.sk/776739-eKasa--z%C3%B3na-na-port%C3%A1li-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](https://developer.android.com/tools/adb) z počítača,
ku ktorému je zariadenie pripojené USB káblom:

```bash
# 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:

```http
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](https://ekasa.ninedigit.sk/docs/dotnet/logging).

## Kam ďalej

- [HTTP API](https://ekasa.ninedigit.sk/docs/rest-api): Požiadavky, inštalácia služby a prvé volanie.
- [Registrácia dokladu](https://ekasa.ninedigit.sk/docs/receipt-registration): Typy dokladov, položky, platby a výsledok.
- [Pred nasadením](https://ekasa.ninedigit.sk/docs/go-live-checklist): Kontrolný zoznam pred ostrou prevádzkou.
