Integrating with Odoo

Table of Contents

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 Oodo.
  2. Install the Starshipit module by going to Odoo's Apps module.
  3. Search for Starshipit Shipping.
  4. Click Activate to install it.
    Starshipit Shipping module in the Odoo Apps module.
  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.

  Important

To set a default package type, the Packages feature must be enabled in Inventory > Configuration > Settings.

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

Example of shipping products configured in Odoo.

  Note

We do not provide test keys when a company tests the sending of a package in Odoo. This means that if a package is created, your account may be charged.

Odoo has a built-in layer of protection against unwanted charges when using test environments. Within a test environment, if a shipping method is used to create labels, then those labels are immediately canceled after creation — this occurs automatically. Please note that depending on the shipping provider being used, the account might be charged for printing label, unless the order is cancelled manually on the couriers’s portal.

Switch between the test and production environment by clicking the Environment smart button at the top of the shipping method form.

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.

Example of a shipped order in Odoo.

  Important

Package weight in Odoo is calculated by adding the weights of the products plus the empty package saved in the database. Ensure the correct shipping option is selected, as the package weight is not automatically verified.

Verify the destination address, as Starshipit checks it when the order is created.

Finally, some couriers may require other information, such as an email address or phone number. Please ensure that all necessary information are set upon sending a shipping order.

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.

Want to deliver great shipping experiences?

Start a 30-day free trial or book a demo with one of our shipping experts

Was this article helpful?
0 out of 0 found this helpful

Comments

0 comments

Please sign in to leave a comment.