Zoho VAL1238 ServiceCodeScheme: SAC vs HSN Fix | 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›VAL1238 Invalid ServiceCodeScheme in Zoho Books
E-Invoicing · Zoho Books Error Series · Part 4

VAL1238 Invalid ServiceCodeScheme: Why Zoho Books Wants SAC

This one is maddening because it appears after you have added the code. The code is there; Zoho is reading it under the wrong scheme. Here is why, and how to classify items so it never comes back.

✓ 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

VAL1238 means a line has a service code that is not tagged as SAC. When a service code is given, the scheme must be SAC.

02

Services carry SAC codes; goods carry HSN (HS-based) codes. Mixing them up is the usual cause.

03

In our case it appeared on the second push, right after the SAC code was added to the item.

04

The fix lives on the item record, so one correction covers every future invoice for that item.

Quick Answer

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

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

Infographic
Goods or service? Pick the code scheme
StartThe invoice line itemWhat does the customer actually receive?
AskA physical thing?Something that changes hands
Yes: goods
Item typeGoodsSet on the Zoho Books item
Code schemeHSN codeHS-based goods classification
No: service
Item typeServiceSet on the Zoho Books item
Code schemeSAC codeService accounting code
↓
Causes VAL1238Service code in the HSN field, or item left as goodsThe code is there but sent under the wrong scheme
Both in one line?Split itOne goods line with HSN, one service line with SAC
Fix it on the item record once, and every future invoice line for that item carries the right scheme.

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.

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

  1. Push 1 — FAILED with the generic message. Support said the service line item had no SAC code.
  2. Fix — A code was added to the item.
  3. Push 2 — FAILED with VAL1238 Invalid ServiceCodeScheme, alongside the two customer errors from Parts 2 and 3.
  4. Fix — The item was set up as a service with its code in the SAC field.
  5. 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.

ItemUsuallyCode typeNote
Consulting, accounting, legal, design feesServiceSAC—
Trading stock, equipment, spare partsGoodsHSN—
Software subscription or SaaS accessServiceSACConfirm treatment if a physical medium is supplied
Installation, maintenance, repair labourServiceSACBill parts on a separate goods line
Equipment supplied and installed for one priceMixedBothSplit into a goods line and a service line
Freight and delivery chargesServiceSACOften invoiced as a separate line already
Rent of equipment or spaceServiceSACCheck 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.

  1. Find the service line — On the failed invoice, note which item is the service.
  2. Open the item — Items, then open and edit that item.
  3. Set the type to Service — If it is set to goods, change it.
  4. Put the code in the SAC field — Move it out of the HSN field if that is where it was entered.
  5. Check the unit and VAT treatment — Use a UN/CEFACT unit code and the correct tax treatment.
  6. 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.

DoDon’t
Pick the code that best describes what the customer receivesUse one generic service code for every service item
Record why you chose each code, for later reviewCopy codes from a supplier’s invoice without checking
Use one code consistently for the same kind of itemGive identical services different codes on different items
Re-check codes when the item description changesLeave 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 unitUN/CEFACT codeMeaning
pcs, nos, eachH87Piece
kgKGMKilogram
hrs, hourHURHour
unit, oneC62One (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.

Review my item list

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.

  1. Export active items — Items you expect to invoice after go-live; skip archived ones.
  2. Add three columns — Goods or service, HSN or SAC code, UN/CEFACT unit code.
  3. Classify and review — Fill the sheet, then review it as a whole for consistency.
  4. Load the changes — Update items through Zoho Books’ import, exporting a sample first so the column names match, or update short lists by hand.
  5. 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.

Every item classified, coded and tested

Goods and services split, HSN and SAC codes assigned, unit codes set, then tested before go-live.

AED 499 / organisation + VAT

A mixed item list of goods and services?

We classify every item, assign codes and unit codes, and test each VAT scenario before go-live. AED 499 + VAT per Zoho organisation.

FAQ

FAQ: VAL1238 Invalid ServiceCodeScheme in Zoho Books

It means an invoice line has a service code but the code is not identified as a SAC code. The full message says the ServiceCodeScheme must be SAC when a ServiceCode is provided. In practice the item is usually classified as goods, or the code is in the HSN field.
HSN codes classify goods and are based on the international Harmonized System. SAC, the service accounting code, classifies services. Each item should carry the code type that matches what it is: goods take HSN, services take SAC.
Because the code is being sent under the wrong scheme. The most common reasons are that the item type is still goods, or that the code was typed into the HSN field. Change the item type to service and put the code in the SAC field.
The item. The classification and code live on the item record, and every invoice line for that item takes them from there. Fix the item once and every future invoice for it carries the right code.
Split it into separate lines, one for the goods with an HSN code and one for the service with a SAC code. A single line cannot be both, and mixed lines are a common source of classification errors.
Unit of measure problems are common next. UAE e-invoices use UN/CEFACT unit codes, such as H87 for a piece or HUR for an hour, so free-text units like pcs or job may need to be replaced.
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