> For the complete documentation index, see [llms.txt](https://help.supplyd.co/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.supplyd.co/supplyd-erp/settings/integrations/sales-channel-integrations/square/configuring-the-square-integration.md).

# Configuring the Square Integration

Configuring your Square integration ensures orders, inventory & product information are synced correctly to suit your business operations.

The Square integration settings allow you to control how orders, inventory and products are synced between Square and Supply’d. You can configure syncing preferences, select locations, match products and manage how product information is sent to Square.

This document explains the available Square integration settings and how to configure them to suit your business.

***

## Configuring the Square Integration

{% hint style="info" %}
Before configuring these settings, ensure you have connected your Square account to Supply’d.

👉 For instructions, see [Connecting to Square](https://help.supplyd.co/supplyd-erp/settings/integrations/sales-channel-integrations/square/connecting-to-square.md).
{% endhint %}

{% stepper %}
{% step %}

#### Open the Square Settings Page

To access your Square integration settings:<br>

1. Click your company name in the top-right corner and select **Settings** from the **Account** menu.
2. Scroll down and select **Integrations**.
3. Select **Square** from the integrations list.<br>

The **Square Settings** page will open.

<figure><img src="https://2965503026-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDaPYJDB89ny0x7wcMedb%2Fuploads%2FQRICojD4TZWkp8dsCMX3%2FSpacer.png?alt=media&amp;token=3bc5fa40-c805-461a-a4e4-b8c4ca526aad" alt=""><figcaption></figcaption></figure>

<div data-with-frame="true"><figure><img src="https://2965503026-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDaPYJDB89ny0x7wcMedb%2Fuploads%2FHeGScWI8mtK9JgIs6lnt%2FSquare%20Settings%20Form%20-%20NB.png?alt=media&amp;token=81e92dca-4a4f-48d4-8cc4-f2dfec509047" alt="" width="563"><figcaption></figcaption></figure></div>

<figure><img src="https://2965503026-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDaPYJDB89ny0x7wcMedb%2Fuploads%2FbJDih3Dwv41QavjV1QDa%2FSpacer.png?alt=media&amp;token=6c34f805-9610-4de9-8f8a-a029f13dd1a1" alt=""><figcaption></figcaption></figure>

Complete the form using the guidelines below.

<figure><img src="https://2965503026-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDaPYJDB89ny0x7wcMedb%2Fuploads%2FbJDih3Dwv41QavjV1QDa%2FSpacer.png?alt=media&amp;token=6c34f805-9610-4de9-8f8a-a029f13dd1a1" alt=""><figcaption></figcaption></figure>

***

{% endstep %}

{% step %}

#### General Settings

<figure><img src="https://2965503026-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDaPYJDB89ny0x7wcMedb%2Fuploads%2FG8XYUeWDpFyAAfHvQ26p%2FSpacer.png?alt=media&amp;token=d1017aad-751e-46d9-ad85-7546e0f615cb" alt=""><figcaption></figcaption></figure>

<div data-with-frame="true"><figure><img src="https://2965503026-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDaPYJDB89ny0x7wcMedb%2Fuploads%2FBIywrFUchyvqPKJGbIOU%2FSquare%20Integration%20Name%20-%20NB.png?alt=media&amp;token=788bbfa4-e60f-4a2d-a33c-0db4595f3b0c" alt=""><figcaption></figcaption></figure></div>

<figure><img src="https://2965503026-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDaPYJDB89ny0x7wcMedb%2Fuploads%2FbJDih3Dwv41QavjV1QDa%2FSpacer.png?alt=media&amp;token=6c34f805-9610-4de9-8f8a-a029f13dd1a1" alt=""><figcaption></figcaption></figure>

**Integration Name\* \[required field]**

Enter a reference name for this integration.

<figure><img src="https://2965503026-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDaPYJDB89ny0x7wcMedb%2Fuploads%2FmurMTSBr5ONapkfWbeN8%2FSpacer.png?alt=media&amp;token=642d6d48-93c5-4ef4-a74f-2abef01d15a5" alt=""><figcaption></figcaption></figure>

***

{% endstep %}

{% step %}

#### Sync Orders?

Toggle on to automatically import sales orders from Square into Supply’d, allowing you to manage orders in one central location.

<figure><img src="https://2965503026-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDaPYJDB89ny0x7wcMedb%2Fuploads%2FmbL9OgSjx8nmO36Mscsj%2FSpacer.png?alt=media&amp;token=4cf73227-f3fa-45e1-ab66-47b41045aee4" alt=""><figcaption></figcaption></figure>

<div data-with-frame="true"><figure><img src="https://2965503026-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDaPYJDB89ny0x7wcMedb%2Fuploads%2FYU19v8yh6h9Ecdw2eJCj%2FSquare%20Sync%20Orders%20-%20NB.png?alt=media&amp;token=8d366659-55f4-4d2f-a40c-26dc9dd35cc2" alt=""><figcaption></figcaption></figure></div>

<figure><img src="https://2965503026-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDaPYJDB89ny0x7wcMedb%2Fuploads%2FmbL9OgSjx8nmO36Mscsj%2FSpacer.png?alt=media&amp;token=4cf73227-f3fa-45e1-ab66-47b41045aee4" alt=""><figcaption></figcaption></figure>

**Order Number Prefix**

Enter an optional prefix for order numbers imported from Square. This can help distinguish Square orders from orders created through other sales channels.

<figure><img src="https://2965503026-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDaPYJDB89ny0x7wcMedb%2Fuploads%2FbJDih3Dwv41QavjV1QDa%2FSpacer.png?alt=media&amp;token=6c34f805-9610-4de9-8f8a-a029f13dd1a1" alt=""><figcaption></figcaption></figure>

**Sync Locations**

Select the Square locations you would like to sync orders from.

<figure><img src="https://2965503026-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDaPYJDB89ny0x7wcMedb%2Fuploads%2FmbL9OgSjx8nmO36Mscsj%2FSpacer.png?alt=media&amp;token=4cf73227-f3fa-45e1-ab66-47b41045aee4" alt=""><figcaption></figcaption></figure>

**Sync Orders**

Choose which orders to import from Square:

<figure><img src="https://2965503026-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDaPYJDB89ny0x7wcMedb%2Fuploads%2FmbL9OgSjx8nmO36Mscsj%2FSpacer.png?alt=media&amp;token=4cf73227-f3fa-45e1-ab66-47b41045aee4" alt=""><figcaption></figcaption></figure>

<div data-with-frame="true"><figure><img src="https://2965503026-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDaPYJDB89ny0x7wcMedb%2Fuploads%2FQkDCpWKhcJOivkRQhsKf%2FSync%20Orders%20Drop%20Down%20-%20NB.png?alt=media&amp;token=015d1db2-ccd8-4f05-a26f-079248752a0e" alt="" width="375"><figcaption></figcaption></figure></div>

<figure><img src="https://2965503026-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDaPYJDB89ny0x7wcMedb%2Fuploads%2FmbL9OgSjx8nmO36Mscsj%2FSpacer.png?alt=media&amp;token=4cf73227-f3fa-45e1-ab66-47b41045aee4" alt=""><figcaption></figcaption></figure>

* **All Orders** - Import all available orders.
* **All Orders Since Date** - Import orders from a selected date onwards.

<figure><img src="https://2965503026-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDaPYJDB89ny0x7wcMedb%2Fuploads%2FbJDih3Dwv41QavjV1QDa%2FSpacer.png?alt=media&amp;token=6c34f805-9610-4de9-8f8a-a029f13dd1a1" alt=""><figcaption></figcaption></figure>

If **All Orders Since Date** is selected, an additional field, **Sync Orders Since Date**, will appear.

<figure><img src="https://2965503026-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDaPYJDB89ny0x7wcMedb%2Fuploads%2FbJDih3Dwv41QavjV1QDa%2FSpacer.png?alt=media&amp;token=6c34f805-9610-4de9-8f8a-a029f13dd1a1" alt=""><figcaption></figcaption></figure>

**Sync Orders Since Date**

This field appears when **All Orders Since Date** is selected. Click the field to open the calendar and select the date from which Square orders should be imported.

<figure><img src="https://2965503026-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDaPYJDB89ny0x7wcMedb%2Fuploads%2FzRfJZ4oiCW81yz5OksdD%2FSpacer.png?alt=media&amp;token=33e11e06-eb50-4824-a0f6-6c2482eae6a3" alt=""><figcaption></figcaption></figure>

<div data-with-frame="true"><figure><img src="https://2965503026-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDaPYJDB89ny0x7wcMedb%2Fuploads%2FNA9a6edXebLQxzwLd1nV%2FOrder%20Sync%20Start%20Date%20-%20NB.png?alt=media&amp;token=3144d25d-90fc-426c-b292-3573772986e7" alt=""><figcaption></figcaption></figure></div>

<figure><img src="https://2965503026-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDaPYJDB89ny0x7wcMedb%2Fuploads%2FzRfJZ4oiCW81yz5OksdD%2FSpacer.png?alt=media&amp;token=33e11e06-eb50-4824-a0f6-6c2482eae6a3" alt=""><figcaption></figcaption></figure>

Click the field to open the calendar and select the starting date.

<figure><img src="https://2965503026-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDaPYJDB89ny0x7wcMedb%2Fuploads%2FzRfJZ4oiCW81yz5OksdD%2FSpacer.png?alt=media&amp;token=33e11e06-eb50-4824-a0f6-6c2482eae6a3" alt=""><figcaption></figcaption></figure>

<div data-with-frame="true"><figure><img src="https://2965503026-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDaPYJDB89ny0x7wcMedb%2Fuploads%2F4zHFrkUZrECHXydu5mLP%2FOrder%20Sync%20Start%20Date%20Calender%20-%20NB.png?alt=media&amp;token=cf511db2-b514-4e86-bb30-39c56d029973" alt="" width="375"><figcaption></figcaption></figure></div>

<figure><img src="https://2965503026-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDaPYJDB89ny0x7wcMedb%2Fuploads%2FzRfJZ4oiCW81yz5OksdD%2FSpacer.png?alt=media&amp;token=33e11e06-eb50-4824-a0f6-6c2482eae6a3" alt=""><figcaption></figcaption></figure>

**Reduce Inventory On Import**&#x20;

Choose whether stock on hand should be reduced when Square orders are imported into Supply’d.

<figure><img src="https://2965503026-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDaPYJDB89ny0x7wcMedb%2Fuploads%2FbJDih3Dwv41QavjV1QDa%2FSpacer.png?alt=media&amp;token=6c34f805-9610-4de9-8f8a-a029f13dd1a1" alt=""><figcaption></figcaption></figure>

<div data-with-frame="true"><figure><img src="https://2965503026-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDaPYJDB89ny0x7wcMedb%2Fuploads%2FzJVOQkmBWuqCwNUz4xaG%2FReduce%20Inventory%20On%20Import%20Drop%20Down%20-%20NB.png?alt=media&amp;token=001844da-bc65-4257-a244-879d3b351bb9" alt="" width="375"><figcaption></figcaption></figure></div>

<figure><img src="https://2965503026-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDaPYJDB89ny0x7wcMedb%2Fuploads%2FzRfJZ4oiCW81yz5OksdD%2FSpacer.png?alt=media&amp;token=33e11e06-eb50-4824-a0f6-6c2482eae6a3" alt=""><figcaption></figcaption></figure>

* **Never** - Stock levels in Supply’d will not be reduced when orders are imported from Square.
* **All Orders** - Stock levels in Supply’d will be reduced for all orders imported from Square.

<figure><img src="https://2965503026-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDaPYJDB89ny0x7wcMedb%2Fuploads%2FbJDih3Dwv41QavjV1QDa%2FSpacer.png?alt=media&amp;token=6c34f805-9610-4de9-8f8a-a029f13dd1a1" alt=""><figcaption></figcaption></figure>

**Match Product SKU**&#x20;

Select which Supply’d field should be used to match products imported from Square:

<figure><img src="https://2965503026-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDaPYJDB89ny0x7wcMedb%2Fuploads%2FbJDih3Dwv41QavjV1QDa%2FSpacer.png?alt=media&amp;token=6c34f805-9610-4de9-8f8a-a029f13dd1a1" alt=""><figcaption></figcaption></figure>

<div data-with-frame="true"><figure><img src="https://2965503026-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDaPYJDB89ny0x7wcMedb%2Fuploads%2FSjxSD5FiY0rlT4yqvTvx%2FMatch%20Product%20SKU%20Using%20-%20NB.png?alt=media&amp;token=7b48678a-e7e5-4ca0-aff1-2abef7de5fe6" alt="" width="375"><figcaption></figcaption></figure></div>

<figure><img src="https://2965503026-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDaPYJDB89ny0x7wcMedb%2Fuploads%2FzRfJZ4oiCW81yz5OksdD%2FSpacer.png?alt=media&amp;token=33e11e06-eb50-4824-a0f6-6c2482eae6a3" alt=""><figcaption></figcaption></figure>

* **SKU** - Matches the SKU in Square with the **SKU** field of the corresponding product in Supply’d.
* **Barcode** - Matches the SKU in Square with the **Barcode** field of the corresponding product in Supply’d.

Square uses the product SKU to identify the corresponding product in Supply’d. The selected Supply’d field must contain the correct matching value.

<figure><img src="https://2965503026-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDaPYJDB89ny0x7wcMedb%2Fuploads%2FzRfJZ4oiCW81yz5OksdD%2FSpacer.png?alt=media&amp;token=33e11e06-eb50-4824-a0f6-6c2482eae6a3" alt=""><figcaption></figcaption></figure>

{% hint style="warning" %}
**Important: Product Matching**

Ensure all products have the correct value entered in the selected field. If **SKU** is selected, each product must have a SKU in the **SKU** field. If **Barcode** is selected, each product must have a barcode in the **Barcode** field.

Do not enter barcodes in the **SKU** field or SKUs in the **Barcode** field. Products with missing or incorrectly entered values will be skipped during syncing.
{% endhint %}

<figure><img src="https://2965503026-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDaPYJDB89ny0x7wcMedb%2Fuploads%2FbJDih3Dwv41QavjV1QDa%2FSpacer.png?alt=media&amp;token=6c34f805-9610-4de9-8f8a-a029f13dd1a1" alt=""><figcaption></figcaption></figure>

**Sync Location - Warehouse**&#x20;

Select the Supply’d warehouse associated with the Square location.

The **Sync Location** identifies the Square location, while **Warehouse** determines the corresponding warehouse in Supply’d.

<figure><img src="https://2965503026-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDaPYJDB89ny0x7wcMedb%2Fuploads%2FzRfJZ4oiCW81yz5OksdD%2FSpacer.png?alt=media&amp;token=33e11e06-eb50-4824-a0f6-6c2482eae6a3" alt=""><figcaption></figcaption></figure>

<div data-with-frame="true"><figure><img src="https://2965503026-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDaPYJDB89ny0x7wcMedb%2Fuploads%2FE3qDWYlJ8NeMqlQ0dye8%2FSupply'd%20Test%20Account%20-%20Warehouse%20-%20NB.png?alt=media&amp;token=8aca81e8-fab8-48d5-b35b-6fd67bde91c1" alt="" width="375"><figcaption></figcaption></figure></div>

<figure><img src="https://2965503026-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDaPYJDB89ny0x7wcMedb%2Fuploads%2FzRfJZ4oiCW81yz5OksdD%2FSpacer.png?alt=media&amp;token=33e11e06-eb50-4824-a0f6-6c2482eae6a3" alt=""><figcaption></figcaption></figure>

***

{% endstep %}

{% step %}

#### Sync Inventory

These settings control how inventory information is synced from Supply’d to Square.

Toggle on **Sync Inventory** to enable inventory syncing from Supply’d to Square.

<figure><img src="https://2965503026-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDaPYJDB89ny0x7wcMedb%2Fuploads%2FzRfJZ4oiCW81yz5OksdD%2FSpacer.png?alt=media&amp;token=33e11e06-eb50-4824-a0f6-6c2482eae6a3" alt=""><figcaption></figcaption></figure>

<div data-with-frame="true"><figure><img src="https://2965503026-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDaPYJDB89ny0x7wcMedb%2Fuploads%2FnDQZpSF8m6wANsaJ2dK7%2FSquare%20Sync%20Inventory%20-%20NB.png?alt=media&amp;token=08fe39e8-35bc-4c3e-92a5-19a5d6f480ac" alt=""><figcaption></figcaption></figure></div>

<figure><img src="https://2965503026-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDaPYJDB89ny0x7wcMedb%2Fuploads%2FzRfJZ4oiCW81yz5OksdD%2FSpacer.png?alt=media&amp;token=33e11e06-eb50-4824-a0f6-6c2482eae6a3" alt=""><figcaption></figcaption></figure>

**Sync Location - Warehouse**&#x20;

Select the Supply’d warehouse you would like to make available for inventory syncing with the corresponding Square location.

<figure><img src="https://2965503026-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDaPYJDB89ny0x7wcMedb%2Fuploads%2FzRfJZ4oiCW81yz5OksdD%2FSpacer.png?alt=media&amp;token=33e11e06-eb50-4824-a0f6-6c2482eae6a3" alt=""><figcaption></figcaption></figure>

<div data-with-frame="true"><figure><img src="https://2965503026-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDaPYJDB89ny0x7wcMedb%2Fuploads%2FE3qDWYlJ8NeMqlQ0dye8%2FSupply'd%20Test%20Account%20-%20Warehouse%20-%20NB.png?alt=media&amp;token=8aca81e8-fab8-48d5-b35b-6fd67bde91c1" alt="" width="375"><figcaption></figcaption></figure></div>

<figure><img src="https://2965503026-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDaPYJDB89ny0x7wcMedb%2Fuploads%2FzRfJZ4oiCW81yz5OksdD%2FSpacer.png?alt=media&amp;token=33e11e06-eb50-4824-a0f6-6c2482eae6a3" alt=""><figcaption></figcaption></figure>

**Match Product SKU Using**&#x20;

Select which Supply’d field should be used to match products in Square:

<figure><img src="https://2965503026-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDaPYJDB89ny0x7wcMedb%2Fuploads%2FzRfJZ4oiCW81yz5OksdD%2FSpacer.png?alt=media&amp;token=33e11e06-eb50-4824-a0f6-6c2482eae6a3" alt=""><figcaption></figcaption></figure>

<div data-with-frame="true"><figure><img src="https://2965503026-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDaPYJDB89ny0x7wcMedb%2Fuploads%2FSjxSD5FiY0rlT4yqvTvx%2FMatch%20Product%20SKU%20Using%20-%20NB.png?alt=media&amp;token=7b48678a-e7e5-4ca0-aff1-2abef7de5fe6" alt="" width="375"><figcaption></figcaption></figure></div>

<figure><img src="https://2965503026-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDaPYJDB89ny0x7wcMedb%2Fuploads%2FbJDih3Dwv41QavjV1QDa%2FSpacer.png?alt=media&amp;token=6c34f805-9610-4de9-8f8a-a029f13dd1a1" alt=""><figcaption></figcaption></figure>

* **SKU** - Matches the SKU in Square with the **SKU** field in Supply’d.
* **Barcode** - Matches the SKU in Square with the **Barcode** field in Supply’d.

<figure><img src="https://2965503026-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDaPYJDB89ny0x7wcMedb%2Fuploads%2FzRfJZ4oiCW81yz5OksdD%2FSpacer.png?alt=media&amp;token=33e11e06-eb50-4824-a0f6-6c2482eae6a3" alt=""><figcaption></figcaption></figure>

{% hint style="warning" %}
**Important: Product Matching**

Ensure all products have the correct value entered in the selected field. If **SKU** is selected, each product must have a SKU in the **SKU** field. If **Barcode** is selected, each product must have a barcode in the **Barcode** field.

Do not enter barcodes in the **SKU** field or SKUs in the **Barcode** field. Products with missing or incorrect values will be skipped during syncing.
{% endhint %}

<figure><img src="https://2965503026-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDaPYJDB89ny0x7wcMedb%2Fuploads%2FbJDih3Dwv41QavjV1QDa%2FSpacer.png?alt=media&amp;token=6c34f805-9610-4de9-8f8a-a029f13dd1a1" alt=""><figcaption></figcaption></figure>

**Untracked Stock Setting**&#x20;

Choose how Supply’d should handle products marked as **Untracked** in Square.

<figure><img src="https://2965503026-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDaPYJDB89ny0x7wcMedb%2Fuploads%2FzRfJZ4oiCW81yz5OksdD%2FSpacer.png?alt=media&amp;token=33e11e06-eb50-4824-a0f6-6c2482eae6a3" alt=""><figcaption></figcaption></figure>

<div data-with-frame="true"><figure><img src="https://2965503026-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDaPYJDB89ny0x7wcMedb%2Fuploads%2FQRajS6mAVl3Wzkhd6UGn%2FUntracked%20Stock%20Setting%20-%20NB.png?alt=media&amp;token=7ac5355f-09cc-42a7-b1d6-a32246c5abf5" alt="" width="375"><figcaption></figcaption></figure></div>

<figure><img src="https://2965503026-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDaPYJDB89ny0x7wcMedb%2Fuploads%2FzRfJZ4oiCW81yz5OksdD%2FSpacer.png?alt=media&amp;token=33e11e06-eb50-4824-a0f6-6c2482eae6a3" alt=""><figcaption></figcaption></figure>

* **Use Supply’d Setting** - Update the product to match its stock management setting in Supply’d.
* **Ignore Product** - Exclude the product from inventory and stock status syncing.

<figure><img src="https://2965503026-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDaPYJDB89ny0x7wcMedb%2Fuploads%2FzRfJZ4oiCW81yz5OksdD%2FSpacer.png?alt=media&amp;token=33e11e06-eb50-4824-a0f6-6c2482eae6a3" alt=""><figcaption></figcaption></figure>

***

{% endstep %}

{% step %}

#### Sync Products?

These settings control how products created or managed in Supply’d are synced to Square, including product matching, locations, tax mappings and product information.

Toggle on **Sync Products** to automatically sync selected products from Supply’d to Square.You can choose which products to sync when editing each product in Supply’d.

<figure><img src="https://2965503026-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDaPYJDB89ny0x7wcMedb%2Fuploads%2FbJDih3Dwv41QavjV1QDa%2FSpacer.png?alt=media&amp;token=6c34f805-9610-4de9-8f8a-a029f13dd1a1" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
**Product Matching Without Syncing**

If **Sync Products** is disabled, Supply’d will still attempt to match products when sales orders are imported from Square.

Products are matched using their **SKU**, so ensure the SKU in Square matches the corresponding SKU in Supply’d.

If the SKUs do not match, Supply’d will not be able to automatically identify the product and add it to the sales order.
{% endhint %}

<figure><img src="https://2965503026-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDaPYJDB89ny0x7wcMedb%2Fuploads%2FbJDih3Dwv41QavjV1QDa%2FSpacer.png?alt=media&amp;token=6c34f805-9610-4de9-8f8a-a029f13dd1a1" alt=""><figcaption></figcaption></figure>

<div data-with-frame="true"><figure><img src="https://2965503026-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDaPYJDB89ny0x7wcMedb%2Fuploads%2Fzubms6eo6eVUQkXBTur1%2FSquare%20Sync%20Products%20-%20NB.png?alt=media&amp;token=0aa4bb6d-1529-40ca-9342-f9af439b064d" alt=""><figcaption></figcaption></figure></div>

<figure><img src="https://2965503026-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDaPYJDB89ny0x7wcMedb%2Fuploads%2FzRfJZ4oiCW81yz5OksdD%2FSpacer.png?alt=media&amp;token=33e11e06-eb50-4824-a0f6-6c2482eae6a3" alt=""><figcaption></figcaption></figure>

**Match Product SKU Using**&#x20;

Select whether products should be matched using their **SKU** or **Barcode**.

Ensure the selected field is completed correctly for all products being synced.

<figure><img src="https://2965503026-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDaPYJDB89ny0x7wcMedb%2Fuploads%2FzRfJZ4oiCW81yz5OksdD%2FSpacer.png?alt=media&amp;token=33e11e06-eb50-4824-a0f6-6c2482eae6a3" alt=""><figcaption></figcaption></figure>

<div data-with-frame="true"><figure><img src="https://2965503026-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDaPYJDB89ny0x7wcMedb%2Fuploads%2FSjxSD5FiY0rlT4yqvTvx%2FMatch%20Product%20SKU%20Using%20-%20NB.png?alt=media&amp;token=7b48678a-e7e5-4ca0-aff1-2abef7de5fe6" alt="" width="375"><figcaption></figcaption></figure></div>

<figure><img src="https://2965503026-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDaPYJDB89ny0x7wcMedb%2Fuploads%2FzRfJZ4oiCW81yz5OksdD%2FSpacer.png?alt=media&amp;token=33e11e06-eb50-4824-a0f6-6c2482eae6a3" alt=""><figcaption></figcaption></figure>

{% hint style="warning" %}
**Important: Product Matching**

Ensure all products have the correct value entered in the selected field. If **SKU** is selected, each product must have a SKU in the **SKU** field. If **Barcode** is selected, each product must have a barcode in the **Barcode** field.

Do not enter barcodes in the **SKU** field or SKUs in the **Barcode** field. Products with missing or incorrect values will be skipped during syncing.
{% endhint %}

<figure><img src="https://2965503026-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDaPYJDB89ny0x7wcMedb%2Fuploads%2FbJDih3Dwv41QavjV1QDa%2FSpacer.png?alt=media&amp;token=6c34f805-9610-4de9-8f8a-a029f13dd1a1" alt=""><figcaption></figcaption></figure>

**Sync To Locations**

Select which Square locations should receive products synced from Supply’d.

<figure><img src="https://2965503026-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDaPYJDB89ny0x7wcMedb%2Fuploads%2FzRfJZ4oiCW81yz5OksdD%2FSpacer.png?alt=media&amp;token=33e11e06-eb50-4824-a0f6-6c2482eae6a3" alt=""><figcaption></figcaption></figure>

<div data-with-frame="true"><figure><img src="https://2965503026-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDaPYJDB89ny0x7wcMedb%2Fuploads%2FI2xbBBHcKKyhG3aiY8ri%2FSync%20To%20Locations%20-%20NB.png?alt=media&amp;token=149fd5cb-a298-4e21-80b4-2ae36ccdb02d" alt="" width="375"><figcaption></figcaption></figure></div>

<figure><img src="https://2965503026-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDaPYJDB89ny0x7wcMedb%2Fuploads%2FzRfJZ4oiCW81yz5OksdD%2FSpacer.png?alt=media&amp;token=33e11e06-eb50-4824-a0f6-6c2482eae6a3" alt=""><figcaption></figcaption></figure>

* **All Locations** - Sync products to all available locations.
* **Specific Locations** - Select individual locations.

If **Specific Locations** is selected, an additional field, **Specific Sync Locations**, will appear, allowing you to choose which Square locations to sync products to.

<figure><img src="https://2965503026-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDaPYJDB89ny0x7wcMedb%2Fuploads%2FzRfJZ4oiCW81yz5OksdD%2FSpacer.png?alt=media&amp;token=33e11e06-eb50-4824-a0f6-6c2482eae6a3" alt=""><figcaption></figcaption></figure>

**Specific Sync Locations**&#x20;

Select the Square location or locations you would like products to be synced to.

<figure><img src="https://2965503026-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDaPYJDB89ny0x7wcMedb%2Fuploads%2FzRfJZ4oiCW81yz5OksdD%2FSpacer.png?alt=media&amp;token=33e11e06-eb50-4824-a0f6-6c2482eae6a3" alt=""><figcaption></figcaption></figure>

<div data-with-frame="true"><figure><img src="https://2965503026-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDaPYJDB89ny0x7wcMedb%2Fuploads%2FjJo25bvqyb4yd4hB7RkI%2FSpecific%20Sync%20Locations%20-%20NB.png?alt=media&amp;token=d4ffb0bf-4005-44aa-9f39-4064f22124fc" alt=""><figcaption></figcaption></figure></div>

<figure><img src="https://2965503026-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDaPYJDB89ny0x7wcMedb%2Fuploads%2FzRfJZ4oiCW81yz5OksdD%2FSpacer.png?alt=media&amp;token=33e11e06-eb50-4824-a0f6-6c2482eae6a3" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
This field only appears when **Specific Locations** is selected under **Sync To Locations**.
{% endhint %}

<figure><img src="https://2965503026-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDaPYJDB89ny0x7wcMedb%2Fuploads%2FbJDih3Dwv41QavjV1QDa%2FSpacer.png?alt=media&amp;token=6c34f805-9610-4de9-8f8a-a029f13dd1a1" alt=""><figcaption></figcaption></figure>

**GST Tax\* \[required field]**&#x20;

Select the Square tax mapping to use for products that attract GST.

<figure><img src="https://2965503026-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDaPYJDB89ny0x7wcMedb%2Fuploads%2FzRfJZ4oiCW81yz5OksdD%2FSpacer.png?alt=media&amp;token=33e11e06-eb50-4824-a0f6-6c2482eae6a3" alt=""><figcaption></figcaption></figure>

<div data-with-frame="true"><figure><img src="https://2965503026-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDaPYJDB89ny0x7wcMedb%2Fuploads%2FxzPtPtbYu0c1ckOLzfZQ%2F%20GST%20Tax%20-%20NB.png?alt=media&amp;token=de48835c-fa49-4bcf-a3a4-ffc2c5c92e96" alt="" width="375"><figcaption></figcaption></figure></div>

<figure><img src="https://2965503026-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDaPYJDB89ny0x7wcMedb%2Fuploads%2FzRfJZ4oiCW81yz5OksdD%2FSpacer.png?alt=media&amp;token=33e11e06-eb50-4824-a0f6-6c2482eae6a3" alt=""><figcaption></figcaption></figure>

**GST Free Tax\* \[required field]**&#x20;

Select the Square tax mapping to use for GST-free products.

<figure><img src="https://2965503026-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDaPYJDB89ny0x7wcMedb%2Fuploads%2FzRfJZ4oiCW81yz5OksdD%2FSpacer.png?alt=media&amp;token=33e11e06-eb50-4824-a0f6-6c2482eae6a3" alt=""><figcaption></figcaption></figure>

<div data-with-frame="true"><figure><img src="https://2965503026-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDaPYJDB89ny0x7wcMedb%2Fuploads%2FUXj1Kpc6zrHt1wsJZSZ1%2FGST%20Free%20Tax%20-%20NB.png?alt=media&amp;token=9e966050-e38b-4226-b26c-a306ce07f6b6" alt="" width="375"><figcaption></figcaption></figure></div>

<figure><img src="https://2965503026-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDaPYJDB89ny0x7wcMedb%2Fuploads%2FzRfJZ4oiCW81yz5OksdD%2FSpacer.png?alt=media&amp;token=33e11e06-eb50-4824-a0f6-6c2482eae6a3" alt=""><figcaption></figcaption></figure>

* **None** - No GST tax is applied to the product in Square.
* **GST** - Maps the product to the GST tax option in Square.

<figure><img src="https://2965503026-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDaPYJDB89ny0x7wcMedb%2Fuploads%2FbJDih3Dwv41QavjV1QDa%2FSpacer.png?alt=media&amp;token=6c34f805-9610-4de9-8f8a-a029f13dd1a1" alt=""><figcaption></figcaption></figure>

**Name Format\* \[required field]**&#x20;

Specify the format used when sending product names from Supply’d to Square.

This field uses **Handlebars templating** to combine product information into a customised name format.

<figure><img src="https://2965503026-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDaPYJDB89ny0x7wcMedb%2Fuploads%2FbJDih3Dwv41QavjV1QDa%2FSpacer.png?alt=media&amp;token=6c34f805-9610-4de9-8f8a-a029f13dd1a1" alt=""><figcaption></figcaption></figure>

Common fields include:

| Field              | Description                                         |
| ------------------ | --------------------------------------------------- |
| `{{brand}}`        | Product brand name                                  |
| `{{name}}`         | Product name                                        |
| `{{size_unit}}`    | Product size value, such as 100 for a 100 g product |
| `{{size_measure}}` | Product size measurement, such as g                 |
| `{{carton_qty}}`   | Quantity per carton                                 |

<figure><img src="https://2965503026-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDaPYJDB89ny0x7wcMedb%2Fuploads%2FbJDih3Dwv41QavjV1QDa%2FSpacer.png?alt=media&amp;token=6c34f805-9610-4de9-8f8a-a029f13dd1a1" alt=""><figcaption></figcaption></figure>

{% hint style="success" %}
👉 For more information about available fields and formatting, see the [Handlebars](https://help.supplyd.co/supplyd-erp/settings/templating/handlebars.md) document.
{% endhint %}

<figure><img src="https://2965503026-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDaPYJDB89ny0x7wcMedb%2Fuploads%2FzRfJZ4oiCW81yz5OksdD%2FSpacer.png?alt=media&amp;token=33e11e06-eb50-4824-a0f6-6c2482eae6a3" alt=""><figcaption></figcaption></figure>

**Description Mapping**&#x20;

Configure how product descriptions are sent from Supply’d to Square.

You can use Supply’d fields with **Handlebars templating** to customise descriptions. HTML tags are also supported.

<figure><img src="https://2965503026-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDaPYJDB89ny0x7wcMedb%2Fuploads%2FbJDih3Dwv41QavjV1QDa%2FSpacer.png?alt=media&amp;token=6c34f805-9610-4de9-8f8a-a029f13dd1a1" alt=""><figcaption></figcaption></figure>

{% hint style="success" %}
👉 For more information about available fields and formatting, see the [Handlebars](https://help.supplyd.co/supplyd-erp/settings/templating/handlebars.md).
{% endhint %}

<figure><img src="https://2965503026-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDaPYJDB89ny0x7wcMedb%2Fuploads%2FzRfJZ4oiCW81yz5OksdD%2FSpacer.png?alt=media&amp;token=33e11e06-eb50-4824-a0f6-6c2482eae6a3" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
**Removing Products from Square**

Turning off **Sell on Square** for a product in Supply’d (see [Sell on Square Details](https://help.supplyd.co/supplyd-erp/products/adding-products/sell-on-square-details.md)) does not remove a product that has already been synced to Square.

If you no longer want the product available in Square, you will need to archive or remove it directly in Square. Products cannot currently be removed from Square through Supply’d.
{% endhint %}

<figure><img src="https://2965503026-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDaPYJDB89ny0x7wcMedb%2Fuploads%2FbJDih3Dwv41QavjV1QDa%2FSpacer.png?alt=media&amp;token=6c34f805-9610-4de9-8f8a-a029f13dd1a1" alt=""><figcaption></figcaption></figure>

***

{% endstep %}

{% step %}

#### Click Save

Once you have completed the required settings, click <img src="https://2965503026-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDaPYJDB89ny0x7wcMedb%2Fuploads%2Fw7vNdWre4ViL4czC3qLv%2FSAVE.png?alt=media&amp;token=96a25e18-5d77-4c97-82c6-d9d9d6362740" alt="" data-size="line"> to apply your configuration.

<figure><img src="https://2965503026-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDaPYJDB89ny0x7wcMedb%2Fuploads%2FbJDih3Dwv41QavjV1QDa%2FSpacer.png?alt=media&amp;token=6c34f805-9610-4de9-8f8a-a029f13dd1a1" alt=""><figcaption></figcaption></figure>

{% hint style="success" %}
👉 For information about making changes later, see [Managing the Square Integration](https://help.supplyd.co/supplyd-erp/settings/integrations/sales-channel-integrations/square/managing-the-square-integration.md).
{% endhint %}

<figure><img src="https://2965503026-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDaPYJDB89ny0x7wcMedb%2Fuploads%2FzRfJZ4oiCW81yz5OksdD%2FSpacer.png?alt=media&amp;token=33e11e06-eb50-4824-a0f6-6c2482eae6a3" alt=""><figcaption></figcaption></figure>

{% endstep %}
{% endstepper %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

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

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://help.supplyd.co/supplyd-erp/settings/integrations/sales-channel-integrations/square/configuring-the-square-integration.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.
