E-Invoicing Study: Anticipated Components in Software Development Kit - System Specification
This article is trying to highlight the anticipated contents inside Software Development kit before the official document is scheduled to release in December 2023 or any time after the article publication.
The software development kit shall consider of the following sections:
- Digital Certificate and Signature
- IRBM announced in the guideline that digital signature is embedded into the e-invoice. Therefore, IRBM shall use Tax Identification Number to create the digital certificate for specific taxpayer as an authentication approach to validate the identity of the taxpayer. The SDK shall indicate a digital signature to be embedded in the e-invoice shall be based on one digital signature or shall use different digital signature that belongs to the same taxpayer for retailing e-invoice.
- Digital signature is mandatory to present in the e-invoice. The attached sample shows typical digital signature as Issuer's Digital Signature as mandatory field. However, the length of the digital signature is yet to be finalized.
- Quick Response Code QR Code
- QR Code shall include TIN and Seller's Name.
- The SDK shall indicate the development on QR Code whether it is based on Base64 string.
- The SDK shall indicate the contents of QR code in term of Tag, Length and Value (TLV)
- Provision for Data Dictionary - Helpful in XML schema
- The SDK shall provide complete lists of data dictionary as whether it is based on PEPPOL INTERNAITONAL (PINT) or Malaysia specific data field.
- It shall provide UBL XML schema sample to help in the software development and how to fill in from data catalogue published by IRBM.
- Provide sample value in each data field and whether validation will be done during validation stage.
- Provide indication whether the data field is mandatory or optional as not all e-invoices issued contain Sales Tax, Service Tax or Tourism Tax.
- Elaboration on File Storage Path
- IRBM provided the file storage in the e-invoice guideline. Therefore, the software development shall dedicate the folders to store the e-invoices generated before sending for validation and after validation.
- File Name Convention
- The SDK shall indicate the file name for generated e-invoices. The objective is to make sure that no e-invoices with the same file name are sent to IRBM for validation at the same time.
- Typical file name convention as below:
- TIN
- DATETIME
- E-Invoice Code / Number
- Example: C22218888888_20240801151308_INV12345.xml