Manual Sync ID: the iPaaS.com product identifier, entered on the iPaaS.com Manual Sync page.

External ID saved after sync: on the first successful transfer, iPaaS.com records the Square catalog item identifier and catalog version as the external ID for the product. That external ID routes later updates to the same Square item and supplies the catalog version Square needs to accept an update.

Status: Enabled, with a mapping filter on the parent Product collection that limits it to products tracked at the variant level that have one or more variants (see Mappings). The child collections carry no filter of their own; the parent filter governs whether the product and its variants transfer.

Trigger Events: the iPaaS.com product Create and Update outbound triggers, enabled by subscribers or their MiSP in the subscription's Outbound Data Flows configuration. Products can also be written on demand from the Manual Sync page.

Add/Update Square Product Option FROM iPaaS.com: creates the product's options (for example, Size or Color). Its child, Add/Update Square Product Option Value FROM iPaaS.com, creates the values for each option (for example, Small, Medium, Large).

Add/Update Square Product Variant FROM iPaaS.com: creates the product's variations. Its child, Add/Update Square Product Variant Option FROM iPaaS.com, records which option values each variation is for.

Money amounts are in the smallest unit of the currency (for example, cents); the iPaaS.com price is converted accordingly.

Currency must match your Square account. The variation price currency ships as USD; if your Square account is not in US dollars, the variation is rejected until the currency is changed (see the placeholder callout under Mappings).

Fixed catalog keywords are case-sensitive. The item, option, option-value, and variation types and the pricing type use exact Square keywords and must not be changed.

Variant name must match the Square format on update. Square builds a variant name by joining its option values with commas; the integration sends the name in that format so updates are accepted. A variant with no option values is sent with its SKU as the name.

Stock status comes from variant status. An Active variant is stockable; Disabled or Preorder is not.

Every variation must select all of the product's options, in order. If a product has both a Size and a Material option, each variation must specify a value for both, listed in the same order the options are defined on the product. A missing or reordered option causes Square to reject the product.

Option matching can be case-sensitive. The Match Different Case Product Options and Values subscription setting controls how option names and values are matched against Square. When it is off, matching is case-sensitive and a difference in letter casing can cause Square to report a duplicate option; when it is on, matching ignores letter casing, existing Square option names are reused, and existing color values are preserved when the incoming data does not include them.

Categories must already exist in Square. Category assignment matches iPaaS.com categories to existing Square categories by name and full parent chain; categories with no exact match are left off.

Rate limiting: if Square temporarily limits requests, the transfer is automatically rescheduled to resume after the limit resets. No subscriber action is required.

The Square item name is set from the product SKU. If you want a different name on the Square item, remap the name to the iPaaS.com product name field.

The parent product is written before its variations, options, and option values. Each variation links to the Square item recorded when the parent product transferred.

Product link could not be completed: when the integration finds (or creates) a Square item but cannot save the external-ID link, the transfer stops and records an error noting that duplicate product records may otherwise result.

Currency mismatch: if the USD currency does not match your Square account, Square rejects the variation; set the currency to your account's currency (see the placeholder callout under Mappings).

Incomplete or misordered variation options: Square rejects the product if a variation does not select a value for every product option, or lists them in a different order than the product defines. Confirm each variation specifies all options in the product's option order.

Duplicate options from case differences: with Match Different Case Product Options and Values off, an option or value that differs only in letter casing can be reported by Square as a duplicate. Turn the setting on to match regardless of case.

Write an iPaaS.com product that has two options (for example, Size and Color) and several variants; confirm the Square item is created with the options, option values, and variations, and that each variation carries the correct price, SKU, and stock status.

Confirm each variation is linked to the parent Square item and records the correct combination of option values, in the product's option order.

Confirm an Active variant is stockable and a Disabled or Preorder variant is not.

Change a variant's price in iPaaS.com, re-write the product, and confirm the existing Square variation is updated rather than duplicated.

Assign the product to an iPaaS.com category that also exists in Square (with the same parent chain) and confirm it is filed under the matching Square category.

With Match Different Case Product Options and Values on, write a product whose option casing differs from an existing Square option and confirm the existing option is reused rather than duplicated.

Deletion is out of scope. Removing a product, variant, option, or option value in iPaaS.com does not remove the corresponding record in Square on its own; the product is refreshed as a whole on its next transfer.

Square Installation Instructions

Square Connections and Settings

Square API Endpoints

Square Error Messages

Square Integration Known Limitations

Square Mapping Collections