Create a draft invoice
freeagent_create_draft_invoiceDestructive
Create a sales invoice in DRAFT status. Nothing is sent to the customer and nothing is posted as income until it is marked sent in FreeAgent; a draft can be edited or discarded there. FreeAgent: POST /v2/invoices.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| due_on | No | Explicit due date, if not derived from payment terms (YYYY-MM-DD). | |
| contact | Yes | The contact being invoiced's numeric id or full FreeAgent URL. | |
| project | No | The project's numeric id or full FreeAgent URL. | |
| comments | No | Comments printed on the invoice. | |
| currency | No | ISO currency code, e.g. GBP (defaults to the company currency). | |
| dated_on | Yes | Invoice date (YYYY-MM-DD). | |
| reference | No | Invoice reference/number; omit to use the next in sequence. | |
| po_reference | No | The customer's purchase-order reference. | |
| exchange_rate | No | Exchange rate for a foreign-currency invoice. | |
| invoice_items | Yes | The invoice lines. | |
| discount_percent | No | Whole-invoice discount percentage. | |
| payment_terms_in_days | Yes | Payment terms in days; 0 = due on receipt. |