/ API
Obecné Jak začít PAMICA POHODA
Kontakty

XML validace


Správná validace XML souborů před jejich odesláním do Pohody je klíčová pro bezproblémovou komunikaci. Pomáhá odhalit chyby dříve, než dojde k pokusu o import/export dat.


Proč validovat XML?

  • Zajišťuje, že struktura XML odpovídá očekávanému formátu dle XSD schématu.
  • Pomáhá předejít chybám typu „neznámý element“, „chybějící povinný údaj“ nebo „neplatný datový typ“.
  • Umožňuje rychlejší ladění a vyšší spolehlivost integrace.

Kde získat XSD schémata?

  • Oficiální XSD schémata poskytuje STORMWARE jako součást dokumentace k XML komunikaci.
  • Obvykle jsou dostupná v instalační složce Pohody nebo ke stažení na webu STORMWARE.

Doporučený postup validace

  • Získejte odpovídající XSD schéma pro danou agendu (např. invoice.xsd).
  • Validujte XML soubor proti tomuto schématu pomocí výše uvedených nástrojů.
  • Zkontrolujte výstup – pokud se objeví chyba, opravte ji před odesláním do Pohody.
  • Testujte na testovací databázi, pokud je to možné.

Validace XML

Validaci lze provést pomocí nástrojů jako XML Schéma Validator nebo v IDE (např. Visual Studio Code, Oxygen XML).


Nejčastější chyby při validaci

  • Chybějící namespace – např. xmlns:inv="http://www.stormware.cz/schema/version_2/invoice.xsd".
  • Nesprávné pořadí elementů – XML musí odpovídat přesně definici ve schématu.
  • Neznámé nebo chybně zadané elementy – např. invoceHeader místo invoiceHeader.
  • Neplatný formát data – např. 19.08.2025 místo 2025-08-19.

Validace XML pomocí nástroje XML Schema Validator

Aplikace XML Schema Validator slouží k obecné validaci XML souborů podle zadaného XSD schématu. Je to doporučený nástroj pro ladění chyb při XML komunikaci s programem POHODA.

Aplikace XML Schema Validator slouží pro obecnou validaci souborů XML dle zadaného schématu.

Pokud xml import/export není korektní a požadavek je nevalidní, XML Schema Validator vám usnadní práci a vypíše v sekci pro Log podrobné informace, které se týkají daného požadavku. Dozvíte se umístění daného problému a výpis chyby, kterou je nutné opravit dle schématu.