Links

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.
Here's a quick recap of what you have available to you in an Offer:
Offer information When it was created, when it expires, which product or product collection it was created for, and an ID for future reference
Plans
1-3 product protection plan options (each containing an ID, a SKU, a title, a price and a term length) that you can use to build protection products for your ERP system
Marketing content
Additional content that you can add to each constructed protection product, e.g., as a description
You'll only need to construct protection products for the plan options you actually want to offer to your customers. This means that if you only want to offer your customers a 1-year warranty extension for a certain product in your store, 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.

Requirements

You're free to decide exactly how you want to structure the protection products, but there are a few things you'll need to include in each protection product that you add to your ERP system.

Offer contents

You'll need to include the following Offer information in 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
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.

Mapping

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.

Examples

Using Offers for individual products

In this example, we created an Offer for an iPhone 14.
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 */ }
}

Using Offers for product collections

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 */ }
}