Shopify is a popular online store service.
This is a fully hosted and supported integration for use with the FlowLink product. With this integration you can perform the following functions:
- Send product information to Shopify whenever products are created or updated.
- Send customer and order information to Shopify whenever orders are created or updated.
The following parameters must be setup within FlowLink:
| Name | Value |
|---|---|
| shopify_apikey | Shopify account API key (required) |
| shopify_password | Shopify account password (required) |
| shopify_host | Shopify account host, no 'http://' (required) |
The following webhooks are implemented. For all 'get_' webhooks, a 'shopify_id' field is return that use used to tie a FlowLink object to its corresponding Shopify object.
- get_orders: Retrieves a list of orders from Shopify with all details of line items, taxes, discounts, shipping charges etc in FlowLink official format. Each order's 'id' will be the Shopify order ID, prefixed by either (1) the store's name and a dash (default), or (2) whatever is specified in the "shopify_order_prefix" parameter associated with the flow (note that QuickBooks Desktop will not accept an order number that is longer than 11 characters, so it is best to specify a "shopify_order_prefix" that is very short if you intend to use this integration with any QB Desktop version). 'source' will be set to your shopify_host parameter value. Also returns a list of shipment objects associated with all orders.
- get_products: Retrieves a list of products from shopify. Also returns a list of inventory items, one for each product.
- add_product
- update_product
- get_inventory: Retrieves one inventory items for each product.
- get_shipments: Retrieves shipments recorded in Shopify.
- update_shipment
- get_customers: Retrieves a list of customers from Shopify (based on last updated timestamp).
- add_customer
- update_customer: Note that a known bug exists that makes it impossible to update a customer's address. We are looking into this now with Shopify.
There are various differences between how FlowLink and Shopify handle objects that are worth noting and watching out for:
- Products: First, Shopify only stores SKU and price values in variants, while FlowLink has a sort of base product with a SKU and a price, along with variants, which also have SKUs and prices. This integration ignores FlowLink's base SKU and price and only uses those from variants. Second, Shopify only associates images only with base products, not for each variant, while FlowLink associates images with the base product AND its variants. So, when adding a FlowLink product to Shopify, we add all FlowLink images to the Shopify base product. The 'gotcha' here is that products added to Shopify with images associated with variants will lose that association. Finally, Shopify checks if image URLs are valid prior to adding them, and will fail to add an image URL silently if not.
- Customers: Shopify checks to ensure that customer emails and addresses are unique, and will not add a customer if not.
FlowLink allows you to connect to your own custom integrations. Feel free to modify the source code and host your own version of the integration or better yet, help to make the official integration better by submitting a pull request!
This integration is 100% open source an licensed under the terms of the New BSD License.
