Shopify Integration

This native integration with Shopify enables seamless synchronization of orders, catalogs, and inventory.

Version: v1.0
Date: January 10, 2025
Owner: Sales Channel Product Team

1. Overview

What this integration does

The Shopify integration connects your Shopify store with Omniful so that:

• Orders created on Shopify are automatically synced to Omniful for processing.
• Inventory availability maintained in Omniful can be synced to Shopify.
• Shipments created in Omniful can update shipment status and tracking to Shopify.
• You can configure hub mapping and order status mapping directly from Omniful.

Supported integration types:

• Fulfillment + Shipping: Omniful handles both fulfillment and shipping.
• Shipping Only: Omniful handles only shipping, while order creation, inventory, and catalog remain managed in Shopify.

2. Prerequisites

2.1 Sales Channel Prerequisites

For Shopify Public App Integration, you will need:

• An active Shopify store with permission to install and manage apps.
• Access to the email inbox associated with the Shopify store (to receive the activation code).
  • This email can be found in Shopify → Settings → Store Details.

3. Integration Methods & Setup

3.1 Omniful App on Shopify

3.1.1 To Install Omniful App on Shopify

1. Log in to your Shopify store dashboard.
2. Search “Shopify App Store” → open the Shopify App Store.
   
3. Search Omniful on the App Store and click Install.
   • Note: Make sure you are logged in with the correct store.
     
4. Check your Shopify store email inbox for the activation code required for the next step.
5. After installation, use the Workspace Validator to open your Omniful workspace.
   • Alternatively, share the activation code with your Omniful fulfillment/shipping partner for further steps.

3.2 Integrate Shopify Store with Omniful

Once you have the Activation Code:

1. In the Omniful workspace, go to Settings → App & Integration → Sales Channel Apps.
2. Select the seller for which the Shopify store is being integrated.
3. Locate Shopify from the available sales channels and click Add Store.

For Public Omniful App:

• Type of Integration: Fulfilment + Shipping or Shipping Only
• Activation Code: Enter the code received via email

If you did not receive the code:

• Click Resend Code.
• Enter your Shopify Store URL (e.g., test-store.myshopify.com) and Shopify store email address (found in Shopify → Settings → Store Details).
• Click Resend Code, then continue.

4. Omniful Configuration

Once the store is connected, configure how data flows between Shopify and Omniful.

4.1 Store-Level Settings

Depending on your requirements, you can enable:

• Order Sync: Automatically fetch orders from Shopify to Omniful.
• Catalog Sync: Fetch catalog (active SKUs) from Shopify into Omniful.
• Inventory Sync: Push available inventory from Omniful hubs to Shopify.

4.2 Hub Mapping

Configure how Shopify orders are routed to Omniful hubs:

• Map Omniful hubs to the hubs configured in Shopify.
  

Note: Hub mapping is mandatory for inventory and order sync.

4.3 Order Status Mapping

Defines how Shopify and Omniful statuses stay in sync.

• Sales Channel Mapping: Map incoming Shopify order statuses (e.g., Open, Unfulfilled) to internal Omniful order lifecycle stages (e.g., New, Ready for Picking).

  • Ensure Shopify order statuses are configured correctly—otherwise, new orders may not sync.
  • If the Cancelled status is not mapped, cancellations won’t sync back.

• Omniful Workspace Order Status Mapping: Define which outgoing Omniful fulfillment/shipment statuses update Shopify (e.g., Shipped, Canceled).

Use Fetch Order Status in the configuration screen to load available Shopify statuses, then map them as needed.

4.4 Delivery Type Mapping

Map Shopify shipping profiles to Omniful delivery types.
You can add multiple profiles by copying each Shipping Profile Name and assigning it to a Delivery Type.
This ensures accurate mapping for smooth processing.

4.5 Reason Mapping

Use Omniful’s cancellation and return-decline reasons to reflect corresponding reasons on Shopify.

Manage them under:
Settings → Order Settings → OMS Settings → Reason Configuration.

These reasons can then be mapped to Shopify to maintain consistency.

4.6 Configuration Log

Use the Configuration Log to track all changes to store configurations.

5. Data & Sync Behaviour

5.1 Orders

• Hub-based Sync: Only orders with a mapped hub will be visible in Omniful.
• Status-based Sync: Only orders with mapped statuses will be visible in Omniful.

5.2 Catalog

• The seller’s Shopify catalog (SKUs with valid SKU codes) is fetched automatically when Catalog Sync is enabled.
• Omniful periodically fetches active and live SKUs for order and fulfillment processes.

5.3 Inventory

• Omniful automatically maintains inventory levels on Shopify when Inventory Sync is enabled and hub mapping is done.

5.4 Cancellations

• When Automated Order Cancellation on Sales Channel is enabled, canceling an order in Omniful automatically cancels it in Shopify.

6. FAQs

Q: Do I need Shopify Partner access or just store admin access?
A: Store owner/admin access with permission to install apps is sufficient. Partner access is not required.

Q: Why are some Shopify orders not appearing in Omniful?
A: Ensure correct order status and hub mappings are configured, and that Order Sync is enabled.

Q: Can I control when an order is synced to Omniful?
A: Yes. Configure Order Status Mapping so Omniful only creates orders at specific statuses, e.g., Open.

Q: Who is the inventory master?
A: Omniful is the inventory master. When Inventory Sync is enabled, it pushes updated stock to Shopify.

Q: Who creates shipments for Shopify orders?
A: Omniful manages shipment and delivery; statuses are updated in Shopify automatically.

Q: When does tracking information appear in Shopify?
A: When a shipment is created in Omniful. Tracking number, carrier, and shipping label are sent to Shopify.

Q: What happens if I uninstall or disable the Omniful app?
A: New orders will stop syncing; shipment updates will no longer reach Shopify. Existing orders already in Omniful remain processable but will not sync back until the app is reinstalled.

© 2025 Omniful. All Rights Reserved.
For more information, visit Omniful.ai