5 Minuten

Quickstart Guide

Erstelle deine erste E-Rechnung in unter 5 Minuten. Kein SDK nötig – nur ein HTTP-Request.

1

API Key erstellen

Registriere dich kostenlos und hole dir deinen API Key aus dem Dashboard.

2

Request senden

Sende deine Rechnungsdaten als JSON an unsere API.

3

E-Rechnung erhalten

Erhalte eine validierte XRechnung oder ZUGFeRD zurück.

1

API Key erstellen

Erstelle einen kostenlosen Account und generiere deinen API Key im Dashboard. Du erhältst zwei Keys:

  • Test
    sk_test_...

    Für Entwicklung und Testing — kostenlos innerhalb des Free-Kontingents (20 Calls/Monat); darüber zählt jeder Call wie mit einem Live-Key

  • Live
    sk_live_...

    Für Production (Pay-per-Use)

Dein API Key

sk_test_abc123xyz...

Halte deinen API Key geheim. Teile ihn nie öffentlich.

2

Erste E-Rechnung erstellen

Sende einen POST-Request an /api/v1/invoice/de/xrechnung/generate mit deinen Rechnungsdaten. Hier ein vollständiges Beispiel:

POSThttps://service.invoice-api.xhub.io/api/v1/invoice/de/xrechnung/generate
bash
1curl -X POST https://service.invoice-api.xhub.io/api/v1/invoice/de/xrechnung/generate \
2  -H "Authorization: Bearer sk_test_abc123..." \
3  -H "Content-Type: application/json" \
4  -d '{
5    "invoice": {
6      "invoiceNumber": "RE-2026-001",
7      "type": "invoice",
8      "issueDate": "2026-04-10",
9      "dueDate": "2026-05-10",
10      "currency": "EUR",
11      "seller": {
12        "name": "Meine Firma GmbH",
13        "vatId": "DE123456789",
14        "street": "Musterstraße 1",
15        "city": "Berlin",
16        "postalCode": "10115",
17        "countryCode": "DE",
18        "bankAccount": { "iban": "DE89370400440532013000", "bic": "COBADEFFXXX" }
19      },
20      "buyer": {
21        "name": "Kunde AG",
22        "vatId": "DE987654321",
23        "street": "Kundenweg 42",
24        "city": "München",
25        "postalCode": "80331",
26        "countryCode": "DE"
27      },
28      "countrySpecific": { "countryCode": "DE", "buyerReference": "BUYER-REF-001" },
29      "items": [
30        {
31          "position": 1,
32          "description": "Beratungsleistung",
33          "quantity": 10,
34          "unit": "HUR",
35          "unitPrice": 150.00,
36          "taxRate": 19,
37          "netAmount": 1500.00,
38          "taxAmount": 285.00,
39          "grossAmount": 1785.00
40        }
41      ],
42      "subtotal": 1500.00,
43      "total": 1785.00,
44      "taxSummary": [{ "taxRate": 19, "netAmount": 1500.00, "taxAmount": 285.00 }],
45      "paymentTerms": { "dueDays": 30 },
46      "paymentMethods": [{ "type": "bank_transfer" }]
47    }
48  }'
3

Response verstehen

Bei Erfolg erhältst du einen 200 OK mit der erstellten Rechnung. Die Response enthält das Dokument Base64-kodiert in `data`, dazu `format`, `filename`, `mimeType`, `hash`, `payloadHash` sowie `errors`, `complianceErrors` und `warnings` — **keine** Download-URL: die API speichert nichts.

json
1{
2  "success": true,
3  "format": "xrechnung",
4  "filename": "invoice-2025-001.xml",
5  "mimeType": "application/xml",
6  "hash": "9f2c1b7d4e8a03f5c6b9d0e1a2f3c4b5d6e7f8a9b0c1d2e3f4a5b6c7d8e9f0a1",
7  "data": "PD94bWwgdmVyc2lvbj0iMS4wIj8+...",
8  "errors": [],
9  "warnings": []
10}

success

true bedeutet die Rechnung wurde erfolgreich generiert.

data

Base64-kodiertes Dokument (XML oder PDF je nach Format).

