#zugferd

# Neues Feature: Gap-Report für ZUGFeRD-Mapping Unser **KI-gestütztes ZUGFeRD-Mapping** hat ein neues Feature bekommen, das die Arbeit noch einfacher macht! ## Das Problem Die KI mappt automatisch ~90% der ZUGFeRD-Felder. Aber was ist mit den **fehlenden 10%**? Bisher musste man selbst herausfinden, welche Felder in FileMaker noch fehlen und wie man sie anlegt. ## Die Lösung: Gap-Report Ab sofort erstellt die KI einen **detaillierten Gap-Report** für alle fehlenden Felder: ### Was der Gap-Report liefert: ✅ **Welches Feld fehlt** (z.B. `invoiceCurrencyCode`) ✅ **ZUGFeRD-Code** (z.B. BT-5) ✅ **Beschreibung** (was bedeutet das Feld?) ✅ **Pflicht oder Optional?** (Priorität HOCH/NIEDRIG) ✅ **Konkrete Empfehlung** für FileMaker ✅ **Beispielwerte** zur Orientierung ### Beispiel: ``` ❌ invoiceCurrencyCode (BT-5) - PFLICHT Beschreibung: Währungscode der Rechnung Empfehlung: Textfeld mit Werteliste (EUR, USD, CHF, GBP) Beispiel: EUR ❌ unitCode (BT-130) - PFLICHT Beschreibung: Einheitencode (UN/ECE) Empfehlung: Textfeld mit Werteliste (C62, HUR, MTR, KGM, LTR) Beispiel: C62 (Stück), HUR (Stunden) ℹ️ deliveryTerms (BT-20) - Optional Beschreibung: Lieferbedingungen (IncoTerms) Empfehlung: Textfeld mit Werteliste (EXW, FOB, CIF, DAP, DDP) Beispiel: DAP ``` ## Vorteile **Vorher:** "15 Felder fehlen" - und jetzt? **Nachher:** Konkrete Schritt-für-Schritt-Anleitung, was genau anzulegen ist. Perfekt für **FileMaker-Entwickler ohne ZUGFeRD-Kenntnisse**! ## Fazit Das KI-Mapping wird immer intelligenter. Nicht nur automatisch mappen, sondern auch **aktiv beim Nacharbeiten helfen**. ZUGFeRD-Compliance wird zum Kinderspiel. --- **Update:** Oktober 2025 **Feature:** Gap-Report mit konkreten FileMaker-Empfehlungen **Status:** Live #FileMaker #ZUGFeRD #KI #Automatisierung #ERechnung

