1. Installation

The OneStock connector is available on the Shopify marketplace. To install the OneStock connector, you need a Shopify Plus shop.

...

You’ll be redirected on your shop admin and asked to install the connector.

...

2. Configuration page

The configuration of the connector is done directly on the shop admin page.

2.1. General API configuration

Go to your configuration page and fill the mandatory fields:

...

Once your credential saved, you will have access to more configurations and also to two admin pages : Synchronization and Carrier services.

...

2.2 Order synchronization

If checked, the connector will listen to all orders created in Shopify to create them in OneStock.

...

Those 3 webhooks let the connector update the order on Shopify when a line item is removed or when a parcel is dispatched.

parcel_state_changed:

The connector is listening to dispatched and collected states of a parcel. If the parcel is at one of those state, the connector create a fulfillment for the related line items. (A fulfillment order represents a group of one or more items in an order that will be fulfilled from the same location.)

order_state_changed:

The connector is listening to removed and fulfilled states of an order.

If the order is at one of those state, the connector checks if there are items that need to be hold. In case there are items that need to be hold, it applies a fulfillment hold on the related fulfillment order.

line_item_group_state_changed:

The connector is listening to removed state of a line item. If the line item group is at this state, it applies a fulfillment hold on the related fulfillment order.

Rulesets Mapping (optional)

Map your Shopify delivery rate to a OneStock ruleset chaining you want your order to be orchestrated with.

...

Sales channel (optional)

A dropdown will reveal available sales channel configured in OneStock. This value will be used for order creation but also for the delivery promise calls.

...

2.3. Stock configuration (optional)

SFTP Configuration

This is where you have to configure the sftp for stock export from OneStock to Shopify.
The values to enter will be specified by the owner of the SFTP that you are using.

Location & Stock request mapping (optional)

This is to configure the stock export from OneStock to Shopify for full stock and delta stock.

Values to input here will be given by your OneStock contact.

...

Timezone (optional)

This is to configure the timezone you are using for your scheduled stock imports

2.4. Delivery promise

Delivery promises Mapping (optional)

If you have subscribed to OneStock delivery promise, you can display the delivery promise result on your checkout page under every Shopify delivery rate.

...

Default location for Delivery Promise (demo, don’t use)

The connector is shipped with a theme block to display every delivery promise configured on the delivery promise mapping. This block is used to call the delivery promise with the country and zip code inputted here when the theme block is activated on the product and basket pages.

...

3. Synchronization page

This page allows you to trigger a product synchronization or to trigger a stock import (full or diff).

...

3.1 Synchronize specific products

You can also use the products list or details pages on Shopify to filter the products you want to synchronize. A synchronize button is available on the more options button.

...

This synchronize button is also available on a specific product page

...

3.2 Synchronize orders

You can also force an order synchronization from the order list or an order detail page of Shopify through a more action button.

Image AddedImage Added

4. Carrier services page

This page allows you to create a new delivery option based on a delivery method from OneStock.

...

Thus, if a delivery method is dynamic (e.g. only available depending on the items on the basket or on the delivery address), you have to create the rate from this page.

...

4.1 Create a rate

First, you have to make sure that the delivery promise route is configured and exists in OneStock.

...

• Default Service name : the name that your customers will see in the checkout page.

• Translations : if your shop supports multiple langages, you can translate the delivery option name that will be displayed on the checkout page here

• Code : required by Shopify, this will be the rate code that is saved in the Shopify Order

• Is C&C : if set to true, a list of stores that can fulfill the order will be displayed

• Cost : you can set a fixed cost here. If not filled, we will use the cost returned by the delivery promise

• Currency : set the currency of the cost

• Delivery Promise Route : select the delivery route that is configured in OneStock

• Ruleset (optional) : the ruleset chaining that will be posted to OneStock with the order.

...

5. Translation page

The connector displays the delivery promise for two types of messages on the checkout page: click and collect and home delivery.

...

There is an helper on the top right that explains the variables you can use but also some text transformers to display the dates in different formats

...

6. Documentation page

This page explains the two proxy routes opened by the connector. This is used so that your system integrator can make a custom implementation of the delivery promise and do extra stock check before checkout.

Usage of those routes must be validated by your OneStock contact. The content of the paylods will be validated during your technical workshops.

...

7. Checkout extension and delivery promise

7.1. Display the delivery promise in the checkout

To display the delivery promise on your checkout page, you have to add our app block in your checkout page from the shopify admin.

...

8.

...

Metafield data for custom integration.

The connector populates an order metafield with the response we got in the checkout page.

...

8.1. Delivery promise data

You can use Shopify APIs to retrieve this information to correctly create an order in OneStock if you are not using the order synchronization from the connector. This is to populate the delivery_promise parameter of the POST /orders API.

[
    {
        "carbon_footprint": 100,
        "cost": 1,
        "cutoff": 1722224700,
        "delivery_method": "my_delivery_method_name",
        "destination": {
            "location": {
                "country": "FR",
                "zip_code": "31400"
            }
        },
        "eta_end": 1722524401,
        "eta_start": 1722322800,
        "shipment_number": 1,
        "delivery_routes": [
            {
                "carrier": {
                    "name": "carrier name",
                    "option": "standard"
                },
                "items": [
                    {
                        "id": "my_item_id",
                        "quantity": 1
                    }
                ]
            }
        ],
        "status": "valid",
        "code": "Standard",
        "delivery_promise_message": "The delivery promise displayed to the customer"
    }
]

8.2. Click and Collect data for custom integration

The selected store for click and collect is also stored on the delivery_promise metafield.

You can retrieve the store value to be used for your integration in destination.endpoint_id

{
    "carbon_footprint": 100,
    "cost": 1,
    "cutoff": 1722224700,
    "delivery_method": "ckc",
    "destination": {
        "endpoint_id": "my_store_id"
    },
    "eta_end": 1722524401,
    "eta_start": 1722326400,
    "shipment_number": 1,
    "delivery_routes": [
        {
            "carrier": {
                "name": "carrier name",
                "option": "standard"
            },
            "items": [
                {
                    "id": "my_item_id",
                    "quantity": 1
                }
            ]
        }
    ],
    "status": "valid",
    "code": "ckc",
    "delivery_promise_message": "the delivery promise message"
}