Cin7 Core Integration

Integrate your Shippit instance with the Cin7 Core e-commerce platform. Set up, configure, and sync orders between Cin7 Core and Shippit.

Updated over a week ago

Shippit works seamlessly with Cin7 Core to synchronise orders. This article explains how to set up your Cin7 Core integration, configure it for your unique workflow, and get the most out of Cin7 Core and Shippit.

💡NOTE: Cin7 Core is the same product that used to be called Dear.


Set up your Cin7 Core integration

To get started with Cin7 Core, you need to generate an API key in Cin7 Core, then log in to your Shippit account, and set up the integration.

Generating an API key in Cin7 Core

  1. Log in to your Cin7 Core account, and navigate to Integrations.

  2. Click API - Cin7 Core.

  3. In the API Integration dialog, click the + icon to create a new integration.

  4. In the Name field, type a name for your integration, and click Create.

  5. Take a note of the Account ID and Application Key, and confirm that the Application is showing as Active.

  6. Click Save to save your API integration.

Setting up your Cin7 Core integration in Shippit

  1. Log in to your Shippit store.

  2. Open the drop down menu in the top right of your screen, and click Settings.

  3. Click Integrations to go the integrations settings.

  4. In the Select an Integration section, click Cin7 Core.

  5. Use the details you noted from your Cin7 Core API settings to complete these fields:

    • In the Account Id field, type the Account ID

    • In the Application Key field, type the Application key

  6. Click Connect to complete your integration.

You can check that your integration has been set up successfully, by making sure that the Webhook URL field is populated.

Registering Shippit in Cin7 Core

  1. Log in to your Cin7 Core account, and navigate to Sale.

  2. Select any order that has already been packed, and click Ship.

  3. In the Carrier column, click Add a new carrier.

  4. Type Shippit and click Save to add Shippit as a new carrier.

You can check that your integration has been set up successfully, by making sure that the Webhook URL field in your Shippit integration settings is populated.


Configure your Cin7 Core integration

When you have your Cin7 Core integration set up, you can configure it to suit your requirements. For most settings, you can make the changes in Shippit.

Updating settings in Shippit

  1. Log in to your Shippit account.

  2. Open the drop down menu in the top right of your screen, and click Settings.

  3. Click Integrations to go the integrations settings.

  4. FIXME Click Administer Cin7 Core Integration and provide your login details to open the Cin7 Core integration settings page.


Synchronise orders

You can configure how you want Cin7 Core orders to synchronise with your Shippit account.

💡Note: Shippit can synchronise both simple and advanced sales orders from Cin7 Core. The reference number in Shippit changes depending on which type it is. Simple sales orders use a reference like SO-00011. Advanced sales orders include the fulfilment number at the end, like SO-00011/1.

Changing order synchronisation options

  1. In your Shippit account, navigate to the Orders tab in the Cin7 Core integration settings.

  2. In the Auto-sync new orders field, choose to synchronise orders every 15 minutes, to synchronise using the webhook, or not to synchronise. If you choose not to synchronise automatically, you need to manually import orders every time.

  3. In the Default Email field, type an email to use for any orders that do not have a customer email address associated with them.

  4. Click Update to save your changes.

Shipment synchronisation to Cin7 Core

When Shippit updates an order, it also sends information back to Cin7 Core. The fields that are updated in Cin7 Core are:

  • Despatch Timestamp

  • Tracking Code

  • Internal Comments

  • Carrier Fields.

Navigate to the the Fulfilments tab to configure how you would like to synchronise your orders' shipment status from Shippit to Cin7 Core. Turn this setting on to allow Shippit to update Cin7 Core with the tracking information for each order.


Manually import orders

Whether or not you enable automatic synchronisation from Cin7 Core to Shippit, you can also manually import orders if you need to. You can do this using Shippit Connect.

You can see imported orders in your Shippit account in the New Orders screen.

