LHDN Client ID and company e-Invoice profile
Purpose
- Connect this company to MyInvois and store the issuer details LHDN requires on every e-Invoice you send.
- Company e-Invoice profile: TIN, SST, MSIC, default classification, address, and phone. Same fields as the Company E Invoice tab. See Company.
- LHDN Client ID: Client ID and secrets so KinraSoft can submit, refresh status, cancel, Search TIN, and Validate TIN.
- Without the profile, MyInvois rejects the document. Without the Client ID, KinraSoft cannot talk to MyInvois at all.
Menu path
- Company TIN, MSIC, and address: Accountant Tools → Company Management → select company → Edit → E Invoice and Corresponding Address tabs. First company: Company Setup opens for you.
- Client ID and secrets: E Invoice → LHDN Client ID Setup.
- You need Company Management to edit the company. If you cannot see LHDN Client ID Setup, ask the owner for the e-Invoice role. See Role.
Assistant
- Edit company e-Invoice (or Edit company e invoice). Select the company, then update TIN, SST, tourism tax, MSIC, default classification, and address. Save.
- Create company can ask “Do you want to setup company e-Invoice data now?” after the first save.
- There is no live wizard that pastes Client ID and Client Secret. Use the LHDN Client ID Setup screen.
- Do not type “how to edit company e-invoice” if you want the wizard.
- If you try Submit e-Invoice before Client ID is saved, chat says to use Edit company e-Invoice. That wizard stores the profile, not the Client ID. Still open LHDN Client ID Setup to paste the ID and secrets.
Before you start
- The company already exists. You are switched into that company for Client ID Setup. See Company and Sign in and switch company.
- From the MyInvois Portal, you have this taxpayer’s Client ID, Client Secret, and the secret expiry date (integration credentials for KinraSoft as the intermediary).
- For the profile: TIN, SSM Register No., MSIC, address line 1, country, state, city, and Phone 1 (example +60197788999).
Company e-Invoice profile — screen
- Accountant Tools → Company Management → select the company → Edit (or double-click).
- On Company Details, fill Register No. if it is empty.
- Open Corresponding Address: Address line 1, Country, State, City, Phone 1.
- Open E Invoice: Tax Identification Number (TIN); SST Registration Number if SST-registered; Tourism Tax Registration Number if applicable; MSIC from the typeahead list; Default Classification — used on document lines when the stock item has no classification. See Categories and products.
- Click Validate TIN if you want to check the TIN against LHDN. This needs Client ID. Do it after the next section, or come back.
- Click Save.
Company e-Invoice profile — Assistant
- AI Agents → Setup → Edit company e-Invoice.
- Select the company → Submit.
- Complete TIN, SST, tourism tax, MSIC, classification, and the address fields marked for e-Invoice.
- Save. Or Cancel — nothing is stored.
LHDN Client ID — screen only
- Switch Company to the company that will submit.
- E Invoice → LHDN Client ID Setup.
- Paste Client ID.
- Paste Client Secret 1. Optional Client Secret 2 if MyInvois gave you a second secret for rotation.
- Set Client Secret Expires At.
- Click Save (disk icon). Wait for Document Saved.
- Treat Client ID and secrets like a password. Do not email them or put them in a shared chat. When the secret expires, paste the new secret and expiry, then Save.
What each piece is for
- TIN, Register No., MSIC, SST, tourism tax, default classification. Company E Invoice tab or Edit company e-Invoice. Issuer block on every e-Invoice you send.
- Address line 1, country, state, city, Phone 1. Corresponding Address. Issuer address. Mandatory once a TIN is entered.
- Client ID, Client Secret 1 and 2, expiry. LHDN Client ID Setup. Login to MyInvois APIs: submit, status, cancel, Search TIN, Validate TIN.
- If you enter a TIN, KinraSoft treats the company as e-Invoice-ready. Save fails until Register No., address line 1, country, state, city, MSIC, and a valid Phone 1 are also filled.
- You may save the company without a TIN and add the profile later. You cannot submit until both the profile and the Client ID are in place.
- Client ID is per company. After Create company in chat, Switch Company before you open Client ID Setup.
Screen vs Assistant
- TIN, MSIC, SST, address, Phone 1. Screen: E Invoice and Corresponding Address. Assistant: Edit company e-Invoice.
- Validate TIN button. Screen only, after Client ID exists.
- Client ID, secrets, and expiry. LHDN Client ID Setup only.
- Logo and letterhead. Company Setup only. See Company.
If something goes wrong
- Invalid Client ID or Client Secret on Validate TIN or Search TIN. Re-copy ID and secret from MyInvois. Check expiry. Confirm you are in the right company.
- Chat cannot submit — Client ID not set up. LHDN Client ID Setup → Save. Then try Submit e-Invoice again. See Submit and check status.
- TIN save lists empty e-Invoice fields. Fill Register No., address line 1, country, state, city, MSIC, and Phone 1.
- Phone not accepted. International format, no spaces — example +60197788999.
- After Assistant create, Client ID screen is empty. Switch Company to the new company, then paste the credentials.
- Secret expired. Generate a new secret on MyInvois, paste it and the new expiry, Save.