Square Integration

Sync inventory, pull sales information, sync products to and from Square. Square can also be used just to process payments without managing inventory.


Table of Contents

  1. Square Integration Setup
  2. Catalogue
  3. Orders and Sales
  4. Operation Logs

Square Integration Setup

[back to top]

First, you must connect DEAR to your Square store.

It is possible to link several Square stores to a single DEAR account. Each linked store has an independent catalogue, logs and settings.

To connect Square to DEAR:  

  1. Navigate to Integration -> Square.

  2. Click + to connect a new store. 
  3. Click Connect to Square to be directed to the Square website and log in. 
  4. You will be asked to connect your Square account to DEAR Inventory and allow access.

  5.  Once permissions have been allowed, you will be redirected back to DEAR. 
  6.  Repeat these steps to connect as many Square accounts as you require.

Integration settings

[back to top]

Square can be used in two ways – to Load Sales and Process Payments or Process Payments alone. If Process Payments alone is selected, many of the following settings are not present (see below):

If the Square integration is set to Load Sales and Process Payments, many more integration settings can be customised in the Setup tab. 


Order Capture

This option specifies when a Square Order will be captured: when it is created or when it is paid in Square. This setting is also taken into account when downloads of historical orders from Square are triggered.

Consolidate Orders

DEAR - Square Integration allows two options for order consolidation:

  • No Consolidation

  • Daily Consolidation.

NOTE: Returns and Refunds for walk-in sales are not supported in Daily Consolidation mode.

No Consolidation indicates that sales will be captured from Square as they occur. Daily Consolidation will consolidate all orders from that day into a single order. When Daily Consolidation is chosen, an additional setting becomes available: Consolidation Time. This is your local time when all pending orders aggregated during the day will be processed. 

See Pending Orders Processing section below for more details.


For the pending order processing to be successful, an existing customer must be selected.

When Consolidation Type is Daily Consolidation, this customer is used to create a new sale task which will combine all daily sales. A customer can be created in DEAR just for this purpose.

Sale Price Tier

Choose which Price Tier to use as the default price when DEAR syncs products with Square. See Managing Price Tiers for more information. 

Pick, Pack and Ship Processing Mode

When pending orders are processed by DEAR, new sale tasks are created. This setting tells DEAR if it should try to Auto Pick, Auto Pack and Auto Ship these tasks. If there is not enough stock on hand to pick the full quantity of products in an order, then Pick will remain in Draft state, and Pack and Ship won’t be completed.

DEAR does not pick up shipment information from Square if auto-ship is selected and will not create fulfilment in Square in this scenario (if Auto Ship is enabled).


Square does not allow use of multiple warehouses. Each Square store can have a dedicated Location within DEAR which can be selected from the drop down menu. Selecting a particular warehouse will limit the availability of stock in Square to that location. The default option, All Locations, will display consolidated stock quantities across all of your locations.

Invoice Status

You can control the Invoice Status for Sale tasks created as a result of pending order processing. By default, the Invoice will not be authorised and will be in Draft state, adjustable and waiting for authorisation. However, if this setting is changed to AUTHORISED, the Invoice will be automatically authorised, and pending sync will be created for it to sync with an accounting application of your choice.

Gift Card Liability Account

DEAR will use this Liability account instead of a Revenue account for Gift Card sales. This account should have the ability to accept payments. If a sale is made which contains a gift card, this sale will remain in the Pending Orders area until a Gift Card Liability Account is specified.

Optional revenue account

The revenue account to be used for all sales downloaded from Square. This will override settings at the Product/Customer level and any other Account mapping. 

Sales Representative Name

This option allows the shop name to be used as a Sales Representative. 

Update Stock Levels in Square

You may choose to disable an automatic stock level update in Square performed by DEAR at the time the available product quantity changes in DEAR. This may be useful if you are managing the stock level in Square manually and do not want DEAR to change it. Please ensure you have the correct stock quantities entered in DEAR before you turn on this option as these values will override the stock quantities in Square. 

