You are here:
Manage Product Warranties in Point of Sale
Dynamic warranty management uses an SPI so the POS can send cart data to your warranty engine, receive eligible warranty SKUs, and replace prior warranty lines with the SPI result. Learn how the POS system identifies warranty products, the required CMS setup, and the associate flow during checkout.
POS Prerequisites:
- Modern POS App Build: 12.0.1 or later
- Platform Support: iPhone & iPad
- Offline Support: No
- Files: Product Feed configured with add-on products and warranty SKU products
The WarrantySKU rule on the product class identifies an item as a warranty item, not by a fixed class name. Before the SPI runs, the POS removes warranty items from the payload to send only merchandise in the request. Warranty products are considered add-on products in the cart, see Configure Add-On Products in the POS App.
To customize the SPI for warranty checks, and for reference on the request and response payloads, see Point of Sale for Developers.
Warranty SKUs in the Product Feed
Warranty products must exist in the product catalog before the SPI can return them. The warrantyProductId returned by the warranty SPI must match a productId in your catalog with a warrantySKU-enabled product class. Create one SKU per warranty category. See Product Feed.
| Field | value | notes |
|---|---|---|
| productId | Assigned by the merchant (for example WRN-FURN-5y). | This field must match the warrantyProductId in the SPI response. |
| name | Human-readable (for example, Furniture Protection Plan - 5 Year). | None |
| productClass | The product class name. | Enable the WarrantySKU setting. |
| price | 0 | This is a placeholder. The SPI overrides the actual price. |
| imageURL | Shield/warranty icon URL. | Used as the deep link CTA button in the cart and in the warranty confirmation window at checkout. |
Constraints
After you add warranty items to a cart, warranty items create these constraints:
- Warranty quantity is locked
- Warranty products can’t be discounted
- Warranty price can’t be overriden
- Warranties can’t be added manually
- Warranties can’t be removed without manager approval
- Configure Product Warranties in CMS
Configure Point of Sale CMS settings so you can offer product warranties. Set up a custom connector to call the warranty SPI at checkout and create a warranty product class so the POS system can identify warranty products. Then configure approvals, deep links, and warranty checks for the associate checkout experience. - Perform Warranty Checks at the Point of Sale
Associates can run the warranty check during checkout so the POS calls the Warranty SPI. This check reviews eligible warranties and prompts associates to confirm them before adding them to the cart.
