Faktury do Pohody: ruční import XML vs. napojení přes mServer

Pohoda je nejrozšířenější účetní software v Česku a zároveň místo, kde končí velká část dokladů od živnostníků a malých firem. Cesta faktury do Pohody ale často vypadá stejně jako před dvaceti lety: účetní dostane hromadu PDF nebo papírů a položku po položce je přepisuje. Přitom Pohoda umí doklady přijímat strojově, buď ručním importem XML souboru, nebo přímým napojením přes komunikační rozhraní mServer. V tomto článku si obě cesty projdeme krok za krokem, ukážeme, kdy která dává smysl, a projdeme chyby, na kterých import faktur do Pohody nejčastěji ztroskotá: číselné řady, předkontace a znakové sady.

Co v článku najdete

• Proč faktury do Pohody nepřepisovat ručně
• Dvě cesty: XML import vs. mServer
• Ruční import XML krok za krokem
• Přímé napojení přes mServer
• Tři úskalí z praxe: číselné řady, předkontace, znakové sady
• Jak to automatizuje DokladBot
• Časté chyby při importu
• Časté otázky
• Zdroje a reference

Proč faktury do Pohody nepřepisovat ručně

Ruční přepis jedné přijaté faktury zabere zkušené účetní 3 až 5 minut: založit dodavatele, opsat číslo dokladu, datumy, částky, rozepsat DPH, přiřadit předkontaci. U klienta s padesáti doklady měsíčně jsou to hodiny čistého času, a to bez započtení chyb z překlepů, které se pak dohledávají při kontrole DPH.

Přitom Pohoda má už roky dokumentované XML rozhraní, přes které lze doklady importovat strojově. STORMWARE, výrobce Pohody, publikuje oficiální XML schémata (aktuálně verze 2.x) pro faktury, pokladní doklady, objednávky, adresář a další agendy. Prakticky každý fakturační nebo vytěžovací nástroj na českém trhu proto umí data pro Pohodu připravit. Otázka tedy nezní, jestli import použít, ale kterou ze dvou cest zvolit.

Dvě cesty: XML import vs. mServer

Pohoda přijímá strojová data dvěma způsoby, které se liší mírou automatizace i nároky na nastavení.

Kritérium	Ruční import XML	Napojení přes mServer
Princip	Soubor XML ručně načtete v Pohodě	Aplikace komunikuje s Pohodou přímo přes HTTP
Zásah člověka	Při každém importu	Jednorázové nastavení, pak běží samo
Směr komunikace	Jednosměrný (dovnitř)	Obousměrný (import i export dat)
Rychlost zpětné vazby	Chyby vidíte až po načtení souboru	Odpověď na každý doklad okamžitě
Technická náročnost	Nízká, zvládne každý uživatel Pohody	Vyžaduje nastavení mServeru a sítě
Vhodné pro	Občasné dávky dokladů	Průběžný tok dokladů, účetní kanceláře

Zjednodušeně: XML import je jako posílat dopisy, mServer je jako mít otevřenou telefonní linku. Pro pár dokladů měsíčně stačí dopisy. Jakmile doklady tečou průběžně nebo obsluhujete víc firem, vyplatí se linka.

Ruční import XML krok za krokem

Ruční import zvládnete i bez IT podpory. Potřebujete jen XML soubor ve formátu Pohody, který vám vygeneruje fakturační nástroj, vytěžovací služba nebo jiný systém.

Celý proces zabere pár minut na dávku. Slabina je zřejmá: někdo ho musí pokaždé ručně spustit a soubory mezi systémy přenášet. Právě to řeší druhá cesta.

Přímé napojení přes mServer

mServer je součást Pohody (v řadách Pohoda, Pohoda SQL i E1), která z ní udělá server: Pohoda naslouchá na zvoleném portu a přijímá stejné XML požadavky jako ruční import, jen po síti přes HTTP. Externí aplikace tak může doklady posílat průběžně a na každý dostane okamžitou odpověď, zda se založil, s jakým číslem a případně s jakou chybou.

Nastavení v kostce:

