MyInvois XML ke PDF — invois A4 untuk diserahkan

Apa yang halaman ini buat — dan apa yang tidak

Ia membaca fail XML e-Invois MyInvois (LHDN) UBL 2.1 dan menyusun halaman A4 yang kelihatan seperti invois yang diserahkan kedai kepada pelanggan. Ia perwakilan visual, bukan e-Invois itu sendiri. Panduan LHDN menyatakan e-Invois ialah dokumen XML atau JSON dan bukan PDF, JPG dan seumpamanya; PDF di sini untuk fail pelanggan, folder nota penghantaran, atau orang di kaunter yang mahu kertas.

• Tiada dakwaan pengesahan, dalam apa bahasa pun. Halaman ini tidak pernah menyatakan dokumen itu sah, diluluskan atau diterima LHDN, tidak mencetak lencana hijau, dan kaki setiap PDF menyatakan: “Perwakilan visual yang dijana dalam pelayar anda daripada XML pembekal. Bukan dokumen yang disahkan LHDN.”
• UUID tiada dalam fail. IRBM memberikan UUID dan pautan pengesahan apabila dokumen disahkan, dan memulangkannya sebagai metadata API. Ia bukan unsur XML, jadi halaman ini tidak boleh mencetaknya untuk anda — anda tampal sendiri, atau tiada dicetak.
• Tiada apa dimuat naik. XML dibaca dalam tab ini oleh JavaScript statik. Satu-satunya permintaan yang boleh dibuat halaman ialah untuk fail fon Cina sendiri, dan hanya apabila dokumen mengandungi aksara Cina.

Bagaimana XML dibaca

• Ikut ruang nama, bukan awalan. Pengeluar menulis cbc:, Cbc: atau inv: untuk ruang nama yang sama, jadi setiap unsur dipadankan melalui URI ruang nama dan nama tempatan. Blok UBLExtensions yang mengisytiharkan semula ruang nama lalai juga tidak boleh merampas medan: penyelesai mewarisi pengisytiharan ke bawah pokok, jadi unsur dalam blok itu memang bukan unsur UBL.
• Akar sentiasa Invoice. Kelapan-lapan jenis MyInvois — 01 invois, 02 nota kredit, 03 nota debit, 04 nota bayaran balik, dan 11–14 bil diri — berakar pada Invoice. Jenis dokumen datang daripada cbc:InvoiceTypeCode, bukan nama unsur. Fail berakar CreditNote ialah dokumen UBL lain dan ditolak dengan namanya.
• Nombor dijaga. Setiap jumlah dibaca sebagai nombor bulat sen. Sampel pertukaran asing rasmi LHDN sendiri membawa PayableAmount = abc; fail sebegitu ditolak dengan medan dan nilainya dinamakan, kerana PDF yang mencetak abc sebagai jumlah lebih buruk daripada tiada PDF.

Perangkap yang ditangani, setiap satu secara jelas

• Dua kod klasifikasi. Satu baris boleh membawa kod CLASS dan kod PTC; kod CLASS dicetak dan pratonton menyatakan kedua-duanya ada.
• Dua mata wang. Apabila cukai dinyatakan dalam mata wang cukai, kedua-dua angka dicetak dengan mata wang yang dinyatakan, dan kadar pertukaran dicetak seperti yang tertulis — tiada apa ditukar.
• Orang awam bukan pembeli. TIN EI00000000010 (“Consolidated Buyers”) ialah pemegang tempat LHDN untuk pelanggan walk-in. Ia dibaca dan dilabel sebagai pemegang tempat, bukan dicetak seolah-olah pembeli berdaftar.
• Bil diri 11–14. Pihak yang mengeluarkan dokumen ialah pembeli, jadi kedua-dua tajuk pihak bertukar dan menyatakan peranannya.
• Teks panjang. Perihalan 300 aksara, baris alamat 150 aksara, bandar 50 aksara: semuanya membalut dalam ruangnya, tidak melepasi margin, dan satu baris tidak pernah terbelah antara halaman.
• Fail rosak. Ralat menyatakan tag, baris dan lajur, bukan halaman kosong.

Kod QR, jika anda ada

Dua medan pilihan menerima UUID dan long ID yang dipulangkan MyInvois apabila dokumen disahkan. Dengan kedua-duanya, QR pautan kongsi LHDN dilukis pada PDF. Tanpa kedua-duanya, tiada QR dilukis — QR yang tidak membawa ke mana-mana lebih buruk daripada sudut kosong. UUID yang separuh ditaip ditolak dengan namanya, supaya anda tahu sebelum mencetak.

Logo anda, jika anda mahu

Gambar PNG, JPEG atau WebP boleh ditambah pada kepala surat: ia dicetak pada 120 × 30 pt (kira-kira 42 × 11 mm), mengekalkan kadarnya sendiri, dan ketelusannya dihormati dan bukan diratakan menjadi kotak kelabu. Ia diingati dalam pelayar ini sahaja — disimpan pada peranti ini, tidak pernah dimuat naik — supaya pelawat yang kembali tidak memuat naiknya semula untuk setiap invois. Satu kotak tanda membolehkannya ditinggalkan daripada PDF bagi pembeli yang memerlukan dokumen kosong, dan menyahpilihnya tidak mengubah pratonton. SVG ditolak dengan namanya: SVG ialah bekas untuk penanda dan skrip, bukan gambar. Tiada apa tentang invois itu sendiri disimpan, pada bila-bila masa.

Teks Cina

Dokumen dengan aksara Cina memuat turun subset fon 1.3 MB sekali (sekitar 705 KB di rangkaian) dan menyertakan seluruh fon, supaya aksara itu benar-benar dilukis dan bukan digugurkan secara senyap. Aksara yang tiada dalam subset ditolak dengan namanya. Dokumen Latin sahaja tidak memuat turun fon.