How to Setup Syncware App in Shopify store
Syncware supports all Shopify plans. However, due to the nature of some APIs requiring access to Personally Identifiable Information (PII), full functionality is only available on Shopify Advanced and Shopify Plus plans. If your integration requires handling PII, upgrading to one of these plans may be necessary.
To change your authentication (connection) type please watch this video. Then, skip to STEP 3 for an image on where the API Admin Access token is located.
STEP 1 - Enable custom app development from the Shopify admin
Steps:
- From your Shopify admin, go to Apps.
- Scroll to the bottom gear icon - App and Sales Channel Settings
- Click Develop apps (top right of the page)
- Click Allow custom app development.
- Read the warning and information provided, and then click Allow custom app development
STEP 2 - Create the custom app
Steps:
- From your Shopify admin, go to Apps.
- Click Develop apps.
- Click Build apps in Dev Dashboard.
- Click Create app.
- Start from Dev Dashboard, enter the App Name - Syncware.
- Click Create
- In the URL section for the App URL add www.syncware.com
- Uncheck the box "Embed app in Shopify Admin"
- Scroll down to the Access area, click Select Scopes
- The following scopes should be selected. You can click them individually OR you can copy and paste the following scopes into the text box:
- read_assigned_fulfillment_orders,write_assigned_fulfillment_orders,read_customers,write_customers,read_price_rules,write_price_rules,read_discounts,write_discounts,write_draft_orders,read_draft_orders,read_fulfillments,write_fulfillments,write_inventory,read_inventory,read_locales,read_locations,read_orders,write_orders,read_payment_terms,write_payment_terms,read_product_listings,read_products,write_products,read_shipping,write_shipping,read_third_party_fulfillment_orders,write_third_party_fulfillment_orders,write_order_edits,read_order_edits
- Click Release. You can choose to name the version or not, its optional.
STEP 3 - Install the custom app and get the API access tokens
Steps:
- The newly created Syncware app will now appear on the Apps page on the Dev Dashboard
- From the Home Page of the newly created App you will be able to install the app to your Shopify store.
- Click Install app.
- Review the data that Syncware will be accessing, and click Install App.
- Once installed, you will need to go back to the Dev Dashboard to get your API Key and API Secret Key
- In the Dev Dashboard, click the app
- Click Settings
- Copy your Client ID (API Key) and Secret (API Secret) and enter them into Syncware.
- Follow the steps in this article to add your API Key and API Secret to Syncware.
API Scopes
| Scope | Authenticated access granted |
|---|---|
|
|
FulfillmentOrder resources assigned to a location managed by your fulfillment service |
|
|
Customer and Saved Search permissions required |
|
|
GraphQL Admin API Discounts features |
|
|
Draft Order permissions required |
|
|
Fulfillment Service |
|
|
Inventory Level and Inventory Item |
read_locations |
Location |
|
|
FulfillmentOrder resources assigned to merchant-managed locations |
|
|
Abandoned checkouts, Customer, Fulfillment, Order, and Transaction resources permissions required |
|
|
GraphQL Admin API PaymentSchedule and PaymentTerms objects |
|
|
Price Rules |
|
|
Product, Product Variant, Product Image, Collect, Custom Collection, and Smart Collection |
read_product_listings |
Product Listing and Collection Listing |
|
|
Carrier Service, Country, and Province |
|
|
FulfillmentOrder resources assigned to a location managed by any fulfillment service |
|
|
GraphQL Admin API OrderStagedChange types and order editing features |