Standard Webservice Interface
Introduction
Retarus' https interface is a universal receiving interface for electronic data in basically any format.
Payload / data format
The data format used corresponds to a bilaterally agreed format which, once defined, may not be changed without agreement. Transmission always takes place as a filestream.
If you would like to use a standard format as a default, please refer to the chapter “Standard E-Invoicing Format RIF.”
Authentication
Authentication requires the use of a certificate. You will receive this from Retarus during the service setup. The certificate is valid for 12 months and must be replaced at regular intervals. http only is not supported.
Alternatively Basic Auth is supported.
IP whitelisting
In addition to the certificate, the connection is secured via IP whitelisting. You will therefore be asked by Retarus to provide us with your IP address of the sending client during the service setup. This will then be activated by Retarus.
Webservice address
The https interface can be accessed via the following address scheme:
https://edi.bpagate.retarus.com:<PORT>/fstr/free/<PARTNERNAME>
You will receive the port and partner name from Retarus during the setup of your connection. The address may change for special applications. This will then be communicated to you by Retarus during the service setup.
Response codes
The following codes are returned syncronously according to the request:
200 OK
201 Accepted
400 Bad Request
403 Forbidden
500 Internal Server Error
501 Not Supported
503 Service Unavailable
Further information about the status codes can be found here: