Starshipit Integration
Order Desk can download orders from your shopping carts and send them to Starshipit for fulfillment. After submission, you can also use the integration to request rates, then create and print labels directly from your orders in Order Desk.
As orders are fulfilled, tracking details will automatically flow back to Order Desk and update your carts.
IN THIS GUIDE
Setup
To connect to Starshipit, click on the Manage Integrations link in the left sidebar and under the Shipping tab find and enable the Starshipit integration:
Alternatively, search for Starshipit from the available integration search and click Enable:
Once enabled, enter your Starshipit API Key and Subscription Key, then click Connect:
Please note that Order Desk isn’t able to help find or reset your credentials, as they can only be provided by Starshipit.
Settings
After you have connected the integration, you can apply any necessary details or preferences to the settings.
After Import, Move To
Select the folder you want orders to be moved into after they are successfully sent to Starshipit.
You can use one of the default folders already in your store or create your own. Read the Working with Folders guide for more information.
After Shipment, Move To
Select the folder orders should be moved to when Starshipit sends tracking details back to Order Desk about them.
Default Unit
Choose the unit of measurement for package dimensions and weights (options are LBS/IN or KG/CM)
Default Dimensions
Select the default dimensions for your packaging.
Print Preference
Choose whether you want labels to Print Immediately or Not Print Automatically. This is helpful if you want to create labels but delay printing them.
Default Shipper Information
Set your default return address in the Default Shipper Information section. This address will be used for all orders.
Product Settings
For more information on what these product settings in the Starshipit integration are for and how to use them, read the Fulfillment Integration Product Settings guide.
Starshipit Label Creator
A label creator will display beneath the product details on every order that has previously been submitted to Starshipit from Order Desk.
You can use this section to further adjust your package dimensions, fetch rates, and then purchase your intended labels:
You can also purchase labels automatically with rules. More info here.
Order Level Details
If you're sending orders to Starshipit for fulfillment, the following fields can be added as checkout data or order metadata to be passed through to Starshipit on an order by order basis.
If you are unfamiliar with checkout data, see the How to Work with Checkout Data guide.
| Field Name | Field Description |
|---|---|
| reference | By default, the order reference is set to Order Desk. You can enter a different value here if you prefer. |
| shipping_description | Use this field to override the shipping description sent to Starshipit. If left blank, the shipping method from the order will be used. |
| signature_required | Set this to 1 if a signature is required upon delivery. |
| return_order | Set this to 1 if the order is a return. |
Starshipit Rules Reference
In addition to the general set of rule events and actions in Order Desk, Starshipit includes a number of rule events and actions that are specific to the integration. These aren’t found directly on the integration page. Instead, you’ll need to use the Rule Builder to access them.
If you're new to using rules in Order Desk, we recommend starting with our How to Work With Rules guide.
Rule Events
To find Starshipit-specific rule events, type starshipit into the Event dropdown menu in the Rule Builder.
| Event | Description |
|---|---|
| Starshipit Label Created | Triggered when a shipping label is successfully created from Starshipit. |
| Order Scheduled to Starshipit | Triggered immediately after an order is scheduled to be sent to Starshipit. |
| Before Order Submitted to Starshipit | Triggered just before an order is sent to Starshipit. Useful for making last-minute updates. |
| After Order Submitted to Starshipit | Triggered after an order has been successfully submitted to Starshipit. |
| Order Not Submitted to Starshipit Because of General Error | Triggered when a general error prevents the order from being submitted. |
| Order Not Submitted to Starshipit Because of Invalid SKU | Triggered when one or more SKUs are not valid in Starshipit. |
| Order Not Submitted to Starshipit Because No Products Available | Triggered when no valid products were found on the order. |
Rule Actions
Starshipit also supports specific rule actions that you can apply to your orders. These can be found in the Actions dropdown by searching for starshipit:
| Action | Description |
|---|---|
| Create Starshipit Label | Attempts to automatically purchase a label from Starshipit. This will attempt to create the cheapest label available. |
| Submit Order to Starshipit | Sends an order from Order Desk to Starshipit. |