任何代您向内陆税收局(LHDN)提交电子发票(e-Invoice)的应用程序,都需要从 MyInvois 门户取得两项凭证:Client ID 和 Client Secret。方法是把该应用登记为 ERP System Representative。整个过程大约十分钟,也是大多数网店最容易卡住的一步。

开始之前

  • 您需要董事的 MyTax 登录账户,也就是贵公司用来报税的账户。
  • 系统有两个独立的环境:
    • Live: mytax.hasil.gov.my,用于正式发票
    • Staging: preprod-mytax.hasil.gov.my,用于测试
  • 同一个登录账户在两个环境都能用,但凭证不通用。以下步骤您需要在 Staging 做一次,在 Live 再做一次。

第 1 步:首次登录 MyInvois 门户

  1. 用董事的账户登录 MyTax。
  2. 点击菜单中的 MyInvois。
  3. 阅读并接受条款与条件,然后点击 Continue。
  4. 填写 Taxpayer profile(纳税人资料)和 User profile(用户资料)。请仔细核对每一项资料,因为它们会显示在您的电子发票上。

两份资料都保存后,会出现确认页面。

第 2 步:登记 ERP 系统

  1. 在 MyInvois 门户中,打开右上角的资料菜单,选择 View Taxpayer Profile。
  2. 向下滚动到 Representatives,打开 ERP 标签。
  3. 点击 Register ERP 并填写:
    • ERP Name: 容易辨认的名称,例如 “E-invoice API”
    • Client Secret Expiration: 由您选择(见下文)
    • 勾选 Primary ERP System
  4. 点击 Register。

第 3 步:复制 Client ID 和 Client Secret

门户只会显示一次 Client ID 和 Client Secret。请把两者复制到密码管理器中,勾选确认已复制的方框,然后点击 Done。接着把它们贴到电子发票应用的设置页面。

避免中断的三条规则

1. 把到期日记在日历上。 Client Secret 到期后,提交会停止,直到您生成新的 Client Secret 并更新应用为止。请设定提前一周的提醒。

2. 每个应用使用一组凭证。 不要在第二个系统里重复使用同一组 Client ID 和 Client Secret。如果您的会计软件也需要提交电子发票,请为它另外登记一个 ERP 系统。

3. 绝对不要重新生成其他应用正在使用的 Secret。 Client Secret 同一时间只在一个地方有效。一旦您重新生成,电子发票应用里保存的那一份就会立即失效,用它提交的电子发票,包括顾客已经索取的,都会受到影响。

先用 Staging,再转 Live

用 Staging 凭证跑几笔测试订单,走完整个流程:顾客索取、填写表格和 LHDN 验证。在预生产门户中核对结果。一切正常后,再生成 Live 凭证,并把应用切换到 Live。

检查清单

步骤 完成标准
首次登录 纳税人资料和用户资料已保存
登记 ERP ERP 系统已列在 Representatives 下
复制凭证 Client ID 和 Secret 已妥善保存
Staging 测试 测试电子发票已在预生产门户通过验证
正式上线 已输入 Live 凭证,环境已设为 Live
提醒 Secret 到期前已有日历提醒

取得凭证后,就可以通过我们的电子发票集成连接您的网店,或查看完整的网店电子发票检查清单。

常见问题

如何获取 MyInvois Client ID 和 Client Secret?

用董事的 MyTax 账户登录 MyInvois 门户,打开 View Taxpayer Profile,然后在 Representatives 下的 ERP 标签中点击 Register ERP。门户随即会显示这两项凭证。整个过程大约十分钟。

MyInvois 会显示 Client Secret 超过一次吗?

不会。门户只显示一次 Client ID 和 Client Secret,所以在点击 Done 之前,请先把两者复制到密码管理器中。

Staging 和 Live 使用相同的凭证吗?

不是。同一个 MyTax 登录账户在两个环境都能用,但凭证不通用。请在 Staging 和 Live 各登记一次 ERP 系统。

MyInvois Client Secret 到期后会怎样?

提交会停止,直到您生成新的 Client Secret 并更新应用为止。请在到期日前一周设定日历提醒。

一组 Client ID 和 Client Secret 可以用在两个系统吗?

不可以。请为每个应用另外登记一个 ERP 系统。Client Secret 同一时间只在一个地方有效,所以重新生成后,另一个应用保存的那一份就会失效。