If you are vendor who uses ShipStation to create shipping labels, you can connect your ShipStation account directly to Duoplane to automatically retrieve new orders and to mark shipped orders as fulfilled in Duoplane.

To do that, you will create a Custom Store connection from within ShipStation and connect to Duoplane using the credentials of a Duoplane API user:

Step 1. Create a new API user in Duoplane for the vendor account

Please note that the API user should be a user on the vendor’s account. If you are a retailer configuring this on behalf of your vendor, please be sure to create an API user in that vendor’s account.

  1. In your Duoplane vendor account, go to Settings > Staff Members.
  2. Scroll to the bottom of the page and click “Manage API users
  3. Click “Add an API user
  4. Give the API user a name. For example: “ShipStation User”.
  5. Click “Save” to save the new user.
  6. After the API user is saved, you will see 2 pieces of information that you will need for the next step in ShipStation.
    • API Key: This will be used as the username in the next step in ShipStation
    • API Password: This will be used as the password in ShipStation. Please note that this password will only be displayed once.
Important: Note that the API Password will not be displayed again after you navigate away from this page. So please leave this browser window open or paste the password someplace secure for use in the next step.

 

Step 2. Configure the connection in ShipStation

  1. In your ShipStation account, go to Settings > Selling Channels
  2. Click the “Connect a Store or Marketplace” button.
  3. Search for “Custom Store” and click the “Custom Store” icon.
  4. In the Custom Store configuration,
    1. URL to Custom XML Page = https://app.duoplane.com/integrations/shipstation.xml?price_field=cost
      • See the section below about using URL parameters to customize what information is imported to ShipStation
    2. Username = The API Key of the Duoplane API user created in “Create a new API user in Duoplane” section
    3. Password = The API Password for the API user that you just created in Duoplane
    4. Leave the Order Statuses as their defaults.
    5. Press [Connect]
  5. After saving the Custom Store
    1. Edit the store in your “Stores & Marketplaces” list to customize how this store behaves in your ShipStation account
    2. Update the following info: store name, auto-update setting, etc
    3. Store Name = 420BEAST

 

Extra: Customize what information is imported to ShipStation

By adding query parameters to the URL to Custom XML Page, you can customize what information is imported into ShipStation. Below is a summary of what query parameters are available and their options.

Query parameter Possible values
price_field Items on orders in ShipStation each have a unit price. The value of this unit price can be customized to be the item’s retail price, its wholesale cost, or zero.

 

cost = The item wholesale cost

price = The item retail price. This will also add the shipping revenue to the “Shipping Paid” in ShipStation.

none = Unit prices are set to zero

remove_fields This query parameter can be a comma-delimited list of fields to exclude from being imported into ShipStation. These values are imported by default unless they are explicitly excluded.

 

weight: If excluded, items will be imported to ShipStation without any weight values.

include_fields This query parameter can be a comma-delimited list of fields to include with the information being imported into ShipStation. These values are not imported by default unless they are explicitly included.

 

internal_notes: If included, the “Internal Notes” field in ShipStation is populated with the same value that might otherwise appear on the purchase order footer.

tax_amount: If included, the “Tax Paid” field in ShipStation is populated with the tax collected on the items sent to ShipStation.

 

Examples of using query parameters to customize ShipStation order information

Import the item wholesale cost

In the custom store configuration, set the URL to Custom XML Page to https://app.duoplane.com/integrations/shipstation.xml?price_field=cost

If the cost does not appear, please make sure that you can see item costs on purchase orders within your vendor portal. If not, please ask your retailer partner to make costs visible on purchase orders for you.

Import the item retail price from the original order

Ask your retailer partner to make prices visible on purchase orders for you.

To verify that prices are visible, please make sure that you can see item retail prices on purchase orders within your vendor portal.

In the custom store configuration, set the URL to Custom XML Page  to https://app.duoplane.com/integrations/shipstation.xml?price_field=price

Set unit prices to zero

In the custom store configuration, set the URL to Custom XML Page to https://app.duoplane.com/integrations/shipstation.xml?price_field=none

Exclude item weights

In the custom store configuration, set the URL to Custom XML Page to https://app.duoplane.com/integrations/shipstation.xml?remove_fields=weight

Include the purchase order footer as Internal Notes

In the custom store configuration, set the URL to Custom XML Page to https://app.duoplane.com/integrations/shipstation.xml?include_fields=internal_notes