# MyInvois 集成：门户、API 还是中间件

> 一套不偏袒任何供应商的方法，依交易量与你的 ERP 已经能做什么，在免费的 MyInvois Portal、直接 API 集成与技术供应商之间作选择。

- Category: taxation
- Language: zh
- Status: published
- Updated: 2026-07-20
- Canonical: https://negaraku.md/zh/taxation/myinvois-integration

---

关于这个决定所写的几乎每一样东西，都是由某个在卖其中一个答案的人写的。所以就从
LHDN 实际承认的仅有两种机制开始——载于 e-Invoice Guideline 的 Table 2.1：
**MyInvois Portal** 与 **API**。Peppol 供应商、非 Peppol 技术供应商与中间件不是
第三个选项——它们是通往 API 的三条路。

## 两种机制

| | MyInvois Portal | API |
| --- | --- | --- |
| 成本 | 免费，经 **MyTax** 登入 | 自建或授权 |
| 输入 | 逐笔表单，或**预设 Excel 表格的批量上传** | 依 **UBL 2.1** 的 XML 或 JSON |
| 签名 | 由 Portal 处理 | 你自己的**数码证书**（.cer 或 .pfx） |
| LHDN 所述适用对象 | 所有纳税人皆可使用；无法建立 API 连接的企业 | 高量；需要前期投资与系统改造 |
| 路径 | 一条 | 直接 ERP、**Peppol** 供应商、**非 Peppol** 供应商 |

两者产出的东西一样：一个 IRBM Unique Identifier Number、一个验证时间戳，以及可视
化呈现上的一个 QR 码。

## 采购之前先把问题的规模量出来

问题不在你的营业额。问题在**你每个月必须传输多少份文件**，而这个数目通常比人们
预期的大：

1. 应买方要求开出的交易性电子发票
2. 合并电子发票——每月一份或多份，如果你按分行拆分则按分行计
3. **自开电子发票**——佣金、外国供应商、个人业主、多数利息、股息、资本偿还
4. 贷记、借记与退款单据

然后套上那两项会打碎粗略估算的排除。自 2026 年 1 月 1 日起，任何**超过 RM10,000
的单笔交易**都必须是交易性的，所有行业皆然。而 e-Invoice Specific Guideline 的
Table 3.6 中有九项活动完全不能综合——汽车、机票、建筑合约、代理与经销商付款、
博彩派彩、电力、电信。

一家每月卖三辆车的车厂，Portal 的工作量微不足道。一家有 4,000 名后付费用户的电信
转售商则不然，而且再怎么综合也帮不了它。

**自开发票量通常才是那个意外。** 一家每月开 40 张销售发票、却有 600 笔代理佣金
付款的公司，是一家高量的电子发票企业，不管它的销售账簿怎么说。

## Portal 真正跑不动的地方

- **数据输入成本。** 每一份交易性文件都需要键入或以表格载入买方姓名、TIN、
  注册号码、地址、联络电话与 SST 号码。
- **72 小时时钟。** 取消与拒绝的窗口自验证时起算。每周才提交一次的人工流程用不了
  它们。
- **月底集中。** 合并电子发票须在月底后**七个日历日**内呈交，而这是在其他一切
  之上的。
- **对账。** Portal 给你 XML、JSON、元数据、表格与 PDF 检索——但把已验证文件对回
  你的账簿是人工活。

## API 花的钱比授权费多的地方

- **数码证书**必须取得、安装并轮换。
- **提交限制是硬性的：** 每次提交 100 份文件、5MB，每份文件 300KB。分批以及必要时
  的最小化，是你自己的问题。
- **两阶段验证。** *已提交*不等于*有效*。结构、核心字段与代码会即时检查；签名、
  纳税人、被引用文件与重复项则在后台检查。任何把 202 式确认当成成功的集成，都会
  悄悄累积无效文件。
- **令牌处理。** 登入令牌有效期 60 分钟，本意是重复使用，不是每次请求都新铸一个。
  速率限制会回传 429 并带上 `Retry-After` 标头。
- **主数据。** 供应商与买方的 TIN、新的 12 位 BRN、MSIC 代码与 SST 号码，都必须在
  这一切跑起来之前就是对的。

