Je export JSON a odesílací formát verteco-invoice/1 totéž?

Ne, jsou to dvě struktury. Export JSON je přečtený obsah existujících dokladů (strany, součty, rekapitulace DPH, položky) určený ke čtení a integracím. Formát verteco-invoice/1 je zápis polí formuláře, z něhož e-fakturu sestavíme my; kořen má format, volitelný _comment a pole invoices, přijmeme však i samotný objekt faktury nebo seznam faktur.

Která pole jsou při odesílání z JSON povinná?

invoiceNumber, issueDate (RRRR-MM-DD), customer.name spolu s customer.dic nebo customer.peppolId a lines s poli description, quantity, unitPrice a vatRate (23, 19, 5 nebo 0). Volitelné jsou docType (380 faktura, 381 dobropis, 383 vrubopis, 389 a 261 self-billing), deliveryDate, dueDate, buyerReference, originalInvoiceNumber a originalInvoiceDate u dobropisu, iban, paymentRef (variabilní symbol), note, exemptionReason u sazby 0, line.detail (popis položky, BT-154), line.unit, line.discount a line.discountIsPct.

Jaká omezení má odesílání z JSON?

Ze souboru posíláme jen faktury v EUR, pro jinou měnu použijte formulář. Sazby DPH musí být 23, 19, 5 nebo 0 s uvedeným důvodem osvobození, IČO odběratele má 8 číslic a země je dvoupísmenný kód. Dosažitelnost odběratele v síti Peppol, splatnost a důvod osvobození kontroluje portál stejně jako u formuláře a CSV.

Mohu export JSON stahovat automaticky?

Ano. Koncový bod export.json portálového API přijímá parametry direction, from a to (YYYY-MM-DD) nebo seznam ids konkrétních dokladů, nejvýše 500 najednou. Přihlásíte se API tokenem z levého menu API tokeny (záložka API klíče, tlačítko Vytvořit token); token vidí jen firmy, pro které jste ho vytvořili.

Je JSON vhodný i pro můj účetní program?

JSON je určen vývojářům a vlastním integracím. Pro účetní programy jsou v sekci Exporty připraveny nativní formáty (POHODA, MK-soft, MRP-K/S, Money S3, Money S4, KROS OMEGA, KROS ALFA plus, PROLUC) a ISDOC, které program načte přímo.

Propojení je zdarma. Služba stojí od €2/měs bez DPH za IČO, které odesílá nebo má zapnutý Archiv dat; příjem s vypnutým archivem je zdarma (do 1 000 faktur měsíčně). Během dobrovolného období před mandátem 1. 1. 2027 je všechno bezplatné.

Integrace / Univerzální formáty / JSON

E-faktury ve formátu JSON: export i odesílání

Export + import

JSON v portálu Verteco slouží dvěma směrům. Export JSON v sekci Exporty vrátí kompletní data přijatých i odeslaných dokladů přečtená z originálního XML: obě strany s IČO, DIČ a IČ DPH, součty, rekapitulaci DPH podle sazeb a jednotlivé položky; právě z tohoto souboru se v prohlížeči skládá i export do Excelu. K odesílání slouží jednoduchý formát verteco-invoice/1 v záložce Odeslat souborem: stejná pole jako formulář, váš skript je zapíše do souboru a e-fakturu podle Peppol BIS 3.0 sestavíme a odešleme my.

Dokumentace výrobce ↗

Získat plugin v portálu Vytvořit účet zdarma

Jak to funguje

1Export: v levém menu otevřete Exporty, vyberte firmu, směr dokladů a případně období Od data a Do data, potom v části Univerzální formáty klikněte u karty JSON (.json) na Stáhnout. Získáte soubor peppol-doklady.json.
2Zpracujte ho ve vlastním systému: kořen má pole company, generatedAt, count a documents. Každý doklad nese 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).
3Automatizace: stejný JSON vrátí koncový bod export.json portálového API s parametry direction, from, to nebo ids (nejvýše 500 dokladů). API token si vytvoříte v levém menu API tokeny, záložka API klíče, tlačítko Vytvořit token.
4Odesílání: na stránce Odeslat eFakturu otevřete záložku Odeslat souborem, zvolte JSON a klikněte na Stáhnout vzorový JSON (předvyplněný). Vzor má formát verteco-invoice/1, dodavatele, číslování, splatnost a IBAN vaší firmy a vysvětlivku všech polí; stačí nahradit vzorového odběratele a položky.
5Hotový soubor s jednou fakturou nebo seznamem faktur nahrajte. Portál zkontroluje pole, ukáže náhled s částkami a po vašem potvrzení faktury odešle přes síť Peppol; stav doručení a doručenku MLS potom vidíte u každé faktury.

Co integrace řeší

✓Export JSON čte údaje z originálního XML: obě strany s IČO, DIČ a IČ DPH, součty, rekapitulace DPH podle sazeb a položky
✓Stejná data jako export do Excelu: sešit se skládá v prohlížeči právě z tohoto JSON, takže se nikdy nerozejdou
✓Odesílání ve formátu verteco-invoice/1: stejná pole jako formulář (customer, lines, dueDate), částky a DPH dopočítáme a e-fakturu sestavíme my
✓Vzorový soubor předvyplněný vaší firmou (číslování, splatnost, IBAN a poznámka z Nastavení faktur) s vysvětlivkou polí; vzorového odběratele portál odmítne, takže vzor nikdy neodejde omylem
✓Tolerantní vstup: čísla jako číslo nebo text (i 1 250,50), data RRRR-MM-DD nebo D.M.RRRR; neznámé pole se nahlásí, klíče začínající _ se ignorují
✓Dodavatelem je vždy firma zvolená v portálu; soubor, který uvádí jinou firmu, portál odmítne

