Zoho BillToLegalRegNo Error: Add Licence Number | 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›VAL0001 BillToLegalRegNo Error in Zoho Books
E-Invoicing · Zoho Books Error Series · Part 2

VAL0001 BillToLegalRegNo Must Not Be Empty: The Zoho Books Fix

Your customer has a TRN, so why does Zoho Books say their registration is missing? Because UAE e-invoices identify the buyer twice: once for VAT and once as a legal entity. This is the field that holds the second one.

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

Key Takeaways

4 insights · 10 min read
01

BillToLegalRegNo is the buyer’s legal registration identifier (IBT-047 in PINT-AE), not their TRN.

02

In Zoho Books it is the Buyer ID Value in the customer’s Other Details tab.

03

PINT-AE allows 4 identifier types: commercial or trade licence, Emirates ID, passport and cabinet decision.

04

Fixing it usually reveals the partner field next: BillToLegalAgency, the authority that issued the licence.

Quick Answer

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

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

Infographic
Your customer has four IDs. BillToLegalRegNo is the fourth.
1 · TRNTax Registration Number15 digits, issued by the FTA. Identifies the customer for VAT.
2 · TINFirst 10 digits of TRNUsed to route e-invoices.
3 · Peppol ID0235:TINThe customer’s inbox on the network.
4 · MissingLicence numberBillToLegalRegNo. Identifies the legal entity. Zoho: Other Details › Buyer ID Value.
↓
GetLicence copyFrom the customer
EnterBuyer ID ValueNumber exactly as printed
Pair itBuyer ID AuthorityWho issued it (Part 3)
ResultError clearedPush the invoice again
Most UAE ledgers already hold IDs 1 to 3. The fourth is new with e-invoicing, which is why this error is so common.

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.

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

IdentifierIdentifiesIssued byWhere it sits in Zoho Books
TRN (15 digits)The customer as a VAT registrantFederal Tax AuthorityCustomer tax details
TIN (first 10 digits of TRN)The customer for e-invoicing and routingDerived from the TRNCustomer TIN field
Peppol ID (0235:TIN)The customer’s inbox on the networkRegistered by the customer’s ASPCustomer electronic address
Legal registration numberThe customer as a legal entityDET, a free zone authority, ICP or other registrarCustomer › 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 typeIdentifier typeWhat to enterExtra detail needed
Mainland company or establishmentCommercial / trade licenceLicence number as printedIssuing authority, e.g. DET for Dubai
Free zone company (FZE, FZCO, FZ-LLC)Commercial / trade licenceFree zone licence numberThe free zone authority
Individual with Emirates IDEmirates ID15-digit Emirates ID number—
Individual without Emirates IDPassportPassport numberPassport issuing country
Entity created by cabinet decisionCabinet decisionDecision referenceConfirm 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.

  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 here.
  3. Enter the Buyer ID Value — The licence number exactly as printed. No “Licence No.” prefix, no spaces added or removed.
  4. Fill Buyer ID Authority at the same time — Otherwise the next push fails on BillToLegalAgency. See Part 3.
  5. Check the legal name — It should match the licence, not the trading name you use in conversation.
  6. 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.

SituationWhich registration to useWhy
Customer is a member of a VAT groupThe licence of the member you actually invoiceThe 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 licenceThe licence of the entity named on your contract and invoiceDifferent licences mean different legal entities or branches
Customer is a branch with its own licenceThe branch licenceThe branch is registered separately with its authority
Customer changed free zone or re-licensedThe new licenceOld 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.

  1. List active B2B customers — Customers you expect to invoice after your go-live date. Ignore dormant records.
  2. Request licence copies — One document gives you the licence number, issuing authority and legal name.
  3. Build a working sheet — Customer name, legal name, licence number, authority, TRN, TIN and Peppol ID, with a source column.
  4. 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.
  5. 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.

Get a clean-up quote

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.

Every customer e-invoice ready, not just one

Buyer IDs, authorities, legal names and Peppol IDs checked and loaded, then tested.

AED 499 / organisation + VAT

Hundreds of customers without licence numbers?

We collect, check and load buyer IDs and authorities across your whole customer list, then test before go-live. AED 499 + VAT per Zoho organisation.

FAQ

FAQ: VAL0001 BillToLegalRegNo in Zoho Books

BillToLegalRegNo is the buyer's legal registration number. It corresponds to the buyer legal registration identifier in the UAE PINT-AE standard, an identifier issued by an official registrar that identifies the buyer as a legal entity or person. For most UAE companies it is the trade licence number.
Open the customer, go to the Other Details tab and enter it in the Buyer ID Value field. The authority that issued it goes in the Buyer ID Authority field next to it.
No. The TRN identifies the customer for VAT and is held separately. BillToLegalRegNo identifies the legal entity, so it should be the licence number or other registration identifier, not the TRN.
PINT-AE allows an Emirates ID or a passport as the identifier type for individuals. For a passport, the issuing country is also recorded. B2B e-invoicing mostly involves licensed businesses, so this is uncommon.
Yes, for every customer you invoice through e-invoicing. The field lives on the customer record, so each customer only needs it once, and every later invoice to that customer will carry it.
Validation runs in layers. Once the registration number is present, Zoho checks the related fields, most often the issuing authority, which produces the BillToLegalAgency AgencyName error. Fill both fields together to avoid a second failure.
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