Skip to main content

Connect a Zoey Store to Duoplane

  • Updated

Duoplane connects to Zoey via Zoey's API. To connect Zoey to Duoplane, you will first create an API user for Zoey and then provide Duoplane with that API user's credentials.

 

IMPORTANT: As a first step before adding any new store connection, we recommend checking the setting enabling unique product SKUs.

By going to Main Menu > Settings >Products & Inventory, change the "Product SKUs are unique" setting to "Yes" to link products from the new store to existing products of the same SKU currently in Duoplane.

If this is set to "No", Duoplane will treat every product from the new store as a new product and not link it to existing products, which may cause unintended duplicates.

 

Create a Zoey API user with admin access

The first step is to create a Zoey API user with admin access.

Create an API role

In Zoey, create an API role with access = All

  1. In the Advanced menu, select API Configuration.
  2. Click Manage in the Standard API > API Roles section.
  3. If an "All access" role does not already exist, create one by selecting Add New Role.
  4. Give the role a name. (For example, "Admin")
  5. In the Role Resources tab, select All in the Resource Access dropdown.
  6. Save the role.

Create an API user

Create an API user with that newly created role:

  1. In the Advanced menu, select API Configuration.
  2. Click Manage in the Standard API > API Users section.
  3. Click Add New User.
  4. Fill in the required information and remember the user name and API key that you enter. Those will also need to be put into Duoplane.
  5. Give this API user the "All access" role that you just created earlier.
  6. Save the new user.

 

 Add the Zoey store to Duoplane

  1.  Login to your Duoplane account
  2. In Settings > Ecommerce Stores, select New Store.
  3. Select Zoey from the dropdown.
  4. Give your store a nickname in the Store Name field. This is for internal use only and is mostly relevant if you manage multiple ecommerce channels in Duoplane.
  5. Type or paste the URL for your Zoey admin in the Admin URL field. For standard Zoey setups, it will generally look like this: https://___.zoeysite.com/index.php/admin
  6. In the API access section, complete the fields as follows:
    • API URL: Your Zoey API URL. For a standard setup, the URL will look like this: https://___.zoeysite.com/api
    • API login: This is the API User Name for the Zoey API user that we just created
    • API password: This is the API Key that was used earlier in the creation of the Zoey API user

 

 Map Zoey product attributes to Duoplane's

 

  1. In the Product attribute mappings section, map your Zoey attributes to the corresponding Duoplane fields.
    1. Click the Re-import Zoey attributes button to have Duoplane read in the available attributes from your Zoey catalog.
    2. Wait a few minutes and refresh the page. Each of the listed attributes should have a dropdown next to it listing all of your Zoey attributes.
    3. Map as many attributes as you can, but the the most important fields for order processing are:
      1. Vendor name code
      2. Name
      3. Vendor SKU
      4. Price
      5. Cost
      6. Leadtime days
      7. Backorder date
  2. Once the mappings are complete, enable syncing by turning the following fields to "On":
    1. Import orders? (Order management section)
    2. Import products? (Products and inventory section)

Related articles