Skip to main content

How to Set Up & Manage e-Invoice Settings

Updated over a month ago

Who is this for?

StoreHub merchants in Malaysia who need to set up their e-invoicing system, manage their company profile, configure general e-invoice settings, and assign product classification codes.

Overview

This comprehensive guide shows you how to set up your e-invoicing system in StoreHub and on the LHDN MyInvois portal. You'll learn how to appoint StoreHub as your intermediary, create and validate your company profile, link your stores, configure essential e-invoice settings, and assign the mandatory product classification codes to your items. This article covers adding, editing, and unlinking your e-invoice settings.


Before You Begin

Compliance Timeline

Be aware of the LHDN e-invoice compliance timeline for your business size.

  • 1 August 2024: For businesses with an annual turnover or revenue of more than RM100 million.

  • 1 January 2025: For businesses with an annual turnover or revenue of more than RM25 million and up to RM100 million.

  • 1 July 2025: For businesses with an annual turnover or revenue of more than RM5 million and up to RM25 million.

  • 1 January 2026: For businesses with an annual turnover or revenue of more than RM1 million and up to RM5 million.

  • 1 January 2027: For businesses with an annual turnover or revenue of up to RM1 million.

LHDN MyInvois Portal Access

Only a company Director has permission to appoint StoreHub as an 'Intermediary' on the MyInvois portal. For sole proprietors, ensure you are registered as 'Business Owner' on MyTax.

StoreHub Account Owner Permissions

In StoreHub, only the main 'Account Owner' (the primary registered email address) can enable the e-invoice feature from the BackOffice. If you are using a different email address, the option to enable e-Invoice will not be available.

Application Version Requirements

Ensure your StoreHub POS app is updated to the new version. Older apps do not support e-invoice functionality, including displaying QR codes on receipts.

Product Information

It's a good idea to check that your product names and prices are accurate and up-to-date in your StoreHub BackOffice.


Video Guide


Step-by-Step Guide

Appoint StoreHub as Your e-Invoice Intermediary on the LHDN MyInvois Portal

This is a critical first step. You must give StoreHub official permission to handle e-invoices for you by adding StoreHub as an intermediary on the LHDN MyInvois portal.

1. Go to the LHDN MyInvois portal website at https://MyInvois.hasil.gov.my/.

2. Log in with your business owner details.

MyInvois login screen with fields for username and password.

3. After logging in, click on 'MyInvois' in the top menu to go to the MyInvois portal dashboard.

MyInvois portal dashboard showing the top menu with the MyInvois option highlighted.

4. Click on 'View Taxpayer Profile'.

MyInvois dashboard with the "View Taxpayer Profile" button highlighted.

Note:

  • Make sure your company name is shown. If not, click 'Switch Taxpayer' to select your company.

5. Under your 'Profile', find the 'Representatives' section and click on 'Add Intermediary'.

Taxpayer Profile page with the "Representatives" section and "Add Intermediary" button highlighted.

6. Fill in the fields with StoreHub's information exactly as below (make sure there are no extra spaces):

  • 'TIN': C23195716050

  • 'BRN': 201301042468

  • 'Name': STOREHUB SDN. BHD.

Add Intermediary form with StoreHub’s Tax Identification Number (TIN), Business Registration Number (BRN), and Name filled in.

7. Enter the captcha code shown on the screen and click the search icon.

8. Set the start and end dates for permission (we recommend setting it for 3 years). Then, tick all the permission boxes (e.g., 'Document - Submit', 'Document - Cancel') and click 'Add Intermediary'.

Intermediary permission settings showing selected start and end dates, and all permission checkboxes ticked before adding.

Notes:

  • StoreHub cannot issue or process e-invoices for you unless we are appointed in the MyInvois portal.

  • If you encounter issues with the intermediary appointment process:

    • Double-check all StoreHub details for accuracy (no extra spaces).

    • Ensure you're logged in as the company Director or authorized representative.

    • If the system shows 'Already appointed' but you still can't enable e-Invoice in StoreHub, try removing and re-adding StoreHub as an intermediary.

Set Up Your e-Invoice Company Profile in StoreHub BackOffice

After appointing StoreHub as your intermediary, you need to configure your StoreHub account.

