Na čo sa Kvitos napojí

Prepojenie cez API Shoptetu. O novej objednávke sa Kvitos dozvie webhookom a vystaví z nej faktúru; podpis webhooku sa overuje, takže neoverené doručenie sa zahodí.

Doplnok do WordPressu. Ku každej objednávke vystaví faktúru, ku každému vráteniu dobropis. Stav objednávky, pri ktorom sa fakturuje, si nastavíte.

Modul do PrestaShopu. Faktúra pri vytvorení objednávky alebo až po zaplatení, dobropis z opravného dokladu.

Doklady sa zapisujú priamo cez REST rozhranie KROSu — nie je čo sťahovať a nikam nahrávať. Token si zákazník vygeneruje v KROS Fakturácii.

Export dávky dokladov v tvare, ktorý OMEGA a ALFA naimportujú.

Export dávky dokladov vo formáte, ktorý POHODA naimportuje.

Export dávky dokladov pre Money S3.

Export dávky dokladov pre účtovný systém MRP.

Neutrálne formáty pre program, ktorý vlastný adaptér nemá: ISDOC, UBL 2.1 a CSV s riadkom na každú sadzbu DPH. Kvitos vie CSV aj načítať — prijaté doklady z iného programu sa dajú naimportovať.

Jedno pripojenie pre účty v Tatra banke, Slovenskej sporiteľni, VÚB, ČSOB, Raiffeisen banke, Fio a UniCredit (aj Air Bank, Česká spořitelna, Komerční banka a ČSOB v Česku). Zákazník sa prihlási do svojej banky a vyberie účty; faktúry sa potom označia ako zaplatené samy. Z Kvitosu ide aj platobný príkaz — potvrdzuje ho zákazník vo svojom internetbankingu.

Pohyby sa sťahujú tokenom, ktorý si zákazník vygeneruje sám v internetbankingu — bez zmluvy navyše. Žiadajte výhradne token na čítanie; Fio vie vydať aj taký, ktorý platby zadáva.

Pre banku bez rozhrania: výpis v tvare dátum, suma, mena, variabilný symbol a meno. Párovanie prebieha rovnako ako pri Fiu.

Slovenský prístupový bod do siete Peppol. Odosiela vydané doklady, prijíma doklady od dodávateľov a nesie hlásenie údajov Finančnej správe.

Druhý prístupový bod do siete Peppol. Doklady odosiela a prijaté doručuje späť webhookom.

Karta aj bankové tlačidlo. Firma má u Comgate vlastnú zmluvu a vlastné číslo obchodníka; platbu v jej mene vytvoríme my, peniaze idú na jej účet. Oznámenie o zaplatení sa overuje a faktúra sa označí za uhradenú.

Všeobecný adaptér pre bránu, ktorá platbu vytvorí volaním REST API a vráti adresu, kam poslať platiteľa. Nastavuje ho prevádzkovateľ; názvy polí sa dolaďujú na konkrétneho poskytovateľa.

QR kód na faktúre. Zákazník ho načíta v mobilnej banke a platobný príkaz má predvyplnený vrátane variabilného symbolu.

Celá aplikácia je postavená nad tým istým rozhraním, ktoré dostanete vy. Idempotentné zápisy, stránkovanie cez cursor, stabilné kódy chýb a OpenAPI špecifikácia dostupná bez prihlásenia.

Kvitos oznámi, že doklad bol vystavený, uhradený, doručený alebo nahlásený. Doručenie je podpísané, opakuje sa pri výpadku a je vidieť v logu.

Pre aplikáciu, ktorá pracuje v mene cudzích zákazníkov: zákazník sa prihlási u nás a udelí jej rozsahy, ktoré si vypýtala. Nikto nikam neprepisuje API kľúč.

Klient, ktorý drží idempotency kľúč naprieč opakovaniami, rozlišuje chyby stabilným kódom a overí podpis webhooku nad surovým telom. Pre Laravel aj service provider s hotovou webhook cestou.

Skladá sa z toho, čo tieto nástroje potrebujú: OAuth na prihlásenie, webhooky ako spúšťače s pomenovanými udalosťami a ukážkovým telom a REST API na akcie. Hotový konektor v ich katalógu zatiaľ nie je — scenár sa zostavuje cez všeobecný HTTP modul.

Prehľad vydaných dokladov ako CSV. Tabuľka si ho načíta odkazom, takže sa prepočíta sama a nikto nič nekopíruje ručne.

AI asistent sa vie pozrieť na faktúry a odpovedať, kto dlhuje a čo je po splatnosti. Vystaviť doklad nevie — koncept áno, vystavenie stlačí človek.