U.S Direct can be used as a source in Flxpoint to import products and automate inventory updates, pricing, and order fulfillment. By integrating with U.S Direct, you can sync their product catalog, manage supplier feeds, retrieve invoices, and streamline dropshipping operations directly from your Flxpoint account.
Add Source and Establish Connection
📋 Phase 1: Creating Your U.S Direct Source
+
Create Source in Flxpoint
Log into your Flxpoint account, navigate to the Sources tab, and click + Add Source to begin.
Set Up Source Details
Enter "U.S Direct Supplier" as the source name, select the appropriate source type (e.g., Vendor Warehouse), and choose whether to assign a vendor (recommended for better reporting). Click Save & Next to continue.
Tip: Assigning a vendor improves your reporting capabilities and helps with product organization.
Choose Integration Type
After creating your source, you'll see the Integrations section. If no integrations are set up yet, click Start Creating Integrations. You can set up any of these integrations based on your needs:
- Get Inventory (Primary): Retrieves primary inventory data from U.S Direct.
- Get Inventory (Secondary): Sets up an additional inventory feed from U.S Direct.
- Send Fulfillment Requests: Sends orders to U.S Direct for fulfillment.
- Get Shipments: Pulls shipment information from U.S Direct.
- Get Invoice: Retrieves invoice data for your orders from U.S Direct.
Note: You can activate any combination of these integrations based on your business needs.
🔐 Phase 2: Setting Up Connection
+
Obtain Your Connection Credentials
To connect to U.S Direct, you'll need the required credentials (e.g., API Token, Reseller Token, Feed URL). Follow these steps to obtain them:
- Log into your U.S Direct account using your credentials.
- Navigate to the appropriate section (e.g., Account Dashboard, Settings, API Access, or Integrations) where connection credentials are managed.
- Look for an option to generate or view your credentials. This might be labeled as Generate API Key, FTP Credentials, or similar.
- Copy the credentials and store them securely, as you'll need to enter them in the next step.
- If you can't find the credentials, contact U.S Direct support for assistance.
Important: Keep your credentials secure and do not share them publicly, as they provide access to your U.S Direct account data.
Configure Connection Details
In the New U.S Direct Connection form, enter the details required to connect to U.S Direct:
- Connection Name: "U.S Direct Connection" (or any descriptive name).
- API Token: Provided by U.S Direct for authentication.
- Reseller Token: Configured on the U.S Direct connection card and used by the Get Invoice operation to retrieve invoice data.
- Feed URL: You can request a Feed URL from our support team at support@flxpoint.com.
Tip: If the connection test fails, double-check your credentials and ensure your U.S Direct account is configured for integration access.
🛒 Phase 3: Setting Up Order Processing
+
Configure Order Processing Integrations
For Send Fulfillment Requests and Get Shipments integrations, use the connection you created in Phase 2:
- Send Fulfillment Requests: Enable to send orders to U.S Direct for fulfillment. Map order fields (e.g., Customer Name, Shipping Address) to ensure accurate order transmission.
- Get Shipments: Enable to retrieve shipment updates from U.S Direct. Map shipment fields (e.g., Tracking Number, Shipment Date) to Flxpoint fields.
Automated Order Settings
Configure how orders will be processed:
- Toggle Automatically Send Orders ON to have Flxpoint automatically send orders to U.S Direct.
- Set any additional order rules or conditions as needed (e.g., minimum order quantity, specific product categories).
✅ Phase 4: Mapping and Activation
+
Create Field Mapping
After setting up your connection, you'll need to map U.S Direct fields to Flxpoint fields for Get Inventory (Primary) and Get Inventory (Secondary):
- Choose an existing mapping template or create a new one.
- Map essential fields like SKU, Price, Quantity, and Description.
- Set up any transformations needed (e.g., price markups, quantity adjustments).
Tip: For inventory feeds, make sure to map both product details and inventory quantity fields.
Configure SKU Mapping
In the Master SKU section, set up your preferred SKU mapping (Inventory SKU → Master SKU). Consider adding a SKU prefix (e.g., "USD-") to identify U.S Direct inventory in your system.
Activate and Verify
Complete the setup by clicking Save and Complete. Your U.S Direct integration is now active and will run based on your settings.
Next Steps: The initial inventory sync may take some time to complete. You can monitor the progress in the Integrations section of your Flxpoint dashboard under Fulfillment Sources.
Next
Configure Product & Order Operations 🚀
Now that your U.S Direct connection is saved, go to the
Operations sections of this doc to set up the
integrations you need: Get Inventory (Primary) and
Get Inventory (Secondary) for catalog & pricing,
Send Fulfillment Requests for orders,
Get Shipments for tracking, and
Get Invoice for invoice data.
Product Operations
Get Inventory (Primary)
Introduction
The Get Inventory (Primary) integration enables you to automatically fetch and sync inventory data from your U.S Direct source to Flxpoint. This integration helps you maintain up-to-date inventory information across your systems, keeping product listings and stock levels current.
The sections below walk through each step of the setup and configuration process.
Purpose: The Get Inventory (Primary) integration ensures accurate and real-time synchronization of inventory data — it automatically pulls inventory data from U.S Direct into Flxpoint, eliminates manual updates by syncing on a schedule, and ensures your system always reflects current stock levels for all items.
Configure the integration based on your requirements:
- Connection Settings: Choose the connection to your U.S Direct integration.
- Inventory Sync Frequency: Set the frequency of inventory sync (e.g., daily, weekly).
- Mapping Template: Define how Flxpoint fields map to U.S Direct data.
Follow these steps to configure the integration:
- 1Connect an Integration: Choose your connection settings and authenticate with U.S Direct.
- 2Configure Sync Frequency: Set how often inventory should be synced.
- 3Create a Mapping Template: Map the necessary fields between U.S Direct and Flxpoint for accurate data transfer.
- 4Run the Integration: Manually or automatically run the integration to start syncing your inventory data.
Recommended Mapping
The Mapping Template is where you define how U.S Direct inventory fields map to Flxpoint.
| Field | Maps To | Example | Status |
|---|---|---|---|
| Product SKU | Flxpoint SKU | 12345 |
Required |
| Product Name | Flxpoint Product Name | Widget |
Required |
Tip: Map both product details and inventory quantity fields so your listings and stock levels stay accurate.
Troubleshooting
- API Connection Issues: Verify your API credentials and network connectivity.
- Sync Errors: Check the mapping template for any mismatches between U.S Direct and Flxpoint fields.
- Data Sync Delays: Ensure the sync schedule is correctly configured and check for any delays in the U.S Direct feed.
Summary: The Get Inventory (Primary) integration simplifies keeping your inventory up to date with real-time data from U.S Direct. By mapping key fields and configuring sync frequency, you can ensure accurate stock levels and streamlined inventory management.
Get Inventory (Secondary)
Introduction
The Get Inventory (Secondary) integration allows you to retrieve inventory data from U.S Direct and sync it with your Flxpoint system. This integration ensures your product data, including stock levels, item details, and variants, is updated and available for fulfillment and sales.
Use it alongside Get Inventory (Primary) for more detailed control, such as focusing on specific products or updates.
Purpose: This integration enables you to retrieve inventory data from U.S Direct (ensuring up-to-date stock information), map U.S Direct inventory fields (like SKU, quantity, and description) to Flxpoint for consistent and reliable data, and automate the sync process to reduce manual updates and prevent inventory discrepancies.
How the Integration Works
- Data Extraction: Retrieves inventory data from U.S Direct, including SKU, quantity, description, and variants.
- Field Mapping: Maps data from U.S Direct to Flxpoint's inventory fields, ensuring compatibility between systems.
- Sync Process: Updates your Flxpoint inventory with the data from U.S Direct on a schedule or manually.
Configuration Options
- Connection Settings: Provide your U.S Direct credentials to establish the connection.
- Sync Frequency: Decide whether to run the integration manually or on a set schedule (e.g., daily).
- Data Mapping: Customize which fields in U.S Direct correspond to fields in Flxpoint, ensuring accurate inventory updates.
Setup Instructions
- 1Enter your U.S Direct credentials.
- 2Configure your sync frequency (manual or scheduled).
- 3Set up your data mappings to ensure accurate inventory syncing.
- 4Test the connection to ensure successful integration.
Recommended Mapping
Below is an example of how to map fields from U.S Direct to Flxpoint:
| Field | Maps To | Example | Purpose |
|---|---|---|---|
| SKU | Flxpoint SKU | ZND12345 |
Identifies the product in Flxpoint |
| Quantity | Flxpoint Quantity | 10 |
Shows available inventory |
| Description | Flxpoint Description | Item Description |
Describes the product |
Troubleshooting
- Connection Error: Double-check your API credentials.
- Sync Not Working: Verify that the mapping fields are correct and compatible.
- Data Missing: Ensure that U.S Direct is sending the required data fields.
Key Details You Need to Know
- API Limits: Be aware of any API rate limits imposed by U.S Direct.
- Data Mapping: Review mappings to ensure that inventory data is correctly linked.
Order Operations
Send Fulfillment Requests
Introduction
The Send Fulfillment Requests integration automates the process of sending purchase orders (POs) to U.S Direct for fulfillment. It converts fulfillment requests from Flxpoint into the required format for U.S Direct and submits them through the configured connection.
It submits orders to vendors for fulfillment, ensuring a seamless integration between order processing and downstream shipment tracking.
Purpose: The integration helps automate sending purchase orders to U.S Direct, mapping fields like shipping addresses, item details, and shipping methods. It automates purchase orders (sends them using fulfillment request data), maps Flxpoint data to U.S Direct's required fields, and delivers purchase orders through the connection for processing.
How the Integration Works
- Data Extraction: Pulls data from Flxpoint, including shipping details and items.
- Field Mapping: Maps data to U.S Direct's purchase order format.
- Order Delivery: Submits purchase orders to U.S Direct for processing.
Setup Instructions
- 1Set up the connection with U.S Direct.
- 2Define mapping rules and configure delivery options.
- 3Test the connection and save the setup.
Recommended Mapping
Below is a mapping example for the fields from Flxpoint to U.S Direct:
| Flxpoint Field | U.S Direct Field | Example | Status |
|---|---|---|---|
| Fulfillment Request Number | PO Number | FR12345 |
Required |
| Shipping Address: Address Line 1 | Ship To Address1 | 123 Main St |
Required |
| Fulfillment Request Item: SKU | Item Number | ZND12345 |
Required |
Configuration Options
Customize your configuration to suit your needs. You can define connection settings, set delivery rules, and specify custom mapping rules.
Troubleshooting
- Order not submitting: Confirm the U.S Direct connection passes Test Connection and that required fields (PO Number, Ship To Address, Item Number) are mapped and supply non-empty values.
- Field mapping errors: Audit your mapping template to verify each required field maps to a correctly formatted value for every order.
Tip: Run a single order manually first to verify the submission before enabling automatic order sending.
Get Shipments
Introduction
The Get Shipments integration allows you to retrieve shipment tracking information, status updates, and item details from U.S Direct and sync them with your Flxpoint system. This keeps your order fulfillment system up to date with the latest shipment statuses.
Purpose: This integration enables you to retrieve shipment data including tracking numbers, shipping status, and item details; map U.S Direct shipment fields (like tracking number, status, etc.) to Flxpoint for easy reference and updates; and automate the syncing process so your order fulfillment system stays current.
How the Integration Works
- Data Extraction: Retrieves shipment data from U.S Direct, including tracking numbers, shipping status, and associated items.
- Field Mapping: Maps data from U.S Direct to Flxpoint's shipment fields, ensuring compatibility between systems.
- Sync Process: Updates your Flxpoint system with the latest shipment data, either manually or on a schedule.
Configuration Options
- Connection Settings: Provide your U.S Direct credentials to establish the connection.
- Sync Frequency: Decide whether to run the integration manually or on a set schedule (e.g., daily).
- Data Mapping: Customize which fields in U.S Direct correspond to fields in Flxpoint for accurate syncing.
Setup Instructions
- 1Enter your U.S Direct credentials.
- 2Set up your sync schedule (manual or automated).
- 3Map the necessary shipment fields between U.S Direct and Flxpoint.
- 4Test the connection to ensure the integration works smoothly.
Recommended Mapping
Below is an example of how to map fields from U.S Direct to Flxpoint:
| Field | Maps To | Example | Purpose |
|---|---|---|---|
| Tracking Number | Flxpoint Tracking Number | 1Z9999W99999999999 |
Unique identifier for the shipment |
| Shipment Status | Flxpoint Shipment Status | In Transit |
Current state of the shipment |
| Shipping Date | Flxpoint Shipping Date | 2025-08-14 |
Date the shipment was sent |
Shipping Code Examples
Below are examples of shipping codes to be mapped from U.S Direct:
Example 1: UPS Ground Shipping
Carrier: UPS | Shipping Code: UPS-GND | Description: Ground Shipping
Example 2: FedEx Express Shipping
Carrier: FedEx | Shipping Code: FEDEX-EXP | Description: Express Shipping
Example 3: USPS Priority Shipping
Carrier: USPS | Shipping Code: USPS-PRIORITY | Description: Priority Mail
Troubleshooting
- Connection Error: Double-check your API credentials.
- Sync Not Working: Ensure that the mapping fields are correct.
- Data Missing: Ensure U.S Direct is sending the required data fields.
Key Details You Need to Know
- API Limits: Ensure you do not exceed the API limits set by U.S Direct.
- Field Mapping: Verify that fields are mapped correctly to ensure proper syncing.
Get Invoice
Introduction
The Get Invoice operation retrieves invoice data for your U.S Direct orders into Flxpoint. Flxpoint retrieves invoice data for the order using your Flx PO / Order Number, then parses and maps the invoice response so you can keep invoice details in sync with your order records.
This operation uses the existing U.S Direct connection card — the same card that holds your Reseller Token — and maps the fetched data with the Source Invoice Mapping Template.
Reseller Token: Invoice retrieval uses the existing U.S Direct Integration connection card, which already contains the Reseller Token configuration. No separate connection is required — the same connection used for your other U.S Direct operations is reused for Get Invoice.
Each run follows this workflow:
- 1Select Connection — Choose your existing U.S Direct connection (the card that holds your Reseller Token).
- 2Fetch Invoice Data — Flxpoint retrieves invoice data for the order using your Flx PO / Order Number.
- 3Map Fields — The fetched invoice response is parsed and matched to your Source Invoice Mapping Template.
- 4Save & Schedule — Run manually first to verify, then enable a schedule to keep invoice data current.
How orders are referenced: When orders are pulled into the Order Manager from the integration, the Flx PO Number is stored as the Channel Order Number. A corresponding order is created in the U.S Direct account, where the Flx Order Number is set as the Channel Reference Number (i.e., the Flx PO Number). Get Invoice then fetches invoice details based on that Flx PO / Order Number.
Map Invoice Data with the Source Invoice Mapping Template
Map the fetched invoice data using the Source Invoice Mapping Template. You'll find it under Settings > Mapping Templates. Select or create a Source Invoice template, then map the invoice fields returned for the order to the corresponding Flxpoint fields.
| Field | Maps To | Example | Purpose |
|---|---|---|---|
| Flx PO / Order Number | Channel Order Number | 54007-1 |
References the order whose invoice is retrieved |
| Invoice Number | Flxpoint Invoice Number | INV-10293 |
Identifies the invoice |
| Invoice Total | Flxpoint Invoice Total | 129.95 |
Total amount billed for the order |
Tip: The Source Invoice Mapping Template lets you map the invoice response fields to Flxpoint. Adjust the mapped fields to match the invoice details you want to store against each order.
Quick Checks
- The U.S Direct connection card has a valid Reseller Token and passes Test Connection.
- The order exists in Order Manager with its Flx PO Number stored as the Channel Order Number.
- A Source Invoice mapping template is selected under Settings > Mapping Templates.
Troubleshooting
- Invoices not pulling: Confirm the Reseller Token is configured on the U.S Direct connection card and that the order's Flx PO / Order Number matches the order you expect an invoice for.
- Invoice data not mapping: Open your Source Invoice Mapping Template under Settings > Mapping Templates and confirm the invoice fields are mapped to the correct Flxpoint fields.
Expected behavior: During retrieval, Flxpoint fetches invoice details for the order using the Flx PO / Order Number, then parses and maps the response per your Source Invoice Mapping Template. After retrieval, the mapped invoice data is available against the matching order.
Troubleshooting
Common issues and solutions for the U.S Direct integration. Expand each item to learn more.
What's happening
The U.S Direct connection is not authenticating or Test Connection returns an error.
- The API Token may be incorrect, expired, or rotated by U.S Direct.
- Your U.S Direct account may not yet have integration access enabled.
How to fix it
- Open the U.S Direct connection and click Test Connection. If it fails, double-check your credentials and paste a fresh API Token, then retry.
- Confirm your U.S Direct account is configured for integration access. If credentials worked before but now fail, contact U.S Direct support to confirm access is still active.
What's happening
Get Inventory (Primary or Secondary) is not importing data, or specific fields are missing from the import.
- The U.S Direct connection may not be passing Test Connection.
- The mapping template may have mismatches between U.S Direct and Flxpoint fields.
- The sync schedule may not be configured, or the U.S Direct feed may be delayed.
How to fix it
- Verify your API credentials and network connectivity.
- Check the mapping template for any field mismatches and confirm the required fields are mapped.
- Ensure the sync schedule is correctly configured and that U.S Direct is sending the required data fields.
What's happening
Send Fulfillment Requests fails to submit a purchase order to U.S Direct.
- A required field (PO Number, Ship To Address, Item Number) may be missing or invalid.
- The connection may not be passing Test Connection.
How to fix it
- Audit your mapping template to confirm every required field maps to a non-empty, correctly formatted value for each order.
- Confirm the U.S Direct connection passes Test Connection, then resubmit the order.
What's happening
Recent orders show no tracking updates, or shipment data is missing.
- The U.S Direct connection may not be authenticating.
- Tracking Number, Shipment Status, or Shipping Date may not be mapped in the template.
- U.S Direct may not be sending the required data fields.
How to fix it
- Click Test Connection on the U.S Direct connection and double-check your API credentials.
- Open the Get Shipments template and confirm the shipment fields are mapped correctly.
- Confirm U.S Direct is sending the required shipment data fields.
What's happening
Get Invoice is not retrieving invoice data, or the retrieved invoice is not mapping into Flxpoint.
- The Reseller Token may not be configured on the U.S Direct connection card.
- The order's Flx PO / Order Number may not match the order you expect an invoice for.
- A Source Invoice mapping template may not be selected, or its fields may be mapped incorrectly.
How to fix it
- Confirm the Reseller Token is configured on the existing U.S Direct connection card.
- Verify the order exists in Order Manager with its Flx PO Number stored as the Channel Order Number, and that Get Invoice references that Flx PO / Order Number.
- Open your Source Invoice Mapping Template under Settings > Mapping Templates and confirm the invoice fields are mapped to the correct Flxpoint fields.
Still need help? If you're experiencing issues not covered here, contact U.S Direct or your Flxpoint account manager.
Contact Support