GunBroker as a Channel

GunBroker is a leading online auction platform designed for firearms, ammunition, and related accessories, making it the go-to marketplace for firearm enthusiasts. With Flxpoint’s direct integration, you can seamlessly list, sync, and manage your firearm inventory on GunBroker, reaching a niche audience of buyers while automating key processes. This integration supports a range of operations, including:
 
  • Publishing listings with automated AI Category Mapping to simplify categorization.
  • Syncing pricing and quantity data to keep your inventory up-to-date.
  • Importing orders with FFL (Federal Firearms License) status filtering for compliance.

Whether you’re a seasoned seller or new to firearm sales, GunBroker on Flxpoint helps you streamline your workflow and grow your business. Let’s explore how to set up and manage your integration!

 

How to connect

Step 1: Log into your Flxpoint account and navigate to the Channels section.
Step 2: Click on + Add Channel to start your GunBroker integration.
Step 3: In the popup, select GunBroker as your channel, enter a channel name, and click Continue.
Step 4: Enter your GunBroker authentication details.
Provide your GunBroker Username and Password.
Select the appropriate Environment (e.g., Production or Sandbox) from the dropdown.
Click Continue to authenticate your GunBroker account.
GunBroker Authentication Screen
Step 5: Configure your GunBroker integration settings:
- Import Listings: Enable to import product listings from GunBroker. Set the Master SKU field (e.g., GunBroker Variant - SKU to Master SKU) and enable Set New Listings to Paused if desired.
- Publish Listings: Enable to create and publish listings to GunBroker. Configure settings like Listing Duration (e.g., 30 days), Shipping Classes Supported (e.g., Overnight, FirstClass), Payment Methods (e.g., AMEX, PayPal), and Trim Title up to 75 characters (set to No if titles should not be trimmed).
- Sync Listings: Enable to sync pricing and quantity data with GunBroker. Set the linking identifier (e.g., Flxpoint Listing: SKU to GunBroker Listing: SKU).
- Get Orders: Enable to import orders from GunBroker. Select order statuses (e.g., Pending Seller Review, Pending Buyer Confirmation) and set the time range (e.g., CreatedLastWeek).
- Sync Orders: Enable to sync order and shipment data with GunBroker. No additional settings are required for this step.
Step 6: Click Continue to finalize the setup. Your GunBroker channel is now connected.
A confirmation message will appear: “Success! Your connection to GunBroker was created successfully and your selected operations have been configured.”
Step 7: Manage your GunBroker integration.
In the Channels > GunBroker section, you’ll see the status as Active with options to Run Sync, View Logs, Adjust Schedule, or Edit Integration Settings.
Tip: Use the Integration Settings to fine-tune operations like importing, publishing, or syncing listings and orders.

 

Listing Operations

This section covers the operations related to managing your Gunbroker listings, including linking, syncing, and publishing.

Publish Listings

Supported | GunBroker - Publish Listings

Introduction to GunBroker Publish Listings Integration
This guide will walk you through setting up the Publish Listings integration for GunBroker on Flxpoint. It helps you create and publish product listings to GunBroker, ensuring your products are ready for sale. Let’s dive in!

Purpose of This Integration
This integration allows you to push your product catalog to GunBroker as listings, automating the process of selling on their platform:
- Creates new listings or updates existing ones with details like price, quantity, and shipping options.
- Ensures listings comply with GunBroker’s requirements (e.g., titles under 75 characters).
It saves time and reduces errors by syncing your inventory directly to GunBroker.

How the Integration Works
The integration follows these steps:
1. Initiation: Flxpoint retrieves products from your catalog that are ready to publish.
2. Mapping: Maps your product data (e.g., SKU, title, price) to GunBroker’s required fields using a mapping template.
3. Validation: Ensures data meets GunBroker’s rules (e.g., title ≤ 75 characters, category configured).
4. Publishing: Sends the listings to GunBroker via their API, creating or updating listings.
5. Confirmation: Updates your Flxpoint account with the listing status (e.g., “Active”).
6. Syncing: Optionally syncs updates like price or quantity. Run manually using "Run Sync" or schedule via "Adjust Schedule."
Note: You’ll need to authenticate with your GunBroker username and password (as set up in the connection steps) and configure categories in GunBroker.

Configuration Options
Customize how your listings are published with these settings:
- Enable Publish Listings: Turn on to create and publish listings to GunBroker.
- Auto Re-list When Back in Stock: Automatically re-list products when they’re back in stock.
- Listing Duration: Choose how long listings stay active (e.g., 30 days).
- Shipping Classes: Select supported shipping options (e.g., Overnight, FirstClass).
- Payment Methods: Choose accepted payment methods (e.g., PayPal, AMEX).
- Country Code and Postal Code: Specify the seller’s country and postal code.
- Sales Tax and State Code Taxes: Decide if the seller collects sales tax and specify state tax rates.
- Auto Relist: Decide if listings should automatically relist after they end (e.g., Do Not Relist, Relist Until Sold).
- Category Mapping: Choose between manual category mapping (using uploaded files) or AI Category Mapping to automate category assignments for GunBroker listings.
- Mapping Template: Enable or disable fields to control what data is sent (e.g., enable/disable “Weight”). A default rule helps ensure safe publishing by setting quantity to 0 if cost or list price is missing.

