Offering & License

Maven Repository

All QR Invoice Library artifacts are published in The Central Repository.

Maven Dependencies

The QR Invoice Library uses OpenPDF for creating PDFs.

QR Invoice Library with OpenPDF (default)

<dependencies>
    <dependency>
        <groupId>ch.codeblock.qrinvoice.core</groupId>
        <artifactId>qrinvoice-core</artifactId>
        <version>1.20</version>
    </dependency>
    <dependency>
        <groupId>ch.codeblock.qrinvoice.openpdf</groupId>
        <artifactId>qrinvoice-openpdf</artifactId>
        <version>1.20</version>
    </dependency>
</dependencies>

Optional - PDFBox

This is an optional dependency and is only required, if you want to scan / parse PDF documents for Swiss QR Codes. See How to Scan Documents for Swiss QR Codes

<dependencies>
    <dependency>
        <groupId>ch.codeblock.qrinvoice.pdfbox</groupId>
        <artifactId>qrinvoice-pdfbox</artifactId>
        <version>1.20</version>
    </dependency>
</dependencies>

You may also want to include jai-imageio-jpeg2000 in order to support jpeg2000. Please make sure to check license information

<dependencies>
    <dependency>
        <groupId>com.github.jai-imageio</groupId>
        <artifactId>jai-imageio-jpeg2000</artifactId>
        <version>1.4.0</version>
    </dependency>
</dependencies>

Optional - BoofCV

QR Invoice makes use of ZXing for QR code generation and parsing/scanning/decoding. ZXing provides good detection rate, however no solution is perfect when it comes to image recognition, especially on scanned documents. In order to provide higher detection rates we integrated BoofCV as an additional QR Code detection library. What library is used can be chosen via API. If you want to use BoofCV, include the following dependency

<dependencies>
    <dependency>
        <groupId>ch.codeblock.qrinvoice.boofcv</groupId>
        <artifactId>qrinvoice-boofcv</artifactId>
        <version>1.20</version>
    </dependency>
</dependencies>

Sources Jars

Make sure to download the sources jar along with the dependencies.

Continue by reading QR bill basics.

DEPRECATED: QR Invoice Library with iText5 (requires additional licensing)

If you have a valid iText5 License and don’t want extra dependencies on OpenPDF, you can choose QR Invoice Library to use iText5.

This is still a valid, but deprecated option. Unless customers depend on iText5, we will discontinue iText5 support in the future.
<dependencies>
    <dependency>
        <groupId>ch.codeblock.qrinvoice.core</groupId>
        <artifactId>qrinvoice-core</artifactId>
        <version>1.20</version>
    </dependency>
    <dependency>
        <groupId>ch.codeblock.qrinvoice.itext5</groupId>
        <artifactId>qrinvoice-itext5</artifactId>
        <version>1.20</version>
    </dependency>
</dependencies>