Airtable

Airtable Integration

Weg A – kein Code

E-Rechnungen direkt aus Airtable-Datensätzen generieren – ohne eigene Server-Infrastruktur. Verbinde Airtable mit invoice-api.xhub über Zapier, Make.com oder n8n.

Weg A: Automation-Plattform (verfügbar)

Airtable ist ein nativer Connector auf Zapier, Make.com und n8n – alle drei Plattformen haben bereits eine invoice-api.xhub-Integration. Verknüpfe sie in wenigen Minuten ohne Code.

Wie funktioniert die Integration?

Du nutzt eine der drei Automatisierungsplattformen als Middleware zwischen Airtable und invoice-api.xhub. Der Workflow folgt immer demselben Muster:

1

Trigger: Airtable-Datensatz

Ein neuer oder geänderter Datensatz in deiner Airtable-Base löst den Workflow aus.

2

Action: invoice-api.xhub aufrufen

Die Felder des Datensatzes (Rechnungsnummer, Käufer, Betrag, …) werden an die Generate-, Parse- oder Validate-Operation von invoice-api.xhub übergeben.

3

Result: Ergebnis zurückschreiben

Das generierte Dokument (XML, PDF) oder Validierungsergebnis wird als Attachment oder Status-Feld zurück in den Airtable-Datensatz geschrieben.

3 verfügbare Operationen

invoice-api.xhub bietet drei Operationen, die du über den Automation-Connector aufrufen kannst.

Generate

Erstellt eine konforme E-Rechnung (PDF, XRechnung, ZUGFeRD) aus den Rechnungsdaten im Airtable-Datensatz.

POST /api/v1/invoice/{countryCode}/{format}/generate

Parse

Liest eine vorhandene E-Rechnung (XML oder PDF) aus und gibt die strukturierten Daten zurück – z. B. um eingehende Rechnungen ins Airtable zu importieren.

POST /api/v1/invoice/parse

Validate

Prüft Rechnungsdaten gegen die länderspezifischen KoSIT-Schemas (kostenlos, ohne Quota). Schreibe das Ergebnis als Status-Feld zurück.

POST /api/v1/invoice/{countryCode}/validate

14 EU-Länder, 3 Formate

invoice-api.xhub unterstützt PDF (alle 14 Länder), XRechnung und ZUGFeRD (Deutschland), sowie weitere länderspezifische Formate.

PDF

Für alle 14 EU-Länder verfügbar. Standard-Rechnung im PDF-Format.

XRechnung

Deutsche B2G/B2B-Pflicht. XML-Format nach EN-16931 und KoSIT-Standard.

ZUGFeRD

PDF mit eingebettetem XML (hybrides Format). Kompatibel mit Factur-X.

Authentifizierung

Alle invoice-api.xhub-Endpunkte werden per Bearer-API-Key authentifiziert. Den Key erzeugst du in der Console und trägst ihn als Header ein:

bash
1# Header für alle invoice-api.xhub-Requests
2Authorization: Bearer sk_live_xxxxxxxxxxxxxxxxxxxx
3 
4# In Zapier: "Custom Request" Headers-Feld
5# In Make.com: HTTP-Modul "Add a header"
6# In n8n: HTTP Request Node Authentication = "Header Auth"

Wähle deine Automation-Plattform

Zapier

Zapier

5.000+ App-Verbindungen, Drag-&-Drop-Editor, kein Code. Bestens geeignet für einfache Airtable → E-Rechnung-Workflows.

  1. 1

    Zap erstellen: Trigger "Airtable – New Record" oder "Updated Record"

  2. 2

    Action: "Webhooks by Zapier" → POST an invoice-api.xhub Generate-Endpoint

  3. 3

    Action: "Airtable – Update Record" – PDF/XML als Attachment zurückschreiben

