In the United States, firearms are subject to federal regulations that require them to be delivered to licensed FFL (Federal Firearms License) locations. Flxpoint helps you comply with these regulations by providing tools to identify, validate, and route firearm-related products appropriately.
This guide explains how to configure firearms workflows in Flxpoint and ensure compliance with these requirements.
Key Features for FFL Handling
Identifying Firearm Products
Flxpoint identifies and
flags products that require FFL transfers to ensure proper workflows are
applied. Examples of items requiring FFL handling include:
- Complete firearms (e.g., rifles, pistols, shotguns).
- Serialized components (e.g., AR-15 lower receivers).
- Restricted items requiring additional approvals (e.g., silencers).
Order Splitting for Mixed Items
Orders containing both
firearm and non-firearm items are automatically split:
- Firearm Orders: Held until FFL validation is complete.
- Non-Firearm Orders: Processed immediately.
Validation of FFL Information
During fulfillment request
generation, Flxpoint ensures all required FFL details are present:
- License number.
- Address of the receiving FFL holder.
- Contact details.
Configuring Firearms in Flxpoint
1. Enable Firearm Handling
To enable firearm workflows:
- Navigate to Connections > Fulfillment Sources.
- Select your source.
- In the Settings section, enable the Contains Firearms option.
This setting ensures Flxpoint applies the correct workflows to firearm-related products..
2. Mapping Firearm Fields in Inventory
Proper field mapping is essential for identifying firearm products. This is configured in your Get Inventory Mapping template.
- Navigate to Connections > Fulfillment Sources.
- Select the source and go to Integration Settings.
- Click the three-dot menu and choose Manage Mappings.
Important Fields to Map:
- Product Type/Category: Distinguish firearms from non-firearms.
- FFL Required: Indicate whether a product requires an FFL transfer.
- Firearm Indicator: Flag items that must follow firearm-specific workflows.
Mapping these fields ensures Flxpoint processes firearm-related items correctly.
3. Enable the FFL Toggle for Inventory Items
To manually indicate that a product requires an FFL transfer:
- Navigate to Products > Inventory.
- Select the firearm variant and scroll to the Additional Properties section.
- Enable the Requires FFL toggle.
This step ensures that specific products are flagged for FFL handling during order processing.
Adding FFL Information for Fulfillment
Orders containing firearms must include valid FFL details. Flxpoint provides options for automatic and manual FFL entry:
Manual FFL Entry
- Navigate to Orders.
-
Select the order and manually enter the following FFL details:
- FFL License Number.
- Receiving Party Address and Contact Information.
Automatic FFL Collection
If your sales channel supports automatic FFL data collection, Flxpoint can import FFL details directly from orders without manual entry.
Using Master FFL with BigCommerce
If you use BigCommerce with the Master FFL (FFL360) app, you can send FFL dealer data directly to Flxpoint via a webhook. Flxpoint ingests the webhook payload first, and then automatically associates the FFL details to the correct order when the order is imported via your BigCommerce “Get Orders” integration.
In the Master FFL (FFL360) app settings, set your webhook destination URL to:
Replace {channelId} with your Flxpoint BigCommerce Channel ID
(found under Connections > Sales Channels).
- Webhook must use HTTP POST.
- The webhook call must complete within 20 seconds.
- On success, Flxpoint returns HTTP status 204 (no content). Any other status is considered a failure by Master FFL.
Then in Flxpoint:
- Navigate to Connections > Sales Channels.
- Select your BigCommerce channel and open Get Orders settings.
- In Advanced Configuration, enable Import FFL Details from BigCommerce via Master FFL and enter your MasterFFL API Key when prompted.
Once enabled, Flxpoint stores each incoming MasterFFL payload in staging (keyed by order ID and channel ID) and attaches the FFL details to the order the moment the order is imported into Flxpoint.
Pro Tip: Ensure your sales channel supports FFL information collection, as Flxpoint relies on the sales channel to provide valid FFL details.
Troubleshooting Common Issues
| Issue | Cause | Resolution |
|---|---|---|
| Missing FFL Info | Required fields not populated. | Complete missing FFL fields and rerun validation. |
| Order Split Delays | Validation failed for firearm items. | Review and correct incomplete or incorrect FFL details. |
| Category Mismatches | Incorrect product mapping. | Verify and adjust mapping for firearms and serialized parts. |
| FFL data not appearing on orders | Master FFL webhook not configured or pointing to the wrong Channel ID. |
Verify the webhook URL in Master FFL includes the correct Channel ID
and matches
https://api.flxpoint.com/public/webhook/masterffl/{channelId}/ingest. Also confirm the
Import FFL Details from BigCommerce via Automatic FFL App
toggle is enabled in your channel's Get Orders settings.
|