Export dat do účetních systémů — Kompletní průvodce integrací
Vytěžení dat z faktur je jen polovina práce. Klíčové je dostat tato data do vašeho účetního systému — ať už je to Pohoda, Money S3, nebo vlastní řešení. V tomto článku vám ukážeme všechny možnosti exportu z MIKISI a praktické návody pro jednotlivé systémy.
Obsah
- Přehled exportních formátů
- Export do Pohody (XML)
- Export do Money S3
- Export do CSV a Excel
- API integrace
- Vlastní exportní formát
- Často kladené otázky
Přehled exportních formátů
MIKISI podporuje několik exportních formátů pro různé účetní systémy:
| Formát | Účetní systém | Poznámka |
|---|---|---|
| XML Pohoda | Pohoda (všechny verze) | Nativní formát, plná podpora faktur i pokladních dokladů |
| XML Money S3 | Money S3 | 🚧 Připravujeme |
| CSV | Univerzální | Pro import do jakéhokoliv systému |
| Excel (XLSX) | Microsoft Excel, Google Sheets | Formátovaná tabulka s položkami na samostatném listu |
| JSON | Vlastní řešení | Pro vývojáře a API integrace |
Export do Pohody (XML)
Pohoda je nejrozšířenější účetní systém v ČR. MIKISI generuje XML soubor přesně podle specifikace Stormware — import je otázka několika kliknutí.
Podporované typy dokladů:
- Přijaté faktury (invoice:invoiceType = "receivedInvoice")
- Vydané faktury (invoice:invoiceType = "issuedInvoice")
- Pokladní doklady (voucher:voucherType)
- Zálohové faktury
- Dobropisy
Postup exportu:
- V MIKISI vyberte faktury k exportu (zaškrtněte v seznamu)
- Klikněte na „Export" → „Pohoda XML"
- Stáhněte vygenerovaný XML soubor
Import do Pohody:
- Otevřete Pohodu a přejděte do agendy Přijaté faktury (nebo Pokladna pro pokladní doklady)
- Menu: Soubor → Datová komunikace → XML import
- Vyberte stažený XML soubor
- Potvrďte import
💡 Tip: Před prvním importem doporučujeme vyzkoušet na testovací databázi. V Pohodě: Soubor → Databáze → Kopie databáze pro vytvoření testovací kopie.
Mapování polí MIKISI → Pohoda:
| MIKISI | Pohoda XML |
|---|---|
| supplier_ico | partnerIdentity/address/ico |
| invoice_number | invoiceHeader/number |
| date_issued | invoiceHeader/dateInvoice |
| date_due | invoiceHeader/dateDue |
| total_amount | invoiceSummary/homeCurrency/priceHighSum |
| variable_symbol | invoiceHeader/symVar |
Export do Money S3
🚧 Připravujeme: Export do Money S3 je aktuálně ve vývoji. Pracujeme na plné kompatibilitě s nativním XML formátem Money S3. Pokud používáte Money S3 a máte zájem o early access nebo chcete pomoci s testováním, kontaktujte nás na [email protected].
Money S3 od Cígler Software je druhý nejrozšířenější účetní systém v ČR. Připravujeme export ve formátu kompatibilním s XML přenosy Money S3.
Plánované funkce:
- Export přijatých faktur (FaktPrij)
- Export vydaných faktur (FaktVyd)
- Podpora položek faktur
- Kompatibilita s modulem XMLDE i bez něj
Prozatímní řešení:
Než bude Money S3 export dokončen, můžete využít:
- CSV export — univerzální formát, který lze do Money S3 importovat přes Excel
- Excel export — formátovaná tabulka připravená pro ruční zpracování
Export do CSV a Excel
CSV (Comma-Separated Values) a Excel jsou univerzální formáty, které zvládne importovat prakticky jakýkoliv systém — od tabulkových procesorů až po specializované účetní software.
Kdy použít CSV/Excel:
- Váš účetní systém nepodporuje XML import
- Potřebujete data zpracovat v Excelu před importem
- Chcete data analyzovat nebo archivovat
- Importujete do vlastního systému
Výhody Excel exportu:
- Formátovaná tabulka s barevnými záhlavími
- Položky faktur na samostatném listu
- Správné formátování čísel a datumů
- Připraveno pro přímé použití v Microsoft Excel nebo Google Sheets
Struktura CSV exportu:
invoice_number;date_issued;date_due;supplier_name;supplier_ico;total_amount;vat_amount;currency
FV-2026-001;2026-02-15;2026-03-01;Firma s.r.o.;12345678;12100;2100;CZK
FV-2026-002;2026-02-16;2026-03-02;Dodavatel a.s.;87654321;5000;0;CZK
Nastavení CSV exportu:
CSV export používá tyto výchozí hodnoty optimalizované pro české prostředí:
- Oddělovač: středník (;)
- Kódování: UTF-8 s BOM (pro správné zobrazení v Excelu)
- Formát datumu: DD.MM.YYYY
API integrace
Pro pokročilé uživatele a vývojáře nabízí MIKISI REST API pro automatizované zpracování a export dat.
Základní workflow:
- Nahrání faktury přes API (POST /api/upload)
- Čekání na zpracování (GET /api/documents/{id})
- Získání vytěžených dat (GET /api/documents/{id})
- Export ve zvoleném formátu (POST /api/pohoda/export/{id})
Příklad API volání (získání dat):
GET /api/documents/123
Authorization: Bearer YOUR_ACCESS_TOKEN
Response:
{
"success": true,
"data": {
"id": 123,
"status": "extracted",
"document_number": "FV-2026-001",
"supplier_ico": "12345678",
"total_with_vat": 12100.00,
...
}
}
API dokumentace:
Kompletní API dokumentace je dostupná na mikisi.cz/api/docs. Obsahuje popis všech endpointů, příklady volání a interaktivní testování (Swagger UI).
💡 Tip: Přístup k API získáte po přihlášení. API používá Bearer token autentizaci — token získáte přes endpoint /api/auth/login.
Vlastní exportní formát
Pokud používáte vlastní účetní systém nebo máte specifické požadavky na formát dat, můžete využít:
1. JSON export
Surová data v JSON formátu přes API. Obsahuje všechna vytěžená pole včetně metadata (confidence score, validační upozornění).
2. Webhook notifikace (plánováno)
Připravujeme možnost automatického odeslání webhook notifikace po zpracování faktury. Váš systém data přijme a zpracuje podle vlastní logiky. Pokud máte zájem o early access, kontaktujte nás.
3. Custom export template
Pro enterprise zákazníky nabízíme možnost vytvoření vlastního exportního formátu. Kontaktujte nás na [email protected] pro konzultaci.
Často kladené otázky
Co když import do Pohody selže?
Nejčastější příčiny: nesprávná verze Pohody (XML import podporují verze od 2015), importujete do špatné agendy, nebo soubor obsahuje neplatná data. Zkontrolujte chybovou hlášku v Pohodě — obvykle přesně říká, co je špatně.
Můžu exportovat i položky faktury?
Ano, pokud MIKISI vytěžila položky (název, množství, jednotková cena), jsou součástí exportu. V Pohoda XML jsou v sekci invoiceDetail/invoiceItem. V Excel exportu jsou položky na samostatném listu. Ne všechny faktury mají položky — jednořádkové faktury obsahují jen celkovou částku.
Jak řešit duplicity při opakovaném importu?
Pohoda kontroluje číslo faktury a datum. Pokud se pokusíte importovat fakturu, která už v systému je, import se odmítne s upozorněním. To je ochrana proti duplicitám — nechte ji zapnutou.
Můžu exportovat faktury hromadně?
Ano, v seznamu dokladů můžete vybrat více faktur najednou (Ctrl+klik nebo zaškrtávací políčka) a exportovat je do jednoho souboru. Limit je 500 faktur na jeden export.
Podporuje MIKISI přímé napojení na Pohodu (mServer)?
Ano! Přímá integrace s Pohoda mServer je v beta testování. Umožňuje odesílat doklady přímo do Pohody bez nutnosti ručního importu XML. Pokud máte zájem o aktivaci, kontaktujte nás.
Kdy bude hotový export do Money S3?
Pracujeme na implementaci podle oficiální specifikace Money S3. Pokud používáte Money S3 a chcete nám pomoci s testováním, napište na [email protected] — rádi vás zapojíme do beta testování.
Shrnutí
MIKISI podporuje export do hlavních účetních systémů na českém trhu — Pohoda (XML včetně pokladních dokladů) a univerzální CSV/Excel. Export do Money S3 je ve vývoji. Pro pokročilé integrace je k dispozici REST API. Výběr formátu závisí na vašem účetním systému a workflow. Pro většinu uživatelů je XML export do Pohody nejjednodušší cesta.
Potřebujete pomoc s integrací?
Napište na [email protected] — pomůžeme s nastavením exportu pro váš konkrétní systém.