Articles in this section

Manage Square locations

Saikumar Rachamalla
Updated

The Square – NetSuite integration app syncs data only for the Square locations you select in the General settings. When you add a new location in Square, you must refresh the location list in the app, select the new location, and configure a location mapping in the order flow. This article covers how to do that, and how to structure multiple accounts and tiles for businesses with many locations.

Note: The integration app shows only locations with an active status in your Square account.

Add a new Square location to the integration

When a new location is added in Square, it does not appear in the integration app automatically. You must refresh the list manually.

  1. In the Square – NetSuite integration app, go to Settings > General.
  2. In the Select active Square locations list, select Refresh.
  3. Select the new location or locations you want to add.
  4. Select Done.
  5. Select Save.

Configure location mapping in the order flow

After adding a location, configure a mapping between the Square location and the corresponding NetSuite location. This ensures inventory and order data is assigned to the correct location in NetSuite.

  1. In the integration app, go to Flows > Order.
  2. Next to the Square Order to NetSuite Cash Sale flow, select Edit Mappings.
  3. Find the location_id to Location InternalId mapping entry and select Settings.
  4. In the Export field value column, enter the Square location name.
  5. In the Import field value column, select the corresponding NetSuite location.
  6. Repeat for each new location.
  7. Select Save.

Note: Select Refresh on the Import field value dropdown if new NetSuite locations do not appear in the list.

For more information on field mappings, see Map source data fields to destination.

Manage multiple accounts and locations

A single integration app tile supports up to 10 Square accounts (stores), with up to 10 locations per account. If your business requires more than 10 locations from a single Square account, you need additional tiles.

Limits per tile:

  • Maximum 10 Square accounts per tile
  • Maximum 10 locations per Square account per tile

Example configurations:

Scenario 1: You have 20 locations in one Square account and 4 locations in another.

You need 2 tiles: Tile 1 covers Account 1 (10 locations) and Account 2 (4 locations). Tile 2 covers Account 1 (remaining 10 locations).

Scenario 2: You have 32 locations in a single Square account.

You need 4 tiles, each covering 10 locations from Account 1 (with Tile 4 covering the remaining 2 locations).

Scenario 3: You have 21 locations spread across 4 accounts (3, 7, 2, and 9 locations per account).

You need 1 tile: Account 1 (3), Account 2 (7), Account 3 (2), Account 4 (9) = 21 locations total.

To add a new tile, install a new instance of the Square – NetSuite integration app. See Install the Square – NetSuite integration app.