PDF zu ZUGFeRD: Alte Systeme E-Rechnungs-fit machen

Viele Unternehmen stehen vor einem bekannten Problem: Ihr bestehendes ERP-, Buchhaltungs- oder Legacy-System kann keine E-Rechnungen im ZUGFeRD- oder XRechnung-Format erzeugen – aber es liefert zuverlässig PDF-Rechnungen mit allen relevanten Daten. Mit unserer RechnungsAPI können Sie dieses Problem elegant lösen: Analysieren Sie das PDF, extrahieren Sie die strukturierten Daten als JSON, und erstellen Sie daraus ein vollwertiges ZUGFeRD-PDF – das Original-Layout bleibt dabei erhalten.

Mit der E-Rechnungspflicht 2025 stehen viele Unternehmen vor einer Herausforderung: Ihre bewährten Systeme können zwar professionelle PDF-Rechnungen erstellen, aber keine strukturierten E-Rechnungsdaten erzeugen. Eine komplette Systemumstellung ist oft teuer, zeitaufwendig und risikobehaftet.

• 1
  ERP-Systeme ohne ZUGFeRD/XRechnung-Modul
• 2
  Legacy-Software ohne Update-Möglichkeit
• 3
  Externe Dienstleister, die nur PDFs liefern
• 4
  Übergangsphase bei geplanter Systemumstellung

Für die API müssen Sie Ihr PDF als Base64-String übergeben. Zum Testen können Sie Online-Tools wie base64encode.org nutzen. In Ihrer Anwendung ist die Konvertierung in jeder Programmiersprache einfach:

import base64

with open("invoice.pdf", "rb") as f:
    pdf_base64 = base64.b64encode(f.read()).decode("utf-8")

const fs = require('fs');
const pdfBase64 = fs.readFileSync('invoice.pdf').toString('base64');

$pdfBase64 = base64_encode(file_get_contents('invoice.pdf'));

string pdfBase64 = Convert.ToBase64String(File.ReadAllBytes("invoice.pdf"));

So integrieren Sie den kompletten Workflow in Ihre Anwendung – von der PDF-Analyse bis zur ZUGFeRD-Generierung:

import requests
import base64
import json

API_KEY = "your_api_key"
BASE_URL = "https://api.rechnungsapi.de"

# Step 1: Read and encode the PDF
with open("invoice.pdf", "rb") as f:
    pdf_base64 = base64.b64encode(f.read()).decode("utf-8")

# Step 2: Analyze the PDF
analyze_response = requests.post(
    f"{BASE_URL}/api/v1/invoice/analyseInvoicePdf",
    headers={"Authorization": f"Bearer {API_KEY}"},
    json={"pdfBase64": pdf_base64}
)
invoice_json = analyze_response.json()

# Step 3: Create ZUGFeRD PDF with the extracted data
zugferd_response = requests.post(
    f"{BASE_URL}/api/v1/zugferd/createZugferdPdfFromJson",
    headers={"Authorization": f"Bearer {API_KEY}"},
    json={
        **invoice_json,
        "embeddedPdfBase64": pdf_base64  # Original PDF as visual layer
    }
)

# Step 4: Save the ZUGFeRD PDF
zugferd_base64 = zugferd_response.json().get("pdfBase64")
with open("invoice_zugferd.pdf", "wb") as f:
    f.write(base64.b64decode(zugferd_base64))

print("ZUGFeRD PDF created successfully!")

const fs = require('fs');

const API_KEY = 'your_api_key';
const BASE_URL = 'https://api.rechnungsapi.de';

async function convertPdfToZugferd(pdfPath) {
  // Step 1: Read and encode the PDF
  const pdfBuffer = fs.readFileSync(pdfPath);
  const pdfBase64 = pdfBuffer.toString('base64');

  // Step 2: Analyze the PDF
  const analyzeResponse = await fetch(
    `${BASE_URL}/api/v1/invoice/analyseInvoicePdf`,
    {
      method: 'POST',
      headers: {
        'Authorization': `Bearer ${API_KEY}`,
        'Content-Type': 'application/json'
      },
      body: JSON.stringify({ pdfBase64 })
    }
  );
  const invoiceJson = await analyzeResponse.json();

  // Step 3: Create ZUGFeRD PDF with the extracted data
  const zugferdResponse = await fetch(
    `${BASE_URL}/api/v1/zugferd/createZugferdPdfFromJson`,
    {
      method: 'POST',
      headers: {
        'Authorization': `Bearer ${API_KEY}`,
        'Content-Type': 'application/json'
      },
      body: JSON.stringify({
        ...invoiceJson,
        embeddedPdfBase64: pdfBase64  // Original PDF as visual layer
      })
    }
  );
  const { pdfBase64: zugferdBase64 } = await zugferdResponse.json();

  // Step 4: Save the ZUGFeRD PDF
  fs.writeFileSync(
    'invoice_zugferd.pdf',
    Buffer.from(zugferdBase64, 'base64')
  );

  console.log('ZUGFeRD PDF created successfully!');
}

convertPdfToZugferd('invoice.pdf');

Testen Sie den gesamten Workflow direkt in unserem interaktiven Playground. Laden Sie ein PDF hoch, analysieren Sie es, importieren Sie das JSON und erstellen Sie Ihr ZUGFeRD-PDF – alles ohne eine Zeile Code zu schreiben.