GunBroker is a popular online auction platform specifically tailored for firearms and related accessories. As a sales channel in Flxpoint, it allows users to list, sync, and manage their firearm inventory seamlessly across the marketplace. GunBroker supports various operations such as linking, syncing, and publishing listings, as well as managing orders. It is particularly useful for sellers looking to reach a niche market of firearm enthusiasts, with features that help automate and streamline the process of selling firearms online.
How to connect
Step 1: Log in to your Flxpoint account and navigate to Sales Channels.
Step 2: Click Create Channel (or Add Channel).
Step 3: In the Configure Integration Type screen:
Search for GunBroker in the directory and select it.
Enter a Channel Name (e.g., "GunBroker").
Click Save & Next.
Step 4: On the Connect Channel screen, set up a new GunBroker connection:
Enter a Connection Name (e.g., "GunBroker Connection #3").
Select the Environment (e.g., Production or Sandbox) from the dropdown.
Enter your GunBroker Password.
Enter your GunBroker Username.
Click Test Connection & Continue to verify the setup.
Step 5: Choose the processes you want to enable for your GunBroker channel:
Import Listings: To create and update listings and products in Flxpoint.
Get Orders: To import new orders and send back acknowledgments.
Step 6: In the Configure Settings screen for Import Listings:
Set Set New Listings to Paused to Yes or No. Choosing Yes will pause new listings to prevent syncing until inventory is linked.
Set your Master SKU by selecting Use a field from my channel and choosing a field, or select Don't set a master SKU at this time.
Under Product & Listing Management, choose how listings should be imported (e.g., "Create and update products & listings").
Click Confirm to proceed.
Step 7: In the Configure Settings screen for Get Orders:
Set the Time Frame (e.g., "CreatedLastWeek").
Select the Order Status to import (e.g., Pending Seller Review, Pending Buyer Confirmation, etc.).
Select the FFL Status (e.g., All, Awaiting FFL, FFL Received).
Set the Personal Identifying Information Retention (e.g., Indefinitely, 30 Days After Shipment).
Click Confirm to proceed.
Step 8: In the Channel Created screen:
Check the box to Enable this to start importing your active listings into Flxpoint immediately if desired.
Check the box to Start importing orders immediately if desired.
Click Confirm & Finish to complete the setup.
Final Step: Your GunBroker channel is now set up! You can revisit it in Sales Channels to:
Start Import Listings to create and update listings and products in Flxpoint.
Start Get Orders to import new orders and send back acknowledgments.
Use other operations like Sync Listings, Publish Listings, Sync Orders, and Send Accounting Shipments as needed.
Adjust any skipped steps from the channel settings.
×
![]()
Listing Operations
Flxpoint allows you to manage product listings on eBay by syncing inventory, updating product details, and controlling pricing and availability. This ensures accurate and real-time updates across your eBay store.
Import Listings
Sync & Link Listings
Publish Listings
Supported | GunBroker - Publish Listings
Introduction to GunBroker Publish Listings Integration
This section guides you through using the Publish Listings integration to create new product listings on GunBroker directly from Flxpoint. This integration helps you manage your product catalog by ensuring accurate category mapping, handling zero quantity scenarios, and mapping your product data to GunBroker’s fields. It also includes safeguards to prevent publishing listings with incorrect pricing. Let’s dive into how this works and how to set it up.
Purpose of This Integration
The Publish Listings integration for GunBroker allows you to:
- Create new product listings on GunBroker directly from Flxpoint.
- Map your product data to GunBroker’s fields using a mapping template.
- Ensure proper category mapping using numeric Category IDs.
- Prevent publishing listings with missing or zero cost/list price to avoid unintended low pricing.
This integration streamlines the process of listing products on GunBroker, ensuring your listings are accurate and compliant with GunBroker’s requirements.
How the Integration Works
The integration follows these steps to publish listings on GunBroker:
1. Category Mapping: GunBroker requires category mapping using numeric Category IDs. For example, “Pistol Ammunition” maps to Category ID 3018. You can find the full list of Category IDs here.
2. Mapping Data: A mapping template defines how your system’s fields (e.g., Title, SKU) are mapped to GunBroker’s fields (e.g., Name, SKU). A default rule ensures quantity is set to 0 if cost or list price is 0 (more details below).
3. Publishing Products: Products are published via a POST request using parameters like
ItemSKU={sku}&SellerName={sellerName}&ItemID={external listing ID}.
4. Handling Zero Quantity: When Flxpoint syncs a quantity of 0 to GunBroker, the corresponding listing is automatically ended. To republish, update the quantity in Flxpoint and run the sync operation again.
5. Running the Integration: You can run the integration manually or schedule it to run automatically (e.g., daily or weekly).
Note: Ensure SKUs match between Flxpoint and GunBroker to prevent duplicate listings during re-publishing.
Category Mapping Requirements
GunBroker requires category mapping using numeric Category IDs. Below is a sample of some Category IDs:
For the full list, refer to the Category ID spreadsheet.
| Category Path | Category ID |
|---|---|
| All > Air Guns > Air Gun Accessories | 3052 |
| All > Air Guns > Air Pistols | 3049 |
| All > Air Guns > Air Rifles | 3050 |
| All > Air Guns > Airsoft | 3048 |
| All > Air Guns > Paintball Guns | 3051 |
| All > Ammunition > Reloading > Reloading Equipment | 3015 |
| All > Ammunition > Reloading > Reloading Supplies | 3016 |
| All > Ammunition > Ammo Storage | 3053 |
| All > Ammunition > Large Bore, Inert & Cannon Ammo | 3110 |
| All > Ammunition > Other Ammunition | 3020 |
| All > Ammunition > Pistol Ammunition | 3018 |
Watch the Setup Video
Custom Fields
Custom fields can be mapped in the mapping template as key/value pairs. GunBroker supports these as item characteristics, which can be uploaded for each listing.
Attributes / Tags
Attributes can be uploaded as custom fields on GunBroker. Map these in the mapping template to ensure they are associated with your listings.
Variations / Options
GunBroker does not support variations/options. All products are listed as individual listings, and each variant must be published as a separate listing.
Generic Pricing (& Currency)
The integration supports sending a single price for each listing. For auction listings, the starting price is mandatory, while reserve price and buy-now price are optional. Currency is set by GunBroker (typically USD). To avoid publishing with incorrect pricing (e.g., a very low price), a default rule sets the quantity to 0 if the cost or list price is 0 (see Quantity section below).
Quantity
For auction listings, quantity is always set to 1. For fixed-price listings, any quantity can be sent. When the quantity syncs to 0, the listing is automatically ended.
Important Quantity Rule: To prevent listings from being published with a very low or incorrect price (which can happen if cost or list price is missing or 0), a default rule is applied in the mapping template for new GunBroker configurations. This rule sets the quantity to 0 if:
Important Quantity Rule: To prevent listings from being published with a very low or incorrect price (which can happen if cost or list price is missing or 0), a default rule is applied in the mapping template for new GunBroker configurations. This rule sets the quantity to 0 if:
- The cost (e.g., Listing Variant’s Estimated Cost) is 0 or does not exist, OR
- The list price (e.g., Listing Variant’s List Price) is 0 or does not exist.
When the quantity is set to 0, the listing is automatically delisted from GunBroker, preventing it from being sold at an unintended price. You can modify or remove this rule in the mapping template if needed.
Multiple Warehouses
GunBroker does not support multiple warehouses. Quantities are aggregated in Flxpoint and sent as a single value to GunBroker.
Weights & Dimensions (& Units)
Weight is uploaded as an item characteristic but is not a required field on GunBroker. Dimensions are not supported.
Images
Multiple images can be uploaded for each listing. If variant images are blank, parent images are used. Ensure images meet GunBroker’s requirements.
Categories
Categories must be mapped using numeric Category IDs. Ensure the category field in your mapping template matches the correct Category ID from the spreadsheet.
Overwriting Supported
Overwriting is supported to update static data on GunBroker. However, it does not support auction listings. Ensure SKUs match to avoid duplicates.
Offerings vs Creation
The integration supports creating new listings on GunBroker. Overwriting can be used to update existing listings with matching SKUs.
Option Limitations
GunBroker does not support options or variations. Each product must be listed individually.
Image Limitations
GunBroker supports multiple images per listing, but specific size limits may apply. Ensure your images comply with GunBroker’s requirements.
HTML Descriptions
HTML descriptions are supported and can be mapped to GunBroker’s Description field via the mapping template.
Limitations
Key limitations for publishing on GunBroker:
- Auto relist is set to No by default.
- Serial numbers can be created during publishing but cannot be updated via overwriting.
- Categories must be mapped using numeric Category IDs.
Mapping Template Details
A mapping template defines how data from your system is published to GunBroker. For example, you can map your system’s “Title” field to GunBroker’s “Name” field. Below are the details:
Interface Overview
- The mapping screen is labeled “Publish Listings” at the top. You can name your template (e.g., “Publish Listings 1”).
- Buttons available: Delete, Duplicate, and Save.
- Two sections:
- From Value: Fields from your system (e.g., Listing Parent fields like Title, Parent SKU; Listing Variant fields like UPC, MSRP).
- To GunBroker Product Field: Fields in GunBroker (e.g., Name, SKU, Category).
Mapping Options
You can choose from the following options for each field:
- Don’t Map: Ignore the field entirely.
- Set To Empty: Clear any existing data in that field on GunBroker.
- Field: Map a field from your system (e.g., Listing Parent’s “Title”) to a GunBroker field.
- Value: Set a constant value for all listings.
- Mapping Set: Apply a predefined transformation or mapping table.
- Rules: Use conditional logic to modify fields based on specific criteria (e.g., the default Quantity rule to set quantity to 0 if cost or list price is 0).
Available Source Fields
Your system provides fields under categories like “Listing Parent” and “Listing Variant,” including:
- Listing Parent: Attribute, Brand, Category 1, Category 2, Category 3, Custom Field, Description, Image, Parent SKU, Title.
- Listing Variant: ASIN, Custom Aggregate Field, Custom Field, Description, Dimensional Weight, Estimated Cost, Estimated Dropship Fee, Estimated Shipping Cost, GTIN, Height, Image, Length, List Price, MAP, MPN, MSRP, Master SKU, Option, Quantity, SKU, Title, UPC, Weight, Width.
Complete Field Mappings
Below is a comprehensive list of fields you can map to GunBroker, based on the integration’s capabilities:
Name: The listing name (required).
- Example: “9mm Pistol Ammunition”
- Suggested Mapping: Map to Listing Parent’s “Title” using Field.
SKU: The SKU of the listing.
- Example: “AMMO-001”
- Suggested Mapping: Map to Listing Parent’s “Parent SKU” using Field.
Category: The numeric Category ID (required).
- Example: “3018” (Pistol Ammunition)
- Suggested Mapping: Map to Listing Parent’s “Category 1” using Field and ensure it matches a numeric Category ID.
Price: The starting price for auction listings or fixed price for standard listings.
- Example: “29.99”
- Suggested Mapping: Map to Listing Variant’s “List Price” using Field.
Quantity: The quantity of the listing (1 for auctions, any for fixed-price). A default rule sets this to 0 if cost or list price is 0 to prevent incorrect pricing.
- Example: “1”
- Suggested Mapping: Map to Listing Variant’s “Quantity” using Field.
Description: The description of the listing.
- Example: “High-quality 9mm pistol ammunition, 50 rounds per box.”
- Suggested Mapping: Map to Listing Parent’s “Description” using Field.
Images: The images for the listing.
- Example: A list of image URLs.
- Suggested Mapping: Map to Listing Parent’s “Image” using Field.
UPC: Universal Product Code for the listing.
- Example: “123456789012”
- Suggested Mapping: Map to Listing Variant’s “UPC” using Field.
Weight: The weight of the product (uploaded as an item characteristic).
- Example: “2.5”
- Suggested Mapping: Map to Listing Variant’s “Weight” using Field.
Custom Fields: Additional item characteristics as key/value pairs.
- Example: “Color: Black”
- Suggested Mapping: Map to Listing Parent’s “Custom Field” using Field.
Practice Mapping
Here’s a quick example—if you map the “Name” field:
Troubleshooting
If the integration encounters an issue, try these steps:
- Ensure category mappings use correct numeric Category IDs from the spreadsheet.
- Check that SKUs match between Flxpoint and GunBroker to avoid duplicates.
- If a listing ends due to zero quantity (e.g., because cost or list price is 0), update the cost/list price and quantity in Flxpoint, then re-run the sync.
- Ensure images meet GunBroker’s requirements.
If problems persist, contact support for assistance.
Conclusion
With the GunBroker Publish Listings integration, you can efficiently create new listings on GunBroker directly from Flxpoint. By mapping your product data, ensuring proper category IDs, and leveraging safeguards like the Quantity rule, this integration helps you maintain an accurate and compliant catalog on GunBroker, ready for customers!
×
![]()
Order Operations
Flxpoint imports orders from eBay into your system, automating order processing, tracking updates, and inventory adjustments. This streamlines fulfillment and ensures efficient handling of eBay transactions.
Get Orders
Sync Orders