Synchronizing Square and Brew Ninja Items

Items can be synchronized between Brew Ninja and Square from the Brew Ninja Square Items page, which can be accessed by clicking Setup → Company Info followed by Square Items.

Duplicate Product Codes

Brew Ninja cannot synchronize items with Square if any of your Products have duplicate barcodes. If you have any duplicate product codes, they will be listed on the page and must be resolved before you may proceed.

How does Brew Ninja match Square Items?

The first time a Brew Ninja Product is synchronized with you Square catalogue the following criteria will be used:

  • Look for a Brew Ninja Bar Code that matches the SKU field in Square.
  • Match based on the Brew Ninja Product name, and the Square Item's Name (including Variation name).

After a Product has been synchronized it will be linked to the Square catalogue item, and the names and SKU values are allowed to vary.


Square catalogue items that do not have a match in Brew Ninja will be removed from Square. This is because Brew Ninja can not import sales which contain catalogue items that do not have a corresponding Brew Ninja Product. If the synchronization preview shows items that you think should not be removed from Square, make sure you have an active Brew Ninja product with the same name or Barcode. Then reload the preview.


What Synchronization Changes


When Brew Ninja Products and Square Catalogue items are synchronized the following occurs:

In Square:

  • If the Square Item has a blank SKU, the Bar Code from Brew Ninja will be applied.
  • The price from Brew Ninja will be applied to the Square Item.

In Brew Ninja:

  •  If the Product does not have a barcode, the SKU value from the Square Item will be applied.
  • If the POS Display Name is empty on the Brew Ninja Product, the name used in Square will be applied.
  • If the POS Secondary Category is empty on the Brew Ninja Product and there is a Brew Ninja POS Secondary Category with the same name as the Category used in Square, the Primary and Secondary category will be applied.
  • If the POS Secondary Category is empty on the Brew Ninja Product and is not set on the Square item, then the sync process will look for a Brew Ninja Secondary category with a name starting with the word 'Square' or 'Default', and apply that secondary-category (and matching primary category) to the Brew Ninja Product.


Reference Images
Square Item Editing

Brew Ninja Product Editing

Container Deposits in Square

Square does not support bottle or rental deposits on items or item variations. Brew Ninja will compensate for this by adjusting the price of the item variation such that the after-tax price of items sold in Square equals the after-tax price that Brew Ninja expects.