Catch e-Invoice rejections before MyInvois does

curl https://api.sahkit.example/v1/invoices/validate \
  -H "Authorization: Bearer sk_test_sk9mQ2xR7vK4pLw3" \
  -H "Content-Type: application/json" \
  -d '{
    "number": "INV-2026-00417",
    "issued_at": "2026-09-26T10:42:00+08:00",
    "supplier": { "tin": "C21584563200", "brn": "202401012345", "msic": "4711" },
    "buyer":    { "tin": "C25845632010", "brn": "201901044521" },
    "lines": [
      { "description": "Kopi O beg 1kg", "qty": 12, "unit_price": 18.50,
        "classification": "022", "tax_type": "01", "tax_rate": 10 }
    ],
    "currency": "MYR"
  }'

import Sahkit from "@sahkit/node";

const sahkit = new Sahkit(process.env.SAHKIT_KEY);

const result = await sahkit.invoices.validate({
  number: "INV-2026-00417",
  issuedAt: "2026-09-26T10:42:00+08:00",
  supplier: { tin: "C21584563200", brn: "202401012345", msic: "4711" },
  buyer: { tin: "C25845632010", brn: "201901044521" },
  lines: [{ description: "Kopi O beg 1kg", qty: 12, unitPrice: 18.5,
    classification: "022", taxType: "01", taxRate: 10 }],
});

if (result.status === "rejected") {
  for (const e of result.errors) console.log(e.path, e.fix);
} else {
  await sahkit.invoices.submit(result.id); // sends it on to MyInvois
}

import os
from sahkit import Sahkit

sahkit = Sahkit(os.environ["SAHKIT_KEY"])

result = sahkit.invoices.validate(
    number="INV-2026-00417",
    issued_at="2026-09-26T10:42:00+08:00",
    supplier={"tin": "C21584563200", "brn": "202401012345", "msic": "4711"},
    buyer={"tin": "C25845632010", "brn": "201901044521"},
    lines=[{"description": "Kopi O beg 1kg", "qty": 12, "unit_price": 18.50,
            "classification": "022", "tax_type": "01", "tax_rate": 10}],
)

if result.status == "rejected":
    for e in result.errors:
        print(e.path, e.fix)
else:
    sahkit.invoices.submit(result.id)  # sends it on to MyInvois

HTTP/1.1 422 Unprocessable Entity
x-request-id: req_7Hq2mV9cLkP4
x-sahkit-latency: 38ms

{
  "id": "val_01J8ZK4Q7M2WX9",
  "object": "validation",
  "status": "rejected",
  "document": "INV-2026-00417",
  "checks": { "run": 64, "passed": 62, "failed": 2 },
  "errors": [
    {
      "code": "MSIC_FORMAT",
      "path": "supplier.msic",
      "message": "MSIC code must be 5 digits. Got \"4711\".",
      "fix": "Use 47111 (retail, mainly food and drinks)."
    },
    {
      "code": "TIN_BRN_MISMATCH",
      "path": "buyer.tin",
      "message": "TIN C25845632010 is not linked to BRN 201901044521.",
      "fix": "Ask the buyer to confirm their TIN, or use the general TIN for walk-in sales."
    }
  ],
  "ready_to_submit": false,
  "livemode": false
}

Base URL https://api.sahkit.example/v1. Every response carries x-request-id; paste it in a support ticket and we can see the exact call.

• 64 checks in one call

  Schema, TIN against BRN, 5-digit MSIC, classification and tax type codes, line totals, rounding to the sen and date windows. Everything MyInvois checks, plus what it only tells you after the fact.

  POST /v1/invoices/validate

• Fixes, not error codes

  Each error comes with a field path and a fix sentence you can show a cashier or accounts clerk as-is. Add ?lang=ms and the messages come back in Bahasa Melayu.

  errors[].fix · ?lang=en|ms

• Your JSON in, UBL 2.1 out

  Send invoices the way your app already stores them. A mapping file turns your field names into the MyInvois format, so you never hand-write UBL again.

  PUT /v1/mappings/{name}

• Submit with a retry queue

  Clean invoices go on to MyInvois in one call. If the upstream is slow or rate-limited, we hold the invoice and retry for up to 72 hours with the same idempotency key. No double submissions.

  Idempotency-Key header

• Consolidated and self-billed

  Roll up a month of walk-in cash sales into one consolidated e-Invoice by the 7th. Issue self-billed invoices for foreign suppliers and agents with the right buyer and seller swap.

  type: consolidated | self_billed

• Seven-year audit trail

  Every request, response, UUID and QR is kept for seven years in Malaysian data centres. Search by invoice number or request ID and export a CSV for your auditor.

  GET /v1/documents?number=

What changed for teams that switched

• rejections / month	3,100 → 41

  "We had 3,100 rejected invoices in our first month on MyInvois. After we put Sahkit in front of submit, we had 41. Most of those were buyers with the wrong TIN on file, and the fix text told our cashiers what to ask."

  FI

  Farah Idayu
  Backend lead, Pasar Pintar (fictional)

• integration time	4 hours

  "The Laravel package took an afternoon. The part I did not expect to love is the mapping file: our invoice table has 40 columns with names from 2014, and we never had to rename one."

  KS

  Kumar Selvam
  CTO, Lorong.pay (fictional)

• month-end close	2 days → 20 min

  "Consolidated e-Invoices for 18 outlets used to be two days of Excel at month end. Now a cron job posts one batch on the 1st and the webhook tells us when LHDN has it."

  TW

  Tan Wei Ling
  Engineering manager, KAYUHAN (fictional)

• plan: free

  RM 0forever

  1,000 live requests / month

  hard stop at the limit

  • +Unlimited sandbox requests
  • +All 64 checks + submit
  • +Webhooks and SDKs
  • +Community forum, 2-day email reply
  Get a free key

• plan: build

  most teams

  RM 49per month

  20,000 requests included

  then RM 0.004 per request

  • +Everything in free
  • +Consolidated + self-billed
  • +3 API keys per environment
  • +Email support, next working day
  Start on Build

• plan: scale

  RM 390per month

  250,000 requests included

  then RM 0.0025 per request

  • +Everything in build
  • +99.95% uptime SLA, credits if missed
  • +Two-region failover
  • +Slack channel, 2-hour reply 9am to 9pm
  Start on Scale

• Quickstart

  Send your first invoice from curl, Node or Python.

  5 min read

• API reference

  Every endpoint, field and response, generated from the OpenAPI spec.

  38 endpoints

• Error catalogue

  All 64 checks, why each one fails and what to change.

  64 codes

• Webhooks guide

  Signatures, retries, ordering and local testing with the CLI.

  12 min read

• Sandbox data

  Test TINs, BRNs and MSIC codes that fail on purpose.

  12 test TINs

• Moving from direct MyInvois

  Swap your own UBL builder for Sahkit one endpoint at a time.

  migration guide