Steuer- und Registernummern · Japan

Corporate Number Field for Gravity Forms

Corporate Number Field for Gravity Forms bringt ein Feld für die japanische Unternehmensnummer (法人番号, auf Englisch Corporate Number) in Gravity Forms, das Formular-Plugin für WordPress. Das Feld prüft die dreizehnstellige Nummer anhand ihrer Prüfziffer beim Absenden auf Ihrem eigenen Server und fängt so Tippfehler ab, bevor die Nummer 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 Nummer die Schema-Nummer 0188. Wenn Sie eine App-ID eingetragen haben, fragt das Feld zusätzlich bei der japanischen Steuerbehörde (National Tax Agency) nach, ob die Nummer vergeben ist. Die App-ID ist ein Zugangscode, den die Steuerbehörde für ihre Abfrageschnittstelle vergibt.

So funktioniert es
Handbuch ansehen

Für wen es gedacht ist

Wer davon profitiert.

Das Feld ist für Formulare gedacht, in denen Geschäftskunden oder Lieferanten aus Japan 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 Unternehmensnummer brauchen.

Der Gewinn für Sie liegt in sauberen Daten. Tippfehler und falsche Nummern fallen schon beim Absenden auf, sodass in Ihren Einträgen nur Nummern in richtiger Form stehen. Darauf können sich Ihre Kundendaten, Ihre Rechnungen und Ihre E-Rechnungen stützen, also Rechnungen als strukturierte Datei, die ein Programm lesen kann.

Die Tabelle zeigt die beiden Stufen der Prüfung. Die erste läuft immer mit, die zweite schalten Sie bei Bedarf dazu.

Nur auf Ihrem Server Zusätzlich mit Abfrage bei der Steuerbehörde
Dreizehn Ziffern und Prüfziffer ✓ ✓
Die Nummer ist vergeben – ✓
Was die Prüfung auf Ihrem Server erkennt und was die Abfrage bei der Steuerbehörde ergänzt.

Auch ohne App-ID arbeitet das Feld. Es prüft dann die Länge der Nummer und die Prüfziffer.


Was das Feld für Sie tut

  • Sie finden das Feld Unternehmensnummer (Japan) im Formulareditor in der Feldgruppe e-Invoicing-Felder und setzen es wie jedes andere Feld in Ihr Formular.
  • Es prüft jede Nummer auf Ihrem Server. Sie muss genau dreizehn Ziffern haben, und die erste Ziffer muss als Prüfziffer zu den übrigen passen.
  • Auf Wunsch bestätigt es die Nummer zusätzlich bei der Steuerbehörde. Damit steht fest, dass die Nummer nicht nur stimmig aufgebaut, sondern auch vergeben ist. Die Abfrage läuft entweder direkt über die Web-API der Behörde, also ihre Abfrageschnittstelle, oder über Ihr Konto bei invoicePress.
  • Entwickler bekommen dieselbe Prüfung als Feldtyp für die Einstellungsseiten ihrer eigenen Plugins. Sie können das Feld also auch außerhalb eines Formulars nutzen und müssen die Regeln nicht 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 der Steuerbehörde nicht.
  • Es macht Ihr Formular nicht von der Steuerbehörde abhängig. Ist die Steuerbehörde gerade nicht erreichbar oder fehlt die App-ID, kann Ihr Kunde das Formular trotzdem absenden.
  • Es prüft keine japanische Registrierungsnummer für die Umsatzsteuer (T-Nummer). Das ist eine andere Nummer als die Unternehmensnummer.

So funktioniert es

Von der Eingabe bis zum Eintrag

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

Eine Demo bieten wir auf dieser Seite noch nicht an. Damit die Einrichtung trotzdem leichtfällt, beschreibt das Handbuch jeden Schritt.


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 bei der Steuerbehörde Eine kostenlose App-ID für die Web-API des 法人番号システム, des Systems der Steuerbehörde für Unternehmensnummern. Alternativ 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.

Von der Installation über die ersten Schritte bis zu jeder Einstellung und besonderen Fällen erklärt das Handbuch alles. Es gilt für die Version 1.0.2 des Plugins.

Handbuch ansehen
Handbuch als PDF

English manual · PDF


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.

Mehr erfahren

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.

Mehr erfahren

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.

Mehr erfahren

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.

Mehr erfahren

Alle Kennungsfelder · Alle Erweiterungen


Jetzt anfragen, bald im Shop.

Dieses Plugin kommt in Kürze in den Shop auf invoicePress.de. Bis dahin erhalten Sie es auf Anfrage. Fragen Sie es einfach an, gern auch zusammen mit weiteren Kennungsfeldern dieser Reihe.

Plugin anfragen