LacspaceLacspace Developer
← All packages

@lacspace/invoice

v1.0.0Commerce & Ledger0 deps

Invoice model, numbering and tax-rollup engine — per-line and total calculation, tax grouped by rate, sequential invoice numbers, payment tracking and a render-ready row structure for PDF/XLSX. Integer minor units, zero-dependency, isomorphic.

npm i @lacspace/invoice
View on npm ↗GitHub ↗

Usage

invoice.ts
import { createInvoice, recordPayment, invoiceNumber } from "@lacspace/invoice";

let inv = createInvoice({
  number: invoiceNumber(123),         // "INV-2026-000123"
  currency: "NPR",
  seller: { name: "Lacspace", taxId: "PAN123" },
  buyer:  { name: "Sita Rai" },
  lines: [{ description: "Dhaka Topi", qty: 2, unitPrice: 120000, taxRate: 0.13 }],
});
// inv.taxSummary groups tax by rate; inv.totals.balanceDue in integer paisa
inv = recordPayment(inv, 271200);     // status -> "paid", balanceDue -> 0

Exports 8

createInvoicerecordPaymentmarkVoidmarkIssuedisOverdueinvoiceNumberrenderRowsInvoiceError

Keywords

invoiceinvoicingbillingtaxaccountingecommerce

More in Commerce & Ledger

@lacspace/cart

Headless, framework-agnostic shopping-cart engine — pure, immutable & serializable. Add/merge lines, set quantities, compute tax/discount/shipping totals in integer minor units. Isomorphic (Node, edge, browser).

@lacspace/inventory

Stock-tracking engine that prevents overselling — reserve, release, commit & restock over a plain { onHand, reserved } state. Immutable, bring-your-own-store, throws before it oversells. Isomorphic.

@lacspace/commission

Commission & payout calculation engine — flat, percentage and marginal-tiered rules with min/cap, plus exact proportional split with remainder distribution. Integer minor units, zero floats. Isomorphic.

@lacspace/settlement

Settlement, netting & reconciliation for multi-party payouts — net signed ledger entries per account, reconcile expected vs actual, and list payable positive balances. Integer minor units, pure functions. Isomorphic.

@lacspace/coupon

Discount & coupon engine — percent, fixed and free-shipping codes with validity windows, minimum-subtotal, discount caps and usage limits. Integer minor units, no float drift. Zero-dependency, isomorphic.

@lacspace/tax

VAT & sales-tax done right — exact integer minor-unit arithmetic (no float cents bugs), add/extract tax, inclusive & exclusive prices, compound taxes, half-up/bankers rounding. Isomorphic.

← Browse all 80 packagesRead the handbook