This document is intended for technical resources and describes how to migrate from the old version 1 Decision B2B service to the new version 3 Decision B2B service (Risk Guardian Suite - RGS).
NB! Only applies to Norwegian company decisions.
Applies to Norwegian company requests only.
The only difference in decision request for company is the URL. Check decision service v3 documentation on Developer Portal for decision request body in details.
| Method | URL for old version 1 | URL for new version 3 |
| POST | https://api.bisnode.com/decision/v1/company | https://api.bisnode.com/decision/v3/company/no |
| Version 1 | Version 3 | Comment |
| registrationNumber | registrationNumber | |
| duns | duns | |
| countryCode | -- |
Part of the URL in v3.
|
| rulesetKey | rulesetKey | |
| reference | reference | |
| endUser | endUser | |
| customerInput | customerInput | |
| notificationOptions | notificationOptions | Norway only |
| language | language |
Check decision service v3 documentation on Developer Portal for decision response body in details.
Comparison of structure change. Unchanged fields are omitted from this comparison.
| Old structure in version 1 | New structure in version 3 |
| subjectData | subjectData |
|
|
|
version
|
decisionResult
|
|
scoreData
|
|
|
-- |
| ruleset |
ruleset
|
|
|
|
|
|
|
|
--
|
|
-- |
| decisionResult | decisionResult |
|
|
|
|
|
|
|
|
|
|
| ruleModuleResults | ruleModuleResults |
|
|
|
|
|
-- |
| decisioningRules | decisionResult |
|
|
|
|
|
--
|
|
|
|
|
|
|
|
|
| suppressedRules | decisionResult |
|
|
|
|
|
--
|
|
|
|
|
|
|
|
|
|
Old version 1
|
New version 3 |
|
{ "correlationId": "742b7a78-0a84-4d19-b60c-d04e35daf99d ", "version": "1", "userData": { "customerId": "Customer Id", "customerName": "Some Customer", "userId": "123456", "endUser": "endUser", "reference": "testReference", "language": "en" }, "subjectData": { "registrationNumber": "975374939", "countryCode": "NO", "duns": "562052746", "registrationDate": "2020-01-01", "companyName": "Test Company", "registeredAddress": { "countryCode": "NO", "town": "OSLO", "postalCode": "0010" }, "postalAddress": { "countryCode": "NO", "town": "OSLO", "postBox": "3", "postalCode": "0010" }, "companyStatuses": { "operatingStatus": { "code": "A", "label": "Active" }, "registrationStatusER": { "code": "RER", "label": "Registered" }, "registrationStatusFR": { "code": "RFR", "label": "Registered" }, "registrationStatusMVR": { "code": "NRMVR", "label": "Not registered" } }, "usageRestrictions": [ { "code": "MI", "label": "Voluntary block for credit" } ], "legalForm": { "code": "AS", "label": "Private Limited Company" }, "industryCode": { "primary": { "code": "86909", "label": "Other health services" } }, "test": true }, "scoreData": [ { "scoreCardName": "Some scorecard", "displayName": "Some scorecard", "scoreCardVersion": 2, "scoreCardGenre": "GENERIC", "rawScore": 1481, "scoreValue": 82, "probabilityOfDefault": 0.221, "probabilityOfDefaultAsPercentage": 22.1, "minimumScoreValue": 0, "maximumScoreValue": 100 } ], "date": "2019-08-24T14:15:22.123Z", "ruleset": { "rulesetKey": "some-ruleset-key", "rulesetName": "some ruleset", "rulesetBusinessChannel": "B2B", "rulesetCountryCode": "NO", "rulesetConfigurationVersion": "5" }, "decisionResult": { "decision": "A", "decisionDescription": "approve", "decisionOutcomes": { "approvedLimit": "10000" }, "originalDecisionOutcomes": {}, "decisionReasons": [ { "reasonCode": "AR123" } ] }, "ruleModuleResults": [ { "ruleModuleName": "Some module", "ruleModuleDecision": "A", "ruleModuleOutcomeCode": "AM3" } ], "decisioningRules": [ { "reasonKey": "A123", "ruleName": "Some rule", "ruleModuleName": "Some module", "missingData": false, "ruleOutcomes": { "decision": "approve", "action": "", "reasonCode": "AR123" }, "usedValues": { "creditApplied": "10000" }, "ruleParameters": { "decision": "approve" } } ], "suppressedRules": [ { "reasonKey": "R124", "ruleName": "Other rule", "ruleModuleName": "Some module", "missingData": false, "ruleOutcomes": {}, "usedValues": { "legalForm": "AS" }, "ruleParameters": { "decision": "decline" } } ] } |
{ "correlationId": "742b7a78-0a84-4d19-b60c-d04e35daf99d", "userData": { "customerId": "Customer Id", "customerName": "Some Customer", "userId": "123456", "endUser": "endUser", "reference": "testReference", "language": "en" }, "subjectData": { "registrationNumber": "975374939", "countryCode": "NO", "duns": "562052746", "registrationDate": "2020-01-01", "companyName": "Test Company", "registeredAddress": { "countryCode": "NO", "postalDistrict": "OSLO", "postalCode": "0010" }, "postalAddress": { "countryCode": "NO", "postalDistrict": "OSLO", "postBox": "3", "postalCode": "0010" }, "companyStatuses": { "operatingStatuses": [ { "id": "OPERATING_STATUS", "code": "A", "label": "Active" } ], "registrationStatuses": [ { "id": "ER", "code": "RER", "label": "Registered" }, { "id": "FR", "code": "RFR", "label": "Registered" }, { "id": "MVR", "code": "NRMVR", "label": "Not registered" } ] }, "usageRestrictions": [ { "code": "MI", "label": "Voluntary block for credit" } ], "legalForm": { "code": "AS", "label": "Private Limited Company" }, "industryCode": { "primary": { "code": "86909", "label": "Other health services" } }, "test": true }, "scoreData": [ { "scoreCardName": "Some scorecard", "scoreCardVersion": 2, "scoreCardGenre": "GENERIC", "rawScore": 1481, "scoreValue": 82, "probabilityOfDefault": 0.221, "probabilityOfDefaultAsPercentage": 22.1, "minimumScoreValue": 0, "maximumScoreValue": 100 } ], "ruleset": { "key": "some-ruleset-key", "name": "some ruleset", "version": "5" }, "decisionResult": { "decision": { "code": "A", "label": "Approved", "date": "2019-08-24T14:15:22.123Z", "by": "123456", "comment": "some comment", "outcomeSummary": [ { "moduleId": "module-id", "ruleId": "rule-id", "key": "approvedLimit", "value": "10000" } ], "version": "1" }, "ruleModuleResults": [ { "moduleId": "module-id", "moduleName": "Some module", "decision": { "code": "A", "label": "Approved" } } ], "decisionReasons": { "rules": [ { "moduleId": "module-id", "ruleId": "rule-id", "ruleName": "Some rule", "reason": { "key": "R123", "code": "AR123" }, "priority": 0, "missingData": false, "decsion": { "code": "A", "label": "Approved" }, "outcomes": [ { "key": "approvedLimit", "value": "10000" } ], "usedValues": [ { "key": "creditApplied", "value": "10000" } ], "parameters": [ { "key": "decision", "value": "approve" } ] } ] }, "rulesWithNoResult": { "rules": [ { "moduleId": "module-id", "ruleId": "rule-id", "ruleName": "Other rule", "reason": { "key": "R124" }, "priority": 0, "usedValues": [ { "key": "legalForm", "value": "AS" } ], "parameters": [ { "key": "decision", "value": "decline" } ] } ] } } } |
The only difference in archived decision request for company is the URL.
| Method | URL for old version 1 | URL for new version 3 |
| POST | https://api.bisnode.com/decision/v1/company/{correlationId} | https://api.bisnode.com/decision/v3/company/{correlationId} |
The only difference in background data request for person is the URL.
| Method | URL for old version 1 | URL for new version 3 |
| GET | https://api.bisnode.com/decision/v1/company/{correlationId}/background | https://api.bisnode.com/decision/v3/company/{correlationId}/background |
Background data response structure is unchanged. Check decision service v3 documentation on Developer Portal for background data request body in details.