1

🆙 E-Rechnung mit Ninox

Hallo zusammen, 

Ninox wird mit einer neuen Funktion die e-rechnungskonformen Datenformate ZUGFeRD und XRechnung unterstĂŒtzen. Damit wird es möglich sein, elektronische Rechnungen gemĂ€ĂŸ EN16931 direkt in Ninox zu empfangen, zu erstellen und zu versenden.

Wie das aussieht, findet ihr in diesem Vorschau-Video:
Vorschau Video E-Rechnung

Wir werden umgehend informieren, sobald die neue Funktion nutzbar ist – spĂ€testens bis Ende November. Voraussichtlich ab Anfang Dezember wird sie Ninox-Kunden zur VerfĂŒgung stehen.  

Im Webinar am 12. November werden wir diese neue Funktion sowie weitere Neuerungen aus dem Solutions-Teams zeigen:

Hier geht es zur Webinar-Anmeldung 

Solutions Update

Solltet ihr Fragen haben könnt ihr diese gerne hier in den Kommentaren stellen und wir werden diese zeitnah beantworten. 

Viele GrĂŒĂŸe

Tim

74 Antworten

null
        • Tim_Genkinger
        • vor 3 WochenMon, December 16, 2024 at 7:04 PM UTC
        • Gemeldet - anzeigen

        Update: Wir haben eben die Version 3.14.1 veröffentlicht in der die E-RechnungsfunktionalitĂ€t enthalten ist. Das Template kann steht in Ninox unter den Vorlagen bei einer neuen Datenbank zur VerfĂŒgung: 

          • Tim_Genkinger
          • vor 3 WochenTue, December 17, 2024 at 10:27 AM UTC
          • Gemeldet - anzeigen

           wie ĂŒbermittelst du denn den JSON Code an den Mustang Server? FĂŒr das Auslesen der Rechnung muss einfach nur die Rechnung (E-Rechnung oder X-Rechnung) in das dafĂŒr vorgesehene Feld geladen werden. Den Rest ĂŒbernimmt Ninox bzw. die Vorlage

          • Dirk_Pulver
          • vor 3 WochenTue, December 17, 2024 at 10:42 AM UTC
          • Gemeldet - anzeigen

          meine Kunden verwenden kein carbon. Ich möchte nur XRechnung erzeugen. Mir scheint der Button "Rechnung erzeugen" im Template baut aber eine ZUGFerd Rechnung. Laut Anleitung enthĂ€lt die JSON fĂŒr XRechnung zu Beginn einen body Element - das fehlt hier....
          Ich nehme das erzeugte JSON-Objekt (bei mir in einem Textfeld, daher mit eval() ausgelesen) fĂŒr den Mustang-Server und ĂŒbermittle es gem. Anleitung an den Mustang-Server.

          let connectionName := "Mustang";
          let command := "POST /invoice2XML";
          let requestBody := eval('JSON-Objekt', this);
          let base64URL := sendCommand(connectionName, command, requestBody);
          alert(base64URL.result);
          TextOutput := parseJSON(formatJSON(base64URL)).result.body;
          

          Wenn ich das mit einer Beispiel-JSON aus der Anleitung mache, dann erhalte ich Status 200 OK und bekomme die XML-Ausgabe zurĂŒck.

          • Dirk_Pulver
          • vor 3 WochenTue, December 17, 2024 at 10:46 AM UTC
          • Gemeldet - anzeigen

          ok, scheinbar geht das Template jetzt auch auf der public cloud, dann baue ich die funktion mal direkt beim Kunden in die public cloud ein anstatt das ganze erst auf mein Modul in der private cloud zu transferieren....

          • Dirk_Pulver
          • vor 3 WochenTue, December 17, 2024 at 10:51 AM UTC
          • Gemeldet - anzeigen

           

          Ok, bekomme immer diesen Fehler, auch mit dem 1:1 verwendeten JSON aus dem Template. Wie gesagt - ich sehe da kein body-Element

          • Dirk_Pulver
          • vor 3 WochenTue, December 17, 2024 at 10:53 AM UTC
          • Gemeldet - anzeigen

          Ok, den Fehler bekomme ich jetzt auch wenn ich 1:1 den Code aus der Anleitung verwende. Wurde am Mustang-Server was verÀndert oder am Aufruf im Hintergrund ?

          • simon_woditsch
          • vor 3 WochenTue, December 17, 2024 at 11:02 AM UTC
          • Gemeldet - anzeigen

           

          Das Template sollte bei Eingabe der erforderlichen Daten valide Rechnungen erzeugen - außerhalb des Templates wĂ€re immer zu schauen, dass die gemappten Daten auch vollstĂ€ndig, in der erforderlichen Form (Typecodes) und dem erforderlichen Format mitgegeben werden.

          Der Button im Template nutzt die Funktion combine mit identischen Anforderungen wie invoice2XML, nur das via combine das XML zusĂ€tzlich noch in das parallel erzeugte PDF eingebettet wird. FĂŒr eine XRechnung in UBL gibt es dann noch die Funktion cii2ubl, die die mit invoice2XML erzeugte XML von CII in UBL umwandelt. 

          FĂŒr Testzwecke bietet sich auch die in der Dokumentation beschriebene Testumgebung des Mustang-Servers fĂŒr die einzelnen Endpunkte an, hier kann das Invoice Class JSON direkt getestet werden.
           

          • Ryszard_Paluch
          • vor 3 WochenTue, December 17, 2024 at 11:03 AM UTC
          • Gemeldet - anzeigen

          Hallo Tim

          Mit der Vorlage von : https://www.vr-smart-guide.de/xrechnung-erstellen/ funktioniert

          • Ryszard_Paluch
          • vor 3 WochenTue, December 17, 2024 at 11:04 AM UTC
          • Gemeldet - anzeigen

           Mit der Vorlage von : https://www.vr-smart-guide.de/xrechnung-erstellen/ funktioniert

          • simon_woditsch
          • vor 3 WochenTue, December 17, 2024 at 11:06 AM UTC
          • Gemeldet - anzeigen

           

          Rechnungen, die zu Fehlern fĂŒhren, gerne an  oder Support weiterleiten, wir prĂŒfen dann.

          • Dirk_Pulver
          • vor 3 WochenTue, December 17, 2024 at 11:17 AM UTC
          • Gemeldet - anzeigen

          Ok, das verstehe ich schon. Da liegt aber doch schon das erste Thema. Ich kann ja meine Kunden, die schon Rechnungen auf vielfĂ€ltige Weise erzeugen nicht dazu bringen,  jetzt in diesem Template-Modul Rechnungen  zu erzeugen. Ich muss das ganze ja immer in vorhandene Projekte einpflanzen. NatĂŒrlich nehme ich den Code aus dem Template und schaue, dass die erzeugte JSON alle Informationen enthĂ€lt. Das ist ja eigentlich nur ein Thema der gemappten Felder. Aber egal wie ich es drehe und wende, das daraus entstandene JSON wird vom Mustang-Server mit einem Fehler quitiert. Selbst wenn ich in dem Template in den Button "Rechnung erzeugen" die erzeugte Mustang-JSON an den Mustang-Server gem. Anleitung (Codeblock oben beschrieben) sende, erhalte ich den Fehler 400 und eben keine XML-Ausgabe.

          • simon_woditsch
          • vor 3 WochenTue, December 17, 2024 at 11:49 AM UTC
          • Gemeldet - anzeigen

           

          Weil Rechnungen genau wie beschrieben auf vielfĂ€ltigste (und nicht immer korrekte) Weise erstellt werden und die Rechnungslegung in der Regel auch tief in bestehende Lösungen integriert ist, ist ein one-size-fits-all Template fast nicht darstellbar, bzw. wĂŒrde uns genau die in Ninox mögliche FlexibilitĂ€t in der Gestaltung der eigenen Prozesse kosten. 

          Wir haben das Template so einfach wie möglich gehalten, um eine Integration der FunktionalitĂ€t in eigene Lösungen so gut es geht zu unterstĂŒtzen - trotzdem wird die Integration gerade in bestehende Lösungen in der Regel ein aufwĂ€ndiger Prozess sein. 
           

          In diesem Fall weist die Fehlermeldung aber vielleicht eher auf ein Problem mit dem Request selbst hin, weniger mit den Daten. 
          PĂŒfmöglichkeiten wĂ€ren neben erwĂ€hnter Testumgebung  fĂŒr die PrĂŒfung der Invoice Class auch die PrĂŒfung der Elemente des Requests, insbesondere des requestBody, ob dieser korrekt ausgegeben wird. 

          • Gotje_Ing
          • vor 3 WochenTue, December 17, 2024 at 12:09 PM UTC
          • Gemeldet - anzeigen

           
          Ich möchte an dieser Stelle darauf hinweisen, dass NICHT alle Validatoren die korrekten PrĂŒfroutinen verwenden.
          Speziell der Validator von Serivce-BW hat nur ein kleines Subset aller erlaubten/vorgegebenen Routinen und liefert leider grundsĂ€tzlich bei vielen gĂŒltigen XML Vorlagen der Kosit (Bundesstelle) und von ZUGFeRD selbst falsche Ergebnisse.
          Nach meinem aktuellen Kenntnisstand ist die Validierung ĂŒber Mustang selbst eine der besten Optionen, so komisch es klingen mag. Weitere sind z.B. Valitool (bezahldienst) und wer fit in CLI/PowerShell ist, kann sich ĂŒber Github von der Kosit ein eigenes Validierungstool zusammenbauen.
          https://github.com/itplr-kosit/validator
          Dies ist aber keine triviale Arbeit und funktioniert nur fĂŒr XML Dateien. 

          • Kemal
          • vor 3 WochenTue, December 17, 2024 at 1:17 PM UTC
          • Gemeldet - anzeigen

           Die Vorlage ist in unserer genutzten Private Cloud noch nicht aktiv.
          private cloud ist : 3.14.1

          • Kemal
          • vor 3 WochenTue, December 17, 2024 at 1:22 PM UTC
          • Gemeldet - anzeigen

          Es sieht aus wie eine Vorlage, wenn man es ins Deutsche ĂŒbersetzt!

          • Tim_Genkinger
          • vor 3 WochenTue, December 17, 2024 at 1:34 PM UTC
          • Gemeldet - anzeigen

           du musst die Sprache auf Deutsch stellen, damit die Vorlage erscheint. 

        • wolfgangmohr
        • vor 8 TagenFri, January 3, 2025 at 11:18 AM UTC
        • Gemeldet - anzeigen

        Nutzen das alte Rechnung Template fĂŒr ca 300 Ausgangsrechnungen im Jahr. Und brauchen also jetzt das eRechnung Template um die StaatsbĂŒrokratie zu bedienen. Wollen bei Ninox bleiben. Gerne möchte ich hier die erste Frage stellen: Ist Carbone nötig? (nutzen wir bisher nicht). Ist Carbone integriert oder muss ich noch KlimmzĂŒge fĂŒr die Einrichtung unternehmen? 

        Bin ich hier richtig im Forum? Höre/lese gerne von Euch (die ihr vielfach sicher Àhnliche Probleme habt) Danke schon mal!

        Wolfgang

          • Ninox-Professional
          • planoxpro
          • vor 8 TagenFri, January 3, 2025 at 11:41 AM UTC
          • Gemeldet - anzeigen

           Ja Carbone ist nötig. Die Ninox-Vorlage arbeitet mit dem ZUGFeRD-Format, das aus einer PDF/A-3-Datei mit integrierter XML besteht. Es werden also zuerst die Daten fĂŒr das PDF-File an Carbone gesendet, welches das PDF/A-3-File zurĂŒckgibt. Dieses wird dann mit den Rechnungsdaten an Mustag gesendet. Ergebnis ist eine konforme E-Rechnung im ZUGFeRD-Format mit sichtbarer PDF- und interierter XML-Datei.

          Und ja, Carbone ist Teil der Ninox-Lösung, es sind keine weiteren "KlimmzĂŒge" erforderlich.

          • Dirk_Pulver
          • vor 7 TagenSat, January 4, 2025 at 11:08 AM UTC
          • Gemeldet - anzeigen

          Hallo, ja die Ninox-Vorlage sieht Carbone vor und als E-Rechnungs Format dann ZugFERD. Um eine E-Rechnung zu erzeugen, muss man dann die Daten an den Mustang-Server senden etc.  Ich bin Partner und betreue mehrere Projekte in denen E-Rechnungen erzeugt werden mĂŒssen, aber in keinem dieser Projekte wird Carbone verwendet. Man kann alternativ als Format die XRechnung wĂ€hlen und so zu den - wie bisher erzeugten - PDF-Rechnungen einfach eine zusĂ€tzliche XML-Datei beifĂŒgen. Ich habe das dann einfach so in die vorhandenen Rechnungsprozesse  eingefĂŒgt. Die XML-Datei erzeugen geht direkt in der eigenen Ninox-Datenbank.

          • wolfgangmohr
          • vor 4 TagenTue, January 7, 2025 at 9:11 AM UTC
          • Gemeldet - anzeigen

            Hallo, habe das eRechnung template eingerichtet und die Vorjahresdaten ĂŒbernommen. Das ist zunĂ€chst ein sehr lĂŒckenhaftes Bild đŸ˜‰

          Beim Vortasten kommen Fragen auf. 
          Ich habe das logo geÀndert in den Einstellungen. Die Testrechnung zeigt allerdings das alte logo.
          Zuletzt haben wir mit 6 Einheiten gearbeitet, die angebotene Table gibt eine Auswahl von 200+ und die, die ich brauche, ist nicht dabei (per Stunde) oder (Maschinenstunde). 

          Und wie komme ich an das Carbone - Template fĂŒr Änderungen und ErgĂ€nzungen? 

          Ich bin dankbar fĂŒr Eure Hilfe. LG Wolfgang

          • simon_woditsch
          • vor 3 TagenTue, January 7, 2025 at 4:34 PM UTC
          • Gemeldet - anzeigen

          Hallo  ,
          Die E-Rechnung erfordert die Angabe bestimmter Daten wie z.B LĂ€nder, WĂ€hrungen und auch Einheiten in Form von vorgegebenen Codes. In der nĂ€chsten Version des Templates wird die Konfiguration dieser Listen stark vereinfacht. In der aktuellen Version ist es so gedacht, dass die Liste (in der Tabelle "Admin") entsprechend direkt an die eigenen BedĂŒrfnisse angepasst wird. 

          BezĂŒglich des lĂŒckenhaften Bildes können zusĂ€tzliche Felder relativ unkompliziert hinzugefĂŒgt werden, die Zuordnung ist in dem Trigger nach Änderung des Upload-Felds angesiedelt.

          Das Carbone-Template ist in den Druckvorlagen zu finden, kann heruntergeladen und entsprechend angepasst werden. Dort ( in der Kopfzeile)  ist dann auch das Firmenlogo austauschbar.

          Viele GrĂŒĂŸe
          Simon

          • simon_woditsch
          • vor 3 TagenTue, January 7, 2025 at 4:42 PM UTC
          • Gemeldet - anzeigen

           
          Wie das PDF erstellt wird ist prinzipiell egal (solange PDF/A-3), den grĂ¶ĂŸten Vorteil in der PDF-Erzeugung via JSON + Carbone sehe ich in dem dann sehr Ă€hnlichen Mapping. Der Standard erfordert ja, dass alle Informationen des XML-Parts auch in dem PDF identisch abgebildet werden. Bei relativ Ă€hnlich aufgebauter Erzeugung beider Elemente an einem Ort bzw. in einem Script hat man eine gute Übersicht ĂŒber die Angaben, gerade auch bei der Implementierung von Änderungen. Dies gilt aber nur, solange PDF/A-3 und XML dann auch zu einer ZUGFeRD Rechnung kombiniert werden. 

          Das Versenden eines normalen PDFs zusammen mit einer XRechnung, also einer reinen XML-Rechnung ist meiner Meinung nach nicht zulĂ€ssig, bzw. hat die PDF so keinerlei GĂŒltigkeit.

          • wolfgangmohr
          • vor 2 TagenThu, January 9, 2025 at 8:56 AM UTC
          • Gemeldet - anzeigen

           Danke Simon. Wenn ich das .docx habe und Änderungen (neue Logo) darin gemacht habe, muss ich die speichern. Dann verlangt Word einen anderen Speicherort oder einen anderen docx Namen. Ich dachte wohl, das dieser Name sich nicht Ă€ndern darf weil in carbone fest verbunden. Kannst Du da noch einen Tipp geben, wie das lĂ€uft? Danke und LG Wolfgang 
          (Das mit den Codes sieht ja schon gut aus)

          • simon_woditsch
          • vor 2 TagenThu, January 9, 2025 at 11:46 AM UTC
          • Gemeldet - anzeigen

           
          Hallo Wolfgang,
          wenn du auf den Reiter der Druckvorlage klickst, kannst du mit der Option "Ersetzen" deine Anpassungen hochladen, unabhÀngig von dem gewÀhlten Dateinamen. Bei neuen/zusÀtzlichen Druckvorlagen ist es in der aktuellen Version des Templates dazu wichtig, die PDF-Version auf PDF/A-3 zu setzen (in der rechten Seitenleiste).
          Viele GrĂŒĂŸe
          Simon

          • wolfgangmohr
          • gesternThu, January 9, 2025 at 4:54 PM UTC
          • Gemeldet - anzeigen

            đŸ‘