errors / warnings

Validierungsfehler und -warnungen als Array.

Code-Beispiele

Node.js / TypeScript

typescript
1const response = await fetch('https://service.invoice-api.xhub.io/api/v1/invoice/de/xrechnung/generate', {
2  method: 'POST',
3  headers: {
4    'Authorization': 'Bearer sk_test_abc123...',
5    'Content-Type': 'application/json'
6  },
7  body: JSON.stringify({
8    invoice: {
9      invoiceNumber: 'RE-2026-001',
10      type: 'invoice',
11      issueDate: '2026-04-10',
12      dueDate: '2026-05-10',
13      currency: 'EUR',
14      seller: {
15        name: 'Meine Firma GmbH', vatId: 'DE123456789',
16        street: 'Musterstraße 1', city: 'Berlin', postalCode: '10115', countryCode: 'DE',
17        bankAccount: { iban: 'DE89370400440532013000', bic: 'COBADEFFXXX' }
18      },
19      buyer: {
20        name: 'Kunde AG', vatId: 'DE987654321',
21        street: 'Kundenweg 42', city: 'München', postalCode: '80331', countryCode: 'DE'
22      },
23      countrySpecific: { countryCode: 'DE', buyerReference: 'BUYER-REF-001' },
24      items: [
25        { position: 1, description: 'Beratungsleistung', quantity: 10, unit: 'HUR',
26          unitPrice: 150, taxRate: 19, netAmount: 1500, taxAmount: 285, grossAmount: 1785 }
27      ],
28      subtotal: 1500, total: 1785,
29      taxSummary: [{ taxRate: 19, netAmount: 1500, taxAmount: 285 }],
30      paymentTerms: { dueDays: 30 },
31      paymentMethods: [{ type: 'bank_transfer' }]
32    }
33  })
34});
35 
36const result = await response.json();
37const xmlData = atob(result.data); // Base64 decode to get XML

Python

python
1import requests
2import base64
3 
4response = requests.post(
5    'https://service.invoice-api.xhub.io/api/v1/invoice/de/xrechnung/generate',
6    headers={
7        'Authorization': 'Bearer sk_test_abc123...',
8        'Content-Type': 'application/json'
9    },
10    json={
11        'invoice': {
12            'invoiceNumber': 'RE-2026-001',
13            'type': 'invoice',
14            'issueDate': '2026-04-10',
15            'dueDate': '2026-05-10',
16            'currency': 'EUR',
17            'seller': {
18                'name': 'Meine Firma GmbH', 'vatId': 'DE123456789',
19                'street': 'Musterstraße 1', 'city': 'Berlin', 'postalCode': '10115', 'countryCode': 'DE',
20                'bankAccount': {'iban': 'DE89370400440532013000', 'bic': 'COBADEFFXXX'}
21            },
22            'buyer': {
23                'name': 'Kunde AG', 'vatId': 'DE987654321',
24                'street': 'Kundenweg 42', 'city': 'München', 'postalCode': '80331', 'countryCode': 'DE'
25            },
26            'countrySpecific': {'countryCode': 'DE', 'buyerReference': 'BUYER-REF-001'},
27            'items': [
28                {'position': 1, 'description': 'Beratungsleistung', 'quantity': 10, 'unit': 'HUR',
29                 'unitPrice': 150, 'taxRate': 19, 'netAmount': 1500, 'taxAmount': 285, 'grossAmount': 1785}
30            ],
31            'subtotal': 1500, 'total': 1785,
32            'taxSummary': [{'taxRate': 19, 'netAmount': 1500, 'taxAmount': 285}],
33            'paymentTerms': {'dueDays': 30},
34            'paymentMethods': [{'type': 'bank_transfer'}]
35        }
36    }
37)
38 
39result = response.json()
40xml_data = base64.b64decode(result['data'])  # Base64 decode to get XML

Nächste Schritte

Authentication

API Keys und Sicherheit verstehen

Creator API

Vollständige API-Referenz

Validator API

Rechnungen validieren

Error Handling

Fehler verstehen und behandeln

Bereit loszulegen?

Teste die API direkt im Playground – ohne Account.