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
📋 Phase 1: Initial Channel Setup
+
Access Channels Section
Log into your Flxpoint account and navigate to the Channels section.
Create a New Channel
Click + Add Channel to start the integration process.
Tip: Have your Standard account credentials or API details ready to streamline setup.
Select Standard and Name Channel
In the popup:
- Choose Standard as the channel type.
- Enter a descriptive Channel Name (e.g., "Standard 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
+
Important Note: The recommended method for connecting Standard to Flxpoint is via OAuth2, which securely authorizes the connection without manual credential entry. Use API Key only if OAuth2 is unavailable (e.g., for custom integrations).
Select the Integration Type
In the Setup Integrations wizard, select OAuth2 for secure authorization, or choose API Key for manual credential entry.
Connect Your Account
For OAuth2:
- Enter your Store URL (e.g., https://your-store.standardplatform.com). Find this in your Standard Admin under Settings > Domains or in your browser’s address bar.
- Click Initiate OAuth2 Flow, select your store account, and Install the Flxpoint app in the Standard dialog.
- Review and Approve the requested permissions.
- You’ll be redirected to Flxpoint upon completion.
- In Standard Admin, go to Settings > Apps and Integrations > Develop Apps.
- Click Create an App, name it "Flxpoint", and generate an API Access Token with scopes for products, orders, and inventory.
- Copy the Token and your Store URL.
Important: Use the platform’s native URL (e.g., https://cool-store.standardplatform.com), not a custom domain (e.g., coolstore.com).
Authorize Access
For OAuth2, no further credentials are needed after authorization. For API Key:
- Enter a Connection Name (e.g., "Standard Connection #1").
- Paste the API Access Token and Store URL.
- Click Test Connection and then Continue if successful.
Troubleshooting: If the connection fails, verify credentials, permissions, and URL format. In Standard Admin, go to Apps and Integrations, locate the Flxpoint app, and select Delete to reset, then restart from Phase 1.
Verify Connection
Review connection details in Flxpoint to ensure accuracy, then proceed.
Standard API Rate Limits: Standard enforces API rate limits to ensure platform stability. Details at Standard API Documentation:
- REST API: 2 requests/sec, 40 requests/sec for premium plans.
- GraphQL API: 50 points/sec.
- OAuth2: Exempt from rate limits; optimize with Flxpoint sync schedules.
🔄 Phase 3: SKU Mapping & Configuration
+
Set Up SKU Mapping
Configure Import Listings to align with your inventory:
- Set new listings to Paused to review before publishing.
- Map your internal Master SKU to Standard’s listing SKU.
Pro Tip: Use consistent SKU naming (e.g., "PROD-123" internally and "STD-PROD-123" on Standard) for easier inventory management.
Configure Integration Settings
Enable automated features:
- Inventory & Pricing: Enable automatic synchronization of inventory levels and prices between Flxpoint and Standard.
- Publish Listings: Standard uses GraphQL; map categories to global IDs from Standard’s Taxonomy. Adjust settings like "Truncate Title to 255" or "Enable variant images."
- Order Sync: Select fulfillment and financial statuses (e.g., "Unfulfilled," "Authorized") for Get Orders.
- Shipment Tracking: Configure tracking updates to notify Standard and customers when orders ship.
- TikTok Shop (Optional): In Standard Admin, install a TikTok Shop app, 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 Save. In Channels > Standard, run Import Listings, Get Orders, and manage syncs or schedules.
Next Steps: Run processes manually to verify sync accuracy before enabling automation. For guidance, view the Standard integration walkthrough.
×
![]()
Listing Operations
Import Listings
Supported | Shopify - Import Listings
Introduction to Shopify Import Listings
Welcome to the Shopify Import Listings integration guide! This integration lets you bring your Shopify product listings into Flxpoint, keeping your inventory in sync across both platforms. It ensures data consistency and helps you manage your listings efficiently. Let’s get started!
The Shopify Import Listings integration enables you to:
- Pull your Shopify listings into Flxpoint, either creating new listings or linking them to existing ones using a Master SKU.
- Pause new listings to link inventory before they sync back to Shopify, avoiding mismatches.
- Ensure data consistency between Shopify and Flxpoint for accurate inventory management.
The integration follows these steps:
- 1 Connecting to Shopify: Establish a connection using API credentials or OAuth2 authentication to access your Shopify store.
-
2 Fetching Listings Data: A GET call to
/admin/api/{version}/products.jsonretrieves your Shopify product listings. - 3 Matching Listings: Matches Shopify listings to Flxpoint listings using a Master SKU (e.g., Shopify Variant - Barcode).
- 4 Importing Listings: Imports listings based on your settings (create only or create & overwrite), with an option to pause new listings.
- 5 Execution: Run manually with Run Sync or schedule (e.g., daily).
Pro Tip: Schedule regular syncs to keep your listings up-to-date across platforms.
Note: API failures pause the integration and trigger notifications.
Customize the integration with these settings:
- Enable Import Listings: Toggle this on to start importing Shopify listings.
-
How Listings Are Imported: Choose how Flxpoint handles Shopify listings:
- Create Only: Imports Shopify listings and links them to existing Flxpoint listings by SKU. If there’s no SKU match, a new listing is created.
- Create & Overwrite Existing: Imports Shopify listings, links them by SKU, updates existing Flxpoint listings, and creates new listings if there’s no SKU match.
- Master SKU: Select the Shopify field to use as the Master SKU for linking (e.g., Shopify Variant - Barcode or SKU).
- Pause New Listings: Toggle this on to pause newly imported listings until inventory is linked.
- Scheduling: Run manually or schedule (e.g., daily at 6 AM UTC).
Note: Pausing new listings helps avoid inventory mismatches by giving you time to link inventory.
Follow these steps:
- 1 Add the Integration: Go to Channels > Shopify > Integrations, select “Import Listings.”
- 2 Connect to Shopify: Use your Shopify Token and Store URL or set up a new connection via OAuth2 authentication.
-
3 Configure Settings:
- Toggle on "Enable Import Listings."
- Select how to import ("Create Only" or "Create & Overwrite Existing").
- Choose the Master SKU field (e.g., Shopify Variant - Barcode).
- Enable "Pause New Listings" if desired.
- Configure scheduling (e.g., daily at 6 AM UTC).
- 4 Run the Integration: Start with Run Sync or schedule automatic syncs.
If you chose to pause new listings, you’ll need to unpause them to sync with Shopify:
- 1 Go to Products in Flxpoint.
- 2 Select the paused listings you want to unpause.
- 3 Click Actions → Change Listing Status → Unpause Listings.
Pro Tip: Unpause listings only after linking inventory to ensure accurate syncing.
Here’s what data Flxpoint can import from Shopify:
- Custom Fields: Supported. Parent and variant metafields come in as custom fields.
- Variants/Options: Supported.
- Quantity: Supported. Quantity is imported as a total for all locations.
- Multiple Warehouses: Supported. Product data is saved for all locations.
- Weight & Dimensions: Supported. Weight in oz, lb, kg, g; dimensions not available by default.
- Images: Supported. Images are imported using store-hosted URLs, with multiple images supported.
- List Pricing & Client Pricing: Not supported. You’ll need to set pricing manually in Flxpoint.
- Categories: Not supported.
Be aware of these limitations:
- Pricing Not Imported: List and client pricing aren’t imported; set them manually in Flxpoint.
- Categories Not Supported: Categories aren’t imported; manage them separately.
- API Rate Limits: Shopify API rate limits may affect large import jobs; monitor usage to avoid interruptions.
Troubleshoot issues with these steps:
- Connection Issues: Verify your Shopify Token and Store URL are correct.
- Listings Not Linking: Ensure the Master SKU field (e.g., Shopify Variant - Barcode) matches between Shopify and Flxpoint.
- Import Not Running: Check your sync schedule or run it manually with "Run Sync."
- Other Errors: Review operation details for common errors and resolution steps.
Diagnostic Tip: Listings not linking often results from mismatched Master SKU fields.
Key information:
- Date: As of 09:29 PM -04, May 29, 2025, this integration is operational.
- Master SKU Requirement: Ensure the Master SKU field matches between Shopify and Flxpoint for proper linking.
- API Limits: Monitor Shopify API rate limits to avoid sync interruptions.
Pro Tip: Use "Pause New Listings" to review and link inventory before syncing back to Shopify.
Conclusion
The Shopify Import Listings integration automates the syncing of your Shopify product listings into Flxpoint, ensuring accurate inventory management. Customize settings to fit your workflow, unpause listings as needed, and explore other Shopify integrations like Publish Listings or Sync Orders to enhance your operations. Happy syncing!
Sync & Link Listings
Supported | Shopify - Sync & Link Listings
Introduction to Shopify Sync & Link Listings
Welcome to the Shopify Sync & Link Listings integration guide! This integration ensures that your pricing and quantity data stay consistent between Flxpoint and Shopify by synchronizing channel listings and linking them using a shared identifier. It ensures seamless inventory and pricing updates across platforms. Let’s get started!
The Shopify Sync & Link Listings integration enables you to:
- Sync pricing and quantity data from Flxpoint to Shopify listings.
- Link Flxpoint listings to Shopify listings using a chosen identifier (e.g., SKU or Barcode).
- Specify a Shopify location for syncing inventory data.
The integration follows these steps:
- 1 Connecting to Shopify: Establish a connection using API credentials or OAuth2 authentication to access your Shopify store.
- 2 Identifying Listings: Flxpoint identifies matching listings between Flxpoint and Shopify using a linking identifier (e.g., SKU or Barcode).
- 3 Mapping Data: Maps Flxpoint fields (e.g., List Price, Quantity) to Shopify fields using a mapping template.
-
4 Syncing Data: A POST call to
/admin/api/{version}/inventory_levels/set.jsonupdates Shopify listings with pricing and quantity data for the specified location. - 5 Execution: Run manually with Run Sync or schedule (e.g., daily).
Pro Tip: Schedule regular syncs to keep pricing and inventory data up-to-date across platforms.
Note: API failures pause the integration and trigger notifications.
Customize the integration with these settings:
- Enable Sync Listings: Toggle this on to automatically synchronize pricing and quantity data with Shopify listings.
-
Linking Identifier: Choose the identifier to link Flxpoint and Shopify listings:
- Flxpoint Listing: Options include SKU, ASIN, GTIN, MPN, or UPC.
- Shopify Listing: Options include SKU or Barcode.
- Location ID: Select the Shopify location to sync inventory data with (e.g., Shop Location). Learn more at Shopify Locations Documentation.
- Scheduling: Run manually or schedule (e.g., daily at 6 AM UTC).
- Mapping Template: Define which Flxpoint fields sync to Shopify (e.g., List Price to Shopify Variant - Price).
Note: Ensure the linking identifier matches between Flxpoint and Shopify to avoid sync failures.
Follow these steps:
- 1 Add the Integration: Go to Channels > Shopify > Integrations, select “Sync & Link Listings.”
- 2 Connect to Shopify: Use your Shopify Token and Store URL or set up a new connection via OAuth2 authentication.
-
3 Configure Settings:
- Toggle on "Enable Sync Listings."
- Select the linking identifier (e.g., SKU for both Flxpoint and Shopify).
- Choose the Shopify Location ID (e.g., Shop Location).
- Configure scheduling (e.g., daily at 6 AM UTC).
- 4 Create Mapping Template: Configure field mappings (see Mapping Template Details).
- 5 Run the Integration: Start with Run Sync or schedule automatic syncs.
Mapping templates control which Flxpoint data is synced to Shopify.
Interface Overview
- Screen labeled “Sync & Link Listings” at the top; name your template (e.g., “Shopify Sync & Link Listings 1”).
- Buttons: Delete, Duplicate, Save Mapping.
- Columns: Flxpoint fields (left), Shopify fields (right).
Mapping Options
- Enable: Send the field (e.g., Quantity).
- Disable: Ignore the field (e.g., Estimated Cost).
- Required Fields: Quantity is enabled by default for proper syncing.
Quantity Mapping Requirement
The Quantity field must be enabled to ensure proper inventory syncing.
- Required Field: Quantity ensures accurate inventory levels in Shopify.
-
Error Scenario: Disabling Quantity may cause:
Invalid request: Missing required field 'Quantity' for inventory sync
- Fix: Go to Channels > Shopify > Templates > Sync & Link Listings > Field Mapping, enable Quantity, save, and re-run sync.
Recommendation: Always enable Quantity for reliable inventory syncing.
Complete Field Mappings
Below are the fields you can enable for syncing:
Variant Fields
| Flxpoint Field | Maps To | Data Type | Example | Purpose | Status |
|---|---|---|---|---|---|
| Estimated Cost | Shopify Variant - Cost | Number | $20 | Sets variant cost | Disabled by Default |
| List Price | Shopify Variant - Price | Number | $30 | Sets selling price | Disabled by Default |
| MSRP | Shopify Variant - Compare At Price | Number | $50 | Sets suggested retail price | Disabled by Default |
| Quantity | Shopify Variant - Quantity | Number | 50 | Sets inventory quantity | Enabled by Default |
Practice Mapping
Try enabling/disabling Flxpoint - Quantity:
Here’s what data Flxpoint can sync to Shopify:
- Cost: Supported (optional, can be disabled in mapping).
- Price: Supported (optional, can be disabled in mapping).
- Compare At Price (MSRP): Supported (optional, can be disabled in mapping).
- Quantity: Supported (enabled by default).
Be aware of these limitations:
- Linking Identifier Match: The linking identifier (e.g., SKU) must match between Flxpoint and Shopify to avoid sync failures.
- Location ID Validity: The Location ID must correspond to a valid Shopify location for accurate syncing.
- Field Syncing: Only fields enabled in the mapping template will be synced to Shopify.
- API Rate Limits: Shopify API rate limits may affect large sync jobs; monitor usage to avoid interruptions.
Troubleshoot issues with these steps:
- Connection Issues: Verify your Shopify Token and Store URL are correct.
- Listings Not Linking: Ensure the linking identifier (e.g., SKU) matches between Flxpoint and Shopify.
- Sync Not Running: Check your sync schedule or run it manually with "Run Sync."
- Data Not Syncing: Confirm that the fields are enabled in the mapping template.
-
Product Does Not Exist Error: If you see:
GraphQL Request Failed: Product variant does not existThe product may have been deleted in Shopify but is still linked in Flxpoint. Unlink the product in Flxpoint and re-link it to the correct Shopify product.
- Title or Variant Mismatch: If syncing fails due to a mismatch (e.g., different parent titles or variant structures), ensure the product title and variant structure in Flxpoint match Shopify. Align titles and consolidate variants in Shopify if needed.
Diagnostic Tip: Sync failures often result from mismatched linking identifiers or disabled fields in the mapping template.
Key information:
- Date: As of 09:31 PM -04, May 29, 2025, this integration is operational.
- Required Fields: Quantity must be enabled in the mapping template.
- API Limits: Monitor Shopify API rate limits to avoid sync interruptions.
Pro Tip: Ensure linking identifiers match and enable Quantity for reliable syncing.
Conclusion
The Shopify Sync & Link Listings integration automates pricing and inventory updates, ensuring consistency between Flxpoint and Shopify. Monitor sync logs via "View Logs" to ensure smooth operation, and explore other Shopify integrations like Publish Listings or Get Orders to further streamline your workflow. Happy syncing!
Publish Listings
Supported | Shopify - Publish Listings
Introduction to Shopify Publish Listings
Welcome to the Shopify Publish Listings integration guide! This integration allows you to create and publish product listings from Flxpoint to your Shopify store, ensuring seamless inventory management. It ensures your product data is accurately reflected on Shopify, supporting features like variant positioning and smart collections. Let’s get started!
The Shopify Publish Listings integration enables you to:
- Create new Shopify listings using product data from Flxpoint.
- Update existing Shopify listings by matching Location IDs.
- Support variant positioning and smart collections for better product organization.
The integration follows these steps:
- 1 Connecting to Shopify: Establish a connection using API credentials or OAuth2 authentication to access your Shopify store.
- 2 Mapping Data: Maps Flxpoint fields (e.g., Title, SKU, Images) to Shopify fields using a mapping template.
-
3 Publishing Listings: A POST call to
/admin/api/{version}/products.jsoncreates or updates Shopify listings for the specified location. - 4 Handling Variants: Variants are positioned according to specified option names and values (e.g., Color, Size).
- 5 Title Truncation: Titles exceeding 255 characters are handled based on your settings (truncate or fail).
- 6 Execution: Run manually with Run Sync or schedule (e.g., daily).
Pro Tip: Schedule regular syncs to keep your Shopify listings up-to-date with Flxpoint data.
Note: API failures pause the integration and trigger notifications.
Customize the integration with these settings:
- Enable Publish Listings: Toggle this on to start publishing listings to Shopify.
- Location ID: Select the Shopify location to publish listings to (e.g., Shop Location). Learn more at Shopify Locations Documentation.
- Should Additional Variant Images Be Added?: Enable this to upload variant images for products with a parent image.
-
Truncate Title to 255: Choose how to handle titles exceeding 255 characters:
- Fail Product: Fails the listing if the title is too long.
- Truncate Title to 255: Trims the title to 255 characters.
- Namespace: Optionally set a namespace for metafield fields.
- Use Underscore in Meta Fields Name: Enable this to use underscores as separators in meta field names.
- Advanced Image Duplication Logic: Enable this to prevent duplicate image uploads by caching images using MD5 checksums.
- Auto-Create Smart Collection on "Product Type": Enable this to automatically create Shopify Smart Collections for mapped product types. Learn more at Shopify Smart Collections API.
- Scheduling: Run manually or schedule (e.g., daily at 6 AM UTC).
Note: Ensure the Location ID matches a valid Shopify location for accurate publishing.
Follow these steps:
- 1 Add the Integration: Go to Channels > Shopify > Integrations, select “Publish Listings.”
- 2 Connect to Shopify: Use your Shopify Token and Store URL or set up a new connection via OAuth2 authentication.
-
3 Configure Settings:
- Toggle on "Enable Publish Listings."
- Select the Shopify Location ID (e.g., Shop Location).
- Enable "Should Additional Variant Images Be Added?" if needed.
- Choose title handling ("Fail Product" or "Truncate Title to 255").
- Configure advanced settings (Namespace, Underscore in Meta Fields, Image Duplication Logic, Smart Collections) as needed.
- Configure scheduling (e.g., daily at 6 AM UTC).
- 4 Create Mapping Template: Configure field mappings (see Mapping Template Details).
- 5 Run the Integration: Start with Run Sync or schedule automatic syncs.
Mapping templates control which Flxpoint data is published to Shopify.
Interface Overview
- 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), Shopify fields (right).
Mapping Options
- Enable: Send the field (e.g., Title, SKU).
- Disable: Ignore the field (e.g., Client Pricing).
- Required Fields: Title and SKU are required for proper publishing.
Title and SKU Mapping Requirement
The Title and SKU fields must be enabled to ensure proper listing creation.
- Required Fields: Title and SKU uniquely identify the product and variants.
-
Error Scenario: Missing Title or SKU may cause:
Invalid request: Missing required fields 'Title' or 'SKU' for listing creation
- Fix: Go to Channels > Shopify > Templates > Publish Listings > Field Mapping, enable Title and SKU, save, and re-run sync.
Recommendation: Always enable Title, SKU, and Images for reliable listing publishing.
Complete Field Mappings
Below are the fields you can enable for publishing:
Product Fields
| Flxpoint Field | Maps To | Data Type | Example | Purpose | Status |
|---|---|---|---|---|---|
| Brand | Shopify Product - Vendor | Text | BrandX | Sets product vendor | Supported |
| Title | Shopify Product - Title | Text | Blue T-Shirt | Sets product title | Required |
| Description | Shopify Product - Body HTML | Text | Comfortable cotton t-shirt | Sets product description | Supported |
| Product Images | Shopify Product - Product Images | Text | image_url.jpg | Sets product images | Supported |
| Category 1 | Shopify Product - Product Type | Text | gid://shopify/Taxonomy/Category/ap-1 | Sets product type | Supported |
| All Attributes | Shopify Product - Attributes to Metafields | Text | color: blue | Sets metafields | Supported |
Variant Fields
| Flxpoint Field | Maps To | Data Type | Example | Purpose | Status |
|---|---|---|---|---|---|
| SKU | Shopify Variant - SKU | Text | variant-sku-001 | Identifies the variant | Required |
| List Price | Shopify Variant - Price | Number | $30 | Sets selling price | Supported |
| Quantity | Shopify Variant - Quantity | Number | 50 | Sets inventory quantity | Supported |
| Image | Shopify Variant - Image | Text | variant_image_url.jpg | Sets variant image | Supported |
| Options (e.g., Color, Size) | Shopify Variant - Options | Text | Color: Blue, Size: Medium | Sets variant options | Supported |
Variant Images
- Publishing Variant Images: Enable "Should Additional Variant Images Be Added?" in the configuration settings to upload variant-specific images alongside the parent product image. Images must meet Shopify’s requirements: minimum size of 4472x4472 pixels and maximum file size of 20 MB.
- Variant Positioning: When creating a listing, variants are positioned based on the order of options (e.g., Color, Size). For updates, variants are matched by option names. If the parent-variant structure differs, updates are limited to matching option names. Note that positioning only applies to new listings; for existing listings, new variants are added last, and their position won’t change.
- Recent Update to Variant Image Publishing: If a Shopify listing already has an image attached to a variant and you try to update it with a new image, Shopify might show an error about the image being "already attached." We've updated the Publish Listings integration to handle this smoothly—it will now automatically remove the old image and add the new one for you. To apply this update to existing listings, simply run an "Override" job, and the new image will be published correctly.
Category Mapping
Map your internal categories to Shopify’s Taxonomy using global IDs:
- Use the Shopify Product Taxonomy at Shopify Taxonomy.
- Example: Mapping "Live Animals" to
gid://shopify/Taxonomy/Category/ap-1. - Create mapping sets or rules to automate category translation (e.g., if Category 1 equals "Live Animals", set Shopify Product - Product Type to
gid://shopify/Taxonomy/Category/ap-1).
Practice Mapping
Try enabling/disabling Flxpoint - Title:
Here’s what data Flxpoint can publish to Shopify:
- Custom Fields: Supported. Parent and variant metafields can be uploaded as single-line text metafields.
- Attributes/Tags: Supported. Attributes can be uploaded as metafields.
- Variants/Options: Supported. Up to 100 variants per product, with up to three options.
- Generic Pricing: Supported. Cost, list price, and MSRP as regular values; MAP as metafield.
- Client Pricing: Not supported.
- Quantity: Supported.
- Multiple Warehouses: Not supported.
- Weight & Dimensions: Supported. Weight in oz, lb, kg, g; dimensions as metafields.
- Images: Supported. Uses Fix Hosted URLs; minimum size 4472x4472 pixels, up to 20 megabytes.
- Categories: Supported. Single category; other levels as tags.
- Offerings vs. Creation: Supported. New product creation is supported.
- Option Limitations: Supported. Up to three options per product.
- HTML Description: Supported.
- Publishing Limits: Regular Shopify accounts allow 1000 products/day; Shopify Plus accounts have higher limits.
Be aware of these limitations:
- Client Pricing Not Supported: Client pricing isn’t supported; set it manually in Shopify.
- Multiple Warehouses Not Supported: Data is published for a single location only.
- Image Requirements: Images must be at least 4472x4472 pixels and under 20 MB.
- API Rate Limits: Shopify API rate limits may affect large publishing jobs; monitor usage to avoid interruptions.
Troubleshoot issues with these steps:
- Connection Issues: Verify your Shopify Token and Store URL are correct.
- Variant Update Fails: Ensure option names match between Flxpoint and Shopify.
- Image Upload Fails: Check image size (minimum 4472x4472 pixels, maximum 20 MB).
- Sync Not Running: Check your sync schedule or run it manually with "Run Sync."
-
Product Does Not Exist Error: If you see:
This product does not exist on the user storeThe product may have been deleted in Shopify but is still linked in Flxpoint. Unlink the product in Flxpoint and re-link it to the correct Shopify product.
- Title or Variant Mismatch: If publishing fails due to a mismatch (e.g., different parent titles or variant structures), ensure the product title and variant structure in Flxpoint match Shopify. Align titles and consolidate variants in Shopify if needed.
Diagnostic Tip: Publishing failures often result from mismatched option names or unsupported image sizes.
Key information:
- Date: As of 09:34 PM -04, May 29, 2025, this integration is operational.
- Required Fields: Title and SKU must be enabled in the mapping template.
- API Limits: Monitor Shopify API rate limits to avoid sync interruptions.
Pro Tip: Enable "Advanced Image Duplication Logic" to avoid duplicate image uploads and optimize publishing.
Conclusion
The Shopify Publish Listings integration automates the creation and updating of product listings on Shopify, ensuring your store reflects accurate Flxpoint data. Adjust mappings and settings to fit your needs, and explore other Shopify integrations like Import Listings or Sync Orders to enhance your workflow. Happy publishing!
Order Operations
Get Orders
Supported | Shopify - Get Orders
Introduction to Shopify Get Orders
Welcome to the Shopify Get Orders integration guide! This integration imports orders from Shopify into Flxpoint for centralized order management. It ensures you can track and process Shopify orders efficiently within Flxpoint, supporting filters for fulfillment and financial statuses. Let’s get started!
The Shopify Get Orders integration enables you to:
- Import orders from Shopify into Flxpoint for centralized management.
- Filter orders by fulfillment status (e.g., Unfulfilled) and financial status (e.g., Paid).
- Link Shopify orders to Flxpoint listings for seamless processing.
The integration follows these steps:
- 1 Connecting to Shopify: Establish a connection using API credentials or OAuth2 authentication to access your Shopify store.
-
2 Fetching Order Data: A GET call to
/admin/api/2023-10/orders.jsonretrieves orders based on configured filters. - 3 Filtering Orders: Filters orders by fulfillment status (e.g., Unfulfilled), financial status (e.g., Paid), and Location ID.
- 4 Mapping Data: Maps Shopify order fields (e.g., billing address, line items) to Flxpoint fields using a mapping template.
- 5 Importing Orders: Imports orders into Flxpoint, linking them to listings if fulfillable quantity is greater than 0.
- 6 Execution: Run manually with Run Sync or schedule (e.g., daily).
Pro Tip: Schedule regular syncs to keep your order data up-to-date in Flxpoint.
Note: Orders are processed in batches for efficiency; API failures pause the integration and trigger notifications.
Customize the integration with these settings:
- Enable Get Orders: Toggle this on to import Shopify orders.
- Location ID: Select the Shopify location to import orders from. Orders with a different location are skipped unless you enable “Import Orders with No Location ID.”
- Import Orders with No Location ID: Enable this to import orders lacking a location; disabled by default (skips such orders).
- Get Orders with Fulfillment Status: Choose statuses to import: Unfulfilled, Partially Fulfilled, Fulfilled. Note that “Scheduled” and “On Hold” are not supported.
- Get Orders with Financial Status: Choose statuses to import: Any, Authorized, Pending, Paid, Partially Paid, Partially Refunded, Voided, Unpaid.
- Personal Identifying Information Retention: Choose retention period: Indefinitely, or 30/60/90 days after shipment.
- Upload Tag to Shopify Order After Importing: Add a tag to Shopify orders after import (e.g., “Received by Flxpoint”).
- Get Orders Updated in the Last X Days: Set the time frame for importing updated orders (e.g., last 14 days).
Advanced Options
-
Read Location From Fulfillment Order: Disabled by default. When enabled, Flxpoint will:
- Fetch each order’s Fulfillment Order via a separate API call.
- If exactly one Fulfillment Order exists, use its assigned location ID.
- Skip orders with zero or multiple Fulfillment Orders.
- Compare that location ID with your configured filter.
Note: Ensure your fulfillment and financial status filters match your order management needs to avoid missing orders.
Follow these steps:
- 1 Add the Integration: Go to Channels > Shopify > Integrations, select “Get Orders.”
- 2 Connect to Shopify: Use your Shopify Token and Store URL or set up a new connection via OAuth2 authentication.
-
3 Configure Settings:
- Toggle on "Enable Get Orders."
- Select the Location ID and other filters (fulfillment status, financial status, etc.).
- Configure retention period for personal information.
- Add a tag to Shopify orders after import (optional).
- Set the time frame for updated orders (e.g., last 14 days).
- Enable advanced options like "Read Location From Fulfillment Order" if needed.
- Configure scheduling (e.g., daily at 6 AM UTC).
- 4 Create Mapping Template: Configure field mappings (see Mapping Template Details).
- 5 Run the Integration: Start with Run Sync or schedule automatic syncs.
Mapping templates control which Shopify order data is imported into Flxpoint.
Interface Overview
- Screen labeled “Get Orders” at the top; name your template (e.g., “Shopify Get Orders 1”).
- Buttons: Delete, Duplicate, Save Mapping.
- Columns: Shopify fields (left), Flxpoint fields (right).
Mapping Options
- Enable: Import the field (e.g., Order ID).
- Disable: Ignore the field (e.g., Custom Attributes).
- Required Fields: Order ID and Line Items are required for proper order import.
Order ID and Line Items Mapping Requirement
The Order ID and Line Items fields must be enabled to ensure proper order importing.
- Required Fields: Order ID and Line Items uniquely identify the order and its products.
-
Error Scenario: Missing Order ID or Line Items may cause:
Invalid request: Missing required fields 'Order ID' or 'Line Items' for order import
- Fix: Go to Channels > Shopify > Templates > Get Orders > Field Mapping, enable Order ID and Line Items, save, and re-run sync.
Recommendation: Always enable Order ID, Line Items, and billing/shipping addresses for accurate order importing.
Complete Field Mappings
Below are the fields you can enable for importing:
Order Fields
| Shopify Field | Maps To | Data Type | Example | Purpose | Status |
|---|---|---|---|---|---|
| Shopify Order - ID | Flxpoint Order ID | Number | 123456789 | Identifies the order | Required |
| Shopify Order - Financial Status | Flxpoint Financial Status | Text | Paid | Sets payment status | Supported |
| Shopify Order - Fulfillment Status | Flxpoint Fulfillment Status | Text | Unfulfilled | Sets fulfillment status | Supported |
| Shopify Order - Tags | Flxpoint Order Tags | Text | Received by Flxpoint | Sets order tags | Supported |
Line Item Fields
| Shopify Field | Maps To | Data Type | Example | Purpose | Status |
|---|---|---|---|---|---|
| Shopify Line Item - SKU | Flxpoint Line Item SKU | Text | item-sku-001 | Identifies the product | Required |
| Shopify Line Item - Fulfillable Quantity | Flxpoint Line Item Quantity | Number | 2 | Sets quantity to fulfill | Supported |
| Shopify Line Item - Price | Flxpoint Line Item Price | Number | $30 | Sets item price | Supported |
Address Fields
| Shopify Field | Maps To | Data Type | Example | Purpose | Status |
|---|---|---|---|---|---|
| Shopify Billing Address - Address 1 | Flxpoint Billing Address - Address 1 | Text | 123 Main St | Sets billing address | Supported |
| Shopify Shipping Address - Address 1 | Flxpoint Shipping Address - Address 1 | Text | 456 Oak St | Sets shipping address | Supported |
Practice Mapping
Try enabling/disabling Shopify Order - ID:
Be aware of these limitations:
- Fulfillment Status Support: “Scheduled” and “On Hold” statuses are not supported; only Unfulfilled, Partially Fulfilled, and Fulfilled are importable.
- Location ID Filtering: Orders with a different Location ID are skipped unless “Import Orders with No Location ID” is enabled.
- Fulfillable Quantity Requirement: Orders must have a fulfillable quantity greater than 0 to be linked to Flxpoint listings.
- API Rate Limits: Shopify API rate limits may affect large import jobs; monitor usage to avoid interruptions.
Troubleshoot issues with these steps:
- Orders Not Importing: Check your fulfillment and financial status filters to ensure they match the orders you want to import.
- Location ID Issues: Verify the Location ID matches the orders, or enable “Import Orders with No Location ID” to include orders without a location.
- Missing Data: Confirm that required fields (e.g., Order ID, Line Items) are enabled in the mapping template.
- Sync Not Running: Check your sync schedule or run it manually with "Run Sync" and view logs for details.
Diagnostic Tip: Missing orders often result from mismatched Location IDs or restrictive status filters.
Key information:
- Date: As of 09:36 PM -04, May 29, 2025, this integration is operational.
- Required Fields: Order ID and Line Items must be enabled in the mapping template.
- API Limits: Monitor Shopify API rate limits to avoid sync interruptions.
Pro Tip: Use the “Upload Tag to Shopify Order After Importing” feature to easily track imported orders in Shopify.
Conclusion
The Shopify Get Orders integration streamlines order management by importing Shopify orders into Flxpoint. Monitor sync logs via "View Logs" to ensure smooth operation, and explore other Shopify integrations like Sync & Link Listings or Auto-Generate Fulfillment Requests to further automate your workflow. Happy importing!
Sync Orders
Supported | Shopify - Sync Orders
Introduction to Shopify Sync Orders
Welcome to the Shopify Sync Orders integration guide! This integration ensures that order data, such as fulfillment and shipment details, stays consistent between Flxpoint and Shopify. It helps you keep Shopify updated with tracking information and order statuses, supporting partial shipments and multiple locations. Let’s get started!
The Shopify Sync Orders integration enables you to:
- Sync fulfillment data, including tracking information, from Flxpoint to Shopify.
- Handle orders with multiple Location IDs, ensuring all items are synced correctly.
- Support partial shipments, marking orders as Partially Shipped until fully completed.
The integration follows these steps:
- 1 Connecting to Shopify: Establish a connection using API credentials or OAuth2 authentication to access your Shopify store.
- 2 Identifying Orders: Flxpoint identifies orders in Flxpoint that need to be synced to Shopify based on their status and Location ID.
- 3 Mapping Data: Maps Flxpoint fields (e.g., Tracking Number, Carrier) to Shopify fields using a mapping template.
-
4 Syncing Fulfillment Data: A POST call to
/admin/api/2023-10/fulfillments.jsonupdates Shopify with fulfillment details for the specified location. - 5 Handling Partial Shipments: Marks orders as Partially Shipped until fully completed, supporting multiple Location IDs.
- 6 Execution: Run manually with Run Sync or schedule (e.g., daily).
Pro Tip: Schedule regular syncs to keep Shopify updated with the latest fulfillment information.
Note: API failures pause the integration and trigger notifications.
Customize the integration with these settings:
- Enable Sync Orders: Toggle this on to automatically synchronize order data with Shopify.
- Location ID: Select the Shopify location to sync order data with (e.g., Shop Location). Learn more at Shopify Locations Documentation.
- Sync "Closed" Order Status Back to Shopify: Enable this to sync and archive only future orders from Shopify for orders with partial or no fulfillment data.
- Scheduling: Run manually or schedule (e.g., daily at 6 AM UTC).
Note: Ensure the Location ID matches a valid Shopify location to avoid sync failures.
Follow these steps:
- 1 Add the Integration: Go to Channels > Shopify > Integrations, select “Sync Orders.”
- 2 Connect to Shopify: Use your Shopify Token and Store URL or set up a new connection via OAuth2 authentication.
-
3 Configure Settings:
- Toggle on "Enable Sync Orders."
- Select the Shopify Location ID (e.g., Shop Location).
- Enable "Sync 'Closed' Order Status Back to Shopify" if desired.
- Configure scheduling (e.g., daily at 6 AM UTC).
- 4 Create Mapping Template: Configure field mappings (see Mapping Template Details).
- 5 Run the Integration: Start with Run Sync or schedule automatic syncs.
Mapping templates control which Flxpoint fulfillment data is synced to Shopify.
Interface Overview
- 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), Shopify fields (right).
Mapping Options
- Enable: Sync the field (e.g., Tracking Number).
- Disable: Ignore the field (e.g., Notify Customer).
- Required Fields: Tracking Number is required for proper fulfillment syncing.
Tracking Number Mapping Requirement
The Tracking Number field must be enabled to ensure proper fulfillment syncing.
- Required Field: Tracking Number uniquely identifies the shipment in Shopify.
-
Error Scenario: Missing Tracking Number may cause:
Invalid request: Missing required field 'Tracking Number' for fulfillment sync
- Fix: Go to Channels > Shopify > Templates > Sync Orders > Field Mapping, enable Tracking Number, save, and re-run sync.
Recommendation: Always enable Tracking Number, Tracking URL, and Carrier for reliable fulfillment syncing.
Complete Field Mappings
Below are the fields you can enable for syncing:
Fulfillment Fields
| Flxpoint Field | Maps To | Data Type | Example | Purpose | Status |
|---|---|---|---|---|---|
| Carrier | Shopify Fulfillment - Tracking Company | Text | UPS | Sets the carrier | Supported |
| Notify Customer | Shopify Fulfillment - Notify Customer | Boolean | False | Notifies the customer | Supported (Default: False) |
| Tracking Number | Shopify Fulfillment - Tracking Number | Text | 1Z9999W999999999 | Sets the tracking number | Required |
| Tracking URL | Shopify Fulfillment - Tracking URL | Text | https://ups.com/track | Sets the tracking URL | Supported |
Practice Mapping
Try enabling/disabling Flxpoint - Tracking Number:
Here’s what data Flxpoint can sync to Shopify:
- Platform Notifications: Supported. Notify Customer can be set as True or False per mapping.
- Partial Weekly Shipments: Supported.
- Partial Order Item Shipments: Supported. Partial shipments are marked as Partially Shipped; fully shipped orders are marked as Shipped.
- Post-Shipment Status Updates: Supported.
- Manual Order Item Fulfillments: Not supported.
Be aware of these limitations:
- Multiple Location IDs: For orders with multiple Location IDs, shipments are synced only when available for all items; failed shipments are retried in the next sync job.
- Location ID Validity: The Location ID must correspond to a valid Shopify location for accurate syncing.
- Field Syncing: Only fields enabled in the mapping template will be synced to Shopify.
- Manual Fulfillments: Manual order item fulfillments are not supported.
- API Rate Limits: Shopify API rate limits may affect large sync jobs; monitor usage to avoid interruptions.
Troubleshoot issues with these steps:
- Connection Issues: Verify your Shopify Token and Store URL are correct.
- Sync Fails for Multiple Locations: Ensure all items in the order are available for shipment at the specified Location ID.
- Data Not Syncing: Confirm that required fields (e.g., Tracking Number) are enabled in the mapping template.
- Sync Not Running: Check your sync schedule or run it manually with "Run Sync."
Diagnostic Tip: Sync failures often result from mismatched Location IDs or disabled fields in the mapping template.
Key information:
- Date: As of 09:37 PM -04, May 29, 2025, this integration is operational.
- Required Fields: Tracking Number must be enabled in the mapping template.
- API Limits: Monitor Shopify API rate limits to avoid sync interruptions.
Pro Tip: Enable "Sync 'Closed' Order Status Back to Shopify" to manage partial or unfulfilled orders more effectively.
Conclusion
The Shopify Sync Orders integration keeps your order data consistent by syncing fulfillment details between Flxpoint and Shopify. Monitor sync logs via "View Logs" to ensure smooth operation, and explore other Shopify integrations like Get Orders or Publish Listings to further streamline your workflow. Happy syncing!