Mit ZUGFeRD Swite steht ab sofort ein vollständig automatisiertes, KI-gestütztes Feld-Mapping für FileMaker zur Verfügung. Das System analysiert eigenständig sämtliche FMPXML-Exports aus FileMaker und erstellt innerhalb weniger Sekunden eine komplette Zuordnung zwischen den Quellfeldern und den ZUGFeRD-Zielfeldern. Damit entfällt der aufwendige manuelle Mapping-Prozess, der bislang bei jeder neuen Installation nötig war, Die KI übernimmt die gesamte Arbeit und liefert ein fertiges JSON-Mapping, das sofort in FileMaker übernommen wird. Das ganze erweitert unsere AddOns im Bereich ZUGFeRD. Alle Funktionen bleiben bestehen, das Mapping, mit einem derzeitigen Arbeitsaufwand von ca. 1 Stunde wird auf wenige Minuten reduziert. ## Das Problem: Komplexes Field-Mapping überfordert Anwender Wer schon einmal versucht hat, ZUGFeRD-konforme elektronische Rechnungen aus einem bestehenden ERP- oder Warenwirtschaftssystem zu erzeugen, kennt die Herausforderung: **75+ ZUGFeRD-Felder** müssen den vorhandenen Datenfeldern zugeordnet werden. Ein mühsamer, fehleranfälliger Prozess, der für unerfahrene Anwender kaum zu bewältigen ist. Die klassische Vorgehensweise: - Manuelles Durchgehen jedes einzelnen ZUGFeRD-Feldes - Suchen des passenden Quellfeldes in verschiedenen Tabellen - Copy & Paste von Feldnamen - Stundenlange Trial-and-Error-Sessions - Häufige Fehler durch Tippfehler oder falsche Zuordnungen **Das Ergebnis:** Frustration, Zeitverlust und hohe Fehlerquote. In unserem Bisherigen AddOn, deshalb das händische Mappen ohne in den FileMaker-Scripten Änderungen vornehmen zu müssen. ## Die Lösung: KI macht das Mapping automatisch Nun aber übernimmt diesen Schritt die KI – **Künstlicher Intelligenz** (Claude API von Anthropic). ### So funktioniert es Das System besteht aus drei einfachen Schritten: #### 1. Datenexport aus FileMaker Der Anwender exportiert **7 XML-Dateien** aus seinem System: - **preferences.xml** – Enthält alle ZUGFeRD-Zielfelder (die Referenz) - **invoice.xml** – Rechnungskopfdaten (Rechnungsnummer, Datum, Summen, etc.) - **buyer.xml** – Kundendaten (Name, Adresse, USt-ID, etc.) - **seller.xml** – Verkäuferdaten (Firma, Adresse, Kontakt, etc.) - **finance.xml** – Zahlungsinformationen (IBAN, BIC, Zahlungsbedingungen) - **payments.xml** – Zahlungsdetails und Fälligkeiten - **items.xml** – Rechnungspositionen (Artikel, Mengen, Preise, Steuern) Diese Dateien werden **automatisch nacheinander** auf den Server hochgeladen – kein manuelles Handling nötig. #### 2. KI-gestütztes Mapping Nach dem Upload wird das **KI-Mapping-Script** gestartet: ```php URL: https://ihr-server.de/ki_mapping/start_mapping.php ``` Was passiert im Hintergrund? 1. **Datenanalyse:** Das System liest alle 7 XML-Dateien ein 2. **Feldextraktion:** ZUGFeRD-Zielfelder und Quellfelder werden extrahiert 3. **Intelligente Analyse:** Die KI analysiert: - Feldnamen (semantische Ähnlichkeit) - Beispieldaten aus den ersten 3 Datensätzen - Datentypen und -strukturen 4. **Automatisches Mapping:** Die KI ordnet jedem ZUGFeRD-Feld das passende Quellfeld zu **Dauer:** 5-15 Sekunden (abhängig von der Datenmenge) #### 3. JSON-Response mit fertigem Mapping Das System gibt eine strukturierte JSON-Antwort zurück: ```json { "success": true, "message": "39 von 43 Feldern erfolgreich gemappt", "mapping": { "buyerName": "buyer.BuyerName", "buyerCity": "buyer.BuyerCity", "buyerStreet": "buyer.BuyerStreet", "invoiceNumber": "invoice.InvoiceNumber", "invoiceDate": "invoice.InvoiceIssueDate", "totalGrossAmount": "invoice.InvoiceLegalMonetaryTotalTaxInclusiveAmount", "payeeIBAN": "finance.payeeIBAN", "quantity": "items.LineInvoicedQuantity", "priceNet": "items.LineNetPriceAmount", ... }, "statistics": { "total_zugferd_fields": 43, "mapped_fields": 39, "unmapped_fields": 4, "unmapped_list": ["deliveryTerms", "lieferschein_nr", ...] } } ``` Diese JSON kann direkt in FileMaker (oder jedem anderen System) weiterverarbeitet werden. ## Technische Details ### Architektur Das System besteht aus drei PHP-Scripten: **1. receive_xml.php** – XML-Upload-Handler - Empfängt die 7 XML-Dateien nacheinander - Automatische Reihenfolgen-Erkennung (kein manuelles Benennen nötig) - Parst FileMaker FMPXMLRESULT Format - Extrahiert Feldnamen und Beispieldaten - Speichert XML + JSON-Metadaten **2. process_mapping.php** – KI-Mapping-Engine - Liest alle 7 XML-Dateien - Extrahiert ZUGFeRD-Zielfelder aus preferences.xml - Sammelt Quellfelder + Beispieldaten aus den anderen 6 Dateien - Erstellt intelligenten Prompt für Claude API - Parst KI-Response und validiert Mapping - Speichert Ergebnis als JSON mit Timestamp **3. start_mapping.php** – FileMaker-Interface - Einfacher Endpoint für FileMaker "Aus URL Einfügen" - Startet Mapping-Engine - Gibt JSON-Response direkt zurück - Timeout: 60 Sekunden (ausreichend für alle Fälle) ### Keine Dependencies nötig! Das System nutzt **PHP-Bordmittel:** - `SimpleXML` für XML-Parsing - `cURL` für API-Kommunikation - Keine externen Libraries erforderlich Der bestehende `vendor/`-Ordner auf dem Server bleibt unangetastet. ### KI-Integration: Claude API Wir nutzen **Claude 3 Haiku** von Anthropic: - Schnell (5-15 Sekunden Response) - Günstig (ca. 0,01-0,05 EUR pro Mapping) - Hohe Qualität bei semantischer Analyse - Versteht natürliche Sprache UND Datenstrukturen Die KI erhält: - Liste aller ZUGFeRD-Zielfelder - Alle Quellfelder mit Beispieldaten - Mapping-Regeln (Präzision, Format, etc.) Und gibt zurück: - Vollständiges Mapping als JSON - Confidence-Level implizit durch Match-Quality - `null` für nicht zuordenbare Felder ## Vorteile des Systems ### ✅ Für Anwender - **Keine technischen Kenntnisse erforderlich** - **90%+ automatische Trefferquote** - **Sekunden statt Stunden** - **Fehlerrate nahezu Null** - **Wiederverwendbare Mappings** ### ✅ Für Entwickler/Administratoren - **Einfache Installation** (3 PHP-Dateien) - **Keine komplexen Dependencies** - **Vollständig protokolliert** (Logs in `csv_uploads/`) - **Versionierte Mappings** (Timestamp-basiert) - **Anpassbare Mapping-Regeln** (Prompt kann erweitert werden) ### ✅ Für Unternehmen - **Drastische Zeitersparnis** bei der Implementierung - **Reduzierte Fehlerkosten** - **Schnellere Onboarding-Prozesse** - **Skalierbar** (beliebig viele Mandanten/Systeme) - **Kosteneffizient** (< 5 Cent pro Mapping) ## Integration in FileMaker ### Script-Aufbau ```applescript # Schritt 1-7: XML-Uploads Aus URL einfügen [ URL: "https://server.de/ki_mapping/receive_xml.php" Daten: $xml_preferences Methode: POST ] # ... weitere 6 Uploads ... # Schritt 8: KI-Mapping starten Aus URL einfügen [ URL: "https://server.de/ki_mapping/start_mapping.php" In Variable: $$MappingResponse Timeout: 30 Sekunden ] # Schritt 9: JSON parsen und verwenden Feld setzen [ feldmapping::json ; $$MappingResponse ] ``` ### JSON-Weiterverarbeitung Das Mapping kann direkt genutzt werden: - Import in FileMaker-Tabellen - Verwendung für ZUGFeRD-Export - Speicherung als wiederverwendbares Template - Export für andere Systeme ## Fazit Was früher Stunden manueller Arbeit erforderte, erledigt die KI nun in Sekunden – **mit höherer Qualität und weniger Fehlern**. Das System zeigt eindrucksvoll, wie KI komplexe, repetitive Aufgaben übernehmen kann, ohne dass Anwender technisches Spezialwissen benötigen. **ZUGFeRD-Integration war noch nie so einfach.** --- ## Technische Anforderungen - PHP 7.4+ (SimpleXML, cURL) - Anthropic API Account (ab 5 EUR/Monat ausreichend) - FileMaker Pro/Server

