This guide will help you set up integration between your Shopify store and Orderry. You will learn how to prepare your Shopify account and connect your store to automatically import orders, clients, and products.
Once set up, data will be synchronized every minute, and working with orders will become fast and convenient.
Important: New Shopify stores are connected via the GraphQL Admin API. Stores that were previously connected using the legacy API continue to work correctly — no additional action is required.
Step 1. Prepare your Shopify account
You need to create and install the app from the store owner's account in Shopify.
1. In your Shopify store, go to My store > Dev Dashboard.
2. Click Create app.
3. Enter the name of the app (e.g, Orderry) and click Create.
4. On the next page (Versions), in the Access block, in the Scopes field, enter the following text:
Read_assigned_fulfillment_orders,write_assigned_fulfillment_orders,read_audit_events,read_customer_events,read_companies,read_custom_fulfillment_services,write_custom_fulfillment_services,read_customers,read_customer_data_erasure,read_customer_merge,read_delivery_customizations,read_price_rules,read_discounts,read_discounts_allocator_functions,read_discovery,read_files,read_fulfillment_constraint_rules,read_fulfillments,read_gift_card_transactions,read_gift_cards,write_inventory,read_inventory,write_inventory_shipments,read_inventory_shipments,write_inventory_shipments_received_items,read_inventory_shipments_received_items,write_inventory_transfers,read_inventory_transfers,read_delivery_option_generators,read_locations,read_marketing_integrated_campaigns,read_marketing_events,read_merchant_managed_fulfillment_orders,write_merchant_managed_fulfillment_orders,read_metaobject_definitions,read_metaobjects,write_order_edits,read_order_edits,read_orders,write_orders,read_payment_customizations,read_product_feeds,write_product_feeds,read_product_listings,write_product_listings,read_products,write_products,read_publications,read_returns,write_returns,read_shopify_payments_provider_accounts_sensitive,read_shipping,read_shopify_payments_accounts,read_shopify_payments_payouts,read_shopify_payments_bank_accounts,read_shopify_payments_disputes,read_content,write_content,read_third_party_fulfillment_orders,write_third_party_fulfillment_orders,read_translations,write_translations
5. Click Release at the bottom of the page, add the version name (e.g., 1) in the pop-up window, and click Release.
6. Go to the Home section and click Install app in the Installs block.
7. Select the store for which you want to install this app.
❗ If you have multiple stores, you need to create a separate app for each one.
8. Click Install.
9. Go back to My store > Dev Dashboard and open the app you created.
10. Go to the Settings section and copy the Client ID and Secret in the Credentials block.
The app setup in Shopify is complete! Next, you need to connect Shopify to the Orderry.
Step 2. Connecting your Shopify store to the Orderry
1. Go to Settings > E-commerce Connect.
2. Click + Shop and check the Integration enabled checkbox.
3. In the Source field, select Shopify.
4. Fill in all the required fields:
Name — shop name;
Website URL — link to your Shopify website (for example, gadgetlytest.myshopify.com)
Client ID — paste the Client ID copied from the app settings in Shopify;
Client Secret — paste the Secret copied from the app settings in Shopify;
Location — select the location where orders from Shopify will be created;
Order Type — select the type of orders imported from Shopify;
💡 Tip
Create a special order type only for orders from Shopify and configure the fields you need in it.
Identify products by — select the parameter (name, SKU, or Product ID) by which products from the platform will be identified when they are updated in Orderry orders. This is necessary to avoid duplication of products.
Managers — select the employees who will be assigned as managers to imported orders.
Please note: for the integration to work correctly, the employees assigned by managers to these orders must have the Display employee in the list of managers right enabled.
5. Click Save and import orders.
After that, a one-time import of orders, products, and clients from Shopify to Orderry will take place. The process may take some time, depending on the number of orders being imported. Thanks to further synchronization, all new orders from the Shopify platform will automatically be sent to Orderry, and the data in all imported orders will be updated every minute.
Please note: all orders, created within the last 2 months will be imported, except for fulfilled, canceled, and refunded orders.
How to edit and delete an integration
To edit the integration settings, open the desired integration, make changes, and save the settings.
To delete an integration with a store, open it, click the delete button, and confirm the action.