> For the complete documentation index, see [llms.txt](https://docs.silkline.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.silkline.ai/budgets.md).

# Budgets

Create budgets, assign POs and request items, monitor billed, committed, and proposed spend in real time, and automatically route budget owners into approvals

Silkline's Budgets feature helps organizations track procurement spending against allocated budget amounts. Assign purchase order and request items to budgets, monitor billed, committed, and proposed spend in real-time, and ensure budget owners review purchases through automatic approval routing.

<figure><img src="https://2684497859-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwPsevXC0g5kNMF7GTyPN%2Fuploads%2Fgit-blob-1ee887cf0501bf21d14bbdc7393d6b09d2beee90%2Fbudgets-table.png?alt=media" alt=""><figcaption></figcaption></figure>

## Creating a Budget

To create a new budget:

1. Navigate to **Budgets** from the main navigation
2. Click **Create Budget**
3. Fill in the budget details:
   * **Name** — A unique identifier for the budget
   * **Description** — Optional details about the budget's purpose
   * **Amount** — The total budget allocation
   * **Currency** — The currency for the budget (can differ from order currencies)
   * **Include Taxes** — Whether budget tracking includes or excludes taxes
   * **Owners** — Optional users responsible for reviewing this budget

<figure><img src="https://2684497859-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwPsevXC0g5kNMF7GTyPN%2Fuploads%2Fgit-blob-1f5edc9e6a02bb6c6d472f16ea6514eb476cb522%2Fbudgets-create-form.png?alt=media" alt="" width="375"><figcaption></figcaption></figure>

{% hint style="info" %}
**Budget Owners** are automatically added to the approval workflow for any orders containing items assigned to their budgets. Owners do not control who can assign items to the budget.
{% endhint %}

## Reviewing Budget Spend

Each budget tracks spending across three stages:

| Spend Type    | Description                                                                                            |
| ------------- | ------------------------------------------------------------------------------------------------------ |
| **Billed**    | The billed quantity on order lines in OPEN or CLOSED state, plus any [external spend](#external-spend) |
| **Committed** | The quantity not yet billed on order lines in OPEN or CLOSED state                                     |
| **Proposed**  | Planned spending from orders in DRAFT, REVIEW, or APPROVED state                                       |

A line's billed quantity comes from your connected billing system, such as NetSuite. Billed quantity above the ordered quantity is not counted, so billed spend never exceeds the line's cost. Orders with no billing data show all OPEN and CLOSED spend as committed. Credit lines (negative quantities) are never billed, so they reduce committed spend, which can make it negative.

The budget detail page displays a visual progress bar showing how much of the budget has been consumed:

<figure><img src="https://2684497859-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwPsevXC0g5kNMF7GTyPN%2Fuploads%2Fgit-blob-d48d61c785fad19422c50b5d8f472e78fe0b90c7%2Fbudgets-spend-summary.png?alt=media" alt=""><figcaption></figcaption></figure>

The bar shows billed spend in dark blue, committed spend in medium blue, and proposed spend in light blue. Once spend exceeds the budget, the bar rescales to fit all spend and a line marks the budget amount.

### Budget Status

A status badge above the bar summarizes the budget:

* **In budget** — Total spend is at or below the budget amount
* **Over budget** — Total spend exceeds the budget amount

### Sub-budget Spend

When a budget has sub-budgets, the progress bar and status also count their spend. Each stage in the legend shows its total and how much of it comes from sub-budgets. Spend in a different currency is converted to the budget's currency; spend in a currency with no available exchange rate is left out, and the **Sub-budget Spend** chart on the budget page notes that some spend was excluded.

{% hint style="warning" %}
Silkline displays warnings when budgets are over-allocated but does not prevent orders from being placed against over-budget budgets.
{% endhint %}

## External Spend

**External spend** is money spent against a budget outside Silkline — for example, invoices paid directly, purchases made in another system, or spend that predates your use of Silkline. Recording it keeps the budget's utilization accurate even when not every purchase flows through a Silkline order.

External spend counts as **billed** spend and appears in the progress bar, the Spend Over Time chart, and the budget's totals alongside sent purchase orders.

<figure><img src="https://2684497859-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwPsevXC0g5kNMF7GTyPN%2Fuploads%2Fgit-blob-8c58fff85e061add68357d077a775520cdc63155%2Fbudgets-external-spend-tooltip.png?alt=media" alt=""><figcaption><p>Hover <strong>Add External Spend</strong> on any budget for a quick definition and a link back to this page.</p></figcaption></figure>

### Importing External Spend from a CSV

To record many entries at once, or to add spend across several budgets in one go:

1. Open any budget's detail page and click **Add External Spend**

<figure><img src="https://2684497859-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwPsevXC0g5kNMF7GTyPN%2Fuploads%2Fgit-blob-5a5ede7c565c09fffa8b7ded98cb4a8953255d38%2Fbudgets-external-spend-import.png?alt=media" alt=""><figcaption></figcaption></figure>

2. Upload a CSV file with a header row naming these columns:

| Column             | Required | Description                                                       |
| ------------------ | -------- | ----------------------------------------------------------------- |
| **Amount**         | Yes      | A non-negative number in the budget's currency                    |
| **Budget Name**    | Yes      | Must exactly match the name of an existing budget                 |
| **Effective Date** | No       | The date the spend applies to (e.g. `MM/DD/YYYY` or `YYYY-MM-DD`) |
| **Memo**           | No       | A short note describing the spend                                 |

3. Review the preview. Rows with problems (an unknown budget name, a missing or negative amount, or an effective date that can't be read) are listed with their line numbers and are skipped
4. Click **Accept** to save the valid rows

{% hint style="info" %}
Rows that name a different budget are recorded against that budget, not the one you opened the drawer from. Budget names are matched exactly, so double-check spelling and capitalization.
{% endhint %}

### Adding and Editing Entries

The **External Spend** tab on a budget's detail page lists every entry recorded against it.

<figure><img src="https://2684497859-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwPsevXC0g5kNMF7GTyPN%2Fuploads%2Fgit-blob-7643861e7b4da2e00f74e7eee2a4c96662fd32e4%2Fbudgets-external-spend-tab.png?alt=media" alt=""><figcaption></figcaption></figure>

From here you can:

* Click **Add external spend** to record a single amount, memo, and effective date without a CSV
* Edit an entry's amount, memo, or effective date
* Delete an entry

Entries synced from an integration are read-only in Silkline and can only be changed in the connected system.

Adding external spend requires the **Create Budget** permission, editing an entry requires **Edit Budget**, and deleting one requires **Delete Budget**.

### How External Spend Is Dated

An entry's effective date decides which day it lands on in the Spend Over Time chart and when it falls inside a date range filter. Entries without an effective date use the day they were recorded.

<figure><img src="https://2684497859-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwPsevXC0g5kNMF7GTyPN%2Fuploads%2Fgit-blob-1228fd78e32bfa817a19a0c97554088edc4ed456%2Fbudgets-spend-over-time.png?alt=media" alt=""><figcaption></figcaption></figure>

## Adding Budget to Line Items

Budget assignments happen at the line item level on purchase orders and requests:

1. When creating or editing a purchase order or request, locate the **Budget** column in the line items table
2. Click the dropdown for the line item you want to assign
3. Select the appropriate budget from the list

<figure><img src="https://2684497859-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwPsevXC0g5kNMF7GTyPN%2Fuploads%2Fgit-blob-2e5e03ec802ce6faeca86047b2d30454f4e58c3a%2Fbudgets-line-item-assignment.png?alt=media" alt=""><figcaption></figcaption></figure>

The item's cost is immediately reflected in the budget's spend calculations. When requests are converted to orders, budget assignments carry over automatically.

Budget availability is based on whether the budget is active and the user's normal order or request permissions. A budget does not need an owner to be selected on a line item.

{% hint style="success" %}
**Best Practice:** Assign budgets at the request stage to ensure consistent tracking throughout the procurement lifecycle.
{% endhint %}

## Budgets in Approval Workflow

When order items are assigned to budgets, the budget owners are automatically included in the approval workflow:

* Budget owners appear as **Budget Approvers** in the approval chain
* In the organization default approval chain, several budget owners are sequenced by approval limit, lowest first
* Budget information and utilization is displayed in the approval guide
* If a budget owner already appears elsewhere in the approval chain, they are not duplicated

Budgets without owners can still be used for spend tracking, but they will not add a budget approver to the approval workflow.

<figure><img src="https://2684497859-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwPsevXC0g5kNMF7GTyPN%2Fuploads%2Fgit-blob-8d81137ae021bc36139c0f33ed087a55203f2343%2Fbudgets-approval-workflow.png?alt=media" alt="" width="375"><figcaption></figcaption></figure>

For more information about how approvals work, see [Approvals](https://docs.silkline.ai/approvals.md).

## Viewing All Budgets

The **Budgets** page displays all budgets with key metrics:

| Column               | Description                                                                                                               |
| -------------------- | ------------------------------------------------------------------------------------------------------------------------- |
| **Name**             | Budget name and description                                                                                               |
| **Budget**           | Total allocated amount                                                                                                    |
| **Direct Spend**     | Combined billed, committed, and proposed spending on this budget, excluding sub-budgets                                   |
| **Direct Remaining** | Budget amount minus direct spend                                                                                          |
| **Utilization**      | Progress bar showing percentage used, including sub-budget spend; green under 85%, yellow from 85% to 100%, red when over |
| **Owners**           | Users responsible for the budget                                                                                          |
| **Status**           | Active or Archived                                                                                                        |

Sub-budgets are listed under their parent budget; expand a parent to see them, or click the **Expand all** arrows next to the **Name** header to open every level at once. When you search or filter, the list shows every matching budget as its own row, sub-budgets included, with no expand arrows. A sub-budget whose parent is archived or hidden from you appears as a top-level row. To list every budget as its own row, open the settings (gear) menu and turn on **Show Sub-budgets as Rows**.

To count only billed and committed spend, open the settings (gear) menu and turn on **Exclude Proposed Spend**. Direct Spend, Direct Remaining, Utilization, the chart view, and CSV exports then leave out proposed spend. Silkline remembers the setting in your browser.

Click on any budget to view its detail page, which includes:

* **Spend Summary** — Budget amount, owners, and progress visualization
* **Order Items Tab** — All purchase order line items assigned to this budget. Filter by order, supplier, buyer, requester, status, and more, or search by order number.
* **Request Items Tab** — All request items assigned to this budget. Filter by request, supplier, buyer, requester, status, and more, or search by request number.
* **External Spend Tab** — Spend recorded against this budget from outside Silkline. See [External Spend](#external-spend).
* **Spend Over Time Tab** — A day-by-day chart of billed, committed, and proposed spend, with rolling and custom date ranges.

## Multi-Currency Support

Budgets support multi-currency operations:

* A budget can be in one currency (e.g., USD) while orders are in different currencies (e.g., EUR, GBP)
* Silkline automatically converts order item costs to the budget's currency using current exchange rates
* Spending is tracked in the budget's currency for accurate utilization reporting

## Common Use Cases

### Project Budgets

Track spending for specific projects or programs:

```
Name: Project Falcon - Prototype Build
Amount: $150,000
Owners: Engineering Lead, Procurement Manager
```

### Department Budgets

Set up budgets for each department or cost center:

```
Name: Manufacturing - Q1 2025
Amount: $500,000
Owners: Manufacturing Manager
Include Taxes: Yes
```

### Program Budgets

Track spending across multiple projects within a program:

```
Name: R&D - Fiscal Year 2025
Amount: $2,000,000
Owners: R&D Director, Finance Controller
```

## Enabling Budgets

Budgets must be enabled for your organization before the feature is available. See [Budgets Settings](https://docs.silkline.ai/profile-and-settings/organization-settings/budgets.md) for detailed configuration options including:

* Enabling/disabling the feature
* Creating and managing budgets
* Archiving and deleting budgets
* Permission requirements
