> 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/orders/taxes-in-orders.md).

# Taxes in Orders

Apply tax codes to PO line items, automatically calculate per-line tax amounts, and display tax breakdowns in the order summary and totals

The **Tax Module** allows you to apply tax codes to purchase order line items, automatically calculating tax amounts and displaying them in order totals.

## Overview

When the tax module is enabled for your organization, you can:

* Apply one or more tax codes to each order line item
* Automatically calculate tax amounts based on line item costs
* View tax breakdowns in the order summary
* See total taxes included in order totals

{% hint style="info" %}
Taxes are calculated and applied at the **line item level**, giving you flexibility to apply different tax rates to different items on the same order.
{% endhint %}

## Prerequisites

Before you can use taxes in orders, the tax module must be enabled:

1. Navigate to **Organization Settings** → **Taxes**
2. Toggle **Enable Tax Module** to enable tax functionality
3. Create tax codes as needed (see [Taxes Settings documentation](https://docs.silkline.ai/profile-and-settings/organization-settings/taxes.md))

Only users with **Silkline Admin** permissions can enable the tax module.

## Applying Tax Codes to Line Items

When creating or editing an order with the tax module enabled:

1. Navigate to the **Line Items** section of the order form
2. For each line item, locate the **Tax Codes** field
3. Click the field to open the tax code selector
4. Select one or more tax codes to apply to that line item

### Multiple Tax Codes

You can apply **multiple tax codes** to a single line item. This is useful for scenarios where you need to combine different tax rates, such as:

* **State Tax + Local Tax** – Applying both state and city/county taxes
* **Base Tax + Surcharge** – Combining a standard rate with an additional surcharge
* **Multiple Jurisdictions** – Handling taxes across different tax jurisdictions

When multiple tax codes are applied, their rates are **added together** to calculate the total tax rate for that line item.

### Required Tax Codes

If your organization requires tax codes on order lines, the **Tax Codes** field shows a red asterisk, and each line needs at least one tax code before the order can be saved. This includes shipping and other charge lines; apply a 0% code to any line that isn't taxed. See [Require Tax Codes on Order Lines](https://docs.silkline.ai/profile-and-settings/organization-settings/taxes.md#require-tax-codes-on-order-lines).

<figure><img src="https://2684497859-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwPsevXC0g5kNMF7GTyPN%2Fuploads%2Fgit-blob-eeff022bab9c960d8e31fa3357e6b43f046eda6b%2Forder-form-tax-code-required.png?alt=media" alt="Required Tax Codes field showing Tax code is required on lines without a tax code"><figcaption><p>Lines without a tax code when tax codes are required</p></figcaption></figure>

## Tax Calculations

Taxes are calculated automatically based on:

* **Line item quantity** × **Unit cost** = Base cost
* **Base cost** × **Tax rate(s)** = Tax amount

The tax amount is calculated for each line item individually, then aggregated in the order summary.

### Tax Inclusivity

Purchase orders can be configured to include taxes in the subtotal. When the **Tax Inclusive** toggle is enabled at the PO level, tax amounts are included in the subtotal calculation rather than being added separately. This affects how the order totals are displayed and calculated.

### Example

For a line item with:

* Quantity: 10 units
* Unit cost: $100.00
* Tax codes: "State Tax" (8.5%) + "Local Tax" (2.0%) = 10.5% total

Calculation:

* Base cost: 10 × $100.00 = $1,000.00
* Tax amount: $1,000.00 × 10.5% = $105.00

## Viewing Tax Totals

Tax information appears in the **Order Summary** section of the order form and on completed orders:

* **Subtotal** – Total of all line items before taxes
* **Taxes** – Total tax amount, broken down by tax code
* **Total** – Final order total including taxes

The tax breakdown shows:

* **Total taxes** – Sum of all tax amounts across all line items
* **Individual tax codes** – Each tax code with its calculated amount

### Example: Order with Taxes Applied

The following example shows an order with taxes applied to line items:

## Best Practices

* **Enable the tax module** before creating orders that require tax calculations
* **Create tax codes** that match your organization's tax structure (state, local, etc.)
* **Apply tax codes consistently** across similar line items for accurate reporting
* **Review tax totals** in the order summary before submitting orders

{% hint style="success" %}
Tax codes can be filled down to multiple line items using the fill-down feature, just like other line item fields.
{% endhint %}

## Related Documentation

* [Organization Settings - Taxes](https://docs.silkline.ai/profile-and-settings/organization-settings/taxes.md) – How to enable the tax module and manage tax codes
* [Create or Sync Orders](https://docs.silkline.ai/orders/create-or-sync-orders.md) – General information about creating orders
