Zoho BillToLegalAgency Error: Which Authority? | Fastlane
⚠️ E-invoicing: AED 50M+ businesses must appoint an ASP by 30 Oct 2026. Zoho Books implementation from AED 499 + VAT.See the service →
WhatsApp Us
Home›Blog›BillToLegalAgency AgencyName Error in Zoho Books
E-Invoicing · Zoho Books Error Series · Part 3

BillToLegalAgency AgencyName Must Not Be Empty: The Zoho Books Fix

A licence number on its own is ambiguous: DET and dozens of free zones each issue their own. This error asks which authority issued your customer’s licence, and getting it wrong is easier than getting it empty.

✓ FTA-registered tax agents✓ Authorized Zoho Partner✓ From a live UAE implementation
Fastlane Tax Team10 October 20269 min readUpdated October 2026E-Invoicing
✦

Key Takeaways

4 insights · 9 min read
01

BillToLegalAgency is the authority that issued the customer’s licence (Authority Name, BTAE-11 in PINT-AE).

02

In Zoho Books it is the Buyer ID Authority field, directly beside Buyer ID Value.

03

Mainland Dubai customers are licensed by DET; free zone customers by their free zone authority, not DET.

04

It arrives as a pair with BillToLegalRegNo. Fill both from the same licence copy in one sitting.

Quick Answer

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 guideWhat 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 done

This 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.

Infographic
Same licence number, two different companies
Example ALicence 12345 + DETA Dubai mainland company on DET’s register
Example BLicence 12345 + DMCCA different company on the DMCC free zone register
↓
Step 1Open the licenceNot the address, not the company name
Step 2Read the issuing authorityDET, ADDED, SEDD, a free zone, DIFC or ADGM
Step 3Enter Buyer ID AuthorityZoho: Other Details, next to Buyer ID Value
↓
Common mistakeDET for every Dubai customerFree zone companies get the wrong authority and still pass validation
Do thisAuthority as printed on the licenceSame spelling for every customer of that authority
Illustrative licence numbers. Licence numbers are only unique within the authority that issued them, which is why Zoho needs both fields.

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.

Get Zoho Books e-invoicing right the first time

FTA-registered tax agentsAuthorized Zoho Partner

ASP appointment, customer and item clean-up, test invoices, 30-minute training and go-live sign-off.

AED 499 / organisation + VAT

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 licensedTypical issuing authorityCommon mistake
Dubai mainlandDepartment of Economy and Tourism (DET)Writing DED, the former name
Abu Dhabi mainlandAbu Dhabi Department of Economic Development (ADDED)Entering DET because the invoice address says UAE
Sharjah mainlandSharjah 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 licenceEntering 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 licenceEntering the emirate’s economic department
DIFC or ADGMDIFC Registrar of Companies or ADGM Registration AuthorityEntering 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.

  1. Open the customer — Sales › Customers, then open and edit the customer on the failed invoice.
  2. Go to Other Details — The e-invoicing identity fields are grouped together here.
  3. Enter Buyer ID Authority — The authority’s official name, as printed on the licence.
  4. Confirm the pair — Buyer ID Value should be the licence number from the same licence.
  5. Check the legal name — It should match that same licence.
  6. 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.

DoDon’t
Use the official name as printed on licencesMix abbreviations, full names and old names for the same authority
Keep a reference list of the authorities your customers useLet each team member type their own version
Use DET, not DED, for Dubai mainlandCopy DED from old customer files
Record the free zone, not the emirate, for free zone companiesEnter 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.

Check a licence with us

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.

CheckRed flagLikely fix
Legal name ends in FZE, FZCO, FZ-LLC or LLC-FZAuthority is DET or another mainland departmentReplace with the free zone authority on the licence
Authority entries for the same body spelled differentlySeveral versions of one nameStandardise to your reference spelling
Authority shows an old nameDED instead of DETUpdate to the current name
Buyer ID Value present, authority blankWill fail on the next pushFill from the licence
Authority present, Buyer ID Value blankWill fail as BillToLegalRegNoFill 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.

Every customer mapped to the right authority

Licence numbers, authorities and legal names checked against licences and loaded before go-live.

AED 499 / organisation + VAT

Half your customers are in free zones?

We map every customer to the authority on its licence, load the data and test before go-live. AED 499 + VAT per Zoho organisation.

FAQ

FAQ: BillToLegalAgency AgencyName in Zoho Books

It is the name of the authority that issued the customer's licence. In the UAE PINT-AE standard it is the Authority Name element of the buyer's legal registration, which identifies the authority that issued the commercial or trade licence. In Zoho Books it is the Buyer ID Authority field.
Open the customer, go to the Other Details tab, and you will find Buyer ID Authority next to Buyer ID Value, along with the TIN, legal name and electronic address used for e-invoicing.
No. DET licenses Dubai mainland businesses. A company in a Dubai free zone such as DMCC, JAFZA or DAFZA is licensed by that free zone's authority, so the authority should be the free zone, even though the company is in Dubai.
Enter the registrar of the financial free zone that issued the licence or registration, as printed on the customer's documents, for example the DIFC Registrar of Companies or the ADGM Registration Authority.
Use the authority's official name and the same spelling for every customer licensed by it. Consistent entries are easier to check, filter and correct, and avoid customers with the same authority looking different in your records.
Both fields describe the same thing: the customer's legal registration. When the customer has neither, Zoho reports both on the same push. Fill them together from the customer's licence.
Related Services

E-Invoicing and Compliance Services

📊

Zoho Books E-Invoicing Implementation

ASP appointment, customer and item clean-up, test invoices and 30-minute training. AED 499 + VAT per organisation.

🧭

UAE E-Invoicing Diagnosis

Free assessment of your software and invoicing, with a written route recommendation and total cost.

⚖️

UAE ASP Comparison

How accredited e-invoicing providers compare, and which route fits your accounting software.

🧾

Free UAE E-Invoice Generator

See what a PINT-AE e-invoice has to contain before you push your first live invoice.

📑

Accounting & Bookkeeping

Monthly bookkeeping in Zoho Books from AED 499/month, with e-invoice status monitoring included.

📈

VAT Return Filing

Quarterly VAT returns prepared and filed through EmaraTax from AED 149.

Expert Review

Written From a Live Zoho Books Implementation

FL

Fastlane Tax Team

FTA-Registered Tax Agents • Authorized Zoho Partner

This guide is part of a series based on a Zoho Books e-invoicing implementation Fastlane carried out for a UAE free zone client in September and October 2026, with client details removed. Field definitions are checked against the PINT AE Billing specification (version 1.0.4) published on the Peppol documentation site. Reviewed by Fastlane Management Consultancy’s tax team, led by founder Nithin Pathak. Zoho updates its screens and validation messages, so confirm the current wording in your own organisation.

Created with