fiskalizimi-utils

GitHub Square Software Fiscalization API integrations

Zero-dependency TypeScript utilities for Albanian fiscalization (Law 87/2019): NIPT/NUIS format validation, TVSH (VAT) math for Albania and Kosovo, and fiscal invoice totals with the per-rate VAT breakdown every fiscalized invoice must report.

Try it online — free tools

The same pure functions power these free calculators:

• Verifikues NIPT / NUIS — validate an Albanian tax ID
• Llogaritësi i TVSH-së — add or extract VAT
• Llogaritësi i faturës / fiskalizimit — invoice totals with per-rate VAT

Install

npm install github:square-al/fiskalizimi-utils

API

validateNipt(input) — format-level validation of a NIPT/NUIS (letter A–M + 8 digits + control letter). Normalizes case and separators, flags likely typos (e.g. O vs 0).

addVat(net, rate) / extractVat(gross, rate) — VAT math with bundled rate tables ALBANIA_VAT (20% / 6%) and KOSOVO_VAT (18% / 8%).

invoiceTotals(lines) — subtotal, total VAT and vatByRate, the per-rate base/VAT table a fiscalized invoice reports. Supports quantities and per-line discounts.

Shqip

Mjete TypeScript pa varësi për fiskalizimin shqiptar: verifikim i formatit të NIPT/NUIS, llogaritje TVSH-je dhe totalet e faturës me TVSH-në sipas normës. I njëjti kod që fuqizon llogaritësit tanë falas. Për integrime fiskalizimi: square.al/sq/program-fiskalizimi.

Who maintains this

Square Software — a software development company in Tirana shipping fiscalization integrations for POS, ERP and e-commerce systems across Albania, Kosovo and the EU. MIT licensed.