Sind der JSON-Export und das Versandformat verteco-invoice/1 dasselbe?

Nein, es sind zwei Strukturen. Der JSON-Export ist der gelesene Inhalt bestehender Belege (Parteien, Summen, MwSt.-Rekapitulation, Positionen), gedacht zum Lesen und für Integrationen. Das Format verteco-invoice/1 ist eine Aufzeichnung der Formularfelder, aus der wir die E-Rechnung bauen; die Wurzel hat format, ein optionales _comment und das Feld invoices, wir nehmen aber auch ein reines Rechnungsobjekt oder eine Liste von Rechnungen an.

Welche Felder sind beim Versand aus JSON Pflicht?

invoiceNumber, issueDate (YYYY-MM-DD), customer.name zusammen mit customer.dic oder customer.peppolId sowie lines mit den Feldern description, quantity, unitPrice und vatRate (23, 19, 5 oder 0). Optional sind docType (380 Rechnung, 381 Gutschrift, 383 Belastungsanzeige, 389 und 261 Self-Billing), deliveryDate, dueDate, buyerReference, originalInvoiceNumber und originalInvoiceDate bei einer Gutschrift, iban, paymentRef (Variabelsymbol), note, exemptionReason beim Satz 0, line.detail (Positionsbeschreibung, BT-154), line.unit, line.discount und line.discountIsPct.

Welche Grenzen hat der Versand aus JSON?

Aus einer Datei senden wir nur Rechnungen in EUR; für eine andere Währung nutzen Sie das Formular. MwSt.-Sätze müssen 23, 19, 5 oder 0 mit angegebenem Befreiungsgrund sein, die Unternehmens-ID des Kunden hat 8 Ziffern und das Land ist ein zweistelliger Code. Die Erreichbarkeit des Kunden im Peppol-Netzwerk, die Fälligkeit und den Befreiungsgrund prüft das Portal genau wie beim Formular und bei CSV.

Kann ich den JSON-Export automatisch laden?

Ja. Der Endpunkt export.json der Portal-API nimmt die Parameter direction, from und to (YYYY-MM-DD) oder eine Liste ids konkreter Belege an, höchstens 500 auf einmal. Sie melden sich mit einem API-Token aus dem linken Menü API-Tokens an (Reiter API-Schlüssel, Schaltfläche Token erstellen); das Token sieht nur die Unternehmen, für die Sie es erstellt haben.

Eignet sich JSON auch für mein Buchhaltungsprogramm?

JSON ist für Entwickler und eigene Integrationen gedacht. Für Buchhaltungsprogramme stehen im Bereich Exporte native Formate bereit (POHODA, MK-soft, MRP-K/S, Money S3, Money S4, KROS OMEGA, KROS ALFA plus, PROLUC) sowie ISDOC, das das Programm direkt einliest.

Die Anbindung ist kostenlos. Der Dienst kostet ab €2/Monat zzgl. MwSt. je Unternehmens-ID (IČO), die sendet oder das Datenarchiv eingeschaltet hat; Empfang mit ausgeschaltetem Archiv ist kostenlos (bis 1.000 Rechnungen pro Monat). Während der freiwilligen Phase vor der Pflicht ab 1. 1. 2027 ist alles kostenlos.

Integrationen / Universelle Formate / JSON

E-Rechnungen im JSON-Format: Export und Versand

Export + Import

JSON dient im Verteco-Portal zwei Richtungen. Der JSON-Export im Bereich Exporte liefert die vollständigen Daten empfangener und gesendeter Belege, gelesen aus dem Original-XML: beide Parteien mit Unternehmens-ID, Steuernummer und USt-IdNr., Summen, die MwSt.-Rekapitulation je Satz und die einzelnen Positionen; genau aus dieser Datei wird im Browser auch der Excel-Export zusammengesetzt. Zum Senden dient das einfache Format verteco-invoice/1 auf dem Reiter Per Datei senden: dieselben Felder wie das Formular, Ihr Skript schreibt sie in eine Datei und wir bauen und senden die E-Rechnung nach Peppol BIS 3.0.

Dokumentation des Herstellers ↗

Plugin im Portal holen Kostenloses Konto erstellen

So funktioniert es

