Steuer- und Registernummern · Finnland

Y-tunnus Field for Gravity Forms

Y-tunnus Field for Gravity Forms bringt ein Feld für die finnische Unternehmenskennung Y-tunnus (auf Englisch Business ID) in Gravity Forms, das Formular-Plugin für WordPress. Die Kennung besteht aus sieben Ziffern und einer Prüfziffer. Das Feld prüft sie beim Absenden auf Ihrem eigenen Server und fängt so Tippfehler ab, bevor die Kennung in Ihren Daten landet. Eine Prüfziffer ist eine Ziffer, die aus den übrigen Ziffern berechnet wird und Tippfehler aufdeckt.

In der Kennungsliste ISO 6523, einer internationalen Liste von Kennungsarten für Organisationen, trägt diese Kennung die Schema-Nummer 0037. Auf Wunsch fragt das Feld zusätzlich im offenen Datenbestand des finnischen Patent- und Registeramts (PRH) und des Unternehmensinformationssystems YTJ nach, ob die Kennung vergeben ist.


Für wen es gedacht ist

Wer davon profitiert.

Das Feld ist für Formulare gedacht, in denen Geschäftskunden oder Lieferanten aus Finnland ihre Daten eingeben, zum Beispiel für Rechnungsadressen oder für die Aufnahme neuer Lieferanten. Außerdem richtet es sich an Entwickler, die in den Einstellungen ihres eigenen Plugins eine geprüfte Y-tunnus brauchen.

Sie haben davon zweierlei. Tippfehler und falsche Kennungen fallen schon beim Absenden auf und nicht erst später in Ihren Daten. Und in Ihren Einträgen stehen nur Kennungen in richtiger Form. Das ist eine verlässliche Grundlage für Ihre Kundendaten, Ihre Rechnungen und Ihre E-Rechnungen, also Rechnungen als strukturierte Datei, die ein Programm lesen kann.

Die Prüfung läuft in zwei Stufen. Die erste läuft immer, die zweite nur, wenn Sie sie einschalten.

Nur auf Ihrem Server Zusätzlich mit Abfrage bei PRH/YTJ
Sieben Ziffern und Prüfziffer ✓ ✓
Die Kennung ist vergeben – ✓
Was die Prüfung auf Ihrem Server erkennt und was die Abfrage bei PRH/YTJ ergänzt.

Was das Feld für Sie tut

  • Sie finden das Feld Y-tunnus im Formulareditor in der Feldgruppe e-Invoicing-Felder und setzen es wie jedes andere Feld in Ihr Formular.
  • Es prüft jede Kennung auf Ihrem Server. Sie muss aus sieben Ziffern und einer Prüfziffer bestehen, und die Prüfziffer muss zu den übrigen Ziffern passen.
  • Ihr Kunde kann die Kennung mit und ohne Bindestrich eingeben, so wie sie in Finnland geschrieben wird.
  • Auf Wunsch bestätigt es die Kennung zusätzlich bei PRH/YTJ. Sie wissen dann, dass die Kennung wirklich vergeben ist und nicht nur richtig aussieht. Dafür brauchen Sie keinen Schlüssel. Alternativ läuft die Abfrage über Ihr Konto bei invoicePress.
  • Entwickler nutzen dieselbe Prüfung als Feldtyp auf den Einstellungsseiten ihrer eigenen Plugins. So steht sie auch außerhalb eines Formulars bereit, und niemand muss die Regeln selbst nachbauen.

Wo seine Grenzen liegen

  • Es füllt keine anderen Felder des Formulars aus. Name und Anschrift aus dem Register übernimmt es nicht.
  • Es speichert die Antworten von PRH/YTJ nicht.
  • Es macht Ihr Formular nicht von PRH/YTJ abhängig. Ist PRH/YTJ gerade nicht erreichbar, kann Ihr Kunde das Formular trotzdem absenden.

So funktioniert es

Von der Eingabe bis zum Eintrag

1 · Eingabe
Ihr Kunde tippt die Kennung ein
2 · Prüfung auf Ihrem Server
sieben Ziffern, Prüfziffer
3 · Auf Wunsch: PRH/YTJ
Ist die Kennung vergeben?
4 · Gespeichert
mit geprüfter Kennung
So prüft das Feld eine Eingabe beim Absenden: zuerst auf Ihrem Server, auf Wunsch zusätzlich bei PRH/YTJ, und danach wird der Eintrag gespeichert.

Eine Demo zum Ausprobieren gibt es auf dieser Seite noch nicht. Das Handbuch zeigt Ihnen Schritt für Schritt, wie Sie das Feld einrichten.


Voraussetzungen

Was Sie brauchen.

WordPress eine laufende WordPress-Installation
PHP Version 7.4 oder neuer
Gravity Forms Version 2.5 oder neuer, installiert und aktiv
Prüfung im Register Nichts weiter, denn PRH/YTJ verlangt keinen Schlüssel. Wahlweise läuft die Abfrage mit einem API-Schlüssel von invoicePress, also einem Zugangscode, über Ihr Konto bei invoicePress.

Handbuch

Alles Schritt für Schritt erklärt.

Das Handbuch führt Sie durch die Installation und die ersten Schritte. Es erklärt jede Einstellung und beschreibt auch besondere Fälle. Es gilt für die Version 1.0.1 des Plugins.


Passt dazu

Diese Felder passen dazu

USt-IdNr. (EU) · EU

VAT ID Field for Gravity Forms bringt ein Feld für die Umsatzsteuer-Identifikationsnummer der EU, in Deutschland kurz USt-IdNr. Auf Wunsch bestätigt es die Nummer bei VIES, dem Abfragesystem der Europäischen Kommission.

LEI · weltweit

LEI Field for Gravity Forms bringt ein Feld für den Legal Entity Identifier (LEI), die weltweit eindeutige Kennung für Unternehmen und andere Rechtsträger. Auf Wunsch bestätigt es die Kennung im Register der GLEIF.

ISO 6523 (ICD) · weltweit

ISO6523 ICD Field for Gravity Forms bringt ein Feld für Organisationskennungen nach ISO 6523. Mit dieser Liste von Kennungsarten bezeichnet eine E-Rechnung Verkäufer und Käufer.

EN16931-Felder

Gravity Forms EN16931 Fields bringt die Codelisten der E-Rechnung als fertige Auswahlen in Gravity Forms. Eine Codeliste ist eine festgelegte Liste erlaubter Werte, zum Beispiel die Währungscodes.


Jetzt anfragen, bald im Shop.

Dieses Plugin kommt in Kürze in den Shop auf invoicePress.de. Bis dahin erhalten Sie es auf Anfrage. Schreiben Sie uns einfach, welches Kennungsfeld Sie brauchen.