Bedrijfsinformatie

Let op: Om bedrijfsinformatie te gebruiken in de berekening is Product V2 nodig, de opvolger van voordeelpakketberekening v1.

Bedrijfsinformatie ophalen

Met de company information API is het mogelijk om bedrijfsinformatie op te halen. Met behulp van de bedrijfsinformatie kan de bedrijfsactiviteit worden meegegeven aan de berekening. Om de bedrijfsactiviteiten op te vragen is een KvK nummer nodig. Deze kan worden opgezocht via de company-information API.

1. Zoeken

De zoek methode kan gebruikt worden om meer informatie te vinden van een bedrijf. Alle velden zijn optioneel. Wanneer de PostalCode of PoBoxNumber is ingevuld, is ook het HouseNumber verplicht. Deze methode kan onder meer gebruikt worden om een KvK nummer te vinden voor een bedrijfsnaam.

/search

2. Basisprofiel

De basisprofiel methode kan gebruikt worden om de bedrijfsinformatie op te halen op basis van een KvK nummer, waaronder de SBI activiteiten. De SBI code die in de SBI activiteit staat kan gebruikt worden in de berekening.

/basic-profile/{companyNumber}

3. Subactiviteiten

In de response van de basisprofiel methode zitten de SBI activiteiten. Het kan zijn dat er een SBI activiteit tussen zit met de property hasSubActivities: true. Dit betekent dat er naast de hoofdactiviteit ook nog subactiviteiten zijn. Om deze subactiviteiten op te halen is er een apart endpoint. Dit request heeft de SBI code nodig van de hoofdactiviteit en geeft de lijst van subactiviteiten terug die onder deze hoofdactiviteit vallen (zonder de hoofdactiviteit).

Om een complete lijst van alle activiteiten voor een bedrijf te krijgen roep je 1 keer de basisprofiel call aan, en voor iedere SBI activiteit met hasSubActivities: true roep je de subactiviteiten call aan.

/sbimap/subactivities

4. Een berekening aanmaken met SBI activiteit

Via de basisprofiel methode kan je een SBI code opvragen, deze kan je vervolgens in het product:Profiel van de berekening toevoegen. De zakelijke producten, zie onder andere product:PersonenautoProfiel, hebben een SbiCode property die gevuld kan worden met de codeFormattedSivi property uit het basisprofiel of de sbiCodeFormattedSivi uit het subactiviteiten request.

/berekeningen