Square - 2 Way Interface
Our Square Interface supports a 2-Way integration in which Yellow Dog Inventory can both pulls sales data from Square as well as push in new or changed items.
This interface contains one element: A Yellow Dog sync application which pulls sales (orders) from Square and pushes in new/changed items via the Square API.
This interface can be scheduled to process sales and push items at a time and frequency of your choosing, although by default, it will be run at the top of every hour during business hours.
This interface requires Yellow Dog version 354 or higher.
The Yellow Dog Sync program will need internet access to exchange information with the API.
Our sync requires a Personal Access Token to connect to the Square API. A Personal Access Token is generated by creating a new application here: https://connect.squareup.com/apps/.
Yellow Dog Requirements
A list of Square Location names to match to our Store Revenue Center Codes.
Please let us know before implementation begins if your site already has items in Square. If you wish to continue using those pre-existing items, the item data will need to be extracted from Square and provided to Yellow Dog using our standard Excel template.
Exporting Item Data
Yellow Dog’s pushes the following item details to Square:
|Square Field||Yellow Dog Field|
|Tax Group||Interface Setting|
|Visibility (Private/Public)||Interface Setting|
|Available Online (True/False)||Interface Setting|
|Available for Pickup (True/False)||Interface Setting|
|Abbreviation||POS Description 1|
|Description||Web Extended Description|
|Variation Name||Item Description (Dimension)|
|Location||Revenue Center Code|
Importing Sales Data
We pull in the following sales data:
- Device ID and Name, if provided.
- Discount Descriptions
- Item Retail
- Item Discount
- Transaction Number
- Check Closed DateTime
Importing Code Data
Our sync pulls Square Category and Tax Groups (currently limited to 3) to populate our interface drop-down selector.
This sync can be run from any location with internet access.
- New items can only be pushed to one location in Square.
- We currently do not push Categories or Modifiers to Square.
- Square only allows up to 5 characters for their Abbreviation (POS Description 1 in Yellow Dog).
- Items are limited to 1 picture per main/parent item in Square.
- Square does not support itemized returns in their API.