# Fulfillments (Shopify & Virtualstock Supplier)

## Introduction

Patchworks pulls fulfilled orders from Shopify and the dispatch is then sent to *Virtualstock Supplier*, with the associated tracking number.

<figure><img src="https://2440044887-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLYNcUBVQwSkOMG6KjZfz%2Fuploads%2FnBdMJ5z99Qb0No5MiXZP%2Ffulfillments%20flow%20illustration.png?alt=media&#x26;token=691e94ff-3fd5-4d31-a838-7a43743cdf2b" alt=""><figcaption></figcaption></figure>

We pull newly updated orders with a `fulfilled` or `partially-fulfilled` status and filters on `source_name` = `VS_Patchworks` for sales orders.

## Process flow snapshot

<details>

<summary><img src="https://2440044887-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLYNcUBVQwSkOMG6KjZfz%2Fuploads%2FSUvxsp8XwrC9qsafJMIe%2Ficon%20process%20flow.svg?alt=media&#x26;token=ad1dc886-4a4e-4cad-9ad0-3d755e0f3b5a" alt="" data-size="line"> Process flow snapshot</summary>

![](https://2440044887-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLYNcUBVQwSkOMG6KjZfz%2Fuploads%2FQVUCdR6vZTM8WDZiPbHd%2Ffulfillmenets%20flow.png?alt=media\&token=61c9deb3-2e08-40d4-99ea-ff1dd4b045bd)

</details>

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

The operations count for this process flow is: **2 per fulfillment**.

## Process flow shapes

For reference, all shapes in this process flow are documented below. Do not change shape settings unless advised to do so in our [installation guide](https://doc.wearepatchworks.com/product-documentation/blueprints/patchworks-blueprints/shopify-and-virtualstock-supplier/installation-guide-shopify-and-virtualstock-supplier). &#x20;

<table data-full-width="false"><thead><tr><th width="270">Shape</th><th>Notes</th></tr></thead><tbody><tr><td>Trigger</td><td>Having installed the blueprint, edit this shape and define your preferred run schedule. Please see the <a href="../installation-guide-shopify-and-virtualstock-supplier/stage-6-review-and-test-the-fulfillments-process-flow-shopify-to-virtualstock-supplier">installation guide</a> for specific notes.</td></tr><tr><td>Connector</td><td>This shape includes parameters that you should review/update. Please see the <a href="../installation-guide-shopify-and-virtualstock-supplier/stage-6-review-and-test-the-fulfillments-process-flow-shopify-to-virtualstock-supplier">installation guide</a> for specific notes.<br><br><code>Source instance</code>: Shopify <br><code>Source endpoint</code>: GET Retrieve a list of orders<br><code>Parameters</code>:  <code>created_at_min</code>  <code>financial_status</code> <code>status</code> <code>fulfillment_status</code> <code>updated_at_min</code></td></tr><tr><td>Filter</td><td><p>There should be no need to change any settings for this shape. For reference, required settings are:<br></p><p><code>Source instance</code>: N/A <br><code>Source endpoint</code>: N/A<br><code>Filters</code>: Set as: <code>*.source_name</code> <code>string</code> <code>equals</code> <code>VS_Patchworks</code><br><code>Keep matching</code>: ON</p></td></tr><tr><td>Flow control</td><td><p>There should be no need to change any settings for this shape. For reference, required settings are:<br><br><code>Source instance</code>: N/A <br><code>Source endpoint</code>: N/A</p><p><code>Batch level</code>: *<br><code>Batch size</code>: 1</p></td></tr><tr><td>Script</td><td>These settings should not be changed. For reference, required settings are:<br><br><code>Script</code>: Save Order URI ID to Meta Var<br><code>Version</code>: v5 (latest) </td></tr><tr><td>Flow control</td><td><p>There should be no need to change any settings for this shape. For reference, required settings are:<br><br><code>Source instance</code>: N/A <br><code>Source endpoint</code>: N/A</p><p><code>Batch level</code>: *.fulfillments<br><code>Batch size</code>: 1</p></td></tr><tr><td>De-dupe</td><td><p>There should be no need to change any settings for this shape. For reference, required settings are:<br><br><code>Source instance</code>: N/A <br><code>Source endpoint</code>: N/A</p><p><code>Entity</code>: Fulfillments<br><code>Behaviour</code>: Filter records</p><p><code>Data Pool</code>: FulfillmentOrder<br><code>Key field</code>: *.id<br><code>Behaviour</code>: JSON</p></td></tr><tr><td>Add to cache</td><td>These settings should not be changed. For reference, required settings are:<br><br><code>Cache</code>: (Flow run) FulfillmentOrder<br><code>Cache key</code>: FulfillmentOrder<br><code>Append</code>: OFF<br><code>Save all pages</code>: ON</td></tr><tr><td>Map</td><td>Generally, field mappings should not be changed. However please refer to the <a href="../installation-guide-shopify-and-virtualstock-supplier/stage-5-review-and-test-the-orders-process-flow-shopify-and-virtualstock-supplier">installation guidelines for this process flow</a> for any fields that are noted for special attention.<br><br><code>Source instance</code>: None <br><code>Source endpoint</code>: None</td></tr><tr><td>Connector</td><td>If instance credentials are provided as part of the blueprint installation, there should be no need to change any settings for this shape. For reference, the required settings are:<br><br><code>Source instance</code>: Virtualstock Supplier <br><code>Source endpoint</code>: POST Dispatch an order<br><code>Variables</code>: Set as <code>OrderURI</code> / <code>[[meta.JLorderId]]</code></td></tr><tr><td>Load from cache</td><td>These settings should not be changed. For reference, required settings are:<br><br><code>Cache</code>: (Flow run) FulfillmentOrder<br><code>Cache key</code>: FulfillmentOrder<br><code>Fail on cache miss</code>: OFF<br><code>Load all pages</code>: ON</td></tr><tr><td>De-dupe</td><td><p>There should be no need to change any settings for this shape. For reference, required settings are:<br><br><code>Source instance</code>: N/A <br><code>Source endpoint</code>: N/A</p><p><code>Entity</code>: Fulfillments<br><code>Behaviour</code>: Track records</p><p><code>Data Pool</code>: FulfillmentOrder<br><code>Key field</code>: *.id<br><code>Behaviour</code>: JSON</p></td></tr></tbody></table>

## Scripts used in this process flow

<table><thead><tr><th width="293">Script</th><th>Summary</th></tr></thead><tbody><tr><td>Save Order URI ID to Meta Var</td><td>Extracts URI from Shopify notes.</td></tr></tbody></table>

## Cross-reference lookups used in this process flow

<table><thead><tr><th width="293">Cross-reference lookup</th><th>Summary</th></tr></thead><tbody><tr><td>Carrier map</td><td>Maps Shopify tracking companies to Virtualstock carriers (and vice versa). You need to update this table with your own values - please see the <a href="../installation-guide-shopify-and-virtualstock-supplier/stage-4-update-cross-reference-lookups-shopify-to-virtualstock-supplier">installation guide</a> for details.</td></tr><tr><td>SKU Lookup</td><td>Maps <em>Virtualstock Supplier</em> part numbers to Shopify SKUs. You need to update this table with your own values - please see the <a href="../installation-guide-shopify-and-virtualstock-supplier/stage-4-update-cross-reference-lookups-shopify-to-virtualstock-supplier">installation guide</a> for details.</td></tr></tbody></table>