Quotes & invoicing
Quotes & invoicing
Quotes
A Quote is the confirmable consequence-preview: net, tax, gross, credit applied,
and amount due now. QuoteBuilder composes cboxdk/laravel-tax (seller-of-record
routing + per-line tax) and wallet credit into it:
interface QuoteBuilder
{
public function build(array $lines, QuoteContext $context): Quote;
}
Tax resolution is progressive: an unresolved jurisdiction returns a
tax-pending quote (QuoteStatus, TaxResolution) — never a wrong number. Line
amounts are rounded per line, consistent with the settlement gateway, so a quote
shown at confirm matches the charge (the preview-equals-charge
discipline).
Quantities and units
A line's $quantity is a Quantity: a positive decimal with up to three places, such as 12.5 tonnes or 0.950 hours. LineInput still accepts a plain int for this release and turns it into a Quantity; pass a Quantity going forward. An optional unit (at most 12 characters, for example t or h) travels with the line onto the quote, the invoice and any credit note.
A line is rounded once, half up, to the currency's minor unit, so a quote shown at confirm equals the charge.
| Case | Result |
|---|---|
0.950 × 120000 DKK |
114000 |
1.125 × 100000 DKK |
112500 |
0.333 × 10000 DKK |
3330 |
2.5 × 333 DKK |
833 (832.5 rounds half up) |
Invoicing
Invoicer fixes a confirmed quote to a legal invoice:
interface Invoicer
{
public function issue(Quote $quote, SellerEntity $seller, string $account, DateTimeImmutable $at): Invoice;
}
DefaultInvoicer:
- Refuses a tax-pending quote (
CannotInvoicePendingQuote) — you cannot issue a legal document with an unresolved number. - Draws the invoice number from a per-seller
InvoiceNumberSequence(next(SellerEntity)), which is monotonic and gapless per seller — each seller of record keeps its own legal series. - Stamps and guards the account's billing currency so the first finalized invoice locks the currency.
Credit notes
A CreditNote reverses invoiced value and draws from its own per-seller
CreditNoteNumberSequence, kept as a separate gapless series.