Skip to main content

How to Set Up & Manage e-Invoice Settings

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. It also shows you how to check that your e-invoices are reaching LHDN, and what to do when you see an error message during setup.


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.

Note:

  • Some merchants call this the 'MyTax' portal. That is the same place. You sign in with your MyTax details, then open 'MyInvois' from the top menu in the next step.

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.

  • If your business has more than one taxpayer profile, appoint StoreHub under the profile whose TIN and BRN you use in StoreHub. Appointing StoreHub under a different profile is one of the reasons activation fails later.

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' is our Tax Identification Number and 'BRN' is our Business Registration Number.

  • 'TIN': C23195716050

  • 'BRN': 201301042468

  • 'Name': STOREHUB SDN. BHD.

Note:

  • Copy these three values, or check them digit by digit before you search. One wrong digit in the BRN is enough for the portal to answer 'No TIN/Taxpayer Found'.

  • The 'Name' must read exactly 'STOREHUB SDN. BHD.', including the full stops. If the portal says 'Enter Valid Name', this field is the one to correct.

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.

  • The appointment is time-limited. When the end date passes, StoreHub can no longer issue e-invoices for you and issuance stops. Note the end date you set (we recommend setting it for 3 years), and check it first if e-invoices stop going through later.

  • 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)

  • Use your 12-digit BRN (the new SSM format, for example 201902123456). If your registration number looks like the older format, for example 123456-X, use the new 12-digit version instead. You can check which number LHDN and SSM hold for your business at the LHDN TIN search and SSM e-Search.

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

  • 'Save and Validate' is also how you re-test your setup at any time. It runs a fresh check with LHDN, so use it after you fix anything at the MyInvois portal.

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.

Note:

  • If the test fails with the message 'Test issuance failed. Please ensure that StoreHub has been added as an intermediary in your company MyInvois profile.', go to the Troubleshooting section below. It lists the causes to check in order, starting with an appointment that was never completed and a detail that does not match between StoreHub and MyInvois.

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

Note:

  • Only sales made after you switch this toggle on are covered. Sales made before that stay blank in your transaction reports.

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


Check Your e-Invoice Status: Are Your Sales Reaching LHDN?

After you activate e-invoicing, you can check for yourself whether your sales are being submitted to LHDN. You do not need to contact support to find out.

LHDN is also called IRBM (the Inland Revenue Board of Malaysia). You will see both names in the portal and in these statuses. They are the same body.

1. In your BackOffice, go to 'Online Orders' or to 'Offline Transactions'.

2. Look at the 'e-Invoice Status' column. It is available in both views.

The column shows one of four values:

Status

What it means

Valid

Submitted to IRBM and validated. This sale has reached LHDN.

Empty (blank)

Not submitted to IRBM yet.

Invalid

Rejected by IRBM because some details were incorrect.

Cancelled

A valid e-invoice that was cancelled within 72 hours of submission.

Why Some Transactions Are Blank

A blank status is normal for sales made before e-invoicing was switched on. Check these in order:

1. Check the date the 'Issuing e-Invoice' toggle was turned on for the company profile that store belongs to. Only sales made after that moment are submitted, and sales made before it stay blank. If you have more than one company profile and you switched them on at different times, that is why one store shows 'Valid' while another is blank.

2. Check that the store is linked to a validated company profile in the 'Stores' tab of that profile.

3. Check that the payment method used for that sale is one you selected in your 'e-Invoice Settings'.

4. Check that your products have a classification code, or that a default code is set in your 'e-Invoice Settings'.

Note:

  • Automatic monthly consolidation covers the month you switch e-invoicing on, and it is submitted on the 3rd of the following month.

  • Months before that are not submitted by StoreHub. To report them, export the sales from 'Online Orders' or 'Offline Transactions' and submit them yourself at the MyInvois portal.

When a Transaction Shows 'Invalid'

'Invalid' means IRBM rejected the details on that e-invoice. The common reasons are:

  • The buyer's details are wrong. For a customer sale, the NRIC, TIN or BRN, name and address come from your customer, so ask the customer to confirm them and request the e-invoice again.

  • Your company profile is not validated, or its details do not match LHDN's records. Open your company profile in the 'e-Invoice' section, correct the details, and click 'Save and Validate'.

  • A product on the sale has no classification code and no default code is set.