1Export: öffnen Sie im linken Menü Exporte, wählen Sie Unternehmen, Richtung der Belege und gegebenenfalls einen Zeitraum Von Datum und Bis Datum, dann klicken Sie im Abschnitt Universelle Formate auf der Karte JSON (.json) auf Herunterladen. Sie erhalten die Datei peppol-doklady.json.
2Verarbeiten Sie sie in Ihrem eigenen System: die Wurzel hat die Felder company, generatedAt, count und documents. Jeder Beleg trägt direction, status, peppolMessageId, receivedAt, documentTypeCode, invoiceNumber, issueDate, dueDate, deliveryDate, taxPointDate, currency, variableSymbol, iban, buyerReference, note, supplier und customer (name, ico, dic, icDph, Adresse, peppolId), netTotal, taxTotal, grossTotal, payableAmount, das Feld vat (category, percent, base, amount, exemptionReason) und das Feld lines (id, name, quantity, unit, unitPrice, netAmount, vatCategory, vatPercent).
3Automatisierung: dasselbe JSON liefert der Endpunkt export.json der Portal-API mit den Parametern direction, from, to oder ids (höchstens 500 Belege). Ein API-Token legen Sie im linken Menü API-Tokens, Reiter API-Schlüssel, Schaltfläche Token erstellen an.
4Versand: öffnen Sie auf der Seite E-Rechnung senden den Reiter Per Datei senden, wählen Sie JSON und klicken Sie auf Muster-JSON herunterladen (vorausgefüllt). Das Muster hat das Format verteco-invoice/1, Ihr Unternehmen als Lieferant, Ihre Nummerierung, Fälligkeit und IBAN und eine Erklärung aller Felder; Sie ersetzen nur den Musterkunden und die Positionen.
5Laden Sie die fertige Datei mit einer Rechnung oder einer Liste von Rechnungen hoch. Das Portal prüft die Felder, zeigt eine Vorschau mit den Beträgen und sendet die Rechnungen nach Ihrer Bestätigung über das Peppol-Netzwerk; Zustellstatus und MLS-Bestätigung sehen Sie dann bei jeder Rechnung.

Was die Integration löst

✓Der JSON-Export liest die Daten aus dem Original-XML: beide Parteien mit Unternehmens-ID, Steuernummer und USt-IdNr., Summen, MwSt.-Rekapitulation je Satz und Positionen
✓Dieselben Daten wie der Excel-Export: die Mappe wird im Browser genau aus diesem JSON zusammengesetzt, sodass beide nie auseinanderlaufen
✓Versand im Format verteco-invoice/1: dieselben Felder wie das Formular (customer, lines, dueDate); Beträge und MwSt. berechnen wir und bauen die E-Rechnung
✓Eine mit Ihrem Unternehmen vorausgefüllte Musterdatei (Nummerierung, Fälligkeit, IBAN und der Hinweis aus den Rechnungseinstellungen) mit Erklärung der Felder; den Musterkunden lehnt das Portal ab, sodass das Muster nie versehentlich hinausgeht
✓Toleranter Input: Zahlen als Zahl oder Text (auch 1 250,50), Daten als YYYY-MM-DD oder D.M.YYYY; ein unbekanntes Feld wird gemeldet, Schlüssel mit führendem _ werden ignoriert
✓Der Lieferant ist immer das im Portal gewählte Unternehmen; eine Datei, die ein anderes Unternehmen nennt, lehnt das Portal ab

Häufige Fragen: E-Rechnungen für JSON

