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
📋 Phase 1: Initial Channel Setup+
Access Channels Section
Log into your Flxpoint account and navigate to the Channels section.
Create a New Channel
Under the Channels section, click on + Add Channel to begin creating a new channel for your GunBroker integration.
Tip: Having your GunBroker account credentials ready will make this process smoother.
Configure Channel Details
In the Add Channel popup:
Select GunBroker as your channel
Enter a channel name (e.g., "GunBroker Channel")
Click Continue to proceed
🔐 Phase 2: Channel Connection & Authentication+
Obtain Authentication Details
To get your GunBroker credentials, log into your GunBroker account:
Navigate to the Account Settings or API Access section (this may vary depending on GunBroker's dashboard layout).
Look for your account credentials or API access details.
Ensure you have your Username and Password ready.
Note the Environment (e.g., Production or Sandbox) available for selection.
Important: If you don’t have access to your credentials, contact GunBroker support at support@gunbroker.com or through their support portal to request assistance.
Enter Authentication Details
In the authentication popup, enter the details for your GunBroker account:
Username: Enter your GunBroker account username
Password: Enter your GunBroker account password
Environment: Select the environment (e.g., Production or Sandbox)
Click Continue to authenticate your GunBroker account.
🔄 Phase 3: Configuration & Feature Setup+
Set Up SKU Mapping
Configure your SKU mapping for GunBroker listings:
Set the linking identifier for syncing (e.g., Flxpoint Listing: SKU to GunBroker Listing: SKU).
Pro Tip: Consider adding a prefix like "GB-" to your SKUs to easily identify GunBroker listings in your inventory.
Configure Additional Features
Set up the following features for your GunBroker integration:
Import Listings: Enable to import product listings from GunBroker. Map 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. Ensure the SKU mapping is correctly set.
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.
Complete Setup
Review all your settings and click Continue to finalize your GunBroker channel setup. You should see a confirmation message: “Success! Your connection to GunBroker was created successfully and your selected operations have been configured.”
Next Steps: After completing the setup, your GunBroker channel will begin syncing with Flxpoint. You can manage your listings, orders, and shipments from the Channels > GunBroker section, where you’ll see the status as Active with options to Run Sync, View Logs, Adjust Schedule, or Edit Integration Settings.
×
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
Welcome to the GunBroker Publish Listings integration guide! This integration allows you to create and publish product listings to GunBroker from Flxpoint, ensuring your products are ready for sale. With automated data mapping and category assignments, you’ll save time and reduce errors. Let’s get started!
The GunBroker Publish Listings integration enables you to:
Create or update listings with details like price, quantity, and shipping options.
Ensure compliance with GunBroker’s requirements (e.g., titles ≤ 75 characters).
Automate publishing to streamline selling on GunBroker.
This integration saves time by syncing your Flxpoint catalog directly to GunBroker, reducing manual errors.
The integration follows these steps:
1Initiation: Flxpoint retrieves products ready to publish from your catalog.
2Mapping: Maps product data (e.g., SKU "GB12345", title "Smith & Wesson M&P 9mm") to GunBroker fields.
3Validation: Ensures data meets GunBroker’s rules (e.g., title ≤ 75 characters, valid category ID).
4Publishing: Sends listings to GunBroker via API, creating or updating them.
5Confirmation: Updates Flxpoint with listing status (e.g., “Active”).
6Syncing: Optionally syncs updates like price ($599.99) or quantity (5) via Run Sync or schedule.
Pro Tip: Authenticate with your GunBroker username and password and configure categories before publishing to avoid errors.
Customize your publishing with these settings:
Enable Publish Listings: Toggle to create and publish listings.
Auto Re-list When Back in Stock: Re-list products when restocked.
Listing Duration: Set duration (e.g., 30 days).
Shipping Classes: Select options like Overnight, FirstClass.
Payment Methods: Choose PayPal, AMEX, etc.
Country Code and Postal Code: Specify seller’s country (e.g., “US”) and postal code (e.g., “12345”).
Sales Tax and State Code Taxes: Enable sales tax and set state rates (e.g., FL: 7%).
Auto Relist: Choose “Do Not Relist” or “Relist Until Sold.”
Category Mapping: Use manual mapping or AI Category Mapping for GunBroker categories.
Mapping Template: Enable/disable fields (e.g., Quantity). A safety rule sets quantity to 0 if cost or price is missing.
Note: Use AI Category Mapping for automated category assignments if you’re new to GunBroker.
Follow these steps to configure the integration:
1Enable Publish Listings: Toggle Publish Listings on in GunBroker settings.
2Configure Basic Settings:
Auto Re-list When Back in Stock: Enable for automatic re-listing.
Listing Duration: Set to 30 days.
Shipping Classes: Check Overnight, FirstClass, etc.
Payment Methods: Select PayPal, AMEX, etc.
Who Pays for Shipping: Choose “Seller pays.”
Country Code: Enter “US.”
Postal Code: Enter “12345.”
Sales Tax: Enable if collecting tax.
Auto Relist: Set to “Do Not Relist.”
Trim Title: Set to “Yes” for ≤ 75 characters.
Replace Repeated Word: Set to “No.”
3Configure Advanced Settings:
Default Shipping Profile ID: Enter GunBroker profile ID (optional).
Auto Relist: Set to “No” (hard-coded to 1).
Inspection Period: Set to “AS IS.”
Standard Text ID: Enter terms of sale ID.
Shipping Costs: Set costs for each class.
State Code Taxes: Enter rates (e.g., [{"State":"FL", "TaxRate":"7"}]).
Use Tax Calculation: Enable for GunBroker’s tax system.
Required Fields: SKU, Title, CategoryID, Quantity are mandatory.
Quantity Mapping Requirement
The Quantity field must be mapped to avoid publishing errors, such as a NullPointerException (NPE).
Required Field: Quantity is mandatory for publishing.
Error Scenario: If Quantity is unmapped, publishing may fail:
Cannot invoke "java.lang.Integer.intValue()" because the return value of "GunbrokerProductDto.getQuantity()" is null
Fix: Go to Sales Channel > GunBroker > Templates > Publish Listings > Field Mapping, map Quantity, save, and re-run publishing.
Recommendation: Always map Quantity, SKU, Title, and CategoryID for stable publishing.
Available Fields
Category Fields: Category1, Category2, Category3.
Product Details: Auto Relist, Description, Images, List Price, Quantity, Requires FFL, SKU, Title, UPC, Weight.
Complete Field Mappings
Flxpoint Field
Maps To
Example
Purpose
Status
SKU
GunBroker Variant - SKU
GB12345
Identifies product
Required
Title
GunBroker Variant - Title
Smith & Wesson M&P 9mm
Displays product name
Required
List Price
GunBroker Variant - Fixed Price
$599.99
Sets price
Enabled
Quantity
GunBroker Variant - Quantity
5
Sets available units
Required
Category1
GunBroker Variant - CategoryID
12345 (Firearms)
Sets category
Required
Auto Relist
GunBroker Variant - Auto Relist
1 (Do Not Relist)
Controls relisting
Enabled
Safety Rule
Default Rule: Sets Quantity to 0 if Cost or List Price is 0 or missing.
Practice Mapping
Try enabling/disabling Quantity:
Troubleshoot issues with these steps:
Category Not Configured: Use manual mapping (GunBroker Category IDs) or AI Category Mapping (Cat 1 only).
Quantity Not Publishing:
Ensure Quantity is mapped in the template.
Check cost/price data to avoid quantity = 0.
Unmapped Quantity may cause:
Cannot invoke "java.lang.Integer.intValue()" because the return value of "GunbrokerProductDto.getQuantity()" is null
Fix: Go to Sales Channel > GunBroker > Templates > Publish Listings > Field Mapping, map Quantity, save, and re-run publishing.
Title Too Long: Ensure titles are ≤ 75 characters or enable “Trim Title.”
Missing Required Fields: Map SKU, Title, CategoryID, and Quantity.
Shipping Costs Missing: Set costs for selected shipping classes.
Auto Relist Issue: Set to “No” due to hard-coded value (1).
Can Offer Removed: Adjust syncing settings to preserve Can Offer.
Review Logs: Check “View Logs” for errors.
Contact Support: Reach out to Flxpoint or GunBroker with error details.
Diagnostic Tip: NPE errors often stem from unmapped Quantity fields.
Key information:
Date: As of 08:16 PM -04, May 22, 2025, this integration is operational.
Categories: Must be configured manually or via AI (Cat 1).
Quantity: Must be mapped to avoid NPE errors.
Auto Relist: Hard-coded to “No” (1).
Pro Tip: Use AI Category Mapping for a faster setup, but verify Cat 1 mapping.
Conclusion
The GunBroker Publish Listings integration streamlines publishing, keeping your listings accurate and ready for sales. Manage everything from Flxpoint for a seamless experience. Happy selling!
Sync & link Listings
Supported | GunBroker - Sync & Link Listings
Introduction to GunBroker Sync & Link Listings Integration
Welcome to the GunBroker Sync & Link Listings integration guide! This integration keeps your Flxpoint listings in sync with GunBroker by automatically updating pricing and quantity data. It also links listings using identifiers like SKU, UPC, or GTIN, ensuring seamless inventory management. Let’s dive into the setup process with clear steps, examples, and tips!
The GunBroker Sync & Link Listings integration connects Flxpoint to GunBroker to:
Automatically sync pricing and quantity updates for consistency.
Link Flxpoint listings to GunBroker using SKU, UPC, or GTIN.
Support pausing, unpausing, or delisting listings from Flxpoint.
This reduces overselling and pricing errors, streamlining inventory management.
The integration follows these steps:
1Initiation: Flxpoint retrieves active GunBroker listings and compares them to Flxpoint listings.
2Linking: Matches listings using the selected identifier (e.g., SKU "GB12345").
3Syncing: Updates pricing (e.g., $599.99) and quantity (e.g., 5) on GunBroker.
4Status Updates: Pauses, unpauses, or delists listings based on stock status.
5Confirmation: Assigns a new ItemID to linked listings in Flxpoint.
6Execution: Runs via Run Sync or on a schedule.
Pro Tip: Use SKU for the fastest linking. UPC or GTIN may take longer.
Customize your sync with these settings:
Enable Sync Listings: Toggle to sync pricing and quantity.
Linking Identifier: Choose SKU (e.g., "GB12345"), UPC, or GTIN. SKU is recommended.
Listing Type: Select Any, Fixed Price, or Auction. Default is Any.
Mapping Template: Enable/disable fields like Quantity. A safety rule sets quantity to 0 if cost or price is missing.
Actions: Pause, unpause, or delist listings from Flxpoint.
Note: Use Fixed Price for simpler syncing if you don’t use Auctions.
Follow these steps:
1Enable Sync Listings: Toggle Sync Listings on in GunBroker settings.
2Configure Linking Identifier: Choose SKU, UPC, or GTIN. SKU is default.
3Configure Listing Type: Select Any, Fixed Price, or Auction.
4Create a Mapping Template: Use Manage Mapping to define fields, ensuring Quantity is mapped.
5Run the Integration: Start with Run Sync or schedule it.
6Manage Listings: Use Actions to pause, unpause, or delist listings.
Mapping templates control which data fields sync between Flxpoint and GunBroker, allowing precise customization.
Mapping Options: Don’t Map, Set To Empty, Field, Value, Mapping Set.
Mapping Options
Don’t Map: Ignore the field (e.g., skip Auto Accept Price).
Set To Empty: Clear the field’s value on GunBroker.
Field: Map to a Flxpoint field (e.g., Quantity to Listing Variant - Quantity).
Value: Set a static value (e.g., Can Offer to “True”).
Mapping Set: Apply a predefined mapping configuration.
Required Fields: SKU and Quantity are mandatory to avoid errors.
Quantity Mapping Requirement
The Quantity field must be mapped to avoid sync failures, such as a NullPointerException (NPE).
Required Field: Quantity is mandatory for syncing.
Error Scenario: If Quantity is set to Don’t Map and the product is not Delisted, sync may fail:
Cannot invoke "java.lang.Integer.intValue()" because the return value of "GunbrokerProductDto.getQuantity()" is null
Delisted Exception: If Quantity is unmapped but the product is Delisted, delisting proceeds.
Price Dependency: Mapping Price alone is insufficient; Quantity is required.
Recommendation: Always map both Price and Quantity for stable syncing.
Available Source Fields
Listing Parent:
Parent SKU (Text)
Listing Variant:
Custom Aggregate Field (Key/Value)
Estimated Cost (Numeric)
Estimated Dropship Fee (Numeric)
Estimated Shipping Cost (Numeric)
List Price (Numeric)
MAP (Numeric)
MSRP (Numeric)
Quantity (Numeric)
SKU (Text)
GunBroker Variant Fields
GunBroker Field
Description
Example Mapping
Status
Auto Accept Price
Price to auto-accept offers
List Price ($599.99)
Optional
Auto Reject Price
Price to auto-reject offers
MAP ($499.99)
Optional
Can Offer
Allow offers on listing
Value (True)
Optional
Fixed Price
Sale price for Fixed Price listings
List Price ($599.99)
Enabled
Quantity
Available units
Quantity (5)
Required
SKU
Unique identifier
SKU (GB12345)
Required
Short-Term Auction
Starting bid for short-term auctions
List Price ($500)
Optional
Standard Auction
Starting bid for standard auctions
List Price ($500)
Optional
Rules Engine
New Rule: Create custom rules (e.g., "Set quantity to 0 if Cost or List Price = 0").
Test Rules: Simulate rules to verify behavior.
View All Rules: Review existing rules.
Example Rule: Sets Quantity to 0 if Cost or List Price is 0 or missing, preventing incorrect pricing.
Example: Map Quantity to Listing Variant - Quantity and enable the rule "Set quantity to 0 if Cost or List Price = 0" to ensure safe syncing.
Complete Field Mappings
Flxpoint Field
Maps To
Example
Purpose
Status
SKU
GunBroker Variant - SKU
GB12345
Links listings
Required
List Price
GunBroker Variant - Fixed Price
$599.99
Updates price
Enabled
Quantity
GunBroker Variant - Quantity
5
Updates quantity
Required
Safety Rule
Default Rule: Sets Quantity to 0 if Cost or List Price is 0 or missing.
Practice Mapping
Try enabling/disabling Quantity:
Be aware of these limitations:
Hiding Listings: Not supported.
Delisting: Supported for Fixed Price listings only.
Inventory Tracking Configs: Not synced.
Custom Fields: Not synced.
POS for Auction Listings: Not supported.
Troubleshoot issues with these steps:
Linking Fails: Ensure identifiers match. SKU is fastest.
Quantity Not Updating:
Verify Quantity is mapped to Listing Variant - Quantity.
Check cost/price data to avoid quantity = 0.
Unmapped Quantity may cause:
Cannot invoke "java.lang.Integer.intValue()" because the return value of "GunbrokerProductDto.getQuantity()" is null
Fix: Go to Sales Channel > GunBroker > Templates > Sync Listings > Field Mapping, map Quantity and Price, save, and re-run sync.
Auction Listings Not Delisting: Delisting is for Fixed Price only.
Sync Not Running: Check schedule or run manually.
Review Logs: Check “View Logs” for errors.
Contact Support: Contact Flxpoint or GunBroker with error details.
Diagnostic Tip: NPE errors often stem from unmapped Quantity fields.
Key information:
Date: As of 08:13 PM -04, May 22, 2025, this integration is operational.
Identifier: SKU is recommended for linking.
Sync Actions: Pause/unpause/delist for Fixed Price only.
Quantity: Must be mapped to avoid NPE errors.
Pro Tip: Regularly check sync logs to catch issues early.
Conclusion
The GunBroker Sync & Link Listings integration ensures accurate pricing and quantity syncing, with easy listing management from Flxpoint. Happy syncing!
Import Listings
Supported | GunBroker - Import Listings
Introduction to GunBroker Import Listings Integration
Welcome to the GunBroker Import Listings integration guide! This integration lets you import your GunBroker product listings into Flxpoint, simplifying inventory management across platforms. With options to pause imports or update existing products, you’ll have full control. Let’s dive in!
The GunBroker Import Listings integration enables you to:
Import listings as new products or update existing ones in Flxpoint based on SKU matches.
Pause imported listings to prevent immediate syncing back to GunBroker.
Handle both auction and fixed-price listings from GunBroker.
This centralizes your GunBroker inventory in Flxpoint, streamlining management.
The integration follows these steps:
1Initiation: Flxpoint connects to GunBroker’s API (https://api.gunbroker.com/v1/items).
2Data Retrieval: Retrieves all active listings (auction and fixed-price).
3Processing: Imports listings based on settings (e.g., create or update products).
4SKU Mapping: Links listings using “GunBroker Variant - SKU” as Master SKU (e.g., “GB12345”).
5Pausing (Optional): Sets imported listings to “Paused” if enabled.
6Execution: Runs via Run Sync or schedule.
Pro Tip: Enable “Set New Listings to Paused” to review imported listings before syncing.
Customize your import with these settings:
Enable Import Listings: Toggle to import listings.
Product & Listing Management:
Create new products only: Imports listings as new if no SKU match.
Create products only: Creates new products without linking.
Create and update products & listings: Updates or creates based on SKU.
Master SKU: Use “GunBroker Variant - SKU” for linking.
Set New Listings to Paused: Pause imports to prevent syncing.
Note: Choose “Create and update products & listings” for seamless inventory updates.
Follow these steps:
1Enable Import Listings: Toggle Import Listings on in GunBroker settings.
2Configure Product & Listing Management:
Create new products only: For new listings without matches.
Create products only: For new products without linking.
Create and update products & listings: Recommended for most users.
The Quantity field must be correctly imported to avoid errors, such as a NullPointerException (NPE).
Required Field: Quantity is critical for inventory accuracy.
Error Scenario: If Quantity is missing or mismapped, imports may fail:
Cannot invoke "java.lang.Integer.intValue()" because the return value of "GunbrokerProductDto.getQuantity()" is null
Fix: Verify GunBroker listings have valid Quantity data and ensure “GunBroker Variant - Quantity” is mapped correctly in Flxpoint.
Recommendation: Check Quantity data in GunBroker before importing to ensure accuracy.
Practice Configuration
Try enabling/disabling “Set New Listings to Paused”:
Be aware of these limitations:
Custom Fields: Not imported.
Variations/Options: Not supported.
Client Pricing & Currency: Only USD prices imported.
Multiple Warehouses: Single quantity value only.
Weights & Dimensions: Not imported.
Troubleshoot issues with these steps:
Import Fails: Verify GunBroker authentication in channel settings.
SKU Not Matching: Ensure “GunBroker Variant - SKU” is mapped to Master SKU.
Quantity Not Importing:
Check Quantity data in GunBroker listings.
Missing Quantity may cause:
Cannot invoke "java.lang.Integer.intValue()" because the return value of "GunbrokerProductDto.getQuantity()" is null
Fix: Ensure valid Quantity data in GunBroker and correct mapping in Flxpoint.
Listings Not Paused: Verify “Set New Listings to Paused” setting and check logs.
Missing Data: Only thumbnail URLs and specific fields are imported.
Sync Not Running: Check schedule or run manually.
Review Logs: Check “View Logs” for errors.
Contact Support: Reach out to Flxpoint or GunBroker with error details.
Diagnostic Tip: NPE errors often stem from missing Quantity data in GunBroker listings.
Key information:
Date: As of 08:28 PM -04, May 22, 2025, this integration is operational.
SKU Mapping: Use “GunBroker Variant - SKU” as Master SKU.
Quantity: Must be valid to avoid NPE errors.
Pausing: Enable “Set New Listings to Paused” for control.
Pro Tip: Regularly review import logs to ensure all data, especially Quantity, is correct.
Conclusion
The GunBroker Import Listings integration centralizes your inventory in Flxpoint, with flexible options to pause or update listings. Manage your GunBroker products seamlessly and keep your catalog in sync. Happy importing!
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
Welcome to the GunBroker Get Orders integration guide! This integration imports orders from GunBroker into Flxpoint, centralizing your order data for efficient management and fulfillment. With customizable filters and mapping, you’ll streamline your workflow. Let’s get started!
The GunBroker Get Orders integration enables you to:
Import orders based on status, FFL requirements, and time frame.
Include details like billing/shipping addresses, line items, and totals.
Map order data to Flxpoint fields for seamless integration.
This streamlines order processing by centralizing GunBroker orders in Flxpoint.
The integration follows these steps:
1Initiation: Flxpoint fetches orders in batches of 250 using filters (e.g., Pending Seller Review).
2Data Retrieval: Uses endpoints like /Orders/{orderID} for shipping, /Items/{itemID} for SKUs, and /FFLs/{license} for FFL data.
3Filtering: Imports orders based on Order Status, FFL Status, and Time Frame (e.g., CreatedLastWeek).
4Mapping: Maps data to Flxpoint fields (e.g., SKU "GB12345", quantity "5").
5Processing: Saves orders in Flxpoint with updated statuses.
6Execution: Runs via Run Sync or schedule.
Pro Tip: Set specific Order Status and Time Frame filters to import only relevant orders.
Customize your import with these settings:
Enable Get Orders: Toggle to import orders.
FFL Status:
All: Imports all orders.
Awaiting FFL: Orders needing FFL input.
FFL Received: Orders with FFL provided.
FFL Not Required: Orders without FFL.
Order Status: Select statuses (e.g., Pending Seller Review).
Time Frame: Set order age (e.g., CreatedLastWeek).
Required Fields: Order - Ordered On, Order Line Item - SKU, Quantity.
Quantity Mapping Requirement
The Order Line Item - Quantity field must be mapped to avoid import errors, such as a NullPointerException (NPE).
Required Field: Quantity is mandatory for order accuracy.
Error Scenario: If Quantity is unmapped, imports may fail:
Cannot invoke "java.lang.Integer.intValue()" because the return value of "GunbrokerProductDto.getQuantity()" is null
Fix: Go to Sales Channel > GunBroker > Templates > Get Orders > Field Mapping, map Order Line Item - Quantity, save, and re-run import.
Recommendation: Always map Quantity, SKU, and Order Date for stable order imports.
Available Fields
Order Line Item: Item Price, Quantity, SKU, Item Subtotal, Title, 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, Total Price, Shipping Cost, Sales Tax Total, Miscellaneous Charge, Order Date, Shipping Method.
Complete Field Mappings
GunBroker Field
Maps To
Example
Purpose
Status
SKU
Order Line Item - SKU
GB12345
Identifies product
Required
Quantity
Order Line Item - Quantity
5
Sets ordered units
Required
Item Price
Order Line Item - Cost
$599.99
Records item cost
Enabled
Bill Name
Billing Address - Full Name
John Doe
Identifies buyer
Enabled
Address 1
Shipping Address - Address Line 1
123 Main St
Ensures delivery
Enabled
Total Price
Order - Order Total
$625.99
Records total cost
Enabled
Practice Mapping
Try enabling/disabling Order Line Item - Quantity:
Be aware of these limitations:
Order Acknowledgement: Not supported.
Custom Fields: Not imported.
Line Items/Donations: Donations not imported.
Weight & Dimensions: Not imported.
Currency: Only USD supported.
Troubleshoot issues with these steps:
Orders Not Importing: Verify GunBroker authentication.
Missing Orders: Check Order Status, FFL Status, and Time Frame filters.
Quantity Not Importing:
Ensure Order Line Item - Quantity is mapped.
Unmapped Quantity may cause:
Cannot invoke "java.lang.Integer.intValue()" because the return value of "GunbrokerProductDto.getQuantity()" is null
Fix: Go to Sales Channel > GunBroker > Templates > Get Orders > Field Mapping, map Quantity, save, and re-run import.
FFL Data Missing: Select correct FFL Status (e.g., FFL Received).
Sync Not Running: Check schedule or run manually.
Review Logs: Check “View Logs” for errors.
Contact Support: Reach out to Flxpoint or GunBroker with error details.
Diagnostic Tip: NPE errors often stem from unmapped Quantity fields.
Key information:
Date: As of 08:32 PM -04, May 22, 2025, this integration is operational.
Quantity: Must be mapped to avoid NPE errors.
FFL Status: Filter orders by FFL requirements.
Status Updates: Handled in Flxpoint backend.
Pro Tip: Regularly check import logs to ensure all order data, especially Quantity, is correct.
Conclusion
The GunBroker Get Orders integration centralizes your orders in Flxpoint, with flexible filters and mapping for efficient fulfillment. Customize your imports to fit your workflow and keep your order data in sync. Happy fulfilling!
Sync Orders
Supported | GunBroker - Sync Orders
Introduction to GunBroker Sync Orders Integration
Welcome to the GunBroker Sync Orders integration guide! This integration automatically fetches and updates GunBroker orders in Flxpoint, streamlining your order management. With support for FFL requirements and shipment details, you’ll keep everything in sync effortlessly. Let’s dive in!
The GunBroker Sync Orders integration enables you to:
Fetch and update order statuses (e.g., from “Shipped” to “Delivered”).
Sync shipping details like carrier (e.g., FedEx) and tracking number (e.g., 123456789).
Ensure accurate FFL status updates (e.g., “FFL Received”).
This saves time and keeps your GunBroker orders aligned with Flxpoint.
The integration follows these steps:
1Fetch Orders: Flxpoint retrieves orders using DMX-Core (V1) or Fixpoint API (V2).
2Check FFL Status: Ensures “FFL Received” for orders requiring FFL before marking as “Shipped.”
3Sync Shipment Details: Updates GunBroker with carrier and tracking number when shipped.
4Update Order Status: Sends a PUT request to https://api.gunbroker.com/v1/Orders/{orderID}/Flags to set “Shipped” and “FFL Received.”
Pro Tip: Use Fixpoint API (V2) for reliable FFL data to avoid sync errors.
Here’s how the sync process works:
Fetching Orders: Uses DMX-Core (V1) or Fixpoint API (V2). V2 includes FFL details, avoiding errors like “Cannot be marked Item Shipped until FFL Received.”
FFL Support: Ensures FFL data is included, even with DMX-Core (V1).
Shipment Sync: Only fully shipped orders sync; partial shipments are not supported.
PUT Request: Updates status via https://api.gunbroker.com/v1/Orders/{orderID}/Flags with “FFL Received” set to true.
Note: Ensure all items in an order are shipped before syncing to avoid errors.
Customize your sync with these settings:
Automatically Synchronize Order Data: Toggle to enable automatic syncing.
Additional Settings: No extra settings currently, but toggle controls sync.
Note: Enable automatic syncing for real-time order updates.
Follow these steps:
1Enable Sync Orders: Toggle “Automatically synchronize order data” on in GunBroker settings.
2Run the Integration: Sync automatically or use Run Sync or schedule.
Mapping templates align Flxpoint order data with GunBroker fields.
Interface Overview
Screen labeled “Flxpoint → GunBroker” under Sync Orders.
Disable: Ignore the field (e.g., Tracking Number).
Required Fields: Carrier, Tracking Number for shipped orders.
Quantity Sync Requirement
The Order Line Item - Quantity field must be correctly handled to avoid sync errors, such as a NullPointerException (NPE).
Critical Data: Quantity ensures accurate order fulfillment.
Error Scenario: If Quantity is missing or mismapped, syncing may fail:
Cannot invoke "java.lang.Integer.intValue()" because the return value of "GunbrokerProductDto.getQuantity()" is null
Fix: Verify Quantity data in Flxpoint orders and ensure correct mapping in the Get Orders template (Sales Channel > GunBroker > Templates > Get Orders > Field Mapping).
Recommendation: Ensure Quantity is mapped in the Get Orders template before syncing to avoid errors.
Available Fields
Carrier: Maps to “GunBroker Fulfillment: Carrier Name.”
Tracking Number: Maps to “GunBroker Fulfillment: Tracking Number.”
Complete Field Mappings
Flxpoint Field
Maps To
Example
Purpose
Status
Carrier
GunBroker Fulfillment: Carrier Name
FedEx
Specifies shipping carrier
Required
Tracking Number
GunBroker Fulfillment: Tracking Number
123456789
Tracks shipment
Required
Practice Configuration
Try enabling/disabling “Automatically Synchronize Order Data”:
Troubleshoot issues with these steps:
FFL Error: If “Cannot be marked Item Shipped until FFL Received” appears, use Fixpoint API (V2) and ensure FFL status is updated.
Quantity Sync Issues:
Verify Quantity data in Flxpoint orders.
Missing Quantity may cause:
Cannot invoke "java.lang.Integer.intValue()" because the return value of "GunbrokerProductDto.getQuantity()" is null
Fix: Check Get Orders template mapping (Sales Channel > GunBroker > Templates > Get Orders > Field Mapping) and ensure Quantity is mapped.
Partial Shipments Not Syncing: Ensure all items are shipped, as partial shipments are not supported.
Sync Not Working: Verify “Automatically synchronize order data” is enabled and check GunBroker connection.
Review Logs: Check “View Logs” for error messages.
Contact Support: Reach out to Flxpoint or GunBroker with error details.
Diagnostic Tip: FFL and Quantity errors are common causes of sync failures; verify both before syncing.
Key information:
Date: As of 08:37 PM -04, May 22, 2025, this integration is operational.
Quantity: Must be valid in Get Orders mapping to avoid NPE errors.
FFL: Use Fixpoint API (V2) for accurate FFL data.
Shipments: Only full shipments sync.
Pro Tip: Regularly check sync logs to catch FFL or Quantity issues early.
Conclusion
The GunBroker Sync Orders integration keeps your orders updated in Flxpoint, with seamless FFL and shipment syncing. Manage everything from GunBroker channel settings for a smooth workflow. Happy syncing!
AI Category Mapping
Within your GunBroker channel setup in Flxpoint, the AI Category Mapping feature automates category assignments for listings, removing the need for manual file uploads. Exclusive to GunBroker, this AI tool maps products to correct categories, improving listing efficiency.
This feature:
Automates category assignments for GunBroker listings.
Eliminates manual file uploads, saving time.
Handles new categories or products automatically.
Example: A product titled "Smith & Wesson M&P Pistol" is mapped to the "Handguns" category without manual input.
The AI Category Mapping process:
Enable AI Mapping: In GunBroker settings, enable AI to override manual mapping.
Analyze Products: AI uses product data (titles, descriptions) to determine categories.
Assign Categories: Categories are set automatically; details like Manufacturer or Caliber need separate mapping.
Update Listings: New or updated products are mapped to correct categories.
Switch Back: Revert to manual mapping without losing prior configurations.
Tip: Use detailed titles (e.g., "Smith & Wesson M&P 9mm Pistol") for better AI mapping.
After adding GunBroker as a sales channel in Flxpoint:
Go to Connections in the left-hand panel.
Select the GunBroker sales channel.
In the Settings tab, find Categories Mapping.
Enable the AI Category Mapping option.
Note: Set mapping to Cat 1 to avoid publishing errors.
GunBroker Only: AI Category Mapping is exclusive to GunBroker.
Overrides Manual Sets: AI takes precedence over manual mappings when enabled.
Switching Back: Revert to manual mapping without losing prior files.
Limited Scope: AI maps categories but not details like Manufacturer or Caliber.
Time Savings: No manual mapping files needed, saving hours.
Automatic Updates: AI manages new categories or products.
Easy Reset: Switch to manual mapping without losing configurations.
AI Category Mapping Interface
Setup Video
Note: If the video does not load, verify the Canva embed link or use a direct video file.
Current Date and Time: As of 09:07 PM -04 on Thursday, May 22, 2025, this feature is operational within the GunBroker channel.
GunBroker Exclusive: AI Category Mapping is specific to GunBroker.
Category Focus: Automates categories, not details like Manufacturer or Caliber.
Flexibility: Switch between AI and manual mapping without losing configurations.
Tip: Review listings to ensure AI-assigned categories are correct, especially for new products.
Conclusion
The AI Category Mapping feature in your GunBroker channel setup automates category assignments, saving time and ensuring accurate listings. Switch between AI and manual mapping as needed, with automatic updates for new products. Start listing efficiently!
