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.
Offer information When it was created, when it expires, which product or product collection it was created for, and an ID for future reference
Plans1-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 contentAdditional 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.
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.
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.
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 */ }
}