Malaysia

Credit note

Changes to generic fields

type CreditNote {
  // ...all generic credit note fields
  issued: string; // ISO 8601 date or date-time
  lines: InvoiceLine[];
  invoiceRefs: string[];
  recipient: CreditNoteRecipient;
  customInfo: {
    mys: {
      placeHolder?: string;
    }
  }
}

type CreditNoteRecipient {
  taxId: string;
  name: string;
  address: {
    state: string;
  };
  contact: {
    phone: string;
    email: string;
  };
  sstRegistrationNumber?: string;
  identification: {
    type: 'ARMY' | 'BRN' | 'NRIC' | 'Passport';
    value: string;
  };
  customInfo?: StringStringTMap<string | number>;
}

type InvoiceLine {
  description: string;
  itemCode: string;
  quantity?: number;
  vat: {
    type: 'fixed' | 'percent';
    code: TaxCode;
    amount: number;
    exemptReason?: string;
  };
  price: {
    amount: number;
  };
}

Field information

NameTypeRequiredDescription
issuedstring (ISO 8601 date or date-time)Yes

Issue date of the credit note. A date-only value (e.g. 2025-01-15) is submitted as 00:00:00 UTC on that date.

The credit note must be issued later than the invoice it credits. If you credit an invoice on the same day it was issued, include a time (e.g. 2025-01-15T12:00:00Z), otherwise MyInvois rejects the credit note.

invoiceRefsstring arrayYesThe ref values of the existing invoices this credit note applies to. eezi resolves each one to the invoice's MyInvois UUID. In CSV files, use invoiceRefs.0, invoiceRefs.1, and so on.
linesarrayYesAt least one line item is required. total.amount must equal the sum of the line items, including tax.
lines[].itemCodestringYesLine item code (3 character) as outlined on Malaysia item code list
lines[].vat.codestringYesA value from an enumerated list of types:
  • 01: Sales Tax
  • 02: Service Tax
  • 03: Tourism Tax
  • 04: High-Value Goods Tax
  • 05: Sales Tax on Low Value Goods
  • 06: Outside of scope
  • E: Exempt
lines[].vat.exemptReasonstringConditionalIf the line VAT amount is 0, an exemption reason is required.
recipient.address.statestringYesWhen recipient.address.country is Malaysia, a 2 digit state code as outlined on Malaysia state code list is required.
recipient.contact.phonestringYesContact number of recipient.
recipient.contact.emailstringYesEmail address of the recipient.
recipient.sstRegistrationNumberstringNoSST registration number of the recipients that are SST-registered. The input of special characters is not allowed, except for dash (-) and semicolon (;). A maximum of two SST registration numbers is allowed.
recipient.identification.typestringYesOne of the following values (case-sensitive):
  • NRIC: For Malaysian individuals (MyKad), and for MyPR and MyKAS holders (12 characters).
  • ARMY: For Malaysian armed forces personnel (MyTentera) (12 characters).
  • BRN: For businesses. Business registration number (20 characters).
  • Passport: For non-Malaysian individuals. Passport number (12 characters).
recipient.identification.valuestringYesIdentification number based on type

Example CSV file

Credit note - Malaysia.csv


Did this page help you?