Application · ERP setup

Wafeq

Wafeq contacts have no separate state field, so the city is what carries the emirate.

Send this to the client

Copies the whole Wafeq checklist below as plain text — the steps, the fields each one fills, and the rules that apply to every system — ready to paste into an email.

Before you invoice a customer

A one-time job per customer. Until it is done, that customer's invoices cannot be filed, because a buyer with no tax number and no address cannot be identified to the FTA.

  • Enter the contact's Tax Registration Number

    Contact → Tax registration number. 15 digits for a UAE buyer.

    Read from contact.tax_registration_number

  • Fill in address, city and country on the contact

    For a UAE buyer put the emirate in the city field — that is the field the platform reads for the emirate, because Wafeq has no state field and the district field is usually blank.

    Read from contact.address / .city / .country

  • Nothing to do about the net total

    Wafeq publishes only the tax-inclusive amount, so the platform derives the net from the lines itself. Mentioned only so the figures look familiar when you compare them.

    Read from net_amount — derived, not read

What is the same for all of them

A UAE buyer's TRN is 15 digits. Fourteen or sixteen is rejected — the length is checked, not just the presence.

A buyer outside the UAE has no UAE TRN and is not expected to. Put its own national tax number in the same field and the platform builds its Peppol address from that, under its country's scheme. If the buyer is on the Peppol network under an identifier of its own, that is better still. Leave the field empty and nothing fails: a buyer outside the UAE is never refused for a missing tax number, and is addressed by the export placeholder instead.

Some countries publish a company-register or e-invoicing identifier rather than a tax number — Denmark, Sweden, Norway, Finland, Singapore and others — so no address can be built from a tax number alone. Those invoices are still filed: the buyer is addressed by the FTA's export placeholder, which means the document reaches the authority but is not delivered to the buyer over the network. Supplying a real participant id, where the buyer has one, is what turns that into a delivery.

The country is mandatory on every buyer, and for a UAE buyer the emirate is what the FTA reads as the region.

If the field lives somewhere else

Every path above is a default, not a fixed contract. The PINT Mapping screen points any field at a different source in your own data — so data kept somewhere unusual is repointed rather than moved.

All ERP prerequisites