电子发票数据栏位速查

每一次提交被拒，追究起来不外乎两件事：某个 LHDN 视为必填、而你的 ERP 视为选填的 栏位，或者某个不在 LHDN 清单里的代码值。本页就是那份栏位清单，取自 e-Invoice Guideline 4.7 版的 Appendix 1 与 Appendix 2。

格式为 XML 或 JSON，两者皆须符合 UBL 2.1。LHDN 把这 55 个栏位分为八个 类别：Address、Business Details、Contact Number、Invoice Details、Parties、 Party Details、Payment Info，以及 Products / Services。

55 个栏位

M = 必填 · C = 有条件必填 · O = 选填

各方与各方细节

#	栏位	状态	备注
1	供应商名称	M
2	买方名称	M	合并电子发票上填 General Public
3	供应商 TIN	M	无法取得时适用通用 TIN 代码
4	供应商注册／识别／护照号码	M	在 SSM 注册者只用新的 12 字符 BRN
5	供应商 SST 注册号码	C	已注册 SST 者必填
6	供应商旅游税注册号码	C	已注册旅游税者必填
7	供应商电邮	O
8	供应商 MSIC 代码	M	5 位数字；外国供应商无从取得时填 00000
9	供应商商业活动描述	M
10	买方 TIN	M
11	买方注册／识别／护照号码	M
12	买方 SST 注册号码	C	已注册 SST 者必填
13	买方电邮	O

地址与联络

#	栏位	状态
14	供应商地址	M
15	买方地址	M
16	供应商联络电话	M
17	买方联络电话	M

发票细节

#	栏位	状态	备注
18	电子发票版本	M	SVDP 1.2 / 1.3 仅供自愿披露使用
19	电子发票类型	M	见下方代码清单
20	电子发票代码／号码	M	供应商自己的参考编号
21	原电子发票参考编号	C	贷记单、借记单与退款单必填
22	电子发票日期与时间	M	必须是当下的日期与时间
23	开票方数字签署	M	若有使用服务商，则为服务商的证书
24	发票货币代码	M
25	货币汇率	C	货币非令吉时必填
26	开单频率	O
27	开单期间	O

产品与服务

#	栏位	状态	备注
28	分类	M	取自 LHDN 目录的 3 位代码
29	产品或服务描述	M	合并电子发票上填收据参考编号
30	单价	M
31	税种	M	行层级与发票层级
32	税率	C
33	税额	M	行层级与发票层级
34	免税细节	C	若有免税适用则必填
35	获免税金额	C	若有免税适用则必填
36	小计	M	仅行层级
37	不含税总额	M	行层级与发票层级
38	含税总额	M	仅发票层级
39	净额总计	O	仅发票层级
40	应付总额	M	仅发票层级
41	进位调整金额	O	仅发票层级
42	按税种分列的应税总额	O	仅发票层级
43	数量	O
44	计量	O
45	折扣率	O
46	折扣金额	O
47	费用／收费率	O
48	费用／收费金额	O

付款资讯

#	栏位	状态
49	付款方式	O
50	供应商银行账户号码	O
51	付款条款	O
52	预付金额	O
53	预付日期	O
54	预付参考编号	O
55	账单参考编号	O

附录栏位

栏位	状态	适用于
Customs Form No. 1、9 等的参考编号	必填	货物进口
Customs Form No. 2 的参考编号	选填	货物出口
收货方名称／地址／TIN／注册或护照号码	选填	货物寄送给买方以外的人
Incoterms	选填	货物进口与出口
产品税则代码	选填	仅限货物
自由贸易协定资料	选填	仅限出口，若适用
认证出口商授权号码，例如 ATIGA 号码	选填	仅限出口，若适用
原产国	选填	货物进口与出口
其他收费细节	选填	货物进口与出口

LHDN 指出，附录的要求可能不时更新。

代码清单

电子发票类型

代码	类型		代码	类型
01	Invoice		11	Self-billed Invoice
02	Credit Note		12	Self-billed Credit Note
03	Debit Note		13	Self-billed Debit Note
04	Refund Note		14	Self-billed Refund Note

税种

代码	类型
01	销售税
02	服务税
03	旅游税
04	高价值货物税
05	低价值货物销售税
06	不适用
E	免税（若适用）

通用 TIN（e-Invoice Specific Guideline, Appendix 1）

代码	用途
EI00000000010	General Public——仅持 MyKad 的马来西亚个人；合并电子发票上的买方；汇总自开电子发票上的供应商
EI00000000020	外国买方或外国收货方
EI00000000030	外国供应商，自开发票
EI00000000040	政府、州与地方政府、法定机构、获豁免机构

SDK 另外也发布分类代码、国家代码、货币代码、MSIC 代码、付款方式、州属代码与 计量单位。

验证器，以及什么会触发它们

验证器	时机	常见失败原因
Structure	即时	XML 或 JSON 格式不正确，或文件不符合 UBL 2.1 之下该类型与版本所要求的结构
Core Fields	即时	某个必填栏位缺失
Code	即时与后台	某个货币、税种或其他代码值不在 LHDN 的清单里
Signature	后台	数字签署验证失败
Taxpayer	后台	文件中引用的某个 TIN 在该文件开具日期当日并非有效
Referenced Documents	后台	贷记单、借记单或退款单所指向的文件，在开具当时并非一张有效的电子发票
Duplicate Document	后台	几乎一模一样的文件已经提交过——错误代码 DS302

文件状态的流转是 Submitted → Valid 或 Invalid。Submitted 只代表结构 与核心栏位检查过关；后台验证器仍然可能把它判为失败。

传输层错误采用标准 HTTP 对应：BadRequest 与 BadArgument（400）、 Unauthorized（401）、Forbidden（403）、NotFound（404）、 TooManyRequests（429，附 Retry-After 标头）、InternalServerError（500）、 NotImplemented（501）、ServiceUnavailable（503）。

更正一份有问题的文件

• 验证后 72 小时内——供应商可以取消，或者买方可以请求拒收、再由供应商取消。 超过 72 小时，两者都办不到。
• 在开出有瑕疵的电子发票后三天内——Income Tax Act 1967 s.82C(8) 容许开出 一张替代电子发票。
• 在那之后——开出贷记单、借记单或退款单电子发票，在栏位 21 引用原发票。

常见错误

• 送出旧的 SSM 注册号码。 栏位 4 要求在 SSM 注册者使用新的 12 位 BRN。
• 把栏位 22 倒填日期。 LHDN 要求当下的日期与时间；倒填日期的文件会失败。
• 外国供应商的 MSIC 留空。 用 00000，不要留空值。
• 拿税种 06 当免税用。 06 是不适用；免税是 E，而且它会把栏位 34 与 35 变成必填。
• 原封不动地重送一次失败的提交。 重复文件验证器会抛出 DS302，不会接受它。
• 把 Submitted 回应当成成功。 只有 Valid 才是成功。

下一步

在写任何代码之前，先把栏位 3、4、5、8、10、11 与 12 对照你的客户与供应商主档 数据比一遍——清理时间实际上都花在这七个上面。然后再决定传输路线，因为 Portal 会以表单形式帮你填这些栏位，而 API 会把它们变成你自己的问题。