Note:

  • An 'Invalid' transaction is not lost. If automatic monthly consolidation is on, it is included in the consolidated e-invoice submitted to IRBM on the 3rd of the next month.

  • Invoices for your own StoreHub subscription and expenses are a separate page and use a different set of statuses, including 'Failed'. For those, see How to Get StoreHub e-Invoices for Expenses, where you can hover the '!' icon to read the exact reason and then click 'Retry'.

For the full status list, consolidation timing, and how to read your Consolidation History, see How To Understand e-Invoice Status & Consolidation. To issue an e-invoice for a single sale at your customer's request, see How to Manage e-Invoice Transactions.


Troubleshooting

Issue

Solution

'Test issuance failed. Please ensure that StoreHub has been added as an intermediary in your company MyInvois profile.'

You see this when you switch the 'Issuing e-Invoice' toggle on.

Check in this order:

1. At the MyInvois portal, open 'View Taxpayer Profile', then 'Representatives'. If StoreHub is not listed there, the appointment was not completed, so follow the appointment steps above. If StoreHub is listed, check the details read exactly 'TIN': C23195716050, 'BRN': 201301042468, 'Name': STOREHUB SDN. BHD., with no extra spaces.

2. Compare your own TIN and BRN in your MyInvois Taxpayer Profile with the ones in your StoreHub company profile. They must match exactly, character for character.

3. Use your 12-digit BRN. An older-format number may no longer be found by LHDN. You can check your business at SSM e-Search and your TIN at the LHDN TIN search.

4. If your business has more than one taxpayer profile, click 'Switch Taxpayer' and confirm StoreHub is appointed under the profile whose TIN and BRN you use in StoreHub.

5. Check the appointment's end date has not passed, and that every permission box is ticked.

6. If all of the above are correct, remove StoreHub as an intermediary and add it again.

7. Go back to your StoreHub company profile and click 'Save and Validate'. This runs a fresh test with LHDN, so you can see straight away whether it is fixed.

Two other versions of this message point at the same checks:

  • 'Test issuance failed. Please follow the BRN format shown in your MyInvois Taxpayer Profile.' means your BRN does not match the one in your Taxpayer Profile

  • 'Test issuance failed. Could not validate TIN against BRN / NRIC / Passport. Please ensure the correct TIN and BRN / NRIC / Passport are used.' means the TIN and BRN pair does not match LHDN's records.

'Authorisation error - Intermediary permissions not enabled'

Shown in the 'e-Invoice' section of your BackOffice. It is also written as 'authorization error'. It can appear in the same setup session as the 'Test issuance failed' message above.

This means LHDN is not accepting StoreHub's permission to act for you, even if the boxes look ticked on your screen. Check in this order:

1. At the MyInvois portal, open 'View Taxpayer Profile', then 'Representatives', then open the StoreHub entry. Confirm every permission box is ticked and saved, not only ticked on screen.

2. Check the appointment's end date has not passed. The appointment is time-limited, and once it expires StoreHub can no longer issue e-invoices for you.

3. If your business has more than one taxpayer profile, click 'Switch Taxpayer' and confirm the permissions are on the profile whose TIN and BRN you use in StoreHub.

4. Confirm you are logged in as the company Director or an authorized representative, or as 'Business Owner' on MyTax if you are a sole proprietor.

5. Confirm StoreHub's TIN, BRN and Name are exactly as listed in the appointment steps above.

6. If everything is correct, remove StoreHub as an intermediary and add it again with all permissions ticked.

7. Go back to your StoreHub company profile and click 'Save and Validate' to re-test.

If it still fails after all of these, contact StoreHub Support via Live Chat with a screenshot of your 'Representatives' page. The permission itself is granted on LHDN's side, so a few of these cases have to be settled with LHDN directly. We will check your screenshot and tell you if yours is one of them.

'No TIN/Taxpayer Found' or 'No Taxpayer Found'

