MyInvois ClientMalaysia e-invoicing for TypeScript

Document building, XAdES (JSON) signing, submission, polling, taxpayer validation and built-in rate limiting for the LHDN MyInvois API.

Get Started

API Reference

Official LHDN SDK Docs

Full submission pipeline

Build UBL-in-JSON documents, sign them with XAdES, submit, poll to a terminal status, cancel or reject — one typed client for the whole flow.

Sign once, store, submit

buildSignedDocuments returns the exact wire bytes and hash so you can store the payload and resubmit it byte-for-byte — perfect audit trails.

Rate limiting built in

A per-clientId sliding-window queue keeps every call inside the official limits, with automatic 429 Retry-After back-off and injectable stores for multi-process deployments.

Typed against the official spec

Every code list (MSIC, UOM, currencies, states…) is a TypeScript union generated from the official SDK tables, plus runtime arrays under the /codes subpath.

Install

bash

npm install @ripwords/myinvois-client
# or: bun add / pnpm add / yarn add @ripwords/myinvois-client

At a glance

typescript

import { MyInvoisClient } from '@ripwords/myinvois-client'

const client = MyInvoisClient.fromP12(
  clientId,
  clientSecret,
  'sandbox', // or 'production'
  'path/to/certificate.p12',
  passphrase,
)

const { data, status } = await client.submitDocument([invoice])
if (status === 202) {
  const result = await client.getSubmissionStatus(data.submissionUid)
  console.log(result.status) // 'Valid' | 'PartiallyValid' | 'Invalid' | ...
}

Scope: Malaysia MyInvois only. Singapore's InvoiceNow / Peppol e-invoicing is a different system and out of scope.
Agents: a machine-readable summary of this site lives at llms.txt.