Malaysia-specific codes

Status codes

The following table maps SCICloudStatusCode values to Inland Revenue Board of Malaysia (IRBM) response codes.


SCICloudStatusCode	IRBM code	Meaning	Action required
RECEIVED	—	Sovosreceived the document and queued it for processing.	Continue polling.
MAPPED	—	Sovos mapped the document to the Inland Revenue Board of Malaysia (IRBM) format (multiple responses mode only).	Continue polling.
VALIDATED	—	Sovos validated the document against IRBM's business rules (multiple responses mode only).	Continue polling.
SIGNED	—	Sovos signed the document with the digital certificate (multiple responses mode only).	Continue polling.
SUBMITTED	—	Sovos submitted the document to IRBM (multiple responses mode only).	Continue polling.
ACCEPTED	[IRBM success code]	IRBM accepted the document. The UUID, Long ID, and QR code are in the response.	Embed the QR code and deliver the document to the buyer.
REJECTED	[IRBM rejection code]	IRBM rejected the document. The error's details are in the response.	Fix the identified problems and resubmit with a new document number.
400 (401)	—	Technical or structural error. Sovos didn't submit anything to IRBM.	Fix and resubmit.

Invalid or inactive supplier TIN: Verify the TIN is active at https://www.hasil.gov.my.
Invalid or inactive buyer TIN: Verify the buyer's TIN. For consolidated B2C, use EI00000000010.
Duplicate document number for this TIN: Issue a new invoice with a unique document number.
Tax calculation error: Recalculate at the line item level. All amounts must use two decimal places.
Missing required field: Check for TIN, BRN, MSIC code, and all mandatory elements.
Invalid or expired digital certificate: Upload a new valid certificate from a Malaysian CA.
Document exceeds size limit: Reduce line items or attachments. Maximum is five megabytes.
Invalid document type code: Use the correct IRBM type code from the document type codes table.

Note:

For the authoritative rejection code reference, see IRBM's document validation rules page.

IRBM document type codes map to United Nations Trade Data Interchange Directory (UNTDID) 1001 codes as follows:


IRBM code	UNTDID 1001 code	Document type	Usage
01	380	Invoice	Standard tax invoice issued to a buyer.
02	381	Credit note	Adjustment that reduces the amount of a previously issued invoice.
03	383	Debit note	Adjustment that increases the amount of a previously issued invoice.
04	384	Refund note	Document issued to refund a previously paid amount.
11	380	Self-billed invoice	Invoice the buyer created on behalf of the supplier.
12	381	Self-billed credit note	Credit note for a self-billed invoice.
13	383	Self-billed debit note	Debit note for a self-billed invoice.
14	384	Self-billed refund note	Refund note for a self-billed invoice.

Malaysia uses the following tax type codes in the TaxCategory/ID element:


Code	Description	Rate	Notes
01	Sales tax	5% or 10%	Rate depends on the goods category.
02	Service tax	8%	Applies to most taxable services.
03	Tourism tax	Varies	Applies to accommodation and tourism services.
04	High-value goods tax	Varies	Applies to designated luxury and high-value goods.
05	Sales tax on low-value goods	10%	Applies to low-value imported goods.
06	Not applicable	0%	Use when no tax applies and none of the specific categories fit.
E	Exempt	0%	Tax-exempt supplies.

Note:

For the latest tax rate information, see the invoice page.

Use one of the following reason codes when submitting a cancellation request:

Pricing error: Provide the correct amount in the reason description.
Incorrect buyer information: Provide the correct buyer details in the reason description.
Duplicate invoice: Reference the original correct invoice.
Other: Provide a clear description in the reason description field.

Note:

IRBM assigns The specific cancellation reason code values. See cancellation reason code values for the current list.

200: Request completed. Response data is available.
202: Document accepted for processing. Poll for the application response later.
400: Bad request. The Standard Business Document (SBD) payload is malformed or missing required fields.
401: Unauthorized. Check your API credentials.
404: Not found. The document ID does not exist.
429: Rate limit exceeded. Sovos handles this automatically. No action required.
500: Internal server error. Retry the request after a short delay.

Use the following two-digit numeric state codes in the CountrySubentityCode element for Malaysian addresses:

Note:

For the complete and current list, see the Types page.