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

FieldTypeNotes
AccountAccount selectRequired.
NumberTextRequired. Maximum 100 characters.
CurrencyCurrency codeRequired 3-letter code.

Common Fields

FieldTypeNotes
ProjectProject selectOptional.
Issue dateDateOptional.
Due dateDateOptional.
Payment termsTextOptional. Maximum 100 characters.
Exchange rateDecimal textOptional override.
NotesTextareaOptional. Maximum 5000 characters.
Billing contactContact selectOptional. Should belong to invoice account.
From addressAddress selectOptional.
Bill-to addressAddress selectOptional.
Billing period startDateOptional.
Billing period endDateOptional.
Line itemsLine item listOptional on create.
Custom fieldsCustom fieldsDepends on organization configuration.

Invoice Status Values

  • draft
  • in_review
  • approved
  • sent
  • partially_paid
  • paid
  • written_off
  • voided
  • overdue

Line Item Source Types

  • time
  • expense
  • milestone
  • fixed_fee
  • retainer
  • manual
  • subscription_fee
  • support_overage

Line item fields include source type, description, quantity, unit price, tax code, time entry, expense entry, milestone, and order index.

Payment Methods

  • bank_transfer
  • credit_card
  • cheque
  • other

Payment fields include amount, currency, received date, method, reference, and exchange rate.

Line Item Time Period Values

  • last_7_days
  • last_15_days
  • last_30_days
  • all_uninvoiced

Line Item Grouping Values

  • task
  • phase
  • project
  • member
  • role
  • detailed

Tax Display Modes

  • generic
  • by_code
  • by_component
  • by_code_nonzero
  • by_component_nonzero

Lifecycle Actions

ActionRequired field
Submit for reviewOptional note and approver.
Void invoiceReason is required.
Record paymentAmount, currency, received date, method.
Write offReason 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.