Prehľad systémových aktualizácií

Aktualizácia systému — september 2026

API a integrácie

• API dokumentácia je po novom referenčná https://test.postarflowis.sk/api
• X-Account-Id je voliteľné pre V1 document listings
  GET /api/v1/sent-documents
  GET /api/v1/received-documents
• Webhook popisy boli prevedené do centrálnej dokumentácie  https://test.postarflowis.sk/api-docs/index.html?urls.primaryName=Webhook%20Docs
• Account webhook payload obsahuje nové pole vpds_token
   Relevantné pre intermediary / registration webhook flows.
• Peppol lookup a SMP migration response obsahujú smp_registrator
   Endpoint: GET /api/v1/peppol-lookup
   SMP endpointy: /api/v1/accounts/{id}/smp-migration

Dokumenty a onboarding

• Pribudla možnosť vytvoriť aj novú faktúru
   UI: Account -> Sent documents -> New document
• PDF preview obsahuje všetky detaily dokumentu, nielen BIS povinné polia
• Pribudla default quantity; supplied company ID už nie je povinné vo vybraných document flows
• Priama podpora platby kartou pre všetky balíky
• Pribudol balík MULTI, ktorý zahŕňa až 30 právnych subjektov pod jednou strechou
• Pribudla možnosť zmeniť vybraný balík kedykoľvek
• Pribudli priamo dostupné faktúry za balík po zaplatení účtu

Mobile a UI

• Mobilná aplikácia
• Email 2FA je viazané na konkrétny browser, ktorý si kód vyžiadal
• Self-registration terms links boli aktualizované na priamy odkaz na lokáciu na stránke
• Pribudlo fixnutie záhlavia a päty dokumentov
• Pridávanie užívateľa nad celým billing účtom s rolou koordinátor alebo druhý vlastník

Aktualizácia systému — august 2026

Augustové vydanie prinieslo nový samoobslužný onboarding, rozšírené možnosti API integrácií, lepšiu podporu sprostredkovateľov, silnejšie bezpečnostné mechanizmy a viac nástrojov pre podporu aj vývojárov.

Onboarding a účty

• Nový samoobslužný registračný proces pre zákazníkov vrátane výberu programu, potvrdenia podmienok a dokončenia registrácie.
• Možnosť zvoliť režim dokumentov už počas onboardingu.
• Podpora vlastných plánov pre zákazníkov, ktorí potrebujú individuálne nastavenie služby.
• Úprava cien, limitov a poradia zobrazovania plánov.
• Možnosť spravovať vlastníkov fakturačného účtu.
• Nová rola administrátora v zákazníckom účte.
• Presun jazykových nastavení na úroveň používateľského profilu.

API a integrácie

• Plná správa API tokenov priamo v rozhraní integrácií.
• Auditná história pri správe API prístupov.
• Odolnejšie spracovanie API požiadaviek vrátane podpory textového tela a opravy BOM prefixu.
• Webhooky pre udalosti účtu určené najmä pre sprostredkovateľov.
• Doplnenie account_id do webhook payloadov dokumentov.
• Aktualizované API príklady a dokumentácia.

Peppol

• Vyhľadávanie účastníkov cez SML/SMP.
• Spracovanie registrácií sprostredkovateľov cez schvaľovací workflow.
• Opakované pokusy pri doručovaní dokumentov cez Peppol.
• Zastavenie opakovaného odosielania v prípade, že príjemca nie je registrovaný.

Dokumenty

• Zjednotenie názvoslovia z faktúr na všeobecnejší pojem dokumentov.
• Možnosť upraviť režim dokumentov počas overovania účtu.
• Notifikácie pri neúspešne odoslaných dokumentoch.
• Zníženie počtu databázových dotazov na dashboarde a detailoch dokumentov.

Podpora a administrácia

