---
title: "Orchid eBound"
description: "Connect your Orchid eBound bound book to import firearms, keep stock in sync, reserve serials for online orders, and record FFL transfers"
---

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

# Orchid eBound

# Orchid eBound Integration

Connect FirearmCart to your **Orchid eBound** electronic bound book (FFLBizHub). FirearmCart reads the firearms that are open in your book, keeps your online stock in step with counter sales, reserves the serial for each online order, and records the FFL transfer when the firearm ships.

---

## Features

| Feature | Description |
|---------|-------------|
| **Bound-book browser** | Every open unit in your book (acquired, not yet disposed) with serial, type, caliber, acquisition date, condition, and price |
| **Imports** | Import units into your catalog. Units sharing a UPC (or item number) become one product with matching stock; a used unit is always its own product |
| **Stock sync** | Every 15 minutes, linked products are set to the open, unreserved units in your book minus units on unshipped orders |
| **Serial reservations** | When an order is paid, the oldest matching unit's serial is assigned to each firearm and reserved in eBound |
| **FFL transfers** | When a firearm ships, record the FFL transfer of its exact serial to the buyer's FFL |
| **Acquisitions** | Record received firearms in your book from FirearmCart |

---

## Prerequisites

- An Orchid eBound account with a bound book
- An eBound **API key** for that bound book (one key per bound book — ask Orchid for it)
- For testing, a separate **sandbox** API key from Orchid

Only one electronic bound book can be connected at a time. Deactivate FastBound before activating Orchid eBound.

---

## Getting started

1. Go to **Plugins → Marketplace** and click **Activate** on **Orchid eBound**.
2. Paste your bound book's **API Key**.
3. Tick **Enable Sandbox Mode** only if the key is a sandbox (staging) key. Sandbox and production keys are different; a production key only works with the box unticked.
4. Click **Activate**. FirearmCart checks the key against eBound before saving it.

Once activated, an **Orchid eBound** item appears in the sidebar under **Plugins** and the first bound-book download starts. A **Sandbox** badge shows on the plugin page whenever you're connected to the sandbox.

To change the API key or switch between sandbox and production, open **Plugins → Orchid eBound → Configure**. Switching connects a different bound book, so the downloaded units are cleared and downloaded again, and serials held for open orders are released in FirearmCart. Reservations already made in the old book stay there until you cancel them in eBound.

---

## How stock sync works

FirearmCart downloads the open units in your book every 15 minutes. For each product linked to the book:

**Stock = open units that are not reserved and not on a Form 4473 − units on unshipped orders**

So a firearm sold at your counter drops your online stock at the next sync, and an online order doesn't get counted twice while it waits to ship. If a download doesn't finish, stock is left alone until the next complete sync.

- A product imported from a **single used unit** goes to draft once that unit leaves your book.
- A product for a **UPC group** shows out of stock when its last unit leaves, and comes back when you acquire more.
- Turn **Keep imported products' stock in sync** off under **Settings & Connection** to manage stock yourself.

---

## Importing

1. Open **Plugins → Orchid eBound**.
2. Select units (or click **Import** on one) and choose how to handle a UPC that's already in your catalog:
   - **Import as its own product** (recommended for used and consignment firearms) — a separate listing with suppliers locked
   - **Merge into it (new units only)** — new-condition units become the matching listing's own-stock supply and its preferred supplier, so they sell first under the **Preferred supplier** rule in [Supplier selection](/store-setup/fulfillment#supplier-selection)
   - **Skip it** — treat any product with the same UPC or item number as imported
3. Click **Import**.

Selecting one unit imports its whole group. Products import as **drafts** when eBound has no price for them or when their firearm type isn't recognised, so you can review them before they go live. eBound records don't include photos or descriptions, so add those before you publish.

---

## Serial reservations

With **Reserve serials for paid orders** on (the default), when a paid order's firearm is routed to your own stock FirearmCart:

