Propojení MIKISI s Pohodou

Kompletní návod pro nastavení mServeru a MIKISI Agenta

Jak to funguje

MIKISI Agent je malá aplikace, která běží na vašem počítači vedle Pohody. Vytváří bezpečný tunel mezi MIKISI a vaším mServerem.

MIKISI (cloud) Váš počítač │ │ │◄─── šifrované spojení ──────────►│ MIKISI Agent │ │ │ │ │ ▼ │ │ Pohoda mServer │ │ │ │ │ ▼ │ │ Pohoda databáze

Postup:

  1. Kliknete v MIKISI na tlačítko "Do Pohody"
  2. MIKISI pošle doklad přes agenta do mServeru
  3. mServer ho importuje do Pohody
  4. Hotovo – doklad je v Pohodě

Požadavky

💻 Windows 10 nebo novější
📊 Pohoda s mServerem (součást standardní instalace)
🌐 Internetové připojení
👤 MIKISI účet s účetní jednotkou

Krok 1: Aktivace mServeru v Pohodě

Nejprve je potřeba zapnout mServer v programu Pohoda.

1.1 Otevření správce mServeru

1

Spusťte Pohodu

Otevřete program Pohoda jako obvykle.

2

Otevřete mServer

V menu vyberte: Účetní jednotka → Databáze → POHODA mServer

3

Vytvořte konfiguraci

Klikněte na tlačítko "Nový" a vyplňte:

  • Název: např. "MIKISI"
  • Účetní jednotka: vyberte vaši jednotku
  • Port: zadejte 444 (výchozí port pro mServer)
💡
Proč port 444? Je to výchozí port pro Pohoda mServer. Pole může být prázdné při prvním nastavení – zadejte 444. Pokud je port 444 obsazený, použijte jiné číslo (např. 8080) a stejné zadejte v MIKISI.
💡
Tip: Záložka HTTPS umožňuje šifrované spojení, ale pro lokální použití není nutná. Záložka Monitoring aktivuje logování pro diagnostiku.

Zdroj: Dokumentace Stormware

Krok 2: Spuštění mServeru

Manuální spuštění

V dialogu "Správce POHODA mServer" vyberte vaši konfiguraci a klikněte na "Spustit" (nebo dvakrát klikněte na řádek).

Otevře se monitorovací okno – mServer naslouchá na nastaveném portu.

Spuštění přes příkazový řádek

Pohoda.exe /HTTP start "MIKISI"

Další užitečné příkazy:

Pohoda.exe /HTTP stop "MIKISI"      # Zastavení
Pohoda.exe /HTTP restart "MIKISI"   # Restart
Pohoda.exe /HTTP list               # Seznam konfigurací

Automatické spuštění

Pro automatické spuštění po startu Windows můžete použít Plánovač úloh Windows.

⚠️
Důležité z dokumentace Stormware:
  • mServer si vyhradí jednu instanci Pohody pro svoji komunikaci
  • Pro současnou ruční práci v Pohodě musíte spustit druhou instanci programu
  • Běh mServeru jako Windows služba není doporučen

Zdroj: Dokumentace Stormware

Krok 3: Ověření funkčnosti mServeru

Otevřete webový prohlížeč a zadejte adresu:

http://localhost:444/status

Pokud jste použili jiný port než 444, upravte číslo v adrese.

✅
Úspěch: Měli byste vidět XML odpověď se statusem serveru. To znamená, že mServer běží správně.

Pro detailní status s informacemi o firmě (vyžaduje přihlášení):

http://localhost:444/status?companyDetail

Zdroj: Dokumentace Stormware

Krok 4: Instalace MIKISI Agenta

Stáhněte MIKISI Agent pro Windows

Stáhnout mikisi-agent.exe

První spuštění

1

Spusťte agenta

Dvakrát klikněte na stažený soubor mikisi-agent.exe

2

Zadejte API klíč

Zobrazí se dialog pro zadání API klíče. Klíč získáte v MIKISI: Nastavení → vaše účetní jednotka → MIKISI Agent → Vygenerovat API klíč

3

Kontrola připojení

V system tray (u hodin vpravo dole) se objeví ikona MIKISI:

  • 🟢 Zelená = připojeno k MIKISI
  • 🔴 Červená = odpojeno (zkontrolujte API klíč nebo internet)
💡
Agent se při prvním úspěšném nastavení automaticky přidá do spouštění při startu Windows. Toto můžete změnit pravým klikem na ikonu v system tray.

Krok 5: Nastavení v MIKISI

V MIKISI přejděte na Nastavení → vaše účetní jednotka → mServer a vyplňte:

