# 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.

> **Legacy API v2**
>
> This page documents API v2 for Malaysia, which is no longer developed. Start new integrations on the current API: see the [Unify API reference](https://docs.complyance.io/api-reference/unify/) and the [Malaysia guide](https://docs.complyance.io/countries/my/).

These are the validation error messages the [LHDN Unify API](https://docs.complyance.io/legacy/v2/malaysia/lhdn-unify/) 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` |

Source: https://docs.complyance.io/legacy/v2/malaysia/error-messages-lhdn/