# Partners

<figure><img src="/files/CFZj2hZstcQcWzO7t4ki" alt=""><figcaption></figcaption></figure>

***

## Definitions

A **Customer** is a partner who receives items from your inventory. \
Customers are linked to <mark style="color:blue;">`Stock Out`</mark> transactions and can be used to track sales orders.

A **Supplier** is a partner who provides items to your inventory. \
Suppliers are linked to <mark style="color:blue;">`Stock In`</mark> transactions and can be used to track purchase orders.

<figure><img src="/files/wRHJY3FPV3m2VwN99xrE" alt=""><figcaption></figcaption></figure>

{% hint style="success" %}
The <mark style="color:blue;">`Data Center`</mark> is one of the main tabs on BoxHero’s menu bar that allows users to manage data like items, attributes, and partners.
{% endhint %}

***

## How to Add Partners

### On Your Computer

1. Navigate to <mark style="color:blue;">`Data Center`</mark> > <mark style="color:blue;">`Partners`</mark>.
2. Click “**Add Partners**” in the top-right corner.
3. Choose between **Supplier** or **Customer**.
4. Enter the partner's details.
5. Click “**Add**.”

{% embed url="<https://customer-0jrbilsa8yt3k758.cloudflarestream.com/18079591f2004b22b534f4dee0fe8fbf/iframe?autoplay=true&controls=false&letterboxColor=transparent&loop=true&muted=true&poster=https://customer-0jrbilsa8yt3k758.cloudflarestream.com/18079591f2004b22b534f4dee0fe8fbf/thumbnails/thumbnail.jpg?height=1080&preload=true>" %}

### On Your Phone

You can add partners in the same way on the mobile app.

{% embed url="<https://customer-0jrbilsa8yt3k758.cloudflarestream.com/4016d43b52384092bdba00d5efe9e500/iframe?autoplay=true&controls=false&letterboxColor=transparent&loop=true&muted=true&poster=https://customer-0jrbilsa8yt3k758.cloudflarestream.com/4016d43b52384092bdba00d5efe9e500/thumbnails/thumbnail.jpg?height=1080&preload=true>" %}

### Add Multiple Partners

You can also add multiple partners at once using an Excel file by selecting one of the following under the “**Add Partners**” dropdown:

* Import Excel (Suppliers)
* Import Excel (Customers)

<figure><img src="/files/VIROaUSEFuiWW4Y2gOcq" alt=""><figcaption></figcaption></figure>

Make sure to download the template for reference. Your Excel file should include these columns:

* Name
* Phone Number
* Email
* Address
* Memo

***

## Partners & Inventory Transactions

### A. Stock Out to Customers

When recording a <mark style="color:blue;">`Stock Out`</mark> transaction, you can select one of the registered customers from your *Partners* list.

<figure><img src="/files/SHDzqqXo2g2xkFEaIKai" alt=""><figcaption></figcaption></figure>

### B. Stock In from Suppliers

For a <mark style="color:blue;">`Stock In`</mark> transaction, you can select one of the registered suppliers from your *Partners* list.

<figure><img src="/files/rx1B9FBhe4jSWsovMYAj" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
**Note:** If you don’t need to add a partner, you can skip this step and continue.
{% endhint %}

***

## Managing Orders for Partners

### A. Sales Orders for Customers

You can create a Sales Order (SO) for a specific customer and keep track of your orders.

1. Go to <mark style="color:blue;">`Purchases & Sales`</mark> > <mark style="color:blue;">`Sales`</mark>.
2. Select **Customer** from the dropdown.
3. The system will auto-fill the customer’s saved address and phone number from your **Partners** list.

{% embed url="<https://customer-0jrbilsa8yt3k758.cloudflarestream.com/18031131fb8147dbb6fd65cefccc67b3/iframe?autoplay=true&controls=false&letterboxColor=transparent&loop=true&muted=true&poster=https://customer-0jrbilsa8yt3k758.cloudflarestream.com/18031131fb8147dbb6fd65cefccc67b3/thumbnails/thumbnail.jpg?height=1080&preload=true>" %}

#### Send a Sales Invoice

You can also email the invoice directly to this customer.&#x20;

* Go to the completed sales order and click the <mark style="color:blue;">`...`</mark> (more) button > <mark style="color:blue;">`Send Email`</mark>.&#x20;
* The customer’s saved email information will be used automatically.

<figure><img src="/files/9qWikWoQjaCRG6C5aEhq" alt=""><figcaption></figcaption></figure>

### B. Purchase Orders for Suppliers

Similarly, you can create a Purchase Order (PO) for a specific supplier through the <mark style="color:blue;">`Purchases & Sales`</mark> menu. The PO can be easily edited, deleted, printed, or saved as a PDF at any time.

<figure><img src="/files/5BF8PplqzKUSJUXcMCsE" alt=""><figcaption></figcaption></figure>

***

## Filter by Partner

You can filter by partner to streamline your view across these BoxHero features:

* Transactions
* Purchases
* Sales
* Returns
* Sales Reports
* Summary

<figure><img src="/files/Dr3MXyJLLaj5pPk2HN8l" alt=""><figcaption><p>Filter Transactions history by specific partners</p></figcaption></figure>

<figure><img src="/files/0cH0MoUNXFSjt09IljtR" alt=""><figcaption><p>Filter Summary by specific partners</p></figcaption></figure>

{% hint style="success" %}
To share inventory details with your partners in real time, use the [**Inventory Link**](/docs/other-features/inventory-link.md) feature.
{% endhint %}


---

# 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://www.boxhero.io/docs/concepts/partners.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.
