Konsolidačný balík: info pre vývojárov

Legislatívne vynútená zmena sadzieb DPH (od 1. januára 2025), o ktorej sme informovali v predchádzajúcom článku, je historicky prvou zmenou, pri ktorej sa na Slovensku plošne zavádzajú dve znížené sadzby DPH. Uvedená zmena si vyžiadala náročné úpravy v štruktúre systému OBERON, ktorý od svojho vzniku až dosiaľ pracoval len s jednou vyššou a jednou nižšou sadzbou DPH. Je potrebné mať na zreteli, že úprave podlieha každý doklad, ktorý obsahuje rekapituláciu DPH. To je alfou a omegou aj všetkých ďalších úprav, ktoré táto zmena generuje. Legislatívne vynútené úpravy sa tak netýkajú len samotného programu a jeho doplnkov (v Správcovi doplnkov), ale aj používaných transformačných šablón a komunikácie so súvisiacimi produktami a službami (predovšetkým internetovými obchodmi, ale aj ďalšími). Práve týmto úpravám je venovaný tento článok.

Súvisiace produkty a služby

Súvisiace produkty predstavujú externé softvérové a hardvérové riešenia (produkty a služby), ktoré sú rôznym spôsobom prepojené so systémom OBERON. Časť prepojení vznikla z iniciatívy firmy EXALOGIC (napr. s internetovým obchodom PrestaShop, manažérom rezervačných kanálov Beds24 atď.), iné produkty a služby boli so systémom OBERON prepojené z iniciatívy a v réžii tretích strán (napr. internetový obchod Grandus, UNIobchod, webová aplikácia Chameleoon atď.).

Kým úpravy v komunikácii so súvisiacimi produktami a službami, ktoré boli implementované z rozhodnutia firmy EXALOGIC (napr. PrestaShop, Beds24 atď.), vykoná firma EXALOGIC, úpravy v komunikácii s tými externými produktami a službami, ktoré boli s OBERON-om prepojené z iniciatívy tretích strán, sa musia vykonať v réžii ich dodávateľov.

Transformačné šablóny

V tejto súvislosti by sme chceli informovať z, že všetky potrebné zmeny súvisiace s úpravami sadzieb DPH sa musia vykonať nielen v OBERON-e, ale aj v transformačných šablónach:

• Boli vykonané úpravy v štruktúrach XML, ktoré pracujú s dokladmi obsahujúcimi rekapituláciu DPH ako výdajka, príjemka, objednávky, faktúry. Element Document_PriceValues bol nahradený novým elementom DocumentTotal.
• Z dôvodu kompatibility bude OBERON do verzie December/2025 vedieť importovať tak pôvodný formát súboru XML, ako aj nový.
• Z dôvodu kompatibility bude OBERON od verzie December/2024 exportovať obidva elementy (pôvodný, aj nový). Pôvodný element Document_PriceValues bude odstránený vo verzii December/2025.
• Ak od 1. 1. 2025 bude účtovná jednotka importovať doklady s tromi sadzbami DPH, bude nevyhnutné vykonať úpravy transformačných šablón už od uvedeného dátumu.

Nižšie sú uvedené ukážky transformačnej šablóny používanej pred 1. 1. 2025 (Obrázok č. 1) a upravenej transformačnej šablóny na použitie po 1. 1. 2025 (Obrázok č. 2).

Obrázok č. 1: Ukážka formátu súboru XML rekapitulácie dokladu pred 1. 1. 2025

Obrázok č. 2: Ukážka formátu súboru XML rekapitulácie dokladu po 1. 1. 2025

Ako získať súbory s novými štruktúrami XML?

Je potrebné mať nainštalovanú verziu OBERON-u December/2024 (Beta). V programe v danej evidencii (napr. Objednávky prijaté) vytvorte vzorový nový doklad, ktorý obsahuje základnú, zníženú a nulovú sadzbu DPH a prípadne aj cudziu menu. Stlačte tlačidlo Možnosti a vyberte položku XML komunikácia – export údajov. Otvorí sa sprievodca, v ktorom začiarknite pole Vytvoriť vzorový XML. Takto vyexportovaný súbor bude obsahovať všetky elementy a komentáre.

Vykonané úpravy v rozhraní API webových služieb

Všetky potrebné zmeny súvisiace s úpravami sadzieb DPH boli vykonané aj v rozhraní API webových služieb (Webservices):

• Boli vykonané úpravy v dátových štruktúrach, ktoré pracujú s dokladmi obsahujúcimi rekapituláciu DPH ako výdajka, príjemka, objednávky, faktúry. Element PriceValues bol nahradený novým elementom DocumentTotal. Verzia December/2024 bude z dôvodu kompatibility obsahovať obidva elementy, pričom sú obidva nepovinné (aby parser negeneroval chybu).
• Pôvodný element PriceValues bude odstránený vo verzii December/2025.
• Zmena nastala aj v dátovej štruktúre CompanySettings, ktorá bola rozšírená o nové sadzby DPH. Verzia December/2024 bude z dôvodu kompatibility obsahovať tak pôvodné, ako aj nové elementy, pričom budú všetky nepovinné (aby parser negeneroval chybu).

Uvedené zmeny sú dostupné vo verzii December/2024 (Beta).

Obrázok č. 3: Formát JSON (webové služby) – pôvodná rekapitulácia DPH v doklade (vľavo) a nová (vpravo)