# Payables

Payables is the finance reference point for finding purchase invoices and outgoing
payments, reviewing their list information, and moving to the page for the next task.
Purchase invoices are amounts owed for purchases. Outgoing payments are payments that can
be reviewed by their allocation state.

## Payables

Payables brings together the lists used to review purchase invoices and outgoing payments.
Select the list tab that matches the records you need to review.

| If you need to… | Go to |
|---|---|
| Open the purchase-invoice list or choose its status tab | [Find a purchase invoice or outgoing payment](#find-a-purchase-invoice-or-outgoing-payment) |
| Review columns, filters, and allocation counts | [Understand the Payables lists](#understand-the-payables-lists) |
| Change the table layout | [Choose a list layout](#choose-a-list-layout) |
| Export the current list | [Export a Payables list](#export-a-payables-list) |
| Record a payment after selecting a payment action | [Record a payment](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/record-payment) |
| Create an invoice from the finance flow | [Create an invoice](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/create-invoice) |
| Review additional direct-cost transactions | [Cost transactions](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/cost-transactions) |

The purchase-invoice and outgoing-payment tabs are separate list families. Select **Purchase Invoices**
or **Outgoing Payments** to view the corresponding list.

![Payables with the purchase-invoice tabs and table visible](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/bdeff21e499d40d9f9716d2120c0600b.png)

## Before you start

Payables can show different tabs, actions, and columns for different subscriptions,
permissions, and saved table layouts. Prepare for the following conditions before you
choose a list:

| What to check | What you see or use |
|---|---|
| Subscription access | The main Payables tabs appear when the subscription includes the feature. When it does not, an upgrade surface appears instead. |
| Selected table layout | A grid appears when a table layout is selected for the current list and the selected tab permits that grid. |
| List columns | The headers come from the selected layout, so the columns in your account can differ from another account. |
| Available actions | Actions such as payment, layout management, and export depend on the permissions and feature settings available to your account. |

The list uses the selected layout's columns rather than a fixed business-column list. Work
from the headers visible in your list when you identify a record.

**Note:** Available actions vary with your permissions. Use the controls that appear in your
account rather than assuming that a payment or layout action is available.

When these conditions are clear, select the list family you need.

## Find a purchase invoice or outgoing payment

**Prerequisites**

- You can open the Payables page and the subscription includes the Payables tabs.

**Steps**

1. Select the list family that matches your task.

   | If you need to… | Select |
   |---|---|
   | Review purchase invoices | **Purchase Invoices** |
   | Review outgoing payments | **Outgoing Payments** |

2. If you selected **Outgoing Payments**, choose the allocation view.

   | If you need to review… | Select |
   |---|---|
   | Payments that are not fully allocated | **Not completely Allocated** |
   | Payments that are fully allocated | **Completely Allocated** |

3. Confirm that the selected list and its tabs are visible.

The purchase-invoice list opens at `/finance/payables/list/purchase-invoices/view`.
The outgoing-payment list opens at `/finance/payables/list/outgoing-payment/view`.
**Not completely Allocated** opens `/finance/payables/list/outgoing-payment-not-completely-allocated/view`,
and **Completely Allocated** opens
`/finance/payables/list/outgoing-payment-completely-allocated/view`.
The **Purchase Invoices** and **Outgoing Payments** tabs and the available list columns appear
together on the Payables page.

![Outgoing Payments with its allocation tabs visible](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/6d2bd53c2f4ab2f36d2ac809c4befbb6.png)

**Result:** The selected Payables list is on screen. For outgoing payments, the selected
allocation view is also on screen.

Use the selected list's tabs and headers to identify the records you need to review.

## Understand the Payables lists

The purchase-invoice list helps you separate invoices by payment status; the outgoing-payment
list helps you separate payments by allocation status. The visible rows and headers belong to
the account and list layout you are using.

| List | Tabs | Columns visible in the displayed list |
|---|---|---|
| Purchase invoices | **All**, **Upcoming**, **Payable**, **Paid** | **Account**, **Created By**, **Job No.**, **Shotec S.A.E Order No.**, **Sub-supplier Order No.**, **Payment Due Date**, **Total Amount**, **Total Amount (€)**, **Due Amount**, **Due Amount (€)**, **Paid Amount**, **Paid Amount (€)**, **Status** |
| Outgoing payments | **Not completely Allocated**, **Completely Allocated** | **Transaction no.**, **Receiving on**, **Account**, **Amount**, **Unallocated amount** |

In the purchase-invoice list, `Due` and `Upcoming` appear as row values in **Status**.
They are record values, not default values for every account. In the outgoing-payment views,
the displayed rows show `Count: 6.00` for **Not completely Allocated** and `Count: 14.00`
for **Completely Allocated**. These are values from the records in that account.

The shared list controls can appear conditionally: **Apply filter**, **Clear applied filter**,
**Refresh**, **Filter Row**, and **Group Panel**. Use them when they are shown.
Use the headers in the outgoing-payment list to identify a payment. This list has no labelled
form fields or text-labelled actions.

![Purchase Invoices with the status tabs and visible headers](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/298cf334abe05cc753aef81abee36713.png)

![Not completely Allocated with its allocation count and headers](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/56008af98f6459133f8d6f5fd2ef4962.png)

When you know which columns and controls you need, continue to the list-layout choices or
the export action.

### Choose a list layout

Use a table layout when you need the list to use a saved arrangement of columns or when your
account exposes the layout-management controls.

**Prerequisites**

- You have opened the Payables list whose columns you want to review.
- Your account permits table-layout management.

**Steps**

1. Select **table layout**.

   The available choices use the saved layout names in your account.

2. Choose the action that matches your layout task.

   | If you need to… | Select or enter |
   |---|---|
   | Use the displayed standard layout | **Standard Layout** |
   | Create a saved layout | **Save New Layout**, enter the layout name in the layout-name entry area, then select **Save** |
   | Change the current saved layout | **Update Current** |
   | Remove the current saved layout | **Delete Current** |
   | Review column choices | **Columns Chooser** |
   | Change a column width | **Expand column width** |

   The chooser provides **Close**. The purchase-invoice list has 13 visible columns when the
   chooser is opened.

3. If the layout controls are no longer visible, press `Escape` to close the chooser or
   return to the list before selecting **table layout** again.

![table layout choices including Standard Layout and saved-layout controls](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/6abdac7d6495852c5a7a27c2230b9a9b.png)

![Columns Chooser with the Close control visible](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/e5d7e9830ba6ed3597e69b2862b3b167.png)

**Result:** The chosen layout remains selected, or the layout chooser is closed with the
current list columns unchanged.

After choosing a layout, export the current list if you need a file, or continue to the
available payment branch.

## Export a Payables list

Use **Export** when your account makes export available for the Payables list.

**Prerequisites**

- You have opened the Payables or purchase-invoice list to export.
- Export is allowed for your account.

**Steps**

1. Select **Export** when it is available.

2. Follow the export surface that opens for the selected list.

**Result:** The available export flow opens for the Payables list. When export is not allowed,
the **Export** control is disabled.

If you are continuing with a payment rather than a file, use the payment branch below.

## Handle list and payment branches

The Payables page separates list review from the payment pages that own payment recording.
Choose the branch that matches the record or payment work you need to continue.

**Prerequisites**

- You know whether you are reviewing purchase invoices or outgoing payments.
- The required action is available in your account.

**Steps**

1. Select the branch that matches the work.

   | If you need to… | Select |
   |---|---|
   | Review purchase invoices | **Purchase Invoices** |
   | Review outgoing payments | **Outgoing Payments** |
   | Open the outgoing-payment action menu | **Outgoing Payment** |
   | Open the purchase-invoice payment page | **Pay Purchase Invoice** |
   | Open the additional-cost payment page | **Pay Additional Direct Cost** |

The purchase-invoice and outgoing-payment surfaces appear under their corresponding tab
conditions. Each action is available only when the account permits it.

**Result:** The permitted list or payment branch opens.

If an action is rejected, use the message in the next section before trying the branch again.

## When a Payables action fails

Use the message on screen to correct a rejected value. Payables uses this validation message:

| What you see | What to do |
|---|---|
| `Forbidden characters detected. Please remove them and try again.` | Remove the forbidden characters from the value you entered, then repeat the action. |

Select **table layout** when it appears. If it does not appear, continue with the controls
visible on the list.

After correcting a rejected value, return to the relevant list and use the available branch.

## Continue from a Payables list

After reviewing a Payables list, select **Pay Purchase Invoice** or **Outgoing Payment** when
available, then review the page that opens before entering payment information.
