Connect a Magento 2 Store to Duoplane

Duoplane Retailer accounts
Available on all plans

Duoplane connects to Magento 2 via Magento's core API and uses an Oauth-based integration to communicate with your store's API.

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.

Add the Magento 2 store to your Duoplane account

  1. Login to your Duoplane account
  2. In Settings > Ecommerce Stores, select New Store.
  3. Select Magento2 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 store admin in the Admin URL field. For out-of-the-box Magento setups, this is often the base URL of your store followed by "/admin".
  6. In the API access section, set the API URL to the base URL of your store.

Create a new integration in Magento

  1. Login to your Magento admin
  2. In the System menu, select Integrations
  3. Click Add New Integration
  4. In the Integration Info tab, complete the fields as follows:
    • General
      1. Name = Duoplane
      2. Callback URL = https://app.duoplane.com/integrations/magento2/authenticate
      3. Identity link URL = https://app.duoplane.com/integrations/magento2/start
    • Current User Identity Verification
      1. Your Password = Your Magento password
  5. Switch to the API tab, and set the Resource Access to All
  6. Save the integration.

magento2_duoplane_integration_info.png

 

magento2_duoplane_api.png

 

Authorize Duoplane to connect to Magento

  1. In your Magento integration list (System > Integrations), find the row with the Duoplane integration that you just created.
  2. Click Activate.magento2_duoplane_activate.png
  3. Click Allow to authorize access.

Map Magento product attributes to Duoplane's

  1. Return to your store settings in your Duoplane account
  2. In the Product attribute mappings section, map your Magento attributes to the corresponding Duoplane fields.
    1. Click the Re-import Magento attributes button to have Duoplane read in the available attributes from your Magento 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 Magento 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
  3. 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)

Alternate method to connect Duoplane to Magento

If the streamlined process described above is not working, you can also enter API credentials directly into Duoplane.

  1. Login to your Magento admin
  2. In the System menu, select Integrations
  3. Click Add New Integration
  4. In the Integration Info tab, complete the fields as follows:
    • General
      1. Name = Duoplane
      2. Leave all other fields blank
    • Current User Identity Verification
      1. Your Password = Your Magento password
  5. Switch to the API tab, and set the Resource Access to All
  6. Click "Save"
  7. In your Magento integration list (System > Integrations), find the row with the Duoplane integration that you just created.
  8. Click Activate
  9. Click Allow
  10. Magento will show you 4 different API credentials:
    • Consumer Key
    • Consumer Secret
    • Access Token
    • Access Token Secret
  11. Go to your Duoplane admin to the store record that you created in the initial step
  12. In the section called API access, click the small link that says "Enter integration credentials"
  13. Copy and paste the 4 API credentials from Step 10 into the associated input field in Duoplane
  14. Click Save changes