Sie können herausfinden, ob Beliq das tut, was Sie brauchen, bevor Sie eine Zeile Code schreiben oder zu einem API-Key greifen. Lassen Sie eine echte Rechnung im Browser durchlaufen, lesen Sie das Ergebnis, und wechseln Sie erst zum Code, wenn Sie entschieden haben, dass es sich lohnt. Das Video ist die kurze Fassung, die ausführliche Anleitung folgt darunter.
Im Browser starten, nicht im Editor
Im Playground läuft die echte Engine, ohne Konto und ohne Key. Fügen Sie eine Rechnung ein oder nehmen Sie eines der Beispiele, und starten Sie dann: Validieren Sie eine bestehende Datei, generieren Sie eine aus einer JSON-Beschreibung, parsen Sie ein Dokument zurück in seine Felder, oder konvertieren Sie zwischen Formaten. Was zurückkommt, ist das, was auch die API liefert, denn hinter beiden steckt dieselbe Engine. Deshalb fangen Sie hier an: Sie testen das echte System, keine Sandbox, die sich in der Produktion anders verhält.
Wenn Sie lieber mit einer leeren Rechnung beginnen, füllen Sie sie im kostenlosen Generator Feld für Feld aus und erhalten am Ende eine echte Datei nach EN 16931, direkt im Browser.
Das Ergebnis ist nachprüfbar
Eine übliche Schnellstart-Anleitung endet, sobald die Anfrage 200 zurückgibt.
Bei Beliq endet sie dort nicht, denn eine zurückgegebene Rechnung nützt nur, wenn
sie wirklich gültig ist, und „gültig“ muss etwas bedeuten, auf das Sie verweisen
können.
Jedes Ergebnis nennt deshalb die angewendeten Regelsätze, ihre exakten Versionen und zu jedem einen Hash. Ein grünes Ergebnis bedeutet, dass Ihre Rechnung diese Regeln in diesen Versionen bestanden hat, und die Kennzeichnung jedes Formats zeigt, wie weit diese Prüfung reicht: die eigenen Regeln der Behörde statt der Lesart von Beliq, ein unabhängiger Regelsatz oder nur das Schema. Mit den Hashes können Sie später bestätigen, dass genau die Regeln gelaufen sind, die Beliq versioniert. Das sehen Sie im Playground, bevor Sie eine Zeile Code geschrieben haben, und das ist der ehrliche Weg, ein Compliance-Tool zu beurteilen: prüfen, was es behauptet, an der eigenen Datei.
Wenn Sie zum Code wechseln
Jeder Schritt im Browser entspricht einem Aufruf der API. Die gerade eingefügte Datei zu validieren ist ein einzelner POST mit Ihrem API-Key und der Rechnung im Body, eine Rechnung zu generieren ein POST mit dem JSON, das Sie ausgefüllt haben. Der Vorgang bleibt derselbe, Sie haben ihn nur in Ihren eigenen Code verlegt.
Die Befehle stehen im Schnellstart der Dokumentation, der mit der API aktuell gehalten wird. Dieser Beitrag druckt sie deshalb nicht ab, damit sie hier nicht veralten. Holen Sie sich einen API-Key im Dashboard, folgen Sie dem Schnellstart, und Sie haben dasselbe Ergebnis wie im Playground, nur läuft es jetzt dort, wo Sie es brauchen. Von dort aus stehen Ihnen dieselben Operationen auch über die SDKs und No-Code-Connectors zur Verfügung, falls Sie die REST-API lieber nicht direkt aufrufen.
Generieren, Validieren, Parsen und Konvertieren sind heute alle live. Die verwaltete Zustellung, also das Routing der fertigen Rechnung über das richtige EU-Netzwerk, baut Beliq als Nächstes. Bis sie verfügbar ist, senden Sie die Datei über den Access Point oder das Portal, das Sie bereits nutzen.
Von Anfang bis Ende in der EU
Ob Sie validieren oder generieren: Die Rechnung läuft durch die Systeme von Beliq in der EU, bei Hetzner, und nichts davon geht in die USA. Das Trust Center nennt jeden Unterauftragsverarbeiter und seinen Sitz. Das gilt auch im Playground: Die Datei, mit der Sie testen, bleibt innerhalb derselben Grenze wie die, die Sie in der Produktion senden.
So fangen Sie an
Der kürzeste Weg ist der aus dem Video oben: Öffnen Sie den Playground, lassen Sie eine echte Rechnung laufen, lesen Sie das Ergebnis, und übernehmen Sie denselben Vorgang in Ihren Code, sobald er sich bewährt hat. Nichts zu installieren, und kein Code, bevor Sie selbst gesehen haben, dass es funktioniert.