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 app, you can send FFL dealer data directly to Flxpoint via a webhook. In the Master FFL app settings, set your webhook destination URL to:
Replace {channelId} with your Flxpoint BigCommerce Channel ID (found under Connections > Sales Channels). Once configured, FFL details collected at checkout are automatically attached to the corresponding order in Flxpoint.
Then in Flxpoint:
- Navigate to Connections > Sales Channels.
- Select your BigCommerce channel and open Get Orders settings.
- Enable the Import FFL Details from BigCommerce via Automatic FFL App toggle.
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. |