1. V Pohodě otevřete Databáze, mServer a založte nový mServer (název, port, účetní jednotka).
2. mServer spusťte, případně nastavte automatické spouštění. Pohoda přitom musí běžet na počítači nebo serveru, kde je mServer aktivní.
3. V aplikaci, která má doklady posílat, zadáte adresu, port a přihlašovací údaje uživatele Pohody s právy pro XML komunikaci.
4. Otestujete přenos na několika zkušebních dokladech a zkontrolujete odpovědi.

Výhodou proti souborovému importu je obousměrnost: aplikace může z Pohody i číst, například stav dokladů nebo číselníky. Nevýhodou je, že mServer vyžaduje trvale dostupnou instalaci Pohody a základní síťovou konfiguraci, což u účetní kanceláře typicky řeší její IT správce nebo dodavatel napojené aplikace.

Tři úskalí z praxe: číselné řady, předkontace, znakové sady

Při vývoji napojení DokladBotu na Pohodu přes mServer jsme v produkci přenesli přes 2 455 dokladů a narazili na tři místa, kde importy nejčastěji padají nebo dělají v účetnictví nepořádek. Celou technickou studii najdete na stránce Studie: přímé napojení na Pohodu přes mServer.

1. Číselné řady

Láká to poslat do Pohody doklad i s vlastním číslem. Jenže posílání vlastního čísla dokladu rozbíjí číselné řady Pohody: importované doklady se nezařadí do řady, kterou účetní používá, číslování přestane navazovat a při kontrole se pak složitě dohledává, proč v řadě zejí díry nebo se čísla bijí. Správný postup je nechat číslování na Pohodě, tedy poslat doklad bez čísla (nebo jen s odkazem na řadu) a převzít číslo, které Pohoda přidělí a vrátí v odpovědi. Přesně tak to dělá i DokladBot: doklady se číslují výchozí řadou Pohody, takže napojení nerozbije existující číslování kanceláře.

2. Předkontace

Předkontace určuje, na jaké účty se doklad zaúčtuje. Import bez předkontace znamená, že účetní stejně musí každý doklad otevřít a doplnit ji ručně, čímž se velká část úspory ztratí. Naopak slepě posílaná automatická předkontace umí nadělat škodu v hlavní knize. Osvědčený kompromis: automatický návrh kategorie, který ale člověk před odesláním do Pohody potvrdí. V DokladBotu má kategorie potvrzená účetní v dashboardu vždy přednost před automatickým návrhem.

3. Znakové sady

Nejzáludnější technická drobnost: Pohoda komunikuje ve znakové sadě Windows-1250, ne v UTF-8, které je dnes všude jinde standardem. Když XML pošlete v UTF-8 bez správné deklarace a převodu, dopadne to v lepším případě odmítnutím importu, v horším rozsypanou diakritikou v názvech firem a popisech dokladů ("Nákup materiálu" se změní v nečitelný shluk znaků). Pokud si XML export připravujete sami nebo ho generuje váš nástroj, ověřte, že soubor je skutečně ve Windows-1250 a deklarace kódování v hlavičce XML tomu odpovídá.

Jak to automatizuje DokladBot

DokladBot řeší část procesu, která předchází samotnému importu a obvykle žere nejvíc času: sběr a vytěžení dokladů. Účtenku vyfotíte a pošlete na WhatsApp, faktury přeposíláte e-mailem nebo je přijmete z datové schránky. Bot z každého dokladu vytěží dodavatele, částky, datumy a DPH, automaticky navrhne kategorii a pohlídá duplicity, aby se stejná faktura nedostala do účetnictví dvakrát.

Do Pohody pak doklady předáte dvěma způsoby, které přesně odpovídají cestám z tohoto článku:

• Export XML souborů, které ručně naimportujete postupem popsaným výše. Hodí se, když Pohodu spravuje externí účetní a přímé napojení zatím nechcete řešit.
• Přímé napojení přes mServer, kdy se vytěžené a schválené doklady přenášejí do Pohody i s kategoriemi bez ručního přepisování. Toto napojení máme ověřené v produkci na více než 2 455 dokladech a pěti firmách pod jednou správou, včetně řešení číselných řad, předkontací i znakové sady popsaných výše.

