Malaysia
Configuration
Modules installation
Install the following modules to get all the features of the Malaysian localization:
Name | Technical name | Description |
|---|---|---|
Malaysia - Accounting |
| This module includes the default fiscal localization package. |
Malaysia - Accounting Reports |
| This module includes the accounting reports for Malaysia. |
Malaysia - UBL PINT |
| This module includes the features required to export invoices in PINT format. |
Malaysia - E-invoicing |
| This module includes the features required for integration with MyInvois under IRBM. |
Malaysia - E-invoicing Extended Features |
| This module improves the MyInvois E-invoicing feature by adding proper support for self billing, rendering the MyInvois QR code in the invoice PDF file and allows better management of foreign customer TIN. |
Company information
To configure your company information, go to the Contacts app, search for your company, and select it. Then configure the following fields:
Name
Address, including the City, State, Zip Code, and Country.
In the Street field, enter the street name, number, and any additional address information.
In the Street 2 field, enter the neighborhood.
Tax ID: Tax identification number
SST: Malaysian Sales and Service Tax Number, if applicable
TTx: Malaysian Tourism Tax Number, if applicable
Phone
E-invoicing integration with MyInvois
The MyInvois Portal is a platform provided by the IRBM that facilitates the implementation of e-invoices for Malaysian taxpayers. Odoo supports integration with MyInvois to submit the invoices generated in Odoo.
Note
The Malaysia - E-invoicing module must be installed to submit invoices to MyInvois.
Set-up
MyInvois registration
To send electronic invoices to MyInvois, you first need to register and log in to the MyInvois portal to grant Odoo the right to invoice as an intermediary for your company.
Note
If this is the first time you log into the MyInvois portal, click User Manual on MyTax to learn more about the registration process. Both the pre-production (testing environment to try the functions before using the actual (production) environment) and production (actual environment to submit e-invoices with accurate information) environments are supported.
Log into MyTax. Choose the ID Type and the corresponding identification number used to register for the digital certificate.
From the dashboard, click the (angle-down) icon in the top-right corner and select View Taxpayer Profile.
In the Representatives section, click Add Intermediary in the top-right corner.
Add
ODOO S.A.as an intermediary using the following information:TIN:
C57800417080BRN:
BE0477472701Name:
Production:
ODOO S.A.Pre-production:
OXXX_XXXXA.
Grant the following permissions by clicking the (toggle-on) icon:
Representation From
Document - Submit
Document - Cancel
Document - Request Rejection
Note
Access can be revoked in the future if needed.
Odoo, as an intermediary, does not store invoices sent on behalf of the client on the proxy server.
Click Save. The status for
ODOO S.A.is then Active.
Configuration in Odoo
Company
Open the Settings app, navigate to the Companies section, and click Update Info. Make sure the Tax ID is entered and complete the following fields in the E-invoicing section:
Identification: Select the ID Type and enter the associated Identification number used to register for the digital certificate.
Ind. Classification: Input the 5-digit numeric code that represents the nature and activity of the business.
Electronic invoicing
Go to . In the Malaysian Electronic Invoicing section, select the relevant MyInvois mode based on the environment used for the company’s MyInvois registration.
Make sure to allow Odoo to process e-invoices by checking the box, then click Register.
Note
To change the TIN reference, click Unregister, change the company’s information and make sure the number registered on MyInvois matches, then Register again.
Important
For taxpayers with a TIN starting with “IG” and a ROB number, combine the TIN and ROB in the TIN:ROB format for the Tax ID field.
To register, go to , and in the Malaysian Electronic Invoicing section, click Register. Once the registration is complete, the :ROB can be removed from the Tax ID.
Additionally, remember to log into MyTax account and set the Type of Role as Business Owner.
Contacts
Access the contact’s form and fill in the following fields:
Country
State
Phone
Tax ID
Identification: the ID Type and the corresponding Identification number of the contact registered on MyTax.
Products
All products to be included in e-invoices require a Malaysian classification code. To add it, access the Product form and in the General Information tab, fill in the Malaysian classification code field.
Malaysian tax type
To configure a tax’s Malaysian Tax Type field, go to and open the relevant tax in the Taxes list view.
When an invoice or bill includes a tax with the Malaysian Tax Type set to Tax Exempt, a Tax Exemption Reason must be specified in the MyInvois tab before the document is sent.
Workflow
Send invoices to MyInvois
Invoices can be sent to MyInvois once they have been confirmed. To do so, click Send to MyInvois.
Send bills to MyInvois
Sending a bill to MyInvois is necessary when issuing an e-Invoice on behalf of a supplier. Once a bill is confirmed, click Send To MyInvois.
Note
In MyInvois, these vendor bills are categorized as Self-billed Invoice.
If a Bill Reference field is empty, Odoo’s vendor bill number is used as the MyInvois number. If a reference is entered in the Bill Reference field, that reference is used instead.
MyInvois status
The current MyInvois status of an invoice or bill is shown in the MyInvois State field within the MyInvois tab.
Validation in Progress: the validation is being processed by MyInvois. A blue Processing banner is also displayed.
Valid: it is validated by MyInvois. The Submission UID, MyInvois and Validation Time are automatically updated with information from MyInvois.
Note
Odoo automatically checks and updates the status every hour. To update it manually at any time, click Update MyInvois Status.
Invoice cancellation
Sent invoices can be canceled within 72 hours from Validation time. In this case, open the invoice and click Request Cancel. In the Cancel document window, include the cancellation Reason, then click Update Invoice. The MyInvois State is updated to cancelled.
Send credit notes to MyInvois
Before sending a credit note, the original invoice must be successfully submitted to MyInvois. Otherwise, the credit note’s MyInvois State is updated to Invalid.
While Odoo uses a single credit note document, MyInvois categorizes these into two types: credit note and refund note, depending on how they are reconciled.
MyInvois Credit Note: This is created when an Odoo credit note is reconciled with the original invoice.
MyInvois Refund Note: This is created when an Odoo credit note is reconciled with a full payment instead of the original invoice.
Note
If a credit note is reconciled with only a partial payment before being sent, it is still categorized as a credit note in MyInvois.
Tip
- To issue both a credit note and a refund note for the same original invoice:
Create two separate credit notes in Odoo from the original invoice.
For a MyInvois Refund Note: Register a payment before sending it.
For a MyInvois Credit Note: Do not register a payment before sending it.
Note
The same logic applies to credit notes created from bills: if reconciled with a full payment, the credit note becomes a Self-billed Refund Note; otherwise, it becomes a Self-billed Credit Note.
Send debit notes to MyInvois
Issue a debit note from an existing bill or invoice and click Send To MyInvois. In MyInvois, it appears then as a Debit Note if issued from an invoice or a Self-billed Debit Note from a vendor bill.
Access invoices via QR code
When a document is successfully submitted to MyInvois, a QR code is added to its PDF version. Scanning this code links directly to the validated document in MyInvois.
To download the PDF from an invoice or bill:
Click the (gear) icon
Select Download
Choose either PDF or PDF without Payment
Employment Hero payroll
If your business is already up and running with Employment Hero, you can use our connector as an alternative payroll solution.
Important
To configure the Employment Hero API for Malaysia, use the following value as Payroll URL: https://apimy.yourpayroll.io/.