GunBroker is a popular online auction platform specifically tailored for firearms and related accessories. As a sales channel in Flxpoint, it allows users to list, sync, and manage their firearm inventory seamlessly across the marketplace. GunBroker supports various operations such as linking, syncing, and publishing listings, as well as managing orders. It is particularly useful for sellers looking to reach a niche market of firearm enthusiasts, with features that help automate and streamline the process of selling firearms online.
How to connect
Step 1: Log in to your Flxpoint account and navigate to Sales Channels.
Step 2: Click Create Channel (or Add Channel).
Step 3: In the Configure Integration Type screen:
Search for GunBroker in the directory and select it.
Enter a Channel Name (e.g., "GunBroker").
Click Save & Next.
Step 4: On the Connect Channel screen, set up a new GunBroker connection:
Enter a Connection Name (e.g., "GunBroker Connection #3").
Select the Environment (e.g., Production or Sandbox) from the dropdown.
Enter your GunBroker Password.
Enter your GunBroker Username.
Click Test Connection & Continue to verify the setup.
Step 5: Choose the processes you want to enable for your GunBroker channel:
Import Listings: To create and update listings and products in Flxpoint.
Get Orders: To import new orders and send back acknowledgments.
Step 6: In the Configure Settings screen for Import Listings:
Set Set New Listings to Paused to Yes or No. Choosing Yes will pause new listings to prevent syncing until inventory is linked.
Set your Master SKU by selecting Use a field from my channel and choosing a field, or select Don't set a master SKU at this time.
Under Product & Listing Management, choose how listings should be imported (e.g., "Create and update products & listings").
Click Confirm to proceed.
Step 7: In the Configure Settings screen for Get Orders:
Set the Time Frame (e.g., "CreatedLastWeek").
Select the Order Status to import (e.g., Pending Seller Review, Pending Buyer Confirmation, etc.).
Select the FFL Status (e.g., All, Awaiting FFL, FFL Received).
Set the Personal Identifying Information Retention (e.g., Indefinitely, 30 Days After Shipment).
Click Confirm to proceed.
Step 8: In the Channel Created screen:
Check the box to Enable this to start importing your active listings into Flxpoint immediately if desired.
Check the box to Start importing orders immediately if desired.
Click Confirm & Finish to complete the setup.
Final Step: Your GunBroker channel is now set up! You can revisit it in Sales Channels to:
Start Import Listings to create and update listings and products in Flxpoint.
Start Get Orders to import new orders and send back acknowledgments.
Use other operations like Sync Listings, Publish Listings, Sync Orders, and Send Accounting Shipments as needed.
Adjust any skipped steps from the channel settings.
×
Listing Operations
Flxpoint allows you to manage product listings on eBay by syncing inventory, updating product details, and controlling pricing and availability. This ensures accurate and real-time updates across your eBay store.
Import Listings
Supported | GunBroker - Import Listings
Introduction to GunBroker Import Listings Integration
This guide explains how to use the GunBroker Import Listings integration to bring your existing GunBroker listings into Fixpoint for centralized management. This ensures accurate synchronization and organization of your inventory across platforms. Whether you're managing a small or large catalog, this integration simplifies the process of importing listings, aligning categories, and setting up for further synchronization.
Purpose of This Integration
The GunBroker Import Listings integration connects your Fixpoint system to GunBroker to:
- Import existing GunBroker listings into Fixpoint for centralized management.
- Align Fixpoint product categories with GunBroker’s category structure (e.g., mapping "Ammo" to "Centerfire Handgun Rounds").
- Link imported listings to Fixpoint records using identifiers like SKU.
- Allow pausing of imported listings to prevent synchronization until they are properly linked and verified.
This ensures your Fixpoint inventory reflects your GunBroker listings accurately and is ready for further management.
How the Integration Works
The integration follows a clear process to import listings into Fixpoint:
1. Fetch Listings: Listings are retrieved from GunBroker using the API endpoint https://api.gunbroker.com/v1/ with endpoints for fixed price listings (/auction/fixedPrice/listing).
2. Add Attributes: The attribute IsFixedPrice is added to the product catalog for fixed price listings.
3. Import Data: Listings are imported into Fixpoint, including details like quantity, price, images, and categories.
4. Link Listings: Imported listings are linked to existing Fixpoint records by SKU, or new records are created if no match is found.
5. Category Alignment: Categories are mapped (e.g., GunBroker’s numerical Category IDs are aligned with Fixpoint categories like "Ammo").
6. Paused Status Option: Listings can be set to a "Paused" status to prevent synchronization until verified.
Note: The integration supports only USD for pricing and does not support variants, multiple warehouses, or weights/dimensions.
Configuration Options
Customize the integration to fit your needs:
- Paused Status: Automatically set newly imported listings to "Paused" to prevent syncing until they are properly linked (e.g., price, quantity).
- Master SKU: Choose a field from GunBroker (e.g., SKU, UPC, MPN) to populate Fixpoint’s Master SKU, defining the primary identifier for linking.
- Product & Listing Management: Decide whether to create new products and listings only, or create and update existing ones with imported data.
- Category Mapping: Align Fixpoint categories with GunBroker’s numerical Category IDs for proper organization.
- Advanced Mapping Rules: Use rules to modify imported data (e.g., split values or use rightmost values) for better alignment.
Setup Instructions
Follow these steps to set up the GunBroker Import Listings integration:
1. Add the Integration: Navigate to the Integrations section, select GunBroker as the integration type, and choose “Import Listings.”
2. Connect to GunBroker: Select an existing GunBroker connection or set up a new one using your GunBroker API credentials.
3. Configure Settings: Enable "Set New Listings to Paused" if desired, select a Master SKU field (e.g., SKU), choose product/listing management options, and align categories.
4. Apply Advanced Mapping Rules (Optional): Set up rules to modify imported data for better alignment (e.g., splitting values).
5. Run the Integration: Save and complete the setup to import listings into Fixpoint.
Note: After importing, you can unpause listings by navigating to Products > Select Listings > Actions > Change Listing Status > Unpause Listings.
Operation Details
The integration supports the following features:
- Custom Fields: Not supported.
- Variants/Options: Not supported (variants are not available on GunBroker).
- Generic Pricing & Currency: Supported, but only in USD.
- Client Pricing & Currency: Not supported.
- Quantity: Supported, with available quantity saved in Fixpoint.
- Multiple Warehouses: Not supported.
- Weights & Dimensions: Not supported.
- Images: Supported, with thumbnail image URLs saved in Fixpoint.
- Categories: Supported, with GunBroker’s primary category name saved as Cat1 and secondary category code as Cat2 in Fixpoint.
- Limitations: MPN is saved with the import.
Troubleshooting
If the integration encounters an issue, try these steps:
- Verify your GunBroker API credentials and connection.
- Ensure the API endpoint https://api.gunbroker.com/v1/ is accessible.
- Check category alignments between Fixpoint and GunBroker.
- Confirm the Master SKU field selected matches your data for proper linking.
If issues persist, contact support for assistance.
Conclusion
With the GunBroker Import Listings integration, you can seamlessly bring your GunBroker listings into Fixpoint, ensuring centralized management and accurate organization. By aligning categories, setting Master SKUs, and configuring import settings, you’ll have full control over your inventory with minimal effort!
Sync & Link Listings
Supported | GunBroker - Sync & Link Listings
Introduction to GunBroker Sync & Link Listings Integration
This guide explains how to use the GunBroker Sync & Link Listings integration to keep your product listings in sync with your Fixpoint inventory. This integration ensures that prices and stock levels are always up to date between Fixpoint and GunBroker. It also allows you to link listings using identifiers like SKU, UPC, or GTIN, manage categories, and handle zero-quantity scenarios. Let’s dive into the setup and functionality.
Purpose of This Integration
The GunBroker Sync & Link Listings integration connects your Fixpoint system to GunBroker to:
- Sync price, quantity, and status (PQS) updates between Fixpoint and GunBroker.
- Link Fixpoint listings to GunBroker listings using identifiers like SKU, UPC, or GTIN.
- Align Fixpoint product categories with GunBroker’s structure for better organization.
- Automatically delist products on GunBroker when quantity reaches zero, with options to relist.
This ensures your GunBroker listings are accurate and aligned with your Fixpoint inventory.
How the Integration Works
The integration follows a streamlined process to sync and link listings:
1. Retrieve Listings: Active listings are fetched from Fixpoint.
2. Delist Unavailable Products: Products not available in Fixpoint (directly on GunBroker) are marked for delisting.
3. Update Item IDs: New item IDs are assigned for listings unavailable in Fixpoint but active on GunBroker, associating them with channel listings.
4. Handle Quantity Changes: If a listing’s quantity is sold, GunBroker updates the item ID, and the new ID is saved in the database.
5. Queue Updates: Price and quantity updates are queued for syncing.
6. Sync Data: Updates are sent to GunBroker via PUT requests to the listings endpoint.
7. Delist Out-of-Stock: Listings with zero quantity are delisted using the stock update endpoint.
8. Link Listings: Listings are linked based on user-defined priorities (e.g., SKU, UPC, GTIN).
Note: Listings can be filtered by type (e.g., Fixed Price or Auction) in the integration configuration.
Configuration Options
Customize the integration to fit your needs:
- Linking Priority: Set the order of identifiers (e.g., SKU, UPC, GTIN) to match Fixpoint listings with GunBroker listings.
- Zero Quantity Handling: Automatically delist products when quantity reaches zero, with steps to relist by updating stock in Fixpoint.
- Listing Type: Choose to sync all listings, Fixed Price only, or Auction only.
- Scheduling: Run the integration manually or schedule it (e.g., daily at 6 AM UTC).
- Mapping Template: Define how Fixpoint fields map to GunBroker fields for syncing.
Setup Instructions
Follow these steps to set up the GunBroker Sync & Link Listings integration:
1. Add the Integration: Navigate to the Integrations section, select GunBroker as the integration type, and choose “Sync Listings.”
2. Connect to GunBroker: Select an existing GunBroker connection or set up a new one using your GunBroker API credentials.
3. Configure Settings: Set the linking priority (e.g., SKU first, then GTIN), align categories, configure zero quantity handling, and enable scheduling if needed.
4. Create a Mapping Template: Define how Fixpoint fields map to GunBroker fields (details below).
5. Run the Integration: Start the integration manually or let it run on your schedule.
Hiding
Hiding products is not supported for GunBroker listings. Visibility is managed through delisting when quantities reach zero.
Delisting
Products are automatically delisted from GunBroker when their quantity reaches zero. To relist:
1. Add stock in Fixpoint to update the quantity.
2. Run the sync operation to update GunBroker.
3. The listing will be relisted with the new quantity.
Mapping Template Details
A mapping template defines how data from Fixpoint is synced to GunBroker. For example, you can map Fixpoint’s “Quantity” field to GunBroker’s “Inventory Level.” Below are the details:
Interface Overview
- The mapping screen is labeled “Mapping” at the top, with options to select templates, rules, sets, and product builders.
- Buttons available: Delete and Save.
- Two sections:
- From Value: Fields from Fixpoint (e.g., Listing Variant fields like Quantity, List Price).
- To GunBroker Variant Field: Fields in GunBroker (e.g., GTIN, SKU, UPC).
Mapping Options You can choose from the following options for each field:
- Don’t Map: Ignore the field entirely.
- Set To Empty: Clear any existing data in that field.
- Field: Map a field from Fixpoint (e.g., Listing Variant’s “Quantity”) to a GunBroker field.
- Value: Set a constant value for all products.
- Mapping Set: Apply a predefined transformation or mapping table.
Available Source Fields Fixpoint provides fields under categories like “Listing Variant,” including:
Complete Field Mappings Below is a sample list of fields you can map to GunBroker:
GTIN: Global Trade Item Number for the variant.
- Suggested Mapping: Map to a custom field if available, or don’t map if not needed.
MPN: Manufacturer Part Number.
- Suggested Mapping: Map to a custom MPN field in Fixpoint, or don’t map.
SKU: Stock Keeping Unit identifier.
- Suggested Mapping: Map to Listing Variant’s “SKU” if available, or don’t map.
UPC: Universal Product Code.
- Suggested Mapping: Map to Listing Variant’s “UPC” if available, or don’t map.
Practice Mapping Here’s an example—if you map the “SKU” field:
Troubleshooting
If the integration encounters an issue, try these steps:
- Verify your GunBroker API credentials and connection.
- Ensure the linking priority (e.g., SKU, GTIN) matches your data.
- Check your mapping template for correct field mappings.
- Confirm category alignments between Fixpoint and GunBroker.
If issues persist, contact support for assistance.
Conclusion
With the GunBroker Sync & Link Listings integration, your Fixpoint inventory will stay in sync with GunBroker, ensuring accurate prices, stock levels, and categories. You’ll also have control over linking and delisting products, making inventory management seamless and efficient!
Publish Listings
Supported | GunBroker - Publish Listings
Introduction to GunBroker Publish Listings Integration
This section guides you through using the Publish Listings integration to create new product listings on GunBroker directly from Flxpoint. This integration helps you manage your product catalog by ensuring accurate category mapping, handling zero quantity scenarios, and mapping your product data to GunBroker’s fields. It also includes safeguards to prevent publishing listings with incorrect pricing. Let’s dive into how this works and how to set it up.
Purpose of This Integration
The Publish Listings integration for GunBroker allows you to:
- Create new product listings on GunBroker directly from Flxpoint.
- Map your product data to GunBroker’s fields using a mapping template.
- Ensure proper category mapping using numeric Category IDs.
- Prevent publishing listings with missing or zero cost/list price to avoid unintended low pricing.
This integration streamlines the process of listing products on GunBroker, ensuring your listings are accurate and compliant with GunBroker’s requirements.
How the Integration Works
The integration follows these steps to publish listings on GunBroker:
1. Category Mapping: GunBroker requires category mapping using numeric Category IDs. For example, “Pistol Ammunition” maps to Category ID 3018. You can find the full list of Category IDs here.
2. Mapping Data: A mapping template defines how your system’s fields (e.g., Title, SKU) are mapped to GunBroker’s fields (e.g., Name, SKU). A default rule ensures quantity is set to 0 if cost or list price is 0 (more details below).
3. Publishing Products: Products are published via a POST request using parameters like ItemSKU={sku}&SellerName={sellerName}&ItemID={external listing ID}.
4. Handling Zero Quantity: When Flxpoint syncs a quantity of 0 to GunBroker, the corresponding listing is automatically ended. To republish, update the quantity in Flxpoint and run the sync operation again.
5. Running the Integration: You can run the integration manually or schedule it to run automatically (e.g., daily or weekly).
Note: Ensure SKUs match between Flxpoint and GunBroker to prevent duplicate listings during re-publishing.
Category Mapping Requirements
GunBroker requires category mapping using numeric Category IDs. Below is a sample of some Category IDs:
Category Path
Category ID
All > Air Guns > Air Gun Accessories
3052
All > Air Guns > Air Pistols
3049
All > Air Guns > Air Rifles
3050
All > Air Guns > Airsoft
3048
All > Air Guns > Paintball Guns
3051
All > Ammunition > Reloading > Reloading Equipment
3015
All > Ammunition > Reloading > Reloading Supplies
3016
All > Ammunition > Ammo Storage
3053
All > Ammunition > Large Bore, Inert & Cannon Ammo
Custom fields can be mapped in the mapping template as key/value pairs. GunBroker supports these as item characteristics, which can be uploaded for each listing.
Attributes / Tags
Attributes can be uploaded as custom fields on GunBroker. Map these in the mapping template to ensure they are associated with your listings.
Variations / Options
GunBroker does not support variations/options. All products are listed as individual listings, and each variant must be published as a separate listing.
Generic Pricing (& Currency)
The integration supports sending a single price for each listing. For auction listings, the starting price is mandatory, while reserve price and buy-now price are optional. Currency is set by GunBroker (typically USD). To avoid publishing with incorrect pricing (e.g., a very low price), a default rule sets the quantity to 0 if the cost or list price is 0 (see Quantity section below).
Quantity
For auction listings, quantity is always set to 1. For fixed-price listings, any quantity can be sent. When the quantity syncs to 0, the listing is automatically ended.
Important Quantity Rule: To prevent listings from being published with a very low or incorrect price (which can happen if cost or list price is missing or 0), a default rule is applied in the mapping template for new GunBroker configurations. This rule sets the quantity to 0 if:
- The cost (e.g., Listing Variant’s Estimated Cost) is 0 or does not exist, OR
- The list price (e.g., Listing Variant’s List Price) is 0 or does not exist.
When the quantity is set to 0, the listing is automatically delisted from GunBroker, preventing it from being sold at an unintended price. You can modify or remove this rule in the mapping template if needed.
Multiple Warehouses
GunBroker does not support multiple warehouses. Quantities are aggregated in Flxpoint and sent as a single value to GunBroker.
Weights & Dimensions (& Units)
Weight is uploaded as an item characteristic but is not a required field on GunBroker. Dimensions are not supported.
Images
Multiple images can be uploaded for each listing. If variant images are blank, parent images are used. Ensure images meet GunBroker’s requirements.
Categories
Categories must be mapped using numeric Category IDs. Ensure the category field in your mapping template matches the correct Category ID from the spreadsheet.
Overwriting Supported
Overwriting is supported to update static data on GunBroker. However, it does not support auction listings. Ensure SKUs match to avoid duplicates.
Offerings vs Creation
The integration supports creating new listings on GunBroker. Overwriting can be used to update existing listings with matching SKUs.
Option Limitations
GunBroker does not support options or variations. Each product must be listed individually.
Image Limitations
GunBroker supports multiple images per listing, but specific size limits may apply. Ensure your images comply with GunBroker’s requirements.
HTML Descriptions
HTML descriptions are supported and can be mapped to GunBroker’s Description field via the mapping template.
Limitations
Key limitations for publishing on GunBroker:
- Auto relist is set to No by default.
- Serial numbers can be created during publishing but cannot be updated via overwriting.
- Categories must be mapped using numeric Category IDs.
Mapping Template Details
A mapping template defines how data from your system is published to GunBroker. For example, you can map your system’s “Title” field to GunBroker’s “Name” field. Below are the details:
Interface Overview
- The mapping screen is labeled “Publish Listings” at the top. You can name your template (e.g., “Publish Listings 1”).
- Buttons available: Delete, Duplicate, and Save.
- Two sections:
- From Value: Fields from your system (e.g., Listing Parent fields like Title, Parent SKU; Listing Variant fields like UPC, MSRP).
- To GunBroker Product Field: Fields in GunBroker (e.g., Name, SKU, Category).
Mapping Options
You can choose from the following options for each field:
- Don’t Map: Ignore the field entirely.
- Set To Empty: Clear any existing data in that field on GunBroker.
- Field: Map a field from your system (e.g., Listing Parent’s “Title”) to a GunBroker field.
- Value: Set a constant value for all listings.
- Mapping Set: Apply a predefined transformation or mapping table.
- Rules: Use conditional logic to modify fields based on specific criteria (e.g., the default Quantity rule to set quantity to 0 if cost or list price is 0).
Available Source Fields
Your system provides fields under categories like “Listing Parent” and “Listing Variant,” including:
Complete Field Mappings
Below is a comprehensive list of fields you can map to GunBroker, based on the integration’s capabilities:
Name: The listing name (required).
- Example: “9mm Pistol Ammunition”
- Suggested Mapping: Map to Listing Parent’s “Title” using Field.
SKU: The SKU of the listing.
- Example: “AMMO-001”
- Suggested Mapping: Map to Listing Parent’s “Parent SKU” using Field.
Category: The numeric Category ID (required).
- Example: “3018” (Pistol Ammunition)
- Suggested Mapping: Map to Listing Parent’s “Category 1” using Field and ensure it matches a numeric Category ID.
Price: The starting price for auction listings or fixed price for standard listings.
- Example: “29.99”
- Suggested Mapping: Map to Listing Variant’s “List Price” using Field.
Quantity: The quantity of the listing (1 for auctions, any for fixed-price). A default rule sets this to 0 if cost or list price is 0 to prevent incorrect pricing.
- Example: “1”
- Suggested Mapping: Map to Listing Variant’s “Quantity” using Field.
Description: The description of the listing.
- Example: “High-quality 9mm pistol ammunition, 50 rounds per box.”
- Suggested Mapping: Map to Listing Parent’s “Description” using Field.
Images: The images for the listing.
- Example: A list of image URLs.
- Suggested Mapping: Map to Listing Parent’s “Image” using Field.
UPC: Universal Product Code for the listing.
- Example: “123456789012”
- Suggested Mapping: Map to Listing Variant’s “UPC” using Field.
Weight: The weight of the product (uploaded as an item characteristic).
- Example: “2.5”
- Suggested Mapping: Map to Listing Variant’s “Weight” using Field.
Custom Fields: Additional item characteristics as key/value pairs.
- Example: “Color: Black”
- Suggested Mapping: Map to Listing Parent’s “Custom Field” using Field.
Practice Mapping
Here’s a quick example—if you map the “Name” field:
Troubleshooting
If the integration encounters an issue, try these steps:
- Ensure category mappings use correct numeric Category IDs from the spreadsheet.
- Check that SKUs match between Flxpoint and GunBroker to avoid duplicates.
- If a listing ends due to zero quantity (e.g., because cost or list price is 0), update the cost/list price and quantity in Flxpoint, then re-run the sync.
- Ensure images meet GunBroker’s requirements.
If problems persist, contact support for assistance.
Conclusion
With the GunBroker Publish Listings integration, you can efficiently create new listings on GunBroker directly from Flxpoint. By mapping your product data, ensuring proper category IDs, and leveraging safeguards like the Quantity rule, this integration helps you maintain an accurate and compliant catalog on GunBroker, ready for customers!
×
Order Operations
Flxpoint imports orders from eBay into your system, automating order processing, tracking updates, and inventory adjustments. This streamlines fulfillment and ensures efficient handling of eBay transactions.
Get Orders
Supported | GunBroker - Get Orders
Introduction to GunBroker Get Orders Integration
This guide explains how to use the GunBroker Get Orders integration to retrieve new orders from GunBroker that have not yet been imported into Fixpoint. This integration includes itemized order details, shipping information, and customer data, ensuring streamlined order management. It also supports Federal Firearms License (FFL) handling and shipping policy mappings for efficient processing.
Purpose of This Integration
The GunBroker Get Orders integration connects your Fixpoint system to GunBroker to:
- Import new orders with details like payment status, shipping information, and customer data.
- Handle orders requiring Federal Firearms License (FFL) compliance with additional checks.
- Import orders in USD with itemized line details for accurate order management.
This ensures your Fixpoint system stays updated with GunBroker orders, enabling efficient processing and fulfillment.
How the Integration Works
The integration follows a structured process to retrieve and import orders:
1. Fetch Orders: Orders are retrieved in batches of 250 using the GunBroker API endpoint (e.g., /orders).
2. Get Order Details: Detailed order information is fetched, including order status, FFL status, and timestamps.
3. Retrieve Line Items: Order line items are fetched using the /items/{itemId} endpoint to get SKUs and quantities.
4. Fetch FFL Details: If FFL is required, FFL details are retrieved using the /ffls/{fflId} endpoint to include business names and license information.
5. Multi-Status Handling: Orders with multiple statuses (e.g., Payment Pending) are processed based on selected statuses in the configuration.
6. Iterate and Import: Orders are imported iteratively based on the selected statuses, ensuring all relevant orders are captured.
Note: GunBroker does not support multi-status orders in a single API call, so statuses are processed separately.
Configuration Options
Customize the integration to fit your needs:
- Order Status Selection: Choose which order statuses to import (e.g., Payment Pending, Awaiting Shipment).
- FFL Handling: Enable FFL checks and configure rules in source settings to flag items requiring FFL compliance.
- Personal Identifying Information (PII) Retention: Set retention periods for PII (e.g., Indefinitely, 30 days after shipment).
- Time Frame: Specify the time frame for fetching orders (e.g., orders created within the last 14 days).
- Scheduling: Run the integration manually or schedule it (e.g., daily at 6 AM UTC).
- Mapping Template: Define how GunBroker order fields map to Fixpoint fields (details below).
Setup Instructions
Follow these steps to set up the GunBroker Get Orders integration:
1. Add the Integration: Navigate to the Integrations section, select GunBroker as the integration type, and choose “Get Orders.”
2. Connect to GunBroker: Select an existing GunBroker connection or set up a new one using your GunBroker API credentials.
3. Configure Settings: Select order statuses to import, map shipping methods, configure FFL rules, set PII retention, and define the time frame for order retrieval.
4. Create a Mapping Template: Define how GunBroker order fields map to Fixpoint fields (details below).
5. Run the Integration: Start the integration manually or schedule it to run automatically.
Shipping Mappings
Orders include a "Shipping Text" field (e.g., "Standard," "Priority") that must be mapped to Fixpoint shipping policies:
- Map GunBroker’s "Standard" to Fixpoint’s "Standard" shipping policy.
- Map GunBroker’s "Priority" to Fixpoint’s "Priority" shipping policy.
This ensures proper shipping method alignment during order processing.
FFL Handling
Orders requiring Federal Firearms License (FFL) compliance are handled separately:
- FFL Rules: Configure rules in source settings to flag items as FFL (e.g., based on category "Rifles").
- FFL Orders: Ensure the FFL dealer’s information is included in the order. Orders marked as "Needs Attention" require manual approval before processing.
This ensures compliance with firearm regulations during order fulfillment.
Operation Details
The integration supports the following features:
- Order & Payment Statuses: Supported, with payment status saved in the channel invoice section.
- Order Acknowledgment: Not supported.
- Order Receipt/Invoice & Currency: Supported, in USD only.
- Shipping Selection: Supported, with unique shipping methods mapped in shipping management.
- Custom Fields: Not supported.
- PII Restrictions: Supported, with configurable retention periods.
- Digital Items/Donations: Not supported.
- Weight & Dimensions: Not supported; GunBroker does not include these in orders.
- Limitations: Orders are imported in batches of 250 for optimal performance.
Mapping Template Details
A mapping template defines how data from GunBroker orders is imported into Fixpoint. For example, you can map GunBroker’s "Shipping Address - State" to Fixpoint’s "State" field. Below are the details:
Interface Overview
- The mapping screen is labeled “Get Orders” at the top, with options to name your template (e.g., “Get Orders 4”).
- Buttons available: Delete, Duplicate, and Save.
- Two sections:
- From Value: Fields from GunBroker (e.g., Billing Address, Line Item, Order, Shipping Address).
- To Fixpoint Field: Fields in Fixpoint (e.g., State, SKU, Order ID).
Mapping Options You can choose from the following options for each field:
- Don’t Map: Ignore the field entirely.
- Set To Empty: Clear any existing data in that field.
- Field: Map a field from GunBroker (e.g., Shipping Address - State) to a Fixpoint field.
- Value: Set a constant value for all orders.
- Mapping Set: Apply a predefined transformation or mapping table.
- Rules: Use conditional logic to modify fields (more advanced).
Available Source Fields GunBroker provides fields under categories like:
- 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 Below is a sample list of fields you can map to Fixpoint:
State: The state in the billing or shipping address.
- Suggested Mapping: Map to GunBroker’s "Billing Address - State" or "Shipping Address - State" using Field.
State Code: The state code in the address.
- Suggested Mapping: Don’t Map (default) or map to a custom field if needed.
SKU: The stock keeping unit of the line item.
- Suggested Mapping: Map to GunBroker’s "Line Item - SKU" using Field.
Order ID: The unique identifier for the order.
- Suggested Mapping: Map to GunBroker’s "Order - Order ID" using Field.
Shipping Method: The shipping method selected for the order.
- Suggested Mapping: Map to GunBroker’s "Shipping Address - Shipping Method" using Field.
Quantity: The quantity of the line item.
- Suggested Mapping: Map to GunBroker’s "Line Item - Quantity" using Field.
Practice Mapping Here’s an example—if you map the “State” field:
Troubleshooting
If the integration encounters an issue, try these steps:
- Verify your GunBroker API credentials and connection.
- Ensure the API endpoints (e.g., /orders, /ffls/{fflId}) are accessible.
- Check your mapping template for correct field mappings (e.g., "Shipping Address - State" to "State").
- Confirm FFL rules are correctly set in source settings for FFL items.
If issues persist, contact support for assistance.
Conclusion
With the GunBroker Get Orders integration, you can efficiently import new orders into Fixpoint, complete with shipping, payment, and FFL details. By configuring shipping mappings, FFL rules, and order statuses, you’ll streamline your order management process with minimal manual effort!
Sync Orders
Supported | GunBroker - Sync Orders
Introduction to GunBroker Sync Orders Integration
This guide explains how to use the GunBroker Sync Orders integration to push shipment and tracking updates from Fixpoint to GunBroker. This ensures that your buyers are informed about the status of their orders, keeping your order management seamless and efficient.
Purpose of This Integration
The GunBroker Sync Orders integration connects your Fixpoint system to GunBroker to:
- Push shipment updates, including tracking numbers and carrier information, to GunBroker when an order is fully shipped.
- Update the order status to "Shipped" on GunBroker upon successful sync.
- Ensure buyers receive timely updates about their order status.
This integration keeps your GunBroker orders aligned with Fixpoint, enhancing customer satisfaction.
How the Integration Works
The integration follows a structured process to sync order updates:
1. Fetch Orders: Orders are retrieved from Fixpoint using DMX-Core (V1) API or Fixpoint API (V2).
2. Verify FFL Status: Ensure the order does not include FFL items unless marked as FFL Received; orders with FFL items not marked as received are skipped.
3. Check Shipment Status: A shipment is eligible for sync only when the entire order is shipped (partial shipments are not supported).
4. Sync Shipment: Push shipment updates to GunBroker via a PUT request to /orders/{orderId}/shipments, including tracking number, carrier, and FFL Received flag if applicable.
5. Update Status: Update the order status to "Shipped" on GunBroker using a PUT request to /orders/{orderId}/flags.
Note: Only fully completed orders are synced, and manually created orders in Fixpoint are not eligible for shipment sync.
Configuration Options
The integration requires minimal configuration:
- Mapping Template: Define how Fixpoint shipment fields map to GunBroker shipment fields (details below).
- Scheduling: Run the integration manually or schedule it (e.g., daily at 6 AM UTC).
Note: There are no additional settings to configure in Fixpoint for this integration.
Setup Instructions
Follow these steps to set up the GunBroker Sync Orders integration:
1. Add the Integration: Navigate to the Integrations section, select GunBroker as the integration type, and choose “Sync Orders.”
2. Connect to GunBroker: Select an existing GunBroker connection or set up a new one using your GunBroker API credentials.
3. Configure Settings: No additional settings are required for this integration.
4. Create a Mapping Template: Define how Fixpoint shipment fields map to GunBroker shipment fields (details below).
5. Run the Integration: Start the integration manually or schedule it to run automatically.
Operation Details
The integration supports the following features:
- Platform "Notify Customer" Flow: Not supported.
- Partial Order Shipments: Not supported.
- Partial Order Item Shipments: Not supported.
- Post-Shipment Status Updates: Supported; updates the status to "Shipped" on GunBroker.
- Manual Order Item Limitations: Supported; manually added items to a downloaded order will not sync, but complete orders created manually in Fixpoint can sync.
- Limitations: Only fully completed orders are eligible for synchronization; partial shipments are not supported due to GunBroker’s restrictions.
Mapping Template Details
A mapping template defines how shipment data from Fixpoint is synced to GunBroker. For example, you can map Fixpoint’s "Tracking Number" field to GunBroker’s "Tracking Number" field. Below are the details:
Interface Overview
- The mapping screen is labeled “Sync Orders” at the top, with options to name your template (e.g., “Sync Orders 1”).
- Buttons available: Delete, Duplicate, and Save.
- Two sections:
- From Value: Fields from Fixpoint (e.g., Shipment fields like Carrier, Tracking Number).
- To GunBroker Shipment Field: Fields in GunBroker (e.g., Tracking Number, Shipping Method).
Mapping Options You can choose from the following options for each field:
- Don’t Map: Ignore the field entirely.
- Set To Empty: Clear any existing data in that field.
- Field: Map a field from Fixpoint (e.g., Shipment - Tracking Number) to a GunBroker field.
- Value: Set a constant value for all shipments.
- Mapping Set: Apply a predefined transformation or mapping table.
- Rules: Use conditional logic to modify fields (more advanced).
Available Source Fields Fixpoint provides fields under the "Shipment" category, including:
Complete Field Mappings Below is a sample list of fields you can map to GunBroker:
Shipping Provider: The carrier providing the shipping service.
- Suggested Mapping: Map to Fixpoint’s "Shipment - Carrier" using Field.
Comments: Additional notes about the shipment.
- Suggested Mapping: Map to Fixpoint’s "Shipment - Note" using Field.
Date Created: The date the shipment was created.
- Suggested Mapping: Don’t Map (default) or map to "Shipment - Shipped At" if needed.
Merchant Shipping Cost: The cost of shipping for the merchant.
- Suggested Mapping: Map to Fixpoint’s "Shipment - Shipping Cost" using Field.
Shipping Method: The shipping method used.
- Suggested Mapping: Map to Fixpoint’s "Shipment - Method" using Field.
Tracking Carrier: The carrier associated with the tracking number.
- Suggested Mapping: Map to Fixpoint’s "Shipment - Carrier" using Field.
Tracking Link: The URL for tracking the shipment.
- Suggested Mapping: Map to Fixpoint’s "Shipment - Tracking URL" using Field.
Tracking Number: The tracking number for the shipment.
- Suggested Mapping: Map to Fixpoint’s "Shipment - Tracking Number" using Field.
Practice Mapping Here’s an example—if you map the “Tracking Number” field:
Troubleshooting
If the integration encounters an issue, try these steps:
- Verify your GunBroker API credentials and connection.
- Ensure the API endpoints (e.g., /orders/{orderId}/shipments) are accessible.
- Check your mapping template for correct field mappings (e.g., "Shipment - Tracking Number" to "Tracking Number").
- Confirm the order is fully shipped and does not require FFL unless marked as FFL Received.
If issues persist, contact support for assistance.
Conclusion
With the GunBroker Sync Orders integration, you can efficiently push shipment and tracking updates from Fixpoint to GunBroker, ensuring your buyers are kept informed. By configuring the mapping template and scheduling the integration, you’ll streamline your order fulfillment process with minimal effort!