Key Takeaways
4 insights · 10 min readVAL1238 means a line has a service code that is not tagged as SAC. When a service code is given, the scheme must be SAC.
Services carry SAC codes; goods carry HSN (HS-based) codes. Mixing them up is the usual cause.
In our case it appeared on the second push, right after the SAC code was added to the item.
The fix lives on the item record, so one correction covers every future invoice for that item.
VAL1238 Invalid ServiceCodeScheme means an invoice line carries a service code that Zoho Books is not sending under the SAC scheme. Open the item, confirm its type is Service and that the code sits in the SAC field rather than the HSN field, save it and push the invoice again. Goods use HSN codes; services use SAC codes.
In this guide
What the error meansWhy it appears after adding SACGoods or services?Where to fix it in ZohoChoosing the right codeMixed linesWhat comes nextFixing the whole item listGet helpVAL1238 is the error that makes people think they have done something wrong twice. On our client’s implementation, Zoho support said the first failure was caused by a missing SAC code on the service item. The code was added, the invoice was pushed again, and this appeared: Invalid ServiceCodeScheme, ServiceCodeScheme must be SAC when ServiceCode is provided. This is Part 4 of our Zoho Books e-invoice error series. It explains what the scheme is, why a correct-looking code can still fail, how to decide whether an item is goods or a service, and how to fix your whole item list at once. Item classification is part of every Zoho Books e-invoicing implementation we run.
What does VAL1238 Invalid ServiceCodeScheme mean?
It means an invoice line carries a service code, but the code is not identified as a SAC code. The rule behind it is stated in the message itself: when a ServiceCode is provided, the ServiceCodeScheme must be SAC.
Every classification code travels with a label saying what kind of code it is: an HSN code for goods, a SAC code for services. The UAE e-invoicing data dictionary has a separate service accounting code field for services, alongside the item classification used for goods. VAL1238 fires when those two things disagree: a code is present on a line being treated as a service, but it has not been labelled as SAC.
Unlike the customer errors in Parts 2 and 3, this one is not about missing data. The data is there. It is in the wrong place, or the item is the wrong type.
Why does VAL1238 appear right after you add a SAC code?
Because adding the code fixes the first problem, a missing code, and exposes the second, the scheme. On our client’s invoice the sequence was exactly this:
- Push 1 — FAILED with the generic message. Support said the service line item had no SAC code.
- Fix — A code was added to the item.
- Push 2 — FAILED with VAL1238 Invalid ServiceCodeScheme, alongside the two customer errors from Parts 2 and 3.
- Fix — The item was set up as a service with its code in the SAC field.
- Push 3 — The invoice moved to Push Initiated.
The lesson is to check three things together whenever you touch an item: the item type, which field the code is in, and whether the code is a real code of that type. Fixing only one of them invites the next error.
How do you decide whether an item is goods or a service?
Ask what the customer actually receives. If it is a physical thing that changes hands, it is goods. If it is work, access or advice, it is a service. Most items are obvious; the table covers the ones that are not.
| Item | Usually | Code type | Note |
|---|---|---|---|
| Consulting, accounting, legal, design fees | Service | SAC | — |
| Trading stock, equipment, spare parts | Goods | HSN | — |
| Software subscription or SaaS access | Service | SAC | Confirm treatment if a physical medium is supplied |
| Installation, maintenance, repair labour | Service | SAC | Bill parts on a separate goods line |
| Equipment supplied and installed for one price | Mixed | Both | Split into a goods line and a service line |
| Freight and delivery charges | Service | SAC | Often invoiced as a separate line already |
| Rent of equipment or space | Service | SAC | Check VAT treatment separately for property |
Expert Tip
Classification for e-invoicing and VAT treatment are separate decisions. An item can be a service and zero-rated, or goods and exempt. Set both on the item, and do not let one decide the other.
Where do you fix it in Zoho Books?
On the item record, not the invoice.
- Find the service line — On the failed invoice, note which item is the service.
- Open the item — Items, then open and edit that item.
- Set the type to Service — If it is set to goods, change it.
- Put the code in the SAC field — Move it out of the HSN field if that is where it was entered.
- Check the unit and VAT treatment — Use a UN/CEFACT unit code and the correct tax treatment.
- Save and push again — Every future invoice line for this item now carries the corrected classification.
⚠️ Items used in recurring invoices
If the item appears on recurring invoice profiles or saved templates, push one new invoice after the fix to confirm the change has flowed through before the next scheduled run.
How do you choose the right SAC or HSN code?
Use a code from the official classification list that Zoho Books offers for UAE organisations, and pick the most specific code that genuinely describes the item. Do not invent codes or reuse one code for everything.
| Do | Don’t |
|---|---|
| Pick the code that best describes what the customer receives | Use one generic service code for every service item |
| Record why you chose each code, for later review | Copy codes from a supplier’s invoice without checking |
| Use one code consistently for the same kind of item | Give identical services different codes on different items |
| Re-check codes when the item description changes | Leave old codes on items that now describe something else |
Code choice is where a tax adviser earns their fee. A plausible-looking code passes validation, but the wrong code misdescribes your supply in data the FTA receives in near real time. For a short item list, a careful afternoon is enough. For hundreds of items, classify in a spreadsheet first and review the list as a whole.
What if one invoice line mixes goods and a service?
Split it. A single line cannot be both goods and a service, so a supply-and-install line, or a product price that quietly includes delivery, will keep causing classification problems until it is separated.
✗ One combined line
“Supply and install of equipment” at one price. The item type is a guess, the code fits only half the supply, and the VAT treatment may differ between the parts.
✓ Separate lines
“Equipment” as goods with an HSN code, and “Installation” as a service with a SAC code. Each line is classified correctly and validates on its own.
Separate lines also make credit notes cleaner. If the customer disputes only the installation, you can credit that line without touching the goods.
What error usually comes after VAL1238?
Often the unit of measure. UAE e-invoices use UN/CEFACT unit codes rather than free text, so units such as pcs, nos or job may need replacing.
| Common free-text unit | UN/CEFACT code | Meaning |
|---|---|---|
| pcs, nos, each | H87 | Piece |
| kg | KGM | Kilogram |
| hrs, hour | HUR | Hour |
| unit, one | C62 | One (unit) |
Set the unit on the item while you are fixing the classification. It is the same record and the same five minutes, and it avoids a fourth push.
Item list full of free-text units and missing codes?
Send us an item export on WhatsApp. We’ll tell you how many items need work and what it costs to fix.
How do you fix every item before go-live?
Classify the active items in one pass, then test. Items fail one invoice at a time, so leaving them to surface naturally means failures for months.
- Export active items — Items you expect to invoice after go-live; skip archived ones.
- Add three columns — Goods or service, HSN or SAC code, UN/CEFACT unit code.
- Classify and review — Fill the sheet, then review it as a whole for consistency.
- Load the changes — Update items through Zoho Books’ import, exporting a sample first so the column names match, or update short lists by hand.
- Test one invoice per item type — At least one goods line and one service line before go-live.
Item-level mistakes we see most
• Services set up as goods — Items created years ago for VAT only, with the default type left in place.
• SAC code in the HSN field — The exact cause of VAL1238 in many cases.
• One code for everything — Passes validation, but misdescribes the supply.
• Free-text units — pcs, nos and job instead of UN/CEFACT codes.
Should you fix this yourself or get help?
Fix it yourself if you have a short list of clearly defined services. Get help if your item list is long, mixes goods and services, or carries years of old classifications. Our Zoho Books e-invoicing implementation covers item classification and unit codes, customer identity clean-up, ASP appointment, scenario tests with recorded UUIDs and a 30-minute staff training session for AED 499 + VAT per organisation. Very large item lists are quoted separately in writing first.
That completes the four errors from our client’s case. Go back to the series overview for the full checklist, or start with a free diagnosis on our UAE e-invoicing page.