GunBroker as a Channel

Table of Contents

How to connect Listing Operations Order Operations

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

📋 Phase 1: Initial Channel Setup +

Access Sales Channels

Log into your Flxpoint account and navigate to the Sales Channels section.

Create a New Channel

Under the Sales Channels section, click on Create Channel (or 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 Integration Type

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 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.

Set Up GunBroker Connection

On the Connect Channel screen, set up a new GunBroker connection:

Connection Name: Enter a descriptive name (e.g., "GunBroker Connection #3")

Environment: Select the environment (e.g., Production or Sandbox)

Username: Enter your GunBroker account username

Password: Enter your GunBroker account password

Click Test Connection & Continue to verify the setup.

🔄 Phase 3: Configuration & Feature Setup +

Enable Desired Processes

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

Configure Import Listings Settings

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.

Pro Tip: Pausing new listings can help you review and link inventory before they go live, ensuring accuracy.

Configure Get Orders Settings

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).

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.

✅ Phase 4: Finalize and Manage Channel +

Start Channel Operations

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.

Manage Your GunBroker Channel

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

Next Steps: Monitor the initial sync progress in the Sales Channels section. You can adjust settings or enable additional operations as needed to optimize your GunBroker integration.

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

Supported | GunBroker - Import Listings

Introduction to GunBroker Import Listings Integration

Welcome to the GunBroker Import Listings integration guide for Fixpoint! This integration simplifies bringing your GunBroker listings into Fixpoint for centralized inventory management. Whether managing a small or large catalog, you’ll align categories, link listings, and prepare for seamless synchronization with ease. Let’s get started!

The GunBroker Import Listings integration enables you to:

Import GunBroker listings into Fixpoint for centralized management.
Align Fixpoint categories with GunBroker’s structure (e.g., “Ammo” to “Centerfire Handgun Rounds”).
Link listings to Fixpoint records using identifiers like SKU (e.g., “GB12345”).
Pause imported listings to prevent syncing until verified.

This ensures your Fixpoint inventory mirrors your GunBroker listings accurately.

The integration follows these steps:

1 Fetch Listings: Retrieves listings via https://api.gunbroker.com/v1/auction/fixedPrice/listing.
2 Add Attributes: Adds IsFixedPrice attribute for fixed price listings.
3 Import Data: Imports details like quantity (e.g., “5”), price (e.g., “$599.99”), and images.
4 Link Listings: Links by SKU or creates new records if no match.
5 Category Alignment: Maps GunBroker Category IDs to Fixpoint categories (e.g., “12345” to “Ammo”).
6 Paused Status Option: Sets listings to “Paused” if enabled.

Pro Tip: Enable “Paused” status to review imported listings before syncing.

Customize your import with these settings:

Paused Status: Set listings to “Paused” to prevent syncing until verified.
Master SKU: Select SKU, UPC, or MPN (e.g., SKU “GB12345”) as the primary identifier.
Product & Listing Management:
- Create new products and listings only.
- Create and update existing products and listings.
Category Mapping: Align Fixpoint categories with GunBroker IDs.
Advanced Mapping Rules: Modify data (e.g., split values) for alignment.

Note: Use SKU as Master SKU for reliable linking.

Follow these steps:

1 Add the Integration: In Integrations, select GunBroker and “Import Listings.”
2 Connect to GunBroker: Use existing or new API credentials.
3 Configure Settings: Enable “Paused” status, select Master SKU (e.g., SKU), choose management options, align categories.
4 Apply Advanced Mapping Rules (Optional): Set rules to modify data.
5 Run the Integration: Save to import listings.
6 Unpause Listings: Go to Products > Actions > Unpause Listings when ready.

The integration supports:

