> For the complete documentation index, see [llms.txt](https://help.supplyd.co/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.supplyd.co/supplyd-erp/expenses/expense-agent.md).

# Expense Agent

The Supply’d Expense Module keeps a sharp eye on every dollar spent on products and materials - so you don’t have to.

The **Expense Agent** in Supply’d helps automate supplier invoice processing and reconciliation, reducing manual work and improving efficiency. Using information extracted by Expense Intelligence, the agent can perform authorised expense-related actions or request approval when required.

This allows businesses to streamline invoice processing while maintaining control over how expenses are managed.

## Expense Agent Settings

The **Expense Agent** uses Supply’d Intelligence to help automate expense reconciliation by reviewing supplier invoices and performing reconciliation tasks.

You can configure which actions the Expense Agent is allowed to perform automatically and which require your approval.

**Note:** Expense Agent Settings are only available to **Supply’d ERP accounts** and users with access to **Settings**.

### Configuring Expense Agent Permissions

1. Open **Settings**.
2. Navigate to the new **Expense Agent** settings section.
3. Select which actions the Expense Agent can perform without requiring your approval.
4. Save your settings.

**\[Insert updated Settings screenshot showing the Expense Agent section]**

**Note:** Any actions that have not been authorised for automatic processing will require your approval when the Expense Agent runs. The agent will request approval before proceeding with each of these actions.

Configuring these permissions allows you to control how much of the reconciliation process is automated while maintaining oversight of important changes.

***

## Using the Expense Agent

The **Expense Agent** uses Supply’d Intelligence to assist with expense reconciliation by reviewing supplier invoices and performing reconciliation tasks.

It helps reduce manual work while allowing you to review and approve actions based on your configured permissions.

***

### Understanding Expense Agent Status Icons

On the **Expenses** page, icons appear beside purchase orders to indicate the status of invoice processing and Expense Agent activity.

| Icon                                      | Description                                                                |
| ----------------------------------------- | -------------------------------------------------------------------------- |
| 🟡 Yellow dot                             | The invoice is currently being processed.                                  |
| 🟢 Green dot                              | The invoice has been scanned and processed.                                |
| Supply’d Intelligence icon                | The Expense Agent is running or has previously run for the purchase order. |
| Supply’d Intelligence icon with green dot | The Expense Agent has run or is running, and the invoice has been scanned. |

**Note:** Hover over any of these icons to view an explanation of what the status means.

**\[Insert screenshot showing the status icons beside purchase orders]**

***

### Running the Expense Agent

You can run the Expense Agent directly from a purchase order on the **Expenses** page.

{% stepper %}
{% step %}

#### Select the Purchase Order

<figure><img src="https://2965503026-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDaPYJDB89ny0x7wcMedb%2Fuploads%2FbJDih3Dwv41QavjV1QDa%2FSpacer.png?alt=media&amp;token=6c34f805-9610-4de9-8f8a-a029f13dd1a1" alt=""><figcaption></figcaption></figure>

1. Select **Expenses** from the main menu.
2. Locate the purchase order you want to reconcile.
3. Click the **three-dot menu** beside the purchase order.
4. Expand **Actions**.
5. Select **Run Expense Agent**.

<figure><img src="https://2965503026-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDaPYJDB89ny0x7wcMedb%2Fuploads%2FbJDih3Dwv41QavjV1QDa%2FSpacer.png?alt=media&amp;token=6c34f805-9610-4de9-8f8a-a029f13dd1a1" alt=""><figcaption></figcaption></figure>

**\[Insert screenshot showing Actions → Run Expense Agent]**

<figure><img src="https://2965503026-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDaPYJDB89ny0x7wcMedb%2Fuploads%2FbJDih3Dwv41QavjV1QDa%2FSpacer.png?alt=media&amp;token=6c34f805-9610-4de9-8f8a-a029f13dd1a1" alt=""><figcaption></figcaption></figure>

{% hint style="warning" %}
**Important:** An invoice must be added before running the Expense Agent. If no invoice is available, the agent will not be able to proceed with reconciliation.
{% endhint %}

<figure><img src="https://2965503026-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDaPYJDB89ny0x7wcMedb%2Fuploads%2FbJDih3Dwv41QavjV1QDa%2FSpacer.png?alt=media&amp;token=6c34f805-9610-4de9-8f8a-a029f13dd1a1" alt=""><figcaption></figcaption></figure>

***

{% endstep %}

{% step %}

#### Review and Approve Actions

Once the Expense Agent starts, it will review the available invoice information and perform reconciliation tasks.

Depending on your **Expense Agent Settings**, some actions may be completed automatically, while others will require your approval.

When approval is required:

1. Review the action the Expense Agent wants to perform.
2. Hover over the action description to see exactly what the agent intends to change.
3. Review the details before deciding whether to approve the action.
4. Approve the action if you are happy for the agent to proceed.

<figure><img src="https://2965503026-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDaPYJDB89ny0x7wcMedb%2Fuploads%2FbJDih3Dwv41QavjV1QDa%2FSpacer.png?alt=media&amp;token=6c34f805-9610-4de9-8f8a-a029f13dd1a1" alt=""><figcaption></figcaption></figure>

**\[Insert screenshot showing an Expense Agent approval request]**

<figure><img src="https://2965503026-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDaPYJDB89ny0x7wcMedb%2Fuploads%2FbJDih3Dwv41QavjV1QDa%2FSpacer.png?alt=media&amp;token=6c34f805-9610-4de9-8f8a-a029f13dd1a1" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
**Note:** Actions that have been authorised in **Expense Agent Settings** can be performed without requesting approval. All other actions require your approval before the agent can proceed.
{% endhint %}

<figure><img src="https://2965503026-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDaPYJDB89ny0x7wcMedb%2Fuploads%2FbJDih3Dwv41QavjV1QDa%2FSpacer.png?alt=media&amp;token=6c34f805-9610-4de9-8f8a-a029f13dd1a1" alt=""><figcaption></figcaption></figure>

***

{% endstep %}

{% step %}

#### Monitor Expense Agent Activity

While the Expense Agent is running, you can monitor its progress under the **Agent** section.

Select **Open Activity** to expand the activity panel and view the steps the agent is performing.

You can:

* View the actions the agent is working through.
* Hover over action descriptions to see additional details.
* Review any actions awaiting your approval.
* Select **Hide Activity** to collapse the activity panel.

**\[Insert screenshot showing the Agent Activity panel]**

**Note:** While the Expense Agent is running, the **Run Expense Agent** option will be disabled. This prevents multiple agent runs from operating on the same purchase order simultaneously.

<figure><img src="https://2965503026-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDaPYJDB89ny0x7wcMedb%2Fuploads%2FbJDih3Dwv41QavjV1QDa%2FSpacer.png?alt=media&amp;token=6c34f805-9610-4de9-8f8a-a029f13dd1a1" alt=""><figcaption></figcaption></figure>

***

{% endstep %}

{% step %}

#### Review Completed Actions

Once the Expense Agent has finished running, Supply’d will prompt you to **Refresh** the page to display the updated information.

Before refreshing, you can open **Agent History** to review the actions completed by the agent.

This allows you to check what has changed before viewing the updated purchase order.

<figure><img src="https://2965503026-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDaPYJDB89ny0x7wcMedb%2Fuploads%2FbJDih3Dwv41QavjV1QDa%2FSpacer.png?alt=media&amp;token=6c34f805-9610-4de9-8f8a-a029f13dd1a1" alt=""><figcaption></figcaption></figure>

#### **\[Insert screenshot showing the refresh prompt]**

<figure><img src="https://2965503026-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDaPYJDB89ny0x7wcMedb%2Fuploads%2FbJDih3Dwv41QavjV1QDa%2FSpacer.png?alt=media&amp;token=6c34f805-9610-4de9-8f8a-a029f13dd1a1" alt=""><figcaption></figcaption></figure>

{% endstep %}
{% endstepper %}

***

### Viewing Expense Agent History

The **Agent History** option allows you to review previous Expense Agent runs for a purchase order.

To view the history:

1. Locate the relevant purchase order on the **Expenses** page.
2. Click the **three-dot menu** beside the order.
3. Expand **Actions**.
4. Select **Agent History**.

**\[Insert screenshot showing Actions → Agent History]**

The history displays information about previous agent runs, including:

* How many times the Expense Agent has been run.
* The actions performed during each run.
* An AI-generated summary of the completed actions.

**Note:** The wording and level of detail in the activity summaries may vary, as they are generated by Supply’d Intelligence.

Reviewing Agent History helps you understand what the Expense Agent has done and check any changes made during reconciliation.

***

### Running the Expense Agent Again

You can run the Expense Agent again if you need it to review the purchase order after a previous run.

If the agent has already been run, Supply’d will display a confirmation prompt before starting another run.

1. Open the **three-dot menu** beside the purchase order.
2. Expand **Actions**.
3. Select **Run Expense Agent**.
4. Review the confirmation message.
5. Confirm if you want to run the agent again.

{% hint style="warning" %}
**Note:** The Expense Agent cannot be started again while an existing run is still in progress. You must wait until the current run has finished.
{% endhint %}

***

### Tips for Using the Expense Agent

* Ensure the supplier invoice has been added before running the agent.
* Configure your Expense Agent permissions to determine which actions require approval.
* Hover over action descriptions to understand proposed changes before approving them.
* Use **Open Activity** to monitor the agent's progress.
* Review **Agent History** to check completed actions before refreshing the purchase order.
* Check the reconciled purchase order to ensure the results are correct.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://help.supplyd.co/supplyd-erp/expenses/expense-agent.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