Setup Instructions
Follow these steps to configure the Publish Listings integration:
1. Enable Publish Listings: Go to the GunBroker channel settings, find "Publish Listings," and toggle it on.
2. Configure Basic Settings: Set the following:
- Auto Re-list When Back in Stock: Enable if you want to automatically re-list products when they’re restocked.
- Listing Duration: Select a duration (e.g., 30 days).
- Shipping Classes Supported: Check options like Overnight, FirstClass, or Priority.
- Payment Methods: Check accepted methods like PayPal, AMEX, or CertifiedCheck.
- Who Pays for Shipping: Choose “Seller pays for shipping” or another option.
- Country Code: Enter a 2-character country code (e.g., “US”).
- Postal Code: Enter your postal code (e.g., “12345”).
- Sales Tax: Select “Seller must collect sales tax” if applicable.
- Auto Relist: Choose whether listings should automatically relist after they end: “Do Not Relist” (default) or “Relist Until Sold.”
- Trim Title up to 75 characters: Set to “No” if you don’t want titles trimmed (GunBroker requires titles ≤ 75 characters).
- Replace Repeated Word from the Title: Set to “No” to allow repeated words in titles.
3. Configure Advanced Settings: Click "Show Advanced Settings" to adjust:
- Default Shipping Profile ID: Enter a shipping profile ID configured on GunBroker (optional).
- Auto Relist: Choose “Do Not Relist” or another option. Note: This is hard-coded to 1 in Flxpoint, so “No” is recommended to avoid unexpected behavior.
- Inspection Period: Set a return period (e.g., “AS IS - No refund or exchange”).
- Standard Text ID: Enter an ID for additional terms of sale.
- Shipping Costs: Enter costs for each selected shipping class (e.g., Overnight Cost, FirstClass Cost).
- State Code Taxes: Specify tax rates by state (e.g., `[{"State":"FL", "TaxRate":"7"}]`).
- Use Tax Calculation: Enable to use GunBroker’s built-in tax calculation (recommended if you’re collecting sales tax).
4. Configure Categories: GunBroker requires categories to be configured for publishing listings. You can choose between manual mapping or AI Category Mapping:
- Manual Mapping: Use the category IDs from this spreadsheet: GunBroker Category IDs. Example categories:
- Firearms (ID: 12345)
- Ammunition (ID: 67890)
- Optics (ID: 54321)
- AI Category Mapping: Automate category assignments using Flxpoint’s AI Category Mapping tool, exclusive to GunBroker:
- Navigate to Connections in the left-hand panel.
- Select the GunBroker Sales Channel.
- Go to the Settings tab and scroll to the Category Mappings section.
- Click Use AI Category Mapping to enable the tool.
- Ensure your category mapping is set to Cat 1 (e.g., in the mapping template, map “Category1” to “GunBroker Variant - CategoryID”). The AI tool is configured to use Cat 1, and using Cat 2 or Cat 3 may cause publishing errors.
- Key Details about AI Category Mapping:
- Exclusive to GunBroker: This feature is only available for GunBroker and not other channels.
- Overrides Manual Sets: Enabling AI Category Mapping supersedes any manually uploaded mapping sets.
- Switching Back: If you revert to manual mapping, your previous files remain intact and will resume mapping upon saving.
- What It Does: Automates the assignment of categories for GunBroker listings, eliminating the need for manual file uploads. However, it does not auto-populate specific firearm details (e.g., Manufacturer, Model, Caliber, Barrel Length, Total Capacity)—these must be managed separately.
- AI vs. Manual Mapping: If you’re already using manual mapping effectively, continue with that. If you’re new to GunBroker or want a clean slate, enable AI Category Mapping for a more automated approach.
- Benefits of AI Category Mapping:
- Time Savings: No need to compile manual mapping files.
- Automatic Updates: The AI system handles updates when new categories or products are added.
- Easy Reset: Switch back to manual mapping at any time if needed.
Map the chosen category IDs (manual or AI-assigned) to the “Category1” field in the mapping template (see below).
5. Create a Mapping Template: Use "Manage Mapping" to define which product fields to send (see below).
6. Run the Integration: Start manually with "Run Sync" or schedule via "Adjust Schedule."

Mapping Template Details
The mapping template controls how your product data is sent to GunBroker. You can enable or disable fields to customize what’s included in your listings.

