Key Takeaways
4 insights · 10 min readBillToLegalRegNo is the buyer’s legal registration identifier (IBT-047 in PINT-AE), not their TRN.
In Zoho Books it is the Buyer ID Value in the customer’s Other Details tab.
PINT-AE allows 4 identifier types: commercial or trade licence, Emirates ID, passport and cabinet decision.
Fixing it usually reveals the partner field next: BillToLegalAgency, the authority that issued the licence.
VAL0001 BillToLegalRegNo must not be empty means the customer on the invoice has no legal registration number. In Zoho Books, open the customer, go to Other Details and enter the Buyer ID Value, normally the trade licence number exactly as printed. Save the customer and push the invoice again.
In this guide
What the error meansWhy the TRN isn't enoughWhich identifier to useWhere it goes in ZohoEntering it correctlyGroups, branches and free zonesFixing all customers at onceWhat error comes nextDone-for-you optionVAL0001 BillToLegalRegNo is one of the first specific errors you see once a Zoho Books e-invoice gets past the generic failure. It appeared on our client’s second push, alongside two others. This is Part 2 of our Zoho Books e-invoice error series. It explains what the field is, which identifier to use for different kinds of customer, where it goes in Zoho Books, and how to fill it for every customer at once rather than one failure at a time. If you would rather have it done for you, our Zoho Books e-invoicing implementation covers it.
What does VAL0001 BillToLegalRegNo must not be empty mean?
It means the customer has no legal registration number on record. VAL0001 is the code Zoho Books uses for a required field that is empty; BillToLegalRegNo tells you which one.
In the UAE e-invoicing standard, PINT-AE, this is the buyer legal registration identifier (business term IBT-047), defined as an identifier issued by an official registrar that identifies the buyer as a legal entity or person. In plain terms: the number on your customer’s licence or other registration document.
The prefix “BillTo” refers to the customer (the party you bill), not your own company. Your organisation’s registration details are held separately in the organisation settings, and they were not the problem in our client’s case.
Why isn’t the customer’s TRN enough?
Because the TRN and the legal registration identify different things. The TRN identifies the customer to the FTA for VAT. The legal registration identifies the legal entity on the register that created it: a DET licence, a free zone licence, an Emirates ID.
| Identifier | Identifies | Issued by | Where it sits in Zoho Books |
|---|---|---|---|
| TRN (15 digits) | The customer as a VAT registrant | Federal Tax Authority | Customer tax details |
| TIN (first 10 digits of TRN) | The customer for e-invoicing and routing | Derived from the TRN | Customer TIN field |
| Peppol ID (0235:TIN) | The customer’s inbox on the network | Registered by the customer’s ASP | Customer electronic address |
| Legal registration number | The customer as a legal entity | DET, a free zone authority, ICP or other registrar | Customer › Other Details › Buyer ID Value |
Most UAE ledgers hold the first, sometimes the second, rarely the third, and almost never the fourth. That is why this error is so common: it is asking for something that accounting systems have never needed before.
Which identifier should you enter for each type of customer?
PINT-AE allows four identifier types for the buyer’s legal registration: commercial or trade licence, Emirates ID, passport and cabinet decision. For almost every B2B customer the answer is the trade licence.
| Customer type | Identifier type | What to enter | Extra detail needed |
|---|---|---|---|
| Mainland company or establishment | Commercial / trade licence | Licence number as printed | Issuing authority, e.g. DET for Dubai |
| Free zone company (FZE, FZCO, FZ-LLC) | Commercial / trade licence | Free zone licence number | The free zone authority |
| Individual with Emirates ID | Emirates ID | 15-digit Emirates ID number | — |
| Individual without Emirates ID | Passport | Passport number | Passport issuing country |
| Entity created by cabinet decision | Cabinet decision | Decision reference | Confirm format with your ASP [VERIFY] |
Expert Tip
Licence numbers are only unique within the authority that issued them. Two different free zones can issue the same number to two different companies, which is exactly why the authority field exists alongside this one.
Where do you enter it in Zoho Books?
In the customer record, on the Other Details tab, in the Buyer ID Value field. That tab also holds the TIN, Buyer ID Authority, legal name and electronic address used for e-invoicing.
- Open the customer — Sales › Customers, then open and edit the customer on the failed invoice.
- Go to Other Details — The e-invoicing identity fields are grouped here.
- Enter the Buyer ID Value — The licence number exactly as printed. No “Licence No.” prefix, no spaces added or removed.
- Fill Buyer ID Authority at the same time — Otherwise the next push fails on BillToLegalAgency. See Part 3.
- Check the legal name — It should match the licence, not the trading name you use in conversation.
- Save and push again — The change applies to every future invoice to that customer.
⚠️ Edit the customer, not the invoice
The registration number belongs to the customer record. Typing it into invoice notes or a custom invoice field will not satisfy validation, and it would have to be repeated on every invoice.
What mistakes cause the error to come back?
Most repeat failures come from the right field filled with the wrong content. These are the patterns we see most often:
Common BillToLegalRegNo mistakes
• TRN pasted as the licence number — The TRN belongs in the tax fields; this field needs the registration number.
• Expired licence details — A renewed licence normally keeps its number, but a re-licensed or migrated company may not. Use the current licence.
• Parent company licence on a branch — If the customer is a separately licensed branch, use the branch licence, not the parent’s.
• Prefixes and labels — Entering “TL No. 123456” instead of the number itself.
• Trading name instead of legal name — The legal name on the customer record should match the licence the number came from.
How do VAT groups, branches and free zone customers change the answer?
The identifier always belongs to the legal entity you are invoicing, even when the VAT registration is shared or the customer operates through several licences.
| Situation | Which registration to use | Why |
|---|---|---|
| Customer is a member of a VAT group | The licence of the member you actually invoice | The group shares a TRN, but each member is a separate legal entity, and each member needs its own e-invoicing endpoint |
| Customer has a mainland and a free zone licence | The licence of the entity named on your contract and invoice | Different licences mean different legal entities or branches |
| Customer is a branch with its own licence | The branch licence | The branch is registered separately with its authority |
| Customer changed free zone or re-licensed | The new licence | Old numbers may no longer exist on the issuing register |
If you are unsure which entity you are actually supplying, look at the contract and the purchase order. The legal entity named there is the one whose licence belongs in Buyer ID Value, and its TRN, TIN and Peppol ID should all point to the same entity. A record that mixes the group TRN with a branch licence and another member’s Peppol ID will pass the empty-field check and still cause delivery problems later.
How do you fix this for all your customers at once?
Collect the data first, then load it in bulk. Fixing customers one failed invoice at a time can take months; a single clean-up takes days.
- List active B2B customers — Customers you expect to invoice after your go-live date. Ignore dormant records.
- Request licence copies — One document gives you the licence number, issuing authority and legal name.
- Build a working sheet — Customer name, legal name, licence number, authority, TRN, TIN and Peppol ID, with a source column.
- Load the data — Use Zoho Books’ customer import to update existing records, exporting a sample first so the column names match exactly, or update records manually for short lists.
- Spot-check before go-live — Open a sample of updated customers and push one test invoice per customer type.
Customer list too long to clean by hand?
We build the sheet, chase the licences and load the data. Send us the size of your customer list.
What error usually appears after you fix it?
BillToLegalAgency AgencyName must not be empty. A registration number needs the name of the authority that issued it; the two fields work as a pair. On our client’s invoice both errors appeared on the same push. The fix is covered in Part 3 of this series.
The third error on that push, VAL1238 Invalid ServiceCodeScheme, came from the item record rather than the customer, and is covered in Part 4.
✗ Fix one field, push, repeat
Each push reveals the next empty field, so one customer can take three or four attempts and several support tickets.
✓ Fill the identity block together
Buyer ID Value, Buyer ID Authority, legal name, TIN and electronic address entered in one sitting from one licence copy.
Should you fix this yourself or get help?
Fix it yourself if you have a handful of customers and their licence copies to hand. Get help when the customer list is long, includes many free zone companies, or nobody owns master data. Our Zoho Books e-invoicing service includes the customer identity clean-up, item classification, ASP appointment, test invoices with recorded UUIDs and a 30-minute training session, for AED 499 + VAT per organisation. Bulk clean-up of very large lists is quoted separately in writing first.
Not sure Zoho Books is the right route at all? Start with the free diagnosis on our UAE e-invoicing page.