# Invoice lifecycle

An invoice records an amount due from an account or principal. Its lifecycle runs from preparation
through approval, due-date handling, and payment.

## Invoice lifecycle at a glance

The invoice workspace carries header information, invoice items, totals, payment information, and
approval state. The lifecycle uses these statuses:

| Status | What it means in the lifecycle |
| --- | --- |
| **Draft** | The invoice is being prepared or returned for further work. |
| Release for Approval | The invoice is ready to enter the approval path. |
| **Approved** | The invoice has completed approval and moves into sending and payment handling. |
| **Due** | The invoice has an outstanding amount and its payment period has not become overdue. |
| **Overdue** | The invoice still has an outstanding amount after its payment period. |
| **Paid** | The due amount is zero or less. |

The normal shape is Draft → Release for Approval → Approved → Due. From Due, the invoice becomes
Overdue when its payment period is overdue, or Paid when its due amount is zero or less. An
approved invoice can also return to Draft when the approval process permits **Consider as not
approved**.

```mermaid
stateDiagram-v2
    Draft --> Release for Approval: Request approval
    Release for Approval --> Approved: Approve
    Approved --> Due: Consider as sent to client/principal
    Due --> Overdue: payment period overdue
    Due --> Paid: due amount ≤ 0
    Approved --> Draft: Consider as not approved
```

