Skip to main content

Shopify Integration

Details about available services and how to integrate your Shopify store with Logiwa.

S
Written by Stephanie Kelley
Updated over 3 weeks ago

Logiwa streamlines your business management with our user-friendly self-onboarding process for sales channels. This article will walk you through the available functions and setup of your Shopify sales channel.


Available Functions

  • Download Products: Download product that have been created in your store. Note that products in draft status in Shopify aren't downloaded to Logiwa.

  • Download Orders: Download shipment orders from your store that are ready for shipping.

  • Sync Inventory: Automatically send inventory level changes from Logiwa to your store.

  • Send Shipment Info: Send shipment information directly to your store once the order has been shipped from Logiwa.

  • Get Shipment Order Status Changes: Automatically send the status of orders in your store to update the order statuses in Logiwa.


Connect to Shopify

  • To connect to Shopify, begin by visiting our Store and Marketplace Integrations page.

  • Select Shopify from the available options.

  • A pop-up will open with two pieces of information that need to be entered and API Version needs to be selected. Enter your Shopify Store Name and Access Token, Select your Client and API Version as Rest API or GraphQL, then click Continue to proceed.

  • Once the system has accepted your credentials, you'll enter your new store's details.

  • Note, if you encounter the "This action requires merchant approval for read_orders scope." error, please make sure you have granted Shopify access to the necessary scopes as described in the Access Token article.

Shopify Subscription Plan & API Access to PII

Warning: Shopify's Basic/Starter plans restrict API access to Protected Customer Data (PII) including full names, addresses, and contact info. This

will prevent Logiwa from receiving complete order details, causing sync failures (e.g., "Customer description/code/address cannot be empty") or orders with missing data.

Recommendation: For full data sync, the Shopify store must be on a "Shopify" plan or higher. Include links to Shopify's official documentation. Suppose you are on a "Basic" or "Starter" plan and require access to Shipment and Billing Addresses, along with orders. In that case, you must purchase the Carrier Calculated Shipping (CCS) feature in addition to your Shopify plan.

For further details, please contact Shopify Support.)

Shopify Product Data Setup

  • All fulfillable items must have unique, correctly formatted SKUs

  • Clearly distinguish physical vs. digital/service items. Logiwa IO primarily fulfills physical items; ensure products intended for fulfillment are marked as such on the channel.

  • "Track quantity" must be enabled in Shopify for items at relevant locations.

  • Products must be stocked at, and orders correctly assigned to, the specific location(s) Logiwa IO will be configured to monitor, with

    fulfillable quantity> 0

Shopify Customer & Address Data Completeness

Orders should better have complete customer names (first and last, in appropriate fields, including within address blocks) and full, valid shipping and billing addresses (all lines, city, state, postal code, country).

Shopify Order Statuses (Fulfillment & Financial)

Logiwa imports "Unfulfilled" orders that meet selected financial status criteria (e.g., "Paid"). Orders "Fulfilled," "Closed," "Cancelled," or "Archived" in Shopify are generally for new import.

Shopify Edit Store Connection

General

For the General section, you'll enter your store's basic details. Information on each field is below the screenshot.

Field

Description

Connection Store Name

The original name of your Shopify connection. If no entry is made in the field below, this will be the name displayed in Logiwa. This field cannot be modified.

Store Name

An alternative name for your Shopify connection. Entries in this field can override the above field.

Client(*)

Choose the client from your account that will use this connection.

The Client selected for the Shopify connection must be the Logiwa IO client under whom the corresponding product SKUs are defined. A mismatch can prevent orders from syncing.

Active

Set to Yes to make this connection active. Set to No to make it inactive.

API Version

Select your connection method to Shopify as Rest API or GraphQL. To learn more about API Version, see this article.

  • (*) Critical Note: The Client selected for the Shopify connection must be the Logiwa IO client under whom the corresponding product SKUs are defined. A mismatch can prevent orders from syncing.

  • Customize Tokens: To add tokens for your store, click to expand the Customize Tokens menu. To create these tokens, please complete the Access Token creation process 4 times to receive 4 individual tokens.

    • Shopify tokens serve as secure keys that facilitate data exchange and integration between Shopify's platform and Logiwa IO. Entering different tokens for each process can help resolve throttle issues faced by high-volume Shopify operations.

  • Each token is described in the table below:

Field

Description

Download Product Token

Grants Logiwa IO permission to download product information from Shopify's database, including product names, descriptions, and prices.

Download Orders Token

Grants Logiwa IO permission to retrieve order data from Shopify, including customer details, order items, shipping information, and order status.

Sync Inventory Token

Grants Logiwa IO permission to synchronize inventory levels between Shopify and Logiwa's platform, such as updating stock quantities, tracking product availability, and managing inventory

Send Shipment Token

