Flxpoint Help Center
All DocsContact support

How to Add & Configure a Source

June 26, 2026

Summary

Learn how to connect and manage fulfillment centers or supplier feeds by setting up integrations, importing inventory, and validating data. This guide is for users who need to automate product data, stock levels, and order routing between suppliers and their Flxpoint account.

Get Inventory
Pulls product data, pricing, and stock levels from the supplier
Send FRs
Transmits fulfillment requests to the supplier when an order routes
Get Shipments
Retrieves tracking numbers from the supplier after fulfillment
Get Invoices
Imports supplier invoices for reconciliation and accounting sync

A source connects in one of four ways. Find your supplier's method below and gather what it needs before you start - the credentials all come from the supplier, not from Flxpoint.

API
An API key or client credentials from the supplier. Confirm the supplier's API supports Send FRs and Get Shipments before onboarding - not all supplier APIs expose these endpoints.
Where: the supplier's account or developer portal (API / integrations section).
SFTP / FTP
Host, port, username, password, and the exact directory path where files are placed (whether files land in an in/, out/, or root folder).
Where: from the supplier - also confirm the file naming convention and update frequency.
EDI
ISA/GS identifiers, transaction set codes, and the file exchange schedule. Requires coordination with the supplier's EDI team before setup.
Where: the supplier's EDI / integrations team.
Built-in integration
Supplier account credentials (username/password or API token). For integrations like RSR, Keystone, Seawide, and Sports South.
Where: your supplier account portal - not your Flxpoint credentials.

Confirm Send FRs and Get Shipments before onboarding

If orders will route to this source, confirm the supplier supports Send FRs and Get Shipments via their connection method - discovering they don't after catalog and listings are built causes significant rework. Confirm this before running the first Get Inventory.

Duplicate variant SKUs are dropped - a duplicate key error can appear

Variant SKUs must be unique in the supplier feed. If the feed has the same SKU on two rows, Flxpoint keeps only the first, and a duplicate error can be shown, something like a duplicate key error. Validate the raw feed for SKU duplicates before configuring the mapping template, especially for CSV and SFTP sources.

Every Get Inventory run can overwrite existing data

Each run updates source inventory records - including overwriting previously correct data if the supplier feed changes. Validate cost, price, and content after each new integration configuration, not just the first run.

Supplier outages affect all accounts simultaneously

When a built-in integration goes down (e.g. Sports South, RSR, Keystone), all Flxpoint accounts using it fail at once. If jobs suddenly fail across multiple sources from one supplier, check for a supplier-side outage before troubleshooting your configuration.

Primary vs Secondary Get Inventory are not interchangeable

Primary imports full product content - titles, images, descriptions, cost, and quantity. Secondary imports price and quantity only, runs more frequently. Running only Primary at high frequency on large catalogs creates unnecessary load and slower syncs.

Set an inventory buffer before enabling channel sync

Supplier feeds lag behind real inventory. Without a buffer, Flxpoint syncs reported quantity as-is and fast-moving SKUs oversell before the next update. Configure a buffer in Source → Settings → Enable Commit stock before the first Sync Listings run. Buffers reduce what's shown to the channel proactively; committed stock reduces available quantity reactively when an order is placed.


Get Inventory [Primary]Required

Imports new inventory items and full product data - titles, categories, images, content, cost, pricing, and quantity. The foundation import for every source: run it before anything else.

Get Inventory [Secondary]Recommended

Price and quantity updates only - no product content. A lightweight feed for faster stock accuracy between Primary runs. Run more frequently than Primary (every 1-4 hours) when the supplier supports it.

Send Fulfillment RequestsRequired if routing

Transmits orders to the supplier when an order routes to this source. Must be configured and test-transmitted before going live - required if you route orders to this source.

Get ShipmentsRequired if routing

Pulls tracking numbers and shipment updates back from the supplier into Flxpoint, which then syncs tracking to the originating channel. Required if you route orders to this source.

Get InvoicesOptional

Retrieves supplier invoices for processed fulfillment requests - used for cost reconciliation and accounting sync. For suppliers that provide invoice data electronically.

Get Inventory ImagesOptional

Retrieves product images from a separate FTP or ZIP file using a standard naming convention, independent of the main product feed. Use when the supplier delivers images separately from product data.


After running Get Inventory [Primary], all imported data appears in Products → Source Inventory. Validate before building your product catalog - bad data here propagates into published listings.

ViewUse for
Parents viewConfirming parent-level product data, category mapping, and image presence. Check that record count looks reasonable relative to the supplier's stated catalog size.
Variants viewSpot-checking individual SKU costs, quantities, and pricing. Confirm variants nest under the right parents - no floating variants without a parent.
Spot-check 5-10 SKUs across different product types, price ranges, and quantity states. Confirm: SKU uniqueness, title and brand accuracy, image presence, cost alignment with supplier agreement, and correct parent/variant relationships. Fix issues in the mapping template before building the catalog.