Im Zuge der Zusammenarbeit mit dem geschätzten Entwickler Alexander Lemuth haben wir in den letzten 2 Wochen etliche spannende Änderungen und Verbesserungen vorgenommen. Ursprünglich war geplant, die Implementierung gemeinsam per Zoom durchzuführen. Doch wie es oft bei guter Zusammenarbeit der Fall ist: während der intensiven Auseinandersetzung mit der bestehenden Lösung sind uns immer mehr interessante Details und Optimierungsmöglichkeiten aufgefallen. Was als einfaches Update beginnen sollte, entwickelte sich zu einer grundlegenden Überarbeitung. Die kritischen Fragen von Alexander und seine praktischen Anforderungen haben uns dazu gebracht, tiefer zu graben und das FM ZUGFeRD AddOn kräftig zu überarbeiten. Das Ergebnis ist Version 2.0, eine deutlich flexiblere, intuitivere und mächtigere Lösung, die wir ohne diesen produktiven Austausch nie erreicht hätten. Ein herzliches Dankeschön an dieser Stelle an Alexander für die konstruktiven Impulse, die geduldigen Tests und das ehrliche Feedback! # FM ZUGFeRD 2.0 – Die Evolution der elektronischen Rechnungsstellung in FileMaker Die elektronische Rechnungsstellung wird in Deutschland und Europa zunehmend zur Pflicht. Mit **FM ZUGFeRD 2.0** präsentieren wir die nächste Generation unseres AddOns für FileMaker – komplett überarbeitet, intuitiver und flexibler als je zuvor. ## Was ist neu? Die wichtigsten Features im Überblick ### 🎯 1. Flexible Primärschlüssel-Zuordnung Endlich: **Abweichende Primärschlüssel** für maximale Flexibilität! Nicht jede FileMaker-Lösung nutzt standardisierte Primärschlüssel. Mit der neuen Funktion können Sie für jeden Bereich (Seller, Buyer, Invoice, Items) einen **alternativen Primärschlüssel** definieren. **Was bedeutet das für Sie?** - Keine Anpassung Ihrer bestehenden Datenstruktur nötig - Volle Kontrolle über die Datenzuordnung - Nahtlose Integration in Ihre vorhandene FileMaker-Lösung **So funktioniert's:** Ein einfacher Dialog ermöglicht die Auswahl eines abweichenden Identifikationsfeldes. Das System nutzt dann automatisch diesen alternativen Schlüssel für die Datenzuordnung – perfekt für komplexe Datenmodelle mit individuellen Beziehungsstrukturen. ### 🖨️ 2. Erweiterte Drucklayout-Verwaltung Die neue **Drucklayout-Funktion** bietet Ihnen volle Kontrolle über die Ausgabe Ihrer ZUGFeRD-Dokumente: **Zwei Ansichtsmodi:** - **Formularansicht**: Für detaillierte Einzelrechnungen mit allen Informationen - **Tabellenansicht**: Für kompakte Listenansichten und Sammelrechnungen **Intelligente Layout-Zuordnung:** - Separate Layouts für verschiedene Ausgabeformate - Flexible Feldzuordnung pro Ansicht - Automatische Anpassung an Ihre Corporate Identity Das bedeutet: **Einmal konfigurieren, mehrfach nutzen** – ohne ständige manuelle Anpassungen. ### 🎨 3. Überarbeitete Benutzeroberfläche Die komplette Oberfläche wurde von Grund auf neu gestaltet. **Moderne, intuitive Navigation** durch alle Konfigurationsbereiche: **9 übersichtliche Tabs:** 1. **Info** – Zentrale URL-Konfiguration für alle Endpunkte 2. **Payments** – Rechnungskopf und allgemeine Daten 3. **Buyer** – Käufer-/Kundendaten mit vollständiger Adressverwaltung 4. **Seller** – Verkäufer-/Firmendaten inkl. Steuer-IDs 5. **Finance** – Bankinformationen und Zahlungskonditionen 6. **Invoice** – Rechnungsbeträge, Steuern und Totalsummen 7. **Items** – Rechnungspositionen mit detaillierten Artikeldaten 8. **Print** – Drucklayout-Verwaltung für beide Ansichtsmodi 9. **Testen** – Integrierte Demo- und Validierungsfunktionen **Das neue Design punktet mit:** - Klarer visueller Hierarchie - Zweisprachigen Labels (Deutsch/English) - Kontextsensitiven Hilfetexten - Farblich gekennzeichneten Bereichen für schnellere Orientierung ### 🔄 4. Intelligentes Feld-Mapping Das Herzstück von FM ZUGFeRD: Die **automatisierte Feldzuordnung**. **Wie es funktioniert:** 1. **Layout wählen**: Dropdown-Auswahl Ihrer FileMaker-Tabellen 2. **Felder zuordnen**: Drag & Drop Ihrer FileMaker-Felder zu ZUGFeRD-Standardfeldern 3. **Validieren**: Automatische Prüfung auf Vollständigkeit und Konformität 4. **Testen**: Sofortige Vorschau der generierten Dokumente **Unterstützte Datenquellen:** - Beliebige FileMaker-Tabellen - Portal-Beziehungen für Positionsdaten - Berechnungsfelder für dynamische Werte - Globale Felder für Standardwerte ### 📋 5. EN 16931 Konformität garantiert Alle generierten ZUGFeRD-Dokumente entsprechen der **Europäischen Norm EN 16931** für elektronische Rechnungen. **Technische Details:** - **Format**: PDF/A-3 mit eingebettetem XML - **Profile**: BASIC, COMFORT, EXTENDED - **Standard**: ZUGFeRD 2.x / Factur-X - **Kompatibilität**: UBL (Universal Business Language) **Validierung in Echtzeit:** Das AddOn prüft kontinuierlich: - Pflichtfelder gemäß gewähltem Profil - Korrekte Datenformate (Datum, Währung, Steuersätze) - Konsistenz zwischen Positionen und Gesamtsummen - Gültige ISO-Codes für Länder, Währungen und Einheiten ### 🧪 6. Integrierte Test- und Demo-Funktionen Der neue **Testen-Tab** ist Ihr Playground für ZUGFeRD-Dokumente: **Demo-Funktionen:** - **Create ZUGFeRD Demo**: Erstellt Beispielrechnungen zum Testen - **Create UBL Demo**: Generiert UBL-Testdokumente - **Read ZUGFeRD Demo**: Liest und analysiert vorhandene ZUGFeRD-Dateien - **Read UBL Demo**: Importiert UBL-Dokumente zur Validierung **Export/Import von Konfigurationen:** - Einstellungen exportieren für Backup oder Migration - Konfigurationen importieren zwischen Test- und Produktivumgebungen - Versionierung Ihrer Mapping-Definitionen **Live-Vorschau:** Zwei Container zeigen in Echtzeit: - **XML-Container**: Die generierte ZUGFeRD-XML-Struktur - **PDF-Container**: Das finale PDF/A-3-Dokument mit eingebettetem XML ### 🌐 7. Nahtlose HTTP-Integration FM ZUGFeRD arbeitet mit **PHP-Scripten (local oder Server)** über standardisierte HTTP-Schnittstellen: **Der Workflow:** 1. FileMaker sendet Rechnungsdaten via POST an konfigurierten Endpoint 2. PHP-Service generiert ZUGFeRD-konforme Struktur 3. XML wird nach EN 16931 erstellt und validiert 4. PDF/A-3 wird mit eingebettetem XML erzeugt 5. Fertiges Dokument wird zum Download bereitgestellt 6. FileMaker lädt automatisch herunter und speichert in Container-Feld **Ihre Vorteile:** - Keine lokale PDF-Bibliothek erforderlich - Zentrale Verwaltung der Generierungslogik - Skalierbar für hohe Dokumentenvolumen - Einfache Updates der ZUGFeRD-Spezifikationen ### 📊 8. Präzise Steuerberechnung Die Steuerberechnung erfolgt auf **zwei Ebenen** – vollständig automatisiert: **Positionsebene:** Jede Rechnungsposition enthält: - Einzelpreis (netto) - Menge und Einheit - Steuersatz (%) - Steuerkategorie (S, Z, E, AE, ...) - Automatische Berechnung des Zeilentotals **Dokumentebene:** Automatische Aggregation zu: - Gesamtnettobetrag (Summe aller Positionen) - Steuerblöcke pro Steuersatz - Steuerbemessungsgrundlage pro Satz - Gesamtsteuerbetrag - Bruttoendbetrag **Wichtig:** Das System stellt sicher, dass Position- und Dokumentsummen immer konsistent sind! ## Praktische Anwendungsfälle ### Szenario 1: Standardrechnung mit 19% MwSt. ``` Artikel: "Beratungsdienstleistung" Menge: 8 Stunden Einzelpreis: 120,00 EUR (netto) Steuersatz: 19% → Netto: 960,00 EUR → MwSt.: 182,40 EUR → Brutto: 1.142,40 EUR ``` FM ZUGFeRD erstellt automatisch ein PDF/A-3 mit eingebettetem XML – bereit für die elektronische Übermittlung. ### Szenario 2: Rechnung mit mehreren Steuersätzen ``` Position 1: Bücher (7% MwSt.) → 100,00 EUR netto Position 2: Software (19% MwSt.) → 500,00 EUR netto → Steuerblock 7%: Basis 100,00 EUR, Steuer 7,00 EUR → Steuerblock 19%: Basis 500,00 EUR, Steuer 95,00 EUR → Gesamt: 702,00 EUR brutto ``` Das AddOn erstellt automatisch separate Steuerblöcke für jeden Satz – EN 16931 konform. ### Szenario 3: Grenzüberschreitende Rechnung (Reverse Charge) ``` Verkäufer: Deutschland (DE) Käufer: Österreich (AT) mit gültiger UID Steuerkategorie: AE (Reverse Charge) → Nettobetrag: 2.500,00 EUR → Steuersatz: 0% (Hinweis auf Reverse Charge) → Bruttobetrag: 2.500,00 EUR ``` Perfekt für B2B-Geschäfte innerhalb der EU. ## Best Practices für Ihre FileMaker-Lösung ### 1. Datenstruktur vorbereiten **Empfohlene Felder in Ihrer Rechnungstabelle:** - `rg_nummer` (Text): Eindeutige Rechnungsnummer - `rg_datum` (Datum): Rechnungsdatum im Format YYYY-MM-DD - `rg_faellig` (Datum): Fälligkeitsdatum - `rg_waehrung` (Text): ISO-Währungscode (EUR, USD, CHF, ...) - `rg_kunde_id` (Zahl): Fremdschlüssel zur Kundentabelle - `rg_netto` (Zahl): Nettosumme (berechnet) - `rg_steuer` (Zahl): Steuerbetrag (berechnet) - `rg_brutto` (Zahl): Bruttosumme (berechnet) ### 2. Berechnungsfelder nutzen **Steuerbetrag berechnen:** ``` Round ( rg_netto * 0.19 ; 2 ) ``` **Bruttobetrag berechnen:** ``` rg_netto + rg_steuer ``` **Aggregation von Positionen:** ``` Sum ( rg_positionen::pos_netto ) ``` ### 3. Validierung implementieren **Prüfen vor Export:** - Sind alle Pflichtfelder gefüllt? - Ist die USt-ID formal korrekt? - Stimmen Positions- und Kopfsummen überein? - Sind ISO-Codes korrekt (Land, Währung, Einheit)? **FileMaker-Skript Beispiel:** ``` If [ IsEmpty ( rg_nummer ) or IsEmpty ( rg_datum ) ] Show Custom Dialog [ "Fehler"; "Pflichtfelder fehlen!" ] Exit Script [ Text Result: False ] End If # ZUGFeRD Export starten Perform Script [ "ZUGFeRD - Export Rechnung" ] ``` ### 4. Layouts strukturieren **Empfohlene Layout-Struktur:** - **Formularansicht**: Vollständige Rechnung mit Header, Positionen, Footer - **Listenansicht**: Kompakte Positionsübersicht - **Druckansicht**: Formatiert für PDF-Export mit Corporate Design ### 5. Fehlerbehandlung einbauen **Typische Fehlerquellen:** - Leere Pflichtfelder - Ungültige Datumsformate - Falsche Währungscodes - Fehlende Beziehungen zu Stammdaten **Lösung:** Validierungs-Skripte vor dem Export ausführen! ## Technische Details für Entwickler ### Unterstützte Einheitencodes (UN/ECE Recommendation 20) Die wichtigsten Codes für den deutschen Markt: | Code | Bedeutung | Verwendung | |------|-----------|------------| | **C62** | Stück | Einzelne Artikel, Produkte | | **HUR** | Stunde | Dienstleistungen, Beratung | | **DAY** | Tag | Tagessätze, Miete | | **MTR** | Meter | Längenangaben, Textilien | | **MTK** | Quadratmeter | Flächen, Immobilien | | **MTQ** | Kubikmeter | Volumen, Baustoffe | | **KGM** | Kilogramm | Gewichtsangaben | | **TNE** | Tonne | Schwergewicht, Rohstoffe | | **LTR** | Liter | Flüssigkeiten | | **SET** | Set | Produktsets, Bundles | | **MON** | Monat | Abonnements, Mieten | ### Steuerkategorien nach EN 16931 | Code | Bedeutung | Anwendung | |------|-----------|-----------| | **S** | Standard rate | Regelsteuersatz (19% in DE) | | **AA** | Lower rate | Ermäßigter Satz (7% in DE) | | **Z** | Zero rated | 0% (z.B. innergemeinschaftlich) | | **E** | Exempt | Steuerbefreit (z.B. Kleinunternehmer) | | **AE** | Reverse charge | Umkehr der Steuerschuldnerschaft | | **K** | Intra-Community | Innergemeinschaftliche Lieferung | | **G** | Free export | Export außerhalb EU | | **O** | Outside scope | Nicht steuerbar | ### Rechnungstyp-Codes (UNTDID 1001) | Code | Typ | Verwendung | |------|-----|------------| | **380** | Commercial Invoice | Standardrechnung | | **381** | Credit Note | Gutschrift/Stornorechnung | | **384** | Corrected Invoice | Korrekturrechnung | | **389** | Self-billed Invoice | Gutschriftverfahren | | **751** | Invoice Information | Rechnungsinformation | ### Zahlungsarten (ISO 20022) | Code | Zahlungsart | |------|-------------| | **58** | SEPA-Überweisung | | **30** | Banküberweisung | | **48** | Kreditkarte | | **49** | Lastschrift | | **97** | Verrechnungsscheck | ## Lizenzierung und Support ### COMFORT-Version FM ZUGFeRD ist als **COMFORT-Version** lizenziert und bietet: - Vollständige EN 16931 Konformität - Alle ZUGFeRD 2.x Profile (BASIC, COMFORT, EXTENDED) - UBL-Unterstützung - Unbegrenzte Dokumentenerstellung - Professioneller Support ### Updates und Wartung - Regelmäßige Updates bei Änderungen der ZUGFeRD-Spezifikation - Anpassungen bei gesetzlichen Änderungen - Bug-Fixes und Optimierungen - Neue Features basierend auf Kundenanforderungen ### Support-Kanäle - E-Mail Support: [email protected] - Dokumentation: Wiki mit ausführlichen Anleitungen - Video-Tutorials: Schritt-für-Schritt Konfiguration - Community-Forum: Austausch mit anderen Nutzern ## Migration von älteren Versionen ### Von FM ZUGFeRD 1.x auf 2.0 Die Migration ist einfach: 1. **Backup erstellen**: Sichern Sie Ihre aktuelle Konfiguration 2. **Export Settings**: Exportieren Sie Ihre Feldzuordnungen 3. **Update installieren**: Neue AddOn-Version in FileMaker laden 4. **Import Settings**: Importieren Sie Ihre gespeicherte Konfiguration 5. **Test durchführen**: Erstellen Sie Test-Dokumente zur Validierung **Was bleibt erhalten:** - Alle Feldzuordnungen - URL-Konfigurationen - Layout-Einstellungen **Was ist neu zu konfigurieren:** - Drucklayout-Zuordnungen (neue Funktion) - Alternative Primärschlüssel (falls gewünscht) ## Roadmap: Was kommt als Nächstes? Wir arbeiten bereits an weiteren Verbesserungen: ### Geplante Features (Q2-Q4 2025) - 🔄 **Batch-Verarbeitung**: Mehrere Rechnungen auf einmal exportieren - 📧 **E-Mail-Integration**: Direktversand via FM MailBridge AddOn - 🗄️ **Archivierung**: Automatisches Ablegen in revisionssicheren Archiven - 📱 **Mobile Optimierung**: Rechnungserstellung auf iPad - 🤖 **KI-Unterstützung**: Automatische Felderkennung beim Import - 🌍 **Weitere Formate**: X-Rechnung, Peppol BIS - 📊 **Analytics**: Reporting und Statistiken über ZUGFeRD-Nutzung ## Fazit: Bereit für die E-Rechnungs-Pflicht Mit **FM ZUGFeRD 2.0** sind Sie bestens gerüstet für die elektronische Rechnungsstellung: ✅ **Rechtskonform**: EN 16931 zertifiziert ✅ **Flexibel**: Passt sich Ihrer FileMaker-Lösung an ✅ **Intuitiv**: Moderne, übersichtliche Benutzeroberfläche ✅ **Zuverlässig**: Validierung in Echtzeit ✅ **Zukunftssicher**: Regelmäßige Updates und Erweiterungen ### Ab sofort verfügbar! **Jetzt informieren:** - 📧 E-Mail: [email protected] - 🌐 Web: www.filemaker-experts.de - 📞 Telefon: +49 (0) 176 3130 9949 --- *Hinweis: Ab 2025 wird die E-Rechnung in Deutschland für B2B-Transaktionen schrittweise verpflichtend. Mit FM ZUGFeRD erfüllen Sie alle gesetzlichen Anforderungen – heute schon für morgen bereit.* **#FileMaker #ZUGFeRD #ERechnung #DigitaleTransformation #Automatisierung**