Grants Logiwa IO permission to send shipment information back to Shopify once orders are fulfilled, including tracking numbers, shipping carriers, and fulfillment status.

  • These tokens are not required.

  • This information is pulled from Shopify every 15 minutes. Pulling this info can be manually activated using the Run button found in the Integration Monitoring section of Logiwa (available for users with access).

    • Information pulled via the Run button will show the data from the last run up to the time the button is used.

  • Once you've input the necessary information, click Next to continue.

Warehouse

In this section, you will assign a warehouse for each location you have in Shopify. Note: You cannot assign the same Shopify location to different Logiwa warehouses, but you can assign multiple Shopify locations to one warehouse.

  • Click Shopify Location List to select from your locations. Then, click the Warehouse created in Logiwa that corresponds to that location.

  • Click Add to add the location to the list.

Shopify Location List*

Choose the location for the products in your Shopify account. This list will automatically generate based on the locations in your Shopify account.

To learn more about your Shopify locations, see this article.

Warehouse*

Choose the warehouse from your account that will use this connection.

  • If you need to remove any locations that have been added, use the Trash icon to remove them.

  • Click Next to continue.

Advanced

In the Advanced section, you'll input the statuses you wish to download from Shopify and any order filtering information necessary.

  • To set the payment statuses you want to download from Shopify, select them from the dropdown menu.

  • Select as many as you need, then click Done to add them.

  • If you want to set Tax ID field of Logiwa Shipment Orders with the value on the Shopify Order's Note Field, Select Tax ID Mapping dropdown as "Shopify Note Field".

Filter Order by Order Tag

  • Next, use the Filter Order by Order Tag if needed. This section allows you to filter the orders that are downloaded from your store according to the tags set in Shopify.

  • If you wish to only download certain orders from Shopify, you can tag them in Shopify, then enter the tags to download here.

An example of a tag and where to add tags in Shopify.

  • Start by choosing your Filter Condition. You can either filter by two methods:

    • Any of the Following Tags: Filter orders by any Shopify tag you enter

    • All Following Tags: Filter for orders ONLY that have all of the following Shopify tags

  • To add a tag, type it under the Order Tag field and Enter. Repeat this process to add additional tags.

  • Use the (X) icon if any tags need to be removed.

  • Click Next to continue.

Configuration

From this section, you'll decide how/what Logiwa imports from Shopify. Expand the sections below to learn more about these functions.

If this is the first store you are connecting to Logiwa, we highly recommend connecting the store with the most comprehensive product catalog. If this is an additional store, we recommend that you check and update your product SKU codes so that your products can be linked in Logiwa. Doing so will prevent any duplicate products from being created.

Download Products

If selected, the system creates unique products in Logiwa based on the SKU in the connected store with the selected Product Unit of Measure (UOM). This allows the system to smoothly import orders with the correct products.

  • If your product does not have a SKU, the system will utilize the product's Title as the SKU in Logiwa.

  • If your product's Seller SKU and Name are not provided, Logiwa will be unable to create the product and will issue a warning in the Integration History section of the Integration Log.

  • When you change the following fields of the product from the connected store, it is reflected in Logiwa:

    • Barcode: Matches to the UPC of the product in Logiwa.

    • Price: Sales price of the product.

    • Image: Image(s) for the product.

    • Title: Matches to the Name and Description fields of the product in Logiwa.

    • Adding Variants: Variants are a different version of the product in Logiwa

  • If you modify any field of the product in Logiwa, these alterations will not have an impact on the store's product.

  • When you delete a product or a variant from your connected store, Logiwa will not automatically delete it.

  • If this option is not enabled, you can manually link your products from the Product Listings tab on the Product screen.

    • When you select not to download products from your store, additional configuration options will be editable under Download Orders to provide options for the system's actions when incoming orders do not have matching products.

  • Products in Draft status on Shopify are not downloaded to Logiwa.

Timing of Product Download

Download Products Service is scheduled to run daily. Press "Download Products" Button on Integration Integration Methods Screen for immediate needs.

Handling Bundles/Kits from Shopify

Shopify "bundle/kit" items appearing as lines without SKUs will cause Order Download Errors. Ensure components are SKU'd under kit item in Logiwa and both kits and components are matched with Shopify Products on Product Listings Screen.


Download Orders

When this option is enabled, Logiwa automatically downloads new sales orders and related customers to assist you in smoothly managing your shipment preparations. This includes tasks such as gathering the necessary products, packing them, printing the packing slip, and more. If this option is not enabled, you will need to manually download orders and add them to the system before proceeding with picking, packing, and shipping orders.

  • Once the setup is completed, Logiwa downloads orders that are in Paid Status.

  • Download Orders are created with the selected Shipment Order Type.

  • Draft, Fulfilled, or Cancelled orders are not downloaded to Logiwa.

  • After an order is downloaded to Logiwa, if it is cancelled from the store, Logiwa marks the order as Cancelled as well.

  • If an order has been downloaded into Logiwa, and subsequently an update from Shopify indicates that all order lines have been removed or there's no fulfillable quantity remaining at the associated Shopify Location(s) for any of the order's items, Logiwa will automatically mark that order as Cancelled as well.

    • When an order is marked Cancelled, this cannot be undone.

    • If you cancel or delete an order in Logiwa, this action will not be sent to your store.

  • In addition to new orders, changes made to existing orders will be reflected after orders have been re-downloaded. For instance, if the Shipping Address of an order has been changed, you will see the same changes in Logiwa.

