LHDN needs to know who the buyer is and what each line is. When you connect Zoho, envoice adds LHDN fields to your Zoho contacts and items. Fill them once and every invoice you submit from Zoho picks them up.
Watch where the fields are, or follow the steps below.
1. Buyer details on a contact
In Zoho Books, go to Sales > Customers, open the customer and click Edit. Open the Custom Fields tab.
Open full-size screenshot (new tab)| Field | What to enter |
|---|---|
| TIN | The buyer's tax identification number from LHDN, for example C24681357902 for a company. |
| ID Type | BRN for a business (SSM number), NRIC for a Malaysian individual, PASSPORT or ARMY where that applies. |
| ID Value | The number for that ID type, for example the 12-digit SSM registration number. |
| SST Registration | The buyer's SST registration number, if they have one. Leave it empty otherwise. |
Click Save.
LHDN checks that the TIN and the ID belong to the same taxpayer. A TIN that does not match the BRN is rejected. See Rejected: buyer TIN or BRN does not match.
2. Walk-in buyers: General Public TIN
For a customer who does not give you their details (a walk-in or cash buyer), use LHDN's General Public TIN:
- TIN:
EI00000000010 - ID Type: BRN
- ID Value:
NA
If you leave the TIN empty, envoice submits the buyer as general public for you and the widget's pre-submit check says so. See What do I do about walk-in customers?.
3. Find the TIN, BRN and address with one search
Open the customer (not the edit form) and open the envoice e-invoice panel in the right sidebar. The search box already holds the customer's name. Correct it if needed and click Search.
Open full-size screenshot (new tab)- The contact has an ID Type and ID Value: envoice asks LHDN for the TIN that belongs to that ID.
- It has no ID yet: envoice looks the company up by name. If several companies match, pick yours from the list.
- Address: envoice finds the address from the same name. If it is not the right one, click Change to pick another.
Open full-size screenshot (new tab)Nothing is written to Zoho yet. Review what was found:
- Untick anything you do not want.
- Replaces: shows the value it would overwrite. An address that would replace the one on the contact starts unticked, so you replace it only on purpose.
- Tick Billing, Shipping or both for the address.
- A value the contact already has shows Already on contact.
Open full-size screenshot (new tab)Click Save. The panel shows Saved to contact with what it wrote. Reload the contact to see the new values.
Open full-size screenshot (new tab)If nothing is found, check the name or the ID Type and ID Value against the customer's SSM certificate or MyKad. If there is still no match, ask the customer for their TIN, or use the General Public TIN and file it as a consolidated sale. A company TIN found by name alone shows Needs BRN: add the 12-digit BRN as the ID Value, then search again.
The same search is on your vendors, for the supplier's details on self-billed invoices (see Self-billed invoices from Zoho).
The search text is sent to LHDN, to the company register and to Google, only to find these details. See the privacy policy.
4. Classification and tax on an item
Go to Items, open the item and click Edit. Scroll down to Additional Information.
Open full-size screenshot (new tab)| Field | What to enter |
|---|---|
| LHDN Classification | The LHDN classification code for what you sell. 022 - Others fits most general goods and services. |
| LHDN Tax Type | The tax on this item, for example 01 - Sales Tax, 02 - Service Tax, 06 - Not Applicable or E - Tax exemption. |
| LHDN Tax Exemption Reason | Required when the tax type is E: why the item is exempt. |
| LHDN Tariff Code | Optional. The customs tariff code, for imported or exported goods. |
| LHDN Country of Origin | Optional. Where imported goods were made. |
Click Save. envoice reads these from the item for every invoice line, even when Zoho does not copy them onto the invoice. An item with no classification is submitted as 022.
Set the item's own Zoho Tax (for example Service Tax 8%) as usual. That decides the SST amount on the invoice; the LHDN Tax Type tells MyInvois which kind of tax it is.
5. How envoice picks the tax type when the item has none
A line whose item has no LHDN Tax Type (and every line on an expense or a retainer invoice, which have no item field) gets its tax type from the line's Zoho tax: its name first, then its rate.
| Zoho tax on the line | LHDN tax type filed |
|---|---|
| No tax, or any tax at 0% | 06 Not Applicable |
| Name has "Low Value" (for example Sales Tax on Low Value Goods) | 05 Sales Tax on Low Value Goods |
| Name has "High-Value" or "High Value" | 04 High-Value Goods Tax |
| Name has "Sales" (for example Sales Tax 10%) | 01 Sales Tax |
| Name has "Tourism" | 03 Tourism Tax |
| Name has "Service" (for example Service Tax 8%) | 02 Service Tax |
| Any other name at 5% or 10% (for example SST 10%) | 01 Sales Tax |
| Any other name at another rate (for example SST 6% or SST 8%) | 02 Service Tax |
| Name has "Withholding" | Not filed. Withholding tax is not SST: remove it from the line, then submit. The pre-submit check says so first. |
To file E (tax exemption), set LHDN Tax Type to E and the LHDN Tax Exemption Reason on the item. A Zoho tax named "Tax exemption" at 0% files as 06, because LHDN needs the exemption reason with E.
When the buyer has no TIN (general public), LHDN requires classification 004 on every line, so envoice files 004 whatever the item says.
Related