Usually shown at the MyInvois portal when you search for StoreHub before appointing us. It can also appear in StoreHub when you click 'Save and Validate'.

At the MyInvois portal, when searching for StoreHub:

1. Check StoreHub's BRN digit by digit. It is 201301042468, twelve digits. A single wrong or missing digit produces this message.

2. Check the 'TIN' reads C23195716050 and the 'Name' reads STOREHUB SDN. BHD., with no extra spaces before or after.

3. Check your own company name is shown at the top of the profile. If it is not, click 'Switch Taxpayer' and select your company.

4. Confirm you are logged in as the company Director or an authorized representative, or as 'Business Owner' on MyTax if you are a sole proprietor.

If the portal shows 'TIN already added as an Intermediary' together with 'Enter Valid Name', the first message is not blocking you. Correct the 'Name' field to read exactly 'STOREHUB SDN. BHD.' and search again.

In StoreHub, when clicking 'Save and Validate':

1. Your own TIN and BRN must match your MyInvois Taxpayer Profile exactly.

2. Check your TIN prefix: 'C' for a registered business, 'IG' for an individual, 'PT' for a partnership.

3. Use the 12-digit BRN. Verify your TIN at the LHDN TIN search and your BRN at SSM e-Search.

'Incorrect Buyer Info. Please carefully verify company details before retrying.'

Shown when an e-invoice request for a single sale fails. The full message can also include a line that starts 'IRBM Error: Step04-Invalid Code Field Validator', for example 'State Code 17 should be used for Consolidated e-Invoice and non-Malaysian address only - Buyer'.

This is about the buyer details on that one e-invoice, not about your whole setup. Your other sales keep going through.

1. If the buyer is your customer, ask them to confirm their NRIC, TIN or BRN, name and address, then request the e-invoice again.

2. If the e-invoice is for your own StoreHub subscription or another StoreHub charge, then your own company is the buyer. Open your company profile in the 'e-Invoice' section, check the details against your MyInvois Taxpayer Profile, and click 'Save and Validate'. See How to Get StoreHub e-Invoices for Expenses, where you can hover the '!' icon to read the exact reason and then click 'Retry'.

3. If the request still fails, contact StoreHub Support via Live Chat and paste the whole message, including the part that starts 'IRBM Error'. We need that full text to tell which field LHDN is rejecting.

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 connects directly to the LHDN MyInvois system 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’?

Check the date e-invoicing was switched on first. Only sales made after the 'Issuing e-Invoice' toggle was turned on for the company profile that store belongs to are submitted, so earlier sales stay blank. If the sale came after that date, check that the store is linked to a validated company profile, that the payment method is included in your 'e-Invoice Settings', and that the products have a classification code. If all of that is correct, contact StoreHub Support via Live Chat.

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.

14. How do I know my e-invoices are actually being sent to LHDN?

In your BackOffice, go to 'Online Orders' or 'Offline Transactions' and look at the 'e-Invoice Status' column. 'Valid' means that sale reached LHDN and was accepted. Blank means it has not been submitted yet.

15. Why does only one of my stores show 'Valid' while the others are blank?

The 'Issuing e-Invoice' toggle sits on each company profile, not on each store. If you have more than one company profile and you switched them on at different times, the stores under the profile you switched on later will show blank for their earlier sales. Months before that are not submitted automatically. Submit them yourself at the MyInvois portal using the sales you export from 'Online Orders' or 'Offline Transactions'.

16. I have ticked all the permission boxes at the MyTax portal, so why do I still see an authorization error?

Ticking the boxes is only one of the checks. Confirm the appointment sits on the correct taxpayer profile, that its end date has not passed, and that your TIN and BRN in StoreHub match your MyInvois Taxpayer Profile exactly. The Troubleshooting section above lists the checks in order.

17. Does the intermediary appointment expire?

Yes. The appointment you give StoreHub at the MyInvois portal has a start and an end date, which is why we recommend setting it for 3 years. When the end date passes, StoreHub can no longer issue e-invoices for you, so check it first if issuance stops working.


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?