Download Open Order From

When "All Time" is selected, Shopify orders created up to 2 months ago will be downloaded.

When "Specific Date" is selected, Shopify Orders created after the selected Date / Time will be downloaded.

"Specific Date" can be selected within the range from the selection day to two months ago. If you try to select a date more than two months ago, A Pop-up will appear and will not let you "Save" the setup.

Let Logiwa Create Partial Orders

Becomes editable only when you have chosen not to download products.

When selected, Logiwa will create partial orders based only on the products that have been added to our system. It will not create new products for those that have not been created. This is an either/or selection with the option below.

Create Nonexistent Products When Orders Are Downloaded

Becomes editable only when you have chosen not to download products.

When selected, Logiwa will create a new entry in Logiwa for products downloaded from Shopify that do not already have an entry. This will allow products to be added automatically. This is an either/or selection with the option above.

Impact of 'Download Products' / 'Create Nonexistent Products' being OFF:

All products must be manually created in Logiwa AND manually linked via Product Listings. Failure leads to errors.

Integrating with Orders from Third-Party Apps via Shopify (e.g., TikTok Shop)

  • Fulfillment Location assignment in Shopify must match Logiwa's filter.

  • The timing of data availability by these apps (order details might be initially incomplete).

  • Ensure product SKUs are known to Logiwa.


Sync Inventory

Essential Prerequisites

  • "Sync Inventory" Toggle must be ON in Logiwa.

  • Logiwa must have positive sellable inventory.

  • Shopify Products must be Downloaded/Created & Linked in Logiwa.

Selecting Logiwa's Sync Inventory option ensures that your Shopify inventory stays up-to-date. Logiwa will automatically send inventory updates to your store whenever a new sales order is received or if there are any changes in quantity within the inventory.

Note, if you stop tracking the inventory level of a product from your Shopify store, Logiwa will not sync the inventory of that product.

This option can be enabled once the initial setup has been completed. If it is not enabled, you will need to manually update the inventory of your Shopify store as inventory levels in Logiwa change due to inventory movement.

When the Available Inventory Sync Method is selected, Logiwa will send the available to sales inventory count to Shopify (with reducing the open order quantity in Logiwa). Shopify will then add any open orders(committed quantity) on their platform to calculate the On Hand quantity for sale.

When the On Hand Inventory Sync Method is selected, Logiwa will send the physical inventory count to Shopify (without reducing by the open order quantity in Logiwa). Shopify will then deduct any open orders on their platform to calculate the Available quantity for sale. Please note that On Hand Quantity should only be used when Shopify is the only selling channel for that inventory.

Logiwa's Event-Driven Sync Triggers for Inventory: Logiwa primarily sends inventory updates when an inventory change event occurs in Logiwa for a synced SKU. Simply enabling a sync toggle for a store with existing unchanged inventory might not push everything without a specific trigger.

Main Event-Driven Sync Triggers

When “Sync Inventory” is activated

Incoming Shipment Order from any source other than the channel

Receiving Process / Shipment Order cancellations

Inventory Sync with Location Change (if the transfer is changing the available to sale quantity)

Positive Adjustment ( Count & Inventory Adjustment)

Negative Adjustment ( Count & Inventory Adjustment)

Adding/ Removing damage reason

Receiving Process

Event that Doesn't Trigger Sync Inventory

When, “Sync Inventory” is deactivated.

Incoming Shipment Order from the channel.

Send Shipment Info to My Store

If Send Shipment Info to My Store option is activated, when you ship an order in Logiwa with a Tracking Number, a fulfillment message is sent to Shopify as well. Shopify updates the order as Fulfilled or Partially Fulfilled according to the order's Logiwa Status (Shipped or Partially Shipped).

If this option is not activated, Shopify will not update the order when the order is shipped, and any shipment info will need to be added manually to your store.

Critical Note: If the order is manually updated in Logiwa after the order is downloaded (e.g., an item is added or removed—even if the same item is re-added, or quantities are changed), this breaks the Send Shipment Info logic and prevents fulfillment updates from being sent to Shopify.


  • To complete the setup, click the Save button.

  • This will start the "Initial Process", which can take some time.

  • When the store has been integrated successfully, the status will change to Completed.


Couldn’t Find What You Were Looking For?

Visit our Help Center to search more documents!

Did this answer your question?