Project

secretariat

0.03
There's a lot of open issues
A long-lived project that still receives updates
secretariathalfbyte/ruby-secretariatHomepageDocumentationSource CodeBug TrackerWiki
a tool to help generate and validate ZUGFeRD invoice xml files
2005
2006
2007
2008
2009
2010
2011
2012
2013
2014
2015
2016
2017
2018
2019
2020
2021
2022
2023
2024
2025
 Popularity
Downloads
8,923
Stars
28
Forks
22
Watchers
3
 Releases
Current version
3.6.0
Total releases
10
First release
2019-12-19
Latest release
2024-11-06
 Issues
Open Issues
6
Closed Issues
6
Total Issues
12
Issue Closure Rate
50%
 Pull Requests
Open Pull Requests
1
Closed Pull Requests
1
Merged Pull Requests
16
Pull Request Acceptance Rate
88%
 Development
Primary Language
Ruby
Licenses
Apache-2.0
Average date of last 50 commits
2025-02-16
Reverse Dependencies
0

 Dependencies

Development

minitest
~> 5.13
rake
~> 13.0
base64
~> 0.2.0

Runtime

bigdecimal
~> 3.1
nokogiri
~> 1.10
mime-types
~> 3.6
 Project Readme

A ZUGFeRD xml generator and validator

See tests for examples.

Some words of caution

  1. This is an opinionated library optimised for my very specific usecase
  2. While I did start to add some validations to make sure you can't input absolute garbage into this, I cannot guarantee factual (as in taxation law) correctness of the resulting XML.
  3. The library, for ZUGFeRD 2.x, currently only supports the EN16931 variant. This is probably what you want as well. PRs welcome.
  4. This does not contain any code to attach the XML to a PDF file, mainly because I have yet to find a ruby library to do that. For software that does this, take a look at this python library or this Java library which also does extended validation

Contributors

See CONTRIBUTORS.md.

LICENSE

See LICENSE.

Additionally, this project contains material, such as the schema files, which, according to the ZUGFeRD documentation, are also licensed under the Apache License.

Additionally, this project uses nokogiri and SchXslt, both licensed unter the MIT license.