Peppol API
Java

Java SDK

for Peppol E-Invoicing

The official Java SDK for e-invoice.be. Enterprise-ready for Spring Boot, Jakarta EE, and any JVM application.

implementation("com.e_invoice.api:e-invoice-java:0.1.0-alpha.12")

What is e-invoice.be?

e-invoice.be is a recognized Peppol Access Point and SMP operating under the Belgian Peppol Authority (BOSA). We enable businesses worldwide to send and receive electronic invoices via the Peppol network.

Our API lets you send invoices from JSON, upload pre-generated UBL XML, create invoices from PDF files, or integrate via our reseller programme. The Java SDK provides enterprise-grade integration for JVM applications.

Instant Delivery

E-invoices delivered instantly via Peppol

Peppol Compliant

Automatic UBL BIS Billing 3.0 conversion

Real-time Validation

Validate invoices before sending

Quick Start

Get up and running in minutes with our Java SDK.

1. Add the dependency

Gradle

implementation("com.e_invoice.api:e-invoice-java:0.1.0-alpha.12")

Maven

<dependency>
    <groupId>com.e_invoice.api</groupId>
    <artifactId>e-invoice-java</artifactId>
    <version>0.1.0-alpha.12</version>
</dependency>

2. Usage

import com.e_invoice.api.client.EInvoiceClient;
import com.e_invoice.api.client.okhttp.EInvoiceOkHttpClient;

EInvoiceClient client = EInvoiceOkHttpClient.builder()
    .apiKey(System.getenv("E_INVOICE_API_KEY"))
    .build();

var documentResponse = client.documents().create();

System.out.println(documentResponse.id());

Features

Builder Pattern

Fluent builder API for all request objects. Type-safe and IDE-friendly with comprehensive JavaDoc.

Thread-safe Client

Fully thread-safe client suitable for concurrent use. Perfect for multi-threaded enterprise applications.

Comprehensive JavaDoc

Full JavaDoc documentation for all classes and methods. Integrated directly in your IDE.

Auto-retry with Backoff

Automatic retry logic with exponential backoff for transient failures. Configurable retry strategies.

Java 11+

Supports Java 11, 17, and 21 LTS releases. Uses modern Java features like records and sealed classes.

Spring Boot Ready

Easy integration with Spring Boot, Spring Cloud, and Jakarta EE. Auto-configuration available.

Start integrating today

Get your API key and start sending e-invoices in minutes. Our documentation has everything you need to get started.

Switch to e-invoicing, keep your workflow