Quantity: Available quantity (e.g., “5”).
Images: Thumbnail URLs (e.g., “https://example.com/image.jpg”).
Categories: Cat1 (name, e.g., “Centerfire Handgun Rounds”), Cat2 (code, e.g., “12345”).
MPN: Manufacturer Part Number (e.g., “MPN123”).
Pricing: USD only (e.g., “$599.99”).

Quantity Import Requirement

The Quantity field must be correctly imported to avoid errors, such as a NullPointerException (NPE).

Required Field: Quantity ensures accurate inventory.
Error Scenario: If Quantity is missing, imports may fail:
Cannot invoke "java.lang.Integer.intValue()" because the return value of "GunbrokerProductDto.getQuantity()" is null
Fix: Verify Quantity data in GunBroker listings and ensure correct import settings.

Recommendation: Check Quantity data in GunBroker before importing.

Limitations

Custom Fields: Not imported.
Variants/Options: Not supported.
Client Pricing & Currency: Not supported; USD only.
Multiple Warehouses: Not supported.
Weights & Dimensions: Not imported.

Practice Configuration

Try enabling/disabling “Set New Listings to Paused”:

Troubleshoot issues with these steps:

Import Fails: Verify GunBroker API credentials and connection.
API Endpoint Issues: Ensure https://api.gunbroker.com/v1/ is accessible.
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 review import settings.
Category Misalignment: Verify category mappings between Fixpoint and GunBroker.
SKU Mismatches: Confirm Master SKU field matches data.
Contact Support: Reach out to Fixpoint or GunBroker support with error details.

Diagnostic Tip: Quantity and category issues are common; verify both before importing.

Key information:

Date: As of 08:53 PM -04, May 22, 2025, this integration is operational.
Master SKU: Use SKU for reliable linking.
Quantity: Must be valid to avoid NPE errors.
Categories: Align with GunBroker IDs for accuracy.

Pro Tip: Pause imports to verify Quantity and category data before syncing.

Conclusion

The GunBroker Import Listings integration seamlessly brings your listings into Fixpoint, enabling centralized inventory management. With category alignment, SKU linking, and pausing options, you’ll maintain control with minimal effort. Happy importing!

Sync & Link Listings

Supported | GunBroker - Sync & Link Listings

Introduction to GunBroker Sync & Link Listings Integration

Welcome to the GunBroker Sync & Link Listings integration guide for Fixpoint! This integration keeps your Fixpoint inventory in sync with GunBroker, ensuring accurate prices, stock levels, and categories. By linking listings with identifiers like SKU, UPC, or GTIN and managing zero-quantity scenarios, you’ll streamline your inventory management. Let’s dive into the setup and functionality!

The GunBroker Sync & Link Listings integration enables you to:

Sync price, quantity, and status (PQS) updates between Fixpoint and GunBroker.
Link Fixpoint listings to GunBroker using SKU, UPC, or GTIN (e.g., SKU “GB12345”).
Align Fixpoint categories with GunBroker’s structure (e.g., “Ammo” to “Centerfire Handgun Rounds”).
Automatically delist products when quantity reaches zero, with relisting options.

This ensures your GunBroker listings reflect your Fixpoint inventory accurately.

The integration follows these steps:

1 Retrieve Listings: Fetches active listings from Fixpoint.
2 Delist Unavailable Products: Marks unavailable products for delisting on GunBroker.
3 Update Item IDs: Assigns new item IDs for GunBroker listings not in Fixpoint.
4 Handle Quantity Changes: Updates item IDs when quantity is sold (e.g., quantity “5” to “0”).
5 Queue Updates: Queues price (e.g., “$599.99”) and quantity updates.
6 Sync Data: Sends updates via PUT requests to GunBroker.
7 Delist Out-of-Stock: Delists zero-quantity listings.
8 Link Listings: Links by SKU, UPC, or GTIN based on priority.

Pro Tip: Prioritize SKU for linking to ensure fast and reliable matching.

Customize your sync with these settings:

Linking Priority: Set order (e.g., SKU, UPC, GTIN) for matching listings.
Category Alignment: Map Fixpoint categories to GunBroker IDs (e.g., “12345” to “Ammo”).
Zero Quantity Handling: Delist products at zero quantity; relist by updating stock.
Listing Type: Sync all, Fixed Price, or Auction listings.
Scheduling: Run manually or schedule (e.g., daily at 6 AM UTC).
Mapping Template: Define field mappings for syncing.

Note: Schedule daily syncs for real-time inventory updates.

Follow these steps:

1 Add the Integration: In Integrations, select GunBroker and “Sync Listings.”
2 Connect to GunBroker: Use existing or new API credentials.
3 Configure Settings: Set linking priority, align categories, configure zero quantity handling, and enable scheduling.
4 Create a Mapping Template: Map fields like Quantity to GunBroker’s Inventory Level.
5 Run the Integration: Start manually or on schedule.

Hiding

Hiding products is not supported. Visibility is managed via delisting.

Delisting

Products are delisted at zero quantity. To relist:

Add stock in Fixpoint (e.g., quantity “5”).
Run sync to update GunBroker.
Listing is relisted with new quantity.

Mapping templates define how Fixpoint data syncs to GunBroker.

Interface Overview

Screen labeled “Mapping” with template, rule, and product builder options.
Buttons: Delete, Save.
Sections: From Value (Fixpoint fields), To GunBroker Variant Field.

Mapping Options

Don’t Map: Ignore the field.
Set To Empty: Clear the field.
Field: Map a Fixpoint field (e.g., Quantity).
Value: Set a constant value.
Mapping Set: Apply a predefined transformation.
Required Fields: SKU, Quantity for syncing.

Quantity Mapping Requirement

The Quantity field must be mapped in your Sync Listings template to avoid errors, such as a NullPointerException (NPE).

Required Field: Quantity is mandatory for syncing.
Error Scenario: If Quantity is not mapped 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 correctly.
Price Dependency: Mapping Price alone is insufficient; Quantity is required.
Fix: Go to Sales Channel > GunBroker > Templates > Sync Listings > Field Mapping, ensure Quantity and Price are mapped, save, and re-run the sync job.

Recommendation: Always map both Price and Quantity for stable sync behavior.

Available Source Fields

Listing Variant: Quantity, List Price, MAP, MSRP, Estimated Cost, Estimated Dropship Fee, Estimated Shipping Cost.

Complete Field Mappings

Fixpoint 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 inventory	Required
UPC	GunBroker Variant - UPC	012345678905	Alternate identifier	Optional
GTIN	GunBroker Variant - GTIN	012345678905	Alternate identifier	Optional

Practice Mapping

Try mapping the “Quantity” field:

Troubleshoot issues with these steps:

Connection Issues: Verify GunBroker API credentials and connection.
Linking Fails: Ensure linking priority (e.g., SKU) matches data in Fixpoint and GunBroker.
Quantity Sync Issues:
- Check if Quantity is mapped in the template.
- 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, ensure Quantity and Price are mapped, save, and re-run sync.
Category Misalignment: Verify category mappings (e.g., “Ammo” to “12345”).
Delisting Issues: Ensure zero-quantity handling is configured correctly.
Contact Support: Reach out to Fixpoint or GunBroker support with error details.

Diagnostic Tip: Quantity and linking errors are common; verify mappings and SKU data first.

Key information:

Date: As of 08:55 PM -04, May 22, 2025, this integration is operational.
Quantity: Must be mapped to avoid NPE errors.
Linking: Prioritize SKU for best results.
Delisting: Automatic at zero quantity; relist by adding stock.

Pro Tip: Regularly check sync logs to catch Quantity or linking issues early.

Conclusion

The GunBroker Sync & Link Listings integration ensures your Fixpoint inventory stays in sync with GunBroker, maintaining accurate prices, stock levels, and categories. With flexible linking, delisting, and mapping options, inventory management becomes seamless and efficient. Happy syncing!

Publish Listings

Supported | GunBroker - Publish Listings

Introduction to GunBroker Publish Listings Integration

Welcome to the GunBroker Publish Listings integration guide for Fixpoint! This integration enables you to create new product listings on GunBroker directly from Fixpoint, ensuring accurate category mapping, proper data alignment, and safeguards against incorrect pricing. Whether you’re listing ammunition or accessories, this guide will walk you through the setup with clear steps and examples. Let’s get started!

The GunBroker Publish Listings integration enables you to:

Create new product listings on GunBroker from Fixpoint.
Map product data to GunBroker fields using a mapping template.
Ensure accurate category mapping with numeric Category IDs (e.g., “3018” for Pistol Ammunition).
Prevent publishing listings with missing or zero cost/list price to avoid low pricing errors.

This streamlines listing creation, ensuring compliance with GunBroker’s requirements.

The integration follows these steps:

1 Category Mapping: Maps Fixpoint categories to GunBroker’s numeric Category IDs (e.g., “3018” for Pistol Ammunition).
2 Mapping Data: Maps fields like Title to Name, SKU to SKU (e.g., “AMMO-001”), with a rule setting quantity to 0 if cost or list price is missing.
3 Publishing Products: Publishes via POST request with parameters like ItemSKU=AMMO-001&SellerName=YourSellerName.
4 Handling Zero Quantity: Ends listings at quantity 0; republish by updating quantity (e.g., “5”) and syncing.
5 Running the Integration: Runs manually or on a schedule (e.g., daily).

             Pro Tip: Ensure SKUs match between Fixpoint and GunBroker to avoid duplicate listings.
          

GunBroker requires numeric Category IDs. Here’s a sample:

Category Path	Category ID
All > Air Guns > Air Gun Accessories	3052
All > Air Guns > Air Pistols	3049
All > Ammunition > Pistol Ammunition	3018
All > Ammunition > Reloading > Reloading Equipment	3015
All > Ammunition > Ammo Storage	3053

For the full list, see the Category ID spreadsheet.

Follow these steps to configure the integration:

1 Add the Integration: In Integrations, select GunBroker and “Publish Listings.”
2 Connect to GunBroker: Use existing or new API credentials.
3 Configure Settings: Set category mappings, create a mapping template, and configure scheduling (e.g., daily).
4 Run the Integration: Start manually or on schedule.

Watch the Setup Video

Custom Fields

Map custom fields as key/value pairs for GunBroker item characteristics.

Attributes / Tags

Map attributes as custom fields to associate with listings.

Variations / Options

GunBroker does not support variations; each variant is a separate listing.

Generic Pricing (& Currency)

Supports single price (USD); auction listings require starting price, with optional reserve/buy-now prices. Quantity is set to 0 if cost/list price is missing.

Quantity

Auction listings: quantity = 1. Fixed-price listings: any quantity (e.g., “5”). Listings end at quantity 0. A default rule sets quantity to 0 if cost or list price is 0 to prevent low pricing errors.

Multiple Warehouses

Not supported; quantities are aggregated as a single value.

Weights & Dimensions

Weight is optional; dimensions are not supported.

Images

Multiple images supported; use parent images if variant images are blank.

Fixpoint Field	Maps To	Example	Purpose	Status
Title	GunBroker - Name	9mm Pistol Ammunition	Listing name	Required
Parent SKU	GunBroker - SKU	AMMO-001	Identifies listing	Required
Category 1	GunBroker - Category	3018 (Pistol Ammunition)	Sets category	Required
Quantity	GunBroker - Quantity	5	Sets inventory	Required
List Price	GunBroker - Price	$29.99	Sets price	Enabled
Description	GunBroker - Description	50 rounds per box	Describes listing	Enabled
Image	GunBroker - Images	URL list	Adds images	Enabled
UPC	GunBroker - UPC	123456789012	Alternate identifier	Optional
Weight	GunBroker - Weight	2.5	Item characteristic	Optional

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

Supported | GunBroker - Get Orders

Introduction to GunBroker Get Orders Integration

Welcome to the GunBroker Get Orders integration guide for Fixpoint! This integration retrieves new orders from GunBroker that haven’t been imported into Fixpoint, including itemized details, shipping information, and customer data. With support for Federal Firearms License (FFL) handling and shipping policy mappings, it streamlines your order management process. Let’s dive into the setup and functionality!

The GunBroker Get Orders integration enables you to:

Import new orders with payment status, shipping details, and customer data (e.g., order ID “ORD123”).
Map GunBroker shipping methods (e.g., “Standard”) to Fixpoint shipping policies.
Handle FFL-compliant orders with additional checks.
Import orders in USD with itemized details (e.g., SKU “AMMO-001”, quantity “5”).

This ensures efficient order processing and fulfillment in Fixpoint.

The integration follows these steps:

1 Fetch Orders: Retrieves orders in batches of 250 via /orders.
2 Get Order Details: Fetches status, FFL status, and timestamps.
3 Retrieve Line Items: Gets SKUs and quantities via /items/{itemId}.
4 Fetch FFL Details: Retrieves FFL data via /ffls/{fflId} for compliant orders.
5 Multi-Status Handling: Processes statuses (e.g., Payment Pending) separately.
6 Iterate and Import: Imports orders based on selected statuses.

             Pro Tip: Select specific order statuses to import only relevant orders, reducing processing time.
          

Customize your import with these settings:

Order Status Selection: Choose statuses (e.g., Payment Pending, Awaiting Shipment).
Shipping Mappings: Map GunBroker methods (e.g., “Standard”) to Fixpoint policies.
FFL Handling: Enable FFL checks and set rules (e.g., flag “Rifles”).
PII Retention: Set periods (e.g., 30 days after shipment).
Time Frame: Fetch orders from a period (e.g., last 14 days).
Scheduling: Run manually or schedule (e.g., daily at 6 AM UTC).
Mapping Template: Map GunBroker fields to Fixpoint fields.

Note: Map shipping methods accurately to ensure proper fulfillment.

Follow these steps:

1 Add the Integration: In Integrations, select GunBroker and “Get Orders.”
2 Connect to GunBroker: Use existing or new API credentials.
3 Configure Settings: Select statuses, map shipping methods, set FFL rules, configure PII retention, and define time frame.
4 Create a Mapping Template: Map fields like Line Item - SKU to Fixpoint SKU.
5 Run the Integration: Start manually or schedule.

Map GunBroker’s “Shipping Text” field to Fixpoint shipping policies:

“Standard” to Fixpoint “Standard” policy.
“Priority” to Fixpoint “Priority” policy.

This ensures accurate shipping method alignment.

For FFL-compliant orders:

FFL Rules: Set rules in source settings (e.g., flag “Rifles”).
FFL Orders: Include FFL dealer info; “Needs Attention” orders require manual approval.

This ensures compliance with firearm regulations.

The integration supports:

Order & Payment Statuses: Saved in channel invoice section.
Order Acknowledgment: Not supported.
Order Receipt/Invoice & Currency: USD only.
Shipping Selection: Mapped in shipping management.
Custom Fields: Not supported.
PII Restrictions: Configurable retention periods.
Digital Items/Donations: Not supported.
Weight & Dimensions: Not supported.
Batch Processing: 250 orders per batch.

Mapping templates define how GunBroker order data is imported into Fixpoint.

Interface Overview

Screen labeled “Get Orders” with template naming (e.g., “Get Orders 4”).
Buttons: Delete, Duplicate, Save.
Sections: From Value (GunBroker fields), To Fixpoint Field.

Mapping Options

Don’t Map: Ignore the field.
Set To Empty: Clear the field.
Field: Map a GunBroker field (e.g., Line Item - Quantity).
Value: Set a constant value.
Mapping Set: Apply a transformation.
Rules: Use conditional logic.
Required Fields: Order ID, SKU, Quantity.

Quantity Mapping Requirement

The Line Item - Quantity field must be mapped to avoid import errors, such as a NullPointerException (NPE).

Required Field: Quantity is critical for order accuracy.
Error Scenario: If Quantity is not mapped, 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, ensure Line Item - Quantity is mapped, save, and re-run import.

Recommendation: Always map Order ID, SKU, and Quantity for stable imports.

Available Source Fields

Billing Address: City, Company, Country, Email, First Name, Last Name, Phone, State, Street Address 1, Street Address 2, Zip.
Line Item: SKU, Quantity, Price Ex Tax, Price Inc Tax, Name, UPC.
Order: Order ID, Payment Status, Date Created, Shipping Cost, Total Ex Tax, Total Inc Tax.
Shipping Address: City, Country, First Name, Last Name, Phone, Shipping Method, State, Street Address 1, Street Address 2, Zip.

Complete Field Mappings

GunBroker Field	Maps To	Example	Purpose	Status
Line Item - SKU	Fixpoint - SKU	AMMO-001	Identifies product	Required
Line Item - Quantity	Fixpoint - Quantity	5	Sets ordered units	Required
Order - Order ID	Fixpoint - Order ID	ORD123	Identifies order	Required
Shipping Address - State	Fixpoint - State	CA	Shipping address	Enabled
Shipping Address - Shipping Method	Fixpoint - Shipping Method	Standard	Shipping policy	Enabled
Order - Total Inc Tax	Fixpoint - Total	$34.99	Order total	Enabled

Practice Mapping

Try mapping the “Line Item - Quantity” field:

Troubleshoot issues with these steps:

Connection Issues: Verify GunBroker API credentials and ensure endpoints (e.g., /orders, /ffls/{fflId}) are accessible.
Missing Orders: Check selected order statuses and time frame (e.g., last 14 days).
Quantity Not Importing:
- Ensure Line Item - Quantity is mapped in the template.
- 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, ensure Line Item - Quantity is mapped, save, and re-run import.
FFL Issues: Verify FFL rules in source settings and check “Needs Attention” orders for manual approval.
Shipping Mismatches: Confirm GunBroker shipping methods map to Fixpoint policies.
Contact Support: Reach out to Fixpoint or GunBroker support with error details.

Diagnostic Tip: Quantity and FFL errors are common; verify mappings and rules first.

Key information:

Date: As of 09:04 PM -04, May 22, 2025, this integration is operational.
Quantity: Must be mapped to avoid NPE errors.
FFL Handling: Configure rules for compliance.
Batch Processing: Imports 250 orders per batch.

             Pro Tip: Schedule frequent imports to keep order data current, especially for FFL orders.
          

Conclusion

The GunBroker Get Orders integration streamlines order management in Fixpoint by importing new orders with detailed shipping, payment, and FFL information. With flexible mappings and configurations, you’ll process orders efficiently with minimal effort. Happy fulfilling!

Sync Orders

Supported | GunBroker - Sync Orders

Introduction to GunBroker Sync Orders Integration

Welcome to the GunBroker Sync Orders integration guide for Fixpoint! This integration pushes shipment and tracking updates from Fixpoint to GunBroker, ensuring buyers receive timely order status updates. With support for Federal Firearms License (FFL) checks and full shipment syncing, it streamlines your fulfillment process. Let’s explore the setup and functionality!

The GunBroker Sync Orders integration enables you to:

Push shipment updates, including tracking numbers (e.g., “1Z9999W999999999”) and carriers (e.g., “FedEx”), to GunBroker.
Update order status to “Shipped” on GunBroker (e.g., for order ID “ORD123”).
Keep buyers informed about their order status, enhancing satisfaction.

This ensures seamless order alignment between Fixpoint and GunBroker.

The integration follows these steps:

1 Fetch Orders: Retrieves orders from Fixpoint using DMX-Core (V1) or Fixpoint API (V2).
2 Verify FFL Status: Skips orders with FFL items unless marked “FFL Received.”
3 Check Shipment Status: Ensures the entire order is shipped (partial shipments not supported).
4 Sync Shipment: Pushes updates via PUT to /orders/{orderId}/shipments with tracking and carrier data.
5 Update Status: Sets “Shipped” status via PUT to /orders/{orderId}/flags.

Pro Tip: Use Fixpoint API (V2) for reliable FFL data to avoid sync errors.

Configure the integration with:

Mapping Template: Map Fixpoint shipment fields to GunBroker fields (e.g., Tracking Number).
Scheduling: Run manually or schedule (e.g., daily at 6 AM UTC).

Note: Minimal configuration ensures quick setup; focus on accurate field mappings.

Follow these steps:

1 Add the Integration: In Integrations, select GunBroker and “Sync Orders.”
2 Connect to GunBroker: Use existing or new API credentials.
3 Configure Settings: No additional settings required.
4 Create a Mapping Template: Map fields like Shipment - Tracking Number to GunBroker’s Tracking Number.
5 Run the Integration: Start manually or schedule.

The integration supports:

Platform "Notify Customer" Flow: Not supported.
Partial Order Shipments: Not supported.
Partial Order Item Shipments: Not supported.
Post-Shipment Status Updates: Updates to “Shipped” on GunBroker.
Manual Order Item Limitations: Manually added items don’t sync; complete manual orders can sync.
Limitation: Only fully shipped orders sync; partial shipments are not supported.

Mapping templates define how Fixpoint shipment data is synced to GunBroker.

Interface Overview

Screen labeled “Sync Orders” with template naming (e.g., “Sync Orders 1”).
Buttons: Delete, Duplicate, Save.
Sections: From Value (Fixpoint fields), To GunBroker Shipment Field.

Mapping Options

Don’t Map: Ignore the field.
Set To Empty: Clear the field.
Field: Map a Fixpoint field (e.g., Shipment - Tracking Number).
Value: Set a constant value.
Mapping Set: Apply a transformation.
Rules: Use conditional logic.
Required Fields: Tracking Number, Shipping Provider.

Quantity Sync Requirement

The Line Item - Quantity field must be correctly mapped in the Get Orders integration to avoid sync errors, such as a NullPointerException (NPE), as Sync Orders relies on imported order data.

Critical Data: Quantity ensures accurate shipment syncing.
Error Scenario: If Quantity is missing in Get Orders, syncing 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, ensure Line Item - Quantity is mapped, save, and re-run the import and sync jobs.

Recommendation: Verify Quantity mapping in Get Orders before syncing shipments.

Available Source Fields

Shipment: Carrier, Fulfillment Request Number, Method, Note, Shipped At, Shipping Cost, Tracking Number, Tracking URL.

Complete Field Mappings

Fixpoint Field	Maps To	Example	Purpose	Status
Shipment - Carrier	GunBroker - Shipping Provider	FedEx	Specifies carrier	Required
Shipment - Tracking Number	GunBroker - Tracking Number	1Z9999W999999999	Tracks shipment	Required
Shipment - Note	GunBroker - Comments	Handle with care	Adds notes	Optional
Shipment - Shipping Cost	GunBroker - Merchant Shipping Cost	$5.99	Shipping cost	Optional
Shipment - Tracking URL	GunBroker - Tracking Link	https://fedex.com/track	Tracking URL	Optional

Practice Mapping

Try mapping the “Tracking Number” field:

Troubleshoot issues with these steps:

Connection Issues: Verify GunBroker API credentials and ensure endpoints (e.g., /orders/{orderId}/shipments) are accessible.
FFL Errors: Ensure FFL items are marked “FFL Received”; check order status in Fixpoint.
Quantity Sync Issues:
- Verify Line Item - Quantity is mapped in the Get Orders template.
- 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, ensure Line Item - Quantity is mapped, save, and re-run import and sync.
Partial Shipment Errors: Ensure the entire order is shipped, as partial shipments are not supported.
Mapping Errors: Confirm Shipment - Tracking Number and Carrier are mapped correctly.
Contact Support: Reach out to Fixpoint or GunBroker support with error details.

Diagnostic Tip: Check FFL status and Quantity mapping in Get Orders before syncing shipments.

Key information:

Date: As of 09:06 PM -04, May 22, 2025, this integration is operational.
Quantity: Must be mapped in Get Orders to avoid NPE errors.
FFL: Requires “FFL Received” for FFL items.
Shipments: Only full shipments sync.

Pro Tip: Schedule daily syncs to ensure timely shipment updates for buyers.

Conclusion

The GunBroker Sync Orders integration ensures your shipment and tracking updates are seamlessly pushed to GunBroker from Fixpoint, keeping buyers informed. With minimal configuration and robust FFL handling, you’ll streamline fulfillment with ease. Happy syncing!

Flxpoint Knowledge

How to connect

Listing Operations

Import Listings

Sync & Link Listings

Publish Listings

Order Operations

Get Orders

Sync Orders

Related Articles