Shopify is a leading eCommerce platform that allows businesses to sell products online and manage their sales channels efficiently. Integrating Shopify into Flxpoint as a channel allows you to automate order processing, inventory syncing, and product publishing between Flxpoint and Shopify. It helps streamline operations, ensuring that your product data and inventory levels are always up-to-date across your sales platforms.
How to Connect
- Search for Shopify and select it.
- Enter a Channel Name (e.g., "Shopify Store").
- Click Save & Next.
- Recommended: Select API - Shopify App (OAuth2) and click Initiate OAuth2 Flow to securely authorize Flxpoint.
- Alternatively, choose API - Bearer Token or API - Basic Auth for manual credential entry (required for vendors using Shopify as a source).
- Enter your Store URL (e.g., https://your-store-name.myshopify.com). Find this in your Shopify Admin under Settings > Domains or in your browser’s address bar when logged into Shopify Admin.
- Follow the OAuth2 prompts to log in to Shopify and grant Flxpoint access.
- No API keys or tokens are required for OAuth2.
- Log in to Shopify Admin at https://www.shopify.com/login.
- Go to Apps > Develop apps (enable custom app development if prompted).
- Click Create an app, name it (e.g., "Flxpoint Integration"), and create it.
- In API Credentials, generate an Admin API access token with permissions for products, orders, and inventory.
- Copy the API Key, API Secret Key, and Admin API access token.
- Note your Store URL (e.g., https://your-store-name.myshopify.com).
- 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 (e.g., https://your-store-name.myshopify.com).
- Click Test Connection, then Save & Next if successful.
- REST API: 2 requests/sec (standard), 4 requests/sec (Shopify Plus).
- GraphQL: 50 points/sec (standard plans).
- OAuth2: Exempt from rate limits; optimize with Flxpoint sync schedules.
- Set new listings to Paused to review before publishing.
- Configure Master SKU to align with your inventory.
- Shopify uses GraphQL; Category requires a global ID from Shopify Product Taxonomy.
- Map internal categories (e.g., "Consumer Electronics") to valid global IDs in your template.
- Adjust settings like "Truncate Title to 255" as needed.
- Select statuses (e.g., Open) and time range for order imports.
- Location ID Note: Orders with or without a Location ID are saved unless disabled in Advance Config.
- In Shopify Admin, install a Shopify app/plugin that supports TikTok Shop integration (e.g., TikTok Shop app).
- Follow the app’s instructions to connect your Shopify store to TikTok Shop.
- Verify the integration by ensuring listings can be published to TikTok Shop via the Shopify channel in Flxpoint.
- Review settings and enable processes (e.g., import listings).
- Click Confirm & Finish.
- Start Import Listings to sync products.
- Start Get Orders to manage orders.
- Check Sync and Link Listings and Publish Listings.
Listing Operations
Import Listings
- Centralize inventory by importing Shopify listings into Flxpoint to manage across multiple channels.
- Define Master SKUs in Flxpoint to connect Shopify listings with fulfillment sources.
- Control import behavior with options to pause new listings for review.
- Support variants by importing both parent products and variants, including fields like price, quantity, and metafields.
- 1 Connecting to Shopify: Establish a connection using API credentials or OAuth2 authentication to access your Shopify store.
- 2 Fetching Product Data: A GET call to the Shopify /admin/api/{version}/products.json endpoint retrieves product data, including variants.
- 3 Defining Master SKU: Maps a Shopify field (e.g., Variant Barcode or SKU) to Flxpoint’s Master SKU for unique identification.
- 4 Importing Listings: Creates or updates listings in Flxpoint based on Shopify data, following selected Product & Listing Management settings.
- 5 Handling Variants: Imports variant-specific fields like price, quantity, and metafields into Flxpoint.
- 6 Pausing New Listings (Optional): Sets newly imported listings to "Paused" status to allow review before syncing with sources.
- Connection: Select your Shopify store connection (e.g., "Shopify Connection API - Shopify App (OAuth2)").
- Set New Listings to Paused: Enable to pause newly imported listings for review before syncing.
- Master SKU: Choose a Shopify field (e.g., Variant Barcode or SKU) to populate Flxpoint’s Master SKU.
- Product & Listing Management: Select import behavior: "Create products & listings only," "Create new products only," or "Create and update products & listings."
- 1 Add the Integration: Go to Channels > Shopify > Integrations, select "Import Listings."
- 2 Connect to Shopify: Use existing Shopify credentials or set up a new connection via OAuth2 authentication.
-
3 Configure Settings:
- Enable "Set New Listings to Paused" if needed.
- Choose a Master SKU field (e.g., Shopify Variant SKU).
- Select Product & Listing Management option (e.g., "Create products & listings only").
- 4 Save and Complete: Click "Save and Complete" to finalize setup.
- 5 Run the Integration: Start with Run Sync manually.
- Create Products & Listings Only: Imports Shopify listings and links to existing listings by SKU; creates new listings if no match is found.
- Create New Products Only: Creates new products in Flxpoint without updating existing ones.
- Create and Update Products & Listings: Imports and links listings by SKU, overwriting existing Flxpoint data with Shopify data if a match is found, or creates new listings if no match exists.
Shopify Field | Maps To | Example | Purpose | Status |
---|---|---|---|---|
externalListingId | Flxpoint externalListingId | 123456789 | Identifies the parent listing | Supported |
SKU (Handle) | Flxpoint SKU | product-handle | Unique identifier for the product | Supported |
Title | Flxpoint Title | Blue T-Shirt | Product name | Supported |
Description | Flxpoint Description | Comfortable cotton t-shirt | Product description | Supported |
Manufacturer | Flxpoint Manufacturer | BrandX | Product manufacturer | Supported |
Images | Flxpoint Images | image_url.jpg | Product images | Supported |
customField (Product Metafields) | Flxpoint customField | color: blue | Additional product metadata | Supported |
Attributes (Tags) | Flxpoint Attributes | tag: summer | Product attributes | Supported |
Category1 (CustomCollection1) | Flxpoint Category1 | Apparel | Primary category | Supported |
Category2 (CustomCollection2) | Flxpoint Category2 | T-Shirts | Secondary category | Supported |
Category3 (CustomCollection3) | Flxpoint Category3 | Casual | Tertiary category | Supported |
Shopify Field | Maps To | Example | Purpose | Status |
---|---|---|---|---|
externalListingId | Flxpoint externalListingId | 987654321 | Identifies the variant | Supported |
SKU | Flxpoint SKU | variant-sku-001 | Unique identifier for the variant | Supported |
UPC (Barcode) | Flxpoint UPC | 012345678905 | Universal product code | Supported |
Title | Flxpoint Title | Blue T-Shirt - Medium | Variant name | Supported |
Price | Flxpoint Price | 29.99 | Variant price | Supported |
MSRP (Compare at Price) | Flxpoint MSRP | 39.99 | Manufacturer’s suggested retail price | Supported |
SalePrice | Flxpoint SalePrice | 24.99 | Discounted price | Supported |
Quantity | Flxpoint Quantity | 100 | Available stock | Supported |
customFields (Variant Metafields) | Flxpoint customFields | size: medium | Additional variant metadata | Supported |
Options | Flxpoint Options | Medium, Blue | Variant options | Supported |
Weight | Flxpoint Weight | 0.5 lbs | Variant weight (converts from grams if needed) | Supported |
Weight Unit | Flxpoint Weight Unit | lbs | Unit of weight | Supported |
- Custom Fields: Supported—Parent and variant metafields are imported as custom fields.
- Variations/Options: Supported—Imports variant options.
- Generic Pricing & Currency: Not supported—List price from the store is imported.
- Client Pricing & Currency: Not supported.
- Quantity: Supported—Imported as an aggregate value for all locations.
- Multiple Warehouses: Supported—Product data is saved for all locations, but location selection isn’t available.
- Weights & Dimensions: Supported—Weight in oz, lb, kg; dimensions are not set by default.
- Images: Supported—Images are imported via store-hosted URLs; multiple images are supported.
- Categories: Not supported—Category linking in Flxpoint is not available.
- Missing SKU Errors: If errors like "SKU must be provided to create a variant" appear in the Recent Notifications log, ensure the Shopify Variant SKU field is populated.
- Connection Issues: Verify Shopify connection is active and credentials are valid.
- Master SKU Settings: Ensure the chosen Master SKU field (e.g., Shopify Variant SKU) contains data to avoid import failures.
- Recent Notifications: Check Shopify Channel Settings > Integrations > Import Listings for a breakdown of created/updated items and errors.
- Date: As of 08:13 PM -04, May 29, 2025, this integration is operational.
- Required Fields: Shopify Variant SKU or Barcode must be mapped to Flxpoint’s Master SKU.
- Manual Execution: Scheduling is not supported; run the integration manually.
Sync & Link Listings
- Seamlessly sync price, quantity, and variant attributes between Flxpoint and Shopify.
- Accurately link Flxpoint listings to Shopify products using identifiers like UPC or SKU.
- Control product visibility by hiding or delisting products on Shopify based on stock or status.
- Support both simple products and variants, such as products with multiple sizes or colors.
- 1 Connecting to Shopify: Establish a connection using API credentials or OAuth2 authentication to access your Shopify store.
- 2 Retrieving Product Data: Flxpoint pulls product data, including variants, from Shopify using API calls.
- 3 Linking Listings: Matches Flxpoint listings to Shopify products using identifiers like UPC or SKU, based on linking priority settings.
- 4 Mapping Data: Aligns Flxpoint data with Shopify fields using a mapping template.
- 5 Syncing Updates: Updates Shopify with the latest price, stock, and variant information from Flxpoint.
- 6 Managing Visibility: Hides or delists products on Shopify based on stock levels or status, such as marking them as "Out of Stock."
- Connection: Select your Shopify store connection (e.g., "Shopify Connection API - Shopify App (OAuth2)").
- Location ID: Specify the Shopify inventory location ID to update inventory for that location.
- Linking Priority: Define matching criteria, such as Listing Variant SKU to Shopify Variant SKU.
- Scheduling: Run manually or schedule syncs (e.g., daily at 6 AM UTC).
- Mapping Template: Define how Flxpoint fields map to Shopify fields (see Mapping Template Details).
- 1 Add the Integration: Go to Channels > Shopify > Integrations, select "Sync Listings."
- 2 Connect to Shopify: Use existing Shopify credentials or set up a new connection via OAuth2 authentication.
-
3 Configure Settings:
- Specify the Location ID.
- Set Linking Priority (e.g., Listing Variant SKU to Shopify Variant SKU).
- Enable scheduling if desired.
- 4 Create Mapping Template: Configure field mappings (see Mapping Template Details).
- 5 Run the Integration: Start with Run Sync or schedule.
- Screen labeled "Sync Listings" at the top; name your template (e.g., "Shopify Sync Listings 1").
- Buttons: Delete, Duplicate, Save Mapping.
- Columns: Flxpoint fields (left, e.g., Listing Variant Quantity), Shopify fields (right, e.g., Quantity).
- 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., Quantity to Quantity).
- Value: Set a static value (e.g., Price to "50").
- Rules: Apply conditional logic (e.g., hide if Quantity < 1, if available).
- Required Field: Quantity uniquely tracks inventory levels.
-
Error Scenario: Unmapped Quantity may cause:
Invalid request: Missing required field 'Quantity' for inventory sync
- Fix: Go to Channels > Shopify > Templates > Sync Listings > Field Mapping, map Listing Variant Quantity to Shopify Quantity, save, and re-run sync.
Shopify Field | Maps To | Example | Purpose | Status |
---|---|---|---|---|
Status | Flxpoint Status | Active | Sets product status (Active, Draft, Archived) | Optional (Don’t Map unless needed) |
Shopify Field | Maps To | Example | Purpose | Status |
---|---|---|---|---|
Compare At Price | Listing Variant - MSRP | $50 | Shows crossed-out price higher than actual price | Supported |
Cost | Listing Variant - Estimated Cost | $20 | Tracks product cost | Supported |
Price | Listing Variant - List Price | $30 | Sets selling price | Supported |
Quantity | Listing Variant - Quantity | 50 | Updates stock level | Required |
Requires Shipping | Flxpoint Requires Shipping | True | Indicates if shipping is needed | Optional (Don’t Map unless needed) |
Track Inventory | Flxpoint Track Inventory | True | Enables inventory tracking | Optional (Don’t Map unless needed) |
- Connection Issues: Verify Shopify connection is active and credentials are valid.
- Linking Errors: Confirm identifiers (e.g., SKU, UPC) match between Flxpoint and Shopify.
- Mapping Issues: Ensure fields are mapped correctly (e.g., Quantity to Quantity).
- Product Status: If a product is in "Draft" in Shopify, Flxpoint shows it as hidden; set to "Active."
- GraphQL Inventory: If Track Inventory is "false" in Shopify, quantity won’t update; ensure it’s enabled.
- Date: As of 08:15 PM -04, May 29, 2025, this integration is operational.
- Required Fields: Quantity must be mapped; SKU or UPC recommended for linking.
- API Limits: Monitor Shopify API rate limits to avoid sync interruptions.
Publish Listings
- Publish or update products and variants on Shopify using Flxpoint data.
- Support up to 100 variants per product with up to 3 options (e.g., size, color).
- Customize data mapping for fields, including metafields, categories, and tags.
- Automate publishing with scheduled jobs for consistent updates.
- 1 Connecting to Shopify: Establish a connection using API credentials or OAuth2 authentication to access your Shopify store.
- 2 Creating/Updating Products: A POST request to /admin/api/{version}/products.json creates or updates products at a specified inventory location.
- 3 Mapping Data: Aligns Flxpoint data with Shopify fields using a mapping template, including categories, metafields, and tags.
- 4 Handling Variants: Publishes variants with up to 3 options, positioning them based on option values (e.g., Color: White/Blue).
- 5 Publishing Attributes: Publishes listing attributes as Shopify tags and supports metafields for additional data.
- 6 Scheduling Publishing: Optionally automates publishing using UTC time zone scheduling.
- Connection: Select your Shopify store connection (e.g., "Shopify Connection API - Shopify App (OAuth2)").
- Location ID: Specify the Shopify inventory location ID for publishing products.
- Additional Variant Images: Enable to upload variant-specific images to products with a parent image.
- Namespace: Define the namespace for metafields when configuring direct copy to Shopify.
- Truncate Title to 255: Trim product titles to 255 characters to meet Shopify’s limit.
- Auto-Create Smart Collection: Automatically create Smart Collections for mapped Product Types.
- Advanced Image Duplication Logic: Use cached MD5 checksums to prevent duplicate image uploads.
- Use Underscore in Meta Fields Name: Use underscores as separators in metafield names.
- Sort Variants by Option Position: Sort variants by option position for new parent products.
- Automate: Schedule automatic publishing in UTC time zone.
- Mapping Template: Define Flxpoint-to-Shopify field mappings, including rules for categories and metafields.
- 1 Add the Integration: Go to Channels > Shopify > Integrations, select "Publish Listings."
- 2 Connect to Shopify: Use existing Shopify credentials or set up a new connection via OAuth2 authentication.
-
3 Configure Settings:
- Specify the Location ID.
- Enable options like "Truncate Title to 255," "Advanced Image Duplication Logic," and "Sort Variants by Option Position."
- Enable scheduling if desired.
- 4 Create Mapping Template: Configure field mappings, including categories and metafields (see Mapping Template Details).
- 5 Run the Integration: Start with Run Sync or schedule.
- Screen labeled "Publish Listings" at the top; name your template (e.g., "Shopify Publish Listings 1").
- Buttons: Delete, Duplicate, Save Mapping.
- Columns: Flxpoint fields (left, e.g., Listing Parent Title), Shopify fields (right, e.g., Title).
- 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., Title to Title).
- Value: Set a static value (e.g., Tags to "Tag1,Tag2,Tag3").
- Rules: Apply conditional logic (e.g., set Category based on Category 1).
- Required Field: SKU uniquely identifies variants.
-
Error Scenario: Unmapped SKU may cause:
Invalid request: Missing required field 'SKU' for variant publishing
- Fix: Go to Channels > Shopify > Templates > Publish Listings > Field Mapping, map Listing Variant SKU to Shopify SKU, save, and re-run sync.
Shopify Field | Maps To | Example | Purpose | Status |
---|---|---|---|---|
Title | Listing Parent - Title | Blue T-Shirt | Sets product title | Required |
Description | Listing Parent - Description | Comfortable cotton t-shirt | Sets product description | Supported |
Tags | Listing Parent - Attribute | Tag1,Tag2,Tag3 | Adds comma-separated tags | Supported |
Category | Listing Parent - Category 1 | gid://shopify/TaxonomyCategory/ap-1 | Sets product category | Supported |
Shopify Field | Maps To | Example | Purpose | Status |
---|---|---|---|---|
SKU | Listing Variant - SKU | variant-sku-001 | Identifies the variant | Required |
Price | Listing Variant - List Price | $30 | Sets selling price | Supported |
Compare At Price | Listing Variant - MSRP | $50 | Shows crossed-out price | Supported |
Weight | Listing Variant - Weight | 0.5 | Sets variant weight | Supported |
Weight Unit | Listing Variant - Weight Unit | lb | Sets unit of weight | Supported |
Shopify Field | Maps To | Example | Purpose | Status |
---|---|---|---|---|
Custom Fields | Listing Variant - Custom Field | color: blue | Adds metafield data (single_line_text) | Supported |
- Refer to Shopify’s Product Taxonomy for category IDs (e.g., "gid://shopify/TaxonomyCategory/ap-1" for "Live Animals").
- Example Rule: If Category 1 = "Live Animals," set Category to "gid://shopify/TaxonomyCategory/ap-1."
- Product Options: Maximum of 3 options per product (e.g., Size, Color, Material).
- Attributes and Custom Field Titles: Limited to 30 characters.
- Image Size: Maximum 4472 x 4472 pixels, 20 MB file size.
- Product Limits: 1,000 products/day for regular Shopify accounts (Shopify Plus accounts exempt).
- Title Length Errors: Enable "Truncate Title to 255" if titles exceed 255 characters.
- Variant Option Limits: Ensure no more than 3 options and 100 variants per product.
- Metafield Errors: Verify Namespace, Key, and Value; only single_line_text metafields supported.
- Image Upload Issues: Check images meet Shopify’s size limits; enable "Advanced Image Duplication Logic."
- Category Mapping Issues: Ensure category IDs match Shopify’s Taxonomy.
-
Product Does Not Exist Error: Unlink and re-link the product in Flxpoint if it was deleted in Shopify.
Error: Product does not exist
- Product Variant Does Not Exist: For recurring errors (e.g., "GraphQL Request Failed: Product variant does not exist" for SKU 2190-Case), contact Flxpoint support if unlinking/re-linking fails.
- Mismatched Titles and Variant Structures: Align Shopify product titles and variant groupings with Flxpoint to resolve publishing errors.
- Price/Quantity Sync Errors: Contact Flxpoint support for structural mismatches affecting price or quantity syncing.
- Date: As of 08:18 PM -04, May 29, 2025, this integration is operational.
- Required Fields: SKU and Title must be mapped.
- API Limits: Monitor Shopify API rate limits to avoid sync interruptions.
- Product Limits: 1,000 products/day for regular Shopify accounts.
Order Operations
Get Orders
- Import new and updated orders from Shopify.
- Include already-fulfilled items for accounting or PO creation when needed.
- Preserve your preferred Shopify order reference (e.g.,
#1001
or the numeric ID). - Support “In Progress” print-on-demand orders without routing them for fulfillment.
- 1 Connect: Authorize your Shopify store.
- 2 Filter: Choose financial/fulfillment filters (see “Filters & Statuses”).
- 3 Map: Set your order and line-item mapping (see “Mapping Template Details”).
- 4 Advanced: Toggle advanced configs for special cases (fulfilled items, zero-fulfillable lines).
- 5 Run: Run on demand or on a schedule.
Goal: Ensure print-on-demand orders in production import correctly.
- Where: Get Orders → Step 2: Filters
-
Fulfillment Status: select
unfulfilled
and/orpartial
.
These include orders whose underlying fulfillment orders are open orin_progress
. -
Financial Status: include the statuses you expect for your flow (e.g.,
paid
,authorized
, etc.).
unfulfilled
/partial
at the order level reliably brings in those jobs while they’re in progress.
line_items.quantity
. If a previous mapping used fulfillable quantities, orders could land “On Hold.” Fix the mapping and re-run.
What it does: Imports Shopify line items where fulfillable_quantity = 0
(already fulfilled). Useful for accounting or reporting that needs every line present.
- Default: Off
- Where: Get Orders → Advanced Settings
- When to use: You need already-fulfilled lines on the Flxpoint order (e.g., for “Send Accounting Orders”).
What it does: Marks already-fulfilled (zero-fulfillable) lines as shippable so you can create Fulfillment Requests and sync Purchase Orders to accounting.
- Default: Off
- Where: Get Orders → Advanced Settings
- Use with: Import Already Fulfilled Order Items (enable both for FR/PO workflows).
Choose which Shopify identifier becomes your Flxpoint Order Reference Number. This keeps your reporting and downstream systems consistent.
Flxpoint Field | Shopify Property | Looks Like | When to Use |
---|---|---|---|
Order Reference Number | order.name |
#1001 | Matches the label most merchants see in Shopify UI. |
Order Reference Number | order.order_number |
1001 | Numeric only—use when your accounting system expects digits. |
Order Reference Number |
order.id (Shopify orderId) |
gid or numeric ID | Best for cross-system joins and shipment lookups. |
Flxpoint Line Field | Shopify Property | Notes |
---|---|---|
SKU | line_items.variant.sku |
Primary match key for routing and linking. |
Quantity | line_items.quantity |
Use this (not fulfillable qty) to avoid On-Hold imports. |
Unit Price | line_items.price |
Pre-discount unit price. |
Line Discount | line_items.total_discount |
Optional: map if you need discount detail per line. |
Title / Variant |
line_items.title , line_items.variant_title
|
Optional metadata for docs and packing slips. |
order.id
saved to the FR. That lets you import the order from the channel and the tracking from the source—without routing the FR.
- 1 Add Integration: Channels → Shopify → Get Orders.
- 2 Authorize: Connect your Shopify store.
- 3 Filters: Select financial status and set fulfillment to unfulfilled/partial to include “In Progress.”
-
4 Mapping: Choose your preferred order reference (name / order_number / order.id) and confirm quantity =
line_items.quantity
. -
5 Advanced: Toggle:
- Import Already Fulfilled Order Items
- Allow Zero Fulfillable Shipment (if you plan to create FRs/POs from those lines)
- 6 Run or Schedule: Test with a manual run, then schedule if desired.
-
Order “On Hold”: Check Quantity mapping → use
line_items.quantity
. Re-run. - Missing already-fulfilled lines: Enable Import Already Fulfilled Order Items.
- Need FR/PO from fulfilled lines: Also enable Allow Zero Fulfillable Shipment.
-
Tracking won’t import (POD flow): Save Shopify
order.id
as reference and use the source’s “fetch shipments by orderId” option. - Order not fetched: Loosen Financial / Fulfillment filters temporarily to confirm visibility.
-
Fulfillment logic: Shopify’s order-level
fulfillment_status
is legacy; including unfulfilled/partial captures in-progress fulfillment orders. - Defaults: Both advanced configs are Off by default.
- Best practice: Keep a test order handy to validate mapping and filters before you scale up.
Sync Orders
- Update Shopify with shipment details like tracking numbers, URLs, and carrier information.
- Sync a "Closed" status for orders with partial or no fulfillment data, including auto-closed In-Store orders, archiving future orders from Shopify.
- Support multi-location inventory by associating shipments with the correct Shopify Location ID.
- Handle partial shipments, updating Shopify with "Partially Shipped" or "Shipped" statuses.
- Notify customers of shipment updates via Shopify, configurable in the mapping template.
- 1 Connecting to Shopify: Establish a connection using OAuth2 authentication to access your Shopify store.
-
2 Sending Fulfillment Data: A POST request to
/admin/api/{version}/fulfillments.json
sends fulfillment details for a specified order_id. - 3 Handling Multi-Location: Syncs shipments for items from the same location; retries failed shipments for other locations in the next sync job.
- 4 Mapping Data: Aligns Flxpoint shipment data with Shopify fulfillment fields using a mapping template.
- 5 Updating Order Status: Updates Shopify with "Partially Shipped" or "Shipped" statuses, and optionally "Closed" for orders with partial/no fulfillment data, including In-Store orders.
- 6 Notifying Customers: Optionally sends shipment update notifications to customers, configurable via the mapping template.
- Connection: Select your Shopify OAuth connection (e.g., “Shopify Connection API - Shopify App (OAuth2)”).
- Location ID: Specify the Shopify inventory location ID for syncing fulfillments (required).
- Sync "Closed" Order Status: Enable to send a "Closed" status for orders with partial/no fulfillment data, including auto-closed In-Store orders.
- Shipping Mappings: Map Shopify shipping rates (e.g., Free, Expedited) to Flxpoint shipping policies (e.g., Ground, Two Day Shipping). For In-Store orders, map Channel Shipping Text (e.g., “In-Store”) to align with In-Store Order Workflow rules.
- Mapping Template: Define how Flxpoint shipment fields map to Shopify fulfillment fields.
- 1 Add the Integration: Go to Channels > Shopify > Integrations, select “Sync Orders.”
- 2 Connect to Shopify: Select an existing Shopify OAuth connection or set up a new one.
-
3 Configure Settings:
- Specify the Location ID.
- Enable “Sync 'Closed' Order Status” if needed, especially for In-Store orders.
- Configure shipping mappings (e.g., Shopify “Expedited” to Flxpoint “Two Day Shipping”; “In-Store” for In-Store orders).
- 4 Create Mapping Template: Configure field mappings for shipment data (see Mapping Template Details).
- 5 Run the Integration: Start with Run Sync to update Shopify manually.
- Expedited: $9.90 for 5lb–10lb.
- Free: Free for 0lb–1lb.
- Standard: $3.95 for $0.00–$30.00.
- Free → Ground: Maps Shopify’s “Free” rate to Flxpoint’s “Ground” policy.
- Expedited → Expedited: Maps Shopify’s “Expedited” rate to Flxpoint’s “Expedited” policy.
- Standard → Two Day Shipping: Maps Shopify’s “Standard” rate to Flxpoint’s “Two Day Shipping” policy.
- Screen labeled “Sync Orders” at the top; name your template (e.g., “Shopify Sync Orders 1”).
- Buttons: Delete, Duplicate, Save Mapping.
- Columns: Flxpoint fields (left, e.g., Shipment Tracking Number), Shopify fields (right, e.g., Tracking Number).
- 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., Tracking Number to Tracking Number).
- Value: Set a static value (e.g., Notify Customer to “True”).
- Rules: Apply conditional logic (e.g., notify customer only for specific carriers).
- Required Field: Tracking Number identifies shipments.
-
Error Scenario: Unmapped Tracking Number may cause:
Invalid request: Missing required field 'Tracking Number' for fulfillment sync
- Fix: Go to Channels > Shopify > Templates > Sync Orders > Field Mapping, map Shipment Tracking Number to Shopify Tracking Number, save, and re-run sync.
Shopify Field | Maps To | Example | Purpose | Status |
---|---|---|---|---|
Location ID | Flxpoint Location ID | 123456789 | Specifies fulfillment location | Optional (Don’t Map; set by integration) |
Notify Customer | Fixed Value | True | Notifies customer of shipment | Supported |
Tracking Company | Shipment - Carrier | UPS | Sets carrier name | Supported |
Tracking Number | Shipment - Tracking Number | 1Z9999W999999999 | Sets tracking number | Required |
Tracking URL | Shipment - Tracking URL | https://ups.com/track | Sets tracking URL | Supported |
- Location ID Requirement: Specify a Location ID in Flxpoint to sync fulfillments. Refer to Shopify’s guide on managing locations.
- Multi-Location Shipments: Syncs shipments for items from the same location; retries failed shipments for other locations in the next sync job. Applies to both online and In-Store orders.
- Manual Order Item Limitations: Flxpoint does not support manual order item limitations for syncing shipments.
- Sync "Closed" Limitation: Affects only future orders; existing orders are not updated. Applies to In-Store orders for auto-closed status syncing.
-
Shipment Not Syncing: If a product was deleted in Shopify (e.g., ordered Tuesday, deleted Wednesday, shipped Thursday), Shopify throws an error:
Error: Product cannot be locatedResolve by unlinking/re-linking the product in Flxpoint, as detailed in the Publish Listings section.
- Multi-Location Errors: Verify the Location ID matches the fulfillment location. For In-Store orders, ensure the fulfillment source aligns with In-Store Order Workflow settings.
- Customer Not Notified: Ensure “Notify Customer” is mapped to “True” in the mapping template.
- Additional Sync Errors: For errors like “Product variant does not exist” or price/quantity sync issues, refer to the Publish Listings section to resolve product linking mismatches.
- Date: As of 08:26 PM -04, May 29, 2025, this integration is operational.
- Required Fields: Tracking Number must be mapped; Location ID is required.
- API Limits: Monitor Shopify API rate limits to avoid sync interruptions.