Template-Konfiguration: optional, klein, hilfreich Damit ich bei Bedarf Kleinigkeiten ohne neues Template anfassen kann, lese ich eine layout_config.json ein. Sie enthält vor allem Koordinaten und Schriftgrößen für Textbausteine, die ich optional über FPDF ergänze (z. B. Adressblock, Infospalte, Summenfeld) – praktisch, falls Kundenvarianten leichte Unterschiede verlangen, aber kein komplett eigenes Template rechtfertigen. Beispielhafte Keys (gekürzt): page_width, margin_left, sender_start_x, right_column_label_x, document_type_y, table_start_y, default_font, header_bg_color, summary_label_x, template_pdf. Fehlt die Datei, läuft das System mit vernünftigen Standardwerten weiter – der ZUGFeRD-Teil ist davon ohnehin unabhängig. Logging und Fehlertoleranz Alle wesentlichen Schritte werden in uploads/zugferd_log.txt mit Zeitstempel geloggt: Welche Stufe gegriffen hat, Dateigrößen vor/nach Verarbeitung, gefundene Templates, etwaige Exceptions inklusive Trace. Damit sind Fehlersuche und spätere Betriebsbeobachtung unaufwendig. Auch wenn FPDI oder Ghostscript nicht verfügbar sind, bleibt das System funktionsfähig, da es am Ende immer auf die „Kopie + Einbettung“-Strategie zurückfällt. Was bleibt von FPDF? FPDF bleibt im Projekt lediglich als Minimal-Fallback oder für sehr kleine Ergänzungen (z. B. dynamischer Hinweistext) erhalten. Logos, Balken, CI-Elemente usw. kommen aus dem Template, so wie es sein soll. Fazit Statt aufwendig ein bestehendes Corporate-Design in FPDF nachzubauen, nutze ich jetzt vorhandene PDFs die in FileMaker erzeugt werden unverändert und lasse lediglich die ZUGFeRD-XML sauber einbetten. Die Kombination aus Template-Erkennung, FPDI-Fallback, optionaler Konvertierung und konsequentem Error-Handling führt zu einem robusten, praxistauglichen Workflow: Template bzw. die aktuelle Rechnung hochladen, Daten senden, fertige ZUGFeRD-PDF erhalten. Wenn Sie bereits ein gutes Rechnungslayout in FileMaker haben und nur „ZUGFeRD dazu“ brauchen, ist dieser Ansatz die pragmatische Abkürzung.

