Přeskočit obsah

Pohoda

Nastavení Redque můstku pro použití s Stormware Pohoda

Redque můstek pro systém Pohoda

Instalační postup pro Redque můstek

Redque můstek ke stažení ZDE

Jak to funguje?

Po spuštění synchronizace (ručně/automaticky) můstek zkontroluje dostupné dokumenty ve stavu state-ready-to-export.png. Jakmile je dokument připraven, můstek načte IČO dokumentu, na jehož základě spustí POHODA mServer pro danou účetní jednotku. Dokument(y) do POHODA naimportuje a mServer ukončí. Tento proces pak opakuje pro všechny další dokumenty z jiných ÚJ ve frontě.

Podporované funkce

Podporovaná funkcionalita pro POHODA

Konfigurace

Požadavky

  • Základní konfigurace můstku
    • Pokud jste zatím neprovedli instalaci a základní konfiguraci můstku, postupujte podle návodu zde.
  • Webová aplikace
    • Účetní jednotky
      • V Alice si připravte všechny účetní jednotky, které budete chtít zpracovávat v Pohodě podle návodu zde.
  • Počítač/Server, na kterém máte nainstalovaný můstek
    • Lokální nebo síťová dostupnost (Síťový klient) spouštěcího souboru Pohody (Pohoda.exe) 
