> Portal Navigation:
> 
> - Append `.md` to any URL under `https://dev.wix.com/docs/` to get its markdown version.
> - Pages are either content pages (article or reference text) or menu pages (a list of links to child pages).
> - To get a menu page, truncate any URL to a parent path and append `.md` (e.g. `https://dev.wix.com/docs/sdk.md`, `https://dev.wix.com/docs/sdk/core-modules.md`).
> - Top-level index of all portals: https://dev.wix.com/docs/llms.txt
> - Full concatenated docs: https://dev.wix.com/docs/llms-full.txt

## Resource: Status Qualifiers

## Article: Status Qualifiers

## Article Link: https://dev.wix.com/docs/api-reference/business-management/get-paid/invoices/status-qualifiers.md

## Article Content:

# 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](https://dev.wix.com/docs/api-reference/business-management/get-paid/invoices/invoices/send-invoice.md) or [Mark Invoice as Sent](https://dev.wix.com/docs/api-reference/business-management/get-paid/invoices/invoices/mark-invoice-as-sent.md).
- `VIEWED`: Applied when you call [Mark Invoice as Viewed](https://dev.wix.com/docs/api-reference/business-management/get-paid/invoices/invoices/mark-invoice-as-viewed.md).
- `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.<br>`VIEWED`: After you call Mark Invoice as Viewed.<br>`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.