# Shopify & Virtualstock Supplier

## Overview <a href="#overview" id="overview"></a>

The *Shopify & Virtualstock Supplier* blueprint includes everything you need to sync orders, fulfillments, and inventory between *Virtualstock Supplier* and *Shopify.* The high-level architecture is illustrated below:

<figure><img src="/files/JKX0KeHWeQlj4B39TjjY" alt=""><figcaption></figcaption></figure>

Orders are pulled from *Virtualstock Supplier* and created in Shopify with a `paid` and `unfulfilled` status. When a fulfilment partner ships an order in Shopify, Patchworks pulls shipment information and sends this (together with a tracking number) to *Virtualstock Supplier*. Finally, inventory is synced from Shopify to *Virtualstock Supplier*.

## Prerequisites <a href="#prerequisites" id="prerequisites"></a>

| Item                                                                                               | Notes                                                                                                                                                                                                                                                                           |
| -------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Virtualstock & Shopify staging/sandbox credentials                                                 | Virtualstock Supplier credentials are provided by the associated Virtualstock merchant- e.g.  John Lewis.                                                                                                                                                                       |
| Virtualstock & Shopify live/production credentials                                                 | Virtualstock Supplier credentials are provided by the associated Virtualstock merchant- e.g.  John Lewis.                                                                                                                                                                       |
| List of all Shopify SKUs and corresponding Virtualstock Supplier part numbers                      | This will usually be in the form of a spreadsheet that's issued by the *Virtualstock Supplier* merchant. For example, John Lewis provide a spreadsheet named *Smartsheet* or *JL SKU*s. Note: for testing, you only require enough SKUs/part numbers to fulfill required tests. |
| List of Shopify carriers that will be used for Virtualstock Supplier orders                        | The Slug for these carriers is usually provided by the Virtualstock Supplier merchant (e.g. John Lewis).                                                                                                                                                                        |
| Test scenarios                                                                                     | Some Virtualstock merchants mandate specific test scenarios - for example, John Lewis require three  test orders to be processed before live/production credentials are released.                                                                                               |
| Confirmation of predefined values to be used for acknowledgement back to  *Virtualstock Supplier*. | <p></p><ul><li><code>Supplier\_delivery\_date</code>. This is usually <code>orderdate</code> plus 5-7 days</li><li><code>Fulfillment\_route</code>. This is usually set to <code>Direct to customer</code>.</li></ul>                                                           |

## Operations summary <a href="#app-installation-and-setup" id="app-installation-and-setup"></a>

In Patchworks, an [operation](/product-documentation/company-management/company-insights/company-insights-overview/about-operations.md) is counted whenever a request is made to send or receive a payload to/from an endpoint. The operations count for installed process flows is shown below:

| Process flow                                                                                                                                                                                                          | Operations count  | Default run frequency\* |
| --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------- | ----------------------- |
| [Orders](/product-documentation/blueprints/patchworks-blueprints/shopify-and-virtualstock-supplier/available-process-flows-shopify-and-virtualstock-supplier/orders-shopify-and-virtualstock-supplier.md)             | 4 per order       | Every 10 minutes        |
| [Fulfillments](/product-documentation/blueprints/patchworks-blueprints/shopify-and-virtualstock-supplier/available-process-flows-shopify-and-virtualstock-supplier/fulfillments-shopify-and-virtualstock-supplier.md) | 2 per fulfillment | Hourly                  |
| [Inventory](/product-documentation/blueprints/patchworks-blueprints/shopify-and-virtualstock-supplier/available-process-flows-shopify-and-virtualstock-supplier/inventory-shopify-and-virtualstock-supplier.md)       | 3 per sync        | 2 x daily               |

<mark style="color:red;">\*</mark> You can change the frequency at which process flows run - please see our [installation guide](/product-documentation/blueprints/patchworks-blueprints/shopify-and-virtualstock-supplier/installation-guide-shopify-and-virtualstock-supplier.md) for details.

## Blueprint installation & setup <a href="#app-installation-and-setup" id="app-installation-and-setup"></a>

Please see our [installation guide](/product-documentation/blueprints/patchworks-blueprints/shopify-and-virtualstock-supplier/installation-guide-shopify-and-virtualstock-supplier.md).

## Available process flows

Please see our [available process flows](/product-documentation/blueprints/patchworks-blueprints/shopify-and-virtualstock-supplier/available-process-flows-shopify-and-virtualstock-supplier.md) section.

## Out of Scope

* Cancellations both from Virtualstock Supplier and From Shopify
* Returns/Refunds
* Product Creation
* Lead Time updates to Virtualstock Supplier


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://doc.wearepatchworks.com/product-documentation/blueprints/patchworks-blueprints/shopify-and-virtualstock-supplier.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.