Skip to content

ZUGFeRD/mustangserver

Repository files navigation

mustangAPI

A rest API for Mustangproject, i.e. for ZUGFeRD/Factur-X.

outdated, since there were no contributions in two years in the meantime we rewrote it with Mustang 2.3 in spring boot and made it proprietary. Send me a mail to jochen at zugferd.org for a test version. Screenshot

Architecture

Using a

Recommended: German 45min Dropwizard/Swagger introduction video and slides from Froscon 2017

Features

  • Integrates its own (jersey) webserver
  • get the API documentation online (Human readable and as OpenAPI)
  • try the API in a swagger generated demo web client
  • Extract the XML from a ZUGFeRD/Factur-X invoice
  • Combine custom XML and a PDF/A-1 file to a ZUGFeRD/Factur-X invoice

Feel free to send pull requests for more functionality.

Compile

mvn clean package

Start

java -jar target/server-0.0.2-SNAPSHOT.jar server config.yml

Use

use http://127.0.0.1:8080/swagger to try the methods (https://localhost:8443/swagger would work but is self-signed). Access http://localhost:8080/swagger.yaml to build your clients. For demo purposes, extract does not require authentication but combine requires http authentication with user name "good-guy" and password "secret".

Support

Community support is available via the ZUGFeRD Google Group

Contact

For commercial and/or legal inquiries contact Jochen Stärk jochen@zugferd.org