Harmony IntegrationHarmony Integration

Sjablonen

POST /api/insurance/SearchTemplates

🔍 Zoek beschikbare verzekeringssjablonen voor een apparaat op basis van de specificaties en verkoopprijs.

  • 📦 Geef alleen itemNo op, of geef zowel manufacturerCode als itemCategoryCode op
  • 💰 retailPrice is altijd vereist (minimumwaarde: 1)

About itemCategoryCode

The dropdown above shows a placeholder list that may not be complete. Categories available for your account can differ — sign in to load them automatically, or call SearchItemCategory to fetch the real list for your account.

POST
/api/insurance/SearchTemplates

Authorization

BearerAuth
AuthorizationBearer <token>

In: header

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

itemNo?string
Item number from the product catalog. Required if manufacturerCode and itemCategoryCode are not provided.
manufacturerCode?string
Manufacturer code. Required if itemNo is empty.
model?string
Device model name (optional).
itemCategoryCode?stringPHONETABLETNOTEBOOKVISUALWEARABLESOTHERDESKTOPNote: this is a placeholder list and may not be complete. The categories available for your account can differ — sign in to load them automatically, or call SearchItemCategory to fetch the complete list.
Device category code. Required if itemNo is empty.
retailPrice*number
Retail price of the device in euros. Minimum value: 1.
includeTermsOfConditions?boolean
Set to true to include the terms of conditions document (base64-encoded PDF) in the response.

Response Body

application/json

application/json

curl -X POST "https://jubilee-ws.test.harmony.nl/api/insurance/SearchTemplates" \  -H "Content-Type: application/json" \  -d '{    "itemCategoryCode": "PHONE",    "manufacturerCode": "APPLE",    "itemNo": "PHONE-APPLE",    "model": "iPhone 17 Pro",    "retailPrice": 2000,    "includeTermsOfConditions": true  }'
{
  "templates": [
    {
      "code": "string",
      "description": "string",
      "itemNo": "string",
      "defaultServicePeriod": "string",
      "invoicePeriod": 0,
      "invoicePeriodLength": 0,
      "invoicePeriodAmount": 0,
      "prepaymentAmount": 0,
      "policyCost": 0,
      "excessFeeDamage": 0,
      "excessFeeTheft": 0,
      "prepaymentPeriod": "string",
      "includeTermsOfConditions": true,
      "termsOfConditions": "string",
      "commission": 0,
      "requirePrepayment": true,
      "insuredComponents": {
        "theft": true,
        "abuseCallCosts": true,
        "loanDevice": true,
        "dataRecovery": true,
        "displayDamage": true,
        "waterDamage": true,
        "dropDamage": true,
        "technicalMalfunction": true
      }
    }
  ]
}
{}