Manually importing all orders awaiting fulfilment

  1. In your Shippit account, navigate to the Order Sync tab in the Cin7 Core integration settings, and click Launch Connect.

  2. Navigate to the Orders tab, and click Import orders.

  3. Click Import to import all orders that are awaiting fulfilment.

Manually importing an individual order

  1. In your Shippit account, navigate to the Order Sync tab in the Cin7 Core integration settings, and click Launch Connect.

  2. Navigate to the Orders tab, open the Import orders dropdown menu, and click Choose by Order Number.

  3. Type the Cin7 Core order number.

  4. Click Import to import the order.

Manually importing bulk orders

  1. In your Shippit account, navigate to the Order Sync tab in the Cin7 Core integration settings, and click Launch Connect.

  2. Navigate to the Orders tab, open the Import orders dropdown menu, and click Choose by Created Date to import orders by date, or Choose by Order Stage to select all orders in a particular stage.

  3. Choose the search criteria, either a date range, or the order stage.

  4. Click Import to import the orders. A progress bar shows you how many orders are being imported.


Shipping options

You can configure shipping options in Shippit so that they more accurately match your Cin7 Core settings. These settings allow you to select which Cin7 Core shipping method matches a specific service or class in Shippit. This is especially useful if you are using your own custom shipping options.

If you offer free shipping, you can manage your shipping costs by identifying the specific service or service class that you would like the order to be transacted through.

Changing shipping options

  1. In your Shippit account, navigate to the Order Sync tab in the Cin7 Core integration settings, and scroll down to the Shipping method mapping section.

  2. Click Add mapping to add another shipping method mapping.

  3. Type the Cin7 Core shipping method in the left column, and select the matching Shippit service type. You can find the Cin7 shipping methods in the Cin7 Omni Sales Order Page, in the Freight field. It is best to type the shipping method exactly, but you can also use an asterisk (*) as a wildcard symbol if you need to. For example, you can type Shippit* to match all shipping methods that start with Shippit.

  4. Optional: If you have orders that you don't want to fulfil in Shippit, select the Don't send to Shippit Shippit method. This prevents orders of this order type being synchronised with Shippit.

  5. Click Update to save your changes.

💡NOTE: If you select the Click & Collect Shippit service type, a label is generated for the order. As soon as you download the label, the order is moved from the New Orders page to the Track page.


Troubleshooting

This section contains information about some common issues you might encounter with your Cin7 Core integration. If you can't find an answer to your question here, contact [email protected] for assistance.

Orders are not synchronising to Shippit

This could be due to a number of reasons. Check these things first:

  • Check the content and format of the customer and delivery information for the order

  • Check that you have the appropriate carrier services activated in Shippit.

  • If you have automated workflows in the Cin7 Core that bypass the pack authorisation step, these orders might not be synchronised.

Not receiving tracking updates for orders booked through Shippit

This can happen if you haven't enabled the Shippit Fulfilment Sync setting in Cin7 Core Inventory. If it is enabled, and still not working, check that you have a Shippit webhook URL in Shippit Cin7 Core integration settings.

If the webhook URL field is empty, re-register your webhook by turning off the Fulfilment Sync option in Cin7 Core Inventory, and then re-enabling it. You might also need to refresh your browser window.

All fulfilments are failing in Shippit Connect

This can happen because the ship record has already been closed in Cin7 Core Inventory, or because the carrier value for Shippit has not been set in Cin7 Core.

Orders booked in Shippit Connect are not appearing in fulfilment history

This can happen if your Shippit webhook URL has not been properly set up, or has been removed. It can also happen if you have a pre-existing webhook URL that has not been overridden after you connected Cin7 Core Inventory with Shippit.

If the webhook URL field is empty, re-register your webhook by turning off the Fulfilment Sync option in Cin7 Core Inventory, and then re-enabling it. You might also need to refresh your browser window.

Did this answer your question?