Document Properties
Last Modified23-Jun-2020
Added to KB18-Jun-2012
Public AccessEveryone
Doc TypeGuidelines, Concepts & Cookbooks
  • ICM 7.7
  • ICM 7.8
  • ICM 7.9
  • ICM 7.10

Concept - Warranties

1 Introduction

This document introduces the concept of warranties as it exists in Intershop 7:

  • A warranty itself is a product.
  • A product becomes a warranty when it is assigned to the Service Types Classification Catalog category "ES_Warranty_Dependent".
  • A warranty can be assigned to one or more products.
  • A warranty is purchased in combination with a product. This is why we say we have a dependent warranty - it depends on the product it is sold with.

The next figure shows the warranty classification together with a few similar classifications.

Overview - Assignment of Products to Warranties

1.1 System Classification Catalog - Warranties

For a product to become a warranty, it has to be assigned to the "ES_Warranty_Dependent" classification category. 

A warranty can only be bought together with another product.

1.2 Assign Warranties

A warranty can be assigned to products using product links. To this end, there is a 'Warranty' link type.

1.2.1 Warranty Product Assignment

A warranty can only be assigned to a product, which is not a warranty itself.

2 Warranty Prices

Intershop supports different calculation models for warranty prices. Currently, three calculation models are available:

  • Fixed Price: The warranty has a fixed price, like $100.
  • Percentage Price: The warranty price is a percentage value of the assigned product's price.
  • Range Price: The warranty price scales depending on the price of the assigned product.

It is possible to extend the warranty pricing with new calculation models.

2.1 Configuring Price Models

Price providers are used for the warranty price calculation. There is a different provider for each of the supported calculation models. The shop manager selects from the available calculation models for a warranty when adding a price to a warranty.


Each price provider is responsible for

  • Calculation of warranty price(s)
  • Providing template, pipeline and webform to configure warranty price(s)
  • Resolving and storing price configuration data


Starting with Intershop 7.4 we strongly recommend to use the WarrantyBOPricingExtension for price handling. For example: warrantyBO.getExtension("Pricing").getPrice(String priceType, Currency currency).

3 Warranty Detail Information

Warranty detail information consists of specific information that needs to be shown in the web store. In addition to the regular product information, the following data can also be specified as classification attributes for a warranty when it is assigned to the "ES_Warranty_Dependent" classification category:

  • Time period
  • Warranty code
  • Warranty type

4 Basket Handling

If a product is added to the basket together with a warranty, the product becomes a root product line item (PLI). For the dependent warranty, there are added a dependent service line item (SLI) with no cost and a dependent PLI for the warranty product. The dependent SLIs and PLIs are automatically removed from the basket when the root PLI is removed.

Warranty Line Item Structure

4.1 Adding Dependent Warranty to the Basket

If a user adds a product together with a warranty to the basket, both the product itself and the selected dependent warranty are added.
If a user adds another product of the same type with a dependent warranty to the basket, the additional root PLI with the dependent SLI/PLI will always be created and appear as a separate line item. No quantities are merged.

4.2 Changing Dependent Warranties in the Basket

If a user changes the dependent warranty in the basket, the current dependent warranty PLI is removed and a new dependent warranty PLI of the selected type is added. The exchange is done for the total quantity. There is no item splitting.

4.3 Prices for Warranties

The price calculation is different for warranty PLIs, in case the price depends on the product for which the warranty is applicable. In this case, the product's price has to be calculated first and then the warranty price is calculated in relation to the product price.

4.4 Shipping Restrictions for Warranties

It is possible to forbid the purchase of a warranty depending on the shipping address using a shipping rule. If a warranty is not eligible, the user will be notified and can remove the warranty from the basket to continue the checkout or go back to the basket and try to order the same product with a different warranty.

4.5 Shipping Costs on Dependent Warranties

Warranties do not have shipping costs. You may add a surcharge using a shipping rule if necessary.

4.6 Warranty Tax Calculation

Dependent warranties use the tax class of the parent PLI for calculation.


The information provided in the Knowledge Base may not be applicable to all systems and situations. Intershop Communications will not be liable to any party for any direct or indirect damages resulting from the use of the Customer Support section of the Intershop Corporate Web site, including, without limitation, any lost profits, business interruption, loss of programs or other data on your information handling system.

Customer Support
Knowledge Base
Product Resources