Interface Overview
- The mapping screen is labeled “Flxpoint → GunBroker” under “Publish Listings.”
- Buttons: Cancel and Save Mapping.
- Columns: Left (Flxpoint fields), Right (GunBroker fields).
Mapping Options
- Enable: Send the field (e.g., enable “Weight”).
- Disable: Ignore the field (e.g., disable “Category2”).
Required fields like “GunBroker Variant - SKU” and “GunBroker Variant - Title” cannot be disabled.
Available Fields
- Category Fields: Category1, Category2, Category3 (maps to GunBroker Variant - CategoryID).
- Product Details: Auto Relist, Description, Images, List Price, Quantity, Requires FFL, SKU, Title, UPC, Weight.
Complete Field Mappings
GunBroker Variant - SKU: The product’s unique identifier.
- Example: “GB12345”
- Mapping: Maps to “SKU” from Flxpoint.
- Reason: Identifies the product on GunBroker. This field is required.
GunBroker Variant - Title: The product’s listing title.
- Example: “Smith & Wesson M&P 9mm”
- Mapping: Maps to “Title” from Flxpoint.
- Reason: Displays the product name (must be ≤ 75 characters).
GunBroker Variant - Fixed Price: The product’s selling price.
- Example: “$599.99”
- Mapping: Maps to “List Price” from Flxpoint.
- Reason: Sets the price for the listing.
GunBroker Variant - Quantity: The number of units available.
- Example: “5”
- Mapping: Maps to “Quantity” from Flxpoint.
- Reason: Specifies how many units are for sale.
- Safety Rule: To prevent publishing items at incorrect prices, a default rule sets the quantity to 0 (delisting the item on GunBroker) if the cost or list price is 0 or missing. Ensure your inventory links and cost data are set to avoid this.
GunBroker Variant - Auto Relist: Controls whether the listing automatically relists after it ends.
- Example: “1” (Do Not Relist) or “2” (Relist Until Sold)
- Mapping: Maps to “Auto Relist” from Flxpoint.
- Reason: Determines the relisting behavior. If set in the mapping template, this value will be used; otherwise, the value from the integration settings (under Basic Settings) will apply.
GunBroker Variant - CategoryID: The category for the listing.
- Example: “12345” (Firearms category ID)
- Mapping: Maps to “Category1” from Flxpoint.
- Reason: Places the listing in the correct GunBroker category. Must be configured using manual mapping or AI Category Mapping.
Practice Mapping Try enabling or disabling the “Weight” field:

Troubleshooting
If you encounter issues:
- Category Not Configured: Ensure categories are set up using either manual mapping (via the spreadsheet: GunBroker Category IDs) or AI Category Mapping.
- AI Category Mapping Errors: If using AI Category Mapping, ensure your category mapping is set to Cat 1 in the mapping template. Using Cat 2 or Cat 3 may lead to publishing errors.
- Item Not Published (Quantity Set to 0): A default rule sets the quantity to 0 (delisting the item on GunBroker) if the cost or list price is 0 or missing. Check that your inventory links are set and cost/list price data is provided.
- Auto Relist Not Working as Expected: If you’ve set Auto Relist in the mapping template, that value will take priority. If not set in the mapping template, the value from the integration settings (under Basic Settings) will be used. Ensure your settings align with your desired relisting behavior.
- Title Too Long: Titles must be ≤ 75 characters. Check “Trim Title up to 75 characters” or shorten your titles.
- Missing Required Fields: Ensure fields like SKU, Title, and CategoryID are enabled in the mapping template.
- Shipping Costs Missing: If you selected a shipping class (e.g., Overnight), enter its cost in the advanced settings.
- Auto Relist Issue: Auto Relist is hard-coded to 1 in Flxpoint, meaning it’s set to “No.” If you select “Relist Until Sold,” it may not behave as expected.
- Can Offer Feature Removed: If you sync listings after publishing, features like “Can Offer” may be removed. Adjust your syncing settings to avoid this.
- Review Logs: Check errors in “View Logs” if a listing fails to publish.
- Contact Support: Reach out to Flxpoint or GunBroker support for assistance.

Conclusion
Once set up, your products will be published to GunBroker effortlessly, keeping your listings up-to-date and ready for sales. You can manage everything from the GunBroker channel settings in Flxpoint.

Sync & link Listings

Supported | GunBroker - Sync & Link Listings

Introduction to GunBroker Sync & Link Listings Integration
This guide will help you set up the Sync & Link Listings integration for GunBroker on Flxpoint. It ensures your Flxpoint listings stay in sync with GunBroker by automatically updating pricing and quantity data. It also links your listings using identifiers like SKU, UPC, or GTIN. Let’s get started!

Purpose of This Integration
This integration keeps your inventory data consistent between Flxpoint and GunBroker, reducing overselling and pricing errors:
- Automatically syncs pricing and quantity updates between Flxpoint and GunBroker listings.
- Links Flxpoint listings to GunBroker listings using a chosen identifier (SKU, UPC, or GTIN).
- Supports actions like pausing, unpausing, or delisting GunBroker listings directly from Flxpoint.
It streamlines inventory management, ensuring your GunBroker listings reflect the latest data from Flxpoint.

How the Integration Works
The integration follows these steps:
1. Initiation: Flxpoint retrieves all active listings from GunBroker and compares them to your Flxpoint listings.
2. Linking: Matches Flxpoint listings to GunBroker listings using the selected identifier (e.g., SKU).
3. Syncing: Updates pricing and quantity on GunBroker based on Flxpoint data.
4. Status Updates: If a product is out of stock in Flxpoint, the GunBroker listing can be paused, unpaused, or delisted based on your settings.
5. Confirmation: Assigns a new ItemID to linked listings and saves the association in Flxpoint.
6. Execution: Runs manually via "Run Sync" or on a schedule via "Adjust Schedule."
Note: Linking with SKU is the fastest and most reliable method. Using UPC or GTIN may take longer.

