Guns.com Integration
Connect your FirearmCart store with Guns.com to list merchant-managed inventory and import orders.
Features
| Feature | Description |
|---|---|
| NEW listings | List in-stock products by manufacturer UPC. Guns.com owns title, images, and specs. |
| USED listings | List serialized firearms one serial at a time, with your own photos of the gun. |
| Condition from the product | NEW or USED is taken from the product’s Condition specification, so your catalog, your bound book and Guns.com agree. |
| Quantity sync | Push on-hand quantity for NEW listings whenever stock changes, including sales made in store or on another marketplace. |
| Order import | Accept or reject orders awaiting confirmation, then import sales as FirearmCart orders. |
| Shipped and tracking | Guns.com’s own tracking number is recorded on the order, with no email to the buyer. |
| Webhooks | Receive order.assigned and order.canceled events on a unique HTTPS URL. Shipped and delivered arrive by polling. |
Prerequisites
Before connecting, you need:
- An active Guns.com seller account
- FirearmCart enabled on that account (email
api@guns.com; Guns.com refers to a connected system like ours as a “POS system”, so give them the name FirearmCart) - Seller account email and password
- Stock you hold yourself. Guns.com lists what is physically on your shelves, so distributor inventory — drop ship, just-in-time or any other third-party-held stock — cannot be listed, even where your storefront sells it
Platform onboarding is handled by FirearmCart. The plugin is invite-only until that is live.
Getting started
- Activate Guns.com from the plugin marketplace (your store must have marketplace feeds, or an admin grant).
- Enter your Guns.com seller email and password. Use sandbox while testing.
- Import existing Guns.com listings before creating new ones so you do not create duplicates.
- Give each product you want to list a Condition specification (see below).
- Create listings from tracked, merchant-managed products priced at $100 or more. Draft products are included, so you can sell an item on Guns.com without publishing it to your own storefront.
Condition comes from the product
Guns.com lists a gun as NEW or USED, and FirearmCart takes which one from the product’s Condition specification rather than asking on the create-listing form. The same gun then reads the same way in your catalog, in your bound book and on Guns.com. You cannot pick a condition that contradicts the product.
Add it on the product under Specifications, named Condition:
| Write this | Guns.com lists it as |
|---|---|
| New, Factory New, Brand New, New In Box, NIB, New Old Stock, NOS, Unfired | NEW |
| Used, Pre-Owned, Second Hand, Consignment | USED, and you choose the grade on the listing |
| Excellent, or Used — Excellent | USED, Excellent |
| Very Good | USED, Very Good |
| Good | USED, Good |
| Fair, or Poor | USED, Fair |
Capitals, hyphens and dashes don’t matter: factory-new and Factory New are read the same way. Anything else — “Refurbished”, for instance — isn’t a Guns.com condition, and the product page and the create-listing form both say so until you change it.
The product page shows a Guns.com panel with whatever is still missing, alongside the panels for your other marketplaces.
Photos on a USED listing have to be of the actual firearm. Guns.com rejects a manufacturer or catalog stock photo, and a photo of a different unit of the same model. NEW listings are the opposite: Guns.com supplies the photos, title and specifications from their own catalog entry for the UPC, and only your price and quantity are sent.
When a listing sells out
Under Settings, When a listing sells out decides what happens once a product’s on-hand quantity reaches zero:
| Option | What happens |
|---|---|
| Keep it listed at zero (default) | The listing stays on Guns.com showing sold out. Restocking brings it straight back. |
| Remove it from Guns.com | The listing comes down. When you restock, FirearmCart relists it and pushes the new price and quantity for you. |
Either way a sale anywhere — your storefront, in store, or another marketplace — lowers the Guns.com quantity, because every stock change is pushed.
Orders
FirearmCart imports Guns.com orders that have reached ready to ship, shipped, or delivered, and reverses an imported order if Guns.com later cancels it. Guns.com settles payment, so an imported order arrives already paid.
Set the FFL before shipping. FirearmCart matches the receiving dealer on the exact licence number, then on the premise address. When neither matches it tells you the order needs an FFL rather than guessing, because two different dealers can share a shortened licence number.
Orders marked “Not in your catalog”. An order can only import if at least one of its items matches a product in your catalog by UPC. When nothing matches, the Orders tab shows Not in your catalog against the order along with the UPCs it could not place, and stops trying. Add or list the product, then press Retry on that order to import it.
Guns.com manages the buyer
Guns.com takes the order, vets the buyer and picks the receiving dealer, and their record is the one on file. On an imported order the Customer, Address and FFL cards are read-only — a lock icon replaces the edit pencil, and the order page says so. Everything else about the order is yours: fulfillment, tracking, notes, labels and your own reporting. If a buyer’s details are wrong, they have to be corrected on Guns.com.
The one exception is an order whose dealer we could not match to a licence on the ATF list. There the FFL card stays usable, so you can record the dealer Guns.com named rather than leaving the order unshippable. Once a dealer is on the order it locks like the rest.
Your store never emails a Guns.com buyer. Guns.com handles all customer contact, so order confirmation, tracking and delivery emails are not sent for a Guns.com order and there is no setting to turn them on.
Shipped status and tracking
Guns.com’s webhook only fires order.assigned and order.canceled, so shipped and delivered reach FirearmCart by polling — every 15 minutes, or when you press Sync now on the Orders tab. The status badge turns green once Guns.com marks the order shipped or delivered.
Guns.com buys the shipping label, so their tracking number travels in with the order. FirearmCart shows it under the status on the Orders tab and records it on the fulfillment, which marks the line shipped and closes it off your processing queue. It is kept for your records only: there is no email to the buyer, and nothing to send back to Guns.com — their API has no endpoint for tracking because the label is theirs.
Bound book and stock
A sale on Guns.com lowers the product’s on-hand quantity straight away. When the same firearm later leaves your bound book — your own disposition in FastBound or Orchid eBound — FirearmCart recognises it as the same sale rather than taking a second unit off, so a gun sold on Guns.com cannot come back in stock and be sold twice.

