Integration Specific Product Mapping

Link a TapMango product to an individual product or a category in your point of sale.

You can also create category folders to organize products in Portal. Folders are optional, and they help when you have a large product list.

Map a product by search

A Merchant Admin maps a product from Loyalty → Smart Products. What are Smart Products? covers that page.

Several point-of-sale items can map to one Smart Product.

Search is available for Clover, Square, Toast, Shopify, Lightspeed (R-Series), Lightspeed (X-Series), Lightspeed E-Commerce, BigCommerce, Qu, Loyalty API, and Mobile Ordering.

Generic POS is entered by hand. If mapping is unavailable, the page says “Product mappings are not available for this merchant.” Use Manual tracking, or finish the point-of-sale setup first.

How to manually add mapping

Use this when you enter the mapping yourself. On the integration, paste the value into External product IDs. Separate more than one ID with a comma, semicolon, or a new line, then select Add IDs.

Each point of sale uses a different value.

• Lightspeed (R-Series)
• Clover
• Shopify
• Square
• Mindbody
• Lightspeed (X-Series)
• Toast

Lightspeed (R-Series)

Single product matching. Custom SKU — Each Lightspeed item has a custom SKU that can be edited. The custom SKU on the Lightspeed product must match the External Product ID on the TapMango product exactly.

Category matching. Category Name — The External Product ID on the TapMango product must match the exact category name in Lightspeed, including parent category names.

Clover

Single product matching. Product ID — Sign in to the Clover portal and search for the item in your inventory. Immediately below the item name is the product ID, in the form product ID: AB1CD2EF3GH5IJ6KL7. Copy and paste that ID into External Product ID on the TapMango product.

Category matching. Category ID — Sign in to the Clover portal and search for the category. Immediately below the category name is the category ID, in the form category ID: AB1CD2EF3GH5IJ6KL7. Copy and paste that ID into External Product ID on the TapMango product.

Shopify

Single product matching. Product ID — Every Shopify inventory item has an ID that Shopify creates. On the Shopify website, edit the product and check the URL for `.../admin/products/???`. Enter that number in External Product ID on the TapMango product.

Category matching. Product Type Name — External Product ID on the TapMango product must match the Shopify product type name exactly.

Collection ID — External Product ID on the TapMango product must match the collection ID in the Shopify collection URL exactly.

Square

Single product matching. SKU — Log in to Square, edit the item, copy the SKU, and paste it into External Product ID on the TapMango product.

Category matching. Category Name — The TapMango product name must match the Square category name exactly. Leave External Product ID empty.

Mindbody

Single product matching. Product Name — External Product ID on the TapMango product must match the exact product name in Mindbody.

Mindbody is not included in catalog search, and it does not support category matching.

Lightspeed (X-Series)

Single product matching. Product ID — Every Lightspeed (X-Series) inventory item has an ID that Lightspeed creates. On the Lightspeed (X-Series) website, edit the product and check the URL for `...id=???`. Enter that number in External Product ID on the TapMango product.

Category matching. Category Name — Lightspeed (X-Series) supports category-name mapping. The External Product ID on the TapMango product must match the Lightspeed (X-Series) category name exactly.

Toast

Single product matching. GUID — Log in to ToastTab, go to Menus, then Edit Menus, and open the product details. The GUID is listed under Basic. Copy and paste the GUID into External Product ID on the TapMango product mapping.

Category matching. Category Name — In ToastTab, a category is a Group under the menu. Open the group you want to map. Under Basic, copy the GUID and paste it into External Product ID on the TapMango product mapping.