> ## Documentation Index
> Fetch the complete documentation index at: https://docs.fire.rest/llms.txt
> Use this file to discover all available pages before exploring further.

# Stores and suppliers

> Create BOH stores linked to Restaurant OS and manage the suppliers you buy from, including item-supplier links with price and purchase unit.

Stores and suppliers are the foundation of BOH: every movement happens **in a store**, and every purchase comes **from a supplier**.

**Where you work:** the **Establishments** section of the BOH menu — **Stores** (`/boh/admin/stores`), **Suppliers** (`/boh/admin/suppliers`), and **Inventory areas** (`/boh/admin/operations/inventory-areas`, covered in [Stock counts](/en/manuals/boh/stock-counts#inventory-areas)).

## Stores

A BOH store represents the inventory of a physical location. It is always **linked to a Restaurant OS store**, which is how sales orders find the right inventory to consume.

<Frame>
  <img src="https://mintcdn.com/firepos/BrdVCD37uC_Sgwgg/images/manuals/boh/stores-suppliers/01-stores-list.png?fit=max&auto=format&n=BrdVCD37uC_Sgwgg&q=85&s=84195607b5f6f12f24c6475c241d6922" alt="BOH stores list in the Fire backoffice" width="2904" height="1500" data-path="images/manuals/boh/stores-suppliers/01-stores-list.png" />
</Frame>

### Create a store

<Steps>
  <Step title="Open the store form">
    **BOH → Stores → Create** (`/boh/admin/stores/new`).
  </Step>

  <Step title="Pick the Restaurant OS store">
    Choose the store from the account catalog. The link cannot point two BOH stores to the same Restaurant OS store.
  </Step>

  <Step title="Review the timezone">
    The timezone determines when daily reports and closes cut over. It usually comes from the linked store.
  </Step>

  <Step title="Save" />
</Steps>

<Frame>
  <img src="https://mintcdn.com/firepos/BrdVCD37uC_Sgwgg/images/manuals/boh/stores-suppliers/02-store-form.png?fit=max&auto=format&n=BrdVCD37uC_Sgwgg&q=85&s=d28d8fac41cde2361364e766da9292dc" alt="BOH store creation form with Restaurant OS store selector" width="2908" height="1510" data-path="images/manuals/boh/stores-suppliers/02-store-form.png" />
</Frame>

From the store detail (`/boh/admin/stores/{id}/view`) you can also review the **inventory areas** defined for physical counts — see [Stock counts](/en/manuals/boh/stock-counts).

<Note>
  Archiving a store hides it from day-to-day screens but keeps its history. You cannot record new movements in an archived store.
</Note>

<Note>
  **ERP integration — `tax_id` field:** If you create purchase orders through the BOH API from an ERP system, you can set a `tax_id` on each store (RUC, CNPJ, CUIT, NIT, RFC, or any fiscal code up to 64 characters). This lets the ERP reference a store by its fiscal identifier when creating orders — no internal UUID needed. Set it via `POST /identity/stores` or `PATCH /identity/stores/{id}`. Note: the field is not unique, so if several stores share the same `tax_id` you will need to use `store_id` or `external_store_id` instead for order creation.
</Note>

## Suppliers

A supplier is any vendor you buy supplies from. The record keeps contact information and the tax ID used in purchasing documents.

<Frame>
  <img src="https://mintcdn.com/firepos/BrdVCD37uC_Sgwgg/images/manuals/boh/stores-suppliers/03-suppliers-list.png?fit=max&auto=format&n=BrdVCD37uC_Sgwgg&q=85&s=c2759905aee3af710296ede48d42490d" alt="Suppliers list in the BOH module" width="2896" height="1512" data-path="images/manuals/boh/stores-suppliers/03-suppliers-list.png" />
</Frame>

### Create a supplier

<Steps>
  <Step title="Open the supplier form">
    **BOH → Suppliers → Create** (`/boh/admin/suppliers/new`).
  </Step>

  <Step title="Fill in the basics">
    Name, contact details, and tax ID.
  </Step>

  <Step title="Save" />
</Steps>

## Item-supplier links

The most useful part of a supplier record is the list of **items you buy from them**, with the purchasing conditions for each one:

| Field             | What it is for                                                                      |
| ----------------- | ----------------------------------------------------------------------------------- |
| **Item**          | The catalog item this supplier sells you.                                           |
| **Purchase unit** | The unit you buy in (e.g. a 25 kg bag), which may differ from the item's base unit. |
| **Price**         | Agreed cost per purchase unit. Used as the default in purchase orders.              |
| **Supplier SKU**  | The supplier's own code for the product, useful for matching invoices.              |

You can manage links from either side:

* From the supplier: **Suppliers → (supplier) → Items** (`/boh/admin/suppliers/{id}/items`).
* From the item: **Items → (item) → Suppliers** (`/boh/admin/items/{id}/suppliers`).

<Frame>
  <img src="https://mintcdn.com/firepos/BrdVCD37uC_Sgwgg/images/manuals/boh/stores-suppliers/04-supplier-item-link.png?fit=max&auto=format&n=BrdVCD37uC_Sgwgg&q=85&s=2fd29c9b08b3b63666baa1c391680285" alt="Item-supplier link form with purchase unit, price and supplier SKU" width="2896" height="1514" data-path="images/manuals/boh/stores-suppliers/04-supplier-item-link.png" />
</Frame>

<Tip>
  Set up item-supplier links before using [Procurement](/en/manuals/boh/procurement): purchase orders can suggest prices and units from the link, and the receiving flow validates against it.
</Tip>

Next: [Catalog](/en/manuals/boh/catalog).