Enable e-Invoicing

1. Go to the 'e-Invoice' section from the main menu.

2. You will land on the e-invoice information page. Click the 'Set Up Now' button to begin the setup process.

Create or Update Your Company Profile

Your company profile contains essential business details that StoreHub uses to communicate with LHDN.

1. On the e-Invoice page, click 'Create a Company Profile'.

StoreHub e-Invoice page with the "Create a Company Profile" button highlighted.

Notes:

  • If you have previously set up your e-Invoice details under store settings, your company profile(s) will appear here as a list.

  • If you see a red '!' alert next to the 'Company Profiles' tab, it means your profile is missing some information that you need to fill in.

2. Fill in all your company details accurately. This includes your Business Registration Number (BRN), Tax Identification Number (TIN), company name, address, and contact information. These details will be validated with LHDN.

Company Profile form in StoreHub BackOffice with fields for business details like BRN, TIN, and address.

Notes:

The system needs this information to match LHDN's records.

  • For all Businesses:

    • Business Name

    • Business Registration Number (BRN)*

    • Tax Identification Number (TIN)*

    • Address

    • Industry

    • MSIC Code

    • SST ID (If applicable)

  • For Individual Registration (Sole Proprietorship):

    • NRIC field will be added

  • The TIN must begin with:

    • 'C' for Registered Businesses (e.g., C20880050010)

    • 'IG' for Individual Registration (e.g., IG20880050010)

    • 'PT' for Partnership Businesses (e.g., PT20880050010)

**It is important to make sure your BRN and TIN matches exactly with the one in your MyInvois Portal

3. To turn on automatic monthly consolidation of your sales data for LHDN, choose 'Yes' for the setting, 'Do you want StoreHub to automatically consolidate your monthly sales?'. If you prefer to manage this manually or do not issue e-invoices to customers, select 'No'.

Company Profile form showing the dropdown for "Do you want StoreHub to automatically consolidate your monthly sales?".

Notes:

  • This feature is important as it automatically submits all unvalidated transactions to LHDN.

  • It only submits sales from the current month onwards.

  • For example, if you enable this setting today, StoreHub will automatically consolidate all of your sales for this month and submit them on the 3rd of the following month. Sales from the previous months will not be submitted.

4. Click 'Save and Validate'. StoreHub will then attempt to validate your company details with LHDN.

The "Save and Validate" button on the Company Profile form.

Notes:

  • Validation is a check to make sure your TIN matches your BRN (for companies) or NRIC (for individuals).

  • If the details are incorrect, the system will not save and will highlight the section that has an error.

Assign Stores from Your Company Profile

After your company profile is validated, you need to link your physical stores to it. This tells StoreHub which stores are part of this e-invoice setup.

1. In the 'Assign Stores' section, search for your store name and add it to your profile. You can add multiple stores to one profile as long as they share the same BRN/TIN.

The "Assign Stores" section in StoreHub BackOffice, showing a search bar and a list of available stores to link.

2. Once all the desired stores have been selected, click on 'Save' to link them to the company profile.

The "Save" button to confirm linking selected stores to the company profile.

Notes:

  • If the store you're searching for is already assigned to the company, you will not be able to add it.

  • If you don't have access to add or delete stores, you will not be able to do them.

3. Once completed, your 'Company Profile' page will display the company status, indicating if it's 'Validated' and which stores are linked.

Company Profile page displaying a "Validated" status and a list of linked stores.

Note:

  • To start issuing e-Invoice, you have to complete the e-Invoice Settings next.

Unlink Stores from Your Company Profile

If you need to remove a store from your e-invoice company profile:

1. Click on your 'Company Name' in the StoreHub BackOffice 'e-Invoice' section.

StoreHub BackOffice e-Invoice section displaying a list of company profiles, with a company name highlighted.

2. You'll be taken directly to the 'Stores' tab within your company profile.

3. To unlink a store from the company, click the 'trash bin' icon next to its name.

Trash bin icon highlighted next to a linked store in the "Stores" tab, indicating the option to unlink.

Delete an e-Invoice Company Profile

