ZUGFeRD-Interface WebService-Online-Hilfe
Im nachfolgenden ist die Nutzung des RESTful-Services "eDocService" für die ZUGFeRD-Schnittstelle beschrieben. Die ZUGFeRD-Schnittstelle besteht technisch aus zwei Komponenten:
- MBS Dynamics-NAV-Komponente - eingebettet in Ihre NAV-Anwendung und
- der RESTful Webservice der die Konvertierung und Extraktion der Daten übernimmt.
Der RESTful-Service ist als Teil der ZUGFeRD-Schnittstelle auch für andere ERP-Verfahren einsetzbar. Der RESTful-Service verfügt über keine eigene GUI.
Die technische Dokumentation des RESTful-Services sehen Sie hier https://api.br-ag.com/edocservice/swagger/index.html
Der Zugriff erfolgt über das Internet via RESTFul API die beim Kunden in das System eingebunden werden muss. Dies ist von Kundenseite aus vorzunehmen, insofern Sie die MBS Dynamics-NAV-Komponente des ZUGFeRD-Interfaces der bartolome röder AG nicht nutzen.
Voraussetzung Inbound
- gültiger Sicherheitstoken
- gültige MSAccountID
- gültige E-Mailadresse
- zu verarbeitende ZUGFeRD-Datei in den jeweiligen Formaten oder X-Rechnungsdatei
Voraussetzung Outbound
- gültiger Sicherheitstoken
- gültige MSAccountID
- gültige E-Mailadresse
- zu verarbeitende ZUGFeRD-Datei in den jeweiligen Formaten und X-Rechnungsdatei
Funktionsbeschreibung Outbound
Das RESTful - API erhält eine PDF und eine XML-Datei und vereinte diese zu einem ZUGFeRD-konformen Beleg nach EU-Norm EN 16931 und liefert diesen Beleg zurück.
Funktionsbeschreibung Inbound
Das RESTful - API erhält eine ZUGFeRD-konforme PDF oder X-Rechnung-konforme XML und nimmt eine Format-Trennung vor und extrahiert verarbeitungsrelevante Daten im JSON-Format und übergibt die Daten an das aufrufende System.
Wie erhalte ich einen Sicherheitstoken?
Der Sicherheitstoken wird von uns anhand bestimmter, kundenspezifischer Parameter erzeugt und gewährt Ihnen Zugriff auf die beiden Funktionaltitäten Inbound/ Outbound gemäß Ihrer Vereinbarung. Der Sicherheitstoken wird Ihnen schriftlich übermittelt und authorisiert Sie zur Nutzung der REST-API. Nutzen Sie den Dynamics NAV-Teil unserer ZUGFeRD-Schnittstelle, so wird der Token in den Einrichtungsparametern eingetragen und bei jedem Aufruf der API automatisch mitgegeben. Nutzen Sie die REST-API mit anderen Komponenten, müssen Sie beim Aufruf entsprechend den Token übergeben.