Časté otázky: e-faktury pro JSON

Je export JSON a odesílací formát verteco-invoice/1 totéž?: Ne, jsou to dvě struktury. Export JSON je přečtený obsah existujících dokladů (strany, součty, rekapitulace DPH, položky) určený ke čtení a integracím. Formát verteco-invoice/1 je zápis polí formuláře, z něhož e-fakturu sestavíme my; kořen má format, volitelný _comment a pole invoices, přijmeme však i samotný objekt faktury nebo seznam faktur.
Která pole jsou při odesílání z JSON povinná?: invoiceNumber, issueDate (RRRR-MM-DD), customer.name spolu s customer.dic nebo customer.peppolId a lines s poli description, quantity, unitPrice a vatRate (23, 19, 5 nebo 0). Volitelné jsou docType (380 faktura, 381 dobropis, 383 vrubopis, 389 a 261 self-billing), deliveryDate, dueDate, buyerReference, originalInvoiceNumber a originalInvoiceDate u dobropisu, iban, paymentRef (variabilní symbol), note, exemptionReason u sazby 0, line.detail (popis položky, BT-154), line.unit, line.discount a line.discountIsPct.
Jaká omezení má odesílání z JSON?: Ze souboru posíláme jen faktury v EUR, pro jinou měnu použijte formulář. Sazby DPH musí být 23, 19, 5 nebo 0 s uvedeným důvodem osvobození, IČO odběratele má 8 číslic a země je dvoupísmenný kód. Dosažitelnost odběratele v síti Peppol, splatnost a důvod osvobození kontroluje portál stejně jako u formuláře a CSV.
Mohu export JSON stahovat automaticky?: Ano. Koncový bod export.json portálového API přijímá parametry direction, from a to (YYYY-MM-DD) nebo seznam ids konkrétních dokladů, nejvýše 500 najednou. Přihlásíte se API tokenem z levého menu API tokeny (záložka API klíče, tlačítko Vytvořit token); token vidí jen firmy, pro které jste ho vytvořili.
Je JSON vhodný i pro můj účetní program?: JSON je určen vývojářům a vlastním integracím. Pro účetní programy jsou v sekci Exporty připraveny nativní formáty (POHODA, MK-soft, MRP-K/S, Money S3, Money S4, KROS OMEGA, KROS ALFA plus, PROLUC) a ISDOC, které program načte přímo.
Kolik to stojí?: Propojení je zdarma. Služba stojí od €2/měs bez DPH za IČO, které odesílá nebo má zapnutý Archiv dat; příjem s vypnutým archivem je zdarma (do 1 000 faktur měsíčně). Během dobrovolného období před mandátem 1. 1. 2027 je všechno bezplatné.

Začněte ještě dnes: stačí výběr na portálu Finanční správy

Příjem zdarma · bez závazků a skrytých poplatkůSplňte si zákonnou povinnost 2027 za 2 minuty

Vybrat Verteco na portálu Finanční správy →Na portálu kliknete na „Pokračovať" (Pokračovat), přihlásíte se (slovensko.sk / eID nebo přihlašovací údaje do portálu FS) a potvrdíte výběr, zbytek zařídíme automatickyCertifikovaný poskytovatel Finanční správy (EFSK000031) · bez závazku · poskytovatele můžete kdykoli změnit

Jak výběr probíhá? (3 kroky, ~2 minuty)

1Kliknete na tlačítko výše, otevře se oficiální stránka Finanční správy „Výber certifikovaného poskytovateľa" (Výběr certifikovaného poskytovatele) s předvybraným Verteco. Kliknete na „Pokračovať" (Pokračovat).
2Přihlásíte se do Portálu finanční správy, přes slovensko.sk (eID / občanský průkaz s čipem) nebo svými přihlašovacími údaji do PFS, a potvrdíte výběr poskytovatele.
3Hotovo, přijde vám e-mail s přihlášením. Účet, firmu i registraci v síti Peppol vytvoříme automaticky. Pokud váš příjem už drží jiný poskytovatel, záznam nepřebíráme: pošleme vám postup s migračním kódem, nebo si v portálu zvolíte, že příjem zůstává u něj a přes nás jen odesíláte.
Nemáte eID? Na portál Finanční správy se přihlásíte i identifikátorem a heslem (přihlašovací údaje PFS). Případně se zaregistrujte e-mailem a heslem, firmu přidejte ručně a výběr dokončete později.
Nevidíte svou firmu ve výběru daňového subjektu? Nabízejí se jen subjekty, ke kterým máte na portálu FS autorizaci. Přidejte si ji v Osobní internetové zóně (Autorizácie → Pridať autorizovaného používateľa) a výběr dokončíte.
Podrobný návod k výběru na portálu FS (slovensky) →

Související: Peppol ověření firmy · průvodce e-fakturou 2027 · ceník · všechny integrace