• Nové stránky pre vývojársku podporu s prístupom k API logom, idempotency kľúčom, e-mailom, dokumentom, MLS odpovediam a pokusom o odoslanie.
• Súhlasom riadený prístup podpory k zákazníckym účtom.
• Prehľad a audit systémových zmien cez PaperTrail.
• Vylepšené prehľady zákazníckych účtov, registračných požiadaviek a plánov.
• Nová stránka Pomocník s kontaktným formulárom pre zákazníkov.

Bezpečnosť a technické jadro

• Ochrana pred brute-force útokmi a skenovaním pomocou Rack::Attack.
• Prechod na Ruby 4.0.6.
• Upgrade Rails na verziu 8.1.3.1.
• Pridanie strong_migrations pre bezpečnejšie databázové migrácie.
• Aktualizácie závislostí a opravy bezpečnostných nálezov.
• Vyčistenie nepoužívaného JavaScript kódu a zjednodušenie frontendu.

Aktualizácia systému — júl 2026

Júlové vydanie prinieslo správu používateľských rolí, detailnejší prehľad životného cyklu dokumentov, ďalšie možnosti API a posilnenie bezpečnosti účtov.

API

• Nový API endpoint pre vyhľadávanie v Peppol Directory a overenie dostupnosti účastníka siete Peppol cez API.
• Používateľské API na správu používateľov a ich rolí v rámci zákazníckeho účtu.
• Režim dokumentov v Accounts API, napríklad v požiadavkách POST /accounts a PATCH /accounts, vrátane hodnoty režimu odosielania a prijímania.
• Ochrana overených účtov pred zmenami citlivých údajov, ako sú identifikátor účastníka, daňové identifikačné číslo alebo krajina.
• Filtrovanie prijatých dokumentov podľa toho, či už boli alebo neboli stiahnuté.
• Predvolené zoradenie prijatých a odoslaných dokumentov od najnovších.

Účty a používatelia

• Nové používateľské roly: vlastník, administrátor, spracovateľ a čitateľ.
• E-mailové pozvánky pre nových používateľov.
• Možnosť deaktivácie používateľa prostredníctvom podpory.

Dokumenty

• Časová os dokumentu zobrazujúca jeho vytvorenie, zaradenie na odoslanie, pokus o doručenie, MLS odpoveď a dokončenie spracovania.
• Podrobnejšie informácie o chybách pri neúspešnom doručení.
• Ochrana produkčného prostredia pred odoslaním dokumentu rovnakému účastníkovi.

Peppol

• Spracovanie MLS správ o prijatí alebo odmietnutí dokumentu.
• Vyhľadávanie v Peppol Directory dostupné v používateľskom rozhraní aj cez API.

Bezpečnosť

• Príprava penetračného testovania vrátane testovacích účtov, rozsahu testovania, povolených adries, kontaktov a obmedzení.
• Základ pre silnejšie overovanie používateľov a dvojfaktorovú autentifikáciu.
• Kontroly oprávnení pri správe používateľov a zákazníckych účtov.

Používateľské rozhranie

• Informačná stránka SAPI s príkladom použitia endpointu.
• Vylepšené filtre v správe zákazníckych účtov pre podporu.
• Zdieľané filtre naprieč jednotlivými zobrazeniami.
• Prehľadnejšie zobrazenie dostupných akcií dokumentu.

Technické jadro

• Refaktoring tried na vyhľadávanie, filtrovanie a zoraďovanie údajov.
• Textové hodnoty enumov pre stabilnejšie dátové modely.
• Usporiadanie modelov do samostatných menných priestorov.

Aktualizácia systému — jún 2026

V júni sme rozšírili overovanie účastníkov siete Peppol, spresnili stavové informácie dokumentov a doplnili nástroje pre používateľov aj zákaznícku podporu.

API

• Aktualizovaná API dokumentácia s jasnejšími popismi a odkazmi na sekcie API a SAPI.
• Zjednotené API odpovede v scenároch Swagger a Postman.
• Údaj invoice_mode v odpovedi účtu, napríklad pri GET /account.
• Úprava stavov dokumentu v API a odstránenie nevhodného manuálneho prechodu do stavu ready_to_send.
• Presnejšie API správy pri nedostupnom príjemcovi v sieti Peppol.

