E-Rechnung erstellen mit Java — XRechnung und ZUGFeRD per API

import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpRequest.BodyPublishers;
import java.net.http.HttpResponse;
import java.net.http.HttpResponse.BodyHandler;
import java.nio.file.Path;
import java.util.UUID;
import java.util.regex.Matcher;
import java.util.regex.Pattern;

public class Fortlauf {
    private static final String BASE_URL = System.getenv("FORTLAUF_API_URL");
    private static final String API_KEY = System.getenv("FORTLAUF_API_KEY");
    private final HttpClient http = HttpClient.newHttpClient();

    private <T> HttpResponse<T> send(HttpRequest.Builder req, BodyHandler<T> handler)
            throws Exception {
        HttpRequest built = req.header("Authorization", "Bearer " + API_KEY).build();
        HttpResponse<T> res = http.send(built, handler);
        if (res.statusCode() >= 400) {
            throw new IllegalStateException(
                built.method() + " " + built.uri() + " → HTTP " + res.statusCode());
        }
        return res;
    }

    // Liest die "id" der Rechnung (das erste "id"-Feld der Antwort).
    // In echtem Code nimmst du Jackson: mapper.readTree(json).get("id").asText()
    private static String extractId(String json) {
        Matcher m = Pattern.compile("\"id\"\\s*:\\s*\"([^\"]+)\"").matcher(json);
        if (!m.find()) throw new IllegalStateException("keine id in der Antwort");
        return m.group(1);
    }

    // … hier kommen anlegen(), ausstellen() und abholen() aus den Schritten 1–3 hin …

    public static void main(String[] args) throws Exception {
        Fortlauf api = new Fortlauf();
        String id = api.anlegen();
        api.ausstellen(id);
        api.abholen(id);
        System.out.println("Rechnung " + id + " ausgestellt und abgeholt");
    }
}

String anlegen() throws Exception {
    // In der Praxis serialisierst du ein DTO mit Jackson/Gson; hier als Text-Block
    // zur Veranschaulichung — Beträge als Strings, nicht als Zahl-Literale.
    String body = """
        {
          "currency": "EUR",
          "documentTarget": "b2g",
          "buyer": {
            "name": "Zweckverband Wasserversorgung Nordmoor",
            "addressLine1": "Deichweg 15",
            "postalCode": "26847", "city": "Nordmoor", "countryCode": "DE"
          },
          "buyerElectronicAddress": "<LEITWEG-ID>",
          "buyerReference": "<LEITWEG-ID>",
          "invoiceTypeCode": "380",
          "lineItems": [
            { "description": "Betriebsführung Leitstelle (Q3 2026)", "quantity": "3",
              "unitCode": "MON", "unitPriceNet": "2100.00", "taxRatePercent": "19" }
          ]
        }
        """;

    var res = send(
        HttpRequest.newBuilder(URI.create(BASE_URL + "/invoices"))
            .header("Content-Type", "application/json")
            .header("Idempotency-Key", UUID.randomUUID().toString())
            .POST(BodyPublishers.ofString(body)),
        HttpResponse.BodyHandlers.ofString());

    // Status "draft", Summen serverseitig berechnet
    return extractId(res.body());
}

void ausstellen(String id) throws Exception {
    send(
        HttpRequest.newBuilder(URI.create(BASE_URL + "/invoices/" + id + "/finalize"))
            .method("PATCH", BodyPublishers.noBody()),
        HttpResponse.BodyHandlers.ofString());
    // → Status "issued", Nummer vergeben, XRechnung-XML (CII) gerendert + validiert
}

void abholen(String id) throws Exception {
    // reines XRechnung-XML (CII)
    send(
        HttpRequest.newBuilder(URI.create(BASE_URL + "/invoices/" + id + "/xml")).GET(),
        HttpResponse.BodyHandlers.ofFile(Path.of("rechnung-" + id + ".xml")));

    // oder das hybride ZUGFeRD/Factur-X-PDF (PDF/A-3 mit eingebettetem XML)
    send(
        HttpRequest.newBuilder(URI.create(BASE_URL + "/invoices/" + id + "/pdf")).GET(),
        HttpResponse.BodyHandlers.ofFile(Path.of("rechnung-" + id + ".pdf")));
}