Harmony IntegrationHarmony Integration

Maak Contract

POST /api/insurance/CreateContract

📋 Maak direct een verzekeringscontract aan zonder eerst een lead te maken. Deze methode registreert de aanvraag en retourneert een contractnummer (ContractNo).

🔧 Geef ofwel itemNo op in de apparaatsectie, of geef manufacturer, model en itemCategoryCode op.

🏢 Als u een verzekering voor een bedrijf aanschaft, kunt u companyName en chambresOfCommerceNumber opgeven in het klantobject.

Optionele velden voor logboekregistratie: met employeeNo, externalReference en shopNo op het hoogste niveau kunt u bijhouden welke werknemer of winkel de transactie heeft voltooid.

POST
/api/insurance/CreateContract

Authorization

BearerAuth
AuthorizationBearer <token>

In: header

Request Body

application/json

customer*object
Customer personal and contact details.
insurance*object
Insurance policy details.
device*object
Insured device details.
employeeNo?string
Employee number (optional).
shopNo?string
Shop or store number (optional).
externalReference?string
External reference identifier from your own system (optional).

Response Body

application/json

application/json

curl -X POST "https://jubilee-ws.test.harmony.nl/api/insurance/CreateContract" \  -H "Content-Type: application/json" \  -d '{    "customer": {      "companyName": "",      "chambresOfCommerceNumber": "",      "gender": "Unknown",      "initials": "J.D.",      "firstname": "John",      "middleName": "",      "lastName": "Doe",      "dateOfBirth": "1980-08-13",      "addressLine1": "Main Street",      "addressLine2": "123",      "addressLine3": "",      "zipCode": "1234AB",      "city": "Amsterdam",      "countryCode": "NL",      "phoneNumber": "+31612345678",      "emailAddress": "[email protected]",      "ibanCode": "NL70ABNA00000000"    },    "insurance": {      "startDate": "2024-06-12",      "templateCode": "SJ0001",      "discountCode": null,      "acceptAutomaticPaymentCollection": true,      "acceptPolicyTerms": true,      "acceptPrivacyPolicy": true    },    "device": {      "itemNo": "PHONE-APPLE",      "itemCategoryCode": "PHONE",      "objectConditionCode": "REFURBISHED",      "manufacturer": "Apple",      "model": "iPhone X",      "serialNo": "SERIAL12351",      "imei": "000000000000000",      "ean": "",      "productType": "Mobile",      "retailPrice": "123.45",      "purchaseDate": "2024-01-01",      "includeTermsOfConditions": false    },    "employeeNo": "E0001",    "shopNo": "shop01",    "externalReference": "ref-x"  }'
{
  "contractNo": "C-123456789",
  "status": "created"
}
{}