StoreHub does not currently support deleting an entire e-invoice company profile once it has been created and validated. If you no longer wish to issue e-invoices for a company, you can turn off the 'Issuing e-Invoice' toggle and unlink all associated stores. For further assistance, please contact StoreHub Support.


Configure Your Account's General e-Invoice Settings

Within the e-invoice settings tab, you can review and update account-level configurations that apply across all your companies and stores.

1. Go to the 'e-Invoice' section in your BackOffice, then click on the 'e-Invoice Settings' tab.

The "e-Invoice Settings" tab within the e-Invoice section of StoreHub BackOffice.

2. Choose a code from the dropdown list that best fits most of your products. This code will be automatically used for any product that doesn't have its own specific code, ensuring all items are compliant.

e-Invoice settings page with the "Default Product Classification Code" dropdown menu highlighted.

Note:

3. Select which payment methods used in your POS will trigger the e-invoice process. For example, you might want to exclude cash payments if you only issue e-invoices for card transactions.

e-Invoice settings page showing checkboxes to select which payment methods will generate an e-invoice.

Notes:

  • Credit Card and Debit Card payment options are mandatory and cannot be unchecked.

  • You should not include third-party payments like FoodPanda or ShopeeFood, because those platforms will issue their own e-invoices.

  • If you uncheck a payment option, a confirmation pop-up will appear asking you to confirm the exclusion from e-Invoice consolidation.

4. Match the tax codes you use in StoreHub (e.g., 'SST - Service') to the official LHDN e-invoice tax codes from the dropdown menu. This ensures your tax reporting is accurate.

e-Invoice settings page displaying a table for mapping StoreHub tax codes to LHDN e-invoice tax codes.

Notes:

  • The Tax Codes in the left column are pulled from your BackOffice Tax Codes.

  • Clicking the Tax Codes link will take you to that page, where you can add new tax codes if needed.

  • Once done, use the e-Invoice Tax Codes link to return to the e-Invoice Settings page and continue your setup.

5. Click 'Save' to apply your changes.

The "Save" button to confirm changes made in the e-Invoice settings.


Manage Product Classification Codes for e-Invoices

LHDN requires every item you sell to have an official classification code. This helps them understand what kind of products your business sells for tax purposes. Getting this right is important for staying compliant.

Why Product Classification Codes Matter

Every product or service you sell needs a specific code from LHDN. This code categorizes your items for tax purposes. If a product doesn't have a code, LHDN will reject the e-invoice.

Set a Default Classification Code

This is the most important step to ensure you can issue e-invoices smoothly. The default code acts as a fallback and will be automatically used for any product that doesn't have its own specific code.

1. In the 'e-Invoice Settings' tab (as described in the previous section), find the 'e-Invoice Default Product Classification Code' and choose a code from the list that best fits most of your products.

e-Invoice settings page with the "e-Invoice Default Product Classification Code" dropdown highlighted.

2. Click 'Save'.

The "Save" button to confirm the default product classification code.

Note:

For F&B merchants:

  • There is no specific code for food and beverage items. Please use 022 - Others as your default, or choose the most suitable alternative.

Assign a Code to a Single Product

For special items that need a different code than your default, you can set them individually.

1. Go to the 'Products' page in your StoreHub BackOffice.

StoreHub BackOffice main menu showing the "Products" option highlighted.

2. Click on an existing product to edit it, or click 'Add Product' to create a new one.

Products page in StoreHub BackOffice, showing an option to select an existing product or click "Add Product".

3. Go to the 'e-Invoice Product Classification Code' field.

Notes:

  • Parent Products: For products with variants (e.g., Small, Medium, Large), the classification code field for the parent product is not editable and will display N/A for parent products. You must set the codes on each individual variant.

  • You can remove a specific classification code from a product at any time. The system will then use the default code for that product.

4. Select the appropriate code for this specific product from the dropdown list.

Dropdown menu for "e-Invoice Product Classification Code" on the product edit page, showing available codes.

Notes:

  • You can choose the correct 3-digit classification code from the dropdown or leave it blank.

  • If you have assigned a Default Classification Code, the system will automatically apply it to the product when an e-invoice is issued. On the product details page, this will be displayed with the prefix 'Default:'.

5. Click 'Save' to update the product.