Sync product categories with Square

You can enable DEAR to push category and brand information to Square and update DEAR with Square category information. 

Use Square as Master source for DEAR products

If this option is enabled, products that have been changed or updated in Square will cause the linked products in DEAR to be changed to match upon catalogue download. 

Export Shipping information to Square

If this option is selected, DEAR will export shipping information to Square. Further details can be found in the Fulfilment section below.       

Tax Rule Mapping

When a pending order is processed by DEAR, a sale task is created. Each order and invoice line is assigned a tax rule. The tax rules specified in these settings will be used to create these lines. 

DEAR does not apply the tax rule to recalculate tax and is simply using the actual tax amount from the Square order. This means that if certain products are not Taxable or with varying tax in Square, all data and totals in DEAR will look identical to Square, but with DEAR tax rule name selected in this setting.

In case of tax recalculation, Tax amount will be overwritten with a value calculated by DEAR Taxation rule.

IMPORTANT:  Orders will be skipped on download if Taxation mapping is not finished! 

Payment Account Mapping

DEAR can capture payments made against orders in Square and is able to automatically add payments to a created sale invoice. To do this, Payment Account Mapping must be completed on this integration settings screen. You must choose an account which is able to receive payments from the chart of accounts. 

This setting is not mandatory – if payment mapping is not completed, orders are still captured and downloaded from Square, but payments must be manually added to invoices in DEAR. Some customers prefer to keep invoices open and then reconcile them with payouts from Square. 

Disconnect from Square store

When you disconnect from Square store, DEAR removes all associations between DEAR objects and Square, including Log and Product Catalogue.


[back to top]

The DEAR Square Catalogue page allows the user to download products from Square, upload products to Square, break the link between a DEAR product and its Square listing and update quantities in Square according to DEAR available stock.

Downloading Products

[back to top]

Products can be loaded from Square to DEAR in the Catalogue tab by clicking Load Products. This operation may take some time. 

There are two types of products in Square: simple product and product with options (these have child SKUs). 

DEAR will not create a Product Family when loading Square products as Square products lack information regarding option names/values. 

If products are already created/linked with Square, then DEAR updates existing products instead of creating new versions. In Square, SKU is an optional product field whereas in DEAR it is mandatory. DEAR requires all SKUs to be specified for all Square products and variations. All products with missing SKUs will be skipped (not loaded) from Square.

When a product is created or updated in DEAR during download process, a link is established between the product and variant unique Square ID and DEAR unique product ID. This link is used when products are matched against sale order lines in Square and when subsequent product downloads occur.

When downloading products, DEAR tries to match existing products first to avoid creating duplicates.

During product download DEAR automatically creates required product categories.

Data mapping for products between DEAR and Square is as follows:


Variant SKU

Family NameProduct Name
Product NameProduct Name + Variation Name (unless Variation Name already contains Product Name)
DescriptionProduct Description
Price Tier. Default is Price Tier 1.Price
Image (first default image). Existing images won't be deleted.Image (existing image won't be overwritten).

Track Inventory (DEAR will enable it for new products created by DEAR; it won’t change the setting for existing products).

Manage the Catalogue 

[back to top]

There are two possible statuses for products in the Catalogue: Not Listed and Listed

NOTE: Updating products from the catalogue will update the stock level in Square regardless of the related Quantity update setting status.

List a product on Square:

  1. Click on the product in the Catalogue tab. 
  2. You can enable or disable stock level syncing at the individual product level.
  3. Click List on Square.
  4. Save your changes.

Unlist a product on Square:

  1. Click on the product in the Catalogue tab. 
  2. Click Unlink.
  3. Save your changes.

Remove a product from Square:

  1. Click on the product in the Catalogue tab. 
  2. Click Remove from Square.
  3. Save your changes.

Bulk Listing

[back to top]

As well as listing products individually, products can be listed in bulk to save time. 

List products on Square in bulk:

  1. Go to the Bulk Listing tab.
  2. Select products to upload in bulk. You can select products by Category, Family, Product Tag, Price Tier, Listing Status and through manual search.
  3. Click Start to upload all selected products.