Elektronische Rechnungen sind längst Standard, insbesondere im öffentlichen Bereich mit UBL/XRechnung und bei Geschäftspartnern mit ZUGFeRD 2.1.1. Für viele FileMaker-Anwender stellt sich die Frage: Wie lassen sich diese Rechnungen direkt in bestehende Systeme integrieren, ohne jede Datei manuell zu erfassen? Genau hier setzt unser neues ZUGFeRD/UBL Reader Add-on an. Was kann das Add-on? • ZUGFeRD-PDFs einlesen: XML wird automatisch erkannt und verarbeitet • UBL/XRechnung unterstützen: kompatibel mit den gängigen Behörden- und Portallösungen • Strukturierte JSON-Ausgabe: Kopf-, Positions- und Steuerdaten stehen FileMaker-konform bereit • Beispielskripte und Mapping: sofort loslegen mit vorbereiteten Routinen • Flexibel im Einsatz: Einzelplatz oder Serverumgebung Warum ist das wichtig? • Zeitersparnis: keine manuelle Eingabe von Rechnungsdaten mehr • Rechtssicherheit: Unterstützung aktueller Standards für E-Rechnung • Offen & erweiterbar: klare Dokumentation, kein Vendor-Lock-in • Praxisnah: entwickelt von FileMaker-Experten mit jahrzehntelanger Projekterfahrung Für wen ist das interessant? • Unternehmen mit Pflicht zur E-Rechnung (öffentlicher Sektor, Lieferanten) • FileMaker-Entwickler, die Buchhaltung oder ERP-Funktionen integrieren möchten • Teams, die Eingangsrechnungen automatisiert verarbeiten wollen