Účetní kanceláře tenhle model používají jako sběrné místo: klienti posílají doklady přes WhatsApp nebo e-mail, kancelář je v dashboardu zkontroluje, schválí a pošle do Pohody. Jak to vypadá v praxi u kanceláře s pěti firmami, popisuje případová studie účetní kanceláře a další scénáře najdete na stránce Jak využívat DokladBot naplno. Srovnání s ručním účtováním jsme sepsali v článku automatické účtování vs. ruční práce.

Férově dodejme, co DokladBot nedělá: nevede podvojné účetnictví ani sklady a nenahrazuje Pohodu. Jádro účetnictví zůstává v Pohodě, DokladBot automatizuje cestu dokladu k ní.

Časté chyby při importu

Chyba	Projev	Řešení
Vlastní čísla dokladů	Rozbité číselné řady, díry a kolize v číslování	Číslo přiděluje Pohoda, zdrojový systém přebírá odpověď
XML v UTF-8	Odmítnutý import nebo rozsypaná diakritika	Generovat XML ve Windows-1250 se správnou deklarací
Chybějící předkontace	Doklady bez zaúčtování, ruční dodělávky	Potvrzovat kategorie před odesláním
Duplicitní doklady	Stejná faktura v agendě dvakrát, dvojité náklady	Kontrola duplicit před importem, hlídání párovacích symbolů
Import bez zálohy	Nepovedená dávka se maže ručně	Záloha účetní jednotky před každou větší dávkou
Špatné účetní období	Doklady spadnou do nesprávného roku	Řešit období per doklad, ne globálním přepínáním

Časté otázky

Musím mít pro import XML nějakou vyšší verzi Pohody?

XML import přes menu Soubor, Datová komunikace je dostupný napříč řadami Pohody. mServer je součástí Pohody, Pohoda SQL i Pohoda E1. Konkrétní možnosti si ověřte v dokumentaci STORMWARE ke své verzi, rozsah podporovaných agend se mezi řadami může lišit.

Je lepší XML import, nebo mServer?

Záleží na objemu a frekvenci. Pro jednorázové nebo občasné dávky stačí ruční import XML, nastavíte ho za pár minut. Pokud doklady přibývají průběžně, obsluhujete víc firem nebo chcete obousměrnou komunikaci, vyplatí se jednorázově nastavit mServer a dál už nic ručně nepřenášet.

Co se stane, když importovaný doklad obsahuje chybu?

Pohoda ke každému importu vrací odpověď se stavem jednotlivých dokladů. Chybný doklad se nezaloží (nebo se založí s varováním) a v odpovědi je uvedený důvod. U mServeru dostane odesílající aplikace tuto odpověď okamžitě, takže chybu může rovnou zobrazit a nechat opravit.

Přenese se do Pohody i DPH a předkontace?

Ano, XML formát Pohody přenáší rozpis DPH po sazbách i předkontaci. Praktická rada z našeho nasazení: předkontaci neposílejte naslepo z automatiky, ale nechte ji před odesláním potvrdit člověkem. Ušetříte si opravy v hlavní knize.

Zvládne to i neplátce DPH nebo úplný začátečník?

Ano. Ruční import XML je klikání v průvodci a u napojení přes DokladBot se o technické detaily (znakové sady, číselné řady, formát XML) nestaráte vůbec, řeší je integrace. Vyzkoušet si to můžete 7 dní zdarma, tarify začínají na 199 Kč měsíčně bez DPH, podrobnosti najdete v ceníku.

Zdroje a reference

• STORMWARE: dokumentace XML komunikace programu POHODA a přehled XML schémat, stormware.cz/xml
• STORMWARE: POHODA mServer, popis a nastavení komunikačního rozhraní, stormware.cz/pohoda/xml/mserver
• DokladBot: Studie: přímé napojení na Pohodu přes mServer, srpen 2026
• DokladBot: Studie: účetní kancelář s 5 firmami

Údaje v článku odpovídají stavu k srpnu 2026. Postupy v Pohodě se mohou mezi verzemi mírně lišit, ověřte je v dokumentaci ke své verzi.