> For the complete documentation index, see [llms.txt](https://docs.xorosoft.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.xorosoft.com/xoroerp-1/inventory/item-inventory-snapshot/bom-producible-debounce.md).
# BOM Producible Debounce
### Overview
XoroERP calculates the **Producible Quantity** for manufactured items by evaluating the available inventory of the raw materials defined in their Bill of Materials (BOM). This allows users to quickly determine how many finished goods can be manufactured using the inventory currently available.
To ensure these calculations remain accurate while maintaining optimal system performance, XoroERP automatically refreshes BOM producible quantities after inventory changes. Instead of recalculating after every individual inventory transaction, the system intelligently processes inventory updates and refreshes the producible quantities after a short interval, providing users with an accurate view of their current manufacturing capacity.
***
#### How Producible Quantity Works
For every manufactured item, XoroERP evaluates the available inventory of each component defined in its Bill of Materials.
The raw material with the lowest available quantity determines the maximum number of finished products that can currently be manufactured.
**Example**
A manufactured item, "**Water Bottle"** requires:
| Component | Quantity Required |
| --------- | ----------------: |
| Bottle | 1 |
| Cap | 1 |
| Label | 1 |
Current inventory:
| Component | Available Quantity |
| --------- | -----------------: |
| Bottle | 100 |
| Cap | 60 |
| Label | 80 |
Although sufficient Bottles and Labels are available, only **60 Caps** exist in inventory.
Therefore, XoroERP calculates:
**Producible ATS Quantity = 60**
This indicates that a maximum of **60 Water Bottles** can currently be produced until additional Caps become available.
***
### Prerequisites
### Prerequisites
Before using the **BOM Producible Debounce** functionality, ensure the following settings are enabled:
#### Show BOM Inventory Levels in Inventory Snapshot
Enable the **Show BOM Inventory Levels in Inventory Snapshot** setting to display BOM-related inventory information, including **Producible ATS Quantity**, **Producible Available Quantity**, and other producible inventory fields across the supported modules.
#### Live Update BOM Inventory with Inventory Change
Enable the **Live Update BOM Inventory with Inventory Change** setting to automatically refresh the producible quantities whenever inventory changes affect the raw materials used in a Bill of Materials (BOM).
{% hint style="info" %}
This setting only works when **Show BOM Inventory Levels in Inventory Snapshot** is enabled.
{% endhint %}
Once both settings are enabled, XoroERP automatically refreshes BOM producible quantities after inventory or BOM changes using the default refresh interval of approximately **15 seconds**.
***
### How BOM Producible Debounce Works
The **BOM Producible Debounce** functionality ensures that the **Producible ATS Quantity** displayed for manufactured items remains up to date whenever inventory or Bill of Materials (BOM) information changes.
For example, if a manufactured item requires one unit of a raw material to produce one finished item, and **60 units** of the raw material are currently available, XoroERP calculates the **Producible ATS Quantity** as **60**, indicating that up to 60 finished items can be manufactured with the available inventory.
Whenever the inventory of a BOM component changes—for example, through a purchase receipt, inventory adjustment, sales shipment, or inventory transfer—the available quantity of raw material changes as well. Since the manufacturing capacity depends on the available raw materials, the **Producible ATS Quantity** must also be recalculated.
Instead of recalculating the producible quantity after every individual inventory transaction, XoroERP waits for a short period (approximately **15 seconds** by default) after the most recent inventory or BOM update before performing the calculation. This allows multiple changes occurring within a short period to be processed together, resulting in a single accurate update.
The producible quantities are automatically refreshed when:
* Inventory is increased or decreased for any raw material used in a BOM.
* A Bill of Materials (BOM) is created or updated by adding, removing, or modifying components.
This approach ensures that users always see accurate manufacturing capacity while improving system performance during periods of frequent inventory activity.
***
### Automatic Producible Quantity Refresh
Once both the App Config settings are enabled, XoroERP continuously monitors inventory activity affecting the components of manufactured items.
Whenever inventory changes occur, standard inventory quantities such as **On Hand**, **Available**, and **Available to Sell (ATS)** are updated immediately.
The system then automatically refreshes the BOM producible quantities approximately 15 seconds after the most recent inventory change **(default)**.
If additional inventory transactions occur during this interval, XoroERP waits until inventory activity has completed before recalculating the producible quantities. This ensures that the calculation is performed using the latest inventory values while avoiding unnecessary repeated processing.
Once the refresh is complete, the updated producible quantities become available throughout all BOM-related planning screens.
***
### What Triggers the Automatic Refresh?
The producible quantity refresh is initiated whenever inventory changes affect the availability of BOM components or whenever the BOM definition itself is modified.
Common inventory transactions include:
* Purchase Order Receiving
* Inventory Receipts
* Inventory Adjustments
* Inventory Transfers
* Sales Shipments
* Manufacturing Receipts
* Manufacturing Consumption
* Any inventory increase or decrease affecting BOM components
The refresh is also triggered when changes are made to the Bill of Materials, including:
* Adding or removing components
* Updating component quantities
* Modifying the BOM structure
***
### Modules Impacted
The refreshed producible quantities are automatically reflected in all areas of XoroERP that display BOM inventory planning information.
#### Item Inventory Snapshot
Displays updated BOM inventory information, including:
* Producible ATS Quantity
* Producible Available Quantity
* Other producible inventory columns
Standard inventory values continue to update immediately after inventory transactions.
***
#### Item Master
Inventory details for manufactured items display the refreshed producible quantities once the automatic update has completed.
***
#### Short Inventory Planner
Planning recommendations are generated using the latest producible quantities, allowing purchasing and manufacturing teams to make informed replenishment decisions.
***
#### BOM Inventory Planning
The **Inventory** tab within the BOM module displays refreshed producible quantities, providing planners with an accurate representation of the current manufacturing capacity.
***
### Example Scenario
A warehouse receives several shipments of raw materials for the same manufactured item within a short period.
Each receipt immediately updates the available inventory quantities. After inventory activity has stopped, XoroERP automatically recalculates the producible quantity using the latest inventory balances.
Approximately **15 seconds** after the final inventory transaction, the refreshed producible quantities become available across all supported modules, allowing production planners to view the current manufacturing capacity without requiring any manual action.
**The functionality is working as intended when:**
* Standard inventory values update immediately after inventory transactions.
* Producible quantities refresh approximately **15 seconds** after the most recent inventory change.
* Multiple inventory transactions occurring within the refresh interval result in a single updated producible quantity.
* All supported modules display the same refreshed producible inventory values after the automatic update completes.
***
#### Benefits
This functionality helps organizations:
* Automatically maintain accurate BOM producible quantities.
* Improve manufacturing planning by reflecting the latest inventory availability.
* Reduce unnecessary system processing during frequent inventory updates.
* Automatically synchronize producible quantities across all supported modules.
* Eliminate the need for manual refreshes after inventory transactions.
***
---
# 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://docs.xorosoft.com/xoroerp-1/inventory/item-inventory-snapshot/bom-producible-debounce.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.