Ontsluiten SBI-indeling 2025 voor instanties (4.1.3.7)

Breaking change

In de nieuwe 2025-indeling voor SBI-codes kunnen meerdere nevenactiviteiten worden ingevoerd. Deze zijn nu beschikbaar via een nieuwe WebApi-ingang. 

Nieuwe API-ingang voor nevenactiviteiten

GET relatie/api/v1/relaties/instanties/{id}/sbicodes/nevenactiviteiten 

Deze nieuwe ingang levert:

{

"Data": [

{

"SbiCodeId": "string",

"Omschrijving": "string"

}

],

"Paging": {

...

}

}

Onder deze node worden de nevenactiviteiten geleverd zoals ingevoerd op het tabblad Instantie bij de Relatie-gegevens. 

Hoofdactiviteit blijft ongewijzigd

De hoofdactiviteit wordt nog steeds zoals voorheen geleverd via de node SbiCodeHoofdactiviteit van:

GET relatie/api/v1/relaties/instanties/{id}

{

...

"SbiCodeHoofdactiviteit": {

"SbiCodeId": "string",

"Omschrijving": "string"

},

...

}

Vervallen node SbiCodeNevenactiviteit

Voorheen was slechts één nevenactiviteit mogelijk, die werd geleverd via de node SbiCodeNevenactiviteit. Nu meerdere nevenactiviteiten mogelijk zijn bij gebruik van de nieuwe SBI-indeling, vervalt deze node. Programmatuur die gebruik maakt van deze node moet hierop worden aangepast. 

Overgangsfase

Om te helpen bij de overgang is er sprake van een tijdelijke overgangsfase:

• Als de SBI-codes uit de nieuwe SBI-indeling nog niet zijn ingevoerd, dan worden voor nu alsnog de hoofdactiviteit en nevenactiviteit uit de oude indeling geleverd in de nodes SbiCodeHoofdactiviteit en SbiCodeNevenactiviteit, als deze zijn opgegeven.
• Als de SBI-codes uit de nieuwe SBI-indeling wél zijn ingevoerd, dan wordt voor nu nog de eerste nevenactiviteit uit de lijst opgenomen onder de SbiCodeNevenactiviteit-node, zodat bestaande programmatuur die afhankelijk is van deze node niet direct ophoudt met werken. 

Impact voor jou

Als je gebruik maakt van de SbiCodeNevenactiviteit-node in je integraties, dan moet je deze aanpassen naar de nieuwe /sbicodes/nevenactiviteiten-ingang. De overgangsfase geeft je tijd om deze aanpassing door te voeren voordat de oude node definitief wordt verwijderd.