Unclear source names make routing rules, reports, and troubleshooting significantly harder once you have more than a handful of sources. Recommended format: [Supplier Name] - [Type] - [Region/Warehouse]

Example nameWhy it works
RSR - Vendor Warehouse - USSupplier, connection type, and region all visible at a glance in routing rules
Keystone - Dropship - EastDistinguishes from a potential West warehouse without ambiguity
ACME - CSV Feed - DailyFeed type and frequency help identify why the source updates differently from API sources
Internal WH - Chicago - ILMakes clear this is not a dropship supplier - routing rules can target it separately

Get Inventory runs successfully but no inventory appears in Source Inventory
Two causes: (1) The job ran but imported 0 items - check the job log for a record count and review any Do Not Import rules or filters on this source. (2) Mapping template column headers don't match the supplier's feed headers - open the template and compare against the raw file. A single mismatched header silently skips that field for every record.
Inventory quantities completely wrong or all showing as 0
First check whether the supplier's service is down - if multiple sources from the same supplier (e.g. Keystone, Seawide) all show wrong quantities simultaneously, it's a supplier-side outage, not a configuration issue. If only one source is affected, check the job log for the specific error and confirm the Quantity field is correctly mapped and not being overridden by a Do Not Import rule.
Source integration suddenly failing after working correctly
Most likely a credential change - the supplier rotated their API key, changed their password, or an OAuth token expired. Re-enter or re-authenticate credentials in the source connection settings. For SFTP sources, also check whether the supplier changed the file path, naming convention, or stopped placing files. The job log error (401 Unauthorized, connection refused, no new feed found) will identify the cause.
SKUs or MPNs changed unexpectedly after a Get Inventory run
The mapping template has a field targeting the wrong column - commonly a date or description field overwriting the SKU or MPN. Open the mapping template and check every row targeting SKU, MPN, or any identifier field. Also check whether a product builder rule is modifying these fields post-import.
Orders routing to this source but supplier says they're not receiving them
Check the fulfillment request status in Flxpoint. If it shows Unprocessed, auto-processing is not enabled - go to Sources → [Source] → Workflows → Source Fulfillment Request Strategy → Override: Auto Processing and enable it. If the FR shows Processed or Acknowledged, open the FR log for the transmission timestamp and confirmation ID and share that with the supplier as proof of delivery.
Inventory on channels is higher than the supplier's actual available stock
Two possible causes: (1) No inventory buffer is configured, or the buffer is too low for this supplier's sell-through velocity - go to Sources → [Source] → Settings and enable Commit stock before it syncs to channels; the right buffer size depends on the supplier's sell-through velocity and feed update frequency. (2) The Get Inventory [Primary] or [Secondary] job isn't pulling the correct quantity from the source - check the job log against the supplier's actual feed. If the quantity Flxpoint imports is already wrong, no buffer will fix it; the mapping or feed itself needs correcting.

When should I use Get Inventory Primary vs Secondary?
Use Primary for full product content imports - titles, images, descriptions, cost, and initial quantity. Run it daily or less frequently since it processes the full feed. Use Secondary for price and quantity updates only - lightweight, run every 1-4 hours for near-real-time stock accuracy. If the supplier only provides one feed, use Primary for everything at whatever frequency their data updates.
Can I add the same supplier as multiple sources?
Yes - and it's common. A supplier might provide a full product feed (one source), a separate lightweight pricing feed (second source using Secondary), and a second warehouse location (third source). Separate sources per feed type or warehouse give cleaner routing control and more precise per-node reporting.
What happens when a supplier like Sports South or RSR goes down?
All Flxpoint accounts using that integration are affected simultaneously - Get Inventory, Send FRs, and Get Shipments jobs fail with authentication or connection errors. Nothing in Flxpoint configuration needs to change during an outage. Jobs resume automatically once the supplier restores service. Check the supplier's status page and expect queued jobs to reprocess once connectivity returns.
What's the right inventory buffer size?
It depends on two factors: how fast the supplier sells through stock, and how often they update their feed. A supplier updating every 4 hours with fast-moving products needs a larger buffer (5+ units) than one updating hourly with slow-moving items (1-2 units). Start conservative, monitor for oversells in the first two weeks, and adjust upward if needed.
Is vendor assignment required when adding a source?
No, but recommended. Assigning a vendor enables supplier-level reporting, cleaner segmentation across multiple sources from the same company, and Vendor Portal access for suppliers who manage their own shipment confirmations. Skipping it doesn't break functionality but reduces visibility as you scale.
© 2026 Flxpoint. All rights reserved.