Flxpoint Knowledge

Contact us

Shopify as a Source

Table of Contents

How to connect Product Operations Order Operations

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.
Shopify Integration Setup
🔐 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.
For Bearer Token or Basic Auth (vendor/custom app flow):
  • 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.
Click Save to finalize.
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:

 

 

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_ids.
  • 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 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:
  1. Verify your product variants in Shopify have SKUs and correct on-hand quantities.
  2. In Flxpoint, ensure your mapping includes Variant SKU → SKU and Available → Quantity.
  3. Open Get Inventory (Primary) → Advanced Config → enable Force Full Inventory Fetch.
  4. Run the job. All variant quantities for the chosen Location ID are saved to GIP.
  5. (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.
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.

  • 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_ids.
  • 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.

  • 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.
This ensures efficient order fulfillment and accurate data synchronization between Flxpoint and Shopify.

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.
This ensures consistent shipment tracking and management across your sales channels.

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!
 
 

 

Related Articles

Shipping Easy

ShippingEasy as a source supports sending fulfillment requests/fulfillment orders...