Changelog #

0.3.1 #

Correzione: l'ultima tranche di un reso su merce a peso veniva rifiutata. Le quantità sono num, e tre resi da 0,1 su una riga da 0,3 sommano a 0,30000000000000004: il residuo diventava 0.09999999999999998 e ExcessiveReturnError scattava su un reso legittimo. I confronti fra quantità ora ammettono una tolleranza relativa di 1e-9, e remainingQuantity restituisce zero invece del pulviscolo lasciato dalle sottrazioni fra double.
Sette test di proprietà su scontrini generati, in test/properties, con generazione e semplificazione dei controesempi scritte a mano: glados non è compatibile con Dart 3. Sono loro ad aver trovato il difetto qui sopra, e a essersi ridotti da soli a «un centesimo, tre etti».
Dichiarato un limite che prima non era scritto: l'imposta stornata da più documenti di reso può scostarsi di qualche centesimo da quella incassata, perché ogni documento scorpora sui propri importi. Il denaro rimborsato resta invece sempre esatto. ARCHITECTURE.md spiega perché non va corretto.

Modifiche non compatibili: le aliquote predefinite cambiano nome. VatRate.ordinaria, ridotta, superRidotta ed esente diventano standard, reduced, superReduced ed exempt. Sono gli stessi termini usati dalle direttive europee sull'IVA, e allineano l'API pubblica al resto del pacchetto, che era già in inglese. Le etichette leggibili — Ordinaria, Ridotta, Super ridotta, Esente — non cambiano: restano il testo che finisce sullo scontrino.
Il resto del rinominio riguarda i test e l'esempio, e non tocca l'API.

Prima versione pubblicata su pub.dev.

Storni e resi. ReturnReceipt e ReturnBuilder: documento di reso collegato allo scontrino originale, totale o parziale, con riepilogo IVA a segno invertito e controllo che non si renda più di quanto venduto — resi precedenti compresi.
Receipt.netLineTotals: il totale effettivo di ciascuna riga, dopo la ripartizione dello sconto di documento. È la base di ogni rimborso.
Lo sconto di documento si ripartisce una volta sola, sulle righe, e il riepilogo per aliquota ne discende: prima erano due ripartizioni distinte che potevano differire di un centesimo.
VatSummaryCalculator.summarize accetta coppie (aliquota, importo) e funziona su importi negativi, così il reso riusa il calcolo invece di duplicarlo.
Modifiche non compatibili: DiscountAllocator.allocate prende amounts al posto di grossByRate; Receipt richiede netLineTotals.
Preparazione alla pubblicazione: documentazione dartdoc su tutta l'API pubblica, topics e issue_tracker nel pubspec, lints e test aggiornati all'ultima versione. La pipeline misura il punteggio di pub.dev a ogni push e fallisce sotto 130 su 160.