Scurri has an integration with WooCommerce,  allowing customers to import orders directly from WooCommerce and pass back carrier and tracking information upon manifest. 

To connect WooCommerce with Scurri, you will need the following information from your WooCommerce account: 

• Consumer Key
• Consumer Secret

This information can be easily set up by following the steps below. 

WooCommerce Setup

Configure User Role

When setting up WooCommerce to integrate with Scurri, a WooCommerce user will need to complete the setup. This can be an existing user, or you can set up a new user specifically for the API connection into Scurri. There is one requirement when setting up or using an existing user: the user must have one of the following roles assigned to them. 

• Administrator
• Shop manager

To set the role in WooCommerce, access Users > All Users/Add new > Role

Configure Permalink Settings

The WooCommerce account must support a postname attribute in order to connect to Scurri. 

To enable:

1. Log in to the WooCommerce admin panel
2. Access Settings > Permalinks in the menu bar
3. Click the radio button beside Post Name to select
4. Click Save Changes at the bottom of the screen

Configure API Credentials

Scurri connects to WooCommerce via its Rest API, and so requires a Consumer Key and Consumer Secret to connect.  There is also a requirement to pull and push information, which is set via permissions. 

To configure these settings:

1. Navigate to WooCommerce > Settings > Advanced tab > Rest API sub-tab
2. Click Add key
3. Add a Description, such as “Scurri API Key”, or a description which will allow people to understand what this key is for
4. Select a User from the dropdown 
   (it must have an ‘Administrator” or “Shop Manager” Role)
5. Set Permissions to Read/Write
6. Click Generate API key
7. Consumer Key and Consumer Secret are generated and displayed. These are only visible once; either keep the screen open until copied over to Scurri or copy to somewhere until they are used.

The WooCommerce set-up is complete at this point. 

Scurri Setup

1. Log in to Scurri
2. Navigate to Setup > Integrations
3. Click the green +Add New Integration button
4. Click the +Add button beside WooCommerce

5. Copy the Consumer Key from WooCommerce into the “Consumer key” field in Scurri
6. Copy the Consumer Secret from WooCommerce into the “Consumer Secret” field in Scurri
7. Enter the WooCommers shop URL into the “Shop URL” field in Scurri
8. The Enabled box is ticked by default. If you do not want the integration to go live immediately, untick this box, and it can be ticked again at a later time.
9. Click Save

At this point, your new integration will be visible on the list of integrations in Scurri, and the setup is complete.

By clicking on “Status”, you will see the following:

• Orders imported to Scurri
• Failed orders
• Sync Now button to manually import orders rather than waiting for the automatic sync, which happens every 5 minutes

Products in WooCommerce

Every product in WooCommerce has a title, description and image; however, it does not have dedicated fields for weight, harmonisation code, country of origin, etc.

If you ship internationally, it is important that you can provide these additional pieces of information for customs, and so Item attributes can be set up in WooCommerce. 

The following fields in Scurri can be mapped to attribute fields: 

• Weight

• Harmonisation Code
• Country of Origin

Weight can be accepted in the following formats

• Gram
• Kilogram
• Ounce 

If you wish to pass these additional fields to Scurri, please provide the WooCommerce attribute field names that have been set up to the support team, who will apply the mapping to your account. 

Example:

Mapping of order details from WooCommerce to Scurri

In Scurri, we map the following data from the WooCommerce Order

• Shipping address -> destination address
• Billing address email -> destination email address
• Products -> items
• Shipping cost -> Shipping cost
• Order total value -> Shipment total value
• Order number -> Shipment order number
• Order id -> Shipment identifier in the format “<warehouse.id>-<order id>”
• Order currency -> Shipment currency

Multi packages are not supported on WooCommerce, Scurri maps all items into 1 package.

Optional mapping of order details from WooCommerce to Scurri

Scurri does not automatically import a specific WooCommerce field to define the Scurri shipping method. Customers can choose which WooCommerce field to map to the Scurri shipping method as detailed below.

• method_id
• method_title

Processing orders in Scurri

For enabled integrations, Scurri will pull new orders every 5 minutes. 

Scurri pulls orders with WooCommerce status “Processing”.  Scurri will pull only new orders, we exclude any orders that have already been imported. 

Then 

• If we can create a shipment from order data, then the Order notes in WooCommerce are updated with “Order imported to scurri”
• If the order fails, “Failed to Import” is displayed in the Order Notes

Example of an order that has successfully imported to Scurri:

Manifest shipments

When orders are manifested/shipped in Scurri, we update the WooCommerce order with the following:

• Status from Processing to Completed
• Tracking Data: carrier name, tracking number, and tracking URL

Include or Exclude orders by Shipping Method

For every order in WooCommerce, there is an ability to set a “Shipping Method”. This option allows you to define in Scurri which shipments you would like to include or exclude from the import. 

To set up a “Shipping Method” in WooCommerce, select the ‘Add Shipping’ button at the bottom of each order and input a ‘Shipping Line Name’. For each ‘Shipping Line Name’, you can include a Shipping Cost.

In your WooCommerce Integration in Scurri, you can set the different ‘Shipping Line Name’(comma separated) you would like to include or exclude from the import process. 

1. Log in to Scurri
2. Navigate to Setup > Integrations > WooCommerce > Edit
3. Input your Include or Exclude Shipping Lines
   • If “include” is set, then Scurri pulls orders where any “Shipping line name” matches one of the include methods
   • If “exclude” is set, then Scurri excludes orders where any “Shipping line name” matches one of the exclude methods