json
1# Zapier Workflow: Airtable XRechnung generieren
2 
3# 1. Trigger: Airtable New Record (oder Updated Record)
4# Base: "Aufträge" | Table: "Rechnungen"
5 
6# 2. Action: Webhooks by Zapier Custom Request
7# Method: POST
8# URL: https://service.invoice-api.xhub.io/api/v1/invoice/de/xrechnung/generate
9# Headers: Authorization: Bearer {{your_api_key}}
10# Content-Type: application/json
11# Body:
12{
13 "invoice": {
14 "invoiceNumber": "{{airtable_invoice_number}}",
15 "type": "invoice",
16 "issueDate": "{{airtable_issue_date}}",
17 "dueDate": "{{airtable_due_date}}",
18 "currency": "EUR",
19 "seller": {
20 "name": "{{airtable_seller_name}}",
21 "vatId": "{{airtable_seller_vat_id}}",
22 "street": "{{airtable_seller_street}}",
23 "city": "{{airtable_seller_city}}",
24 "postalCode": "{{airtable_seller_zip}}",
25 "countryCode": "DE"
26 },
27 "buyer": {
28 "name": "{{airtable_buyer_name}}",
29 "vatId": "{{airtable_buyer_vat_id}}",
30 "street": "{{airtable_buyer_street}}",
31 "city": "{{airtable_buyer_city}}",
32 "postalCode": "{{airtable_buyer_zip}}",
33 "countryCode": "DE"
34 },
35 "countrySpecific": { "buyerReference": "{{airtable_buyer_ref}}" },
36 "items": [{
37 "position": 1,
38 "description": "{{airtable_item_desc}}",
39 "quantity": {{airtable_quantity}},
40 "unit": "C62",
41 "unitPrice": {{airtable_unit_price}},
42 "taxRate": 19,
43 "netAmount": {{airtable_net}},
44 "taxAmount": {{airtable_tax}},
45 "grossAmount": {{airtable_gross}}
46 }],
47 "subtotal": {{airtable_subtotal}},
48 "total": {{airtable_total}},
49 "taxSummary": [{ "taxRate": 19, "netAmount": {{airtable_subtotal}}, "taxAmount": {{airtable_tax_sum}} }],
50 "paymentTerms": { "dueDays": 30 }
51 }
52}
53 
54# 3. Action: Airtable Update Record
55# Field "XRechnung_URL": {{zapier_step2_filename}}
56# Field "Status": "Rechnung erstellt"
Make.com

Make.com

Visueller Workflow-Builder mit EU-Rechenzentren. Ideal für komplexe Szenarien mit Router, Fehler-Handler und Data Stores.

  1. 1

    Szenario erstellen: Airtable-Modul "Watch Records" als Trigger

  2. 2

    HTTP-Modul: POST an invoice-api.xhub (Authorization: Bearer …)

  3. 3

    Airtable-Modul "Update a Record" – Ergebnis zurückschreiben

json
1// Make.com Szenario: Airtable → ZUGFeRD generieren
2 
3// Modul 1: Airtable – Watch Records
4// Base: "Aufträge"
5// Table: "Rechnungen"
6// Filter: {Status} = "Abgeschlossen"
7 
8// Modul 2: HTTP – Make a request
9{
10 "url": "https://service.invoice-api.xhub.io/api/v1/invoice/de/zugferd/generate",
11 "method": "POST",
12 "headers": [
13 { "name": "Authorization", "value": "Bearer {{connection.apiKey}}" },
14 { "name": "Content-Type", "value": "application/json" }
15 ],
16 "body": {
17 "invoice": {
18 "invoiceNumber": "{{1.invoiceNumber}}",
19 "type": "invoice",
20 "issueDate": "{{1.issueDate}}",
21 "seller": {
22 "name": "{{1.sellerName}}",
23 "vatId": "{{1.sellerVatId}}",
24 "street": "{{1.sellerStreet}}",
25 "city": "{{1.sellerCity}}",
26 "postalCode": "{{1.sellerZip}}",
27 "countryCode": "DE"
28 },
29 "buyer": {
30 "name": "{{1.buyerName}}",
31 "vatId": "{{1.buyerVatId}}",
32 "street": "{{1.buyerStreet}}",
33 "city": "{{1.buyerCity}}",
34 "postalCode": "{{1.buyerZip}}",
35 "countryCode": "DE"
36 },
37 "items": [{ "position": 1, "description": "{{1.itemDesc}}",
38 "quantity": "{{1.qty}}", "unit": "C62", "unitPrice": "{{1.price}}",
39 "taxRate": 19, "netAmount": "{{1.net}}", "taxAmount": "{{1.tax}}",
40 "grossAmount": "{{1.gross}}" }],
41 "subtotal": "{{1.subtotal}}",
42 "total": "{{1.total}}",
43 "taxSummary": [{ "taxRate": 19, "netAmount": "{{1.subtotal}}", "taxAmount": "{{1.taxSum}}" }],
44 "paymentTerms": { "dueDays": 30 }
45 }
46 }
47}
48 
49// Modul 3: Airtable – Update a Record
50// Record-ID: {{1.id}}
51// ZUGFeRD_PDF: {{2.filename}}
52// Status: "Rechnung erstellt"
n8n