Bulk Update Product Classification Codes

These methods are great for updating many products at once.

Option 1: Use 'Group Actions' on the Products Page

1. In the BackOffice, go to the 'Products' page.

StoreHub BackOffice main menu showing the "Products" option highlighted.

2. Select all the products you want to update by ticking the boxes next to their names.

Products page showing multiple product checkboxes ticked for group action.

3. Click the 'Group Action' button at the top, and choose 'Set e-Invoice Product Classification Code'.

The "Group Action" button and its dropdown menu, with "Set e-Invoice Product Classification Code" highlighted.

4. Enter the 3-digit code you want to apply to the selected products and click 'Save'.

Pop-up window for setting the e-Invoice Product Classification Code, showing an input field and "Save" button.

5. You'll be asked to confirm your choice. Click on 'Confirm' to proceed.

Confirmation pop-up asking to confirm applying the classification code to selected products.

Once you click on 'Confirm', the Classification Code will be applied to all of your selected products.

Products page displaying updated classification codes for the previously selected products.

Option 2: Update via Import Products CSV File

This method is great for updating your whole catalog at once.

1. From the 'Products' page, click 'Export to CSV' to download your current product list.

The "Export to CSV" button on the Products page in StoreHub BackOffice.

2. Open the downloaded CSV file in a spreadsheet program (like Excel or Google Sheets) and find the 'Classification Code' column.

a. Enter the appropriate 3-digit code for each product.

b. If you leave this field blank for a product, the system will automatically apply your 'Default Product Classification Code' upon import.

A CSV file opened in a spreadsheet program, with the "Classification Code" column highlighted for editing.

3. Go back to the 'Products' page in StoreHub BackOffice and click 'Import CSV' to upload your updated file.

The "Import CSV" button on the Products page in StoreHub BackOffice.

Notes:

  • For parent products, any value entered in the 'Classification Code' column in the CSV file will be ignored during import.

  • If any codes are invalid, the system will let you know with an error report.

  • Once the error file is downloaded, the CSV file will indicate which products have errors.


Activate e-Invoice to Start Issuing

Once all your settings are configured and validated, you can activate e-invoicing.

1. On the 'e-Invoice Company Profile' page, turn the 'Issuing e-Invoice' toggle 'ON'.

The "Issuing e-Invoice" toggle switch on the e-Invoice Company Profile page, set to ON.

2. A pop-up will appear to confirm. Click 'Yes, proceed'. StoreHub will then issue and immediately cancel a test e-invoice to check that the connection to LHDN is working correctly.

Confirmation pop-up for activating e-invoice, with a "Yes, proceed" button.

What Happens After Activation

  • A test e-Invoice is issued and then automatically cancelled to verify your setup is working.

  • If the test is successful, an alert will appear at the top of the page to let you know.

  • If the test fails, you will also see a notification that explains the reason for the failure.

  • Once active, all transactions will be eligible for e-invoice.

  • If you turn the 'Issuing e-Invoice' toggle 'OFF', a pop-up will appear to remind you that customers will no longer be able to get e-invoices from this company. To confirm, click 'Stop Issuing e-Invoice' in the pop-up.

Pop-up message confirming that stopping e-invoice issuance will prevent customers from receiving e-invoices.


Troubleshooting

Issue

Solution

QR Code Not Appearing on Printed Receipt

This typically occurs when using an older app version, which does not support e-Invoice. To resolve this issue, migrate to the new StoreHub app for e-Invoice compatibility. Contact StoreHub support for migration instructions if needed.

Unable to Enable e-Invoice

If you cannot enable e-Invoice, check:

  • Are you logged in with the primary account owner email? Only this account can enable the feature.

  • Have you completed the intermediary appointment process in the MyInvois portal?

  • Is your company information correctly validated in the system?

Intermediary Appointment Issues on MyInvois Portal

If you face issues appointing StoreHub as an intermediary, ensure all StoreHub details (TIN, BRN, Name) are entered exactly as provided, with no extra spaces. Also, confirm you are logged in as the company Director or authorized representative. If it says 'Already appointed' but you still have issues, try removing and re-adding StoreHub as an intermediary.

e-Invoice Company Profile Validation Failed