| If you need to… | Go to |
| --- | --- |
| Check access and approval prerequisites | [Before you start](#before-you-start) |
| Locate a saved invoice | [Find and open an invoice](#find-and-open-an-invoice) |
| Identify fields, totals, tabs, and actions | [Read the invoice workspace](#read-the-invoice-workspace) |
| Start a new account or additional invoice | [Choose an invoice creation route](#choose-an-invoice-creation-route) |
| Request, complete, or reverse approval | [Request and complete approval](#request-and-complete-approval) |
| Follow payment and due-date branches | [Follow Due, Overdue, and Paid branches](#follow-due-overdue-and-paid-branches) |
| Correct a blocked invoice action | [When an invoice action does not work](#when-an-invoice-action-does-not-work) |
| Record an incoming payment | [Record a payment](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/record-payment) |
| Review principal invoices | [Principal invoices](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/principal-invoices) |
| Review purchase invoices or outgoing payments | [Payables](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/payables) |

## Before you start

Prepare the access and record conditions below before you begin.

| Prepare | Why it matters |
| --- | --- |
| The invoice feature is included in your subscription. | The invoice workspace is subscription-gated. |
| Access to the invoice list and editor is granted to your role. | The list and editor have permission guards. |
| An approval process and applicable approval limit are configured when your work uses approval. | The **Approve** and **Request approval** actions depend on approval configuration and limits. |
| A saved invoice exists for record actions. | Approval, sending, and other record actions operate on a saved invoice. |

Open the finance invoice list to work with saved invoice records. Opening a saved invoice takes you
to its invoice workspace. Account-invoice and additional-invoice creation are separate routes.

**Note:** Approval authority matters before saving or changing an invoice. If your work uses an
approval process, identify the person or role that must approve the invoice before you select an
approval or record-changing action.

## Find and open an invoice

The invoice list is the finance workspace for choosing an invoice type, narrowing statuses, and
opening an existing record. After you open a record, continue with [Read the invoice workspace](#read-the-invoice-workspace).

**Prerequisites**

- Your subscription includes the invoice workspace.
- Your role can open the finance invoice list.
- You know whether the record is a sales invoice or a commission invoice.

**Steps**

1. Open the finance invoice list.
2. Select the invoice navigation tab that matches your task.

   | If you need to… | Select |
   | --- | --- |
   | Review every invoice-list area | **All** |
   | Review sales invoices | **Sales Invoices** |
   | Review commission invoices | **Commission Invoices** |
   | Review incoming payments | **Incoming Payments** |
   | Review principal invoices | **Tracking Principal Invoices** |

3. Select the status filter that matches the invoice stage.

   | If you need to find… | Select |
   | --- | --- |
   | All available statuses | **All** |
   | Upcoming invoices | **Upcoming** |
   | Draft invoices | **Draft** |
   | Approved invoices | **Approved** |
   | Receivable invoices | **Receivable** |
   | Paid invoices | **Paid** |

4. Read the visible grid headers before identifying the row. The sales-invoice grid shows
   **Invoice No.**, **Job No.**, **Account**, **Due Date**, Invoice Amount €, Invoice
   Amount, Paid Amount, Paid Amount €, Due Amount, Due Amount NaN, Total Sales Price, and
   **Status**.
5. Select the row for the saved invoice you need to review.

![Use the navigation tabs, status filters, and visible invoice grid headers to locate a record.](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/8bc189367930435638a61afdd11e661f.png)

6. Open the selected invoice record.

Your list layout determines which columns are available. Work from the headers currently shown in
your list rather than assuming that every account has the same columns.

**Result:** The selected saved invoice is open in its invoice workspace, or the list shows that
the required tab or filter is unavailable.

## Read the invoice workspace

The invoice workspace brings together the invoice header, account-invoice items, totals, approval
actions, and saved-record follow-up areas.

The header can contain these fields:

| Field | When it appears | Required status | Choices |
| --- | --- | --- | --- |
| **Account** | Non-account invoice | Not required | — |
| **Invoice Date** | Invoice loaded | Not required | — |
| **Invoicing Address** | Invoice loaded | Required | — |
| **Payment Period** | Invoice loaded | Not required | Choices: the runtime `Name` values from `AllTimePeriods`; each option has an `ID` value. |
| **Issued By** | Invoice loaded | Required | Choices: the runtime `Name` values from `usersList`; each option has an `ID` value. |
| **Vendor Order No.** | Sales or commission invoice | Not required | — |
| **External invoice no.** | Sales or commission invoice with the integration condition | Not required | — |
| **Client** | Commission invoice | Not required | — |
| **Client Order No.** | Sales or commission invoice | Not required | — |
| **Order Date** | Sales or commission invoice | Not required | — |
| **Delivery Date** | Sales or commission invoice | Not required | — |
| **Delivery Term** | Sales or commission invoice | Not required | — |
| **Payment Method** | Invoice loaded | Not required | — |
| **Invoice Note** | Invoice loaded | Not required | — |

An account invoice can show an item grid with **Item**, **Unit**, **Quantity**, **Unit Price**,
Discount, **Item Price**, **Tax**, and Currency Code. The summary area shows **Invoice
amount**, **Total taxes**, **Total incl. tax**, **Paid Amount**, **Deductions**, and **Due amount**.

The saved-record workspace includes the tabs **Comments**, **Attachment**, **Tasks**,
**Activities**, **Deductions**, **Payments**, and **Last Modifications**. Approval and sending
actions depend on the invoice type, status, approval process, approval limit, email permission,
and feature conditions. Available actions include **Approve**, **Request approval**, **Consider as
sent to principal**, **Consider as sent to client**, **Send to principal**, and **Send to client**.

The invoice-create workspace can also contain embedded areas for files, activities, tasks, an
address, and contacts. Use those areas only for the supporting work they own; see [Out of scope
messages](#out-of-scope-messages) for messages from those areas.

![Recognize the invoice workspace and its saved-record areas.](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/2add82e9f737965363aa85f157f25db1.png)

## Choose an invoice creation route

An account invoice and an additional invoice are separate creation routes. Each opens the invoice
creation workspace; its fields and save procedure are covered in [Create an Account Invoice](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/create-invoice).

| Create… | Continue with |
| --- | --- |
| An account invoice | [Create an Account Invoice](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/create-invoice) |
| An additional invoice | In the finance invoice area, open the entry for an additional invoice. |

**Prerequisites**

- You have permission to open the applicable creation route.
- You know whether the invoice is an account invoice or an additional invoice.

**Steps**

1. In the finance invoice area, open the entry for the invoice type you need.
2. Follow the applicable outcome.

   | If you see… | Do this |
   | --- | --- |
   | The invoice creation workspace | Continue with [Create an Account Invoice](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/create-invoice). |
   | `You are not allowed to View this page!` | Contact your administrator to request access to the applicable creation option. |

**Result:** The applicable creation workspace is open, or the dashboard is visible after access is
refused.

## Request and complete approval

Approval is the controlled review of an invoice before it proceeds through sending and payment.
The available action depends on its status, approval process, limit, and permission.

| Invoice condition | Action available when the guard allows it | Resulting direction |
| --- | --- | --- |
| **Draft**, Release for Approval, or **Awaiting Approval** with approval authority | **Approve** | Completes approval and leaves the invoice **Approved**. |
| **Draft** or Release for Approval when direct approval is not allowed | **Request approval** | Sends the invoice into **Awaiting Approval**. |
| **Awaiting Approval** | **Cancel request for approval** | Cancels the request. |
| **Awaiting Approval** with approval permission | **Reject approval request** | Rejects the request. |
| **Approved** with an approval process | **Consider as not approved** | Returns the invoice to **Draft**. |

**Prerequisites**

- The invoice is saved.
- The invoice is in a status listed in the applicable row above.
- The approval process, limit, and permission required by the action are in place.
- If you are saving or deleting a record, identify the person or role that must approve the
  change before you commit it.

**Steps**

1. Open the saved invoice and read its current status.
2. Select the approval action that matches the status and authority available to you.
3. Follow the applicable approval outcome.

   | If… | Select or do this |
   | --- | --- |
   | The invoice enters **Awaiting Approval** | Wait for the authorised approver to select **Approve** or **Reject approval request**. |
   | The request is no longer required while the invoice is **Awaiting Approval** | Select **Cancel request for approval**. |
   | An approved invoice must return for correction | Select **Consider as not approved**. |

4. Re-read the status before starting sending or payment work.

Fields including **Account**, **Invoice Date**, **Invoicing Address**, **Payment Period**,
**Issued By**, and **Payment Method** are locked after approval. Do not plan an edit of these
fields after approval; return the invoice to **Draft** where the approval process permits it.

**Result:** The invoice shows the status produced by the selected approval path: **Approved**,
**Awaiting Approval**, **Draft**, or the unchanged status when the guard does not allow the action.

## Follow Due, Overdue, and Paid branches

The payment branch tells you whether an invoice still needs collection, has passed its payment
period, or has no amount left to collect.

| Condition | Status or branch |
| --- | --- |
| The due amount is greater than zero and the payment period is not overdue | **Due** |
| The due amount is greater than zero and the payment period is overdue | **Overdue** |
| The due amount is zero or less | **Paid** |
| A due invoice must be marked as not sent | **Consider as not sent to principal** or **Consider as not sent to client** |
| An eligible approved or draft invoice must be marked as sent | **Consider as sent to principal** or **Consider as sent to client** |

**Prerequisites**

- The invoice is approved or otherwise eligible for the sending action.
- You know whether the invoice is sent to the client or to the principal.
- You have the permission and feature access required by the action.

**Steps**

1. Open the invoice and read **Due amount** and the payment-period information.
2. Identify the payment branch.

   | If… | Follow this branch |
   | --- | --- |
   | **Due amount** is zero or less | Treat the invoice as **Paid**. |
   | **Due amount** is greater than zero and the payment period is overdue | Follow **Overdue**. |
   | **Due amount** is greater than zero and the payment period is not overdue | Follow **Due**. |

3. Select **Consider as sent to principal** or **Consider as sent to client** when the approved
   invoice must enter the sent branch without the corresponding send action.
4. Select **Consider as not sent to principal** or **Consider as not sent to client** when a
   **Due** or due-equivalent invoice must return to the not-sent branch.
5. Use [Record a payment](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/record-payment) to record incoming money.

After approval, editing remains locked according to the invoice status and approval guards. The
payment branch determines the next finance task rather than providing a general editing route.

**Result:** The invoice is identified as **Due**, **Overdue**, or **Paid**, and you have the
appropriate sending or payment hand-off.

## When an invoice action does not work

Use the message on screen to choose the correction.

| What you see | What it means | What to do |
| --- | --- | --- |
| `This field is required` | A required invoice field is empty. | Complete the required field, then save again. |
| `Invalid input. The value must be greater than 0 and cannot exceed 999,999.00` | A numeric value is outside the permitted positive range. | Enter a value greater than zero and no greater than `999,999.00`. |
| `Invalid input. Please enter a non-negative value` | A numeric value is negative. | Enter zero or a positive value. |
| `Check validation` | The form has validation findings to review. | Read the validation state, correct the named field, and save again. |
| `Invoice saved successfully` | The invoice save completed. | Re-read the invoice status and totals before continuing. |
| `Invoice failed to save` | The save did not complete. | Review the invoice values and permissions, then retry the save. |
| `An error occurred while processing your request` | Processing failed while the action was handled. | Stop the workflow and ask an administrator to review the invoice action and access. |
| `complete popup on changed invoice close` | The changed invoice close confirmation is displayed. | Resolve the confirmation before leaving the changed invoice. |
| `You are not allowed to View this page!` | The requested invoice creation route is refused. | Ask for permission to open the account-invoice or additional-invoice route. |

The sales-invoice screen does not provide Payment List or **Due/Overdue**.

![Recognize the invoice-list toolbar area before relying on an export action.](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/ed823ddc6bb19f7060db24e597a32eb0.png)

### Out of scope messages

Embedded files, activities, and contacts have their own owning pages. Their messages can appear in
the invoice editor, but they do not describe the invoice lifecycle.

| Message | Owning page or area |
| --- | --- |
| `This record is related to saved data and cannot be deleted` | Libraries |
| `Your request was completed successfully` | Libraries |
| `Forbidden characters detected. Please remove them and try again.` | Libraries |
| `Action not allowed` | Activities and attachments on a sales job |
| `One topic and at least one note is required` | Activities and attachments on a sales job |
| `You already have a contact with this name` | Contacts, L/Gs, and Last Modifications on a sales job |

Use the owning page for the procedure that produced one of these messages. Continue with [When an
invoice action does not work](#when-an-invoice-action-does-not-work) for invoice status, approval,
and payment problems.

## Continue with the next finance task

Choose the next task from the invoice's current status and the work still required.

| If the invoice work is… | Continue with |
| --- | --- |
| Starting a new account or additional invoice | The invoice-creation page |
| Recording money received | [Record a payment](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/record-payment) |
| Reviewing principal invoice status, deductions, or principal payments | [Principal invoices](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/principal-invoices) |
| Reviewing purchase invoices or outgoing payments | [Payables](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/payables) |

For invoice-entry fields and the save procedure, continue to [Create an Account Invoice](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/create-invoice).
For payment, principal-invoice, or payables work, continue to [Record a payment](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/record-payment),
[Principal invoices](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/principal-invoices), or [Payables](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/payables).
