Rapid Gun Systems is a firearms and sporting-goods point-of-sale platform with a multi-warehouse inventory model. The Flxpoint integration imports your full Rapid Gun catalog — including FFL-specific custom fields like Barrel Length, Caliber, Action, and ATF Type — and aggregates inventory across the physical warehouses you specify. This guide walks you through connecting Rapid Gun Systems, configuring product operations, and troubleshooting common issues.
How to Connect
🧭 Phase 1: Launch the Source Wizard & Enter API Credentials
+
Open Sources and start the Wizard
Go to Sources (building icon) → + Add Source → Configure Single Source. This opens the Source Wizard.
Step 1 — Create Source
Enter a clear name (e.g., Rapid Gun Systems). Then choose the Source Type that best fits how this Source will be used.
After selecting the Source Type, click Save & Next.
Choose the right Source Type
For most Rapid Gun Systems setups, we recommend Vendor Warehouse. Use the other options only if they better match how you store and ship firearms inventory.
- Vendor Warehouse (Recommended): You send POs/FRs to Rapid Gun Systems so they ship directly to your FFL or customer.
- Internal Warehouse: You stock firearms and accessories and ship from your own FFL location.
- External Warehouse: A 3PL or external FFL partner ships your owned inventory.
- Product Data Source: Content-only source to enrich product details (no fulfillment).
For Rapid Gun Systems: select Vendor Warehouse. This enables routing orders to Rapid Gun and using their multi-warehouse inventory for stock decisions.
Step 2 — Vendor Set-Up
Choose Yes (Recommended) to Assign Vendor → Confirm. You'll enable Vendor reporting and the optional Vendor portal.
Step 3 — Order Fulfillment
Decide if this source is eligible to fulfill orders:
- Yes (Recommended): You can route orders here.
- No: Routing/Shipping steps won't apply.
Step 4 — Order Fulfillment Settings
Use Defaults or No, Customize. You'll see:
- Override: Auto Processing (Use Global / Auto Process / Do NOT Auto Process).
- Commit Stock + Inventory Management Options.
- Allow Backorders / Cancel Unacknowledged Items.
Step 5 — Shipping Cost Estimations
Pick one:
- Yes, Use Rate Shopping (Real-Time Estimates).
- No, Set Up via Rules.
Step 6 — Order Routing Groups
Enable on all routing groups? Select Yes or No, Customize. Optionally mark Default Order Routing Group. Save & Next.
Reminder: Complete Shipping Methods and Source Location in Phase 2 below, then return to Phase 3 to enter your API credentials and warehouse list.
🚚 Phase 2: Shipping Methods & Source Location (Finish the Wizard)
+
Goal
Finish the Source Wizard by confirming your Ship From location and reviewing shipping behavior for Rapid Gun Systems.
Step 1 — Shipping Methods
When the wizard opens the Shipping Methods step for this Source:
- Skip if you do not need to configure shipping methods at this time.
- Or Add Method to configure shipping methods if required for your setup.
Step 2 — Source Location (Ship From)
Enter the Ship From address:
- Address, City, State/Code, Postal Code, Country/Code
- Optional: Contact Name, Phone, Email
Finish the Wizard
Review Steps 1–2, then click Save and Complete. The wizard is now finished.
Next: Proceed to Phase 3 to enter your Rapid Gun Systems API credentials, configure the required Warehouse IDs, and test the connection.
🔑 Phase 3: Create Your Rapid Gun Systems Connection
+
Goal
Rapid Gun Systems uses a single API connection (Username, Password, and API Key) plus a required Warehouse IDs setting that tells Flxpoint which of your physical locations to pull pricing and inventory from. You will enter the credentials, list your Warehouse IDs, and confirm with Test Connection.
Step 1 — Open Get Inventory [Primary] and start
Inside your Rapid Gun Systems source, open Integrations → Get Inventory [Primary] and click Start Creating Integrations.
In the connector gallery, choose Rapid Gun Systems. If you don't see it, use Not Listed? → Request a custom integration.
Step 2 — Enter API Credentials
On the New Rapid Gun Systems Connection form, enter the credentials provided by your Rapid Gun Systems account contact:
- Connection Name (required) — a friendly label, for example Rapid Gun — Production.
- Username (required) — your Rapid Gun Systems API username.
- Password (required) — your Rapid Gun Systems API password.
-
API Key (required) — sent as the
x-api-keyauthorization header.
Tip: Treat the API Key like a password. Store it only in Flxpoint — never share it by email or chat.
Step 3 — Configure Warehouse IDs (Required)
Rapid Gun Systems is a multi-warehouse source. You must tell Flxpoint which physical locations to read inventory and pricing from. In the Warehouse setting, enter a comma-separated list of your Warehouse IDs (Location IDs).
-
Example:
1001,1002,1007— the integration pulls and aggregates stock from these three warehouses only. - IDs you do not list are ignored — even if a SKU has stock in those warehouses, it will not be counted.
- Stock for the same SKU across the listed warehouses is summed into one unified quantity (see Get Inventory Secondary).
Important: The Warehouse field is mandatory. If it is left blank, the Get Inventory job will fail immediately with a human-readable error and no data will be imported. Ask your Rapid Gun Systems contact for your list of Warehouse IDs before configuring this integration.
Step 4 — Test Connection & Save
Click Test Connection. Flxpoint validates the credentials and confirms the Warehouse IDs are reachable. Once the test passes, click Save Connection.
If the test fails: double-check the API Key for typos, confirm the username and password are current, and verify each Warehouse ID exactly matches the IDs in your Rapid Gun Systems account.
Step 5 — How Flxpoint uses this connection
Unlike sources that need separate connections for inventory and orders, Rapid Gun Systems uses one connection for every operation:
- Get Inventory [Primary] — full product catalog, prices, and quantities.
- Get Inventory [Secondary] — refresh of quantities only, aggregated across your configured Warehouse IDs.
- Send Fulfillment Requests, Get Shipments, and Get Invoices — order operations use the same connection.
Tip: You only need to maintain the credentials and Warehouse IDs in one place — every operation reuses them.
Next
Configure Product & Order Operations 🚀
Now that your Rapid Gun Systems connection is saved, go to the Operations section of this doc to set up Get Inventory [Primary], Get Inventory [Secondary], and your order operations.
Product Operations
Get Inventory Primary imports the full catalog with multi-warehouse stock and custom fields. Get Inventory Secondary is a lean per-location inventory refresh that aggregates across warehouses. Run Primary daily, Secondary hourly.
Get Inventory (Primary)
Get Inventory (Secondary)
Supported
Introduction
Rapid Gun Systems — Get Inventory [Primary] imports your full Rapid Gun Systems catalog into Flxpoint, transforms it into our standard product/variant structure, and saves it in batches of 250. You'll (1) confirm your warehouses are configured, (2) choose import settings, and (3) select a mapping template.
Setup Steps
-
1Connect Rapid Gun Systems: Select your saved API connection (Username + Password + API Key). Confirm the
warehousesetting lists the Location IDs you want to import from. Click Save and Proceed. -
2Choose Settings:
- Image Handling — toggle whether to import product images alongside catalog data.
-
Archive / Un-Archive Inventory — archive SKUs absent from the latest feed; auto-restore on return.
Tip: Enable Archive in either Primary or Secondary, not both.
- 3Select a Mapping Template: Choose Rapid Gun Systems Get Source Product 1 and click Save and Complete.
What happens on each run
- Authenticate & generate access token.
- Read the warehouse configuration to determine which Location IDs to filter to.
- Download products in pages of 250, with automatic retry up to 5 times on connection drops.
- Parse + transform: extract custom fields, match prices to configured warehouses, calculate inventory totals.
- Save in batches of 250 to the Global Inventory Pool.
Field Mapping
| Rapid Gun Field | Flxpoint Field | Processing Logic |
|---|---|---|
| Product Number / SKU | Product → SKU | Primary identifier; for products without barcodes, this becomes the variant SKU too. |
| Title / Description | Product → Title / Description | Direct mapping. |
| Brand / Manufacturer | Attributes → Brand | Title-cased. |
| Barcodes (list) | Variants | Variant detection: each barcode = one unique variant. Products with no barcodes are treated as single-variant. |
Dimension fields (DIM_1_UPR, DIM_2_UPR, DIM_3_UPR) |
Variant Options | Generates "Options" (e.g., Size, Color). Asterisks (*) are ignored. |
| Inventory (per location) | Inventory → Quantity | Filtered to warehouses you configured; summed across selected locations. |
| Prices (per location) | Pricing → Cost | If 1 price — use it. If multiple, match to one of your configured warehouse locations. |
| Custom fields (full object) | Attributes (auto-extracted) | Reflection-based "sweeping" — every non-null/non-blank custom field is captured automatically. |
FFL / firearms-specific fields auto-captured: Barrel Length, Caliber, Action, ATF Type, and other firearms attributes are saved as Custom Fields without any code changes. New custom fields added by Rapid Gun appear automatically.
Two Variant Calculation Paths
Path A — Products WITH Barcodes (multi-variant):
- Each barcode becomes a unique variant.
- Option Creation: barcode dimensions → option values like Size = Large.
- Inventory Summation: scans
inventoryCellsacross allowed warehouses. - Result: accurate per-barcode "On Hand", "Available", "Committed", "On Order".
Path B — Products WITHOUT Barcodes (simple):
- Single standalone item; no variants.
- SKU Fallback: variant SKU defaults to base Product SKU if missing.
- Inventory Summation: location inventory summed across all configured warehouses.
Quick Checks
- Username, Password, and API Key are entered correctly.
-
warehousesetting lists the Location IDs you want (NOT blank). - Mapping template is selected and saved.
- Archive is enabled in one integration only (Primary or Secondary, not both).
Troubleshooting
- Job fails immediately with "warehouse config blank": add at least one Location ID.
- Inventory totals don't match per-warehouse view: by design — Flxpoint sums across selected warehouses. Use separate sources for per-warehouse visibility.
- Pages failing repeatedly: after 3 consecutive page failures, the warehouse loop aborts gracefully. Re-run; if persistent, contact Flxpoint support.
- Variants missing: products with barcodes become multi-variant; without barcodes, simple. Verify barcodes are present in Rapid Gun.
- Custom field not captured: only non-null/non-blank fields are captured. Verify the field has a value.
Warehouse Config Drives Everything
The warehouse setting controls which SKUs are imported and how inventory is summed.
⚠️ Why this matters
- Quantity in Flxpoint = sum of warehouses you list (not your total Rapid Gun stock).
- Pricing is matched to one of the configured warehouses when multiple price tiers exist.
✅ Multi-warehouse aggregation example:
- Warehouse 1 returns SKU
GLOCK19qty 5. - Warehouse 2 returns SKU
GLOCK19qty 3. - Flxpoint records quantity = 8.
🧮 Multiple Rapid Gun accounts: Create separate sources per account with non-overlapping Location IDs.
Supported
Introduction
Rapid Gun Systems — Get Inventory [Secondary] is the high-frequency inventory refresh. It pulls per-location inventory, aggregates the same SKU's stock across configured warehouses into a single total, and saves variants in batches of 500.
Setup Steps
- 1Re-use the same API connection from Primary.
- 2Match warehouse list to Primary (or intentional subset). Disable Archive here if Primary archives.
- 3Select the Secondary mapping template (SKU + Quantity).
Walkthrough: Warehouse 1 has SKU
GLOCK19 qty 5 → bucket = 5. Warehouse 2 has SKU GLOCK19 qty 3 → bucket = 8. Final saved = 8.
Field Mapping (Secondary)
| Rapid Gun Field | Flxpoint Field | Notes |
|---|---|---|
| Item Number | Variant → SKU | Primary identifier (matches Primary). |
| Quantity On Hand / Available | Inventory → Quantity | Decimal → Integer; summed across warehouses. |
| Cost fields (Average / Last / Standard) | Cost (optional) | Decimal valuation metrics. |
Catalog-level fields are refreshed only by Primary — Secondary handles inventory only.
Troubleshooting
- Quantity totals look wrong: aggregation across warehouses is by design.
- Job fails with warehouse error: blank warehouse halts the job. Add at least one Location ID.
- Page-fetch failures: retries 5x; aborts warehouse loop after 3 consecutive failures.
Troubleshooting
Common issues and solutions for Rapid Gun Systems. Click any card to expand.
!Job fails immediately ("warehouse blank")
What's happening
The warehouse setting is empty. Required.
How to fix it
- Enter a comma-separated list of Location IDs and save.
!Inventory totals don't match Rapid Gun per-warehouse view
What's happening
Flxpoint sums across all selected warehouses by design.
How to fix it
- Use separate sources per warehouse with non-overlapping Location IDs for per-warehouse visibility.
!Page-fetch retry exhaustion
What's happening
A page failed 3 times in a row; warehouse loop aborts gracefully.
How to fix it
- Wait 5-10 minutes and re-run.
- If persistent, contact Flxpoint support.
!Variants missing or incorrect
What's happening
Variant detection is barcode-driven.
How to fix it
- Verify the product has barcodes set in Rapid Gun.
- Check dimension fields aren't blank or just an asterisk.
!Custom field not captured (firearms attribute missing)
What's happening
Sweep captures only non-null fields.
How to fix it
- Confirm the field has a value in Rapid Gun.
- If populated but missing in Flxpoint, contact Flxpoint support.