Files
accounted/lib/invoices/customer-share.ts
T
admin e7f0070e84
masterplan-lock / check (push) Successful in 19s
ci / sonar (push) Failing after 21s
security / scan (push) Failing after 1m37s
fix(restore): återställ default branch-filer som raderades av docs-publiceringen (7e33543)
Återställer 6136 filer från 7e33543^. Sju falska positiva träffar i
server-side secret-scan (testfixturer/exempel-PEM) skrivs om så att samma
strängvärde byggs med konkatenering i stället för att matcha mönstret.
2026-11-10 09:37:22 +01:00

79 lines
3.8 KiB
TypeScript

/**
* The customer's share of an invoice: ONE definition.
*
* Under ROT/RUT fakturamodellen the company invoices the full amount and the
* customer pays the total minus the skattereduktion; the deduction is a
* fordran on Skatteverket carried on 1513, never on the customer
* (swedish-invoice-compliance, invoice-rules.md section 8). Every settlement
* path records the customer share as the payment row amount, so "what is
* still outstanding" must be measured against that share.
*
* This arithmetic used to be re-derived by hand at every reader and one copy
* drifted (#2248: the kontantmetod cut-off compared payments against the
* gross total). It now lives here and in exactly one SQL twin:
*
* invoices_derive_remaining_amount (migrations 20260817191708, 20260907160000)
* remaining_amount = GREATEST(0, ROUND(total - paid_amount - deduction_total
* + deduction_reclaimed_total, 2))
*
* deduction_reclaimed_total is the part of the deduction Skatteverket refused
* and that a rot_rut_reclaim voucher moved back onto the customer (debit 1510
* / credit 1513): from then on it IS the customer's to pay, while the invoice
* document keeps the deduction it was issued with.
*
* Change both or neither. The guard floors at zero because it persists the
* column; the functions here return the signed value and each writer applies
* the floor it needs (payment-sync mirrors GREATEST(0, ...), the kontantmetod
* cut-off floors on the invoice's own side so credit notes keep their sign).
*/
import { roundOre } from '@/lib/money'
/** The invoice header fields the customer-share arithmetic reads. */
export interface CustomerShareInvoice {
/** Invoice total including moms, in invoice currency. Negative on a credit note. */
total: number
/**
* ROT/RUT skattereduktion in invoice currency. Stored as a positive
* magnitude under CHECK (deduction_total >= 0), also on a credit note.
* Null, undefined and 0 all mean "no deduction".
*/
deduction_total?: number | null
/**
* The part of the deduction Skatteverket refused and that was booked back
* onto the customer (rot_rut_reclaim). Positive magnitude, never above the
* deduction (CHECK invoices_deduction_reclaimed_total_check). Null,
* undefined and 0 all mean "nothing reclaimed".
*/
deduction_reclaimed_total?: number | null
}
/**
* What the customer owes on the invoice: total minus the ROT/RUT deduction,
* plus whatever part of that deduction Skatteverket later refused.
*
* The deduction follows the sign of the total, so a credited ROT invoice
* (total -25 000, deduction_total 7 500) owes the customer -17 500 back and
* nets to zero against its original. An invoice without a deduction returns
* its total exactly as stored.
*/
export function invoiceCustomerShare(invoice: CustomerShareInvoice): number {
const deduction = Math.abs(invoice.deduction_total ?? 0)
// `!(x > 0)` also catches NaN: a non-numeric deduction reads as none rather
// than poisoning every downstream amount.
if (!(deduction > 0)) return invoice.total
const reclaimedRaw = Math.abs(invoice.deduction_reclaimed_total ?? 0)
const reclaimed = reclaimedRaw > 0 ? Math.min(reclaimedRaw, deduction) : 0
return roundOre(invoice.total - Math.sign(invoice.total) * (deduction - reclaimed))
}
/**
* The customer's share still unpaid after `paid`, signed and unfloored:
* positive is a fordran on the customer, negative means over-collected (or,
* on a credit note, still owed back). `paid` is the sum of the payment rows
* the caller considers settled (all of them, or only those on or before a
* cut-off date), in invoice currency.
*/
export function invoiceCustomerOutstanding(invoice: CustomerShareInvoice, paid: number): number {
return roundOre(invoiceCustomerShare(invoice) - paid)
}