获取 MyInvois Client ID 和 Secret
MyInvois 门户分步指南:首次登录、登记 ERP 系统,以及获取电子发票应用所需的 Client ID 和 Client Secret。
任何代您向内陆税收局(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 门户
- 用董事的账户登录 MyTax。
- 点击菜单中的 MyInvois。
- 阅读并接受条款与条件,然后点击 Continue。
- 填写 Taxpayer profile(纳税人资料)和 User profile(用户资料)。请仔细核对每一项资料,因为它们会显示在您的电子发票上。
两份资料都保存后,会出现确认页面。
第 2 步:登记 ERP 系统
- 在 MyInvois 门户中,打开右上角的资料菜单,选择 View Taxpayer Profile。
- 向下滚动到 Representatives,打开 ERP 标签。
- 点击 Register ERP 并填写:
- ERP Name: 容易辨认的名称,例如 “E-invoice API”
- Client Secret Expiration: 由您选择(见下文)
- 勾选 Primary ERP System
- 点击 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 同一时间只在一个地方有效,所以重新生成后,另一个应用保存的那一份就会失效。