General
The following describes the use of the RESTful service "eDocService" for the eDoc app. The eDoc app technically consists of two components:
-
MBS Dynamics-NAV component - embedded in your NAV application and
-
the RESTful web service that handles the conversion and extraction of data.
The RESTful service is also usable for other ERP systems as part of the ZUGFeRD interface. The RESTful service does not have its own GUI.
The technical documentation of the RESTful service can be found here https://api.br-ag.com/edocservice/swagger/index.html
Access is via the internet through a RESTful API which must be integrated into the customer's system. This must be done by the customer, unless you use the MBS Dynamics-NAV component of the eDoc module from bartolome röder AG.
Inbound Requirements
-
valid security token
-
valid MSAccountID
-
valid email address
-
ZUGFeRD file to be processed in the respective formats or X-Invoice file
Outbound Requirements
-
valid security token
-
valid MSAccountID
-
valid email address
-
ZUGFeRD file to be processed in the respective formats and X-Invoice file
Outbound Function Description
The RESTful API receives a PDF and an XML file and combines them into a ZUGFeRD-compliant document according to EU standard EN 16931 and returns this document.
Inbound Function Description
The RESTful API receives a ZUGFeRD-compliant PDF or X-Invoice-compliant XML and separates the formats and extracts processing-relevant data in JSON format and passes the data to the calling system.
How do I get a security token?
The security token is generated by us based on certain customer-specific parameters and grants you access to the two functionalities Inbound/Outbound according to your agreement. The security token will be sent to you in writing and authorizes you to use the REST API. If you use the Dynamics NAV part of our ZUGFeRD interface, the token is entered in the setup parameters and automatically included with each API call. If you use the REST API with other components, you must pass the token accordingly when calling.