API Workflow

On this page, you will find the required workflow steps to successfully utilize our API. There are different scenarios depending on whether you work with an article list (artikellijst) or without an article list.

Scenario 1. With Article List

If an article list is available in both the supplying party's system and the Harmony system, a policy can be concluded with two web service calls.

It begins in the local system with entering the article number and the corresponding price. Based on these two details, a call can be made to the SearchTemplates method. This returns the possible insurance templates for the relevant article.

After selecting one of the templates, a call can be made to the CreateContract method along with the NAW and article details. This method will register the application and return a policy number.

Scenario 2. Without Article List

Without an article list, a few more calls are needed because it must be determined what kind of device it is. The extra steps are required to select the article category and manufacturer.

One starts with a call to the SearchItemCategories method, which will return a list of article categories. Then, based on the article category, a call can be made to the SearchManufacturer method. This will return a list of manufacturers.

Based on the article category, manufacturer, and corresponding price, a call can be made to the SearchTemplates method, returning the possible insurance templates for the relevant article.

After selecting a template, a call to CreateContract is made with NAW/article details to register the application and return a policy number.