- **POHODA**
    - **Licenční**
        - 1 licence Pohody. **Při provozu se mServer počítá jako 1 připojený uživatel.** Více [zde](#pohoda-mservery)
    - **Konfigurace** (součást tototo návodu)
        - mServery: nakonfigurované [POHODA mServery](#pohoda-mservery) pro všechny používané účetní jednotky
        - Uživatel: [uživatel s příslušným oprávněním](#uzivatel-v-pohode), skrz kterého bude můstek pracovat
        - Dokumenty do Pohody: pokud plánujete [přenášet dokumenty do Pohody](#prenos-kopie-puvodniho-dokladu-do-pohoda), je vyžadováno dodatečné nastavení v rámci SQL databáze Pohody

Konfigurace Pohody

POHODA mServery

mServer: Licence

Spuštěný POHODA mServer vyžaduje jednu licenci Pohody a počítá se jako 1 připojený uživatel. Pod jednou licencí může běžet neomezené množství mServerů. Pokud máte pouze jednu licenci, doporučujeme přikoupit další, nebo používat můstek v době, kdy nepoužíváte Pohodu, jinak synchronizace nebude fungovat správně.

Nastavení mServerů najdete v programu Pohoda v Soubor > Účetní jednotky (Ctrl + U ) > Databáze > POHODA mServer. Přes tlačítko Nový... je dále nutné přidat mServery pro jednotlivé účetní jednotky. Nastavení mServerů proveďte dle dokumentace Pohody. Výsledné nastavení mServeru, které je dostačující pro můstek, může vypadat např. takto:

  1. Název: popis pro snadné odlišení mServeru
  2. Popis: není povinný
  3. Účetní jednotka: aktuální ÚJ pro daný rok
  4. Logovací nastavení: ponechat výchozí

Screenshot

mServer - Konfigurace

POHODA mServer je zapotřebí vytvořit pro každou účetní jednotku, se kterou chcete můstek využívat. Tento proces nelze provést hromadně, nebo automatizovat, tudíž všechny mServery musíte vytvořit ručně.

Jelikož se mServery můstkem spouštějí postupně, můžete je všechny navázat na jeden port (např. výchozí 444). Pokud plánujete provozovat mServery na dalších portech, nepoužívejte již obsazené porty, jako např. port 445 (k čemuž by posloupnost mohla navádět), jelikož ho již používá systém Windows pro své služby.

Uživatel v Pohodě

Před vytvořením uživatele si prosím přečtěte sekci Oprávnění, která vám pomůže rozhodnout, zda budete chtít vytvářet nového uživatele, nebo použijete již existujícího. Pokud se rozhodnete pro jeho tvorbu, pokračujte dle návodu Konfigurace uživatele s omezeným oprávněním.

Důležité nastavení

Volba uživatele je velmi důležitá, protože při komunikaci s Pohodou se používá nastavení daného uživatele, tzn. přístupová práva, výchozí hodnoty a primárně pak účetní roky v daných účetních jednotkách. Toto nastavení ovlivňuje také např. synchronizaci číselníků.

Příklad: Vliv nastavení uživatele na komunikaci s Pohodou

Pokud se rozhodnete v můstku použít separátního uživatele, můžete se setkat např. s problémy při účtování na přelomu roku v případě, kdy je nový uživatel definovaný v můstku pro danou účetní jednotku v roce 2024, zatímco účet, pod kterým do Pohody přistupujete Vy, je již přepnutý do režimu "Účtování na přelomu roku" (tedy 2024p). Pokud přes můstek a takového uživatele synchronizujete dokumenty, budou zaúčtovány do roku 2024, protože uživatel definovaný v můstku je v tomto roce. Pod uživatelem definovaným v můstku je tedy třeba se přepnout v dané účetní jednotce do požadovaného období.

Oprávnění

V závislosti na bezpečnostních požadavcích vaší společnosti můžete k oprávněním přiřazeným uživateli pro můstek přistupovat několika způsoby, přičemž každý z nich má své výhody a nevýhody:

Možnost Oprávnění Pozn. | Výhody | Nevýhody
Nový uživatel s omezenými globálními právy Ručně nastavená podle návodu níže pouze na využívané agendy metoda snadnější na údržbu, s dostatkem zabezpečení.
Výhody: Uživatel vidí a má oprávnění pouze k prostředkům, které opravdu potřebuje. Při přidání nových ÚJ není potřeba přidávat práva
Nevýhody: Vzhledem ke globálním oprávněním uživatel uvidí všechny ÚJ (včetně uzavřených nebo v Alici nevyužívaných). Toto však není problém, protože můstek bude komunikovat jen s jednotkami, pro které je vydefinovaný mServer.
Potenciálně problematický přelom účetního roku.
K synchronizaci číselníků je zapotřebí využít jiného uživatele nebo dočasně zvýšit práva.
Nový uživatel s omezenými právy pouze na definované ÚJ Ručně nastavená podle návodu níže pouze na využívané agendy a určité ÚJ Nejbezpečenější metoda vyžadující více administrace
Výhody: Zabezpečení. Uživatel opravdu vidí a má oprávnění pouze k prostředkům a ÚJ, které potřebuje.
Nevýhody: Náročnější administrace. Při vzniku nových účetních jednotek je zapotřebí dodatečně přidat oprávnění. Při úpravě již existujích práv je nutné aktualizovat práva na všech aktivních přiřazených ÚJ.
Potenciálně problematický přelom účetního roku.
K synchronizaci číselníků je potřeba využít jiného uživatele nebo dočasně zvýšit práva.
Nejčastější | Stávající uživatel nebo Admin Dle daného uživatele Vhodné např. pro jednotlivce nebo menší firmy.
Výhody: Není potřeba definovat žádná další speciální nastavení za předpokladu, že stávající uživatel splňuje požadavky níže, nebo je Admin. Na přelomu účetního roku lze snáz přecházet mezi roky, protože se rok nemusí přenastavovat na separátním uživateli.
Nevýhody: Potenciální přebytek oprávnění.
Konfigurace uživatele s omezeným oprávněním

Pokud jste si zvolili možnost uživatele s omezeným oprávněním, postupujte dle návodu níže.

  1. V Pohodě zvolte účetní jednotku a přejděte do správy uživatelů: Nastavení > Přístupová práva > Uživatelé (Ctrl + Shift + U)
  2. V seznamu uživatelů zvolte poslední volné pole a vytvořte účet pro můstek s následujícím nastavením:
    pohoda-user.jpgpohoda
  3. Změňte heslo a pokračujte do sekce Práva

Upravte oprávnění následovně:

  1. Zvolte hlavní Práva a zvolte žádná práva, tímto odeberete veškerá oprávnění a můžete přidat jen požadovaná. Screenshot

  2. Přidejte následující oprávnění:

    Agenda Kategorie Oprávnění Účel
    Soubor Účetní jednotky Čtení Možnost zobrazení/čtení požadovaných ÚJ
    Databáze XML komunikace Dodatečný požadavek pro provoz mServeru
    Účetnictví Pokladna Zápis a modifikace všech Možnost nahrávání dokladů
    Ostaní Přelom roku Umožňuje uživatele přechod do účtování na přelomu roku
    Fakturace Vydané faktury Zápis a modifikace všech Možnost nahrávání dokladů
    Přijaté faktury Zápis a modifikace všech Možnost nahrávání dokladů
    Přijaté zálohové faktury Zápis a modifikace všech Možnost nahrávání dokladů
    Ostatní závazky Zápis a modifikace všech Možnost nahrávání dokladů
    Administrátorské funkce POHODA mServer Import dokumentů Oprávnění komunikovat přes mServer

  3. Finální oprávnění by pak měla vypadat takto:
    pohoda-user-access.jpg

  4. Pokud chcete nastavit přístup pouze k určitým ÚJ a neponechat globální oprávnění, v levém panelu zvolte Vybrané firmy a přiřaďte uživateli přístup do všech požadovaných účetních jednotek:
    Screenshot
  5. Uživatele uložte.
  6. V tuto chvíli je uživatel připraven.

Konfigurace můstku

Nyní máme připravené všechny podklady a můžeme se pustit do konfigurace samotného můstku. Dle prvotní konfigurace vytvořte nový export pro Pohodu.

Otevře se vám následující okno:
connector-pohoda-empty.jpg

Výchozí konfigurace

Pokud chcete můstek používat pouze k přenosu dokumentů do Pohody, je nutné provést konfiguraci pouze v sekcích Nastavení Exportu a Nastavení POHODA:

  1. Nastavení Exportu
    1. Název: doplňte vlastní název, pod kterým se vám bude napojení v můstku zobrazovat
    2. Přiřazené ÚJ
      1. Všechny: můstek bude pracovat se všemi ÚJ dostupnými pro danou klientskou aplikaci, v případě role Zpracovatel uvidí všechny
      2. Pouze vybrané: zvolíte pouze ty ÚJ, které chcete pro daný typ exportu používat. Hodí se též při testování nebo synchronizaci číselníků jednotlivých ÚJ

  2. Nastavení POHODA

    Parametr Hodnota
    Instalační adresář Doplňte adresář, kde se nachází spouštěcí soubor POHODA (Pohoda.exe)
    Uživatelské jméno Přihlašovací jméno uživatele, kterého jste se rozhodli používat pro můstek
    Heslo Heslo k danému uživateli
    Kontrola duplicit při importu dokladů Po zaškurtnutí se zapne kontrola duplicit v Pohodě. Pokud se pokusíte nahrát již existující dokument, import selže a v Alici najdete dokument ve stavu state-error.png s chybovou hláškou o duplicitě.

  3. Výchozí konfigurace může vypadat např. takto:
    connector-pohoda-default-config.jpg

  4. Dokumenty a přílohy

    Společeně s importovaným dokladem lze do Pohody přenést jeho původní soubor včetně příloh. Pro správný přenos je potřeba vyplnit dodatečné údaje do nastavení můstku. Správné nastavení pro připojení k SQL databázi můžete vyzkoušet tlačítkem Test:

    PohodaSettings

    Parametr Hodnota
    Ukládat originál dokumentu k importovaným dokladům Uložení a provázání souboru dokladu s Pohodou
    Ukládat přílohy dokumentu v Redque k importovaným dokladům Uložení a provázání souborů příloh exportovaného dokladu
    Složka dokumentů Pohoda Cesta ke složce, kam se soubory budou ukládat
    SQL connection string Připojeni k SQL databázi
    Jméno databáze Název databáze

  5. V tuto chvíli je můstek nastavený pro základní přenos polí z Alice do Pohody a můžete jej otestovat.

  6. V dalším kroku se dozvíte, jak můstek nakonfigurovat k přenosu kopie dokladu do sekce Dokumenty.

Přenos kopie původního dokladu do POHODA

Pokud chcete přenášet kopii původního dokladu do sekce Dokumenty v Pohodě, proveďtě požadovaná nastavení níže.

Pozor!

Toto nastavení je použitelné pouze pro SQL edice Pohody. Pro Non-SQL verze Pohody tuto funkcionalitu nepodporujeme. Alternativně můžete použít možnost Ukládání dokumentů do složky.

Požadavky

  • Povolené nastavení Dokumenty v rámci Pohody | Pro každou používanou ÚJ
    • Nastavení můžete ověřit v Pohodě:
      1. Přejděte do účetní jednotky
      2. V horní liště zvolte Nastavení > Globální nastavení (Ctrl + G)
      3. Zvolte sekci Dokumenty
      4. Nastavení by mělo vypadat takto:
        pohoda-documents-enabled.jpg
        a sekce Dokumenty by neměla zobrazovat tuto hlášku:
        pohoda-documents-settings-missing

  • SQL

    • administrátorský přístup na SQL databázový server Pohody, např. za pomoci nástroje SSMS
    • zapnutý Mixed Mode autentikace k SQL serveru
    • používání výchozího pojmenování databází Pohoda ve tvaru: StwPh_IČO_YYYY
    • žádné duplicitní DB typu: StwPh_IČO_YYYY_2 nebo StwPh_IČO_YYYY_zaloha apod.
  • Základní znalost SQL a konfigurace SQL serveru
  • Základní znalost Powershell
Postup konfigurace

  1. Na základě bezpečenostích požadavků na uživatele si vyberte jednu z možností níže:

    Možnost Popis Výhody | Nevýhody
    Nejbezpečenější Uživatel má přístup pouze tam, kam potřebuje, a nikam jinam Výhody: Maximální zabezpečení, uživatel nevidí nic než jemu přiřazené prostředky.
    Nevýhody: Adminsitrativní zátěž. S každou novu ÚJ bude nutné aplikovat oprávnění a případně jednotlivě změny. ❗Pouze pro zkušené uživatele/administrátory.
    Optimální Uživatel má obecná oprávnění na specifické tabulky. Balanc mezi zabezpečením a náročností správy Výhody: Uživatel má základní opravnění na požadované tabulky. Všechny nové ÚJ mají automaticky aplikovaná oprávnění a není tedy nutné nic konfigurovat
    Nevýhody: Delší prvotní nastavení. Menší nadbytek oprávnění.
    Bez omezení Uživatel má přístup všude Výhody: Rychlá konfigurace. U nových ani historických ÚJ není potřeba nic nastavovat.
    Nevýhody: Přebytek oprávnění včetně databázového serveru.

  2. Připojte se k serveru za pomoci nástroje SSMS pod Administrátorským účtem.

  3. Vytvořte uživatele s přístupem k SQL serveru:
    1. Možnost 1: skrz UI
      1. Klikněte pravým tlačítkem na položku Logins a zvolte New Login...
        1. V nově otevřeném dialogovém okně doplňte hodnoty.
        2. Login name: redque_connector
        3. Přepněte na možnost SQL Server authentication.
        4. Password: Vámi zvolené heslo
        5. Odškrtněte Enforce password policy.
      2. Uložte tlačítkem OK.
        sql-user.jpg
    2. Možnost 2: skrz SQL 
      # Nad databází master spusťte následující příkaz, který vytvoří uživatele s požadovaným heslem:
USE master
GO
CREATE LOGIN [redque_connector] WITH PASSWORD = 'VaseHeslo123'
GO

  4. Nastavte uživatele podle zvolené možnosti:

    Nejbezpečenější

    Tato možnost předpokládá, že uživatel ovládá SQL a má možnost si jednotlivé změny administrovat sám. Jedná se o nejbezpečnější možnost, která nastavuje oprávnění pouze na specifické příkazy a tabulky. Je nutné spravovat oprávnění na všech nových DB a případně je rozšiřovat, pokud přibude změna nebo např. nový typ dokumentu.

    Pro zápis přijaté faktury je potřeba uživateli přiřadit následující oprávnění (pro další typy dokumentů nutno rozšířit):

    Databáze Tabulka Oprávnění Pozn.
    StwPH_sys
    HttpServer SELECT Vyčtení mServerů (názvů DB) pro zápis cest dokumentů
    StwPh_IČO_YYYY Každá jedna DB, kam chceme ukládat cesty k dokumentům
    sKonfig SELECT
    FA SELECT
    sCRady SELECT
    DocDirs SELECT + INSERT Zápis cest dokumentů

    Poté pokračujte v nastavení níže.

    Optimální

    Na co si dát pozor!

    Než se pustíte do této konfigurace, doporučujeme nastavit všechny mServery, protože jejich seznam bude použit k vygenerování SQL query pro aplikaci oprávnění.
    Pokud ÚJ (databázi), která v Pohodě již existuje a kterou plánujete do budoucna používat v Alice, nezahrnete při prvotním nastavení, bude nutné na ni dodatečně aplikovat práva při jejím budoucím přidání. Doporučujeme tedy všechny ÚJ (databáze), které plánujete používat, nastavit předem, abyste v budoucnu nemuseli aplikovat oprávnění dodatečně.

    Seznam požadovaných oprávnění pro tuto možnost:

    Databáze Oprávnění Pozn.
    StwPh_sys
    db_datareader Čtení celé _sys DB kvůli budoucí rozšiřitelnosti a podpoře dalších typů dokumentů
    model Systémová DB, ze které se vytváří všechny nové DB. Pokud nastavíme oprávnění našeho uživatele na tuto DB, automaticky zajistíme můstku oprávnění na všechny nové ÚJ v dalśich letech. Tímto se vyhneme jakékoliv další administraci pro nové ÚJ. ❗ Pozor: Oprávnění se vztahuje i na všechny nově vytvořené Ne-POHODA databáze
    db_datareader Práva nemohou být aplikována na neexistující tabulku, aplikujeme je tedy na celou DB
    db_datawriter -||-
    StwPh_IČO_YYYY Všechny stávající DB, pro které jste nakonfigurovali mServer
    db_datareader Kopie oprávnění z model DB
    db_datawriter -||-

    Nastavení oprávnění

    1. Příkazem níže přiřaďte oprávnění na model DB: 

      USE [model]
GO
CREATE USER [redque_connector] FOR LOGIN [redque_connector]
GO
ALTER ROLE [db_datareader] ADD MEMBER [redque_connector]
GO
ALTER ROLE [db_datawriter] ADD MEMBER [redque_connector]
GO

    2. Příkazem níže přiřaďte oprávnění na hlavní DB Pohody: 

      USE [StwPh_sys]
GO
CREATE USER [redque_connector] FOR LOGIN [redque_connector]
GO
ALTER ROLE [db_datareader] ADD MEMBER [redque_connector]
GO

    3. Příkazem níže vypište seznam ÚJ s mServery. Tímto získáte seznam aktuálně používaných DB. 

      USE [StwPh_sys];
GO
SELECT [Firma] FROM [StwPh_sys].[dbo].[HttpServer]
GO

      1. Výsledek query by měl vrátit takovýto seznam: 

        StwPh_12345678_2024
StwPh_23456789_2024
...
StwPh_34567890_2024

      2. Seznam upravte do tvaru níže, aby mohl být použit jako hodnota proměnné v Powershellu: 

        "StwPh_12345678_2024",
"StwPh_23456789_2024",
...
"StwPh_34567890_2024"

    4. Upravený seznam dosaďte do promměnné $AccountingUnitsList níže a výsledný skript spusťte v Powershellu. (Skript můžete celý zkopírovat a spustit přímo v Powershellu.) 

      $AccountingUnitsList=
"StwPh_12345678_2024",
"StwPh_23456789_2024",
...
"StwPh_34567890_2024"

ForEach ( $AccountingUnit in $AccountingUnitsList ){

Write-Host "
-- $AccountingUnit
USE [$AccountingUnit]
GO
CREATE USER [redque_connector] FOR LOGIN [redque_connector]
GO
USE [$AccountingUnit]
GO
ALTER ROLE [db_datareader] ADD MEMBER [redque_connector]
GO
USE [$AccountingUnit]
GO
ALTER ROLE [db_datawriter] ADD MEMBER [redque_connector]
GO
"

}

    5. Spuštění skriptu vygeneruje query ve formátu níže pro všechny uvedené ÚJ. 

      -- StwPh_12345678_2024
USE [StwPh_12345678_2024]
GO
CREATE USER [redque_connector] FOR LOGIN [redque_connector]
GO
USE [StwPh_12345678_2024]
GO
ALTER ROLE [db_datareader] ADD MEMBER [redque_connector]
GO
USE [StwPh_12345678_2024]
GO
ALTER ROLE [db_datawriter] ADD MEMBER [redque_connector]
GO
...

    6. Query zkopírujte do SSMS a spusťte. Query automaticky aplikuje oprávnění na všechny požadované databáze, není tedy zapotřebí nic upravovat.

    7. Pokračujte v nastavení níže.
    Bez omezení

    Upozornění

    Uživatele nastavujete na vlastní nebezpečí. Uživatel disponuje nejvyšším oprávněním na serveru sysadmin, které je ekvivaletní výchozímu administrátorskému účtu sa, který může být pro tuto možnost též použit.

    1. V SMSS otevřte sekci Logins.
    2. Kliknětě pravým na uživatele redque_connector a zvolte Properties.
    3. V novém dialogovém okně přejděte na stránku Server Roles.
    4. Zaškrtněte možnost sysadmin.
    5. Nastavení uložte tlačítkem OK.
    6. V tuto chvíli má uživatel veškerá oprávnění k serveru a všem DB.
    7. Pokračuje v nastavení níže.

  5. Nakonfigurujte sekci Dokumenty v můstku

    1. Zaškrtněte možnost Ukládat originál dokumentu k importovaným dokladům.

    2. Doplňte hodnoty konfigurace:

      Parametr Hodnota
      Složka dokumentů POHODA Většinou se jedná o stejný adresář jako POHODA + Dokumenty, např.:
      C:\Program Files (x86)\STORMWARE\POHODA SQL\Dokumenty
      Cestu můžete ověřit dle požadavků výše.
      SQL Connection string Připojovací řetězec k vaší databázi. Je nutné připravit uživatele a provést konfiguraci DB viz výše.
      Tvar řetězce:
      Server=SERVER\INSTANCE;User ID=Uživatel;Password=Heslo
      např.
      Server=localhost;User ID=alice;Password=Password123
      Server=192.168.1.134\POHODA;User ID=Uživatel;Password=Heslo
      Server=POHODA\POHODA_SQL;User ID=Uživatel;Password=Heslo
      Jméno databáze Název výchozí databáze Pohody. Pokud nebyl upraveno při instalaci, hodnota bude: StwPh

    3. Výsledná konfigurace může vypadat např. takto:
      pohoda-connector-settings-advanced

    4. Tlačítkem Test ověřte připojení. Při úspěšném připojení se zobrazí následující zpráva:
      pohoda-connector-settings-advanced-test
    5. Natavení uložte tlačítkem OK.
    6. V tuto chvíli se společně s exportovanými doklady bude do Pohody do sekce Dokumenty přenášet i jejich soubor. Nastavení můžete otestovat.
    7. V dalším kroku se dozvíte, jak můstek nakonfigurovat k synchronizaci číselníků do Alice.

Synchronizace číselníků

Synchronizace číselníků umožňuje snadný způsob, jak nahrát a používat číselníky z Pohody v Alice. Jedním tlačítkem snadno synchronizujete podporované číselníky, které si následně napojíte na pole v Alice a můžete je začít používat při zpracování dokumentů.

Manuální synchronizace

Synchronizace je manuální proces. Po každé změně číselníku, kterou chcete zanést do Alice, je nutné provést synchronizaci pro danou účetní jednotku.

Požadavky

  • Klientská aplikace s oprávněním Admin
    • Alespoň po dobu synchronizace je potřeba, aby klientská aplikace nastavená v můstku měla oprávnění Admin, kvůli tvorbě a aktualizaci číselníků. Po dokončení synchronizace můžete oprávnění vrátit na původní hodnotu.
  • Účet se zvýšeným oprávněním v Pohodě
    • Abychom předešli problémům se čtením číselníků v Pohodě, doporučujeme na synchronizace jako výchozí uživatelský účet použít takový účet, který má v Pohodě zvýšené oprávnění (např. Admin). Pokud už takový účet používáte, není potřeba konfiguraci upravovat.
  • Nakonfigurované mServery
    • mServery musí být nakonfigurované pro všechny účetní jednotky, které chcete synchronizovat.
    • Ověřte též, že je možné všechny mServery ručně spustit/zastavit. Takto předejdete možným problémům při synchronizaci, protože vás Pohoda např. může vyzvat k aktualizaci databáze ÚJ po updatu, která by zabránila spuštění mServeru, a tedy i synchronizaci.
Postup konfigurace
  1. První synchronizaci doporučujeme provádět postupně pro každou ÚJ zvlášť (pro snažší diagnostiku možných problémů).
  2. Nastavte můstek k synchronizaci číselníků:
    1. Pro synchronizaci stačí, aby byly vyplněny sekce Nastavení Exportu a Nastavení Pohoda.
    2. Přiřazené účetní jednotky přepněte na Pouze vybrané a zvolte první ÚJ.
    3. Nastavení může vypadat např. takto:
      connector-pohoda-enum-sync.jpg
  3. Spusťte synchronizaci tlačítkem Synchronizovat číselníky z Pohody do Redque.
  4. Synchronizace se spustí; během několika vteřin se spustí mServer pro danou účetní jednotku.
  5. Ve výpisu se zobrazí požadavky, které načtou číselníky z Pohody, a mServer se následně ukončí
    connector-pohoda-enum-sync-mserver.jpg:
  6. Pokud synchronizace proběhla úspěšně, po chvíli se zobrazí zpráva:
    connector-pohoda-enum-sync-success.jpg
    1. ❗Pokud jste při synchronizaci obdrželi chybu: Nejčastější problémy při synchronizaci číselníků.
  7. V Alici nyní najdete synchronizované číselníky v Nastavení > Číselníky:
    connector-pohoda-enum-sync-in-alice.jpg
  8. Nyní můžete proces opakovat jednotlivě pro všechny ostatní účetní jednotky.
  9. Po dokončení synchronizace stačí dát Storno a nastavení se vrátí do původního stavu.
  10. Nyní je nutné číselníky napojit a nastavit políčka, abyste je mohli používat při zpracování dokumentů, a následně změny otestovat.
  11. Níže se dozvíte, jak můstek nakonfigurovat k ukládání dokumentů do složky po úspěšném nahrání do Pohody.
Propojení synchronizovaných polí

Po úspěšné synchronizaci číselníků je nutné provést napojení jednotlivých polí. Jak proces napojení probíhá, se dozvíte v sekci Číselníky.

Omezení synchronizace číselníků
  • Nesynchronizují se zakázky, které mají stav Vyřízeno nebo Uzamknout a dále nepoužívat
Nejčastější problémy při synchronizaci číselníků
Synchronizace (mServer) se nespustila

Příčiny mohu být stejné jako u: Neběží synchronizace do Pohody | Dokumenty čekají ve stavu "K exportu" (kromě bodu 1).

Duplicitní klíče

Aby bylo možné číselníky úspěšně synchronizovat, je potřeba, aby identifikátory jednotlivých hodnot, tzv. Klíče (v Pohodě známé jako Zkratka), byly unikátní. Nesmí tedy např. existovat 2 číselné řady pro faktury přijaté s klíčem "2411". Pokud se tak stane, musíte duplicity odstranit, aby bylo možné synchronizaci provést.

Vypršelo spojení s mServerem | Timeout

Příčiny mohu být stejné jako u: Neběží synchronizace do Pohody | Dokumenty čekají ve stavu "K exportu" (kromě bodu 1).
V tomto případě můžete také zkusit synchronizaci opakovat. Může se stát, že se jedná o ojedinělou chybu.

Prázdný nebo nekompletní číselník v Alici | Chyba: 400
The field Values must be a string or array type with minimum length of '1'

Tento problém je nejčastěji způsobem nedostatečným oprávněním v rámci Pohody při synchronizaci. Zkuste při synchronizaci do můstku zadat uživatele s vyšším oprávněním (např. Admin) a synchronizaci opakovat.

Cannot find mServer with Company Identification (ICO) = 12345678

Viz Cannot find mServer with Company Identification (ICO) = 12345678 in local configuration file..

Ukládání dokumentů do složky

Funkce ukládání dokumentů do složky slouží k dodatečnému uložení zdrojové dokumentu do složky na vašem počítači po jeho úspěšném nahrání do Pohody. Může být alternativou funkce přenosu kopie původního dokladu do Pohody, pokud nemáte SQL Pohodu, nebo doplněním této funkce. Takto můžete dokumenty snadno uchovávat a dohledávat v případě potřeby.

Příklad: Ukládání dle IČO/Názvu ÚJ a ID dokumentu v Pohodě

Pokud chcete dokumenty na počítači snadno dohledat za pomoci IČO nebo názvu účetní jednotky a unikátního ID dokladu v Pohodě, zvolte v konfiguraci následující hodnoty:

  • Cílový adresář
    • Dle vaší volby, např. C:\pohoda_dokumenty.
  • Název podsložky
    1. AccountingUnitCompanyId (ID Účetní jednotky) neboli IČO (pokud chcete mít složky pojmenované dle IČO).
      • Např. nahraje-li se doklad do ÚJ s IČO 12345678 pod ID 2411001, najdete tento dokument zde:
        C:\pohoda_dokumenty\12345678\2411001.pdf
    2. AccountingUnitExternalId (Externí ID účetní jednotky), pokud chcete mít složky pojmenované podle sebe. Externí ID ÚJ je pole v nastavení ÚJ v Alice. V případě Pohody sem můžete zadat vlastní hodnotu, jako je např. název ÚJ (a dokumenty se vám tedy budou nahrávat do složky s názvem ÚJ). Můžete použít i jiný vlastní unikátní identifikátor.
      • Např. nahraje-li se doklad do ÚJ s externím ID Společnost 1 pod ID 2411001, najdete tento dokument zde:
        C:\pohoda_dokumenty\Společnost 1\2411001.pdf
    3. Více možností pojmenování i s vysvětlivkami najdete níže v sekci Postup konfigurace.
  • Název souboru: Např. ExternalDocumentId (Externí ID Dokumentu) neboli ID, pod kterým je dokument v dané ÚJ uložen v Pohodě. Více možností pojmenování i s vysvětlivkami najdete níže v sekci Postup konfigurace.
Postup konfigurace
  1. Zaškrtněte možnost Po úspěšném nahrání do účetního programu uložit původní dokument do složky.

  2. Doplňte hodnoty konfigurace

    Parametr Hodnota Pozn.
    Cílový adresář Např. C:\pohoda_dokumenty Složka na vašem počítači. do které chcete dokumenty ukládat
    Název podsložky - Pojmenování složky, do které bude uložen dokument ve výše uvedené složce
    None Žádné: dokument nebude uložen do složky
    DocumentId ID dokumentu: unikátní identifikátor dokumentu v Alice, např. dab70bed20064b64acb75faba3f3becd
    ExternalDocumentId Externí ID Dokumentu: ID Dokumentu v Pohodě, např. 2411001
    DocumentName Originální název dokumentu
    ContainerId ID containeru: unikátní identifikátor "složky" v Alice, např.
    47EFB799E2355C4200DDCDC2117B94E1D70EFC9CBE6EE5D196D9312C0E20A6C3
    Supplier ID IČO Dodavatele
    BilledToIdentifier IČO Odběratele
    AccountingUnitCompanyId IČO účetní jednotky
    AccountingUnitExternalId Externí ID účetní jednotky: konfigurovatelné pole u každé ÚJ. Pro Pohodu může být opět název ÚJ. Tím docílíte, že "Název složky = Název ÚJ"
    Název souboru - Pojmenování výsledného souboru
    DocumentId ID dokumentu: unikátní identifikátor dokumentu v Alice, např. dab70bed20064b64acb75faba3f3becd
    ExternalDucumentId Externí ID Dokumentu: ID Dokumentu v Pohodě, např. 2411001
    FileName Originální název dokumentu
    SuplierIdentifier IČO Dodavatele
    BilledToIdentifier IČO Odběratele

  3. Vyplněná konfigurace může vypadat takto (dle příkladu výše):
    connector-pohoda-savetofolder-configured.jpg

  4. Nastavení uložte tlačítkem OK.
  5. Nyní se vám po úspěšném nahrání dokumentu do Pohody nahraje i kopie dokumentu do požadované lokální složky v nastaveném formátu.
  6. Nastavení můžete otestovat.

Konfigurace Alice

V Alice se nachází další důležitá nastavení, která dokážou ovlivnit způsob, jakým budou dokumenty importovány do programu Pohoda.

pohoda-settings.jpg

pohoda-settings.jpg

Nastavení
Mapování agend pohoda-settings.jpg
Dle typu dokladu: doklad se vloží dle pravidel níže. Faktura přijatá placená hotově / Účtenka placená kartou / Účtenka placená hotově
Dle číselné řady: doklad se vloží do stejné agendy, ze které pochází vybraná číselná řada.
Exportovat položky
Položky exportovat bez DPH Částky budou odesílány bez DPH. Dopočet celkových částek a DPH bude probíhat dle nastavení účetního programu Pohoda.
Výtvářet dodavatele / odběratele v adresáři Při nahrání dokladu bude vytvořen dodavatel nebo odběratel (přijatý/vydaný doklad) v adresáři.
Faktury vydané importovat pod číslem dokladu Faktura vydaná bude zapsaná pod číslem dokladu (pole Číslo faktury).
Exportovat zálohu
Exportovat zaokrouhlení Částka zaokrouhlení se bude exportovat jako samostatná položka dokladu v 0% sazbě.
Datum zápisu Umožňuje zvolit zdroj data zápisu dokladu do Pohody.

Mapování agend

pohoda-settings.jpg

Dle typu dokladu
  1. Faktura přijatá placená hotově
    1. Agenda Faktury přijaté
    2. Agenda Pokladna
  2. Účtenka placená platební kartou
    1. Agenda Faktury přijaté
    2. Agenda Ostatní závazky
    3. Agenda Pokladna
  3. Účtenka placená hotově
    1. Agenda Faktury přijaté
    2. Agenda Ostatní závazky
    3. Agenda Pokladna
Dle číselné řady

Dokument se vloží automaticky do správné agendy, ke které byl v Pohodě číselník vytvořen.

Upozornění

Aby tato možnost funovala správně, musí být číselník a jeho hodnoty synchronizované pomocí můstku. Vložení do správné agendy podle číselníku nebude fungovat pro ručně vytvořené číselníky nebo jejich hodnoty.

Synchronizace dokumentů do Pohody

Požadavky

  1. Pro prvotní otestování můstek přepněte do manuálního režimu.
    connector-settings-manual.jpg.
  2. V Alice nahrajte dokument a vyčkejte na jeho vytěžení, případně můžete použít již vytěžený dokument.
  3. Přejděte na vytěžený dokument, zpracujte a označte ho k exportu.
    1. Ujistěte se, že exportovaný dokument má správně přiřazenou účetní jednotku a všechny další náležitosti faktury, jako je např. "Datum vystavení", viz Povinná a doporučená pole. V případě chybějících náležitostí nemusí dojít ke správnému importu do Pohody.
  4. Pro ověření, zda se dokument dostal do fronty k exportu, můžete zkontrolovat náhled Čeká na export, kde by se dokument měl nacházet ve stavu state-ready-to-export.png
  5. V můstku spusťte manuální synchronizaci:
    connector-system-tray-download-documents.jpg |
  6. Komunikaci s mServerem uvidíte pouze na počítači, na kterém máte naintalovaný můstek.
    1. Pokud byl dokument v pořádku, můstek jej načte.
    2. Můstek otevře na popředí mServer.
      1. Pokud se můstek nespustí, ověřte, že jste splnili požadavky výše, a případně zkontrolujte nastavení dle: Neběží synchronizace do Pohody | Dokumenty čekají ve stavu "K exportu" .
    3. Následně se naimportuje dokument. V okně mServeru se zobrazí požadavky k importu dokumentu (2 černé řádky):
      mserver-success.jpg
    4. Pokud tento proces proběhl v pořádku, dokument byl úspěšně importován do příslušné účetní jednotky a budete si ho moci zobrazit v Pohodě.
  7. mServer se sám automaticky zavře.
  8. Pokud došlo k nějaké chybě při komunikaci, můžete chybu diagnostikovat za pomoci návodu níže.
  9. Pokud testování proběhlo v pořádku, můžete můstek začít aktivně používat.
    1. Pro periodickou synchronizaci dokumentů můžete můstek přepnout do režimu Automaticky každých X sekund.
    2. Případně můžete můstek ponechat v režimu Ručně a dokumenty si vždy stáhnout ve chvíli, kdy to bude potřeba:
      connector-system-tray-download-documents.jpg

Diagnostika chyb

Obecné chyby

Pokud dojde k chybě při importování dokumentu do Pohody skrze můstek, u problémového dokumentu se v Alici zobrazí stav state-error.png. Po najetí kurzorem na tento stav se zobrazí bližší informace o chybě, které vrátil buď můstek, nebo samotná POHODA:

ui-failure.jpg

Diagnostika komunikace s POHODA

Častým problémem je, že se dokument do Pohody sice dostane, ale neprojde interní validací. V mServeru se toto chování vyznačuje oranžovou barvou requestu. Dle dokumentace POHODA:

  • HTTP komunikace a zpracování dat = OK
  • HTTP komunikace = OK, zpracování dat = ERROR
  • HTTP komunikace = ERROR

Pokud se s tímto problémem potýkáte, můžete postupovat dle návodu níže. Interní validaci lze ručně diagnostikovat skrze XML komunikaci v Pohodě.

  1. Možnost 1:
    1. Pohoda si ukládá informace o importech do agendy XML log. Pokud se log komunikace uložil, můžete bližší informace najít i zde.
    2. V Pohodě přejděte do Soubor > Datová komunikace > XML log.
    3. Najděte log problematického importu (většinou bývá mezi posledními).
    4. V horní části náhledu zvolte Cíl, který obasahuje cestu k souboru se záznamem komunikace (viz. Možnost 2)
    5. Pokud nebyl záznam smazán, zobrazí se vám log komunikace níže.
      1. V opačném případě se zobrazí chybová hláška, že soubor neexistuje. V takovém případě použijte prosím Možnost 2.
  2. Možnost 2:
    1. V Alice si stáhněte XML pro POHODA, jedná se o stejné XML, které můstek nahrává přes mServer. K této možnosti se dostanete v náhledu dokumentu Stáhnout > Stáhnout XML (Pohoda): xml-diag-1
    2. Otevřete Pohodu.
    3. Ujistěte se, že se přihlašujete pod stejným uživatelem, jako používáte i v můstku. (V případě odlišných oprávnění může nastat problém.)
    4. Otevřete požadovanou ÚJ.
    5. Přejděte do: Soubor > Datová komunikace > XML import/export...
    6. Otevře se vám okénko pro import souboru.
      1. Do parametru "Vstupní složka nebo soubor (request)" vyberte za pomocí 3 teček soubor stažený z Alice.
      2. Pokračujte 2x tlačítkem Next.
      3. Dokument se začne importovat.
        1. Pokud došlo k nějaké závažnější chybě, jako je např. chybný formát XML, měli byste ji vidět okamžitě ve výpisu.
      4. Import proběhne a dostanete se na výpis XML Log.
      5. Zde zvolte Cíl, který vám zobrazí log komunikace:
        xml-diag-2
  3. V logu uvidíte tagy:
    1. (rdc:state - warning) - Upozornění: Dokument se v pořádku nahraje, pouze uživatele upozorní a nevalidní hodnoty si upraví.
    2. (rdc:state - error) - Chyby: Dokument se nenahraje a zobrazí hlášku detailněji popisující problém:
      xml-diag-3
  4. Na základě této hlášky můžete dokument v Alice opravit, pokud je to možné, a export opakovat.

Pokud si s chybou nevíte rady a nenašli jste ji ani v nejčastějších chybách, neváhejte se obrátit na naši podporu.

Čtení logu

S diagnostikou chyb vám také může pomoci log můstku. Ten si zobrazíte zde:
connector-system-tray-display-logs.jpg.

  1. V logu sescrollujte k posledním řádkům a zkontrolujte, jestli ve výpisu nevidíte informaci, která by naznačovala chybu. Klíčová slova jsou většinou: Error nebo Exception.
  2. Pokud je z chyby možné zjistit, o jaký problém se jedná (např. chybějící/špatně vyplněné pole, nebo některá z nejčastějších chyb), zkuste se řidit popisem, a pokud je to uživatelsky možné, chybu odstranit (např. opravením hodnoty v aplikaci).
  3. Pokud z chyby není možné zjistit příčinu, neváhejte se obrátit na naši podporu.

Nejčastější chyby

Spouštění synchronizace dokumentů/číselníků

Neběží synchronizace do Pohody | Dokumenty čekají ve stavu "K exportu"

Pro synchronizaci je nutné, aby můstek běžel a byl nastavený v požadovaném režimu.

  1. Přihlaste se na počítač, na kterém používáte můstek, pod uživatelem, kterého používáte pro provoz můstku.
  2. V systémové liště ověřte, že je můstek spuštěný. Měli byste vidět tuto ikonku:
    connector-system-tray.jpg
  3. Můstek můžete preventivně restartovat.
    1. Kliknětě na můstek pravým tlačítkem a zvolte Ukončit.
    2. Můstek znovu spusťte. Spouštěcí soubor najdete zde: C:\Program Files\Redque\Redque Connector\RedqueConnectorApp.exe.
  4. Zvolte možnost Nastavení a ověřte, že je můstek v požadovaném režimu synchronizace. Např. Automaticky každých X sekund
    connector-settings-automatic.jpg
  5. Pro ověření přenosu spusťte synchronizaci pomocí tlačítka Stáhnout dokumenty a vyčkejte na spuštění synchronizace.
    connector-system-tray-download-documents.jpg
  6. Pokud na ikonku můstku najedete kurzorem, můžete sledovat aktuální stav přenosu:
    connector-system-tray-hover.jpg
  7. Pokud je vše v pořádku, spustí se mServer a naimportuje čekající dokumenty.
    1. V tomto případě byl problém způsoben pouze tím, že můstek nebyl automaticky spuštěn po restartu počítače, na kterém je provozovaný.
  8. Pokud synchronizace neproběhla, pokračujte ke kontrole mServerů.

Nejsnadnější způsob ověření problému s mServerem je jeho manuální spuštění v Pohodě:

  1. Přejdětě v Pohodě do Nastavení mServerů: Soubor > Účetní jednotky (Ctrl + U ) > Databáze > POHODA mServer
  2. Vyberte mServer, který má potíže se spuštěním
  3. Zvolte Spustit...
  4. Pokud mServer naběhne, nemělo by při synchronizacei docházet k žádným problémům.

Pokud se mServer nepodaří spustit, je možné, že nastala jedna z následujících situací:

  1. Databáze ÚJ nebyla převedena po poslední verze programu
    1. Převěďte databázi a mServer by mělo být možné opět spustit.
  2. mServer nelze spustit kvůli nedostatku licencí Pohody
    1. Ujištěte se, že v Pohodě je dostatek licencí, jinak nebude možné mServer spustit.
    2. Přejděte v Pohodě do Soubor > Účetní jednotky (Ctrl + U ) > Databáze > Připojení uživatelé...
    3. Zobrazí se vám seznam uživatelů aktuálně používajících Pohodu.
    4. Pokud počet uživatelů překračuje limit licencí v Pohodě, musí některý z uživatelů uvolnit licenci, aby bylo možně synchronizaci spustit.
  3. mServer nelze spustit protože požadovaný port je již alokovaný jiným mServerem nebo jinou instancí stejného serveru
    1. Přejděte na seznam mServerů: Soubor > Účetní jednotky (Ctrl + U ) > Databáze > POHODA mServer
    2. Vy výpisu mServerů by všechny servery měly mít stav Zastavený.
    3. Pokud tomu tak není, je nutné daný mServer zastavit. Synchronizaci by pak mělo být možné spustit.
      1. V tomto případě je nutné zjistit, jak k problému došlo.
      2. Problém může být způsobem tím, že mServer přestal odpovídat a můstku se jej nepodařilo ukončit. Tato situace může nastat v ojedinělých případech.
      3. Dalším důvodem může být Duplicitní můstek (viz níže).
  4. Duplicitní můstek
    1. Pokud nepomohl ani jeden z postupů výše, je pravděpodobné, že jinde beží další nevyžádaná instance můstku, nebo synchronizaci spouští další uživatel, který má špatně nakonfigurovaný můstek.
    2. Pokračujte na "Nevyzpytatelné chování | Změna stavu dokumentu na "Chyba" po úspěšném exportu" níže, kde naleznete popsány nejčastější problémy při konfiguraci můstku.
  5. Alokovaný port obecně
    1. Pokud jste nepoužili výchozí port mServeru 444, ujišttěte se, že vámi využívaný port již nepoužívá jiná služba.

Po vyřešení problému opakujte synchronizaci, která by nyní měla fungovat.

Problémy při komuniaci s Pohodou

Nevyzpytatelné chování | Změna stavu dokumentu na "Chyba" po úspěšném exportu

Ujistěte se, že splňujete doporučení pro provoz můstku.

POHODA API returned code Unauthorized

Tento problém je pravděpodobně způsoben zadáním špatných přihlašovacích údajů pro uživatele Pohody v nastavení můstku. Ověřte, že přihlašovací údaje jsou zadány správně, např. jejich použitím pro přihlášení do Pohody, a heslo případně resetujte.

Pohoda API returned code Forbidden

Tento problém je většinou způsoben nedostatečným oprávněním v rámci Pohody, nejčastěji oprávněním pro účetní jednotku nebo Agendu. Ověřte, že uživatel, kterého používáte v můstku, má přiřazená správná oprávnění pro danou účetní jednotku.

Date issued cannot be empty

Dokument nemá vyplněné pole "Datum vystavení", což je v Pohodě povinné pole. V náhledu dokumentu stačí vyplnit "Datum vystavení" a dokument znovu poslat k exportu.

Cannot find mServer with Company Identification (ICO) = 12345678 in local configuration file.

Pro účetní jednotku s tímto IČO není vytvořen nebo správně nakonfigurován mServer. Ověřte, že je mServer správně nakonfigurovaný dle návodu výše.

The document {documentId} has no accounting unit assigned.

Dokument nemá přiřazenou účetní jednotku. V náhledu dokumentu stačí přiřadit účetní jednotku a dokument znovu poslat k exportu.

Login failed. Status Code: BadRequest Content: {"error":"invalid_client"}

Na tento problém narazíte při spuštění můstku v případě, že jste zadali nesprávné přihlašovací údaje ke klientské aplikaci, kterou jste vytvořili. Ujistěte se, že jste údaje v konfiguraci můstku zadali správně. Pokud jste o údaje přišli, musíte vytvořit novou klietskou aplikaci.

The mServer XY did not reach running status

Nepodařilo se spustit požadovaný mServer. Pokus opakujte a pokud spuštění opakovaně selže, postupujte podle: Neběží synchronizace do Pohody | Dokumenty čekají ve stavu "K exportu".

Pohoda API returned code OK but there is no document number in the response

Dokument se nepodařilo správně importovat, protože neprošel některou z validací. Zkontrolujte správnost a úplnost povinných polí, případně zkuste dokument nahrát ručně do Pohody.

V případě, že v rámci můstku pro komunikaci s Pohodou používáte zvláštního uživatele, zkontrolujte jeho práva a případně jeho nastavení účtování na přelomu účetního období konkrétní účetní jednotky.

m_sPathDoc is not set in database StwPh_IČO_YYY

Tento problém se objevuje pouze v případě, že používáte funkci Přenos kopie původního dokladu do POHODA. Překontrolujte Požadavky u dané ÚJ - problém je pravděpodobě způsoben tím, že funkce ukládání dokumentu není pro tuto ÚJ zapnutá.

Pohoda returned error state: Není zadáno číslo dokladu nebo výchozí číselná řada. Doklad nelze vytvořit

Tento problém může mít následující příčiny:

  1. Špatně přiřazený mServer
    1. Ujistěte se, že mServer, který používáte, je napojený na správnou účetní jednotku, která obsahuje požadovaný číselník. Ověřte, že např. při manuální manipulaci s ÚJ (obnovy apod.) nedochází k automatickému přepnutí ÚJ (databáze) v mServeru. Pokud podobná situace nastane, ověřte, že mServer používa správnou ÚJ (databázi).
  2. Uživatel můstku v nesprávném účetním roce
    1. Zkontrolujte, že uživatel, kterého používáte v můstku pro Pohodu, je pro danou účetní jednotku v požadovaném účetním roce. Tento problém nastává především na přelomu roku, kdy už normální uživatel pracuje v přechodném období (např. 2025p), ale uživatel definovaný v můstku je stále v účetním roce 2024. V takovém případě je nutné se do Pohody přihlásit pod uživatelem v můstku a překontrolovat toto nastavení pro danou ÚJ.
  3. Chybějící hodnota v číselníku | Špatně zadaná hodnota číselníku v Alici
    1. Pokud problém nebyl způsoben příčinami v bodech 1 a 2:
      1. Ujistěte se, že v dané agendě číselník opravdu obsahuje vámi zadanou hodnotu.
      2. V Alice se ujistěte, že Klíč v daném číselníku je roven požadované hodnotě Zkratka v Pohodě.
        1. Pokud se tyto hodnoty neshodují, nelze číselníky správně napárovat.

Časté dotazy | FAQ

Uživatelé

Jak funguje nahrávání dokumentu na přelomu roku?

Nahrávání přes mServer a to, do jakého účetního roku se dokument dostane, se odvíjí od toho, v jakém roce je pro danou účetní jednotku přepnutý uživatel, pod kterým je nastavený můstek (např.: redque_connector). Pokud tedy používáte výchozího uživatele, který je pro danou ÚJ nastavený např. v roce 2024, dokument se dostane do účetního roku 2024. Pokud uživatele přepnete na přelom roku, tzn. ÚR bude 2025p, nahraje se dokument do tohoto ÚR.

Pokud je to možné, doporučuje doúčtovat co nejvetší část hlavního roku a následně přejít za uživatele na přelom roku. V závislosti na počtu dokumentů nebo ÚJ lze pak alternativně přepínat, nebo např. hromadně přečíslovat nahrané dokumenty skrz: Záznam > Editace > Přečíslovat....

Pokud to vaše řešení umožňuje, můžete můstek napojit přes vašeho uživatele, jak je uvedeno výše, čimž se vyhnete přenastavování ÚJ na dalším účtě.

**Toto vychází z nastavení POHODA/mServer. V komunikaci s Pohodou není možné definovat, do jakého ÚR se dokument nahraje; tato informace se přejímá pouze ze stavu uživatele.**
Musím mServer přenastavovat na novou ÚJ pokaždé, když uzavřu účetní rok?

Pokud při přechodu na nový rok postupujete pomocí průvodce Pohody, pak ne. mServer se automaticky přepne na poslední ÚJ pro daný rok. Pokud byl mServer napojený na ÚJ pro rok 2024, který následně uzavřete a vytvoříte rok nový, mServer se automaticky přepne na něj.

Musím provést nějakou změnu při uzavření účetního roku?

V případě uzavření účetní jednotky na nový účetní rok proveďte následující kroky:

  1. Ve webové aplikaci:
    1. Není potřeba provádět změny. Komunikace probíhá na základě IČO, které se nezměnilo.
  2. V POHODA:
    1. Vytvořte účetní jednotku pro nový rok (uzavřete účetní rok).
    2. mServer se přepne automaticky na poslední ÚJ.
    3. Uživatel v Pohodě: pokud používáte dedikovaného uživatele bez globálního oprávnění, zkontrolujte, že se mu aplikovala oprávnění na novou ÚJ. V opačném případě je přiřaďte (mělo by proběhnout automaticky).
    4. Ukládání dokumentů (SQL): pokud jste použili k nastavení možnost "Optimální" nebo "Bez omezení", není nutné provádět žádné změny. V případ možnosti "Nejbezpečnější" si musíte zajistit aktualizaci oprávnění na nových ÚJ.
Jak přidám novou účetní jednotku?

Pro přidání nové účetní jednotky, která bude fungovat s POHODA můstkem, proveďte následující kroky:

  1. Ve webové aplikaci:
    1. Sekce Nastavení > Účetní jednotky.
    2. Přidejte novou účetní jednotku.
  2. V POHODA
    1. Vytvořte novou účetní jednotku.
    2. Nastavte pro jednotku mServer dle návodu výše.
    3. Pokud používáte dedikovaného uživatele bez globálního oprávnění: Přiřaďte uživateli pro POHODA můstek (Výchozí: redque_connector) příšlušná oprávnění na novou účetní jednotku dle návodu výše.
    
    1. **Pokud nahráváte původní kopii dokumentu do POHODA:** Pokud se jedná o novou účetní jednotku (nový rok, nově vytvořená), práva by měla být v pořádku. Pokud se jedná o jednotku, která v POHODA byla, ale nebyla propojená s Alice či mServery, konzultujte návod [Přenos kopie původního dokladu do POHODA](#prenos-kopie-puvodniho-dokladu-do-pohoda).
Proč nemohu opakovaně nahrát dokument, který jsem v Pohodě smazal/a se zapnutou kontrolou duplicit?

Kontrola duplicit v Pohodě funguje na dvou mechanismech.

  1. Samotný duplicitní dokument: Pohoda porovná hodnoty dokumentu s již existujícími. Pokud neexistuje, dokument nahraje, v opačném případě zahlásí chybu.
  2. XML log komunikace: Pohoda též kontroluje, že v agendě XML log již není stejný záznam o nahrání dokumentu. Pokud existuje, Pohoda zahlásí chybu.

Pokud jste tedy již dokument v Pohodě smazali v dané agendě (např. Přijaté faktury), ale stále dostáváte chybu o duplicitě, je zapotřebí smazat záznam ještě z agendy v XML log:

  1. V Pohodě přejděte do Soubor > Datová komunikace > XML log:
    pohoda-xml-log.jpg
  2. Ve výpisu najděte záznam týkající se nahrání požadovaného dokumentu, většinou mezi posledními.
  3. Záznam smažte.
  4. Opakujte export v Alice. Dokument by se měl v pořádku nahrát.
Co mám dělat v případě, že pro stejnou účetní jednotku již používám mServer?

Pokud pro ÚJ, do které chcete nahrávat dokumenty skrze můstek, již máte další aktivní mServer např. kvůli napojení jiných systémů, může dojít k problémům se spouštěním a k narušení stávajících procesů.

Z tohoto důvodu je v můstku integrována možnost, která tomuto chování předejde. Postupujte následovně: 1. Vytvořte další mServer pro stejnou ÚJ, ale do názvu přidejte text "Redque" (např. "Redque - Společnost s.r.o."; na velikosti písmen nezáleží). 1. Můstek si zobrazí mServery pro zvolenou ÚJ a bude preferovat ten mServer, jehož název obsahuje právě text "Redque".

Administrátoři

Bude můstek bránit zálohám nebo aktualizaci Pohody?

Zálohy

Můstek, respektive mServer se zapíná pouze ve chvíli, kdy jsou dokumenty k exportu ve frontě (pokud je v aut. režim synchronizace). Pokud tedy zrovna uživatel v době těchto operací nebude zpracovávat dokumenty, neměl by můstek záloze bránit. Můstek však můžete preventivně přepnout do manuálního režimu nebo ho vypnout a po záloze opět zapnout.

Aktualizace

Při aktualizaci STORMWARE doporučujeme odpojit všechny uživatele včetně mServerů. V případě, že aktualizujete Pohodu, ujistěte se, že můstek (nebo mServery) neběží. V době aktualizace doporučujeme preventivně můstek přepnout do maunálního režimu nebo raději zcela vypnout a po aktualizaci opět zapnout.

Povinná pole

Povinná a doporučená pole: česká faktura
Název pole Povinné Doporučené
Číslo faktury ✔
Číslo objednávky
Číslo dodacího listu
Jméno dodavatele ✔
IČO dodavatele ✔
DIČ dodavatele
Adresa dodavatele ✔
Město dodavatele ✔
PSČ dodavatele ✔
Jméno odběratele ✔
IČO odběratele ✔
DIČ odběratele
Adresa odběratele ✔
Město odběratele ✔
PSČ odběratele ✔
Číslo bankovního účtu
Konstantní symbol
Kód banky
Variabilní symbol
Specifický symbol
IBAN
BIC/SWIFT
Datum vystavení ✔
Datum splatnosti ✔
Datum uskutečnění plnění ✔
Základ sazba 0% DPH
Základ sazba 10% DPH
Základ sazba 12% DPH
Základ sazba 15% DPH
Základ sazba 21% DPH
DPH sazba 10%
DPH sazba 12%
DPH sazba 15%
DPH sazba 21%
Celkem ✔
Zaokrouhlení
Celkem k úhradě ✔
Způsob úhrady
Měna
Plátce daně
Přenesená daňová povinnost
Zálohová faktura
Uhrazená záloha
Směnný kurz
Datum přepočtu kurzu
Poznámka ✔