Dieses JSON ist das ideale Bindeglied: In FileMaker genügt ein Loop über data.lines[], um die einzelnen Positionen anzulegen. Kopf und Summenfelder lassen sich direkt in Variablen schreiben und anschließend auf beliebige Felder mappen. Warum das spannend ist • Automatisierte Buchung: Eingehende Lieferantenrechnungen können ohne Medienbruch erfasst werden. • Plausibilitätsprüfung: Brutto = Netto + Steuer lässt sich sofort abgleichen. • Flexibilität: Egal ob Erzeugung oder Import dieselbe Technik (PHP + horstoeko) kann beides. Fazit Während viele nur an die Ausgabe denken, ist gerade das Einlesen der eigentliche Schlüssel zur durchgängigen Digitalisierung von Rechnungsprozessen. Mit ZUGFeRD lassen sich Daten beidseitig austauschen und mit ein paar Skriptzeilen in FileMaker hat man plötzlich nicht nur ein Export, sondern auch eine Import-Funktion in der Hand.

Nach intensiver Entwicklung ist es soweit: Unser ZUGFeRD-/Factur-X Add-on für FileMaker ist fertig! 🎉 Wer schon einmal versucht hat, ZUGFeRD in eine FileMaker-Anwendung einzubauen, kennt die Herausforderung: Eigenentwicklungen ziehen sich über Tage oder Wochen, kosten Zeit, Geld und Nerven – und am Ende bleibt die Frage nach der Wartbarkeit. Mit unserem Add-on gehen wir einen anderen Weg. Keine Programmierung, kein kompliziertes Skripten, stattdessen Mapping. Mapping statt Programmieren Die Implementierung basiert auf dem offiziellen COMFORT-Profil von ZUGFeRD/Factur-X. Das bedeutet: Alle relevanten Rechnungsdaten werden abgedeckt, ohne dass man sich selbst tief in Spezifikationen und Normdetails einarbeiten muss. Anstatt eigene Scripts oder Datenmodelle zu schreiben, werden die bestehenden Felder in FileMaker einfach über ein Mapping den benötigten ZUGFeRD-Feldern zugeordnet. Damit bleibt die eigene Struktur unverändert, und trotzdem erfüllt die Anwendung sofort den Standard. In weniger als einer Stunde einsatzbereit Der größte Vorteil: Die Integration dauert in der Regel nicht länger als eine Stunde. Das Add-on klinkt sich direkt in die bestehende FileMaker-Datenbank ein, ohne dass das Rechnungslayout oder vorhandene Scripts angepasst werden müssen. Wer möchte, kann die Integration jederzeit durch eigenes Skripting erweitern – doch die Grundinstallation läuft komplett ohne Programmieraufwand. Vorteile gegenüber Eigenentwicklung • Zeitersparnis: statt tagelanger Arbeit → unter einer Stunde fertig. • Kostenreduktion: keine teuren Eigenentwicklungen, kein externer Entwickler notwendig. • Zukunftssicherheit: Nutzung des offiziellen ZUGFeRD-COMFORT-Profils, das in vielen Branchen bereits Standard ist. • Flexibilität: Erweiterungen und Anpassungen sind jederzeit möglich, aber nicht zwingend nötig. Fazit Endlich verfügbar! Mit unserem ZUGFeRD-Add-on für FileMaker sparen Sie Zeit, Geld und Ressourcen – und bleiben dabei normenkonform.