Add Invoice Line
Module · Stable
Add a line to a DRAFT invoice — from the catalog, or a bespoke one.
Adds one line to a draft. Give catalog_item_id and the unit, price, VAT rate and description are filled from the catalog — the authored price book resolved to the invoice’s currency. Give none and the line is bespoke: pass description, qty and unit_price yourself. Only a DRAFT accepts lines; an issued invoice is immutable and refuses.
When to use
Section titled “When to use”Use after Create invoice draft, once per line. Prefer a catalog item when one exists — the price and VAT rate then come from the book rather than from a guess.
When not to use
Section titled “When not to use”Not for changing an issued invoice: it is immutable by law and by schema. The remedy there is a credit note, which a person raises.
Inputs
Section titled “Inputs”Configured per use: invoice_id, catalog_item_id, description, qty, unit_price, uom_code, vat_rate_code.
Outputs
Section titled “Outputs”Auto-generated from the skill registry (load_skills()). Do not edit by hand.