Configuration Options
Customize how your listings are synced and linked with these settings:
- Enable Sync Listings: Turn on to automatically sync pricing and quantity data with GunBroker.
- Linking Identifier: Choose the identifier to link listings (SKU, UPC, or GTIN).
- Listing Type: Specify the type of GunBroker listings to sync (Any, Fixed Price, or Auction).
- Mapping Template: Enable or disable fields to control what data is synced (e.g., enable/disable “Quantity”). A default rule helps ensure safe syncing by setting quantity to 0 if cost or list price is missing.
- Actions: Pause, unpause, or delist GunBroker listings directly from Flxpoint’s product management interface.

Setup Instructions
Follow these steps to configure the Sync & Link Listings integration:
1. Enable Sync Listings: Go to the GunBroker channel settings, find "Sync Listings," and toggle it on.
2. Configure Linking Identifier: Set the identifier to link Flxpoint and GunBroker listings:
- SKU: Recommended for fastest and most reliable linking (a unique Flxpoint ID).
- UPC: A 12-digit barcode for retail products.
- GTIN: A global ID like UPC or EAN, more flexible but slower.
Set the priority (e.g., try SKU first, then GTIN). Default is SKU.
3. Configure Listing Type: Under "Additional Settings," select the type of GunBroker listings to sync:
- Any: Syncs both Fixed Price and Auction listings.
- Fixed Price: Syncs only Fixed Price listings.
- Auction: Syncs only Auction listings.
Default is "Any."
4. Create a Mapping Template: Use "Manage Mapping" to define which fields to sync (see below).
5. Run the Integration: Start manually with "Run Sync" or schedule via "Adjust Schedule."
6. Manage Listings: From the Flxpoint Products page, select listings and use the "Actions" dropdown to:
- Pause Listings: Temporarily pause GunBroker listings.
- Unpause Listings: Reactivate paused listings.
- Delist Listings: Remove listings from GunBroker if out of stock.

Mapping Template Details
The mapping template controls which data fields are synced between Flxpoint and GunBroker. You can enable or disable fields to customize the sync process.

Interface Overview
- The mapping screen is labeled “Flxpoint → GunBroker” under “Sync Listings.”
- Buttons: Cancel and Save Mapping.
- Columns: Left (Flxpoint fields), Right (GunBroker fields).
Mapping Options
- Enable: Sync the field (e.g., enable “Quantity”).
- Disable: Ignore the field (e.g., disable “List Price”).
Required fields like “GunBroker Variant - SKU” cannot be disabled.
Available Fields
- Sync Fields: List Price (maps to GunBroker Variant - Fixed Price), Quantity (maps to GunBroker Variant - Quantity), SKU (maps to GunBroker Variant - SKU).
Complete Field Mappings
GunBroker Variant - SKU: The identifier used to link listings.
- Example: “GB12345”
- Mapping: Maps to “SKU” from Flxpoint.
- Reason: Links the Flxpoint listing to the GunBroker listing. This field is required.
GunBroker Variant - Fixed Price: The product’s selling price.
- Example: “$599.99”
- Mapping: Maps to “List Price” from Flxpoint.
- Reason: Updates the price on GunBroker to match Flxpoint.
GunBroker Variant - Quantity: The number of units available.
- Example: “5”
- Mapping: Maps to “Quantity” from Flxpoint.
- Reason: Updates the quantity on GunBroker to match Flxpoint.
- Safety Rule: To prevent syncing items at incorrect prices, a default rule sets the quantity to 0 (delisting the item on GunBroker) if the cost or list price is 0 or missing. Ensure your inventory links and cost data are set to avoid this.
Practice Mapping Try enabling or disabling the “Quantity” field:

Limitations
Be aware of the following limitations:
- Hiding: Not supported. You cannot hide listings during sync.
- Delisting: Supported. Listings can be delisted if out of stock or queued to delist.
- Inventory Tracking Configs: Not supported. Inventory tracking configurations are not synced.
- Custom Fields: Not supported. Custom fields are not synced.
- POS for Auction Listings: Not supported. Delisting for out-of-stock items applies only to Fixed Price listings, not Auctions.

Troubleshooting
If you encounter issues:
- Linking Fails: Ensure the selected identifier (e.g., SKU) matches between Flxpoint and GunBroker. SKU is fastest; UPC/GTIN may take longer.
- Quantity Not Updating: Check if the “Quantity” field is enabled in the mapping template. A default rule sets the quantity to 0 (delisting the item on GunBroker) if the cost or list price is 0 or missing—ensure your inventory links and cost data are set.
- Auction Listings Not Delisting: Delisting for out-of-stock items is not supported for Auction listings. Set “Listing Type” to “Fixed Price” if you need this feature.
- Sync Not Running: Verify the sync schedule in “Adjust Schedule” or run manually with “Run Sync.”
- Review Logs: Check errors in “View Logs” if syncing fails.
- Contact Support: Reach out to Flxpoint or GunBroker support for assistance.

