jomeinvoice.my

Mastering e-Invoice Submission via API: A Comprehensive Guide

Learn how to seamlessly submit e-Invoices via API to IRBM, including methods, formats, and step-by-step guidelines.

Table of Contents

Table of Contents

In today’s fast-paced digital world, integrating e-Invoices into your business operations isn’t just a good idea—it’s essential for staying efficient and compliant. Luckily, the Malaysian Inland Revenue Board (IRBM) offers a seamless API that allows you to submit e-Invoices directly, making transactions smoother and record-keeping a breeze. This guide will walk you through how to transmit e-Invoices via API, the formats you’ll use, and the key steps in the submission process.

Methods to Transmit e-Invoices via API

Taxpayers can transmit e-Invoices to IRBM through various methods:

  1. Direct Integration with API: Integrate your ERP system directly with the MyInvois System.
  2. Peppol Service Providers: Use Peppol-certified service providers for e-Invoice transmission.
  3. Non-Peppol Technology Providers: Engage with non-Peppol technology providers to facilitate e-Invoice submission.

Supported Formats for e-Invoice Submission: XML and JSON

The e-Invoice structure is designed to accommodate B2B, B2G, and B2C transactions, adhering to the Universal Business Language Version 2.1 (UBL2.1). The supported formats are:

  1. Extensible Markup Language (XML): A strict, text-based format for representing structured information. It ensures reliable processing by computer software.
  2. JavaScript Object Notation (JSON): A lightweight, text-based data interchange format that is simpler to read and write compared to XML. It is language-independent, making it versatile for various programming environments.

Essential Data Fields for e-Invoices

An e-Invoice must include 55 data fields, categorized as follows:

  1. Address
  2. Business Details
  3. Contact Number
  4. Invoice Details
  5. Parties
  6. Party Details
  7. Payment Info
  8. Products / Services

Step-by-Step e-Invoice Submission via API

Pre-Submission Requirements

Digital Certificate: You’ll need a digital certificate (.cer or .pfx) to verify the identity of the issuer. This digital signature will be part of your e-Invoice API submission.

e-Invoice Preparation: Make sure your system (or your technology provider) is set up to generate e-Invoices in the required XML or JSON format. Double-check that all mandatory and optional fields are filled out correctly.

Step 1: Creating and Submitting the e-Invoice

Upon concluding a sale or transaction, the supplier or technology provider creates an e-Invoice in XML or JSON format and submits it to IRBM via API for validation. Ensure the accuracy of the information included in the e-Invoice.

Step 2: e-Invoice Validation Process

The MyInvois System will validate your e-Invoice almost instantly. If everything checks out, you’ll get an API response with:

  • The IRBM Unique Identifier Number
  • Date and time of validation
  • Information for the validation link

If there’s an issue, you’ll receive an API error message, so you can fix the problem and resubmit.

Step 3: Sharing the Validated e-Invoice

It’s time to share the e-invoice with the buyer. You can also provide a visual representation of the e-Invoice, complete with a QR code for easy validation.

Steps 4, 5, and 6: Rejection and Cancellation

If the buyer spots an error, they can request a rejection within 72 hours via API. Once you agree, you can cancel the e-Invoice within that time. If it’s not canceled, you’ll need to issue a new e-Invoice (like a credit note, debit note, or refund note) to make the corrections.

Step 7: Storing e-Invoices

Once validated, your e-Invoices are stored securely in IRBM’s database. Don’t forget to keep your own records and documentation as well.

Step 8: Reporting and Dashboard Services

With API integration, you and your buyers can easily request and retrieve e-Invoice details, making e-Invoice management more transparent and efficient.

Conclusion: Streamlining e-Invoice Management with API Integration

Using API integration for your e-Invoice submissions makes the process quicker and ensures you stay compliant. By following this guide, you’ll be well on your way to smooth, hassle-free e-Invoice management with the MyInvois System.

Need a hand with e-Invoice API integration? Get a consultation with our experts to discuss your e-invoice API integration needs.

Let's discuss your project

We understand that every project is unique. Contact us and we will get back to you with the next steps.