Pole po poli: ťahák k exportu do Pohody

Ak sa staráte o stranu Pohody v integrácii s Acadsys, majte tento prehľad pri ladení otvorený. Pri každom poli je XML element, na ktorý sa mapuje, a formát, ktorý Pohoda očakáva.

Obálka dokumentu

Každý import z Acadsys do Pohody je jeden element `<dat:dataPackItem>` v obálke `<dat:dataPack>`. Atribút verzie je pevne nastavený na `2.0`, aby zodpovedal Stormware JAXB v2. Názov aplikácie je nastavený na „StwPh_9999“. Podľa tejto hodnoty Pohoda rozpozná import z externého systému. Nemeňte ju, inak Pohoda dokument bez upozornenia odmietne.

Polia hlavičky

• `Ico` (IČO dodávateľa): 8 číslic, bez úvodnej nuly, bez predpony krajiny. IČO už musí byť v adresári Pohody, inak import založí nového dodávateľa s automaticky prideleným ID. Väčšina tímov preto dodávateľov synchronizuje vopred.
• `Dic` (IČ DPH dodávateľa): vrátane predpony SK (napr. SK1234567890). Pri dodávateľoch, ktorí nie sú platiteľmi DPH, element úplne vynechajte. Neposielajte prázdny reťazec.
• `Faktura` (číslo faktúry): variabilný symbol, najviac 10 znakov, alfanumerický. Úvodné nuly v XML zostávajú, aj keď ich Pohoda pri importe upraví.
• `DatVyst` (dátum vystavenia): ISO 8601, `YYYY-MM-DD`. Formát DD.MM.YYYY Pohoda v XML importe neprijme. Funguje len pri ručnom zadávaní v desktopovej aplikácii.
• `DatDod` (dátum dodania): rovnaký formát. Nepovinné. Ak chýba, Pohoda použije dátum vystavenia.
• `DatSplat` (dátum splatnosti): rovnaký formát. Ak chýba, dopočíta sa z predvolených platobných podmienok dodávateľa.

Položky faktúry

Každá položka je `<dat:invItem>` s nasledujúcou štruktúrou. Najčastejšia chyba, ktorú vidíme, je v poli `Mnozstvi` (množstvo). V XML je to desatinné číslo, nie reťazec. Ak ho pošlete ako reťazec, import prejde, ale množstvo sa načíta ako nula a účtovníčka musí každý riadok opraviť ručne.

• `Popis`: voľný text, najviac 255 znakov. Pohoda dlhší text bez upozornenia odreže, preto ho Acadsys skráti už pred exportom.
• `Mnozstvi` (množstvo): desatinné číslo s bodkou ako oddeľovačom. Pre jednotlivé kusy posielame `1.000`, aby sme sa vyhli chybám pri porovnávaní desatinných čísel.
• `JednotkovaCena` (jednotková cena): desatinné číslo bez DPH. Oddeľovač je tiež bodka.
• `SazbaDPH` (sadzba DPH): celé percento, teda `23`, `19`, `5` alebo `0` (sadzby platné od roku 2025). Pri riadkoch oslobodených od DPH sa element vynechá.
• `Stredisko`: alfanumerický kód, ktorý musí existovať v číselníku stredísk v Pohode. Acadsys ho pred exportom overí voči záznamu dodávateľa.

Štyri hraničné prípady, pri ktorých import zlyháva

Tieto štyri situácie tvoria zhruba 80 % požiadaviek na podporu typu „import zlyhal“. Ak vám import nefunguje, prejdite ich v tomto poradí:

• IČO nesedí: IČO dodávateľa z Acadsys v Pohode neexistuje. Riešenie: zosynchronizujte zoznam dodávateľov alebo dodávateľa v Pohode vopred založte s rovnakým IČO a až potom spustite import.
• Chýba stredisko: kód strediska v zázname dodávateľa je prázdny alebo nesprávny. Riešenie: v Acadsys doplňte stredisko do záznamu dodávateľa a exportujte znova.
• Sadzba DPH nie je v osnove: účtová osnova Pohody má pevný zoznam sadzieb DPH (od roku 2025: 23 %, 19 %, 5 %, 0 %). Ak dodávateľ použije inú sadzbu, import na danom riadku zlyhá. Riešenie: zaokrúhlite sadzbu na najbližšiu štandardnú alebo ju po importe v Pohode opravte po riadkoch.
• Dátum splatnosti v minulosti: Pohoda upozorní, ale import nezastaví. Upozornenie sa zapíše do logu importu. Ak tím log sleduje, dokument uvidí. Ak nie, dokument sa naimportuje bez chyby a upozornenie zapadne. Riešenie: nastavte cron úlohu, ktorá log prenesie do vášho monitoringu.

Čo dostanete od nás

Každá firma v Acadsys dostane export, validáciu XML schémy a vzorový dokument. Validácia beží pri každom exporte. Ak by dokument pri importe do Pohody neprešiel, súbor nevytvoríme a chybu zobrazíme v aplikácii. Natívny export pre nás znamená, že vieme, čo Pohoda prijme, a nie len to, čo vieme vygenerovať.