> For the complete documentation index, see [llms.txt](https://kb.bevica.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://kb.bevica.com/documentation/guides/items-and-inventory/item_substitutions.md).
# Item Substitutions
Define item substitutions to suggest alternatives during sales.
Bevica has the ability to easily swap items on sales orders and quotes when, for example, you are out of stock of one or the customer asks for an alternative.
{% hint style="warning" %}
**Prerequisites**
Ability to manage item and sales/assembly documents.
{% endhint %}
### Item Card
Substitutions are manually set against an item.
* From the Item List, navigate to Actions, Item Substitutions.
* From the Item Card navigate to Related, Item, Substitutions
This opens the **Item Substitutions Entries** page.
| Field | Note |
| ----------------- | ---------------------------------------------------------------------------------------------------------------------------- |
| Substitution Type | Set this to Item. |
| Substitute No. | Set the substitute item number. |
| Description | This defaults to the substitute item's description but can be changed. The description here will be copied to the sale line. |
| Interchangeable | Set this to Yes if you want the substitution to work both ways. |
| Condition | This denotes if there is explanatory text against the line. You can add the text by selecting Condition on the page ribbon. |
| Variant Code | Best to leave this field blank so that the substitution is available on all orders. |
### Sales Order & Quotes
These documents have the ability to swap an existing item for a substitute, the **Sales Line Details** factbox shows you if the item has any predefined substitutions.
* From the document subform, select Line, Related Information, **Select Item Substitutions**.
* From **Sales Line Details** factbox find the Substitutions line and click the number.
The **Item Substitution Entries** page that appears shows you the pre-defined substitute items alongside their total available stock. You can also read the **Condition** text for any line.
Once ready, highlight the line you want to swap and click **OK**. When you do this, the item on the sales line will be swapped for the substitution item.
{% hint style="warning" %}
**Notes:**
* The new item applies its own pricing.
* The old and new items must have the same units of measure.Notes
{% endhint %}
### Reporting on Substitutions
The sales line also records the old item in a hidden field '**Originally Ordered No.**'. This can be used for reporting on the sales document line or on the posted document lines.
To view an A4 report of items setup with their substitutions, search for report **Item Substitutions.**
### Other documents
Substitutions are also available on:
* Assembly Quotes
* Assembly Orders
* Blanket Assembly Order
---
# 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 dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:
```
GET https://kb.bevica.com/documentation/guides/items-and-inventory/item_substitutions.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.
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.