## 选一条通往 API 的路

| 路径 | 适合 | 要留意 |
| --- | --- | --- |
| **直接 ERP 集成** | 有维护中的马来西亚本地化的成熟 ERP，或有内部工程能力 | 指引版本变动时的持续维护——v4.7 与 v4.8 都在 2026 年 7 月 7 日落地 |
| **Peppol 服务供应商** | 同时想与贸易伙伴进行可互通文件交换的企业 | Peppol 不是 MyInvois 的要求；别当它是要求那样付钱 |
| **非 Peppol 技术供应商／中间件** | 多个来源系统、POS 网点群，或没有本地化的 ERP | 数据保管权、退出条款，以及它们是否以自己的凭证提交 |

LHDN 不背书、不认证、不核准任何供应商。如果有供应商声称获得 LHDN 核准，请他拿
出来看。

## 没人问的中介问题

SDK 载明，中介以**它们自己的 Client ID 与 Client Secret** 提交，而且只能存取
**它们自己**提交的电子发票——它们无法调取纳税人自行提交的文件。

有两项后果值得写进合约：

- **更换供应商不会把你的提交历史带过去。** 请规划一段平行运行期，以及你自己的
  存档。
- **责任不会转移。** Income Tax Act 1967 的第 82C 条把义务放在纳税人身上；
  s.120(1)(d) 使违反构成罪行。供应商停机就是你的不合规。

关于停机，LHDN 提供一项救济。e-Invoice Guideline 第 2.5.4 节说，若 MyInvois
System 本身因维护或技术理由而停摆，而纳税人能证明其合规努力，总监会逐案评估，并
可能不采取任何行动。那涵盖的是 LHDN 的停机，不是你的供应商的。

## 一条决策路径

1. **你获豁免吗？** 年营业额低于 RM1,000,000，就到此为止。
2. **数一数每月文件**，涵盖以上四个类别。
3. **大约一百份以下、以综合为主？** Portal，配 Excel 批量上传。每年重新检视一次。
4. **数百至数千份、单一来源系统？** 问你的 ERP 供应商他们的 MyInvois 本地化涵盖
   什么——具体是自开类型 11 至 14，以及进口的附件字段。
5. **数千份，或多个来源系统，或一整片 POS 网点？** 中间件，选的时候看数据保管权与
   退出条款，而不是功能清单。
6. **无论选什么，在你的宽限期结束前把它端到端验证一遍**——第四阶段是 2027 年
   12 月 31 日，第一至三阶段则已经过去了。

## 常见错误

- **先买再数。** 文件数量，包括自开的，是这个决定的全部输入。
- **以为 Peppol 是强制的。** 它是三条 API 路径之一。
- **相信认证声称。** LHDN 没有公布任何核准供应商名单。
- **把验证当成同步的。** 七个验证器中有四个在后台运行。
- **跳过主数据清理。** 旧的 SSM 注册号码与过期的 TIN，无论集成做得多好都会在纳税人
  验证器上失败。
- **用干净数据测试。** 请拿外国供应商、没有 TIN 的个人、贷记单据与月底量来测，
  因为那才是会坏的地方。

## 下一步

把上个月的应付与应收拉出来，把每一行归类为交易性、综合或自开，然后数。那个数字
决定机制。接着拿字段清单对照你的主数据，因为清理几乎总是比集成花更久。

## Sources

- e-Invoice Guideline (Version 4.7) — sections 2.2 to 2.5 — https://www.hasil.gov.my/wp-content/uploads/IRBM-e-Invoice-Guideline.pdf (LHDN)
- MyInvois SDK — https://sdk.myinvois.hasil.gov.my/ (LHDN)
- MyInvois SDK — frequently asked questions — https://sdk.myinvois.hasil.gov.my/faq/ (LHDN)
- MyInvois SDK — standard error response — https://sdk.myinvois.hasil.gov.my/standard-error-response/ (LHDN)
- e-Invoice Specific Guideline (Version 4.8) — https://www.hasil.gov.my/wp-content/uploads/IRBM-e-Invoice-Specific-Guideline.pdf (LHDN)

---
Source of truth: https://github.com/negaraku-md/NegaraKu.md
License: CC BY-SA 4.0