====== Komunikace OTE metodika ======


=== Obecné ===

Komunikace systému **Helios iNuvio ENERGO** s **Portálem OTE** je prostřednictvím programu **Klient OTE**.\\

Systém Helios iNuvio ENERGO vytváří datové zprávy ve formátu **XML** z dat obsažených v Helios iNuvio ENERGO a zpracovává (zapisuje) doručené **XML** zprávy do Helios iNuvio ENERGO.\\

Program **Klient OTE** odesílá **XML** zprávy vytvořené v **Helios iNuvio ENERGO** na Portál OTE a přijímá **XML** zprávy z Portálu OTE pomoci **SMTP kanálu**.\\

Program **Klient OTE** slouží ke komunikaci s portálem OTE na základě emailových zpráv.\\

=== Scénáře komunikace ===

[[http://www.ote-cr.cz/|OTE, a.s]] (správce Portálu OTE) definuje jednotlivé scénáře komunikace s Portálem OTE. Scénář definuje způsob komunikace s Portálem OTE pro řešení určité situace.\\ 

Scénáře obsahují jednotlivé datové zprávy a jejich popis, funkce a zpracování.\\ 

==== Zprávy OTE v ENERGO ====

Zprávy v přehledu //Energo-komunikace OTE / Zprávy OTE// jsou z pohledu uživatele rozděleny na dvě základní skupiny:
  * **Odeslání**
  * **Příjem**  
V přehledu **Zpráv OTE**((Energo – Komunikace OTE / Zprávy OTE)) je zobrazen sloupec **Směr zprávy**. Ten je určující zda jde o zprávu k **odeslání** nebo **příjem**. 

==== Odeslání ====

V přehledu **Zpráv OTE**((Energo – Komunikace OTE / Zprávy OTE)) je zobrazen sloupec **Stav odeslání**, popř. si ho uživatel může přidat do sestavy přes funkci **Nastav**.
\\
++++ Zobraz zprávy k odeslání | 
 {{:napoveda2:komunikace_ote:stav_odeslani.png?1000}}
++++
\\
U zpráv, které mají **Směr zprávy = odeslání** existují tyto **Stavy odeslání**:
  * vygenerováno,
  * uloženo na disk (odesílá se…),
  * pro EDI zprávy typu CONTRL – syntaktické chyby,
  * odmítnutí aplikací,
  * přijetí bez výhrad,
  * přijetí s výhradou.

Stavy se nastavují automaticky. Při vygenerování zprávy se zpráva vytvoří ve stavu **Vygenerováno**. Po spuštění akce **Uložení zprávy**((Energo – Komunikace OTE / Zprávy OTE / Doplňky / Akce pro zprávy / Uložení zprávy)) se přepne do stavu **Uloženo na disk (odesílá se…)**. Stav se zobrazí po stisku tlačítka **Obnovit F5**. Následně přijde z OTE zpráva //RESPONSE// s informací o přijetí, popř. odmítnutí zprávy, která obsahuje informaci typu **A01**, **A02**, **A03** nebo **A04**.
\\
++++ Zobraz tělo zprávy |
 {{:napoveda2:komunikace_ote:kod_duvodu.png?800}}
++++
\\
Systém podle **ID reference** vyhledá odeslanou zprávu a nastaví ji stav podle typu informace ve zprávě //RESPONSE//. Pro typ:
  * A01 = pro EDI zprávy typu CONTRL – syntaktické chyby,
  * A02 = odmítnutí aplikací,
  * A03 = přijetí bez výhrad,
  * A04 = přijetí s výhradou.

Pokud zpráva obsahuje více informací různých typů, nastaví se stav podle nejvyšší z nich.\\

=== Postup při odeslání zprávy === 

1.	HeO ((Helios iNuvio ENERGO)) - vytvoření dotazu – ručně uživatel pomoci volby z menu **Doplňky** v příslušném přehledu.\\
2.	HeO - vygenerování XML zprávy – ručně uživatel pomoci volby z menu **Doplňky / Zprávy OTE / Generovat zprávy OTE** v příslušném přehledu.\\
3.	HeO - uložení XML zprávy do adresáře **Klienta OTE** Smime_mail/XmlOut – ručně uživatel pomoci volby z menu **Doplňky / Akce pro zprávy / Uložení zprávy** v přehledu //Zprávy OTE//.\\

4.	KlOTE ((Klient OTE)) - příkaz smime_mail –c.\\ 
Vezme zprávu z XmlOUT, zkompiluje a uloží zprávu do OUT. Vstupní soubor přesune do XmlSENT – provede automaticky naplánovaná úloha.\\
5.	KlOTE - příkaz smime_mail –s.\\
Odešle zprávu z OUT XmlSENT na portál OTE a vstupní soubor přesune z XmlSENT do SENT – provede automaticky naplánovaná úloha.\\

==== Příjem ====

V přehledu **Zpráv OTE**((Energo – Komunikace OTE / Zprávy OTE)) je zobrazen sloupec **Stav příjmu**, popř. si ho uživatel může přidat do sestavy přes funkci **Nastav**.

++++ Zobraz přijaté zprávy | 
 {{:napoveda2:komunikace_ote:ote1.png?1050|}}
++++

U zpráv, které mají **Směr zprávy = příjem** existují tyto **Stavy příjmu**:
  * přijato,
  * převedeno,
  * nepřevedeno.
  
**Přijato** - zpráva byla načtena do Helios iNuvio ENERGO a nebyl dále zpracována.
**Převedeno** - data obsažená ve zprávě byla zapsána do datové struktury ENERGO.
**Nepřevedeno** - zpráva nebyla převedena, důvodem většinou bývá nepovolení zpracovávaného druhu zprávy pro konkrétní Licenci Energo.

Stavy se nastavují automaticky.\\

=== Postup při příjmu zprávy ===

1.	KlOTE - příkaz smime_mail -r.\\
Načte zprávy z portálu OTE (emailové schránky) a uloží do IN. Odmitnute zpravy přepošle správci – provede automaticky naplánovaná úloha.\\
2.	KlOTE - příkaz smime_mail –p.\\
Rozšifruje zprávu (dešifruje, ověří podpis), XML část uloží do XmlIN, vstupní soubor přesune do XmlINarch. Odmítnuté zprávy přepošle správci  – provede automaticky naplánovaná úloha.\\

3.	HeI - načte zprávy z XmlIN - provede automaticky naplánovaná úloha.\\
4.	HeI - zpracuje načtené zprávy a zapíše j.e do struktury HeO – provede automaticky naplánovaná úloha.\\