Status Qualifiers

Status qualifiers are additional flags that provide context about an invoice's state, independent of its primary status. They're system-managed and can't be set or removed directly.

• SENT: Applied when you call Send Invoice or Mark Invoice as Sent.
• VIEWED: Applied when you call Mark Invoice as Viewed.
• OVERDUE: Automatically applied when dueDate passes and the invoice isn't fully paid or voided.

Qualifier behavior

Status	Compatible qualifiers	When applied	System behavior
DRAFT	None	N/A	No qualifiers apply during draft state.
PUBLISHED	SENT, VIEWED, OVERDUE	SENT: After you call Send Invoice or Mark Invoice as Sent. VIEWED: After you call Mark Invoice as Viewed. OVERDUE: When dueDate passes.	Qualifiers are added based on actions or system checks.
PARTIALLY_PAID	SENT, VIEWED, OVERDUE	Qualifiers are retained from PUBLISHED state.	OVERDUE persists if the invoice was overdue before payment.
PAID	SENT, VIEWED	All previously set qualifiers except OVERDUE are preserved.	The invoice is fully paid and is no longer overdue.
VOIDED	SENT, VIEWED	All previously set qualifiers except OVERDUE are preserved.	The invoice is canceled and is no longer overdue.

OVERDUE persistence rules

The OVERDUE flag is applied automatically when the current date passes dueDate. Once applied, it's preserved across status transitions except when the invoice becomes PAID, is voided, or dueDate is updated to a future date.

• Late payment: If an invoice is paid after dueDate, the final state is PAID without an OVERDUE qualifier.
• Voiding: If an OVERDUE invoice is voided, the final state is VOIDED without an OVERDUE qualifier.
• Due date extended: If dueDate is updated to a future date, the OVERDUE qualifier is removed. If the new dueDate passes without full payment, OVERDUE is applied again.