Lembaga Hasil Dalam Negeri Malaysia has provisioned SDK 1.0 Release to help taxpayers in preparing for the upcoming MyInvois System. SDK Updates section below highlights key updates as part of this release.
Base URLs
In order for taxpayers to access the URLs for the various environments, please ensure that root certificate is trusted by the machine used to avoid any security-related issues accessing these URLs. See more in FAQ.
SDK Updates
10 August 2024
Updates to Signature
• Included Powershell Script under Signature Creation section for additional guidance on signing JSON file for Version 1.1 document types.
28 June 2024
Updated Validations & Documentation
• Updated to align API Response and Standard Error Response.
• Updated the Document Type examples to specify “v1.1” instead of “v1.0”.
• Removed ‘Continuation Token’ from Search Documents API.
Updates to Signature
• Updated detailed step on encoding the hashed property tag using HEX-to-Base64 Encoder in Document Signature Creation.
• Updated the steps in Signing a JSON Document.
New Additions
• Added Signature Page and Relevant Samples for v1.1.
• Added Type Page and Relevant Samples for v1.1.
• Added new page (Sample) containing sample payload for each document type.
• Updated response to the Get All Document Types, Reject Document and Get Recent Documents APIs.
Other Updates
• Updated Contacts page.
21 JUN 2024
Updated Validations & Documentation
• Updated Actual API deployed to Sandbox environment.
• Updated the UBL Sample XML and JSON for Foreign Currency and Multi Line Item.
• Added a pagination URL parameter to the Get Submission.
• Included clarification on Tax Rate.
• Updated Shipping Recipient fields from “Mandatory where Applicable” to “Optional”.
• Updated SST Registration Number to a maximum character count of 35 and provided support for the special character – semicolon (;).
New Additions
• Implement Minification of XML / JSON documents within the Submit Document API.
Other Updates
• Updated the FAQ:
- Added guidance on QR code generation.
- Updated the title from Error 404 to Error 400 and replaced BadArgument with BadRequest.
- Updated TIN parameters.
24 May 2024
Updated Validations & Documentation
• Amended Number of Characters of Supplier & Buyer Contact Number.
• Refined note on Tax Rate.
• Updated Percent node on Tax Rate.
Updates to Signature
• Updated sample and explanation of actual Digital Certificate JSON.
New Additions
• Added New Sample XML for Foreign Currency with Tax Exchange Rate and Multi Line Item.
• Added X-Rate Limit Description in FAQ.
• Added new page for Signing Document JSON in Document Signature Creation page.
• Added new code ‘E’ under Tax Types.
Other Updates
• Included General, Signature and Postman API Guidance subpages under FAQ along with Integration Practices.
10 May 2024
Updated Validations & Documentation
• Amended descriptions for several fields including Fee / Charge Rate, Fee / Charge Amount, Total Discount Value, and Invoice Additional Fee Amount.
• Updated available APIs in the sandbox environment under FAQs.
• Updated cardinality of fields including Quantity, Measurement, Reference Number of Customs Form No.1, 9, etc., SST Registration Number and Tourism Tax Registration Number.
• Updated number of characters for Measurement field to 3 characters.
• Refined descriptions for fields such as Tax Type, City Name, Payment Mode, and Prepayment Time.
Updates to Signature
• Removal of Timestamp Authority (TSA) requirement of XAdES for digital signature.
• Provided clearer guidance on hashing with SHA256 followed by HEX-to-Base64 encoding.
• Updated sample in SDK with RSA-SHA256.
New Additions
• Added Measurement Code Table under Codes.
Other Updates
• Improved visual for API input parameters with new column on optional / mandatory
19 April 2024
Document Types:
• Updates to cardinality and number of characters for all document types.
• Guidance on Taxpayers’ details for MyPR and MyKAS to adhere to NRIC scheme.
• Updated guidance on address section table.
e-Invoice API:
• Updated IdType input parameter to list all possible values.
• Added new “Mandatory/Optional” column for each API input parameter.
6 April 2024
Updated Validations & Documentation:
• Updated Types > Invoice v1.0 > All data fields, and Types > Invoice v1.0 > Field descriptions.
• Updated applicable fields mandatory in Types > Invoice v1.0 > Data Structure.
• Updated descriptions in Types > Invoice v1.0 > Data Structure.
• Provided guidance for non-registrants in Types > Invoice v1.0 > Data Structure.
• Implemented UBL2.1 Sequencing to improve validation and readability.
• Updated Description field for Fee / Charge Rate.
New Additions:
• Added new code ‘044 - Vouchers, gift cards, loyalty points, etc’ in ‘Codes’.
• Added Tax Exemption Field in Invoice and InvoiceLine.
• Updated guidance with Digital Signature Creation and Validation, along with sample.
Updates to API Documentation:
• Updated API documentation for e-Invoice functionality.
• Clarified error responses and inputs for various API endpoints.
• Updated list of Sandbox APIs and Sandbox Identity Service URL on the FAQ page.
• Updates to writeup of HTTP 400 Error Responses for multiple APIs.
Other Updates:
• Improved documentation on document types, hashing, and getting started.
• Updates to currency exchange rate and file size limitations.
• Updates to mathematical mapping.
Document Version Updates
Addition of Version 1.1 for all Document Types for Signature Validation.