Peppol

• Vyhľadávanie v Peppol Directory podľa názvu, IČO, IČ DPH, DIČ alebo Peppol ID.
• Kontrola dostupnosti účastníka pred odoslaním dokumentu.
• Prepracované odosielanie cez Oxalis s kvalitnejšími údajmi o poskytovateľovi, identifikátorom požiadavky a zachytením chýb pri odosielaní.
• Prepracované prijímanie cez Oxalis so zaznamenaním údajov o odosielateľovi a poskytovateľovi pre reportovanie a stavové odpovede.
• Zrozumiteľnejšie chybové správy pri doručovaní.

Dokumenty

• PDF náhľad a export s údajmi o dodávateľovi, napríklad BT-33, právna forma alebo doplňujúce údaje dodávateľa.
• Zobrazenie merných jednotiek v PDF náhľade, napríklad kus, kilogram, meter, liter, hodina, balenie alebo paleta.
• Možnosť použiť MLS odpovede aj pre iné typy dokumentov než štandardné faktúry, napríklad pre TDD dokumenty.
• Stavové prechody dokumentov, napríklad ready_to_send → sent, sent → accepted a sent → rejected.
• Denné upozornenia na prijaté faktúry so súhrnom nevyriešených dokumentov.

Používateľské rozhranie

• Klikateľné položky na dashboarde smerujúce priamo na detail odoslaného alebo prijatého dokumentu.
• Aktualizované sekcie profilu a zabezpečenia.
• Samostatnejšie a prehľadnejšie zobrazenie predplatného v ľavom menu a nastaveniach účtu.
• Vizuálne odlíšenie testovacieho, vývojového a produkčného prostredia.

Podpora

• Rozšírená diagnostika dokumentov o filtre, zoraďovanie, počet výsledkov a informácie o odosielajúcom a prijímajúcom účte.
• Prehľad jednotlivých pokusov o odoslanie.
• Zaznamenávanie e-mailovej komunikácie a sledovanie stavu doručenia správ.

Technické jadro

• Usporiadanie modelov do menných priestorov pre stabilnejší budúci vývoj.
• Samostatný dátový model pre TDD dokumenty.
• Refaktoring položiek dokumentov, daňových súhrnov a doplňujúcich údajov.
• Príprava produkčného prostredia vrátane aplikácie, databázy, Redis, služieb Oxalis a validátora.

Aktualizácia systému — máj 2026

Májové vydanie položilo základy pre spracovanie ďalších typov dokladov, registráciu slovenských účastníkov v sieti Peppol a spoľahlivejšiu automatizáciu systému.

API

• Webhook údaje na fakturačných účtoch: webhook_slug, šifrovaný webhook_secret a priradenie prichádzajúceho webhooku k správnemu zákazníckemu účtu.
• Spracovanie webhooku nového zákazníka po výbere Digitálneho poštára v externom registračnom procese.
• Rozšírené chybové odpovede API pri problémoch v sieti Peppol, napríklad keď je príjemca nedostupný alebo sa v sieti nenachádza.
• Podpora viacerých typov dokumentov v parseri: faktúra, dobropis, faktúra vystavená odberateľom a dobropis vystavený odberateľom.

Dokumenty

• Podpora dobropisov a dokladov vystavených odberateľom pri spracovaní a validácii.
• Front dokumentov určený pre podporu a diagnostiku.
• Jasné rozlíšenie smeru dokumentu: odoslaný alebo prijatý.

Peppol

• SMP konfigurácia pre Slovensko.
• Základ pre registráciu slovenských účastníkov v infraštruktúre Peppol.

Účty a používatelia

• Informácie o predplatnom v používateľskom profile.
• Základné údaje o balíku: typ služby, platnosť, obdobie a účasť v registračnom programe.

Prevádzka systému

• Spracovanie úloh na pozadí pomocou Sidekiq.
• Odosielanie systémových e-mailov.
• Technické upratanie systému po vyhodnotení MVP verzie.