# Principal invoices

A principal invoice is an invoice record that you review through the Principal invoices list
and its status views. The list includes **All**, **Upcoming**, **Receivable**, and **Paid**. A
considered-paid invoice appears under **Paid**; an invoice returned to due appears under **Due**.

## At a glance

Use this page to review a principal invoice record, update it when permitted, and manage its
payment or deduction information. The separate list and record areas support different tasks.

| If you need to… | Go to |
|---|---|
| Open the principal-invoice list | [Find and open a principal invoice](#find-and-open-a-principal-invoice) |
| Export the selected status view | [Export the current principal-invoice list](#export-the-current-principal-invoice-list) |
| Find fields and totals | [Record fields and totals](#record-fields-and-totals) |
| Edit an invoice record | [Update the principal-invoice record](#update-the-principal-invoice-record) |
| Review payment or deduction information | [Manage payments, deductions, and paid status](#manage-payments-deductions-and-paid-status) |
| Add a deduction or principal payment | [Add a deduction or principal payment](#add-a-deduction-or-principal-payment) |
| Review the general invoice status flow | [Invoice lifecycle](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/invoice-lifecycle) |
| Record a separate payment | [Record a payment](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/record-payment) |
| Review purchase invoices or outgoing payments | [Payables](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/payables) |

The list is for choosing a status view and selecting an existing invoice. The record is for
reviewing invoice information and, when permitted, updating the record or managing related
financial information.

## Before you start

Principal invoice work depends on subscription access, the selected list layout, the record state,
and your role.

| What to check | What it changes |
|---|---|
| Subscription and layout | **All**, **Upcoming**, **Receivable**, and **Paid** appear when the subscription includes the area and the minimum layout is open. |
| Invoice details | Actions require an existing invoice and an applicable status. |
| Editing access | **Save** and **Save and Close** are available when the record is not opened with an input ID and your account passes the edit-permission check. |
| List columns | The visible headers come from the chosen list layout, so another account can show different columns. |
| Role | **Principal Payments** is unavailable to a principal user. |

Deductions require at least due status. Payment and considered-paid actions have their own status
conditions. Use the status shown on the record and the controls that appear there before choosing
related work.

> **Note:** Principal invoices is separate from the general invoice lifecycle and from Payables.
> Use the page that owns the next task instead of treating a status tab as a lifecycle transition.

## Find and open a principal invoice

Choose a status view and open an existing invoice when its row can be selected.

**Prerequisites**

- The Principal invoices area is included in your subscription.
- The list layout is open and an existing invoice row is available.

**Steps**

1. Open the Principal invoices page.
2. Select the status view that answers your question.

   | If you need to review… | Select |
   |---|---|
   | All invoice statuses | **All** |
   | Upcoming invoices | **Upcoming** |
   | Receivable invoices | **Receivable** |
   | Paid invoices | **Paid** |

3. Confirm that the chosen status view and its table are visible.

   If the status view cannot load, the page displays `Load data failed: <error message>`.

   ![The Principal invoices list with the All status view selected](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/78c269468e8f9cb9e304dc8b1cb7c24f.png)

4. Select the existing invoice row you need to review.
5. Confirm that the invoice details open before choosing an action.

**Result:** The chosen status view is on screen, or the existing invoice record is open for review.

### Export the current principal-invoice list

After the status view is open, export its current rows.

**Prerequisites**

- A Principal invoices status view is open.
- **Export** is available on the list page.

**Steps**

1. Select **Export**.
2. Review the export page.
3. If list options are presented, use **Filter Row** and **Group Panel** according to the arrangement you need.

   ![The export surface for the selected Principal invoices list](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/f1137c82b8c7d2b083f567f6a77ea392.png)

**Result:** The export page for the selected list is open.

## Understand the principal-invoice screen

The screen has a list page for status views and a record page for invoice details. The record also
exposes related tabs and status actions when the record conditions allow them.

The list page shows `Tracking Principal Invoices`, the status filters, and **Refresh**, **Table
Layout**, and **Settings**. The record page contains invoice fields, amount information, related
tabs, and **Consider As Paid** and **Consider As Not Paid** when their conditions are met.

| Area | What it is for | Conditions that affect it |
|---|---|---|
| Principal invoices list | Choose **All**, **Upcoming**, **Receivable**, or **Paid**, then review rows. | Subscription and minimum-layout conditions control the status filters. |
| Invoice record | Review or edit fields for an existing invoice. | The record must exist; edit actions also require edit permission. |
| **Comments** | Open comments related to the record. | The record cannot be upcoming or awaiting principal payoff, and comments access must be available. |
| **Deductions** | Review deduction entries and, where allowed, add one. | The record must be at least due and meet the deduction conditions. |
| **Principal Payments** | Review principal-payment entries and, where allowed, add one. | The record cannot be upcoming or awaiting principal payoff, and the reader cannot be a principal user. |
| **Last Modifications** | Open the record modification history. | The record cannot be upcoming or awaiting principal payoff. |

The list table uses the columns from your chosen layout. The invoice details use their own fields and
related tables.

### List columns

The same 12 headers appear in **All**,
**Upcoming**, **Receivable**, and **Paid**:

| First set of headers | Second set of headers |
|---|---|
| `Invoice No.` | `Job No.` |
| `Account` | `Due Date` |
| `Invoice Amount €` | `Invoice Amount` |
| `Paid Amount` | `Paid Amount €` |
| `Due Amount` | `Due Amount NaN` |
| `Total Sales Price` | **Status** |

The list can also include **Item descrption** and **Amount**. Work from the headers visible in your
current list; other saved layouts can show a different set of columns.

![The runtime columns visible for the current Principal invoices layout](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/b7610132378b2094791429fe88a05944.png)

### Record fields and totals

An invoice record brings together parties, dates, identifiers, description, note, and amount
information. Open an existing record before using these fields.

| Field | Type | Requirement |
|---|---|---|
| **Client** | Text | Required only when company configuration makes it required. |
| **Vendor** | Text | Required only when company configuration makes it required. |
| **Shipment Date** | Date | Optional. |
| **Invoice Date** | Date | Optional. |
| **Order Date** | Date | Optional. |
| **Delivery Date** | Date | Optional. |
| **End User** | Text | Optional. |
| **Salesperson Responsible** | Text | Optional. |
| **Product Type** | Text | Optional. |
| **Vendor Order No.** | Text | Optional. |
| **Client Order No.** | Text | Optional. |
| **Invoice No.** | Text | Required only when company configuration makes it required. |
| **Job Title** | Text | Optional. |
| **Item Description** | Text | Optional. |
| **Note** | Text | Required only when company configuration makes it required. |

**Client**, **Vendor**, **Invoice No.**, and **Note** are configurable required fields. Check the
required marker on this record rather than treating all four as universally required. Amount
information appears in the invoice amount area and in the deduction and payment grids.

### Payment, deduction, and paid-status fields

The related dialogs collect different financial information.

| Dialog | Required fields | Limits or choices |
|---|---|---|
| Principal payment | Payment amount, **Payment Date**, and **comment** | Amount must be greater than 0 and cannot exceed the due invoice amount. **Payment Date** cannot be later than today. |
| Principal deduction | Deduction amount, **Deduction reason**, and **comment** | Amount must be greater than 0 and cannot exceed the due invoice amount. |
| Considered paid | **For Sure Paid**, **Probably Paid**, and **Reason For Consideration As Paid** | Each field is required before the paid-status save path. |

The **Deduction reason** choices are `Late Delivery`, `Technical Reason`, `Missed Parts`,
`Missed Services`, and `Unreasoned`.

## Update the principal-invoice record

Change editable invoice fields on an existing record.

**Prerequisites**

- The existing principal invoice record is open.
- The record is opened without an input ID.
- Your account passes the record's edit-permission check.

**Steps**

1. Enter the new invoice number in **Invoice No.**.
2. Choose how to save the record.

   | If you want to… | Select |
   |---|---|
   | Keep the record open | **Save** |
   | Save the record and leave the page | **Save and Close** |

3. If validation stops the save, correct the fields marked as required and repeat your selected save
   option.

A successful record update displays `Your request was completed successfully`. A validation failure
displays `Check validation`.

**Result:** The record is saved with the success message, or it remains open with `Check validation`
so you can correct it.

## Manage payments, deductions, and paid status

After reviewing the record fields, use the related tab that matches the financial work.

**Prerequisites**

- An existing principal invoice record is open.
- The record status and your role permit the related work.

**Steps**

1. Select the related tab that matches the work.

   | If you need to… | Select |
   |---|---|
   | Review comments | **Comments** |
   | Review or add deductions | **Deductions** |
   | Review or add principal payments | **Principal Payments** |
   | Review record changes | **Last Modifications** |

2. Review the table columns in the chosen tab.
3. If **Deductions** is available, use it only when the invoice has reached at least due status.
4. If **Principal Payments** is available, use it only when you are not a principal user.
5. Choose the permitted financial branch from the table below.

   | If you need to… | Continue with |
   |---|---|
   | Consider the invoice paid | [Consider an invoice paid](#consider-an-invoice-paid) |
   | Return an invoice to due | [Return an invoice to due](#return-an-invoice-to-due) |
   | Add a deduction or principal payment | [Add a deduction or principal payment](#add-a-deduction-or-principal-payment) |

**Result:** The permitted related-work tab is open, or its unavailable condition explains why that
branch cannot be used for the current record.

### Consider an invoice paid

Use **Consider As Paid** when an existing record has a positive outstanding amount and its status is
eligible for the considered-paid branch.

**Prerequisites**

- An existing record is open on its standalone details page.
- The record is not upcoming or already paid.
- The applicable status guards permit the action.
- The outstanding amount is positive.

**Steps**

1. Select **Consider As Paid**.
2. Enter the required information in **For Sure Paid**, **Probably Paid**, and **Reason For Consideration As Paid**.
3. Select **Save** in the dialog.
4. Confirm that the record returns to its paid-status branch.

**Result:** The considered-paid information is saved and the invoice is shown in the paid-status
branch.

### Return an invoice to due

Use **Consider As Not Paid** for an invoice that is currently considered paid.

**Prerequisites**

- An existing record is open.
- The record is currently considered paid.

**Steps**

1. Select **Consider As Not Paid**.
2. Confirm that the record returns to the due branch.

The considered-paid status appears under **Paid**. The corresponding due status appears under
**Due**.

**Result:** The invoice is shown under **Due**.

### Add a deduction or principal payment

Choose one entry path after opening the permitted related tab.

**Prerequisites**

- An existing record is open on a permitted, standalone details page.
- For a deduction, **Deductions** is active and the record is not paid or considered paid.
- For a principal payment, **Principal Payments** is active and the record status permits payment.

**Steps**

1. Follow the applicable path.

   | Entry path | Actions |
   |---|---|
   | Deduction | In **Deductions**, enter the deduction amount. Select a **Deduction reason**. Enter the required **comment**. Select **Save**. |
   | Principal payment | In **Principal Payments**, enter the payment amount. Enter **Payment Date** and the required **comment**. Select **Save**. |

For either amount, enter a value greater than 0 that does not exceed the due invoice amount. A
successful save displays `Your request was completed successfully`; a payment validation failure
displays `Check validation`.

**Result:** The new deduction or principal payment is saved and appears in its related grid, or the
dialog remains open with the validation message so you can correct the entry.

## When a principal-invoice action fails

Use the message on screen to correct the value or choose the appropriate page.

| What you see | What to do |
|---|---|
| `This Field Is Required` | Enter a value in the field marked as required, then repeat the action. |
| `Amount must be greater than 0 and can't exceed due invoice amount` | Enter an amount greater than 0 and no greater than the due invoice amount. |
| `Check validation` | Correct the highlighted payment or record fields, then repeat the save action. |
| `Load data failed: <error message>` | Read the error message, then reload the Principal invoices page. |
| `Updating error <error>` | Read the error text, correct the record, and repeat the update. |
| `Deductions Reasons failed to load` | Reload the deduction area and retry when the choices are available. |
| `Are you sure you want to delete this payment?` | Read the confirmation and continue only if you intend to remove the payment. |
| `Are you sure you want to delete this deduction?` | Read the confirmation and continue only if you intend to remove the deduction. |

If a related tab or action is absent, check the record status and whether your role permits the
branch.

## After reviewing a principal invoice

When you finish the list and record work, continue to the page that owns the next task.

| If you need to… | Continue to |
|---|---|
| Follow the general invoice status flow | [Invoice lifecycle](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/invoice-lifecycle) |
| Record a separate payment | [Record a payment](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/record-payment) |
| Review purchase invoices or outgoing payments | [Payables](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/payables) |