Conclusion
With this integration set up, your Flxpoint and GunBroker listings will stay in sync, ensuring accurate pricing and quantity data. You can also manage listings directly from Flxpoint, making inventory management a breeze.

Import Listings

Supported | GunBroker - Import Listings

Introduction to GunBroker Import Listings Integration
This guide will walk you through setting up the Import Listings integration for GunBroker on Flxpoint. It allows you to bring your GunBroker product listings into Flxpoint, making it easier to manage your inventory across platforms. Let’s get started!

Purpose of This Integration
This integration imports product listings from GunBroker into Flxpoint, ensuring your catalog stays up-to-date with your GunBroker inventory:
- Imports listings as products or updates existing ones in Flxpoint based on SKU matches.
- Supports pausing imported listings to prevent immediate syncing back to GunBroker.
- Handles both auction and fixed-price listings from GunBroker.
It simplifies inventory management by centralizing your GunBroker listings in Flxpoint.

How the Integration Works
The integration follows these steps:
1. Initiation: Flxpoint connects to GunBroker’s API using the base URL (e.g., https://api.gunbroker.com/v1/) and the endpoint /items.
2. Data Retrieval: Retrieves all active listings (both auction and fixed-price) from GunBroker.
3. Processing: Imports listings into Flxpoint based on your settings (e.g., create new products, update existing ones).
4. SKU Mapping: Links GunBroker listings to Flxpoint listings using the “GunBroker Variant - SKU” field as the Master SKU.
5. Pausing (Optional): Sets newly imported listings to “Paused” if enabled, preventing immediate syncing back to GunBroker.
6. Execution: Runs manually via "Run Sync" or on a schedule via "Adjust Schedule."
Note: An attribute “IsFixedPrice” is added to the product catalog to identify fixed-price listings.

Configuration Options
Customize how listings are imported with these settings:
- Enable Import Listings: Turn on to import product listings from GunBroker.
- Product & Listing Management: Choose how listings are imported into Flxpoint:
- Create new products only: Imports listings as new products if there’s no SKU match.
- Create products only: Creates new products without linking to existing listings.
- Create and update products & listings: Creates new products or updates existing ones based on SKU matches.
- Master SKU: Set the “GunBroker Variant - SKU” field as the Master SKU for linking.
- Set New Listings to Paused: Automatically pause imported listings to prevent syncing back to GunBroker until you’re ready.

Setup Instructions
Follow these steps to configure the Import Listings integration:
1. Enable Import Listings: Go to the GunBroker channel settings, find "Import Listings," and toggle it on.
2. Configure Product & Listing Management: Choose how to handle imported listings:
- Create new products only: New listings are created if there’s no SKU match in Flxpoint.
- Create products only: Listings are imported as new products without linking to existing listings.
- Create and update products & listings: Updates existing products/listings or creates new ones based on SKU matches. Recommended for most users.
3. Set Master SKU: Ensure the “GunBroker Variant - SKU” field is mapped to the “Master SKU” in Flxpoint. This links GunBroker listings to Flxpoint listings.
4. Set New Listings to Paused: Enable this option to pause newly imported listings. This prevents pricing or quantity data from syncing back to GunBroker until you’re ready.
5. Run the Integration: Start manually with "Run Sync" or schedule via "Adjust Schedule."
6. Unpause Listings (if Paused): If you enabled “Set New Listings to Paused,” unpause listings when ready:
- Go to Products in Flxpoint.
- Select the imported listings.
- Click ActionsChange Listing StatusUnpause Listings.

Imported Data Details
Here’s what data is imported from GunBroker into Flxpoint:
- List Price: Imported in USD only (e.g., “$599.99”). Client pricing in other currencies is not supported.
- Quantity: Available quantity is saved in Flxpoint (e.g., “5”).
- Images: Only the thumbnail image URL is imported and saved in Flxpoint (e.g., “https://example.com/image.jpg”).
- Categories: Secondary category name is saved as Cat1, and secondary category code as Cat2 in Flxpoint (e.g., Cat1: “Firearms,” Cat2: “12345”).
- MPN: Manufacturer Part Number is imported if available (e.g., “MPN123”).
- IsFixedPrice Attribute: Added to identify fixed-price listings (e.g., “true” for fixed-price, “false” for auction).

Limitations
Be aware of the following limitations:
- Custom Fields: Not supported. Custom fields from GunBroker are not imported.
- Variations/Options: Not supported. Variations are not available on GunBroker.
- Client Pricing & Currency: Not supported. Only list prices in USD are imported.
- Multiple Warehouses: Not supported. Quantity is saved as a single value in Flxpoint.
- Weights & Dimensions: Not supported. Weight and dimension data are not imported.

Troubleshooting
If you encounter issues:
- Import Fails: Verify your GunBroker authentication (username, password, environment) in the channel settings.
- SKU Not Matching: Ensure the “GunBroker Variant - SKU” field is correctly set as the Master SKU. Check for discrepancies in SKU formatting between GunBroker and Flxpoint.
- Listings Not Paused: If “Set New Listings to Paused” is enabled but listings are active, check if they were manually unpaused. Review the integration logs.
- Missing Data (e.g., Images): Only thumbnail URLs are imported. Other image data is not supported.
- Sync Not Running: Verify the sync schedule in “Adjust Schedule” or run manually with “Run Sync.”
- Review Logs: Check errors in “View Logs” if the import fails.
- Contact Support: Reach out to Flxpoint or GunBroker support for assistance.

Conclusion
With this integration set up, your GunBroker listings will be imported into Flxpoint, allowing you to manage your inventory seamlessly. You can control how listings are imported and ensure they’re ready for syncing by pausing/unpausing as needed.

 

Order Operations

This section covers the operations related to managing your Gunbroker orders, including getting and syncing orders.

Get Orders

Supported | GunBroker - Get Orders

Introduction to GunBroker Get Orders Integration
This guide will help you set up the Get Orders integration for GunBroker on Flxpoint. It allows you to import orders from GunBroker into Flxpoint, ensuring you can manage and fulfill orders efficiently. Let’s get started!

Purpose of This Integration
This integration imports orders from GunBroker into Flxpoint, keeping your order data centralized and up-to-date:
- Imports orders based on selected statuses, FFL (Federal Firearms License) requirements, and time frames.
- Includes order details like billing/shipping addresses, line items, and totals.
- Supports mapping of order data to Flxpoint fields for seamless integration.
It streamlines order management by bringing GunBroker orders into Flxpoint for processing and fulfillment.

How the Integration Works
The integration follows these steps:
1. Initiation: Flxpoint fetches orders in batches of 250 using specified parameters (e.g., Order Status, FFL Status, Time Frame).
2. Data Retrieval: Retrieves order details using endpoints like /Orders/{orderID} for shipping method and carrier, /Items/{itemID} for line item SKUs and FFL data, and /FFLs/{license} for FFL business names.
3. Filtering: Imports orders based on selected Order Status (e.g., Pending Seller Review), FFL Status (e.g., Awaiting FFL), and Time Frame (e.g., CreatedLastWeek).
4. Mapping: Maps GunBroker order data to Flxpoint fields using the mapping template (e.g., SKU, billing address).
5. Processing: Saves the orders in Flxpoint, updating statuses as configured.
6. Execution: Runs manually via "Run Sync" or on a schedule via "Adjust Schedule."
Note: GunBroker does not support multi-status updates, so Flxpoint handles status updates in the backend.

Configuration Options
Customize how orders are imported with these settings:
- Enable Get Orders: Turn on to import orders from GunBroker.
- FFL Status: Choose which orders to import based on FFL requirements:
- All: Imports orders regardless of FFL status.
- Awaiting FFL: Imports orders awaiting FFL input.
- FFL Received: Imports orders with FFL already in the system.
- FFL Not Required: Imports orders where FFL is not required.
- Order Status: Select the order statuses to import (e.g., Pending Seller Review, Pending Buyer Confirmation).
- Time Frame: Set the age of orders to import (e.g., CreatedLastWeek for orders 7 days or newer).
- Personal Identifying Information Retention: Under Advanced Settings, decide how long to retain PII (e.g., Indefinitely, 30 days after shipment).
- Mapping Template: Enable or disable fields to control what order data is imported (e.g., enable/disable “Billing Address - Phone”).

Setup Instructions
Follow these steps to configure the Get Orders integration:
1. Enable Get Orders: Go to the GunBroker channel settings, find "Get Orders," and toggle it on.
2. Configure FFL Status: Select the FFL status for orders to import:
- All: All orders, regardless of FFL status.
- Awaiting FFL: Orders needing FFL input.
- FFL Received: Orders with FFL already provided.
- FFL Not Required: Orders not requiring FFL.
3. Select Order Status: Check the statuses to import:
- Pending Seller Review
- Pending Buyer Confirmation
- Pending Payment Received
- Pending Shipment
- Pending Buyer Review
- Completed
4. Set Time Frame: Choose the time frame for orders to import:
- CreatedLastWeek (7 days or newer)
- CreatedLast24 (24 hours or newer)
- CreatedLast48 (48 hours or newer)
- CreatedLastWeek
- CreatedLast2Weeks
- CreatedLast30Days
- CreatedLast90Days
5. Configure Advanced Settings: Click "Show Advanced Settings" to set:
- Personal Identifying Information Retention: Choose how long to retain PII (e.g., Indefinitely, 30 days after shipment).
6. Create a Mapping Template: Use "Manage Mapping" to define which order fields to import (see below).
7. Run the Integration: Start manually with "Run Sync" or schedule via "Adjust Schedule."

Mapping Template Details
The mapping template controls which order data is imported from GunBroker into Flxpoint. You can enable or disable fields to customize what’s included.

Interface Overview
- The mapping screen is labeled “GunBroker → Flxpoint” under “Get Orders.”
- Buttons: Cancel and Save Mapping.
- Columns: Left (GunBroker fields), Right (Flxpoint fields).
Mapping Options
- Enable: Import the field (e.g., enable “Billing Address - Phone”).
- Disable: Ignore the field (e.g., disable “Shipping Address - Address Line 2”).
Required fields like “Order - Ordered On” cannot be disabled.
Available Fields
- Order Line Item: Item Price (maps to Order Line Item - Cost), Quantity (maps to Order Line Item - Quantity), SKU (maps to Order Line Item - SKU), Item Subtotal (maps to Channel Invoice - Subtotal), Title (maps to Order Line Item - Title), Weight (maps to Order Line Item - Weight).
- Billing Address: Address 1, Address 2, City, Country Code, Full Name, Phone, Postal Code, State.
- Shipping Address: Address 1, Address 2, City, Country Code, Full Name, Phone, Postal Code, State.
- Order/Invoice: GunBroker Order ID (maps to Channel Invoice - Invoice Number), Total Price (maps to Order - Order Total), Shipping Cost (maps to Channel Invoice - Shipping Cost), Sales Tax Total (maps to Channel Invoice - Tax Cost), Miscellaneous Charge (maps to Channel Invoice - Other Cost), Order Date (maps to Order - Ordered On), Shipping Method (maps to Order - Channel Shipping Text).
Complete Field Mappings
Order Line Item - SKU: The SKU of the ordered item.
- Example: “GB12345”
- Mapping: Maps to “SKU” from GunBroker.
- Reason: Identifies the product in the order. This field is required.
Order Line Item - Cost: The price of the item.
- Example: “$599.99”
- Mapping: Maps to “Item Price” from GunBroker.
- Reason: Records the cost of each line item.
Billing Address - Full Name: The buyer’s full name.
- Example: “John Doe”
- Mapping: Maps to “Bill Name” from GunBroker.
- Reason: Identifies the buyer for billing purposes.
Shipping Address - Address Line 1: The shipping street address.
- Example: “123 Main St”
- Mapping: Maps to “Address 1” from GunBroker.
- Reason: Ensures accurate delivery.
Order - Order Total: The total order amount.
- Example: “$625.99”
- Mapping: Maps to “Total Price” from GunBroker.
- Reason: Records the total cost including shipping and taxes.
Practice Mapping Try enabling or disabling the “Billing Address - Phone” field:

Limitations
Be aware of the following limitations:
- Order & Payment Statuses: Supported, but Flxpoint does not interact with payment statuses. Payment info is saved in the channel invoice section.
- Order Acknowledgement: Not supported. Orders are imported without acknowledgement.
- Order Receipt/Invoice & Currency: Supported, but only in USD.
- Shipping Selection: Supported. A unique shipping method is available for each customer and can be mapped in shipping management.
- Custom Fields: Not supported. Custom fields are not imported.
- PII Restrictions: Supported. PII retention can be configured in Advanced Settings.
- Line Items/Donations: Not supported. Donations are not imported.
- Weight & Dimensions: Not supported. Weight and dimension data for order line items are not imported.

Troubleshooting
If you encounter issues:
- Orders Not Importing: Verify your GunBroker authentication (username, password, environment) in the channel settings.
- Missing Orders: Check the selected Order Status, FFL Status, and Time Frame. For example, if set to “CreatedLastWeek,” only orders from the last 7 days will import.
- FFL Data Missing: Ensure the correct FFL Status is selected (e.g., “FFL Received” for orders with FFL data).
- Sync Not Running: Verify the sync schedule in “Adjust Schedule” or run manually with “Run Sync.”
- Review Logs: Check errors in “View Logs” if the import fails.
- Contact Support: Reach out to Flxpoint or GunBroker support for assistance.

Conclusion
With this integration set up, your GunBroker orders will be imported into Flxpoint seamlessly, allowing you to manage and fulfill them efficiently. You can customize which orders to import and how their data is mapped, ensuring a smooth workflow.

Sync Orders

Supported | GunBroker - Sync Orders

Introduction to GunBroker Sync Orders Integration
This guide helps you set up the Sync Orders integration for GunBroker on Flxpoint. It ensures your orders from GunBroker are automatically fetched and updated in Flxpoint, streamlining your workflow. Let’s get started!

Purpose of This Integration
The Sync Orders integration pulls orders from GunBroker into Flxpoint, keeping your order data up-to-date. It:
- Fetches orders and updates their status (e.g., from “Shipped” to “Delivered”).
- Syncs shipping details like carrier and tracking numbers.
- Ensures accurate order management by marking orders as “FFL Received” when needed.
This saves you time and keeps your GunBroker orders in sync with Flxpoint.

How the Integration Works
The integration follows these steps:
1. Fetch Orders: Flxpoint retrieves orders from GunBroker using one of two methods: DMX-Core (V1) or Fixpoint API (V2).
2. Check FFL Status: For orders requiring FFL (Federal Firearms License), Flxpoint ensures the FFL status is marked as “Received” before marking the order as “Shipped.”
3. Sync Shipment Details: When an order is shipped, Flxpoint updates GunBroker with shipment details like carrier and tracking number.
4. Update Order Status: Flxpoint sends a “Run PUT” request to GunBroker to update the order status to “Shipped” and sets the “FFL Received” flag if applicable.
Note: Partial shipments are not supported—only fully shipped orders can be synced.

Operation Workflow
Here’s how orders are fetched and synced:
- Fetching Orders: You can fetch orders using DMX-Core (V1) or Fixpoint API (V2). DMX-Core (V1) didn’t include FFL information, which caused errors like “Cannot be marked Item Shipped until it has also been marked FFL Received.” Fixpoint API (V2) now includes FFL details to avoid this issue.
- FFL Support: Flxpoint now supports FFL information when fetching orders from DMX-Core (V1), ensuring orders needing FFL are handled correctly.
- Shipment Sync: A shipment can only be synced when the entire order is shipped. Partial shipments are not supported.
- Run PUT Request: To update an order’s status to “Shipped,” Flxpoint sends a PUT request to: https://api.gunbroker.com/v1/Orders/{orderID}/Flags with the “FFL Received” flag set to true in the body.

Configuration Options
Customize how orders are synced with these settings:
- Automatically Synchronize Order Data: Toggle this on to enable automatic order syncing with GunBroker.
- Additional Settings: Currently, there are no extra settings to configure, but you can toggle the main sync option as needed.

Setup Instructions
Follow these steps to set up the Sync Orders integration:
1. Enable Sync Orders: Go to the GunBroker channel settings, find “Sync Orders,” and toggle on “Automatically synchronize order data with your sales channel.”
2. Run the Integration: Orders will now sync automatically. You can also manually sync by using the “Run Sync” option or schedule it via “Adjust Schedule.”

Mapping Template Details
The mapping template ensures your order data from Flxpoint aligns with GunBroker’s fields. Here’s what you can map:
- Carrier: Maps to “GunBroker Fulfillment: Carrier Name” (e.g., FedEx, UPS).
- Tracking Number: Maps to “GunBroker Fulfillment: Tracking Number” (e.g., 123456789).
You can enable or disable these fields to control what data is sent to GunBroker.

Troubleshooting
If you run into issues:
- FFL Error: If you see “Cannot be marked Item Shipped until it has also been marked FFL Received,” ensure the FFL status is updated. Use Fixpoint API (V2) for fetching, as it includes FFL details.
- Partial Shipments Not Syncing: Only fully shipped orders can be synced. Ensure the entire order is shipped before syncing.
- Sync Not Working: Check if the “Automatically synchronize order data” toggle is enabled. Also, verify your GunBroker connection settings.
- Review Logs: Check “View Logs” in Flxpoint for specific error messages if syncing fails.
- Contact Support: Reach out to Flxpoint or GunBroker support for help if needed.

Conclusion
With the Sync Orders integration set up, your GunBroker orders will seamlessly sync with Flxpoint, keeping your order statuses and shipment details updated. Manage everything easily from the GunBroker channel settings in Flxpoint!

 

 

AI Category Mapping

Flxpoint offers a direct integration with GunBroker, allowing you to list and update firearm-related products automatically. A unique feature for GunBroker is the AI Category Mapping tool, which automates category assignments for your products, eliminating manual file uploads or time-consuming category matching. While this tool assigns categories automatically, it does not populate specific product details such as Manufacturer, Model, or Caliber.



Enabling GunBroker Integration

  1. Navigate to Connections in the left-hand panel.
  2. Select the Sales Channel you wish to configure (For AI Category, select Gun Broker).
  3. Go to the Settings tab.
  4. Scroll to the Categories Mapping section.

Here, you can configure both your listing preferences and category mapping preferences.

Image 1

Important Note: When using AI Category Mapping with GunBroker, ensure that your category mapping is set to Cat 1. The AI tool is configured to use Cat 1 for mapping, and configuring any other category (e.g., Cat 2 or Cat 3) may lead to publishing errors.

 

 

 


AI Category Mapping: Key Details

  • Exclusive to GunBroker: You will not see the AI option in other channels.
  • Overrides Manual Sets: Once enabled, any manually uploaded mapping sets are superseded by the AI tool.
  • Switching Back: If you revert to manual mapping, your previous files remain intact and will resume mapping upon saving.
  • What AI Category Mapping Does: The AI Category Mapping tool automates the assignment of categories for your GunBroker listings, saving you from manual file uploads. However, it does not auto-populate specific firearm details (e.g., Manufacturer, Model, Caliber, Barrel Length, Total Capacity). Those fields must be managed separately

AI vs. Manual Mapping:
If you’re already using standard/manual mapping sets effectively, keep doing so. If you’re new to GunBroker or want a clean slate, simply enable AI Category Mapping for a more automated approach.

Benefits of AI Category Mapping

  • Time Savings: No need to compile manual mapping files.
  • Automatic Updates: Whenever new categories or products appear, the AI system handles updates automatically.
  • Easy Reset: If you ever want to revert to manual mapping sets, you can switch back at any time.

 

How can I help?