# 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="/files/ts8fPfqbLDiTcIUxDIFG" alt=""><figcaption><p>Location Hierarchy Diagram</p></figcaption></figure>

<figure><img src="/files/FchbHMQ5f3Cv9zksfAvm" 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="/files/uXz0X19jpNESanypBv8z" 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](/api/api-keys.md) 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="/files/o8F3q943h9wH1dKyVnC3" 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="/files/QvYBb94ZDuZzxxGFUXkC" 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="/files/ZMInBrJQP5NaWjCU1Y58" 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="/files/c1CpeS81e9tsNeyLZd5b" 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="/files/SlCXEFQrbWzn8RSEFlir" alt=""><figcaption></figcaption></figure>

Coming Soon:

1. Consumption of substitute parts<br>


---

# Agent Instructions: 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:

```
GET https://manual.firstresonance.io/automations/auto-consumption-of-lineside-inventory.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.