Key Takeaways
4 insights · 9 min readBillToLegalAgency is the authority that issued the customer’s licence (Authority Name, BTAE-11 in PINT-AE).
In Zoho Books it is the Buyer ID Authority field, directly beside Buyer ID Value.
Mainland Dubai customers are licensed by DET; free zone customers by their free zone authority, not DET.
It arrives as a pair with BillToLegalRegNo. Fill both from the same licence copy in one sitting.
BillToLegalAgency[0].AgencyName must not be empty means the customer record has a registration number but no issuing authority. In Zoho Books, open the customer, go to Other Details and fill Buyer ID Authority with the authority printed on the customer’s licence, such as DET for Dubai mainland or the relevant free zone authority. Save and push again.
In this guide
What the error meansWhy a number needs an authorityWhich authority to enterWhere it goes in ZohoIndividuals and other identifiersKeeping it consistentAuditing existing entriesFixing it at scaleGet it doneThis error appeared on our client’s second push, directly beneath VAL0001 BillToLegalRegNo, and the two are best understood together. One is the number; this one is who issued it. This is Part 3 of our Zoho Books e-invoice error series. It covers what the field means in the UAE standard, how to tell which authority licensed a customer, the mistakes that pass validation but are still wrong, and how to keep the field consistent across hundreds of customers. Our Zoho Books e-invoicing implementation handles this as part of the customer clean-up.
What does BillToLegalAgency[0].AgencyName must not be empty mean?
It means Zoho Books has nothing in the issuing authority field for the customer’s legal registration. The registration number tells the network what the customer’s licence number is; the agency name tells it which register that number belongs to.
In PINT-AE, the buyer’s legal registration identifier carries an Authority Name element (BTAE-11), defined as the authority which has issued the commercial or trade licence. The [0] in the error message simply refers to the first authority entry on the record; for normal customers there is only one.
In our client’s case this error appeared on the same push as VAL0001 BillToLegalRegNo, because the customer record had neither field. That is the usual pattern: a customer missing one is almost always missing the other.
Why does the licence number need an authority?
Because UAE licence numbers are not unique across authorities. Each emirate’s economic department and each free zone runs its own register and numbering system, so the same digits can belong to two unrelated companies on two different registers.
The authority turns an ambiguous number into a precise reference: this number, on this register. That is also why the authority has to match the licence the number came from. A correct number paired with the wrong authority points to a company that does not exist, or to someone else entirely.
⚠️ Wrong is worse than empty
An empty authority fails validation, so you notice it. A wrong authority passes, so the error sits in your records until someone checks. Always take the authority from the licence itself.
Which authority should you enter for each customer?
The one printed on the customer’s current licence. The table below shows the common patterns, but the licence is always the source of truth.
| Where the customer is licensed | Typical issuing authority | Common mistake |
|---|---|---|
| Dubai mainland | Department of Economy and Tourism (DET) | Writing DED, the former name |
| Abu Dhabi mainland | Abu Dhabi Department of Economic Development (ADDED) | Entering DET because the invoice address says UAE |
| Sharjah mainland | Sharjah Economic Development Department (SEDD) | Confusing it with a Sharjah free zone such as SHAMS or SAIF |
| Dubai free zones (DMCC, JAFZA, DAFZA, Meydan and others) | The free zone authority named on the licence | Entering DET because the company is in Dubai |
| Northern emirates free zones (RAKEZ, Ajman Free Zone, SPC and others) | The free zone authority named on the licence | Entering the emirate’s economic department |
| DIFC or ADGM | DIFC Registrar of Companies or ADGM Registration Authority | Entering DET or ADDED |
Expert Tip
Our test customer was an FZ-LLC. Its address was in an emirate, but its licence came from a free zone authority. The address tells you where a company sits; only the licence tells you who registered it.
Where do you enter it in Zoho Books?
In the customer record, on the Other Details tab, in Buyer ID Authority, next to Buyer ID Value.
- 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 together here.
- Enter Buyer ID Authority — The authority’s official name, as printed on the licence.
- Confirm the pair — Buyer ID Value should be the licence number from the same licence.
- Check the legal name — It should match that same licence.
- Save and push again — The change applies to every future invoice to that customer.
What about customers identified by Emirates ID or passport?
The authority element is defined for commercial or trade licences. When the buyer is identified by passport, PINT-AE records the passport’s issuing country instead. For an Emirates ID, the identifier type itself tells the network what kind of number it is.
In practice almost every B2B e-invoice goes to a licensed business, so most of your customers will use a licence and an authority. If Zoho Books still asks for an authority on an individual buyer, enter the body that issued the document they were identified with, and confirm the expected entry with Zoho support before loading it across many records.
Sole establishments are a common grey area. A sole establishment is still a licensed business, even though it is owned by one person, so it is identified by its trade licence and the authority that issued it, not by the owner’s Emirates ID. Use the owner’s personal documents only where the buyer is genuinely an individual rather than a licensed business. If a customer cannot produce a licence at all, that is worth a conversation before go-live: it may mean the invoice is going to the wrong legal entity.
How do you keep authority names consistent across all customers?
Agree one spelling per authority before you start, and use it everywhere. A short reference list saves hours later.
| Do | Don’t |
|---|---|
| Use the official name as printed on licences | Mix abbreviations, full names and old names for the same authority |
| Keep a reference list of the authorities your customers use | Let each team member type their own version |
| Use DET, not DED, for Dubai mainland | Copy DED from old customer files |
| Record the free zone, not the emirate, for free zone companies | Enter DET for every company with a Dubai address |
Consistent entries make the next steps easier: you can filter customers by authority, check a batch against their licences, and correct a whole group at once if an authority changes its name.
Not sure which authority licensed a customer?
Send us the licence copy on WhatsApp and we’ll confirm the entry.
How do you check authority entries that already pass validation?
Run a short reasonableness check across all customers. Because a wrong authority passes validation, the only way to find one is to look. Export your customer list with the legal name, address, Buyer ID Value and Buyer ID Authority columns, and sort by authority.
| Check | Red flag | Likely fix |
|---|---|---|
| Legal name ends in FZE, FZCO, FZ-LLC or LLC-FZ | Authority is DET or another mainland department | Replace with the free zone authority on the licence |
| Authority entries for the same body spelled differently | Several versions of one name | Standardise to your reference spelling |
| Authority shows an old name | DED instead of DET | Update to the current name |
| Buyer ID Value present, authority blank | Will fail on the next push | Fill from the licence |
| Authority present, Buyer ID Value blank | Will fail as BillToLegalRegNo | Fill the licence number |
A company’s legal suffix is a quick clue rather than proof: names ending in FZE, FZCO or FZ-LLC are almost always free zone licences, while a plain LLC is more often mainland. When the clue and the entry disagree, open the licence. Ten minutes of sorting usually surfaces the handful of records that would otherwise cause confusion months later, when a customer queries an invoice and nobody remembers where the authority came from.
How do you fix it for every customer before go-live?
Treat it as part of one customer identity clean-up, not a separate job. The same licence copy gives you the licence number, the authority and the legal name.
✗ Fixing authorities after failures
Each failed invoice prompts one fix. Free zone customers get DET by default, and wrong-but-valid entries go unnoticed.
✓ One identity pass per customer
Licence number, authority, legal name, TIN and Peppol ID entered together from the licence and VAT certificate, then spot-checked.
After the customer is fixed, the remaining failures usually come from items. On our client’s invoice, the third error was VAL1238 Invalid ServiceCodeScheme, covered in Part 4.
Should you do this yourself or get help?
With a short customer list and licence copies to hand, this takes minutes per customer. With hundreds of customers across several free zones, it is a project. Our Zoho Books e-invoicing implementation includes the customer identity clean-up, item classification, ASP appointment, scenario tests with recorded UUIDs and a 30-minute staff training session for AED 499 + VAT per organisation. Very large lists are quoted separately in writing before we start.
If you are still deciding on software, the free diagnosis on our UAE e-invoicing page is the place to start.