Sind der JSON-Export und das Versandformat verteco-invoice/1 dasselbe?: Nein, es sind zwei Strukturen. Der JSON-Export ist der gelesene Inhalt bestehender Belege (Parteien, Summen, MwSt.-Rekapitulation, Positionen), gedacht zum Lesen und für Integrationen. Das Format verteco-invoice/1 ist eine Aufzeichnung der Formularfelder, aus der wir die E-Rechnung bauen; die Wurzel hat format, ein optionales _comment und das Feld invoices, wir nehmen aber auch ein reines Rechnungsobjekt oder eine Liste von Rechnungen an.
Welche Felder sind beim Versand aus JSON Pflicht?: invoiceNumber, issueDate (YYYY-MM-DD), customer.name zusammen mit customer.dic oder customer.peppolId sowie lines mit den Feldern description, quantity, unitPrice und vatRate (23, 19, 5 oder 0). Optional sind docType (380 Rechnung, 381 Gutschrift, 383 Belastungsanzeige, 389 und 261 Self-Billing), deliveryDate, dueDate, buyerReference, originalInvoiceNumber und originalInvoiceDate bei einer Gutschrift, iban, paymentRef (Variabelsymbol), note, exemptionReason beim Satz 0, line.detail (Positionsbeschreibung, BT-154), line.unit, line.discount und line.discountIsPct.
Welche Grenzen hat der Versand aus JSON?: Aus einer Datei senden wir nur Rechnungen in EUR; für eine andere Währung nutzen Sie das Formular. MwSt.-Sätze müssen 23, 19, 5 oder 0 mit angegebenem Befreiungsgrund sein, die Unternehmens-ID des Kunden hat 8 Ziffern und das Land ist ein zweistelliger Code. Die Erreichbarkeit des Kunden im Peppol-Netzwerk, die Fälligkeit und den Befreiungsgrund prüft das Portal genau wie beim Formular und bei CSV.
Kann ich den JSON-Export automatisch laden?: Ja. Der Endpunkt export.json der Portal-API nimmt die Parameter direction, from und to (YYYY-MM-DD) oder eine Liste ids konkreter Belege an, höchstens 500 auf einmal. Sie melden sich mit einem API-Token aus dem linken Menü API-Tokens an (Reiter API-Schlüssel, Schaltfläche Token erstellen); das Token sieht nur die Unternehmen, für die Sie es erstellt haben.
Eignet sich JSON auch für mein Buchhaltungsprogramm?: JSON ist für Entwickler und eigene Integrationen gedacht. Für Buchhaltungsprogramme stehen im Bereich Exporte native Formate bereit (POHODA, MK-soft, MRP-K/S, Money S3, Money S4, KROS OMEGA, KROS ALFA plus, PROLUC) sowie ISDOC, das das Programm direkt einliest.
Was kostet das?: Die Anbindung ist kostenlos. Der Dienst kostet ab €2/Monat zzgl. MwSt. je Unternehmens-ID (IČO), die sendet oder das Datenarchiv eingeschaltet hat; Empfang mit ausgeschaltetem Archiv ist kostenlos (bis 1.000 Rechnungen pro Monat). Während der freiwilligen Phase vor der Pflicht ab 1. 1. 2027 ist alles kostenlos.

Starten Sie heute: die Auswahl auf dem Portal der Finanzverwaltung genügt

Empfang kostenlos · ohne Bindung und versteckte KostenErfüllen Sie Ihre gesetzliche Pflicht für 2027 in 2 Minuten

Verteco auf dem Portal der Finančná správa auswählen →Klicken Sie auf dem Portal auf „Pokračovať" (Weiter), melden Sie sich an (slovensko.sk / eID oder Ihre FS-Portal-Zugangsdaten) und bestätigen Sie die Auswahl. Den Rest erledigen wir automatischZertifizierter Anbieter der Finančná správa (EFSK000031) · keine Vertragsbindung · Sie können den Anbieter jederzeit wechseln

Wie läuft die Auswahl ab? (3 Schritte, ~2 Minuten)

1Klicken Sie auf die Schaltfläche oben. Die offizielle Seite der Finančná správa „Výber certifikovaného poskytovateľa" (Auswahl des zertifizierten Anbieters) öffnet sich mit vorausgewähltem Verteco. Klicken Sie auf „Pokračovať" (Weiter).
2Melden Sie sich beim Portal der Finančná správa an, über slovensko.sk (eID / Personalausweis mit Chip) oder mit Ihren PFS-Zugangsdaten, und bestätigen Sie die Anbieterauswahl.
3Fertig. Sie erhalten eine E-Mail mit den Anmeldedaten. Konto, Unternehmen und Peppol-Netzwerkregistrierung erstellen wir automatisch. Hält bereits ein anderer Anbieter Ihren Empfangseintrag, übernehmen wir ihn nicht: Sie erhalten die Anleitung mit dem Migrationscode, oder Sie legen im Portal fest, dass der Empfang dort bleibt und Sie über uns nur versenden.
Keine eID? Beim Portal der Finančná správa können Sie sich auch mit PFS-Kennung und Passwort anmelden. Oder registrieren Sie sich hier mit E-Mail und Passwort, fügen Sie Ihr Unternehmen manuell hinzu und schließen Sie die Auswahl später ab.
Ihr Unternehmen erscheint nicht bei der Auswahl des Steuersubjekts? Angezeigt werden nur Subjekte, für die Sie im FS-Portal autorisiert sind. Fügen Sie die Autorisierung in der Persönlichen Internetzone hinzu (Autorizácie → Pridať autorizovaného používateľa) und schließen Sie die Auswahl ab.
Ausführliche Anleitung zur Auswahl im FS-Portal (auf Slowakisch) →

Verwandt: Peppol-Prüfung eines Unternehmens · Leitfaden E-Rechnung 2027 · Preisliste · alle Integrationen