Shopify Integration Help Pages

Step 1: Setting Up the Visual Ink Integration - Create and Install a Custom Order Fulfillment App.

1. Log in to your Shopify Admin

2. Click on Settings in the bottom-left corner of the admin dashboard.

3. Select Apps and sales channels

 

4. Click on Develop apps.

 

5. Click Allow custom app development

 

6. Read the warning and information provided. Confirm by clicking Allow custom app development.

 

7. Click on Create an app.

 

8. Configure the app settings in the popup that appears

 

 ~ Enter a name for your app (e.g., "Fulfillment App").

~ Select an App developer. This can be the store owner or any staff member with permissions to develop apps.

 

9. Click Create app to proceed

10. Click on Configure Admin API Scopes

11. Under Admin API access scopes, tick the scopes listed below.

The Admin API Access Scopes define the specific permissions granted to a custom app, determining the types of data and actions it can access or perform within a Shopify store's admin interface.

Assigned fulfillment orders

  • write_assigned_fulfillment_orders: Grants permission to modify fulfillment orders that have been assigned to a specific fulfillment service. This scope allows the app to update the fulfillment status, assign fulfillment orders, and manage the fulfillment process. It is used by the app to handling order fulfillment and logistics, including managing the dispatch of products from the fulfillment center.
  • read_assigned_fulfillment_orders: Provides access to view fulfillment orders that have been assigned to a specific fulfillment service. This scope allows the app to retrieve information about these orders, such as their status, shipping details, and assigned fulfillment service. It is used by the app to track or manage the status of fulfillment orders to provide insights or ensure proper handling of orders through the fulfillment process.

Fulfillment services

  • write_fulfillments: Grants the ability to create, update, or cancel fulfillments for orders, including marking an order as shipped or processing returns. This scope is by the app to manage the logistics or fulfillment process of the store.
  • read_fulfillments: Enables the app to access fulfillment information, such as tracking numbers, shipping methods, and statuses of orders that have been shipped. This is used by the app to handle order fulfillment and shipping.

Inventory

  • write_inventory: Allows the app to update inventory levels for products in the store, such as increasing or decreasing stock quantities. This scope used by the app to handle stock tracking or replenishment.
  • read_inventory: Provides access to view the current inventory levels of products in the store. This scope allows the app to read stock quantities and inventory statuses for individual products or variants.

Products

  • read_products: Provides access to view product data in the store, including product names, descriptions, pricing, and inventory levels. This scope allows the app to read information about the store's catalog of products.

 

12. Click Save to apply these API scopes

13. Click on Install app at the top right of the app details page.

14. In the popup that appears, confirm by clicking Install.

15. From the app's details page, click API Credentials

16. Under Admin API Access token, clilck Reveal token once

Step 2: Setting Up Product Meta File Information

When setting up products in Shopify for fulfillment, it’s essential to configure metafile information that stores the design files used in production. These file metafields enable your designs in Shopify to be automatically matched to the correct decoration areas—namely the front and back—of the blank. Proper product configuration is crucial for smooth fulfillment.

1. Log in to your Shopify Admin

2. Click on Settings in the bottom-left corner of the admin dashboard.

3. Select Custom data from the settings options.

4. Select Products from the Metafield definitions list.

5. Click the Add definition button.

The metafield configuration settings are displayed.

Properly setting up these metafields is essential for ensuring that Visual Ink can accurately map your design files to the correct areas of your products. Verify what file formats are supported and configure the validation rules accordingly. We recommend PDF or hi-res transparent PNG. This step is critical; if the metafields are not set up correctly, it can cause delays in the design mapping process and potentially slow down production.

6. Enter a Name for your metafield that reflects its purpose, such as "Front Decoration File."

7. Enter a Namespace and Key.

Specify a unique namespace and key for your metafield, such as front.decoration_file. This helps in identifying and accessing the metafield later. Shopify will suggest after you have entered a name. You can use the suggested namespace and key if you like.

8. Enter a Description.

Add a description to clarify the purpose of this metafield, such as "File for front decoration" or "File for back decoration."

9. Select the metafield content type.

Click on Select type and choose "file" from the list of options. This will allow you to upload design files.

 

10. Set the validation rules.

Select the Accept specific file types option and tick the Image checkbox.

Select the Accept all file types option if the product can be decorated with graphic and embroidery designs.

 

Step 3: Uploading Design Files to Products

When configuring your Shopify products that are to be fulfilled by Visual Ink, one critical step in the process is uploading the correct design files. It's essential to understand that these design files are intended for the production of the finished product, not for promotional use on your Shopify store.

1. Go to Products in the Shopify admin panel and select the product to which you want to add the metafield.

 

2. Scroll down to the Metafields section on the product page.

3. Upload Files. For each metafield you created:

     Click on the metafield

Click Select Image and choose the design file you want to add from your computer.

Your cart is empty
Search