Nota: Este guia de configuração está por agora disponível apenas em alemão. Se precisar dele em português ou inglês, pergunte-nos no chat.

Hilfe · ZUGFeRD Creator Version 3

Einrichtung des ZUGFeRD Creators

Diese Hilfe führt einmal durch die ganze Einrichtung: den PHP-Ordner auf einem Server oder lokal mit Laravel Herd, die Anbindung der Kundendatei, die Zuordnung, den Knopf im Rechnungsprogramm und den Test. Die Bedienung der Zuordnungsseite im Einzelnen beschreibt der Reiter „Anleitung“ im Creator selbst.

Diese Anleitung gilt für Version 3 des ZUGFeRD Creator. Sie arbeiten mit Version 4? Zur Hilfe für Version 4.

Wie die Teile zusammenhängen

Kundendatei                 ZUGFeRD Creator                  Webserver (PHP)
Rechnung, Angebot   ──►     liest den Beleg über      ──►    baut PDF/A-3 bzw.
Knopf „ZUGFeRD“             die Zuordnung                    XRechnung
       ▲                           │                                │
       └──── Ergebnis im Container ◄────────── Datei abholen ◄──────┘

Die Kundendatei bleibt fast unverändert. Sie bekommt einen Knopf und zwei Containerfelder für das Ergebnis. Alles andere, die Zuordnung, die Suche und das Hochladen, erledigt der Creator.

Der Weg

ServerDen Ordner fm_zugferd auf einen Webserver legen oder lokal mit Laravel Herd bereitstellen. Die Prüfseite install_check.php zeigt, ob alles da ist.
Creator einrichtenIm Reiter „Preferences“ die Adresse des Servers und den Lizenzschlüssel eintragen.
Kundendatei in den Creator holenDie Kundendatei als externe Datenquelle eintragen, Beleg- und Positionstabellen ins Beziehungsdiagramm, je Belegart ein leeres Layout.
Creator in die Kundendatei holenEinmalig _preferences_x aus dem Creator in das Beziehungsdiagramm der Kundendatei, dazu der Knopf, der ZF_Beleg_erzeugen ruft.
Zuordnen und testenIm Reiter „Zuordnung“ je Belegart die Felder zuordnen, mit „Vorschau“ prüfen, dann „Test PDF“ und „Test UBL“.

Voraussetzungen

Was	Mindestens
FileMaker Pro und Server	Version 19
PHP	8.1 mit den Erweiterungen SimpleXML, DOM, iconv, cURL, mbstring, GD und Sodium. Keine Datenbank, kein Composer, keine Kommandozeile.
Kundendatei	Eine Tabelle für den Belegkopf, eine für die Positionen, ein Containerfeld mit der gedruckten Beleg-PDF (nur für ZUGFeRD)
Lizenzschlüssel	Kommt mit dem Creator. Ohne ihn erzeugt der Server nichts; Zuordnung und Vorschau laufen auch ohne.
KI-Vorschlag (optional)	Ein API-Schlüssel von Anthropic (Claude)

Weiter: Server Frage stellen