# Auto-Consumption of Lineside Inventory

### Introduction

This automation will speed up your production processes by reducing the manual input of data into your assemblies' as-built records. When you complete either the first or last step of a run, the automation will search for available locations and consume inventory based on the mBOM for that run. Serial-tracked items will not be consumed. This automation will consume older revisions of the same part.

### Part Interchangeability

This automation will consume older revisions of the same part if they are available. For example, let say you have 3 revisions of the same part with inventory at the location:

* Rev A - Quantity of 10 on hand at the location
* Rev B - Quantity of 30 on hand at the location
* Rev C - Quantity of 5 on hand at the location

If the mBOM requires a quantity of 40 of that part then auto consumption will consume:

* 5 of Rev C
* 30 of Rev B
* 5 of Rev A

### Setup

This manual guides users through setting up an auto consumption system to automatically consume lineside inventory upon completion of a designated run step.

### Getting Started

#### Key Concepts

* **aBOM (As-Built Record)**: A digital record of components used in production.
* **Auto Consumption**: Automated consumption of inventory items from predefined locations.

### Setup

To ensure the automation runs correctly you need to set up a location hierarchy and locations on the procedures you want to run Auto Consumption for.

#### Location Hierarchy:

Below is an example of the location hierarchy you will need to set up in order for the automation to run. 

* **Workstation:** This is where the run steps are being completed. Can have inventory stored on itself or have child racks/totes under it.
* **Child:** The parent location is a workstation. Tote or rack.
* **Parent:** This is a work cell or work area. Can contain workstations and one lineside rack. Workstations under this parent will pull from the one rack.
* **Sibling:** Lineside rack location. Workstations have access to this location (MOST COMMON METHOD OF CONSUMPTION)

<figure><img src="https://3615148728-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LkRqYp6lJhwxjYdzYG8%2Fuploads%2FJ3eF3cTurWNF9mBsDaGu%2Fimage.png?alt=media&#x26;token=223601cb-e165-4e10-8903-71fc28338605" alt=""><figcaption><p>Location Hierarchy Diagram</p></figcaption></figure>

<figure><img src="https://3615148728-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LkRqYp6lJhwxjYdzYG8%2Fuploads%2Fvsuf2LEvrStTonpYrYh7%2FScreenshot%202024-04-10%20at%205.17.10%E2%80%AFPM.png?alt=media&#x26;token=92366ee7-0fa7-4106-a7bc-3c837d6c1343" alt=""><figcaption><p>Example Location Hierarchy in ION</p></figcaption></figure>

* In the above example, the work is being done at the location called "Workstation." Because both "Lineside Rack 1" & "Lineside Rack 2" are siblings of "Workstation," both are candidates for autoconsumption.&#x20;

**Procedure Configuration:**

To get the automation to run correctly you will need to specify a location on the procedure step. This will be the workstation location. To do so, use the drop-down in the procedure editor as shown here:

* We recommend that you set up a location on every step but at this time only the first or last steps need to have a location specified for the automation to run correctly

<figure><img src="https://3615148728-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LkRqYp6lJhwxjYdzYG8%2Fuploads%2F71rdBUIodmpi7szJbTqD%2FScreenshot%202023-11-16%20at%204.25.26%20PM.png?alt=media&#x26;token=def8bd93-d9f7-4fb5-8502-16a8ac827c90" alt=""><figcaption></figcaption></figure>

### Configuring the Automation

Navigate to our [integrations page](https://staging.firstresonance.io/integrations) and search for Auto-Consumption. Press configure

#### Step 1: Configure ion-api Connection&#x20;

* refer to the [API key](https://manual.firstresonance.io/api/api-keys) documentation for information on how to get your API keys
* input your API keys into the following boxes and select your environment

<figure><img src="https://3615148728-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LkRqYp6lJhwxjYdzYG8%2Fuploads%2F5E7s1uAhAbsWuByENPab%2FScreenshot%202023-11-16%20at%203.52.52%20PM.png?alt=media&#x26;token=0c9447bd-88a7-4c85-962e-071921ed89fe" alt=""><figcaption></figcaption></figure>

**Step 2: Setup Consumption Methodology**

* Consumption Method:&#x20;
  * **First:** first step of run (recommended)
  * **Last:** last step of run
* Consumption Location (see diagram above for more information):&#x20;
  * **workstation**: consume directly from inventory at the workstation where the run step is being worked on
  * **child**: consume from child rack or tote of the workstation (limit 1 per workstation)
  * **sibling**: consume from the rack that is a sibling of the workstation (has the same parent as the workstation limit 1 per parent). Example: lineside rack

<figure><img src="https://3615148728-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LkRqYp6lJhwxjYdzYG8%2Fuploads%2FR56JgErKSe04czj1FhQ5%2FScreenshot%202023-11-16%20at%203.54.49%20PM.png?alt=media&#x26;token=18b71a62-9d92-42a9-8f64-bba46f59da3b" alt=""><figcaption></figcaption></figure>

**Step 3 (Optional): Setup a Manual Trigger**

The Auto-Consumption automation lets you configure a manual trigger. This is useful for situations when part inventory present on the build requirements gets moved to consumption location after auto-consumption has run.&#x20;

To configure this, add a  boolean custom attribute on Runs.&#x20;

<figure><img src="https://3615148728-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LkRqYp6lJhwxjYdzYG8%2Fuploads%2FGDLUwH2HhoqVguIrakLJ%2FScreenshot%202025-06-13%20at%201.28.36%E2%80%AFPM.png?alt=media&#x26;token=c7d7bad8-50d1-45f6-a77c-8c9dce5e36f4" alt=""><figcaption><p>Custom Attribute on Runs</p></figcaption></figure>

While configuring the Integration set the Manual Trigger Custom Attribute value to the name of the custom attribute you've added.&#x20;

<figure><img src="https://3615148728-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LkRqYp6lJhwxjYdzYG8%2Fuploads%2FdNypXaZ6mdDq4GHwMCJR%2FScreenshot%202025-06-13%20at%201.31.03%E2%80%AFPM.png?alt=media&#x26;token=75d4e867-ae42-4498-9963-071985af7682" alt=""><figcaption></figcaption></figure>

To use the manual trigger, navigate to the desired run, open the Run Attributes and Labels modal and toggle the custom attribute we've just added from false to true. Note: toggling from no selection to True will not trigger, must be from False to True.&#x20;

<figure><img src="https://3615148728-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LkRqYp6lJhwxjYdzYG8%2Fuploads%2FSSbN6HJbL7gwRA8CksIy%2FScreenshot%202025-06-13%20at%201.35.14%E2%80%AFPM.png?alt=media&#x26;token=0147fabe-7f92-461c-99de-adcdc04df29c" alt=""><figcaption></figcaption></figure>

Coming Soon:

1. Consumption of substitute parts<br>