# Lightspeed X-Series & Shopify

## Overview

The **Lightspeed X-Series & Shopify** blueprint includes everything you need to sync:

* Stock data from Shopify to Lightspeed X-Series 
* Product data from Shopify to Lightspeed X-Series 
* Sales order data from Lightspeed X-Series to Shopify
* Customer data from Lightspeed X-Series to Shopify 

## Installed process flows

Process flows are built to implement powerful data flows between connector instances in an intuitive, visual way - this is where we define if, when, what, and how data is synced. All process flows installed with this blueprint are shown below.

<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"> Shopify > Lightspeed Retail - Stock</summary>

![](https://2440044887-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLYNcUBVQwSkOMG6KjZfz%2Fuploads%2FYvpj1A945a4WxiQpYYh3%2Fflow%201%20-%20Shopify%20%3E%20Lightspeed%20Retail%20-%20Stock.png?alt=media\&token=4313aa94-f4e4-4628-9079-97fed9bf8d4d)

</details>

<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"> Shopify > Lightspeed Retail - Products</summary>

![](https://2440044887-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLYNcUBVQwSkOMG6KjZfz%2Fuploads%2FyLEeFsXFYwOzJvma4sJl%2Fflow%202%20-%20Shopify%20%3E%20Lightspeed%20Retail%20-%20Products.png?alt=media\&token=91da9f71-9eef-4fcd-af22-61b4af04a2dc)

</details>

<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"> Lightspeed > Shopify - Sales Orders</summary>

![](https://2440044887-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLYNcUBVQwSkOMG6KjZfz%2Fuploads%2FExdI2upUobjoUBQOqlVX%2Fflow%203%20-%20Lightspeed%20%3E%20Shopify%20-%20Sales%20Orders.png?alt=media\&token=5d4eb32d-5ccb-4507-a172-e6735eaf4afb)

</details>

<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"> Lightspeed > Shopify - Customers</summary>

![](https://2440044887-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLYNcUBVQwSkOMG6KjZfz%2Fuploads%2FJ4AXGeOR8bkWtdqPP5bp%2Fflow%204%20-%20Lightspeed%20%3E%20Shopify%20-%20Customers.png?alt=media\&token=050dcf1f-592e-4fca-9965-cef16f248557)

</details>

{% hint style="info" %}
You'll find installed process flows in the [manage process flows area of your dashboard](https://app.wearepatchworks.com/flows). For product documentation please see [Process flows](https://doc.wearepatchworks.com/product-documentation/process-flows).
{% endhint %}

## Installed connectors

A [connector](https://doc.wearepatchworks.com/product-documentation/connectors-and-instances) is a generic integration of a third-party business system/application. Connector instances (configured by you as part of the [blueprint install process](https://doc.wearepatchworks.com/product-documentation/blueprints/patchworks-blueprints/installing-a-patchworks-blueprint), or later via your [connectors page](https://doc.wearepatchworks.com/product-documentation/connectors-and-instances/working-with-instances/adding-an-instance)), are added to process flows via the [connector shape](https://doc.wearepatchworks.com/product-documentation/process-flows/building-process-flows/process-flow-shapes/standard-shapes/connector-shape).  All connectors installed with this blueprint are shown below.

<table data-card-size="large" data-view="cards"><thead><tr><th></th><th></th><th></th><th data-hidden data-card-cover data-type="files"></th></tr></thead><tbody><tr><td><a href="../../connectors-and-instances/patchworks-connectors/lightspeed-retail-x-series-prebuilt-connector">Lightspeed Retail X-Series</a> (formerly Vend) is a retail POS, inventory management, and eCommerce solution.</td><td></td><td></td><td><a href="https://2440044887-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLYNcUBVQwSkOMG6KjZfz%2Fuploads%2FmmdcoEyDt6QNf6ulEDYY%2Flightspeed2.svg?alt=media&#x26;token=0872bfb1-5cd0-4120-9ec4-8c600d415182">lightspeed2.svg</a></td></tr><tr><td><a href="../../connectors-and-instances/patchworks-connectors/shopify-prebuilt-connector">Shopify</a> is a cloud-based, fully hosted commerce platform which can be used to create and manage online stores.</td><td></td><td></td><td><a href="https://2440044887-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLYNcUBVQwSkOMG6KjZfz%2Fuploads%2Fm1CTJOzDDCC60gkBdaRy%2Fshopify2.svg?alt=media&#x26;token=6576ee77-1607-4862-b44b-7f595e1bdf19">shopify2.svg</a></td></tr></tbody></table>

{% hint style="info" %}
You'll find installed connectors in the [manage connectors area of your dashboard](https://app.wearepatchworks.com/connectors). For product documentation please see [Connectors & instances](https://doc.wearepatchworks.com/product-documentation/connectors-and-instances/connectors-and-instances-introduction).
{% endhint %}

## Installed scripts

Custom scripts are implemented via the [script shape](https://doc.wearepatchworks.com/product-documentation/process-flows/building-process-flows/process-flow-shapes/advanced-shapes/script-shape), and are typically used when source data needs to be manipulated beyond the capabilities that standard [transform functions](https://doc.wearepatchworks.com/product-documentation/process-flows/building-process-flows/process-flow-shapes/standard-shapes/map-shape/working-with-field-transformations) provide. All scripts installed with this blueprint are shown below.

| Script title                        | Summary                                       |
| ----------------------------------- | --------------------------------------------- |
| Check if customer exists in Shopify | Checks if customers already exist in Shopify. |
| Convert Order ID to Metadata        | Converts `order id` to metadata.              |
| Set Inventory ID                    | Sets `inventory ID` to metadata.              |
| Set Product ID                      | Sets `product ID` to metadata.                |
| Set Shopify Customer ID             | Sets `customer ID` to metadata.               |

{% hint style="info" %}
You'll find installed scripts in the [scripts area of your dashboard](https://app.wearepatchworks.com/scripts). For product documentation please see [Custom scripting](https://doc.wearepatchworks.com/product-documentation/developer-hub/custom-scripting).
{% endhint %}

## Installed cross-reference lookups

Cross-reference lookups are used for cases where some values are commonly known by other terms. If source data includes values that always need to be changed to an alternative term, a [cross-reference lookup](https://doc.wearepatchworks.com/product-documentation/marketplace/marketplace-cross-reference-lookups) can be used to [transform](https://doc.wearepatchworks.com/product-documentation/process-flows/cross-reference-lookups/using-a-cross-reference-lookup-in-field-transformations) required data fields (via the [map](https://doc.wearepatchworks.com/product-documentation/process-flows/building-process-flows/process-flow-shapes/standard-shapes/map-shape) shape). All cross-reference lookups installed with this blueprint are shown below.

| Cross-reference lookup name | Cross-reference lookup description |
| --------------------------- | ---------------------------------- |
| -                           | -                                  |

{% hint style="info" %}
You'll find installed cross-reference lookups in the [cross-reference lookups area of your dashboard](https://app.wearepatchworks.com/cross-reference-lookups). For product documentation please see [Cross-reference lookups](https://doc.wearepatchworks.com/product-documentation/marketplace/marketplace-cross-reference-lookups).
{% endhint %}

## Installed caches

Caches are specified in the [add to cache shape](https://doc.wearepatchworks.com/product-documentation/process-flows/building-process-flows/process-flow-shapes/advanced-shapes/cache/add-to-cache-shape) and used to store data (temporarily) at given points in a process flow. This means that data from a previous point in time can be referenced later in the same process flow or by other process flows, via a [load from cache shape](https://doc.wearepatchworks.com/product-documentation/process-flows/building-process-flows/process-flow-shapes/advanced-shapes/cache/load-from-cache-shape). All caches installed with this blueprint are shown below.

| Cache name  | Cache type |
| ----------- | ---------- |
| Sales Cache | Flow run   |
| Stock Cache | Flow run   |

{% hint style="info" %}
You'll find installed caches in the [data caches area of your dashboard](https://app.wearepatchworks.com/caches). For product documentation please see [Cache shapes](https://doc.wearepatchworks.com/product-documentation/process-flows/building-process-flows/process-flow-shapes/advanced-shapes/cache).
{% endhint %}

## Installed data pools

Data pools are used by the [de-dupe shape](https://doc.wearepatchworks.com/product-documentation/process-flows/building-process-flows/process-flow-shapes/advanced-shapes/de-dupe-shape) in process flows. They store unique key field values that have passed through the shape so subsequent records can be checked and matched for duplication. All data pools installed with this blueprint are shown below.

| Data pool name       | Unique key     | Applicable process flows                                     |
| -------------------- | -------------- | ------------------------------------------------------------ |
| Lightspeed Customers | customer email | [Lightspeed > Shopify - Customers](#installed-process-flows) |


---

# 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/lightspeed-x-series-and-shopify.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.