Je export JSON a odosielací formát verteco-invoice/1 to isté?

Nie, sú to dve štruktúry. Export JSON je prečítaný obsah existujúcich dokladov (strany, súčty, rekapitulácia DPH, položky) určený na čítanie a integrácie. Formát verteco-invoice/1 je zápis polí formulára, z ktorého e-faktúru zostavíme my; koreň má format, voliteľný _comment a pole invoices, prijmeme však aj samotný objekt faktúry alebo zoznam faktúr.

Ktoré polia sú pri odosielaní z JSON povinné?

invoiceNumber, issueDate (RRRR-MM-DD), customer.name spolu s customer.dic alebo customer.peppolId a lines s poľami description, quantity, unitPrice a vatRate (23, 19, 5 alebo 0). Voliteľné sú docType (380 faktúra, 381 dobropis, 383 ťarchopis, 389 a 261 self-billing), deliveryDate, dueDate, buyerReference, originalInvoiceNumber a originalInvoiceDate pri dobropise, iban, paymentRef (variabilný symbol), note, exemptionReason pri sadzbe 0, line.unit, line.discount a line.discountIsPct.

Aké obmedzenia má odosielanie z JSON?

Zo súboru posielame len faktúry v EUR, pre inú menu použite formulár. Sadzby DPH musia byť 23, 19, 5 alebo 0 s uvedeným dôvodom oslobodenia, IČO odberateľa má 8 číslic a krajina je dvojpísmenový kód. Dosiahnuteľnosť odberateľa v sieti Peppol, splatnosť a dôvod oslobodenia kontroluje portál rovnako ako pri formulári a CSV.

Môžem export JSON sťahovať automaticky?

Áno. Koncový bod export.json portálového API prijíma parametre direction, from a to (YYYY-MM-DD) alebo zoznam ids konkrétnych dokladov, najviac 500 naraz. Prihlásite sa API tokenom z ľavého menu API tokeny (záložka API kľúče, tlačidlo Vytvoriť token); token vidí len firmy, pre ktoré ste ho vytvorili.

Je JSON vhodný aj pre môj účtovný program?

JSON je určený vývojárom a vlastným integráciám. Pre účtovné programy sú v sekcii Exporty pripravené natívne formáty (POHODA, MK-soft, MRP-K/S, Money S3, Money S4, KROS OMEGA, KROS ALFA plus, ProLuc) a ISDOC, ktoré program načíta priamo.

Prepojenie je zadarmo. Služba stojí od €2/mes bez DPH za IČO, ktoré odosiela alebo má zapnutý Archív dát; príjem s vypnutým archívom je zadarmo (do 1 000 faktúr mesačne). Počas dobrovoľného obdobia pred mandátom 1. 1. 2027 je všetko bezplatné.

Integrácie / Univerzálne formáty / JSON

E-faktúry vo formáte JSON: export aj odosielanie

Export + import

JSON v portáli Verteco slúži dvom smerom. Export JSON v sekcii Exporty vráti kompletné dáta prijatých aj odoslaných dokladov prečítané z originálneho XML: obe strany s IČO, DIČ a IČ DPH, súčty, rekapituláciu DPH podľa sadzieb a jednotlivé položky; práve z tohto súboru sa v prehliadači skladá aj export do Excelu. Na odosielanie slúži jednoduchý formát verteco-invoice/1 v záložke Odoslať súborom: rovnaké polia ako formulár, váš skript ich zapíše do súboru a e-faktúru podľa Peppol BIS 3.0 zostavíme a odošleme my.

Dokumentácia výrobcu ↗

Získať plugin v portáli Vytvoriť účet zadarmo

Ako to funguje

1Export: v ľavom menu otvorte Exporty, vyberte firmu, smer dokladov a prípadne obdobie Od dátumu a Do dátumu, potom v časti Univerzálne formáty kliknite pri karte JSON (.json) na Stiahnuť. Získate súbor peppol-doklady.json.
2Spracujte ho vo vlastnom systéme: koreň má polia company, generatedAt, count a documents. Každý doklad nesie direction, status, peppolMessageId, receivedAt, documentTypeCode, invoiceNumber, issueDate, dueDate, deliveryDate, taxPointDate, currency, variableSymbol, iban, buyerReference, note, supplier a customer (name, ico, dic, icDph, adresa, peppolId), netTotal, taxTotal, grossTotal, payableAmount, pole vat (category, percent, base, amount, exemptionReason) a pole lines (id, name, quantity, unit, unitPrice, netAmount, vatCategory, vatPercent).
3Automatizácia: rovnaký JSON vráti koncový bod export.json portálového API s parametrami direction, from, to alebo ids (najviac 500 dokladov). API token si vytvoríte v ľavom menu API tokeny, záložka API kľúče, tlačidlo Vytvoriť token.
4Odosielanie: na stránke Odoslať eFaktúru otvorte záložku Odoslať súborom, zvoľte JSON a kliknite na Stiahnuť vzorový JSON (predvyplnený). Vzor má formát verteco-invoice/1, dodávateľa, číslovanie, splatnosť a IBAN vašej firmy a vysvetlivku všetkých polí; stačí nahradiť vzorového odberateľa a položky.
5Hotový súbor s jednou faktúrou alebo zoznamom faktúr nahrajte. Portál skontroluje polia, ukáže náhľad so sumami a po vašom potvrdení faktúry odošle cez sieť Peppol; stav doručenia a doručenku MLS potom vidíte pri každej faktúre.

Čo integrácia rieši

