# Cin7 Omni Integration
URL: https://support.starshipit.com/articles/360001594575-cin7-omni-integration
Canonical: https://support.starshipit.com/articles/360001594575-cin7-omni-integration
Markdown: https://support.starshipit.com/articles/360001594575-cin7-omni-integration.md
Updated: 2026-05-06

> For the complete documentation index, see [llms.txt](https://support.starshipit.com/llms.txt).

> Integrate your Cin7 Omni platform with Starshipit to import orders and write back tracking information when you print labels.

Integrate your Cin7 Omni platform with Starshipit to import orders and write back tracking information when you print labels.

![ecomm_inv_wms_integration_flow.png](/uploads/articles/integrations/inventory-warehouse-retail-management/cin7-omni-integration/image_360006931876.png)

## 1. Activate Starshipit in Cin7 Omni

1. Ensure the Starshipit module has been installed as per the [Cin7 Omni documentation.](https://help.omni.cin7.com/hc/en-us/articles/9128571486095-Set-up-Starshipit)
2. Log into Cin7 Omni with your admin login.
3. Click on your username in the top right corner of the screen and select the **Settings** option in the drop-down.
4. Click on **Integrations & API**.
5. Select **Starshipit** from the list.
6. Make a note of the **ID** and **Key** as you will need to copy these into Starshipit.
7. Change any other settings as desired then click **Save**.

For more information on each setting please contact [Cin7 Omni support](https://help.omni.cin7.com/hc/en-us/requests/new).

## 2. Set up Cin7 Omni in Starshipit

1. In Starshipit go to **Settings** > **Integrations** > **Add New** > **Cin7 Omni**.
2. Tick **Enable Cin7 Omni** and **Use dedicated API**.
3. Enter your **ID** and **Key** gathered in Step 1 into the **Cin7 Omni ID** and **Cin7 Omni Key** fields respectively.
4. Click **Test to ensure it works**, to check if the connection is successful.
5. Click **Save**.

![mceclip0.png](/uploads/articles/integrations/inventory-warehouse-retail-management/cin7-omni-integration/image_4433484813327.png)

## 3. Set order statuses for import

You can specify statuses (known as stages in Cin7 Omni) on which Starshipit will import your orders from Cin7 Omni. For example, you can set the app to only import orders which are Processing and/or Fully Picked. You can also specify a custom import status by typing into the drop-down box.

![mceclip1.png](/uploads/articles/integrations/inventory-warehouse-retail-management/cin7-omni-integration/image_4433516263823.png)

For Starshipit to be able to import orders from Cin7 Omni the below criteria must also be met on each order:

* Sales Orders are **Approved**.
* The fully dispatched field is empty on each Sales Order.

Provided these conditions are met you can import the orders directly into the **New** section of your Starshipit account.

## 4. Importing Dimensions

Starshipit can import item dimensions from the Cin7 Omni setup against your products. To configure dimensions in Cin7 Omni follow [this guide](https://help.omni.cin7.com/hc/en-us/articles/9052674009231-Product-settings).

1. By default, dimensions will be assumed to be in metres. If you are using a different unit of measure in Cin7 Omni, you can configure this from Settings > Integrations > Cin7 Omni settings >

   Linear measurement unit to convert from Cin7 Omni
2. Using our Package Setup section you can configure how Starshipit should handle the imported dimensions. For further information, please read [this guide](/articles/orders-manifests-reports/orders/set-up-packages-and-import-weights-and-dimensions).

## Troubleshooting

#### I clicked on test connection and I got an invalid credentials error message

Double-check that you have copied the correct information into Starshipit and that you have saved the information in Cin7 Omni. If this problem persists, contact our [support team](https://help.starshipit.com).

## FAQs

<!-- faq:start -->

<!-- faq:question -->Can I get my rates into my Cin7 Omni portal?<!-- /faq:question -->

Yes, you can get your Starshipit rates into your Cin7 Omni portal using the Cin7 Omni Rate calculator by following these steps:

1. Log in to Cin7 Omni.
2. From the **Integrations**menu in the navigation, open your Starshipit integration.
3. Open **Settings**.
4. Enter [your Starshipit API key](/articles/integrations/the-starshipit-api/how-to-find-your-starshipit-api-key) into the setting **Starshipit API Key**.
5. Enter [your Starshipit subscription key](/articles/integrations/the-starshipit-api/how-to-find-your-starshipit-api-key) into the setting **Starshipit Subscription Key**.
6. Under **Package Options**, recreate [your Starshipit packages](/articles/orders-manifests-reports/orders/set-up-packages-and-import-weights-and-dimensions) – Omni can’t download your Starshipit package details, so for the rates calculator to work accurately, you must re-define their specifications here.
7. Select **Save**.

Once you’ve configured the rate calculator, use it to see estimated shipping costs for your Starshipit couriers: 

1. Log in to Cin7 Omni.
2. From the **Integrations**menu in the navigation, open your Starshipit integration. You’ll see the rate calculator.
3. Enter the package’s destination (**Ship To**) and weight (**Weight**) in kilograms.
4. Select **Get Rates**. You’ll see estimated shipping costs from your couriers under **Shipping Rates Results**.

<!-- faq:end -->