Invoices Field Reference
Exact invoice fields, statuses, line item types, payments, write-offs, settings, and reminder proposal fields.
Invoices Field Reference
Use this reference when creating, updating, approving, sending reminders for, or searching invoices.
Required Fields
| Field | Type | Notes |
|---|---|---|
| Account | Account select | Required. |
| Number | Text | Required. Maximum 100 characters. |
| Currency | Currency code | Required 3-letter code. |
Common Fields
| Field | Type | Notes |
|---|---|---|
| Project | Project select | Optional. |
| Issue date | Date | Optional. |
| Due date | Date | Optional. |
| Payment terms | Text | Optional. Maximum 100 characters. |
| Exchange rate | Decimal text | Optional override. |
| Notes | Textarea | Optional. Maximum 5000 characters. |
| Billing contact | Contact select | Optional. Should belong to invoice account. |
| From address | Address select | Optional. |
| Bill-to address | Address select | Optional. |
| Billing period start | Date | Optional. |
| Billing period end | Date | Optional. |
| Line items | Line item list | Optional on create. |
| Custom fields | Custom fields | Depends on organization configuration. |
Invoice Status Values
draftin_reviewapprovedsentpartially_paidpaidwritten_offvoidedoverdue
Line Item Source Types
timeexpensemilestonefixed_feeretainermanualsubscription_feesupport_overage
Line item fields include source type, description, quantity, unit price, tax code, time entry, expense entry, milestone, and order index.
Payment Methods
bank_transfercredit_cardchequeother
Payment fields include amount, currency, received date, method, reference, and exchange rate.
Line Item Time Period Values
last_7_dayslast_15_dayslast_30_daysall_uninvoiced
Line Item Grouping Values
taskphaseprojectmemberroledetailed
Tax Display Modes
genericby_codeby_componentby_code_nonzeroby_component_nonzero
Lifecycle Actions
| Action | Required field |
|---|---|
| Submit for review | Optional note and approver. |
| Void invoice | Reason is required. |
| Record payment | Amount, currency, received date, method. |
| Write off | Reason is required; amount optional. |
Invoice Reminder Proposal Fields
For Copilot invoice reminder drafts, use:
- Invoice select, labelled by invoice number.
- Recipient select from contacts on the invoice account.
- Due date from invoice due date when available.
- Message textarea.
Do not show invoice UUIDs as labels when invoice number exists.