MyInvois XML 转 PDF——可以交给客户的 A4 发票

这个页面做什么，不做什么

它读取 MyInvois（LHDN）的 UBL 2.1 电子发票 XML，排出一页 A4，看起来就像商家交给客户的那张发票。这只是版面呈现，不是电子发票本身。LHDN 的说明是：电子发票是 XML 或 JSON 文件，不是 PDF、JPG 之类的格式；这里的 PDF 是给客户存档、放进送货单资料夹，或者给柜台那位要纸的人看的。

• 任何语言都不声称「已验证」。本页从不说文件有效、已获批准或已被 LHDN 接受，不印绿色标记，每份 PDF 的页脚都写着：「本页由浏览器根据供应商的 XML 生成，只是版面呈现，不是经 LHDN 验证的文件。」
• UUID 不在文件里。IRBM 在验证文件时才发出 UUID 和验证链接，并以 API 元数据的形式返回。它们不是 XML 的元素，所以本页没法替你印出来——你自己粘贴，或者干脆不印。
• 不上传任何东西。XML 由静态 JavaScript 在这个标签页里读取。页面唯一可能发出的请求是它自己的中文字体文件，而且只有文件里出现汉字时才会发出。

XML 是怎么读的

• 按命名空间读，不按前缀。开票方会写 cbc:、Cbc: 或 inv: 来表示同一个命名空间，所以每个元素都按命名空间 URI 加本地名匹配。就算 UBLExtensions 里重新声明了默认命名空间也抢不走字段：解析器沿树继承声明，那块里的元素根本不是 UBL 元素。
• 根元素永远是 Invoice。MyInvois 的八种类型——01 发票、02 贷项通知单、03 借项通知单、04 退款通知单，以及 11–14 的自开类型——根元素都是 Invoice。单据类型来自 cbc:InvoiceTypeCode，不是元素名。根元素是 CreditNote 的文件属于另一种 UBL 文档，会被指名拒绝。
• 数字先过关。每个金额都按「分」的整数读取。LHDN 自己公布的汇率样例里，PayableAmount 写的是 abc；这种文件会被拒绝，并说出是哪个字段、什么值——印一个 abc 当合计，比不生成 PDF 更糟。

这些坑都处理了，而且看得见

• 两个分类代码。一行明细可能同时带 CLASS 和 PTC 代码；印的是 CLASS 那个，预览里会说明两个都存在。
• 两种货币。税额用税务货币表示时，两个数字都印出来，各自带上文件写的货币；汇率照原文印出，不做任何换算。
• 公众不是买家。TIN EI00000000010（「合并买家」）是 LHDN 给散客的占位号码，会照读并注明是占位，而不是当成已登记买家印出去。
• 自开 11–14。开出这份文件的一方就是买家，所以两栏标题互换，并写明各自是谁。
• 超长文字。300 字的说明、150 字的地址行、50 字的城市：都在自己的栏里换行，不会越出页边，一行明细也不会被拆到两页。
• 文件损坏。错误会说出标签、行号和列号，而不是给你一页空白。

二维码，有才画

两个选填字段接收 MyInvois 在验证通过时返回的 UUID 和 long ID。两个都填了，PDF 上会画出 LHDN 分享链接的二维码；两个都没填，就完全不画——一个扫了什么都不到的二维码，比空着一角更糟。UUID 格式不对会被指名拒绝，让你在打印之前就知道。

标志，想加就加

可以给页眉加一张 PNG、JPEG 或 WebP 图片：按 120 × 30 pt（约 42 × 11 毫米）印出，保持原比例，透明部分照样透明，不会被压成一块灰底。它只记在这个浏览器里——存在本机，从不上传——所以下次回来不用每张发票都重新上传。一个勾选框可以让它不出现在 PDF 里，给那些要求干净文件的买家；取消勾选不会改变上方的预览。SVG 会被指名拒绝：SVG 是存放标记和脚本的容器，不是图片。发票本身的内容，任何时候都不会被存储。

中文内容

文件里出现汉字时，会下载一次 1.3 MB 的字体子集（实际传输约 705 KB），并把整个字体内嵌进去，保证汉字真的画出来而不是被悄悄丢掉。子集里没有的字会被指名拒绝。纯拉丁文的文件完全不下载字体。