The steps below will guide you through integrating your Dear platform to Starshipit. Once completed, your orders will be imported into Starshipit and the tracking information will be written back when you print a label.
Dear has also released an integration with Starshipit, this integration will allow you to print labels from the DEAR platform. For information on that, see their support guide.
What you need to get started:
Before getting started with Dear you will need a few things.
Your Dear Account Id
- Your Dear API Key
If you do not have the above fields, follow the below steps:
- Log into DEAR Inventory System
- Go to Integration > DEAR API
- Create a new API application
- Save the new API application and note down the Account ID and the Key
How to set up Dear:
To enable Dear on your account:
- Go to Starshipit > Settings > Integrations > Add a new integration > Dear
- Recommended: Select Version 2 for the API version.
- Enter in the Account ID and Key from Dear
- Click Save
Starshipit will update your orders with carrier and tracking information when shipped. By default, Stashipit will use "DEFAULT Carrier" when updating your orders in the DEAR Inventory System.
If you wish to have your DEAR orders to be updated with the specific carrier name then you will need to set up Carrier Mappings in Starshipit.
- Go to Settings > Integrations > Dear > Courier Mappings
- Click Add a new mapping
- From the courier drop down, select one of your enabled couriers
- In the courier name to use textbox, enter in the courier name you have defined in Dear
- When done, click the tick icon
When writeback is attempted for the courier specified, we will send back the courier name you have defined in this field
Status to import
- Use this option to specify what status orders should be in to import into Starshipit. You can specify multiple by separating each status with a semi colon. For example: Ordering;Picked
- If you are using Dear's Advanced Sales - Multiple Fulfillments you can configure your Starshipit integration to import each fulfilment and a single order, instead of importing the overall sales orders.
To do this, you will need to be on Dear Version 2 and select "Import Sale Fulfillments instead of Sales". This means you will have multiple starshipit orders for the one order in Dear allowing you to ship them separately with ease.
- Import Memo/Order Notes
- By default Starshipit does not import memo's from Dear. If you would like these to import into the delivery instructions field, select the option you would like from the memo drop down. Alternatively you can import the order notes by selecting Import order note into delivery instructions
- Dear has an API limit of 60 calls per 60 seconds. This can occasionally mean that the writeback to Dear will fail, or that the import will fail. These both will retry again should they fail.