Pole Hodnota Poznámka
Host localhost Nebo IP adresa, pokud mServer běží na jiném PC v síti
Port 444 Výchozí port mServeru (nebo jiný, pokud jste ho změnili)
Uživatel (z Pohody) Uživatel s přístupem k mServeru
Heslo (z Pohody) Heslo daného uživatele
HTTPS Ne/Ano Podle nastavení v Pohodě (krok 1)

Test spojení

Klikněte na tlačítko "Test spojení". Při úspěchu se zobrazí zelená zpráva.

💡
Přihlašovací údaje musí odpovídat uživateli v Pohodě, který má oprávnění pro práci s mServerem.

Krok 6: Odesílání dokladů

1

Otevřete doklad v MIKISI

Fakturu, příjemku nebo jiný doklad, který chcete odeslat.

2

Klikněte "Do Pohody"

Doklad se odešle přes agenta do mServeru.

3

Hotovo!

Po úspěšném importu se zobrazí číslo dokladu z Pohody.

🎉
Gratulujeme! Propojení je kompletní. Všechny vaše doklady z MIKISI můžete nyní odesílat přímo do Pohody.

Řešení problémů

Agent hlásí "Připojení selhalo"

  • Zkontrolujte internetové připojení
  • Ověřte platnost API klíče v MIKISI nastavení
  • Firewall může blokovat odchozí spojení na port 443

"mServer není spuštěný" (chyba 503)

  • Spusťte mServer v Pohodě
  • Ověřte že port v MIKISI odpovídá portu v nastavení mServeru
  • Zkontrolujte že běží správná konfigurace mServeru

"Neplatné přihlašovací údaje" (chyba 401/403)

  • Zkontrolujte uživatelské jméno a heslo
  • Ověřte že uživatel má v Pohodě práva pro mServer
  • Zkuste se přihlásit přímo v Pohodě tímto uživatelem

Agent v tray má červenou ikonu

  • Pravý klik na ikonu zobrazí chybovou hlášku
  • Nejčastější příčiny: neplatný API klíč, výpadek internetu, firewall

Běží více instancí agenta

Od verze 1.3 agent automaticky detekuje běžící instanci. Pokud spustíte druhého agenta, zobrazí se hláška a ukončí se.

Více účetních jednotek

Pokud účtujete pro více firem (účetních jednotek), můžete je všechny propojit s jedním MIKISI Agentem.

Postup nastavení

  1. V každé jednotce v Pohodě aktivujte mServer (Nastavení → Síťový přístup)
  2. V MIKISI pro každou účetní jednotku:
    • Nastavení → vyberte jednotku → sekce mServer → vyplňte přístupové údaje
    • Sekce MIKISI Agent → Vygenerovat API klíč
  3. V agentovi přidejte všechny API klíče:
    • Klikněte pravým tlačítkem na ikonu agenta v system tray
    • Vyberte "Přidat API klíč"
    • Zadejte API klíč další jednotky
    • Opakujte pro všechny jednotky
💡 Tip: V nabídce agenta (pravé tlačítko na ikonu) vidíte seznam všech připojených jednotek a jejich stav.

Různé scénáře

Scénář Řešení
Více jednotek, jeden mServer Všechny jednotky sdílejí stejnou adresu mServeru (localhost:444)
Každá jednotka má vlastní mServer V MIKISI nastavte pro každou jednotku jiný port nebo IP adresu
mServer na síťovém serveru Agent běží na libovolném PC, mServer adresa = IP serveru

Časté otázky

Musí agent běžet neustále?
Agent musí běžet pouze ve chvíli, kdy chcete odesílat dokumenty do Pohody. Při prvním nastavení se automaticky přidá do spouštění při startu Windows.
Je to bezpečné?
Ano. Komunikace mezi agentem a MIKISI je šifrovaná (WSS/TLS). Přihlašovací údaje k Pohodě se nikde neukládají na straně agenta – posílají se jednorázově pro každý požadavek.
Mohu použít agenta na více počítačích?
Každá účetní jednotka může mít připojeného pouze jednoho agenta. Pokud spustíte agenta na jiném počítači se stejným API klíčem, původní spojení se ukončí.
Kde najdu API klíč?
V MIKISI: Nastavení → vyberte účetní jednotku → sekce "MIKISI Agent" → klikněte na "Vygenerovat API klíč".
Musí mServer běžet na stejném PC jako agent?
Ne, mServer může běžet na jiném počítači v síti. V tom případě v MIKISI nastavení zadejte místo localhost IP adresu počítače s mServerem.
Jak nastavím více účetních jednotek?
Jeden agent může obsluhovat více jednotek. Pro každou jednotku vygenerujte v MIKISI samostatný API klíč a v agentovi ho přidejte přes menu (pravé tlačítko na ikonu → Přidat API klíč). Podrobný návod najdete v sekci Více účetních jednotek.

Další dokumentace

Oficiální dokumentace Stormware k mServeru:

Potřebujete pomoc?

Kontaktujte nás na [email protected]