# Create an Account Invoice

## Create an account invoice

An account invoice records an amount to bill against an account. An additional invoice is
another invoice entry created through the separate additional-invoice route.

The new invoice starts in **Draft**. Use the saved invoice's lifecycle page for the work that
moves it through approval, sending, and payment follow-up.

```mermaid
flowchart LR
    A[Create an account invoice] --> D[Draft]
    B[Create an additional invoice] --> D
```

| If you need to… | Go to |
| --- | --- |
| Check the information and controls before entering data | [Understand the invoice form](#understand-the-invoice-form) |
| Add a billing destination | [Add a billing address](#add-a-billing-address) |
| Enter items and save the invoice | [Complete and save the invoice](#complete-and-save-the-invoice) |
| Correct a message that prevents saving | [When validation fails](#when-validation-fails) |
| Check amounts and what remains due | [Review currency and totals](#review-currency-and-totals) |
| Continue approval and invoice-status work | [Continue with the saved invoice](#continue-with-the-saved-invoice) |
| Create or correct the account first | [Create an account](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/create-account) |
| Review the saved invoice lifecycle | [Invoice lifecycle](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/invoice-lifecycle) |
| Record money received after the invoice exists | [Record a payment](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/record-payment) |
| Work with principal invoices | [Principal invoices](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/principal-invoices) |
| Review purchase invoices and outgoing payments | [Payables](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/payables) |

## Before you start

Prepare the account, the invoice header information, the invoice items, and access to the finance invoice feature before opening the form. Selecting the right account connects the invoice to the account's billing context; collecting the invoice values first avoids leaving a new record incomplete.

**Prerequisites**

| Prepare | Why it matters |
| --- | --- |
| The account for an account invoice | The **Account** picker is available for account invoices. |
| The invoice date, payment period, issuer, payment method, note, and item values | These values complete the invoice header and item grid. |
| The invoicing address | **Invoicing Address** is required before the invoice can be saved. |
| The person or user to select in **Issued By** | **Issued By** is required before the invoice can be saved. |
| Edit access and changed invoice data | **Save** and **Save and Close** require edit access, changes, a non-upcoming status, and no active save. |
| An invoices-module subscription | The invoice workspace is hidden when the invoice feature is not included. |
| `EditClient` permission when adding a new billing destination | Adding a destination requires the account-edit permission. |

> **Note:** The destination is selected from **Billing Address Destination**; the address itself is entered through the destination form.

When the account does not already provide the billing destination needed by the invoice branch, add a destination before saving.

Approval controls are separate from the save controls and depend on approval configuration, invoice status, permission, and subscription features.

## Open the invoice form

Choose the finance route that matches the invoice you need. Do not enter invoice data until
the form is visible.

**Prerequisites**

- You are signed in to PAMS.
- The invoice feature is included in the subscription.
- You have access to the finance invoice page.

**Steps**

1. Choose one route.

   | Invoice you need | Route or entry point |
   | --- | --- |
   | Account invoice | Open the account-invoice route, or select the **Account Invoices** add link when it is available. |
   | Additional invoice | Open the additional-invoice route. |

   ![The account-invoice entry point and the page reached after opening it](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/c0412e66205334ca9d219c53758132ce.png)

   The route determines which new-invoice form opens.

   ![The additional-invoice entry point and the page reached after opening it](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/0204f63edda4fb604281c56ffed4df6d.png)

2. If the access dialog appears, read `You are not allowed to View this page!` and stop
   entering invoice data.

3. If the site redirects you to the dashboard, return to the finance invoice entry point
   after the access issue is resolved.

**Result:** The invoice form is open when access is available. When access is refused, the dashboard is displayed instead and no invoice fields are available.

## Understand the invoice form

The invoice form combines header information, an item grid, a summary, and save controls.
The fields shown can change with the invoice type and status.

| Area | Field or control | What to use it for |
| --- | --- | --- |
| Header | **Account** | Select the account for an account invoice; other invoice types use read-only text. |
| Header | **Invoice Date** | Enter or review the invoice date. |
| Header | **Billing Address Destination** | Select the billing destination. |
| Header | **Invoicing Address** | Enter the required invoicing address. |
| Header | **Payment Period** | Set the payment count and period. Choices come from the available time-period data. |
| Header | **Issued By** | Select the issuer. Choices come from the available user data. |
| Header | **Payment Method** | Select the payment method for an account invoice; sales and commission invoices can show it as read-only text. |
| Header | **Invoice Note** | Add a note to the invoice. |
| Items | **Item**, **Unit**, **Qty**, **Unit Price**, **Discount (%)**, **Item Price**, **Tax (%)**, **Currency** | Enter and review the item row values. |
| Toolbar | **Save** | Save the invoice while remaining on the form. |
| Toolbar | **Save and Close** | Save the invoice and close the form. |

Sales and commission invoice types can add fields for vendor order, external invoice number,
client or order dates, delivery term, payment method, L/C number, and freight. These fields
depend on the invoice type; use the labels visible on the form for the selected type.

Approval actions such as **Approve** and **Request approval** depend on invoice status, approval configuration, permission, and subscription features. **Enable Editing** also depends on status and permission. After approval, the main header fields can become unavailable for editing.

If the account needs a billing destination, continue to [Add a billing address](#add-a-billing-address).
Otherwise, continue to [Complete and save the invoice](#complete-and-save-the-invoice).

## Add a billing address

Use a billing address destination when the account does not already provide the destination
required by the invoice. The destination picker is separate from the required
**Invoicing Address** field.

**Prerequisites**

- The invoice form is open.
- The account needs a new billing destination.
- You have `EditClient` permission to add a destination.

**Steps**

1. Choose the destination path.

   | If | Then |
   | --- | --- |
   | The correct destination is available | In **Billing Address Destination**, choose it. |
   | The destination is not available | Select **Add new Destination**. |

2. If you selected **Add new Destination**, enter the destination name in **Destination Title**.
3. Enter the country in **Country**.
4. Enter the state in **State**.
5. Enter the city in **City**.
6. Enter the street in **Street**.
7. Enter the postal value in **Zip-code**.
8. Select **Save**.
9. Select the saved destination in **Billing Address Destination**.

If permission is denied, stop the address procedure and ask an administrator or account editor to add the destination. The invoice cannot use a destination that has not been saved and selected.

**Result:** An existing or newly saved billing destination is selected on the invoice form.

Continue to [Complete and save the invoice](#complete-and-save-the-invoice).

## Complete and save the invoice

Enter the invoice header values and item rows, then save the new invoice. The account-invoice
item grid uses the item, quantity, price, discount, tax, and currency values to calculate the
invoice summary.

**Prerequisites**

- The invoice form is open.
- **Account**, **Invoicing Address**, and **Issued By** are available.
- You have the invoice date, payment period, payment method, and item values.
- You have edit access.

**Steps**

1. In **Account**, select the account for an account invoice.
2. Enter the date in **Invoice Date**.
3. Select the billing destination in **Billing Address Destination** when one is available.
4. Enter the required address in **Invoicing Address**.
5. Set the count and period in **Payment Period**.
6. Select the issuer in **Issued By**.
7. Select the payment method in **Payment Method**.
8. Enter any supporting text in **Invoice Note**.
9. In the `Account Invoice` item grid, enter the item description in **Item**.
10. Enter the unit in **Unit**.
11. Enter the quantity in **Qty**.
12. Enter the unit amount in **Unit Price**.
13. Enter a percentage in **Discount (%)** when a discount applies.
14. Review the calculated **Item Price**.
15. Enter the tax percentage in **Tax (%)**.
16. Select the item **Currency**.
17. Save the invoice.

   | If you want to… | Select |
   | --- | --- |
   | Remain on the form | **Save** |
   | Leave the form | **Save and Close** |

The save controls are available only when edit access and changed data meet the toolbar conditions. A successful save shows `Invoice saved successfully`. A failed save shows `Invoice failed to save`; a processing problem shows `An error occurred while processing your request`.

**Result:** The invoice is saved when `Invoice saved successfully` appears. Continue to
[Review currency and totals](#review-currency-and-totals). If saving fails, continue to
[When validation fails](#when-validation-fails).

## When validation fails

Correct the value named by the validation message, then return to the save procedure. The form validates required header and item values before it processes the save request.

| Message | Correction |
| --- | --- |
| `This Field Is Required` | Enter the required value, including **Invoicing Address** when it is empty. |
| `This field is required` | Enter the required item value or other field value identified by the message. |
| `Invalid input. The value must be greater than 0 and cannot exceed 999,999.00` | Enter a quantity or other bounded number greater than zero and no higher than `999,999.00`. |
| `Invalid input. Please enter a non-negative value` | Replace a negative quantity, price, tax, or discount with a non-negative value. |
| `Validation errors:` | Review the validation messages beside the fields and correct each listed value. |
| `An error occurred while processing your request` | Review the invoice values, correct any visible validation problem, then select **Save** to retry the save. |

The form also validates **Invoicing Address**. Enter the address in that field and use only
the characters it accepts.

## Review currency and totals

The invoice summary shows the amounts produced from the item rows and payments. Review the summary after changing item values or currency so the amount due matches the invoice you intend to issue.

| Summary value | What it represents |
| --- | --- |
| **Invoice amount** | Calculated from the item values. |
| `Total taxes` | The tax total calculated from the item tax values. |
| `Total incl. tax` | The invoice total including tax. |
| **Paid Amount** | Already paid against the invoice. |
| **Deductions** | Recorded against the invoice. |
| **Due amount** | Remaining after paid amounts and deductions. |

Changing the currency recalculates the item and summary values in the selected currency. The account due calculation uses the due amount and its currency; a branch-currency display can show the due amount converted for the branch.

An invoice with a due amount less than or equal to zero is **Paid**. An invoice whose payment period is overdue is **Overdue**. Otherwise, the invoice is **Due**.

## Out of scope

Creating the invoice ends after the new record is saved. The saved invoice workspace owns the related work below:

| Saved-record area | Work to continue elsewhere |
| --- | --- |
| **Comments** | Add or review discussion on the saved record. |
| **Attachment** | Manage attached files. |
| **Tasks** | Manage tasks linked to the saved record. |
| **Activities** | Manage activities linked to the saved record. |
| **Deductions** | Review or maintain deductions after the invoice exists. |
| **Payments** | Record or review payments after the invoice exists. |
| Principal **Invoice** | Continue principal-invoice work on the principal-invoice page. |
| **Last Modifications** | Review saved-record history. |

The saved invoice can embed files, activities, tasks, address, and contact components, but those components belong to their own follow-up work rather than the new-invoice procedure. Use [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), and [Libraries](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/libraries-files) for those separate tasks.

## Continue with the saved invoice

After saving, continue with the invoice lifecycle for status and approval work.

| After saving, if you need to… | Continue with |
| --- | --- |
| Check the invoice status, including **Draft**, **Approved**, **Due**, **Overdue**, or **Paid** | [Invoice lifecycle](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/invoice-lifecycle) |
| Request approval or approve an eligible invoice | [Invoice lifecycle](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/invoice-lifecycle) |
| Record money received | [Record a payment](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/record-payment) |
| Continue principal-invoice work | [Principal invoices](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/principal-invoices) |

Start the next action from the saved invoice rather than returning to the new-invoice form.
