Integrating with Odoo

Table of Contents

• Before you begin
• Setting up Odoo
• Generate a label
• Returns
• Cancellations

Overview

• Odoo is a suite of open source business apps that cover CRM, eCommerce, accounting, inventory, point of sale, project management, etc.
• You can integrate Starshipit with Oodo, allowing you to create shipping methods that will automatically get rates from specific couriers (such as Australia Post, NZ Post, DHL and others) based on predefined conditions).

Before you begin

In your Starshipit account, make sure you have the following:

• Pickup address - you can set this by navigating to Settings > Pickup address
• Couriers - you can integrate with couriers by navigating to Settings > Couriers
• Starshipit API key - you can find this by navigating to Settings > API
• Starshipit Subscription key - same as above

Setting up Odoo

To integrate your Starshipit account to the Odoo database:

1. Log in to Odoo.
2. Install the Starshipit module by going to Odoo's Apps module.
3. Search for Starshipit Shipping.
4. Click Activate to install it.
   
5. Once installed, go to Inventory > Configuration > Settings.
6. Activate the Starshipit Connector option.
7. Click the Starshipit Shipping Methods link.
8. Click Create.

To configure Starshipit in Odoo, fill out the fields on the Shipping Methods form as follows:

• Shipping Method: Type Starshipit.
• Provider: Select Starshipit from the drop-down menu.
• Delivery Product: Assign or create the delivery product that will appear on the sales order line when the cost of shipping is calculated.

In the Starshipit Configuration tab, fill out the following fields:

• Starshipit API Key
• Starshipit Subscription Key
• Origin Address: The address where products are shipped from
• Default Package Type: Set a default package type to include the weight of the empty package when automatically calculating shipping rates

Manually save the form by clicking the cloud icon next to the Shipping Methods / New breadcrumbs.

To load the newly configured shipping products:

1. Click the Select a service linked to the Starshipit account link at the bottom of the Starshipit Configuration tab. This will open the Choose Starshipit Shipping Service pop-up window.
2. In the Delivery Service field, choose the desired shipping service for deliveries and returns from the drop-down menu.
3. Click Confirm.

The chosen delivery service will populate in the Service Name field.

Example

Here's a sample of a Starshipit shipping product configured in Odoo:

• Sendle: Sendle drop off
• Shipping Product: Sendle Delivery
• Starshipit Service Code: STANDARD-DROPOFF

Generate a label

When creating a quotation in Odoo, add the Starshipit shipping method by:

1. Clicking the Add shipping button.
2. In the Add a shipping method pop-up window, select Starshipit in the Shipping Method field.
3. Calculate the shipping rate by clicking Get rate.
4. Click Add to include the cost of shipping to the sales order line, labeled as the delivery product.

Then, Validate the delivery. Shipping label documents are automatically generated in the chatter, which includes the following:

• Shipping label(s) depending on the number of packages.
• Tracking number(s) if the selected courier supports it.
• Return label(s) if the Starshipit connector is configured for returns.

Returns

We allow returns with the following couriers:

• Australia Post eParcel
• TNT
• Couriers Please
• Aramex
• StarTrack
• DHL Express
• NZ Post Domestic

This can be done by clicking the Return smart button on the intended delivery order. If the selected courier supports returns, the Print Return Label button will be available.

Cancellations

If a delivery order is cancelled in Odoo, it will be automatically archived in Starshipit. However, the cancellation will not be sent to the courier itself, so make sure to log onto the courier’s platform to handle the cancellation manually.