LHDN e-Invoice

Berinteraksi dengan API LHDN e-Invoice Malaysia
Join our community

Actions8

Overview

This node interacts with the LHDN e-Invoice Malaysia API to manage electronic invoice documents. It supports submitting new e-invoice documents either by filling out form fields or by providing raw JSON/XML documents. The node also allows retrieving, canceling, rejecting, and checking the status of documents, as well as validating Tax Identification Numbers (TIN). It is useful for automating e-invoice submissions and management in compliance with Malaysian tax regulations.

Use Case Examples

  1. Submitting an invoice by filling out form fields such as invoice number, supplier and customer details, and invoice items.
  2. Submitting a raw JSON or XML e-invoice document directly.
  3. Retrieving the details or status of a submitted e-invoice document using its UUID.
  4. Canceling or rejecting an e-invoice document with a specified reason.

Properties

Name Meaning
Input Mode Selects the method to input invoice data: either through easy form fields or by providing a raw JSON/XML document.
Invoice Number The invoice number identifier, e.g., INV001.
Invoice Type Type of invoice document, such as Invoice, Credit Note, Debit Note, or Refund Note.
Currency Currency of the invoice document.
Supplier TIN Tax Identification Number of the supplier company.
Supplier Name Name of the supplier company.
Supplier Address Address of the supplier company.
Supplier City City of the supplier company.
Supplier Postal Code Postal code of the supplier company.
Supplier State State of the supplier company.
Customer TIN Tax Identification Number of the customer.
Customer Name Name of the customer.
Customer Address Address of the customer (optional).
Customer City City of the customer (optional).
Invoice Items List of items in the invoice, each with description, quantity, unit price, tax rate, and tax type.
Document Format Format of the raw document to be submitted, either JSON or XML.
Document The raw e-invoice document in JSON or XML format (required if input mode is raw).
Code Number Code number associated with the document.

Output

JSON

  • documents
    • ``
      * format - Format of the submitted document (JSON or XML).
      * documentHash - SHA-256 hash of the submitted document content.
      * codeNumber - Code number associated with the document.
      * document - Base64 encoded content of the submitted document.

Dependencies

  • An API key credential for authenticating with the LHDN e-Invoice API

Troubleshooting

  • Ensure all required fields are filled when using the form input mode, especially mandatory fields like invoice number, supplier and customer details.
  • When submitting raw documents, ensure the JSON or XML is correctly formatted and valid.
  • If authentication fails, verify the API key credential and token retrieval process.
  • Error messages related to document UUID indicate invalid or non-existent document references; verify the UUID used.

Links

Discussion