Step 1: Installation and Organization Setup

Step 1: Installation and Organization Setup


Introduction

Welcome to the eInvoice Malaysia Plugin for Zoho Books, developed by Ooroboros Sdn Bhd. This guide will walk you through the installation, setup, and usage of the plugin to ensure you maximize its benefits and maintain compliance with Malaysia's Tax Authority, LHDN.


Generate your Client ID & Secret

  1. Login to your MyTax to your MyTax account.
    1. If you do not have this access, please refer to the Pre-requisite Guide before you proceed further.
    2. should you be a company representative, use this guide 
      WarningPlease make sure to login to the pre production (https://preprod-mytax.hasil.gov.my/) MyTax and MyInvois environments to generate the Client ID and Client Secret if you are still testing the eInvoice plugin. This way all pushed documents will go to the test LHDN environment.
  2. Under Pilihan Peranan, make sure to select your organization then click on MyInvois.
  3. Click on your profile picture on the top right.
    1. In the drop down, ensure your organization is selected and click on View Taxpayer Profile.
  4. Scroll to the bottom of the Taxpayer Profile page to the Representatives section and select the ERP tab.
  5. Click on the Register ERP button. 
  6. In the pop-up, fill in
    1. the ERP Name (eg: Zoho Books, Zoho Books HQ, Zoho Books Subsidiary A etc.)
    2. select the Client Secret expiration (duration the Client Secret is valid for. Once duration is up e.g. 1 year, you need to generate a new Client Secret)
    3. make sure the Primary ERP System boxed is ticked

    4. click the Register button.
  7. A new pop-up will open with the Client ID, Client Secret 1 and Client Secret 2 (either of Client Secrets can be used for the eInvoice).
    Please make sure to copy all 3 lines and store them somewhere safe.
WarningWARNING: Once you click Done, you will not be able to retrieve the Client Secret if you lose it and will have to re-register the ERP.



Finding the plugin from the Zoho Marketplace


  1. In your Zoho Books, go to Settings>Marketplace under the Integrations and Marketplace section
  2. Search for eInvoice Malaysia for Zoho Books
    1. You may purchase or start a free trial from here 


Choosing your plan


  1. Click on the plugin to visit the eInvoice Plugin page, there are two options:
    1. Click on Start free trial to begin the 15 day free trial 
    2. Click on Buy Now to purchase the plugin directly. 
  2. A new tab will open.
    1. select your organization and review the terms and conditions.
    2. tick agree and press Continue 
  3. click on Install extension to install the plugin. 


Installing the plugin from the Zoho Marketplace

  1. Click Connect and Authorize the connection of the Plugin to your Zoho Books account

  2. Fill in all applicable fields. Note, the fields in red with an "*" are mandatory.

    1. Under Environment ( PROD / SANDBOX ), input SANDBOX for Zoho books to connect to the Test environment of the LHDN MyInvois website. Please ensure to connect to the test environment if you plan to do any testing so that the e-Invoices from Zoho are not submitted as actual live documents in MyInvois. Input PROD for Zoho books to connect to the Live environment

    2. For Individuals, ensure to input the National Registration Identity Card (NRIC) field and for Businesses, please ensure to input the SSM Business Registration Number (BRN) field.

    3. For Tax-Exempt Organizations or if you have tax-exempt items, please complete the following fields with the specified values (If not applicable, please input NA for the same fields):

      1. Scheme ID: UN/ECE 5153

      2. Scheme Agency ID: 6

      3. Tax Name: OTH

    4. Please input the Malaysia Standard Industrial Classification (MSIC) Code relevant to your organization. You may refer to the codes in this link: https://sdk.myinvois.hasil.gov.my/codes/msic-codes/

    5. Input the Client ID and Client Secret you generated in the previous section.

  3. Click Install Extension to begin the Plugin Installation

  4. Wait for the loading to finish and you will now be able to see the Plugin installed in the Installed Extensions tab of your Zoho Marketplace

Note: To change any of the input configuration fields please follow the following steps:

  1. In the Marketplace page, navigate to the "Installed Extensions" tab.

  2. Click "View details" on the e-Invoice Malaysia plugin.

  1. Click on the configure button on the top right.

  2. Click save to complete.



Setup Organization Profile


            
  1. Go to Settings > Organization > Profile and enter your organization's Business Registration Number(BRN) from SSM in Company ID field and click Save
  2. Go to  Settings > Taxes & Compliance > Taxes > Tax Settings and enter your organization's Tax Identification Number (TIN) from LHDN in the TIN field and click Save
  3. Navigate to Settings > Preferences > General > Organization Address Format.
  4. Add the following lines to the bottom of the Organization Address Format
    1. ➤ BRN: ${ORGANIZATION.COMPANYID_VALUE}
    2. ➤ TIN: ${ORGANIZATION.COMPANYTAXID_VALUE}


Setting up QR code for Invoice & Credit Note



Invoice settings placeholders

  1. Go to Settings > Sales > Invoices to access Invoice Settings

  2. Toggle Enable on Invoice QR Code.

    1. Select QR Code Type Custom.

    2. click the Configure button.

  3. In the pop-up select Insert Placeholders and select Public Link. 

    1. ${invoice.cf__com_ghzmyw_public_link} should appear in the custom value field. 

  4. Click Update to close the pop- up

  5. Save to save the settings.

Credit note placeholders

  1. Go to Settings > Sales > Credit Notes to access Credit Note Settings
  2. Toggle Enable on Credit Note QR Code.
  3. Select QR Code Type Custom.
  4. click the Configure button.
  5. In the pop-up select Insert Placeholders and select Public Link. 
    1. The value ${invoice.cf__com_ghzmyw_public_link} should appear in the custom value field. 
  6. Click Update to close the pop- up
  7.  Save to save the settings.


Enable QR in PDF templates

  1. Go to Settings > Customization > PDF Templates >Invoices.

  2. Click Edit on the Invoice PDF template actively used by your organization to open the Invoice Document Formatting.

  3. Click on Other Details on the left

  4. tick Show Invoice QR Code 

  5. Save.


  1. Go to Settings > Customization > PDF Templates >Credit Note.
  2. Click Edit on the Invoice PDF template actively used by your organization to open the Invoice Document Formatting.
  3. Click on Other Details on the left
  4. tick Show Invoice QR Code
  5.  Save.



Updating Customers and Vendors Address Formats


      

  1. Navigate to Settings > Preferences > General > Customers & Vendors.

  2. Add the following lines to the Billing Address field:
    1. TIN: ${contact.cf__com_qhzmyw_tin} 
    2. ${contact.cf__com_qhzmyw_registration_number_scheme}: ${contact.cf__com_qhzmyw_registration_number}

  3. Add the following lines to the Shipping Address field:
    1. TIN: ${contact.cf__com_qhzmyw_tin} 
    2. ${contact.cf__com_qhzmyw_registration_number_scheme}: ${contact.cf__com_qhzmyw_registration_number}

  4. This ensures that the PDF version of documents (Invoice, Debit Note, Credit Note) includes the eInvoice information for both the Customers and the Vendors.


InfoNext step in Step 2: Updating Customer and Vendor databases