1. Picks the oldest matching open unit (first in, first out) for each firearm on the order.
2. Reserves that serial in eBound, so it isn't sold at the counter.
3. Shows it on the order page as an **eBound** badge on the fulfillment.

Click the badge (or **eBound serials** in the fulfillment's menu) to see the serials, **Change serial** to the unit you're actually shipping, **Release** a serial, or **Auto-assign** empty units. Reservations are cancelled automatically when the fulfillment or order is cancelled, refunded, or voided before it ships.

NFA items (suppressors, short-barreled rifles and shotguns, and similar) are never reserved or transferred by FirearmCart — they go through ATF Form 3/4, so record them in eBound yourself. Drop-shipped firearms are never touched; they're in your distributor's book.

---

## Recording FFL transfers

When a firearm ships to the buyer's FFL, its transfer has to be recorded in your book. Two ways:

- **Automatically** — turn on **Record the FFL transfer when tracking is sent**. When a shipped firearm gets its tracking number (added on the order page, with or without the tracking email, or from ShipStation or a distributor) or you resend the tracking email, FirearmCart records the transfer of the serial on each unit.
- **From the order page** — open the fulfillment's eBound badge and click **Record transfer**. Use this after buying a label in FirearmCart, since a purchased label isn't treated as shipped until you send tracking.

Before sending, FirearmCart checks each serial is still open in eBound. A serial picked automatically at ship time (because none was assigned when the order was paid) is held until you confirm it on the order page. Bound-book entries are final, so check the serials are the units in the box.

eBound won't record a transfer for a unit that's reserved for an online sale, so FirearmCart cancels the order's reservation just before recording the transfer. If eBound then refuses the transfer, the reservation is made again.

Pickup orders have no transfer FFL. Record the Form 4473 sale at your counter in eBound as usual.

---

## Recording acquisitions

1. On the plugin page, open **Actions → Create Acquisition**.
2. Pick the product, the acquisition date, and new or used.
3. Search for the FFL you received the firearms from (or type a non-licensee's details).
4. Enter each serial number and click **Record acquisition**.

The product needs **Manufacturer**, **Model**, and **Caliber** specifications. The bound book re-syncs right after, and a new-condition product is linked to its UPC group so its stock follows the book.

---

## Settings

| Setting | Default | What it does |
|---------|---------|--------------|
| **Orchid eBound enabled** | On | Master switch for syncing, stock updates, reservations, and transfers |
| **Keep imported products' stock in sync** | On | Linked products follow the book every 15 minutes |
| **Reserve serials for paid orders** | On | Assign and reserve a serial for each firearm on a paid order |
| **Record the FFL transfer when tracking is sent** | Off | Record transfers automatically when tracking is sent |
| **Log API activity** | Off | Record eBound API calls in the **API Activity** panel (scheduled syncs only log failures) |

---

## Troubleshooting

| Problem | What to do |
|---------|-----------|
| "Orchid eBound rejected your API key" | Check the key and the **Enable Sandbox Mode** box under **Plugins → Configure**, then click **Retry sync** |
| A sync shows "Downloaded X of Y units" | eBound didn't return the whole book. Stock wasn't changed; the next sync retries |
| An order shows "need a serial" | No open, unreserved unit matches the product. Acquire it, or assign a serial by hand from the order page |
| "eBound reserve failed" on an order | Open the eBound badge, then **Retry reserve** or **Change serial** |
| A transfer was rejected | The badge shows the reason. Fix the serial or FFL, then **Record transfer** again |

---

## Limitations

- Orchid eBound doesn't push changes to FirearmCart, so stock and reservations reflect the book as of the last sync (every 15 minutes).
- Unit details like condition and price are loaded once for each new unit, after it first appears in the book.
- FirearmCart doesn't download bound-book PDFs or file Form 4473s.

Source: https://docs.firearmcart.com/integrations/orchid-ebound/index.mdx
