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.
GunBroker sales channel listings support mapping for the Item Subtitle field along with additional marketing and premium listing fields. These fields can be configured within your GunBroker sales channel mapping template to enhance your listings on the channel.
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.
State restrictions (Exclude States)
Flxpoint has no channel screen or setting for ship-to state restrictions. Use GunBroker's own Exclude States fields instead: map Exclude States (and Use Default Exclude States) in the Publish Listings mapping template, and they go out with each new listing and again on every update. To base them on a source field such as Capacity, first map that field in your source's mapping template so the product carries it, then add a rule on the Exclude States field in the Publish Listings template.
Item condition
Map Condition in the Publish Listings template with the number GunBroker expects: 1 Factory New, 2 New Old Stock, 3 Used (a word such as Used is not understood). If Condition is not mapped or has no usable value, the listing is created as Factory New. Condition is only sent when the listing is created: GunBroker does not allow it to change on a listed item, so set it before the first publish.
Does List Price Protection apply to auctions?
List Price Protection is a channel-wide setting, so it applies to every listing on the channel, including GunBroker auction listings. To turn it off, go to Channels, click the gear icon on the GunBroker channel, open Settings, switch List Price Protection off and click Update. While it is on, Flxpoint blocks syncing a listing when its estimated cost is missing or zero, when the list price is lower than or equal to the cost, or when the listing has no linked inventory.
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. |
| Shipping profile | A setting of the operation, not a template field you must map. Go to Channels → gear icon on your GunBroker channel → Integrations → Publish Listings → Edit and enter the Shipping Profile ID of a shipping profile you created in your GunBroker seller account. It applies to every listing you publish. To give some listings a different profile, map the Shipping Profile ID field in the Publish Listings mapping template: a mapped value overrides the setting. |
| Who pays for shipping | Set on the same screen. When a Shipping Profile ID is set, the profile decides the shipping terms and this choice is not used. Without a profile, choose who pays; if the buyer pays a fixed amount, select the shipping classes you offer (e.g. Ground, Priority, Overnight) and enter a cost for each. |
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. This only affects incoming orders: the shipping profile and costs buyers see on a listing are set in the Publish listings settings. |
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. |
Scheduled jobs failing - "invalid credentials" or authentication error
Publish fails with a "terminal categories" error
Listings stuck on "Pending Publish" / Quantity Null Error
GunBroker listings not updating prices after Sync Listings runs
Listings all ended and did not relist after restocking
Listings showing "OTHER Manufacturer" on GunBroker
Non-FFL items flagged as requiring FFL information on all orders
GunBroker orders not closing or receiving tracking numbers
Imported order shows a $0 or incorrect subtotal (unmanaged SKUs)
Duplicate listings created on GunBroker after Publish
Publish fails with "Invalid Shipping Profile selected" after enabling AI Category Mapping?
Orders closing prematurely or marked as fully shipped?
Import Listings failing with blank error details or missing SKUs?
State restrictions not updating despite successful Publish or Overwrite job?
Thumbnail images missing or delayed after publishing?
GunBroker orders imported as Paid when they are still pending payment?
Publish fails with a 'Category Is Not Configured' error
Manual vs AI Category Mapping
Auction publish fails with "Text could not be parsed"?
Publish fails with "Not able to fetch the Item from the store"?
Where do I change the shipping profile or shipping cost for my GunBroker listings?
Why are my GunBroker listing prices not updating even though Sync Listings shows as completed?
Can I sell auction and fixed-price listings through the same channel?
Why did my product disappear from GunBroker after I hid it in Flxpoint?
How do I find the correct GunBroker category ID for my products?
How do I handle FFL orders in the fulfillment workflow?
Does Sync Listings update descriptions, images, or other content fields?
Does Flxpoint support tiered quantity discounts or percentage-off pricing for GunBroker?
No. While GunBroker fixed-price listings support multiple quantities, the integration does not currently support volume-based or percentage-off pricing tiers for purchasing multiple items. Pricing is sent as a single value per listing based on your pricing rules or manual overrides.