Orders and Sales

[back to top]

Processing Pending Orders

[back to top]

When a Square store is connected to DEAR, automatic notifications are triggered when orders are created or modified.

Depending on the Order Capture setting selected, DEAR will capture a Square Order and save it as a pending order when the Order is created or paid. 

Whenever a sale is captured from Square, it is first placed into Pending Orders, and stock is allocated immediately. DEAR imports new orders immediately as individual sale orders (if No Consolidation is selected in the Integration Settings) or once a day as a consolidated sale order (if Daily Consolidation is selected). 

If No Consolidation is selected, each Square sale is converted into an identical sale in DEAR, keeping the same customer and shipping information. If Daily Consolidation is selected, the single daily sale task will use the customer selected in the integration settings, and customer, billing and shipping information imported from Square will be ignored. 

When processing orders, the logic is identical to that of the DEAR UI. DropShipping, Kitting and other important scenarios are implemented in the same way as through the DEAR UI.

Pending Orders can be processed manually by clicking Process. They can then be viewed in the Log tab.

Downloading Orders and Payments

[back to top]

Orders are automatically downloaded if their status in Square is changed (for example, a customer pays for an order). 

NOTE:  Generally, you do not need to trigger manual order download. However, if an order was not captured by DEAR or to load historical sales you can use the manual Load Order option.

Any imported order is saved to the Pending Orders section. It is a temporary storage of all sales and payments in DEAR. If an order already has an entry in the Log (i.e. was imported previously), it will be skipped. This guarantees that no duplicate sales will be created by DEAR.

While saving orders, DEAR captures customer information, billing and shipping addresses. All line items are captured together with quantities, prices and totals. Total order discounts are applied as are additional charges to the whole order, without distribution by lines to reduce the chance of discrepancy.

Tips and gift card sales are also saved as additional charges in the Sale invoice. Square has special Tax Rules for these additional charges, and you can also link these with DEAR Tax Rules in the Setup tab.

If a Payment Account has been specified in the Integration Settings, DEAR will always assign associated payments to the captured Square orders.

When a Square order is cancelled, DEAR automatically finds and voids the corresponding sale task if already created as a Sale Order or just removes the associated pending order if not yet processed.

The final step in the order download is to trigger an update of stock levels in other Square stores and other connected eCommerce channels.

Updating Fulfilment in Square

[back to top]

When Shipment is authorised in DEAR and the carrier specified, DEAR will try to create order shipment information in Square. This will only work in the No Consolidation processing mode.


[back to top]

Each captured Square order once saved to Pending Orders creates a Log entry to track the link between the Sale in DEAR and in Square. This eliminates the possibility of creating duplicated orders when capturing the same order several times during manual order load. 

Each Log entry has a link to the sale task in DEAR. Depending on the settings selected by the user in the Setup tab, this sales task could be draft or authorised, one or more of the Pick, Pack and Ship tabs could be authorised, and payment could have been applied to the invoice. 

Log entries allow you to see which Sale task reflects a particular Square sale. You also have the option to delete a Log entry manually. This will allow to reprocess an order if required. Deleting a log entry will not void or delete its associated sale task.

Reloading Orders from Square

[back to top]

If for any reason you need to reload an order from Square, this can be managed from DEAR.

To reload an order from Square:

  1. Void the sale task. A record of this will be kept in DEAR for reconciliation purposes, but the transactional data will be deleted. 
  2. Return to the Square integration Log tab and delete the Log entry. This will allow the order to be recaptured from Square.
  3. Navigate to the Pending Orders tab and click Load Orders, making sure the date is set to before the order to reload was made. 

Operation Logs

[back to top]

Each time when user or DEAR download sales, an appropriate record is added to the operation log. It also contains information about results of downloading, including the count of processed, skipped or cancelled orders.

Did you find it helpful? Yes No

Send feedback
Sorry we couldn't be helpful. Help us improve this article with your feedback.