Tax and register numbers · Singapore

UEN Field for Gravity Forms

UEN Field for Gravity Forms brings a field for the Unique Entity Number (UEN) from Singapore into Gravity Forms, the form plugin for WordPress. The field checks on your own server on submission whether the identifier matches one of the three official formats of the UEN, and so catches incorrectly formed identifiers before they end up in your data.

The UEN is the identifier that companies and other entities in Singapore use when dealing with government agencies. If you want, the field also asks the directory of the corporate regulator ACRA on data.gov.sg whether the UEN has been issued.

How it works
View the manual

Who it is for

Who benefits.

The field is for forms in which business customers or suppliers from Singapore enter their details, for example for billing addresses or for onboarding new suppliers. It is also for developers who need a UEN in the settings of their own plugin.

For you, this means: an identifier that does not match any of the three official formats is caught the moment the form is submitted, not when you start working with the data. What gets saved is in the correct form. That is a reliable basis for customer data, invoices and e-invoices, meaning invoices as structured files that software can read.

Two stages work together. The check on your server always runs, the lookup after it only if you switch it on.

On your server only Plus the lookup with ACRA
One of the three official formats ✓ ✓
The UEN has been issued – ✓
What the check on your server catches and what the lookup with ACRA adds.

What the field does for you

  • You find the field UEN in the form editor in the field group e-Invoicing Fields and add it to your form like any other field.
  • It checks every identifier on your server. It must match one of the three official formats of the UEN.
  • If you want, it also confirms the UEN with the ACRA authority. That way you know the UEN is not just correctly formed but actually issued. You do not need a key for this. Alternatively, the lookup runs through your invoicePress account.
  • If you write your own plugins, you get the same check as a field type for their settings pages. You can use the field outside a form, too, without rebuilding the rules yourself.

What it does not do

  • It does not check a check digit. A check digit is a digit calculated from the other characters that reveals typos. No such check digit has been officially published for the UEN. So only the online check shows whether an identifier has really been issued.
  • It does not fill in other fields of the form. It does not copy the name or address from the register.
  • It does not store the responses from data.gov.sg.
  • It does not make your form depend on data.gov.sg. If data.gov.sg is unreachable at the moment, your customer can still submit the form.

How it works

From entry to saved record

1 · Entry
your customer types the identifier
2 · Check on your server
one of the three formats
3 · Optional: ACRA
Has the UEN been issued?
4 · Saved
with a checked identifier
How the field checks an entry on submission: first on your server, then, if you want, with ACRA, and after that the entry is saved.

This page does not have a demo yet, but the manual takes you through every step of the setup.


Requirements

What you need.

WordPress a running WordPress installation
PHP version 7.4 or newer
Gravity Forms version 2.5 or newer, installed and active
Register check Nothing else, because data.gov.sg does not require a key. Optionally, the lookup can run through your invoicePress account with an API key from invoicePress, that is, an access code.

Manual

Everything explained step by step.

The manual explains how to install and set up the plugin, what each setting does and what applies in special cases. It describes version 1.0.2.

View the manual
Manual as PDF

Deutsches Handbuch · PDF


Goes well with

Fields that go well with it

EU VAT ID · EU

VAT ID Field for Gravity Forms brings a field for the VAT identification number of the EU, called USt-IdNr. in Germany. If you want, it confirms the number with VIES, the lookup system of the European Commission.

Learn more

LEI · worldwide

LEI Field for Gravity Forms brings a field for the Legal Entity Identifier (LEI), a worldwide identifier for companies and other legal entities that is issued only once. If you want, it confirms the identifier in the GLEIF register.

Learn more

ISO 6523 (ICD) · worldwide

ISO6523 ICD Field for Gravity Forms brings a field for organization identifiers according to ISO 6523. An e-invoice uses this list of identifier types to identify the seller and the buyer.

Learn more

EN16931 fields

Gravity Forms EN16931 Fields brings the code lists of the e-invoice into Gravity Forms as ready-made choices. A code list is a defined list of allowed values, for example the currency codes.

Learn more

All identifier fields · All extensions


Request it now, coming soon to the shop.

This plugin will be available in the shop on invoicePress.de shortly. Until then, you can get it on request. Just let us know that you need this field, together with other identifier fields if you like.

Request the plugin