# Subscription invoices

## Subscription invoices at a glance

A subscription invoice is an invoice record associated with a subscription. Use the
subscription invoice list to review records, narrow the list, open an invoice, or prepare an
export.

| If you need to… | Go to |
|---|---|
| Understand the columns and list controls | [Understand the invoice list](#understand-the-invoice-list) |
| Filter or arrange the list | [Personalize, filter, and prepare the list](#personalize-filter-and-prepare-the-list) |
| Understand why a control is unavailable | [Handle layout and access branches](#handle-layout-and-access-branches) |
| Find a particular invoice | [Find and open an invoice](#find-and-open-an-invoice) |
| Review billing and amount values | [Continue to invoice details](#continue-to-invoice-details) and [Subscription invoice details](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-subscription-invoices-edit-record) |
| Resolve a failed request or empty export | [When a list action goes wrong](#when-a-list-action-goes-wrong) |

The list owns finding and opening an existing invoice. The linked details page owns the
read-only review of billing, subscription, and amount information. Start with [Understand the
invoice list](#understand-the-invoice-list).

## Before you start

Open the subscription invoice list. The list
appears after a layout has loaded. Your company permissions determine whether table-layout,
row-filter, group-filter, and export controls are available.

| What determines what you can use | What it changes |
|---|---|
| A loaded list layout | The list grid is shown only when a layout is available. |
| Table-layout permission | The **Table Layout** menu is available when your account has this permission. |
| Row-filter permission | The **Filter Row** option is available when row filtering is allowed. |
| Group-filter permission | Group filtering is not available on this list. |
| Export availability | **Export** appears in **Settings** when it is available for the list. |

The list layout determines which columns you see. Do not rely on a fixed column order when
comparing two list views.

> **Note:** Work from the headers currently visible in your selected layout. The list does not
> promise the same columns for every layout.

## Understand the invoice list

The invoice list is the working view for locating subscription invoice records. Its columns
come from the selected list layout, so use the headers currently visible on your screen rather
than assuming that every list has the same columns.

The list can show these five columns:

| Column | Use it to… |
|---|---|
| **Company** | Identify the company on the invoice. |
| **Invoice Date** | Identify the invoice date. |
| **Invoice no.** | Identify the invoice number. |
| **Total amount** | Compare the displayed invoice total. |
| **Subscription** | Identify the related subscription. |

The grid provides a **Filter Row** when filtering is available. You can also filter directly from
a visible column header. When no invoice rows are available, the grid keeps its empty-state
message and count indicator visible until rows become available.

The list toolbar includes **Refresh**, **Table Layout**, and **Settings**. **Settings** contains
list settings such as **Filter Row** and, when permitted, **Export**. Select a data row to open
the selected invoice.

## Personalize, filter, and prepare the list

Use the list controls to narrow the records you are reviewing, choose the columns that matter,
and prepare an export when that action is available.

[Handle layout and access branches](#handle-layout-and-access-branches).

### Apply or clear list filters

Narrow the list to the invoice rows you need to review.

**Prerequisites**

- The invoice list is open.
- Row filtering is available in **Settings**.

**Steps**

1. In **Settings**, select the **Filter Row** checkbox.
2. Enter or select filter values in the filter row beneath the visible headers.
3. Select **Refresh** when you need to request the list again.
4. Remove the applied filter values when you need to return to the unfiltered list.

**Result:** The list shows the rows that match the applied filter, or its empty-state message and
count indicator when no rows match.

Use the filter controls attached to a visible column header when you need to narrow that column
directly.

### Adjust the visible layout

Use the table-layout controls when the current list does not show the columns or width you need.

**Prerequisites**

- **Table Layout** is available.

**Steps**

1. Open **Table Layout**.
2. Select a layout such as **Standard Layout**.
3. Choose one list adjustment.

   | If you need to… | Select |
   |---|---|
   | Change the visible columns | **Columns Chooser** |
   | Give the columns more space | **Expand column width** |
   | Store a new arrangement | **Save New Layout** |

4. Complete the selected adjustment.

   | If you selected… | Then… |
   |---|---|
   | **Save New Layout** | Enter a name in **Layout name**, then select **Save**. |
   | **Update Current** | Save changes to the current non-standard layout. |
   | **Delete Current** | When `Are you sure?` appears, select **Delete** to remove the layout or **Cancel** to keep it. |
   | **Columns Chooser** | Choose the columns to display. |
   | **Expand column width** | Select the checkbox to give the columns more space. |

**Result:** The list uses the selected layout, its chosen columns, or its expanded column width.

### Prepare an export

Prepare an export when **Export** is available in **Settings**.

[Handle layout and access branches](#handle-layout-and-access-branches).

**Prerequisites**

- The invoice list is open.
- **Export** is visible in **Settings**.

**Steps**

1. In **Settings**, select **Export**.
2. Choose an export action.

   | If you need to… | Select |
   |---|---|
   | Export an Excel file | **Export to Excel**, then **Export** in the `Exporting List:` dialog. |
   | Export a PDF file | **Export to PDF**, then **Export** in the `Exporting List:` dialog. |
   | Close the dialog without exporting | **Cancel**. |

![Choose the subscription invoice export format](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/4701ab1df405440b51472daee72912e4.png)

![Return to the invoice list after cancelling export](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/9f82802c48adf675ad7de91dfc206ada.png)

**Result:** The selected export action is requested, or the list is visible again after
**Cancel**.

## Handle layout and access branches

The controls available on this list depend on your company permissions and the selected layout.
Use the following table to identify the branch that applies to your screen, then return to the
procedure that needs that control.

| List branch | What you see or use |
|---|---|
| Table layout is allowed | **Table Layout**, its layout choices, **Columns Chooser**, and **Expand column width** are available. |
| The standard layout is selected | **Update Current** and **Delete Current** are disabled for **Standard Layout**. |
| Row filtering is allowed | **Filter Row** is available in **Settings**. |
| Group filtering is requested | The **Group Panel** is not available on this list. |
| **Export** is visible in **Settings** | Use the export choices. |
| Import is expected | Import is not available from this screen. |
| An import upload surface is reached elsewhere | Upload remains unavailable while uploading is disabled. |

## When a list action goes wrong

Use the symptom table to decide what to do when the list request or export does not produce the
expected screen.

| What you see | What it means | What to do |
|---|---|---|
| `An error occurred while processing your request` | The list request failed. | Confirm that the list request can be made with your company permissions, then request the list again with **Refresh**. |
| The grid shows its empty-state message and count indicator | No invoice rows are available in the response used by the list. | Check the visible filters and clear any applied filter before requesting the list again. |
| `NO Data to Export` | The export action has no list data to export. | Return to the list, clear restrictive filters, and confirm that invoice rows are present before selecting **Export** again. |

The export dialog result and exported file contents depend on the response after the export
request.

## Find and open an invoice

Open an existing subscription invoice from its row when you need its read-only billing and amount
details. After it opens, continue with [Continue to invoice details](#continue-to-invoice-details).

**Prerequisites**

- The subscription invoice list is open.
- The invoice row is available in the list.

**Steps**

1. Identify the invoice from the visible **Company**, **Invoice Date**, **Invoice no.**, **Total amount**, and **Subscription** values.
2. Select the invoice data row.

**Result:** The selected subscription invoice opens on its details screen.

## Continue to invoice details

The invoice details page is the read-only destination for reviewing invoice values after you
select a list row. It owns the billing and amount review rather than invoice editing; the view
page does not provide editable invoice fields or invoice save and delete actions.

When the details record is available, review the page's **Bill to** and **Details** areas. The
details page identifies the **Subscription**, **Interval**, and **Amount**, then shows the invoice
amount summary, including **Vat** and **Total**. For field explanations and exit behavior, continue
to [Subscription invoice details](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/configuration-subscription-invoices-edit-record).

The details body appears only when the returned invoice has an identifier. If the invoice record
does not satisfy that condition, the details body is not shown.
