Gravity Forms EPC-QR für Gravity PDF – Ihre Rechnung, bezahlt mit einem Scan
Fügt dem PDF, das Ihr Formular bereits erstellt, eine Zahlungsseite hinzu: einen echten EPC-QR-Code, den jede europäische Banking-App liest, mit vorausgefülltem Begünstigten, IBAN, Betrag und Zahlungsreferenz. Der Kunde scannt, bestätigt und die Rechnung wird bezahlt.
Kein Tippen, keine vertauschten Ziffern, kein „Welches Konto war das nochmal?“ Die Zahlungsdetails werden auch unter dem Code gedruckt, sodass die Seite auch für jemanden ohne Banking-App funktioniert – und ein falscher Wert sichtbar wird, anstatt in einem Quadrat aus Punkten verborgen zu bleiben.
Warum Sie es lieben werden
- Ein echter EPC-QR-Codein Anlehnung an EPC069-12 für SEPA-Überweisungen – derselbe Standard, den auch die Banking-Apps des Euroraums implementieren. Begünstigter, IBAN, BIC, Betrag, Verwendungszweck und Referenz werden darin aufgeführt, genau wie es die Spezifikation vorschreibt.
- An jedes Gravity-PDF angehängt. Die Rechnung, die Ihre Vorlage erstellt, bleibt davon unberührt; Der Code kommt als weitere Seite am Ende an. Jedes PDF eines Formulars oder nur das von Ihnen ausgewählte.
- Der Betrag ergibt sich aus der Buchungnicht aus einem zweiten Feld, das jemand synchron halten muss – es ist die gleiche Reihenfolge, die Total Gravity Forms zeigt. Der Code kann niemals einen anderen Betrag verlangen, als auf der Rechnung angegeben.
- Rechnungsnummer und -datum durch Merge-Tags. Schreiben Sie die Tags, die Ihr Dokument bereits verwendet, und was auch immer sie erzeugt, gelangt in die Zahlungsreferenz – dieses Plugin muss nie die Quelle kennen.
- ⚙️ Eine gemeinsame Einstellungsseite für die ganze Familie. Firmenname, IBAN, BIC und Gläubigerreferenz werden einmalig eingegeben und sind für jedes Companion-Add-on lesbar. Keine doppelte IBAN-Eingabe, daher sind speziell für dieses Add-on keine zwei IBANs – Firmenname und IBAN – erforderlich, da ohne diese kein EPC-QR-Code existieren kann.
- ️ Ein Ausfall macht niemals eine Rechnung kaputt. Nur ein Wert, der definitiv nicht funktionieren kann, stoppt die Seite; Ein fehlerhafter BIC betrifft dieses eine Feld, nicht das Dokument. Ein während des Versands einer Benachrichtigung erstelltes PDF kann niemals an einem Zahlungscode scheitern.
- Nichts zu installieren. Die Payload-Bibliothek wird mit dem Plugin geliefert und der QR-Encoder stammt von Gravity PDF selbst. Kein Composer-Schritt, kein API-Schlüssel, kein externer Dienst – der Code wird auf Ihrem eigenen Server berechnet.
- Übersetzungsbereit. Englisch und Deutsch inklusive, vollständig internationalisiert.
Hauptmerkmale
Die Zahlungsseite
- Eine Überschrift und eine kurze Einleitung, konfigurierbar pro Feed und beide Merge-Tag-fähig.
- Der QR-Code, 45 mm im Quadrat, Fehlerkorrekturstufe M – bequem von einer gedruckten Rechnung aus scannbar.
- Eine Liste der Werte, die tatsächlich in den Code eingeflossen sind, generiert aus dem eigenen Datensatz der Nutzlast dessen, was sie codiert hat, und nicht aus den Einstellungen. Es kann daher nicht behauptet werden, dass etwas im Code nicht enthalten ist. Pro Feed umschaltbar.
- Die Seite verfügt über eigene Ränder, sodass sie unabhängig von der Rechnungsvorlage, an die sie angehängt wird, gleich aussieht – und der Einzug wird immer nur zu dem hinzugefügt, was die Vorlage bereits vorsieht, sodass ein Dokument mit großzügigen Rändern nie doppelt eingerückt wird. Einstellbar durch einen Filter.
Referenz oder Text – die Regel des Standards, nutzbar gemacht
Der EPC-Standard erlaubt entweder eine strukturierte Gläubigerreferenz oder unstrukturierter Überweisungstext. Nie beides. Anstatt dabei zu scheitern, bietet der Feed die Wahl: die Referenz, wenn eine konfiguriert ist, immer die Referenz oder immer den Text. Wenn im automatischen Modus eines ausgewählt wird, wird die Entscheidung in das Protokoll geschrieben – so bleibt sie später erklärbar und nicht rätselhaft.
Sieben Zweckcodes
Die ISO 20022-Zweckcodes, die für die Rechnungsstellung von Bedeutung sind, von der Lieferantenzahlung über die Steuerzahlung bis hin zu Gehalt und Rente.
Die gemeinsame Seite „(e)Rechnungseinstellungen“.
Jedes Add-on dieser Familie, das eine globale Konfiguration benötigt, würde ansonsten eine eigene Registerkarte hinzufügen. Fünf Add-ons, fünf Registerkarten und in drei davon wurde die gleiche Firmen-IBAN eingegeben. Stattdessen gibt es eine Seite, die aus einem gemeinsamen Feld erstellt wurde Katalog – Ein Plugin definiert kein Feld mehr, sondern fordert diejenigen an, die es benötigt, und ein Feld mit mehreren Plugin-Namen erscheint immer noch genau einmal. Dieser fordert den Firmennamen, die IBAN, den BIC und die Gläubigerreferenz an und markiert den Firmennamen und die IBAN, die speziell für ihn selbst erforderlich sind, da ein EPC-QR-Code ohne sie nicht existieren kann, während die anderen Begleit-Add-Ons des Unternehmens ohne Zahlungskonto durchaus gültig sind. Ihr eigenes Plugin kann mit einem einzigen Aufruf ein Katalogfeld anfordern oder einen eigenen Abschnitt hinzufügen:
EInvoicePress_Fields::init();
EInvoicePress_Fields::request( array(
'en16931_seller_name',
'en16931_seller_iban',
) );
Lesen Sie einen Wert von überall aus mit EInvoicePress_Settings::get( ‚en16931_seller_iban‘ ). Ein Feld, das Ihr Plugin alleine benötigt, kann dennoch als eigener Abschnitt beigesteuert werden:
add_filter( 'einvoicepress_settings_sections', function ( $sections ) {
$sections[] = array(
'title' => 'My Section',
'priority' => 20,
'fields' => array(
array( 'name' => 'my_plugin_value', 'type' => 'text', 'label' => 'My value' ),
),
);
return $sections;
} );
Die Kennungen werden validiert und nicht nur gespeichert
- IBAN — Überprüfen Sie die Ziffern und das länderspezifische Format.
- BIC / SWIFT — Länge, Struktur und ein echter ISO 3166-1-Ländercheck an den Positionen 5-6.
- Gläubigerreferenz – Struktur plus die Prüfziffern ISO 7064 MOD 97-10 von ISO 11649.
Ein Tippfehler wird beim Speichern aufgedeckt und nicht Monate später durch eine Zahlung, die nie eintrifft. Dies sind die portablen Einstellungs-API-Feldtypen des Begleiters SEPA-Felder Add-on, als eigenständige Pakete kopiert – gleiche Regeln, gleiche Nachrichten, keine Abhängigkeit zwischen den Plugins.
Wird vor der Konfiguration überprüft
Der Feed-Bildschirm benennt, was fehlt, anstatt es Ihnen anhand einer Rechnung zu zeigen, die ohne Code versendet wurde: falsche Währung, Gravity PDF inaktiv, kein PDF auf diesem Formular oder Firmenname und IBAN noch nicht eingegeben – beides Pflichtfelder auf der Einstellungsseite. Dieselben Prüfungen werden zum Zeitpunkt des Renderns ausgeführt, so dass sich die beiden niemals darüber einig sein können, was falsch ist.
Entwickelt für die tatsächliche Funktionsweise von Gravity PDF
Ein Gravity-PDF-Dokument wird nicht erstellt, wenn das Formular gesendet wird, sondern immer dann, wenn jemand danach fragt, möglicherweise Jahre später und mehrmals. Die Seite wird daher zum Zeitpunkt des Renderns erstellt, was der einzige Zeitpunkt ist, zu dem das fertige Dokument existiert. Gravity PDF verwendet bereits gespeicherte Dateien wieder, sodass ein Dokument, das vor dem Hinzufügen des Feeds erstellt wurde, seinen alten Inhalt behält; Ein Feed-Schalter baut es wieder auf, standardmäßig ausgeschaltet, sodass im Normalbetrieb nichts langsamer wird. Und ein Dokument wird nie zweimal verlängert, egal wie oft die Hooks innerhalb einer Anfrage ausgelöst werden.
Was ist enthalten
- Das Plugin – ein Gravity Forms-Feed-Add-on für Gravity PDF, plus das Shared (e)Rechnungseinstellungen Seite, die andere Plugins erweitern können.
- Der smhg/sepa-qr-data Nutzlastbibliothek, gebündelt. Kein Composer-Schritt.
- Tragbar iban, bic Und iso11649 Feldtypen der Einstellungs-API mit ihren abhängigkeitsfreien Validatoren – wiederverwendbar in Ihren eigenen Plugins.
- Englische und deutsche Übersetzungen (.po / .mo).
- Vollständige Dokumentation in Englisch und Deutsch (README + Funktionsübersicht), einschließlich der Entwicklerreferenz und aller Hooks.
- Sauberer, gut strukturierter, objektorientierter und stark kommentierter Code – leicht zu lesen, zu erweitern und zu prüfen.
Anforderungen & Kompatibilität
- WordPress mit Schwerkraftformen ≥ 2,5
- Schwerkraft-PDF ≥ 6 (das kostenlose Core-Plugin reicht)
- PHP ≥ 8.1
- Die Gravity Forms-Währung muss es sein EUR – Der EPC QR-Standard unterstützt keinen anderen
- Kein ausgehender Netzwerkzugriff, kein API-Schlüssel, kein Drittanbieterdienst
- Funktioniert neben dem Begleiter SEPA-Felder, Feld „Umsatzsteuer-ID“.,
SIRET-Feld, LEI-Feld Und ABN-Feld
Add-ons.
Support und Updates
Sauberer, gut dokumentierter Code, der leicht zu warten ist. Sofort einsatzbereit für die Lokalisierung. Entwickelt, um dem offiziellen Add-on-Framework und den Settings API-Konventionen von Gravity Forms zu folgen und die dokumentierten Filter von Gravity PDF zu verwenden, damit es kompatibel bleibt, während sich Ihr Stack weiterentwickelt.
Änderungsprotokoll
1.0.1
- Der Begünstigtenblock wurde in den gemeinsamen Feldkatalog verschoben, sodass seine Felder von jedem Add-on der Familie, das sie benötigt, angefordert und nicht neu definiert werden.
- Firmenname und IBAN sind jetzt Pflichtfelder, die auf der Seite mit den gemeinsamen Einstellungen speziell für dieses Add-on erzwungen werden.
- Werte, die unter den Feldnamen vor 1.0.1 gespeichert sind, werden einmalig automatisch übernommen.
1.0.0
- Erstveröffentlichung. Feed-Add-on, das eine EPC-QR-Zahlungsseite an ein Gravity-PDF-Dokument anhängt.
- Das Geteilte (e)Rechnungseinstellungen Seite, erweiterbar durch jedes Plugin über einen Filter.
- Begünstigterblock mit validierter IBAN, BIC und Gläubigerreferenz unter Verwendung der portablen Settings API-Feldtypen des SEPA Fields-Add-ons.
- Betrag, der von der Bestellsumme des Eintrags abgezogen wird; Verwendungszweckcode, Überweisungsreferenz oder -text sowie Informationen zum Zahler pro Feed, mit Merge-Tag-Unterstützung.
- Strukturierte Referenz und unstrukturierter Text schließen sich laut Norm gegenseitig aus; Der Feed trifft die Wahl, anstatt daran zu scheitern.
- Eigene Seitenränder, anpassbar über die sp_epcqr_page_margins Filter.
- Optionaler Neuaufbau bereits gespeicherter PDFs.
- Deutsche Übersetzung.
Bewertung: 0
Verkäufe bisher: 0
Be the first to leave a review.
