Connect your FirearmCart store with Orion Wholesale for product import, dropship fulfillment (accessories to the customer, firearms to an FFL), and orders shipped to your store.
Features
| Feature | Description |
|---|---|
| Product import | Import firearms, NFA items, ammunition and accessories from Orion’s catalog, with images, specifications and MAP |
| Inventory sync | Stock and dealer-cost updates on every sync; how often it re-syncs depends on your plan’s sync interval |
| Dropship orders | Accessories ship to your customer, or to their FFL when your FFL rules require it or you choose to; firearms ship to their chosen FFL |
| Store orders | NFA items, items Orion won’t drop ship, items you send to your store, and every order when drop shipping is off ship to your store |
| Tracking sync | Tracking numbers for dropship orders sync back to orders automatically |
Before You Start
Orion Wholesale issues each dealer a Connection Key for its API, separate from your orionfflsales.com login. Ask your Orion sales rep for it.
- Orion drop ships for dealer accounts it has set up for drop shipping. If yours isn’t, turn Drop shipping off when you activate, and every order ships to your store.
- Orion drop ships within the continental US only.
- NFA items, such as suppressors, ship to your store, so Orion needs your SOT on file to ship them.
Setting Up
- Navigate to Plugins > Marketplace
- Find Orion Wholesale
- Click Activate
- Enter your login:
| Field | Description |
|---|---|
| Connection Key | Your Orion Wholesale API Connection Key |
- Leave Drop shipping on to have Orion ship to your customers. Turn it off to send every Orion order to your store.
- Click Activate Plugin
The Connection Key is verified as part of activating. Once activated, an initial catalog sync starts automatically and an Orion Wholesale item appears in the sidebar under Plugins. To change the key or the Drop shipping switch later, click Configure on the Orion Wholesale card in Plugins > Marketplace.
What’s in Your Catalog
Your Orion catalog holds the products in your account’s Orion inventory, with your dealer cost and Orion’s stock. A few products are left out:
- Discontinued products Orion has none left of. A discontinued product Orion still has stays in your catalog until it sells out.
- Products Orion lists at no cost
NFA items, such as suppressors and short-barreled rifles, are included and ship to your store only (see Ship to Your Store). Products carry Orion’s category, its item number (Orion Item #), its specifications, the MSRP where Orion lists one, and, where Orion lists them, the states it doesn’t ship them to (Restricted States). Products Orion ships only to an FFL show FFL Required: Yes. Magazine capacity and firearm action are named the way your FFL rules read them, so capacity and action-type limits apply. Product images come with Orion’s catalog.
Importing Products
- Go to Plugins > Orion Wholesale
- Search the catalog (name, SKU, UPC, manufacturer, or manufacturer number), or narrow it with the manufacturer and category filters
- Use Filters to hide out-of-stock or already-imported products, set a cost range, or include products Orion won’t drop ship
- Select the products you want, then click Import
- Set your Markup % and confirm
Imported products are added to your catalog as drafts. MAP is respected as a price floor: a price FirearmCart sets from your markup, when you import a product and on later syncs, never goes below the MAP in Orion’s catalog. Syncs also reprice a price you typed below MAP from your markup, never below MAP, unless the product’s Auto-update price on cost change switch is off or your store is set to Never change prices. See MAP Pricing.
Inventory Sync
- Every sync updates stock and dealer cost. How often it runs depends on your plan’s sync interval.
- New products, and catalog details such as names, images and MAP, are updated once a day. A product that leaves your Orion inventory, or that Orion discontinues, is set to zero stock.
- To sync on demand, open the Sync info (ⓘ) menu next to the search box and choose Resync now.
- If Orion is unavailable, nothing changes and the next scheduled sync tries again.
Sending Orders to Orion Wholesale
By default, an order goes to Orion when you process its fulfillment from the order page. To send orders as soon as the customer pays, turn on Automatic fulfillment under Settings > Fulfillment. See Automatic Fulfillment.
Orders use Orion’s standard shipping. If Orion refuses an order, the fulfillment shows Error with Orion’s reason and you get an alert. Fix the cause, then click Reship.
Items Orion Can’t Fill
Right before an order goes to Orion, FirearmCart checks each item against Orion’s stock and the states Orion won’t ship it to. An item Orion can’t fill moves to a fulfillment of its own under Needs Processing, with the reason, and the rest of the order goes to Orion. Choose another supplier or your own stock for it, then process it. If Orion can fill nothing on the fulfillment, nothing is ordered and the whole fulfillment waits under Needs Processing.
If Orion Doesn’t Confirm an Order
If Orion doesn’t answer an order, for example because the connection timed out, the fulfillment shows Error with “Orion Wholesale didn’t confirm PO …”. Orion may still have the order, so check your orders on orionfflsales.com:
- If Orion has it, there’s nothing to do. For a dropship, tracking syncs as usual, and the fulfillment moves to Shipped when the first package does.
- If Orion doesn’t have it, click Reship. Because Orion may hold the original, the confirmation asks you to cancel it with Orion first, and Confirm stays disabled until you tick I have cancelled the original order with Orion Wholesale. Fulfill from inventory asks for the same confirmation.
FFL Licenses on Firearm Orders
Orion holds an order to an FFL it doesn’t have on file until it gets a copy of that dealer’s license. When the receiving FFL has a verified license copy in FirearmCart, a firearm order sends Orion a link to it, so Orion can put the FFL on file. When there’s no verified copy, the order still goes to Orion, the fulfillment’s timeline notes it, and you get an alert: if Orion asks, send it the FFL’s license. You can upload a receiving dealer’s license copy from the order page; see Do I need to verify FFL licenses myself?.
Dropship Rules
- Accessories ship to the customer.
- An accessory going to an FFL ships to the customer’s chosen FFL, with the customer named in the order notes. That happens when your FFL rules require it (for example a magazine going to California), or when you send it there yourself: while the order is waiting to be processed, click the item’s Customer badge in the order’s Ship To column and choose FFL.
- Firearms ship to the customer’s chosen FFL with the FFL’s license number. A firearm can’t be dropshipped without an FFL on the order.
- Orion drop ships within the continental US only. An order going to Alaska, Hawaii, a US territory or a military address ships to your store instead, and you ship it on.
- Orion doesn’t drop ship some products to some states (it lists many for Virginia and Colorado). A product it won’t drop ship to the order’s state ships to your store instead.
- Products Orion ships only to an FFL (FFL Required: Yes), and most products going to California, never go to a customer’s door: on an order to the customer, they ship to your store instead. They can still go to the customer’s FFL.
- NFA items, and products Orion won’t drop ship, always ship to your store.
- When only some items on an order have to ship to your store, they move to a fulfillment of their own under Needs Processing, which ships to your store, and the rest drop ships as usual. Process it to order those items to your store.
- With Drop shipping off, every order ships to your store instead.
- You can also send any Orion item to your store from the order’s Ship To column. See Ship To: Customer, FFL or Store.
Ship to Your Store
Orion ships store orders to the address on your Orion account, firearms and NFA items included, so they need no address or FFL in FirearmCart.
When it arrives, ship it on with your own shipping plugins or Add tracking number on the order, or mark it picked up if the customer collects it. Orion emails you the tracking of a store order rather than sending it to FirearmCart: if the order’s FFL is your own store, add Orion’s tracking with Add tracking number so the customer gets it. See When a Store Order Arrives.
Tracking
FirearmCart checks for tracking on open Orion dropship orders every 30 minutes. Each tracking number is recorded on the fulfillment as it arrives, and the customer gets one tracking email for the first.
Checking stops once everything on the order has shipped. If an order hasn’t shipped 45 days after it was placed, checking stops and you get an alert to follow up with Orion. Store orders aren’t checked: Orion emails you their tracking.
Troubleshooting
Connection Issues
- “Orion Wholesale didn’t accept this Connection Key”: check the key with your Orion sales rep and enter it again.
- “Orion Wholesale returned no inventory for this Connection Key”: ask your Orion sales rep to make sure inventory is open to your API key, then click Retry sync.
- If Orion rejects your Connection Key during a sync, syncing pauses and the Plugins > Orion Wholesale page shows Retry sync. Update the key under Configure, then click Retry sync.
Products Missing From Your Catalog
- Products Orion won’t drop ship, including NFA items, are hidden by default. Use the Include non-dropshippable filter to see them.
- Discontinued products Orion has none left of, and products Orion lists at no cost, aren’t offered. A discontinued product that comes back into stock returns with the next daily catalog update.
Firearm Order Issues
- A firearm with no FFL: a firearm can’t be dropshipped without a transfer FFL on the order. Assign one, then reship.
- “Orion Wholesale lists … as a firearm”: Orion’s catalog lists the item as a firearm, but your product’s type says accessory, so FirearmCart won’t ship it to the customer’s door. Correct the product’s type, then reship.
- An order held by Orion: Orion holds an order to an FFL it doesn’t have on file. Send your Orion sales rep a copy of the FFL’s license with the Orion order number.
Related Documentation
- Integrations Overview - All integrations
- Fulfillment - Order fulfillment
- FFL Rules - When accessories ship to an FFL
- FFL Directory - Dealers and their license copies
- Inventory - Inventory management

