පෝලන්ත රජයේ e-ඉන්වොයිස් පද්ධතිය KSeF (Krajowy System e-Faktur) සඳහා JavaScript SDK එකක් නොමැති බව නිවේදනයක් විය. මෙය ව්යාපාරික සම්බන්ධතා වල අඩුපාඩුවක් බවට පත්වූ අතර, බ්රවුසරයේ සෘජුවම පරීක්ෂා කළ හැකි ලාබදායක විසඳුමක් අවශ්ය විය.
එකට ප්රතිචාරයක් ලෙස, පරිසරයක් තුළ Java, .NET SDK පමණක් ලබා දෙන අතර, JavaScript සඳහා කිසිඳු නිල උපකරණයක් නොමැතිව, එක් සංවර්ධකයෙක් තමම නිර්මාණය කළ ksef-invoice-validate නාමක npm පැකේජය නිකුත් කළේය. එය බ්රවුසරයේ ක්රියාත්මක වන, අන්තර්ජාල ඇමතුම් නොකරන, ශුන්ය-අනුබලිත (zero‑dependency) පුස්තකාලයක් වන අතර, ඉන්වොයිස් ව්යුහය, NIP (පෝලන්ත බදු අංක) පරීක්ෂාව, මුදල් ගණනය, දිනයේ සත්යතාවය වැනි වැදගත් තත්ව පරීක්ෂා කරයි.
මෙම පරීක්ෂණ ලේයරය ඉදිරිපත් කිරීමේදී, ඉන්වොයිස් අංක, නිකුත් දිනය, විකුණුම්කරු සහ මිලදී ගන්නා NIP අංක, නෙට්, VAT, ග්රෝස් මුදල් වැනි සියලු තොරතුරු සකස් කර, validateInvoiceForKsef ෆන්ක්ශන් එකට ලබා දීමෙන් පසු, වැරදි හෝ අසත්ය තොරතුරු ඇතුළත් නම් විශේෂ කේත (error code) සමඟ පිළිතුරු ලැබේ.
කේතය තුළ විශේෂයෙන් වැදගත් වූ දෙකක් නම් NIP checksum පරීක්ෂාව සහ මුදල් ගණනයේ floating‑point ගැටලුව විසඳීමය. NIP අංකයේ දශම අංකය mod‑11 පරීක්ෂාවෙන් තහවුරු කරයි; checksum 10 නම් එය අස්ථානීය බව ස්වයංක්රීයව අසත්ය වේ. මුදල් ගණනයේදී, පොලන්තයේ ග්රෝස් (grosze) ලෙස පූර්ණ සංඛ්යාත්මක අගයන් භාවිතා කර, 0.01 වැනි IEEE‑754 දෝෂය තවත් නොපෙනේ.
ශ්රී ලංකාවට ඇති වැදගත්කම
- ස්ථානික සංවර්ධකයින්ට JavaScript‑මත පදනම් වූ API validation ලේයරයක් ඉක්මනින් එකතු කර, අන්තර්ජාල API පරීක්ෂා කිරීමට පෙර දෝෂ හඳුනා ගත හැක.
- පොලන්ත වැනි EU රටවල නීතිමය ඉන්වොයිස් අවශ්යතා සමඟ සම්බන්ධ වීමට අදහස් කරන ශ්රී ලංකා ආයතන, මෙම පුස්තකාලය භාවිතා කර ගැටලු අඩු කර, ඉක්මනින් අනුකූලතා පරීක්ෂා කර ගත හැක.
- ඉන්වොයිස් validation ක්රියාකාරකම් open‑source ලෙස ලබා ගැනීම, දේශීය තාක්ෂණික ප්රජාවට නවතම best‑practice හුවමාරු කරයි.
අවසන් වශයෙන්, ksef-invoice-validate නවතම JavaScript SDK හි පරීක්ෂා ක්රමයක් ලෙස, පෝලන්තයේ e‑ඉන්වොයිස් පද්ධතියේ අඩුපාඩු පිරවීමට සහ ලොව පුරා සංවර්ධකයන්ට මූලික validation layer එකක් ලබා දීමට උදව් කරයි. ඔබත් මේ පුස්තකාලය npm මගින් ස්ථාපනය කර, ඉන්වොයිස් දත්ත ගුණාත්මකත්වය තහවුරු කරගන්න.