If your company profile validation fails, carefully review all the details you entered (BRN, TIN, company name, address) against your official LHDN registration. Even small discrepancies can cause rejection. Correct any errors and click 'Save and Validate' again. If the issue persists, contact LHDN or StoreHub Support.

Product Classification Code Missing or Incorrect

If an e-invoice is rejected due to a missing or incorrect product classification code, first ensure you have set a 'Default Product Classification Code' in your 'e-Invoice Settings'. Then, check the specific product(s) in the transaction to ensure they have an assigned code. You can update individual products or use the bulk update options. Once corrected, the e-invoice may need to be re-submitted or a new one issued.


FAQs

1. What is the e-Invoice compliance requirement for StoreHub merchants?

All businesses in Malaysia will eventually need to issue e-invoices according to LHDN's phased timeline, based on their annual turnover.

2. Can my employees change the e-invoice settings?

No, only the primary 'Account Owner' (the registered email address for your StoreHub account) can enable the e-invoice feature and manage core settings in the BackOffice. Other staff with BackOffice access may view some settings but cannot change critical configurations.

3. How can I start issuing e-Invoices through StoreHub?

First, appoint StoreHub as your intermediary on the LHDN MyInvois portal. Then, in your StoreHub BackOffice, enable e-invoicing, create and validate your company profile, link your stores, configure general settings, and assign product classification codes. Finally, activate e-invoicing.

4. How will StoreHub support the issuance of e-Invoices?

StoreHub integrates directly with the LHDN MyInvois API to automate the submission, validation, and management of e-invoices for your sales, refunds, and cancellations, simplifying your compliance efforts.

5. What is the process for e-Invoice validation?

When an e-invoice is issued (either individually or through monthly consolidation), StoreHub sends the transaction data to LHDN. LHDN validates the information and returns a status (e.g., 'Validated', 'Rejected') and a unique identification number.

6. What is the mandatory information needed from buyers in order to issue an e-Invoice?

For individual buyers, their NRIC (National Registration Identity Card) number is typically required. For businesses, their BRN (Business Registration Number) or TIN (Tax Identification Number) is needed, along with their name and email address.

7. If the buyer forgets his/her TIN number, can he/she just provide the IC number?

Yes, if the buyer is an individual, their NRIC (IC) number can be used. If they are representing a business, the BRN or TIN is mandatory.

8. Can I exclude certain sales from issuing an e-Invoice?

You can configure which payment methods will generate an e-invoice in your 'e-Invoice Settings'. However, LHDN mandates e-invoices for all transactions, so excluding sales should be done with caution and in accordance with LHDN guidelines.

9. Are there any transactions that StoreHub will not issue e-Invoices for?

StoreHub will not issue e-invoices for transactions that do not meet LHDN requirements, such as those with missing product classification codes, invalid company profiles, or if e-invoicing is not activated. Additionally, certain internal transactions or specific payment types might be excluded based on your settings.

10. What happens to my POS orders where there was no e-Invoice issued?

If an e-invoice was not issued for a POS order (e.g., due to setup issues or specific exclusions), that transaction will not be submitted to LHDN via the e-invoice system. You would need to ensure compliance for these transactions through other means as required by LHDN.

11. What should I do if one of the transaction's e-Invoice status is empty, but the others have been ‘Valid’?

An empty status usually means the e-invoice was not processed or submitted. Check your e-invoice settings, company profile validation, and product classification codes for that specific transaction. If all settings are correct, contact StoreHub Support for investigation.

12. When does the seller need to submit consolidated e-Invoices?

If you enable automatic monthly consolidation in your company profile, StoreHub will handle the submission of consolidated e-invoices to LHDN on your behalf at the end of each month for transactions that were not individually requested by customers.

13. Can I change my registered email after enabling E-Invoice?

Yes, you can change your registered email, but it's crucial to ensure the new email is updated as the primary 'Account Owner' in StoreHub BackOffice to maintain full control over e-invoice settings. Contact StoreHub Support for guidance on changing the primary account owner email.


Need Help?

Contact StoreHub Support via live chat in your StoreHub app or email [email protected].


Was this article helpful?

Let us know below or contact support for further assistance.

Did this answer your question?