GunBroker as a Channel
Summary
GunBroker is a sales channel for firearms and shooting-sports products. This integration imports and publishes listings, keeps price and quantity in sync, and brings GunBroker orders into Flxpoint for fulfillment, with built-in handling for FFL orders and for auction vs. fixed-price listings.
Enter these on the Connect Channel screen. They all come from your GunBroker seller account - here's exactly where to find each one.
| Field | What to enter |
|---|---|
UsernameRequired | The login for your GunBroker seller account - the same username you sign in with.
Open gunbroker.com |
PasswordRequired | Your GunBroker account password. Forgot it? Reset it from the GunBroker sign-in page.
Reset on GunBroker |
EnvironmentSetting | Pick Production for live selling, or Sandbox for testing only. Then click Test Connection & Continue to verify.
Chosen in Flxpoint - no external value needed. |
No variants - every SKU is its own listing
GunBroker does not support parent-child product relationships. Each variant must be a standalone item. Do not merge products into a parent-child structure in Flxpoint - doing so causes incorrect delisting and duplicate sync attempts.
Hiding = delisting on GunBroker
GunBroker does not support hiding listings. Moving a product to the Hidden Queue in Flxpoint automatically delists it from GunBroker and updates its status to Delisted. To relist, add stock and run Sync Listings.
Category IDs must be numeric leaf nodes
GunBroker requires numeric leaf-level Category IDs (e.g. 3018 for Pistol Ammunition). Using a parent category ID causes a publish error. All SKUs must publish at the same category depth. Use the official GunBroker category CSV to find correct IDs.
Quantity and Price must always be mapped
Quantity is required across all operations - Import, Sync, Publish, and Get Orders. If Quantity is unmapped, the integration fails. A built-in rule also sets quantity to 0 if cost or list price is missing, ending the listing to prevent low-price errors.
Auto-List requires a scheduled Publish job
The Auto-List to Channel setting automatically sets auto-created listings to publish status and sends updated data for auto-rebuilt listings. For this to function, the Publish Listings job must be on a schedule.
List price protection updates
Price protection rules now automatically set quantity to 0 if cost or list price is missing or zero, preventing low-price errors on GunBroker. Ensure your Publish Listings job is scheduled to handle these updates.
Category AI v2 mapping
The Category AI v2 mapping section is visible exclusively on the GunBroker channel publishing configuration screen. You can access these settings by navigating to Channels, selecting your GunBroker channel, and opening Publish Settings. This feature enables automated category mapping enhancements specifically tailored for GunBroker listings to ensure accurate leaf-node categorization.
Syncing unpauses all listings
When you trigger the Sync Listings action, Flxpoint now automatically unpauses all listings for this channel before the sync job begins. This ensures that inventory and price updates are applied to all intended items without manual unpausing.
Creates new fixed-price or auction listings on GunBroker
| Field | Notes |
|---|---|
| Name (Title) | Required. Maps from Listing Parent → Title. GunBroker will show a generic placeholder if Description is not mapped - map it explicitly to avoid listings showing no description. |
| SKU | Required. The linking key - must match between Flxpoint and GunBroker to avoid duplicate listings. |
| Category ID | Required. Must be a numeric leaf category ID (e.g. 3018). One field only - map from Category 1, 2, or 3; the others are ignored. Use the GunBroker category CSV. |
| Quantity | Required. Auction listings are always quantity 1. Fixed-price listings support any quantity. Quantity is set to 0 automatically if cost or list price is missing or zero. |
| Price | Required for fixed-price listings. USD only. Auction listings require a starting price; reserve and buy-now are optional. |
| Manufacturer | Not a mappable field: GunBroker's Items API doesn't expose a Manufacturer field, so there's nothing to map to and the listing posts as "OTHER Manufacturer". To show the brand, include it in Title (or Description) using the Publish Mapping Template's prefix or postfix option. |
Pushes price & quantity updates; delists at zero stock
Brings GunBroker orders in for fulfillment routing
| Setting | Notes |
|---|---|
| Order status filter | Select the statuses to import (e.g. Pending Seller Review, Pending Shipment). Narrow this to avoid importing unwanted order states. |
| FFL status filter | Filter by FFL status: All, Awaiting FFL, or FFL Received. Non-FFL items being flagged as FFL usually means the FFL rules on the source are misconfigured - check source-level FFL settings if standard items are incorrectly requiring FFL info. |
| FFL License Image | Auto-populated. When the order's FFL has an eFFL on file with GunBroker, Get Orders saves the eFFL file URL into FFL Information → License Image automatically. This is set in code, not through the mapping template, and applies to newly fetched orders only. Orders whose FFL has no eFFL on file still need the license image uploaded manually. |
| PII retention | Set how long customer personal data is stored (e.g. 30 days after shipment, or Indefinitely). |
| Shipping mappings | Map GunBroker's shipping text (e.g. "Standard") to a Flxpoint shipping policy. Unmapped shipping methods put orders on hold. |
Pushes tracking numbers back to GunBroker
| Field | Notes |
|---|---|
| Tracking Number | Required. Maps from Shipment → Tracking Number. |
| Carrier | Required. Maps from Shipment → Carrier (e.g. FedEx, UPS). Sets the GunBroker Shipping Provider field. |
| Partial shipments | Not supported - only fully shipped orders sync. Orders with customer name data issues (e.g. LightSpeed integration) may fail to sync - confirm name fields are mapping correctly in your Get Orders template. |
