Comment on page
Prepare protection products
To be able to offer product protection plans to your customers, you'll need to use the Offer contents to construct protection products for your ERP system and then map them to your products.
You'll need a protection product for each plan option you want to offer to your customers, but you don't have to create one for every plan option with an Offer if you don't want to. This means that if you only want to offer your customers a 1-year warranty extension for a particular product, you'll only need to create the corresponding 1-year extension protection product — even if the Offer also includes plan options for 2- and 3-year warranty extensions.
You're free to decide exactly how you want to structure the protection products you create, but there are a few things you'll need to include in each protection product that you add to your ERP system.
You'll need to include the following Offer information in all of your protection products:
Offer ID - the ID of the Offer provided in the Offer
plan ID - the ID of the plan provided in the Offer
plan price - the price of the plan (in cents) provided in the Offer
insurance details URL - the link to the insurance details provided within the marketing content of an Offer that you are legally required to display alongside the protection product in your store
Depending on the applicable sales channel, you may also need to include channel-specific information. Just check the integration section for more details. Also, if you'll be selling product protection in multiple countries, you'll probably want to include the insurance coverage area (country) so you can show the right Offers in the right locations.
The rest is up to you! Just remember that what you include in your protection products, will have an impact on what you can display on your frontend.
Do not hardcode the insurance details URL or the plan price, as they are subject to regular updates for legal and administrative purposes.
To ensure that your protection products are linked to the product(s) they were created for, you'll need to introduce some kind of mapping logic to your protection products. For example, you could map your protection products based on your internal product IDs (if you're using Offers for individual products) or based on your internal product categories and product prices (if you're using Offer for product collections).
The best method for doing this really depends on your particular setup, so feel free to come up with an approach that works for you.
If we were to create a protection product for the plan option in the Offer, it could look something like this:
{
"id": "prd-hakuna-care-iphone14",
"country": "de",
"categories": ["hakuna_protection"],
"name": "1 year of all-round protection",
"brand": "hakuna",
"variants": [
{
"sku": "AP-IPH-14GELB-AN-C12",
"price": 8464,
"currency": "eur",
"hakuna_plan_id": "pl-90e8f25b-6d83-4d2e-89da-71d8385cdf72",
"hakuna_offer_id": "off-eaf57888-8a68-4f23-8e68-137fc6dd48f4",
"protected_product_id": "prd-iphone14"
}
],
"details": {
"insurance_details_url": "https://hellohakuna.com/plan-details"
/* Other marketing content from offer */ }
}
In this example, we created an Offer for all products in the Hakuna category
101
that cost between 1000 € and 2000 €.If we were to create a protection product for the plan option in the Offer, it could look something like this:
{
"id": "prd-hakuna-care-phones",
"country": "de",
"categories": ["hakuna_protection"],
"name": "1 year of all-round protection",
"brand": "hakuna",
"variants": [
{
"sku": "AN-C12",
"price": 11246,
"currency": "eur",
"hakuna_plan_id": "pl-caf5e239-1607-4c5d-8b80-363c84dd1226",
"hakuna_offer_id": "off-a5a048d0-b0ba-4dc8-9e05-d70625ebc4f6",
"protected_product_category": "phones",
"price_min": 100000,
"price_max": 200000
}
],
"details": {
"insurance_details_url": "https://hakuna-document.s3.eu-central-1.amazonaws.com/hakuna-care-placeholder.pdf"
/* Other marketing content from offer */ }
}
Last modified 2mo ago