Application · ERP setup

Xero

Xero already has the fields. The work is making sure they are filled in, on the right address type.

Send this to the client

Copies the whole Xero 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 customer's tax number on the contact

    Contact → Financial details → Tax Number. 15 digits for a UAE buyer.

    Read from Contact.TaxNumber

    If it is missing: “Contact TaxNumber (TRN) is missing.” / “…must be 15 characters long.”

  • Use the STREET address, not only the postal one

    A Xero contact holds two addresses. The platform reads the street address, so a contact with only a PO Box filled in reads as having no address at all.

    Read from Contact.Addresses[STREET].AddressLine1 / .City / .Region / .Country

    If it is missing: “Contact Address Country is missing.”

  • Give every line an item and a tax rate

    The line's item name and tax rate are both read. A free-text line with no item can still be sent, but you have to repoint the item name to the line description on the PINT Mapping page.

    Read from LineItems[].Item.Name, LineItems[].Description, LineItems[].TaxType

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