Shopify is a popular eCommerce platform that allows businesses to manage online stores. Integrating Shopify as a source in Flxpoint enables the seamless synchronization of products, inventory, and orders between the two platforms. This integration helps streamline order processing, product listings, and inventory updates, ensuring that your Shopify store is always in sync with your Flxpoint account.
How to connect
📋 Phase 1: Initial Channel Setup
+
Access Sales Channels
Log in to your Flxpoint account and navigate to the Sales Channels section.
Create a New Channel
Click "+" to Create Channel.
Tip: Have your Shopify store URL ready for the connection process.
Select Shopify and Name Channel
In the Channel Setup screen:
- Search for Shopify and select it.
- Enter a descriptive Channel Name (e.g., "Shopify Store").
- Click Save to continue.
Start the Integration Process
After creating the channel, you’ll see "No integrations created yet." Click Get Started to launch the setup wizard.

🔐 Phase 2: Authentication & Connection
+
Recommended: Connect via OAuth2 when you can log into the Shopify store (store owner/admin present).
Vendors: If you don’t have access to authorize OAuth2, use a Custom App and share credentials (API Key/Secret + Admin API token) following the Vendor’s Guide to Shopify Custom App.
If the connection later loses permissions, see Shopify Re-authentication (OAuth).
Select the Integration Type
In the Connect to Your Shopify Store section, select API - Shopify App (OAuth2) for secure authorization, or choose API - Bearer Token or API - Basic Auth for manual credential entry.
Heads-up for vendors: If OAuth2 isn’t possible, pick Bearer Token or Basic Auth, then create a Custom App per the Vendor’s Guide.
Connect Your Account
For OAuth2:
- Enter your Store URL (e.g., https://your-store-name.myshopify.com).
- Click Initiate OAuth2 Flow and follow prompts to grant access.
- In Shopify Admin: Settings > Apps and sales channels > Develop apps.
- Create and install your app, then generate the Admin API access token.
- Copy API Key, API Secret Key, and Admin API access token.
- Follow the steps in the Vendor’s Guide to Shopify Custom App.
Important: Use the .myshopify.com URL (e.g., https://cool-gadgets.myshopify.com), not your custom domain.
Authorize Access
For OAuth2, no further credentials are needed after authorization. For Bearer Token or Basic Auth:
- Set a Connection Name (e.g., "Shopify Connection #1").
- For Bearer Token, paste the Admin API access token into the Token field.
- For Basic Auth, enter the API Key and API Secret Key.
- Input your Store URL.
- Click Test Connection and then Continue if successful.
Troubleshooting: If you see 401/403 or permission errors, re-authorize using Shopify Re-authentication (OAuth).
Verify Connection
Review connection details in the Flxpoint setup screen to ensure accuracy, then proceed.
Shopify API Rate Limits: See Shopify API Rate Limits.
- REST API: 2 requests/sec (4/sec for Plus).
- GraphQL: 50 points/sec.
🔄 Phase 3: SKU Mapping & Configuration
+
Set Up SKU Mapping
Configure Import Listings to align with your inventory:
- Set new listings to Paused for review before publishing.
- Map your internal Master SKU to Shopify’s listing SKU.
Pro Tip: Use consistent SKU naming (e.g., "PROD-123" internally and "SHOP-PROD-123" on Shopify) for easier inventory management.
Configure Integration Settings
Set up automated features:
- Publish Listings: Map categories to global IDs from Shopify Product Taxonomy and review options like “Truncate Title to 255”.
- Order Sync: Select statuses (e.g., Open) and time range for Get Orders. Orders with or without a Location ID are saved unless disabled in Advance Config.
- TikTok Shop (Optional): Install a TikTok Shop app in Shopify, connect your store, and verify listings can be published via Flxpoint.
Note: TikTok Shop integration is optional and only needed if selling on that platform.
Complete Setup
Review settings and click Confirm & Finish. In Sales Channels, start Import Listings, Get Orders, and check Sync and Link Listings and Publish Listings.
Final checklist:
- Verify store URL uses .myshopify.com (not a custom domain).
- Confirm Location ID behavior matches your fulfillment setup.
- If permissions lapse, re-authorize via Shopify Re-authentication (OAuth).
- Vendors sharing access? Point them to the Vendor’s Guide to Shopify Custom App.
×
Product Operations
Get Inventory (Primary)
Supported | Shopify - Get Inventory (Primary)
Introduction to Shopify Get Inventory (Primary)
This integration retrieves inventory from Shopify into Flxpoint for a specific location, syncing product/variant quantities to the Global Inventory Pool (GIP).
The Shopify Get Inventory (Primary) integration enables you to:
- Fetch product and variant inventory for a selected Shopify Location ID.
- Sync quantities into Flxpoint’s Global Inventory Pool (GIP).
- Support multi-location workflows (one job per Location ID).
- Map Shopify fields to Flxpoint inventory fields.
The integration follows these steps:
- 1 Connect: OAuth2 connection to your Shopify store.
-
2 Pull Products: Collect products/variants and their
inventory_item_id
s. - 3 Pull Inventory Levels: Retrieve inventory levels for the configured Location ID.
- 4 Map & Save: Apply your mapping template and save quantities to GIP.
Tip: Each job targets one Location ID. Use multiple jobs to cover multiple Shopify locations.
Configure the job with:
- Connection: Select your Shopify OAuth connection.
- Location ID: Required. Choose the Shopify location to pull from.
- Mapping Template: Map Shopify fields (SKU, Quantity, etc.) to Flxpoint fields.
- Sync Frequency: Manual or scheduled (hourly maximum cadence).
Advanced Config
NEW (Oct 2025) — Force Full Inventory Fetch
When enabled, the job pulls inventory for all products/variants at the selected Location ID, regardless of Shopify’s last updated time. Use this to normalize inventory after large imports or when variants haven’t changed recently in Shopify.
When enabled, the job pulls inventory for all products/variants at the selected Location ID, regardless of Shopify’s last updated time. Use this to normalize inventory after large imports or when variants haven’t changed recently in Shopify.
- When to use: Newly imported products show blank/old quantities; mixed sources (e.g., CSV/XLSX to create products + Shopify to fill stock).
- Effects: Longer runs and increased API usage; recommended for targeted/temporary use.
- How to enable: Integration → Advanced Config → toggle Force Full Inventory Fetch → Save & Run.
Important: Jobs cannot run more than once per hour.
- 1 Add Integration: Channels > Shopify > Integrations > “Get Inventory (Primary)”.
- 2 Connect: Choose or create your OAuth connection.
- 3 Configure: Set Location ID and schedule (hourly max).
- 4 Map: Ensure SKU and Quantity are mapped.
- 5 Advanced (optional): Enable Force Full Inventory Fetch when you need a complete refresh.
- 6 Run: Click Run Sync or wait for schedule.
Scenario: You imported products via a file (CSV/XLSX) and their quantities are blank in Flxpoint. You want Shopify to fill the stock even if Shopify hasn’t changed those variants recently.
Steps:
Steps:
- Verify your product variants in Shopify have SKUs and correct on-hand quantities.
- In Flxpoint, ensure your mapping includes Variant SKU → SKU and Available → Quantity.
- Open Get Inventory (Primary) → Advanced Config → enable Force Full Inventory Fetch.
- Run the job. All variant quantities for the chosen Location ID are saved to GIP.
- (Optional) Disable the toggle after normalization so future runs use standard incremental updates.
Inventory not updating for “unchanged” variants
Why: Standard runs focus on recently updated items in Shopify.
Fix: Temporarily enable Force Full Inventory Fetch to pull the complete catalog for your Location ID, then return to incremental mode.
Fix: Temporarily enable Force Full Inventory Fetch to pull the complete catalog for your Location ID, then return to incremental mode.
Duplicate Metafield Warning (informational)
"duplicate rating_count product metafield found, values 0"
This is informational and does not block inventory saves.
“Failed to map variant(s), skipping Shopify Product”
"Failed to map variant(s), skipping Shopify Product"
Likely cause: Variant SKU is missing or not mapped.
Fix: Ensure every variant has a SKU and map Variant SKU → SKU and Available → Quantity.
Fix: Ensure every variant has a SKU and map Variant SKU → SKU and Available → Quantity.
- Single Location per job.
- SKU required for inventory saves.
- API rate limits may extend runtime on large catalogs.
- Hourly maximum cadence for GIP jobs.
- Force Full Inventory Fetch increases run time and API usage; use purposefully.
- Required: Map SKU and Quantity.
- NEW: Force Full Inventory Fetch (Oct 2025) for full-catalog refreshes.
- Best practice: Use the toggle to normalize, then revert to incremental.
Conclusion
Use Force Full Inventory Fetch when you need a full refresh; otherwise rely on incremental updates for speed and API efficiency.
Get Inventory (Secondary)
Supported | Shopify - Get Inventory (Secondary)
Introduction to Shopify Get Inventory (Secondary)
This integration updates variant-level inventory details (e.g., quantities, cost/pricing fields) for a specific Shopify Location ID. It complements Get Inventory (Primary).
- Fetch variant-level inventory updates for a Location ID.
- Update quantities, costs, and pricing fields in Flxpoint GIP.
- Support multi-location (one job per Location ID).
- Map Shopify variant fields to Flxpoint inventory fields.
- 1 Connect via OAuth2.
-
2 Collect product variants and their
inventory_item_id
s. - 3 Pull inventory levels for the configured Location ID.
- 4 Map fields and save to GIP.
Tip: Run Secondary after Primary (especially if Primary used Force Full Inventory Fetch) to apply any variant-level cost/pricing updates.
- Connection: Select your Shopify OAuth connection.
- Location ID: Required.
- Mapping Template: Map variant fields (SKU, Quantity, Cost, MAP, MSRP, etc.).
- Sync Frequency: Manual or scheduled (coordinate with Primary to avoid overlapping long runs).
Coordination with Primary: If Primary has Force Full Inventory Fetch enabled, schedule Secondary to run afterward to leverage the refreshed baseline quantities.
Mapping templates control how variant inventory data is saved in Flxpoint.
Required Mapping
- Variant SKU → SKU (required)
- Available → Quantity (required)
Common Fields
Shopify Field | Maps To | Type | Example | Status |
---|---|---|---|---|
Variant – SKU | SKU | Text | variant-sku-001 | Required |
Variant – Available | Quantity | Number | 50 | Required |
Variant – Cost | Cost | Number | 20 | Supported |
Variant – Compare At Price | MAP / MSRP | Number | 45 / 50 | Supported |
Variant – Title | Custom Field | Text | Blue T-Shirt - M | Optional |
Scenario: Primary ran with Force Full Inventory Fetch at 02:00 to refresh all quantities.
Recommendation: Schedule Secondary at 03:00 to apply variant cost/pricing updates, ensuring it uses the refreshed quantities from Primary.
Recommendation: Schedule Secondary at 03:00 to apply variant cost/pricing updates, ensuring it uses the refreshed quantities from Primary.
- No updates: Verify Location ID and required SKU/Quantity mappings.
- Missing variants: Ensure Shopify variants have SKUs.
- API errors: Reduce frequency or stagger with Primary to avoid long overlapping jobs.
Diagnostic Tip: If variants haven’t changed recently and you need a full catch-up, run Primary with Force Full Inventory Fetch first, then run Secondary.
- One Location ID per job.
- SKU required for saves.
- API limits apply; large catalogs may take longer.
- Secondary focuses on variant-level updates; baseline quantities come from Primary.
- Required: Map SKU and Quantity.
- Coordinate: Stagger with Primary (especially if Primary used full fetch).
Conclusion
Schedule Secondary to complement Primary. After a full refresh in Primary, Secondary can apply cost/pricing updates on top of the newly synchronized quantities.
Order Operations
Send Fulfillment Requests
Supported | Shopify - Send Fulfillment Requests
Introduction to Shopify Send Fulfillment Requests
Welcome to the Shopify Send Fulfillment Requests integration guide! This integration allows Flxpoint to send fulfillment requests to Shopify, enabling Shopify to process and fulfill orders with accurate details such as billing/shipping addresses, line items, and order notes. It ensures seamless communication between Flxpoint and Shopify for efficient order fulfillment across your sales channels. Let’s get started!
The Shopify Send Fulfillment Requests integration enables you to:
- Send fulfillment requests from Flxpoint to Shopify for order processing.
- Include detailed order information such as billing/shipping addresses, line items, and order notes.
- Support multi-location fulfillment by specifying the correct Shopify Location ID.
- Map Flxpoint order data to Shopify fields for accurate fulfillment request creation.
The integration follows these steps:
- 1 Connecting to Shopify: Establish a connection using OAuth2 authentication to access your Shopify store.
- 2 Preparing Order Data: Flxpoint gathers order details, including billing/shipping addresses, line items, and fulfillment request information.
- 3 Mapping Data: Maps Flxpoint order data to Shopify fields (e.g., Billing Address, Line Items) using a mapping template.
-
4 Sending Fulfillment Request: A POST request to
/admin/api/{version}/fulfillment_requests.json
sends the fulfillment request for a specified order ID to Shopify. - 5 Specifying Location: Includes the Shopify Location ID to ensure the request is routed to the correct fulfillment location.
- 6 Confirmation: Shopify processes the fulfillment request, and Flxpoint logs the request status for tracking.
Pro Tip: Ensure accurate mapping of billing and shipping addresses to avoid fulfillment delays.
Note: The integration requires an existing order in Shopify; ensure orders are imported via Shopify Get Orders integration first.
Customize the integration with these settings:
- Connection: Select your Shopify OAuth connection (e.g., “Shopify Connection API - Shopify App (OAuth2)”).
- Location ID: Specify the Shopify inventory location ID for routing fulfillment requests (required).
- Mapping Template: Define how Flxpoint order data maps to Shopify fields (see Mapping Template Details).
- Sync Frequency: Run manually or schedule syncs (e.g., hourly to process new orders).
Note: Verify the Location ID in Shopify to ensure fulfillment requests are sent to the correct location.
Follow these steps:
- 1 Add the Integration: Go to Channels > Shopify > Integrations, select “Send Fulfillment Requests.”
- 2 Connect to Shopify: Select an existing Shopify OAuth connection or set up a new one.
-
3 Configure Settings:
- Specify the Location ID for fulfillment routing.
- Configure sync frequency (e.g., hourly).
- 4 Create Mapping Template: Configure field mappings for order data (see Mapping Template Details).
- 5 Run the Integration: Start with Run Sync or schedule automatic syncs.
Mapping templates control how Flxpoint order data is sent to Shopify for fulfillment requests.
Interface Overview
- Screen labeled “Send Fulfillment Requests” at the top; name your template (e.g., “Shopify Send Fulfillment Requests 1”).
- Buttons: Delete, Duplicate, Save Mapping.
- Sections: Order Note Attributes, Billing Address, Discount Code, Line Item, Order, Shipping Address.
- Columns: Flxpoint fields (left, e.g., Fulfillment Request Number), Shopify fields (right, e.g., Note).
Mapping Options
- Don't Map: Ignore the field; no data is sent to Shopify.
- Set To Empty: Clear the field in Shopify.
- Field: Map a Flxpoint field to a Shopify field (e.g., Fulfillment Request Quantity to Shopify Line Item Fulfillable Quantity).
- Value: Set a static value (e.g., Note to “Urgent Fulfillment”).
- Mapping Set: Apply a predefined mapping set for complex mappings.
- Rules: Apply conditional logic (e.g., send only if Fulfillment Request Total Cost exceeds $100).
Line Item Mapping Requirement
The Shopify Line Item SKU and Fulfillable Quantity fields must be mapped to ensure proper fulfillment request processing.
- Required Fields: SKU identifies items, and Fulfillable Quantity specifies the quantity to fulfill.
-
Error Scenario: Unmapped SKU or Fulfillable Quantity may cause fulfillment request failures:
Invalid request: Missing required fields 'SKU' or 'Fulfillable Quantity' for fulfillment request
- Fix: Go to Channels > Shopify > Templates > Send Fulfillment Requests > Field Mapping, map Fulfillment Request Item SKU to Shopify Line Item SKU and Fulfillment Request Item Quantity to Shopify Line Item Fulfillable Quantity, save, and re-run sync.
Recommendation: Always map SKU, Fulfillable Quantity, Billing Address, and Shipping Address fields for reliable fulfillment requests.
Complete Field Mappings
Below are the fields you can map from Flxpoint to Shopify, based on the provided mapping template:
Order Note Attributes Fields
Flxpoint Field | Maps To | Data Type | Example | Purpose | Status |
---|---|---|---|---|---|
Custom Fields (2) | Shopify Order Note Attributes - Custom Fields | Text | priority: high | Adds custom attributes to order notes | Supported (Up to 2) |
Billing Address Fields
Flxpoint Field | Maps To | Data Type | Example | Purpose | Status |
---|---|---|---|---|---|
Billing Address - Address Line 1 | Shopify Billing Address - Address 1 | Text | 123 Main St | Sets billing address line 1 | Supported |
Billing Address - Address Line 2 | Shopify Billing Address - Address 2 | Text | Apt 4B | Sets billing address line 2 | Supported |
Billing Address - City | Shopify Billing Address - City | Text | New York | Sets billing city | Supported |
Billing Address - Company Name | Shopify Billing Address - Company | Text | Acme Corp | Sets billing company name | Supported |
Billing Address - Country | Shopify Billing Address - Country | Text | United States | Sets billing country | Supported |
Billing Address - Country Code | Shopify Billing Address - Country Code | Text | US | Sets billing country code | Supported |
Billing Address - Email | Shopify Billing Address - Email | Text | john.doe@example.com | Sets billing email | Supported |
Billing Address - First Name | Shopify Billing Address - Name | Text | John | Sets billing first name | Supported |
Billing Address - Full Name | Shopify Billing Address - Name | Text | John Doe | Sets billing full name | Supported |
Billing Address - Last Name | Shopify Billing Address - Name | Text | Doe | Sets billing last name | Supported |
Billing Address - Phone | Shopify Billing Address - Phone | Text | 555-123-4567 | Sets billing phone number | Supported |
Billing Address - Postal Code | Shopify Billing Address - Zip | Text | 10001 | Sets billing postal code | Supported |
Billing Address - State | Shopify Billing Address - Province | Text | New York | Sets billing state | Supported |
Billing Address - State Code | Shopify Billing Address - Province Code | Text | NY | Sets billing state code | Supported |
Discount Code Fields
Flxpoint Field | Maps To | Data Type | Example | Purpose | Status |
---|---|---|---|---|---|
Channel Invoice - Discount Total | Shopify Discount Code - Amount | Number | $10 | Sets discount amount | Supported |
Channel Invoice - Invoice Number | Shopify Discount Code - Code | Text | DISCOUNT10 | Sets discount code | Supported |
Channel Invoice - Discount Total | Shopify Discount Code - Type | Text | fixed_amount | Sets discount type | Supported |
Line Item Fields
Flxpoint Field | Maps To | Data Type | Example | Purpose | Status |
---|---|---|---|---|---|
Fulfillment Request Item - Subtotal | Shopify Line Item - Price | Number | $30 | Sets line item price | Supported |
Fulfillment Request Item - Quantity | Shopify Line Item - Fulfillable Quantity | Number | 2 | Sets quantity to fulfill | Required |
Fulfillment Request Item - Bin Location | Shopify Line Item - Fulfillment Service | Text | warehouse-1 | Sets fulfillment service | Supported |
Fulfillment Request Item - Quantity | Shopify Line Item - Fulfillment Status | Text | pending | Sets fulfillment status | Supported |
Fulfillment Request Item - Title | Shopify Line Item - Gift Card | Text | false | Indicates if item is a gift card | Supported |
Fulfillment Request Item - PO Line Item # | Shopify Line Item - ID | Number | 1001 | Sets line item ID | Supported |
Fulfillment Request Item - Note | Shopify Line Item - Properties | Text | color: blue | Sets line item properties | Supported |
Fulfillment Request Item - SKU | Shopify Line Item - Product Exists | Text | true | Indicates if product exists | Supported |
Fulfillment Request Item - SKU | Shopify Line Item - Product ID | Text | prod-123 | Sets product ID | Supported |
Fulfillment Request Item - Quantity | Shopify Line Item - Quantity | Number | 2 | Sets total quantity | Supported |
Fulfillment Request Item - Quantity | Shopify Line Item - Requires Shipping | Text | true | Indicates if shipping is required | Supported |
Fulfillment Request Item - SKU | Shopify Line Item - SKU | Text | item-sku-001 | Sets line item SKU | Required |
Fulfillment Request Item - Title | Shopify Line Item - Variant Title | Text | Blue T-Shirt - Medium | Sets variant title | Supported |
Fulfillment Request Item - MPN | Shopify Line Item - Vendor | Text | BrandX | Sets vendor information | Supported |
Order Fields
Flxpoint Field | Maps To | Data Type | Example | Purpose | Status |
---|---|---|---|---|---|
Billing Address - Email | Shopify Order - Email | Text | john.doe@example.com | Sets order email | Supported |
Channel Invoice - Total | Shopify Order - Financial Status | Text | paid | Sets financial status | Supported |
Fulfillment Request - Total Weight (lbs) | Shopify Order - Inventory Behaviour | Text | decrement_obeying_policy | Sets inventory behavior | Supported |
Fulfillment Request - Note | Shopify Order - Note | Text | Urgent Fulfillment | Sets order note | Supported |
Billing Address - Phone | Shopify Order - Phone | Text | 555-123-4567 | Sets order phone number | Supported |
Fulfillment Request - Sent At | Shopify Order - Send Fulfillment Receipt | Text | false | Controls fulfillment receipt notification | Supported |
Channel Invoice - Receipt Sent At | Shopify Order - Send Order Receipt | Text | false | Controls order receipt notification | Supported |
Source Shipping Method - Method | Shopify Order - Shipping Method Title | Text | Standard Shipping | Sets shipping method title | Supported |
Fulfillment Request - Estimated Shipping Cost | Shopify Order - Shipping Price | Number | $5 | Sets shipping price | Supported |
Fulfillment Request - Fulfillment Request Number | Shopify Order - Tags | Text | FR-001 | Sets order tags | Supported |
Channel Invoice - Tax Cost | Shopify Order - Total Tax | Number | $2 | Sets total tax amount | Supported |
Shipping Address Fields
Flxpoint Field | Maps To | Data Type | Example | Purpose | Status |
---|---|---|---|---|---|
Shipping Address - Address Line 1 | Shopify Shipping Address - Address 1 | Text | 456 Oak St | Sets shipping address line 1 | Supported |
Shipping Address - Address Line 2 | Shopify Shipping Address - Address 2 | Text | Suite 5C | Sets shipping address line 2 | Supported |
Shipping Address - City | Shopify Shipping Address - City | Text | Los Angeles | Sets shipping city | Supported |
Shipping Address - Company Name | Shopify Shipping Address - Company | Text | XYZ Inc | Sets shipping company name | Supported |
Shipping Address - Country | Shopify Shipping Address - Country | Text | United States | Sets shipping country | Supported |
Shipping Address - Country Code | Shopify Shipping Address - Country Code | Text | US | Sets shipping country code | Supported |
Shipping Address - Latitude | Shopify Shipping Address - Latitude | Text | 34.0522 | Sets shipping latitude | Supported |
Shipping Address - Longitude | Shopify Shipping Address - Longitude | Text | -118.2437 | Sets shipping longitude | Supported |
Shipping Address - First Name | Shopify Shipping Address - Name | Text | Jane | Sets shipping first name | Supported |
Shipping Address - Full Name | Shopify Shipping Address - Name | Text | Jane Smith | Sets shipping full name | Supported |
Shipping Address - Last Name | Shopify Shipping Address - Name | Text | Smith | Sets shipping last name | Supported |
Shipping Address - Phone | Shopify Shipping Address - Phone | Text | 555-987-6543 | Sets shipping phone number | Supported |
Shipping Address - Postal Code | Shopify Shipping Address - Zip | Text | 90001 | Sets shipping postal code | Supported |
Shipping Address - State | Shopify Shipping Address - Province | Text | California | Sets shipping state | Supported |
Shipping Address - State Code | Shopify Shipping Address - Province Code | Text | CA | Sets shipping state code | Supported |
Flxpoint supports Shopify’s multi-location inventory for accurate fulfillment requests:
- Location ID Requirement: Specify a Location ID in Flxpoint to route fulfillment requests to the correct Shopify location. Refer to Shopify’s guide on managing locations.
- Single Location Per Request: The integration sends fulfillment requests for one location per job, using the specified Location ID in the API call.
Pro Tip: Configure multiple integration jobs with different Location IDs to handle fulfillment across all Shopify locations.
Be aware of these constraints:
- Single Location Per Request: Fulfillment requests are sent for one location per job; multiple jobs are needed for multiple locations.
- Order Dependency: Requires an existing order in Shopify; orders must be imported via Shopify Get Orders integration first.
- API Rate Limits: Shopify API rate limits may affect large fulfillment request batches; monitor usage to avoid interruptions.
- Custom Fields Limit: Order Note Attributes support up to 2 custom fields.
Troubleshoot issues with these steps:
- Fulfillment Request Not Sent: Verify the Location ID is correct and matches a valid Shopify location.
- Missing Line Items: Ensure Shopify Line Item SKU and Fulfillable Quantity are mapped in the template.
- API Errors: Check for Shopify API rate limit issues; reduce sync frequency if needed.
-
Order Not Found: Confirm the order exists in Shopify; if not, import it using Shopify Get Orders integration:
Error: Order not found in Shopify for fulfillment request
- Address Issues: Verify billing and shipping address mappings to ensure all required fields are populated.
Diagnostic Tip: Fulfillment failures often result from unmapped SKU/Quantity fields or missing orders in Shopify.
Key information:
- Date: As of 09:03 PM -04, May 29, 2025, this integration is operational.
- Required Fields: Line Item SKU and Fulfillable Quantity must be mapped.
- API Limits: Monitor Shopify API rate limits to avoid sync interruptions.
Pro Tip: Map SKU, Fulfillable Quantity, Billing Address, and Shipping Address, and verify Location ID for reliable fulfillment requests.
Conclusion
The Shopify Send Fulfillment Requests integration streamlines order fulfillment by enabling Flxpoint to send detailed fulfillment requests to Shopify. With support for multi-location inventory and comprehensive field mappings, it ensures accurate and efficient order processing across your sales channels. Happy fulfilling!
Get Shipments
Supported | Shopify - Get Shipments
Introduction to Shopify Get Shipments
Welcome to the Shopify Get Shipments integration guide! This integration retrieves shipment data from Shopify into Flxpoint, syncing fulfillment details such as tracking numbers, carriers, and shipment statuses. It ensures that Flxpoint’s records reflect the latest shipping information for orders, enabling accurate tracking and order management across your sales channels. Let’s get started!
The Shopify Get Shipments integration enables you to:
- Fetch shipment data from Shopify, including tracking numbers, carriers, and shipment statuses.
- Sync fulfillment details with Flxpoint for centralized order tracking.
- Support multi-location inventory by retrieving shipments for specific Shopify locations.
- Map Shopify shipment fields to Flxpoint fields for accurate data integration.
The integration follows these steps:
- 1 Connecting to Shopify: Establish a connection using OAuth2 authentication to access your Shopify store.
-
2 Fetching Fulfillment Data: A GET call to
/admin/api/{version}/fulfillments.json
retrieves fulfillment records for orders, optionally filtered by Location ID. - 3 Retrieving Order Details: Fetches associated order data (e.g., shipping cost, order status) linked to the fulfillments.
- 4 Mapping Data: Maps Shopify fulfillment and order data to Flxpoint shipment fields (e.g., Tracking Number, Carrier) using a mapping template.
- 5 Updating Flxpoint Records: Updates Flxpoint with the retrieved shipment data for tracking and order management.
Pro Tip: Ensure the specified Location ID matches the intended Shopify fulfillment location for accurate shipment retrieval.
Note: This integration requires existing fulfillments in Shopify; ensure orders are fulfilled or synced via Shopify Sync Orders integration.
Customize the integration with these settings:
- Connection: Select your Shopify OAuth connection (e.g., “Shopify Connection API - Shopify App (OAuth2)”).
- Location ID: Specify the Shopify inventory location ID to retrieve shipments (optional; if omitted, fetches all locations).
- Mapping Template: Define how Shopify shipment fields map to Flxpoint fields (see Mapping Template Details).
- Sync Frequency: Run manually or schedule syncs (e.g., daily at 6 AM UTC).
Note: Verify the Location ID in Shopify to ensure shipments are fetched for the correct location.
Follow these steps:
- 1 Add the Integration: Go to Channels > Shopify > Integrations, select “Get Shipments.”
- 2 Connect to Shopify: Select an existing Shopify OAuth connection or set up a new one.
-
3 Configure Settings:
- Specify the Location ID for shipment retrieval (optional).
- Configure sync frequency (e.g., daily at 6 AM UTC).
- 4 Create Mapping Template: Configure field mappings for shipment data (see Mapping Template Details).
- 5 Run the Integration: Start with Run Sync or schedule automatic syncs.
Mapping templates control how Shopify shipment data is imported into Flxpoint.
Interface Overview
- Screen labeled “Get Shipments” at the top; name your template (e.g., “Shopify Get Shipments 1”).
- Buttons: Delete, Duplicate, Save Mapping.
- Sections: Shipment Fields (e.g., Carrier, Tracking Number).
- Columns: Shopify fields (left, e.g., Shopify Fulfillment Tracking Number), Flxpoint fields (right, e.g., Tracking Number).
Mapping Options
- Don't Map: Ignore the field; no data is imported to Flxpoint.
- Set To Empty: Clear the field in Flxpoint.
- Field: Map a Shopify field to a Flxpoint field (e.g., Shopify Fulfillment Tracking Number to Flxpoint Tracking Number).
- Value: Set a static value (e.g., Carrier to “UPS”).
- Mapping Set: Apply a predefined mapping set for complex mappings.
- Rules: Apply conditional logic (e.g., map Shipped At only if Status is “shipped”).
Tracking Number Mapping Requirement
The Shopify Fulfillment Tracking Number field must be mapped to ensure proper shipment tracking in Flxpoint.
- Required Field: Tracking Number uniquely identifies shipments.
-
Error Scenario: Unmapped Tracking Number may cause shipment sync failures:
Invalid request: Missing required field 'Tracking Number' for shipment sync
- Fix: Go to Channels > Shopify > Templates > Get Shipments > Field Mapping, map Shopify Fulfillment Tracking Number to Flxpoint Tracking Number, save, and re-run sync.
Recommendation: Always map Tracking Number, Tracking URL, Carrier, and Shipped At for reliable shipment tracking.
Complete Field Mappings
Below are the fields you can map from Shopify to Flxpoint, based on the provided mapping template:
Shipment Fields
Shopify Field | Maps To | Data Type | Example | Purpose | Status |
---|---|---|---|---|---|
Shopify Fulfillment - Tracking Company | Flxpoint Carrier | Text | UPS | Sets shipment carrier | Supported |
Shopify Order - Shipping Method Title | Flxpoint Method | Text | Standard Shipping | Sets shipping method | Supported |
Shopify Fulfillment - Name | Flxpoint Note | Text | Fulfillment #1001 | Sets shipment note | Supported |
Shopify Fulfillment - Created At | Flxpoint Shipped At | Date | 2025-05-28T14:00:00Z | Sets shipment date | Supported |
Shopify Order - Shipping Cost | Flxpoint Shipping Cost | Number | $5 | Sets shipping cost | Supported |
Shopify Fulfillment - Tracking Number | Flxpoint Tracking Number | Text | 1Z9999W999999999 | Sets tracking number | Required |
Shopify Fulfillment - Tracking URL | Flxpoint Tracking URL | Text | https://ups.com/track | Sets tracking URL | Supported |
Shopify Fulfillment - ID | Flxpoint Reference Identifier | Number | 1001 | Sets shipment identifier | Supported |
Shopify Fulfillment - Location ID | Flxpoint Location ID | Number | 123456789 | Sets fulfillment location ID | Supported |
Shopify Fulfillment - Order ID | Flxpoint Order ID | Number | 987654321 | Sets associated order ID | Supported |
Shopify Fulfillment - Service | Flxpoint Fulfillment Service | Text | warehouse-1 | Sets fulfillment service | Supported |
Shopify Fulfillment - Shipment Status | Flxpoint Shipment Status | Text | in_transit | Sets shipment status | Supported |
Shopify Fulfillment - Status | Flxpoint Status | Text | shipped | Sets fulfillment status | Supported |
Shopify Fulfillment - Updated At | Flxpoint Updated At | Date | 2025-05-29T09:00:00Z | Sets last update date | Supported |
Flxpoint supports Shopify’s multi-location inventory for accurate shipment retrieval:
- Location ID Filtering: Specify a Location ID in Flxpoint to fetch shipments for that location. Refer to Shopify’s guide on managing locations.
- All Locations Option: If no Location ID is specified, the integration retrieves shipments from all locations.
Pro Tip: Use Location ID filtering to focus on specific fulfillment locations and reduce sync time.
Be aware of these constraints:
- Fulfillment Dependency: Requires existing fulfillments in Shopify; orders must be fulfilled or synced via Shopify Sync Orders integration.
- API Rate Limits: Shopify API rate limits may affect large shipment syncs; monitor usage to avoid interruptions.
- Location-Specific Data: Shipments are tied to specific locations; ensure correct Location ID usage to avoid missing data.
Troubleshoot issues with these steps:
- Shipments Not Syncing: Verify the Location ID is correct and matches a valid Shopify location, or remove it to fetch all locations.
- Missing Tracking Information: Ensure Shopify Fulfillment Tracking Number and Tracking URL are mapped in the template.
- API Errors: Check for Shopify API rate limit issues; reduce sync frequency if needed.
-
No Shipments Found: Confirm fulfillments exist in Shopify; if not, ensure orders are fulfilled or synced:
Warning: No fulfillments found for specified orders
Diagnostic Tip: Missing shipments often result from unmapped Tracking Number fields or incorrect Location IDs.
Key information:
- Date: As of 09:06 PM -04, May 29, 2025, this integration is operational.
- Required Fields: Tracking Number must be mapped.
- API Limits: Monitor Shopify API rate limits to avoid sync interruptions.
Pro Tip: Map Tracking Number, Tracking URL, Carrier, and Shipped At, and verify Location ID for reliable shipment syncing.
Conclusion
The Shopify Get Shipments integration streamlines shipment tracking by syncing Shopify fulfillment data with Flxpoint. With support for multi-location inventory and detailed field mappings, it ensures accurate shipment records across your sales channels. Happy tracking!