Malaysia v2: LHDN Unify errors
The validation error messages the Malaysia LHDN Unify API v2 (legacy) can return, with the request field each one refers to.
These are the validation error messages the LHDN Unify API can return. Each one names the request field to check.
Validation errors
| Message | Field |
|---|---|
| Document ID is missing! Please provide a valid Document ID. This field cannot be null or empty. | documentId |
| Document ID is duplicated! Each document must have a unique Document ID. | documentId |
| Document Issue Date is missing! Please provide the issue date of the document in ‘YYYY-MM-DD’ format. | documentIssueDate |
| Document Issue Date is invalid! The date must follow the ‘YYYY-MM-DD’ format and should not be in the future or more than 3 days in the past. | documentIssueDate |
| Document Issue Time is missing! Please provide the time in ‘HH:mm:ssZ’ format. | documentIssueTime |
| Document Issue Time is invalid! The time must follow the ‘HH:mm:ssZ’ format. | documentIssueTime |
| Invoice Start Date is invalid! Please provide a valid date in ‘YYYY-MM-DD’ format. | invoiceStartDate |
| Invoice End Date is invalid! Please provide a valid date in ‘YYYY-MM-DD’ format. | invoiceEndDate |
| Invoice End Date must be after Invoice Start Date. Please check and correct the dates. | invoiceEndDate |
| Invoice Frequency is invalid! Accepted values are ‘DAILY’, ‘WEEKLY’, ‘MONTHLY’, and so on. Please provide a valid frequency. | invoiceFrequency |
| Seller Tax Identification Number (TIN) is missing! Please provide a valid TIN. This field is mandatory. | sellerTinNumber |
| Seller TIN exceeds the maximum length! It must not exceed 14 characters. | sellerTinNumber |
| Buyer Tax Identification Number (TIN) is missing! Please provide a valid TIN. | buyerTinNumber |
| Buyer TIN exceeds the maximum length! It must not exceed 14 characters. | buyerTinNumber |
| Currency is missing! Please provide a valid ISO 4217 currency code (e.g., ‘USD’, ‘MYR’). | currency |
| Currency is invalid! It must be a valid ISO 4217 currency code. | currency |
| Line Item ID is missing! Each line item must have a unique ID. | documentLineItems.lineItemId |
| Line Item Description is missing! Please provide a description for the line item. | documentLineItems.description |
| Line Item Quantity is missing! Please provide a valid quantity greater than zero. | documentLineItems.quantity |
| Line Item Unit Price is missing or invalid! It must be a positive number with up to 4 decimal places. | documentLineItems.unitPrice |
| Line Item Total Excluding Tax is missing! Please provide a valid value. | documentLineItems.lineTotalExcludingTax |
| Line Item Tax Percentage is missing! Please provide a valid percentage between 0 and 100. | documentLineItems.taxPercentage |
| Line Item Tax Type is missing! Please provide a valid tax type code. | documentLineItems.taxType |
| Document Total is missing! Please provide the total amount of the document. | documentTotal |
| Document Total is invalid! It must equal the sum of all line item totals including taxes and charges. | documentTotal |
| Total Payable Amount is missing! Please provide the total amount to be paid. | totalPayableAmount |
| Total Tax Amount is missing! Please provide the total tax amount for the document. | taxTotal |
| Buyer Address is missing! Please provide the buyer’s address details. | buyerAddress |
| Seller Address is missing! Please provide the seller’s address details. | sellerAddress |
| Shipping Address is missing! If provided, ensure it contains valid details like country, city, and address line. | shippingRecipientAddress |