n8n

Open-Source, self-hostbar, nativer invoice-api.xhub Community Node. Ideal für Teams mit eigener Infrastruktur und komplexer Logik.

  1. 1

    Workflow: Airtable-Trigger "On Record Created/Updated"

  2. 2

    Node: Invoice-api.xhub (Community Node) – Operation wählen

  3. 3

    Airtable-Node: Datensatz mit Ergebnis aktualisieren

bash
1# n8n Workflow: Airtable E-Rechnung validieren
2 
3# Node 1: Airtable Trigger
4# Operation: On Record Created
5# Base: "Eingangsrechnungen"
6# Table: "Rechnungen"
7 
8# Node 2: Invoice-api.xhub (Community Node)
9# Operation: Validate
10# Country: de
11# Invoice JSON: {{ $json.rechnungsdaten }}
12 
13# Node 3: IF (valid === true)
14# True Airtable Node: Update "Validiert" = true
15# False Airtable Node: Update "Fehler" = {{ $json.errors }}
16 
17# Installation des Community Node:
18# Settings Community Nodes Install n8n-nodes-invoice-api-xhub

Typische Anwendungsfälle

Rechnung nach Auftragsabschluss

Wenn ein Datensatz in der Airtable-Base den Status "Abgeschlossen" bekommt, wird automatisch eine XRechnung generiert und als Attachment hinterlegt.

  1. 1Trigger: Airtable – Record Status geändert zu "Abgeschlossen"
  2. 2Action: invoice-api.xhub → Generate (XRechnung / ZUGFeRD)
  3. 3Action: Airtable – Attachment (PDF/XML) zum Datensatz hinzufügen

Validierung eingehender Rechnungen

Lade eingehende E-Rechnungen (XML) in eine Airtable-Base hoch und validiere sie automatisch gegen KoSIT-Schemas.

  1. 1Trigger: Airtable – neues Attachment in "Eingang"-Base
  2. 2Action: invoice-api.xhub → Validate
  3. 3Action: Airtable – "Validiert"-Checkbox und Fehler-Feld aktualisieren

Eingehende Rechnungen strukturieren

Parse eingehende PDF-Rechnungen oder XML-Dateien und importiere alle Felder automatisch in deine Airtable-Lieferanten-Tabelle.

  1. 1Trigger: Email-Anhang empfangen (Zapier / Make)
  2. 2Action: invoice-api.xhub → Parse (automatische Format-Erkennung)
  3. 3Action: Airtable – Neuen Datensatz mit geparsten Feldern anlegen

Airtable Scripting (optional)

Falls du lieber direkt in Airtable bleibst: Du kannst invoice-api.xhub auch über die Airtable Scripting Extension aufrufen – ein JavaScript-Snippet reicht für einen einfachen Generate-Aufruf. Für produktive Workflows empfehlen wir trotzdem den Automation-Weg (Zapier/Make/n8n) für bessere Fehlerbehandlung und Monitoring.

Direkt loslegen

API-Key kostenlos holen und in 5 Minuten den ersten Airtable-Workflow testen. Keine Kreditkarte, kein Abo.