✓Export JSON číta údaje z originálneho XML: obe strany s IČO, DIČ a IČ DPH, súčty, rekapitulácia DPH podľa sadzieb a položky
✓Rovnaké dáta ako export do Excelu: zošit sa skladá v prehliadači práve z tohto JSON, takže sa nikdy nerozídu
✓Odosielanie vo formáte verteco-invoice/1: rovnaké polia ako formulár (customer, lines, dueDate), sumy a DPH dopočítame a e-faktúru zostavíme my
✓Vzorový súbor predvyplnený vašou firmou (číslovanie, splatnosť, IBAN a poznámka z Nastavení faktúr) s vysvetlivkou polí; vzorového odberateľa portál odmietne, takže vzor nikdy neodíde omylom
✓Tolerantný vstup: čísla ako číslo alebo text (aj 1 250,50), dátumy RRRR-MM-DD alebo D.M.RRRR; neznáme pole sa nahlási, kľúče začínajúce _ sa ignorujú
✓Dodávateľom je vždy firma zvolená v portáli; súbor, ktorý uvádza inú firmu, portál odmietne

Časté otázky: e-faktúry pre JSON

Je export JSON a odosielací formát verteco-invoice/1 to isté?: Nie, sú to dve štruktúry. Export JSON je prečítaný obsah existujúcich dokladov (strany, súčty, rekapitulácia DPH, položky) určený na čítanie a integrácie. Formát verteco-invoice/1 je zápis polí formulára, z ktorého e-faktúru zostavíme my; koreň má format, voliteľný _comment a pole invoices, prijmeme však aj samotný objekt faktúry alebo zoznam faktúr.
Ktoré polia sú pri odosielaní z JSON povinné?: invoiceNumber, issueDate (RRRR-MM-DD), customer.name spolu s customer.dic alebo customer.peppolId a lines s poľami description, quantity, unitPrice a vatRate (23, 19, 5 alebo 0). Voliteľné sú docType (380 faktúra, 381 dobropis, 383 ťarchopis, 389 a 261 self-billing), deliveryDate, dueDate, buyerReference, originalInvoiceNumber a originalInvoiceDate pri dobropise, iban, paymentRef (variabilný symbol), note, exemptionReason pri sadzbe 0, line.unit, line.discount a line.discountIsPct.
Aké obmedzenia má odosielanie z JSON?: Zo súboru posielame len faktúry v EUR, pre inú menu použite formulár. Sadzby DPH musia byť 23, 19, 5 alebo 0 s uvedeným dôvodom oslobodenia, IČO odberateľa má 8 číslic a krajina je dvojpísmenový kód. Dosiahnuteľnosť odberateľa v sieti Peppol, splatnosť a dôvod oslobodenia kontroluje portál rovnako ako pri formulári a CSV.
Môžem export JSON sťahovať automaticky?: Áno. Koncový bod export.json portálového API prijíma parametre direction, from a to (YYYY-MM-DD) alebo zoznam ids konkrétnych dokladov, najviac 500 naraz. Prihlásite sa API tokenom z ľavého menu API tokeny (záložka API kľúče, tlačidlo Vytvoriť token); token vidí len firmy, pre ktoré ste ho vytvorili.
Je JSON vhodný aj pre môj účtovný program?: JSON je určený vývojárom a vlastným integráciám. Pre účtovné programy sú v sekcii Exporty pripravené natívne formáty (POHODA, MK-soft, MRP-K/S, Money S3, Money S4, KROS OMEGA, KROS ALFA plus, ProLuc) a ISDOC, ktoré program načíta priamo.
Koľko to stojí?: Prepojenie je zadarmo. Služba stojí od €2/mes bez DPH za IČO, ktoré odosiela alebo má zapnutý Archív dát; príjem s vypnutým archívom je zadarmo (do 1 000 faktúr mesačne). Počas dobrovoľného obdobia pred mandátom 1. 1. 2027 je všetko bezplatné.

Začnite ešte dnes: stačí výber na portáli Finančnej správy

Príjem zadarmo · bez viazanosti a skrytých poplatkovSplňte si zákonnú povinnosť 2027 za 2 minúty

Vybrať Verteco na portáli Finančnej správy →Na portáli dáte „Pokračovať", prihlásite sa (slovensko.sk / eID alebo prihlasovacie údaje do portálu FS) a potvrdíte výber. Zvyšok spravíme automatickyCertifikovaný poskytovateľ (EFSK000031) · bez viazanosti · poskytovateľa môžete kedykoľvek zmeniť

Ako výber prebieha? (3 kroky, ~2 minúty)

1Kliknete na tlačidlo vyššie. Otvorí sa oficiálna stránka Finančnej správy „Výber certifikovaného poskytovateľa" s predvybraným Verteco. Kliknete „Pokračovať".
2Prihlásite sa na Portál finančnej správy, cez slovensko.sk (eID / občiansky s čipom) alebo svojimi prihlasovacími údajmi do PFS, a potvrdíte výber poskytovateľa.
3Hotovo. Príde vám e-mail s prihlásením. Účet, firmu aj registráciu v sieti Peppol vytvoríme automaticky. Ak váš príjem už drží iný poskytovateľ, záznam nepreberáme: pošleme vám postup s migračným kódom, alebo si v portáli zvolíte, že príjem ostáva u neho a cez nás len odosielate.
Nemáte eID? Na portál Finančnej správy sa prihlásite aj identifikátorom a heslom (prihlasovacie údaje PFS). Prípadne sa zaregistrujte e-mailom a heslom, firmu pridajte ručne a výber dokončte neskôr.
Nevidíte svoju firmu vo výbere daňového subjektu? Ponúkajú sa len subjekty, za ktoré máte na portáli FS autorizáciu. Pridajte si ju v Osobnej internetovej zóne (Autorizácie → Pridať autorizovaného používateľa) a výber dokončíte.
Podrobný návod k výberu na portáli FS →

Súvisiace: Peppol overenie firmy · sprievodca e-faktúrou 2027 · cenník · všetky integrácie