Airtable Integration
Weg A – kein CodeE-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:
Trigger: Airtable-Datensatz
Ein neuer oder geänderter Datensatz in deiner Airtable-Base löst den Workflow aus.
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.
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}/generateParse
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/parseValidate
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}/validate14 EU-Länder, 3 Formate
invoice-api.xhub unterstützt PDF (alle 14 Länder), XRechnung und ZUGFeRD (Deutschland), sowie weitere länderspezifische Formate.
Für alle 14 EU-Länder verfügbar. Standard-Rechnung im PDF-Format.
Deutsche B2G/B2B-Pflicht. XML-Format nach EN-16931 und KoSIT-Standard.
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:
1# Header für alle invoice-api.xhub-Requests2Authorization: Bearer sk_live_xxxxxxxxxxxxxxxxxxxx3 4# In Zapier: "Custom Request" → Headers-Feld5# In Make.com: HTTP-Modul → "Add a header"6# In n8n: HTTP Request Node → Authentication = "Header Auth"Wähle deine Automation-Plattform
Zapier
5.000+ App-Verbindungen, Drag-&-Drop-Editor, kein Code. Bestens geeignet für einfache Airtable → E-Rechnung-Workflows.
- 1
Zap erstellen: Trigger "Airtable – New Record" oder "Updated Record"
- 2
Action: "Webhooks by Zapier" → POST an invoice-api.xhub Generate-Endpoint
- 3
Action: "Airtable – Update Record" – PDF/XML als Attachment zurückschreiben
1# Zapier Workflow: Airtable → XRechnung generieren2 3# 1. Trigger: Airtable – New Record (oder Updated Record)4# Base: "Aufträge" | Table: "Rechnungen"5 6# 2. Action: Webhooks by Zapier – Custom Request7# Method: POST8# URL: https://service.invoice-api.xhub.io/api/v1/invoice/de/xrechnung/generate9# Headers: Authorization: Bearer {{your_api_key}}10# Content-Type: application/json11# 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 Record55# Field "XRechnung_URL": {{zapier_step2_filename}}56# Field "Status": "Rechnung erstellt"Make.com
Visueller Workflow-Builder mit EU-Rechenzentren. Ideal für komplexe Szenarien mit Router, Fehler-Handler und Data Stores.
- 1
Szenario erstellen: Airtable-Modul "Watch Records" als Trigger
- 2
HTTP-Modul: POST an invoice-api.xhub (Authorization: Bearer …)
- 3
Airtable-Modul "Update a Record" – Ergebnis zurückschreiben
1// Make.com Szenario: Airtable → ZUGFeRD generieren2 3// Modul 1: Airtable – Watch Records4// Base: "Aufträge"5// Table: "Rechnungen"6// Filter: {Status} = "Abgeschlossen"7 8// Modul 2: HTTP – Make a request9{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 Record50// Record-ID: {{1.id}}51// ZUGFeRD_PDF: {{2.filename}}52// Status: "Rechnung erstellt"n8n
Open-Source, self-hostbar, nativer invoice-api.xhub Community Node. Ideal für Teams mit eigener Infrastruktur und komplexer Logik.
- 1
Workflow: Airtable-Trigger "On Record Created/Updated"
- 2
Node: Invoice-api.xhub (Community Node) – Operation wählen
- 3
Airtable-Node: Datensatz mit Ergebnis aktualisieren
1# n8n Workflow: Airtable → E-Rechnung validieren2 3# Node 1: Airtable Trigger4# Operation: On Record Created5# Base: "Eingangsrechnungen"6# Table: "Rechnungen"7 8# Node 2: Invoice-api.xhub (Community Node)9# Operation: Validate10# Country: de11# Invoice JSON: {{ $json.rechnungsdaten }}12 13# Node 3: IF (valid === true)14# True → Airtable Node: Update "Validiert" = true15# False → Airtable Node: Update "Fehler" = {{ $json.errors }}16 17# Installation des Community Node:18# Settings → Community Nodes → Install → n8n-nodes-invoice-api-xhubTypische 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.
- 1Trigger: Airtable – Record Status geändert zu "Abgeschlossen"
- 2Action: invoice-api.xhub → Generate (XRechnung / ZUGFeRD)
- 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.
- 1Trigger: Airtable – neues Attachment in "Eingang"-Base
- 2Action: invoice-api.xhub → Validate
- 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.
- 1Trigger: Email-Anhang empfangen (Zapier / Make)
- 2Action: invoice-api.xhub → Parse (automatische Format-Erkennung)
- 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.