Løsningen Konkursbehandling består av to selvstendige moduler, der begge skal implementeres:
- Konkursvarsel - en eNotifikasjonstjeneste der bankene henter konkursvarsler
- Innhenting av kontrollinformasjon – der bostyrer mottar kontoopplysninger fra bankene skyldnere hadde et kundeforhold til
I tabellen under finnes linker til datamodell, API-spesifikasjon og arkitekturdokumentasjon for de to modulene.
A - Konkursvarsel
Konkursvarsel-tjenesten er en selvstendig tjeneste som varsler om åpnet- slettet- opphevet- og avsluttede konkurser.
| Dokument | Link |
|---|---|
| Funksjonell spesifikasjon | Funksjonell spesifikasjon Konkursvarsel |
| Datamodell og arkitekturdokumentasjon | Datamodell og arkitekturdokument for Konkursvarsel |
| API-spesifikasjon | API-spesifikasjon konkursvarsel |
| Testdata | Testdata Konkursvarsel |
B - Kontrollinformasjon - Innhenting av kontoinformasjon for bostyrere
Tjenesten er basert på DSOP Kontrollinformasjon fellesstandard og gjelder utlevering av kontoopplysninger til bostyrene via «bosiden» hos BRREG.
Trinn 1 - DSOP Oversikt over kundeforhold
Brønnøysundregistrene skal bruke DSOP Oversikt over kundeforhold API-et på følgende måte:
Tillatte endepunkter i trinn 1 for tjenesten Konkursbehandling
| Endepunkter | Scope fra Maskinporten | Minimum nødvendig versjon av API |
|---|---|---|
| customerRelationships | bits:kundeforhold |
V.2.0 |
Gyldig forespørsel - Trinn 1
Brønnøysundregistrene skal bruke endepunktet customerRelationships på følgende måte:
| Input-felter | Beskrivelse |
|---|---|
| Authorization | Gyldig token fra Maskinporten (bits:kundeforhold). |
| CustomerID | FNR/D-NR eller orgnr til skyldneren. |
| CorrelationID | Uuid-verdi for unik teknisk referanse til forespørselen. |
| Legal-Mandate | Lovhjemmel for tjenesten skal være “kkl. §156 (3) og (4), jf. kkfor.§21”. URL Encoded verdien skal altså være “kkl.%20%C2%A7156%20(3)%20og%20(4)%2C%20jf.%20kkfor.%C2%A721”. |
| AccountInfoRequestID | Uuid-verdi for et saksnummer i bosiden. |
| fromDate | Opptil 12 måneder før konkursdato. |
| toDate | Dagens dato. |
| onlyPrimaryOwner | Kun “onlyPrimaryOwner” = “TRUE”. |
Se datamodell for customerRelationships.
Trinn 2 - DSOP Kontrollinformasjon
Generell informasjon
| Informasjon om | Beskrivelse | Link |
|---|---|---|
| Funksjonell spesifikasjon | Den funksjonelle spesifikasjonen for DSOP Kontrollinformasjon fellesstandard gjelder for løsningen Konkursbehandling. | Dokumentasjon på engelsk: Functional specification DSOP Control Common Standard. |
| Informasjon om volum og responstider | Responstidene kan variere mellom finansinstitusjoner, men det typiske mønsteret er at forespørsler etter data vil ha raske responstider (sekunder), mens store historiske forespørsler kan det ta lengre tid. Volum for løsningen Konkursbehandling. Totalt volum per år for forespørsler om kontoliste med tilhørende kontodetaljer og transaksjoner i samme tidsperiode til finansinstitusjoner fra bostyrene: 20.000 forespørsler |
|
| Sikkerhetsdokumentasjon | Sikkerhetsdokumentasjon for DSOP Kontrollinformasjon fellesstandard gjelder for løsningen Konkursbehandling. | Sikkerhetsdokumentasjon. |
| Arkitektur | Arkitektur for DSOP Kontrollinformasjon fellesstandard gjelder for løsningen Konkursbehandling. | Dokumentasjon på engelsk: Architecture documentation. |
| API-spesifikasjon | Følgende endepunkter inngår i løsningen Konkursbehandling: - Accounts - Account details - Transactions Finansforetakene skal påse at Konkursbehandling løsningen ikke får tilgang til endepunktene: - Cards - Roles Finansforetakene skal returnere en HTTP 400 med ACC-001 og best mulig feilbeskrivelse dersom etat sender en forespørsel til ugyldige endepunkter. Se HTTP-feilkoder og spesifikke feilsituasjoner med tilhørende meldingskoder. |
Dokumentasjon på engelsk: API-specification. |
| Overordnet spesifikasjon av DSOP-Kontroll API-et | Den overordnede spesifikasjonen av DSOP Kontroll API-et for DSOP Kontrollinformasjon fellesstandard gjelder for løsningen Konkursbehandling. | Overall description of the DSOP Control API |
| Integrasjonstesting | Definerte test-case for DSOP Kontrollinformasjon fellesstandard gjelder for løsningen Konkursbehandling. For ende til ende testing bør finansforetakene hensynta testdata definert i konkursvarsel testmiljø. |
Internal testing / quality assurance DSOP Control Common Standard. |
Tillatte endepunkter i trinn 2 for tjenesten Konkursbehandling
| Endepunkter | Scope fra Maskinporten | Minimum nødvendig versjon av API |
|---|---|---|
| Accounts (kontoliste) Account Details (kontodetaljer) Transactions (transaksjoner) |
bits:kontoinformasjon |
V.2.0 |
Finansforetakene skal påse at tjenesten Konkursbehandling ikke får tilgang til endepunktene: Cards og Roles.
Gyldig forespørsel - Trinn 2
Brønnøysundregistrene skal bruke endepunktet Accounts på følgende måte:
| Input-felter | Beskrivelse |
|---|---|
| AccountInfoRequestId | Uuid-verdi for et saksnummer i bosiden. |
| CorrelationID | Uuid-verdi for unik teknisk referanse til forespørselen. |
| Legal-Mandate | Lovhjemmel for tjenesten skal være “kkl. §156 (3) og (4), jf. kkfor.§21”. URL Encoded verdien skal altså være “kkl.%20%C2%A7156%20(3)%20og%20(4)%2C%20jf.%20kkfor.%C2%A721”. |
| PartyID | FNR/D-NR eller orgnr til skyldneren. |
| onlyPrimaryOwner | Kun “onlyPrimaryOwner” = “TRUE”. |
| AdditionalReferenceID | Ingen data. |
| AdditionalReferenceIDType | Ingen data. |
| RequesterID | Ingen data. |
| fromDate | Opptil 12 måneder tilbake i tid, regnet fra konkursdato (kjennelsesdato). Banken finner datoen for konkurs i konkursvarselet - i feltet kjennelsesdato (se informasjon om felter i konkursvarselet). |
| toDate | Dagens dato. |
Se datamodell for Accounts.
Videre skal Brønnøysundregistrene bruke endepunktene Account Details og Transactions på følgende måte:
| Felter | Beskrivelse |
|---|---|
| accountReference | Unik referanse til kontoen. |
| AccountInfoRequestID | Samme definisjon som for Accounts. |
| CorrelationID | Samme definisjon som for Accounts. |
| Legal-Mandate | Samme definisjon som for Accounts. |
| AdditionalReferenceID | Ingen data. |
| AdditionalReferenceIDType | Ingen data. |
| RequesterID | Ingen data. |
| fromDate | Samme definisjon som for Accounts. |
| toDate | Samme definisjon som for Accounts. |
Se datamodell for:
Nødvendig filtrering av data ved utlevering per endepunkt
Finansforetakene skal utlevere kontoopplysninger for denne tjenesten iht. gjeldende datamodell for DSOP Kontrollinformasjon API. Se Description of all input- and output parameters in the APIs.
Kategorisering av utlevering av kontoopplysninger på feltnivå:
- Teknisk obligatorisk: Denne opplysningen skal utleveres, ettersom det er teknisk påkrevet i API-et. Det er viktig å ta hensyn til forkortelsene (M, D og MC) fra datamodellen i DSOP Kontroll API-et når det gjelder utlevering av obligatoriske felter, spesielt der finansforetak ikke har mulighet til å utlevere data.
- Skal utleveres: Etaten har behov for denne opplysningen, og tjenesten skal derfor utlevere den dersom finansforetaket har informasjonen tilgjengelig.
- Kan filtreres bort: Etaten har ikke behov for denne opplysningen, og finansforetaket kan velge å utelate den fra utleveringen. Dersom etaten mottar denne opplysningen, skal den slettes.
- Utleveres ikke: Finansforetak vil ikke levere opplysning gjennom datafeltet.
- Til vurdering: Denne kategorien brukes for felt som ennå ikke er avklart. Det betyr at det fortsatt pågår en vurdering av om opplysningen skal utleveres eller ikke.
Overordnede prinsipper for utlevering definert i DSOP Kontrollinformasjon fellesstandard vil gjelde for denne tjenesten.
Utlevering for Accounts (Kontoliste):
“Kontoliste” er det første endepunktet etat vil benytte for å få utlevert en liste over konti som tilhører kontrollobjektet. Videre bruk av tjenesten baseres på dette Kontoliste-kallet.
For tjenesten Konkursbehandling gjelder følgende utlevering fra Kontoliste:
- Liste over konti som skyldneren eide i den gjeldende tidsperioden.
Se gyldig forespørsel for endepunktet Accounts.
Finansforetakene skal utlevere kontoopplysninger fra dette endepunktet etter overordnede prinsipper for utlevering definert i DSOP Kontrollinformasjon fellesstandard.
Videre er retningslinjene for utlevering av data per felt for dette endepunktet beskrevet i tabellen nedenfor, i henhold til kategoriseringen definert i Utlevering av datafelter per endepunkt.
| Svar fra Accounts | Datautlevering |
|---|---|
| responseDetails.status | Teknisk obligatorisk |
| responseDetails.message | Skal utleveres |
| accounts.status | Skal utleveres |
| accounts.servicer.identifier.countryOfResidence | Til vurdering |
| accounts.servicer.identifier.value | Teknisk obligatorisk |
| accounts.servicer.identifier.type | Teknisk obligatorisk |
| accounts.servicer.name | Til vurdering |
| accounts.accountIdentifier | Teknisk obligatorisk |
| accounts.accountReference | Teknisk obligatorisk |
| accounts.type | Til vurdering |
| accounts.currency | Til vurdering |
| accounts.primaryOwner.permission | Til vurdering |
| accounts.primaryOwner.identifier.countryOfResidence | Til vurdering |
| accounts.primaryOwner.identifier.value | Teknisk obligatorisk |
| accounts.primaryOwner.identifier.type | Teknisk obligatorisk |
| accounts.primaryOwner.name | Til vurdering |
| accounts.primaryOwner.startDate | Til vurdering |
| accounts.primaryOwner.endDate | Til vurdering |
| accounts.name | Utleveres ikke |
| links.rel | Teknisk obligatorisk |
| links.href | Teknisk obligatorisk |
Utlevering for Account Details (Kontodetaljer):
Finansforetakene skal utlevere opplysninger fra dette endepunktet etter overordnede prinsipper for utlevering definert i DSOP Kontrollinformasjon fellesstandard. Vær oppmerksom på at det i enkelte tilfeller ikke vil bli utlevert informasjon fra spesifikke felter dersom det ikke er relevant.
Videre er retningslinjene for utlevering av data per felt for dette endepunktet beskrevet i tabellen nedenfor, i henhold til kategoriseringen definert i Utlevering av datafelter per endepunkt.
| Svar fra AccountDetails | Datautlevering |
|---|---|
| responseDetails.status | Teknisk obligatorisk |
| responseDetails.message | Skal utleveres |
| account.status | Skal utleveres |
| account.servicer.identifier.countryOfResidence | Til vurdering |
| account.servicer.identifier.value | Teknisk obligatorisk |
| account.servicer.identifier.type | Teknisk obligatorisk |
| account.servicer.name | Utleveres ikke |
| account.accountIdentifier | Teknisk obligatorisk |
| account.accountReference | Teknisk obligatorisk |
| account.type | Til vurdering |
| account.currency | Til vurdering |
| account.name | Til vurdering |
| account.balances.creditLineIncluded | Til vurdering |
| account.balances.amount | Til vurdering |
| account.balances.creditDebitIdicator | Til vurdering |
| account.balances.registered | Til vurdering |
| account.balances.type | Til vurdering |
| account.balances.creditLineAmount | Til vurdering |
| account.balances.creditLineCurrency | Til vurdering |
| account.balances.currency | Til vurdering |
| account.primaryOwner.permission | Til vurdering |
| account.primaryOwner.identifier.countryOfResidence | Til vurdering |
| account.primaryOwner.identifier.value | Teknisk obligatorisk |
| account.primaryOwner.identifier.type | Teknisk obligatorisk |
| account.primaryOwner.name | Til vurdering |
| account.primaryOwner.startDate | Til vurdering |
| account.primaryOwner.endDate | Til vurdering |
| account.startDate | Til vurdering |
| account.endDate | Til vurdering |
Utlevering for Transactions (Transaksjoner):
Finansforetakene skal utlevere opplysninger fra dette endepunktet etter overordnede prinsipper for utlevering definert i DSOP Kontrollinformasjon fellesstandard. Vær oppmerksom på at det i enkelte tilfeller ikke vil bli utlevert informasjon fra spesifikke felter dersom det ikke er relevant.
Videre er retningslinjene for utlevering av data per felt for dette endepunktet beskrevet i tabellen nedenfor, i henhold til kategoriseringen definert i Utlevering av datafelter per endepunkt.
| Svar fra Transactions | Datautlevering |
|---|---|
| responseDetails.status | Teknisk obligatorisk |
| responseDetails.message | Skal utleveres |
| transactions.transactionIdentifier | Teknisk obligatorisk |
| transactions.references.value | Til vurdering |
| transactions.references.type | Til vurdering |
| transactions.creditDebitIndicator | Til vurdering |
| transactions.reversalIndicator | Til vurdering |
| transactions.status | Til vurdering |
| transactions.transactionCode.domain | Til vurdering |
| transactions.transactionCode.family | Til vurdering |
| transactions.transactionCode.subFamily | Til vurdering |
| transactions.transactionCode.freeText | Til vurdering |
| transactions.bookingDate | Til vurdering |
| transactions.valueDate | Til vurdering |
| transactions.counterParties.accountIdentifier | Til vurdering |
| transactions.counterParties.identifier.countryOfResidence | Til vurdering |
| transactions.counterParties.identifier.value | Teknisk obligatorisk |
| transactions.counterParties.identifier.type | Teknisk obligatorisk |
| transactions.counterParties.name | Til vurdering |
| transactions.counterParties.type | Til vurdering |
| transactions.counterParties.postalAddress.postCode | Til vurdering |
| transactions.counterParties.postalAddress.type | Til vurdering |
| transactions.counterParties.postalAddress.streetName | Til vurdering |
| transactions.counterParties.postalAddress.buildingNumber | Til vurdering |
| transactions.counterParties.postalAddress.townName | Til vurdering |
| transactions.counterParties.postalAddress.country | Til vurdering |
| transactions.counterParties.postalAddress.addressLines | Til vurdering |
| transactions.additionalInfo | Til vurdering |
| transactions.currencyExchange.originalAmount | Til vurdering |
| transactions.currencyExchange.sourceCurrency | Til vurdering |
| transactions.currencyExchange.targetCurrency | Til vurdering |
| transactions.currencyExchange.unitCurrency | Til vurdering |
| transactions.currencyExchange.exchangeRate | Til vurdering |
| transactions.merchant | Til vurdering |
| transactions.paymentCard.cardIdentifier | Teknisk obligatorisk |
| transactions.paymentCard.holderName | Til vurdering |
| transactions.paymentCard.startDate | Til vurdering |
| transactions.paymentCard.expiryDate | Til vurdering |
| transactions.paymentCard.cardIssuerName | Til vurdering |
| transactions.paymentCard.type | Til vurdering |
| transactions.paymentCard.cardStatus | Til vurdering |
| transactions.paymentCard.versionNumber | Til vurdering |
| transactions.paymentCard.cardIssuerIdentifier.countryOfResidence | Til vurdering |
| transactions.paymentCard.cardIssuerIdentifier.value | Teknisk obligatorisk |
| transactions.paymentCard.cardIssuerIdentifier.type | Teknisk obligatorisk |
| transactions.registered | Til vurdering |
| transactions.amount | Til vurdering |
| transactions.currency | Til vurdering |
| links.rel | Teknisk obligatorisk |
| links.href | Teknisk obligatorisk |
Datavalidering
Det er finansforetakenes ansvar å validere forespørsler fra etat og det er opp til finansforetakene å sørge for at alle forespørsler fra etat blir validert godt nok. Ved å validere og logge input-parametere fra etat riktig, vil finansforetakene være bedre egnet til å unngå levering av overskuddsinformasjon. Implementering av slik logikk er finansforetakenes ansvar.
For å sikre godt kontrollnivå på tvers av finansforetakene, er det beskrevet et sett med anbefalinger om generelle og generiske valideringer i DSOP Kontrollinformasjon fellesstandard og spesifikke valideringer knyttet til tjenesten Konkursbehandling.
Generelle og generiske valideringer
Disse er beskrevet på «Generic DSOP Control validations».
Org.nr. til Brønnøysundregistrene (brreg) er 974760673.
Spesifikke valideringer for Konkursbehandling
- Bekreftelse av Konkurs: Finansforetakene bør verifisere at kontrollobjektet (f.nr./d.nr./org.nr.) virkelig er konkurs ved å sjekke feltene “type” og “kjennelsesdato” i eNotifikasjonstjenesten for Konkursvarsel API. Se DSOP Konkursvarsel: API-dokumentasjon.
- Gyldig input-parameter for Konkursbehandling:
- Tilgangstoken fra Maskinporten: Finansforetakene må validere token fra Maskinporten med følgende scope:
bits:kontoinformasjon - Input parameter for Konkursbehandling: Se gjeldende API-spesifikasjon for teknisk beskrivelse: API Specification
- Tilgangstoken fra Maskinporten: Finansforetakene må validere token fra Maskinporten med følgende scope:
For Accounts:
| Input parametere | Forventet verdi | Forslag til validering |
|---|---|---|
| AccountInfoRequestID (M) | Uuid referanse til saksnr. | Formatet kan valideres. I tillegg kan denne parameteren valideres iht definisjonen i Overall description of the DSOP Control API. |
| CorrelationID (M) | Uuid verdi til en unik teknisk referanse for forespørselen. | Formatet kan valideres. I tillegg kan denne parameteren valideres iht definisjonen i Overall description of the DSOP Control API. |
| Legal-Mandate (M) | “kkl. §156 (3) og (4), jf. kkfor.§21”. URL Encoded verdi “kkl.%20%C2%A7156%20(3)%20og%20(4)%2C%20jf.%20kkfor.%C2%A721”. | Strengen skal være I ‘encoded’ format og burde valideres iht til Juridiske rammebetingelser Konkursbehandling. |
| PartyID (M) | Kontrollbjektet: Organisasjonsnummer, FNR eller D.NR. | Formatet kan valideres. |
| OnlyPrimaryOwner (M) | “TRUE” | Konkursbehandling skal kun tillate verdien “TRUE”. |
| AdditionalReferenceID (O) | Ingen. | - |
| AdditionalReferenceIDType (O) | Ingen. | - |
| RequesterID (O) | Ingen. | - |
| fromDate (M) | Inntil 12 måneder før konkursdato. | Formatet kan valideres. I tillegg bør verdien også valideres slik at datoen er opptil 12 måneder før “kjennelsesdato” tilgjengelig i Konkursvarsel API. |
| toDate (M) | Dagens dato. | Formatet kan valideres. |
Se HTTP error codes and specific error situations with associated message codes.
For de andre endepunktene (Account Details og Transactions):
| Input parametere | Forventet verdi | Forslag til validering |
|---|---|---|
| AccountReference (M) | Uuid referanse til kontonr. | - |
| AccountInfoRequestID (M) | Uuid referanse til saksnr. | Samme som for Accounts. |
| CorrelationID (M) | Uuid verdi til en unik teknisk referanse for forespørselen. | Samme som for Accounts. |
| Legal-Mandate (M) | “kkl. §156 (3) og (4), jf. kkfor.§21”. URL Encoded verdi “kkl.%20%C2%A7156%20(3)%20og%20(4)%2C%20jf.%20kkfor.%C2%A721”. | Samme som for Accounts. |
| AdditionalReferenceID (O) | Ingen. | - |
| AdditionalReferenceIDType (O) | Ingen. | - |
| RequesterID (O) | Ingen. | - |
| fromDate (M) | Inntil 12 måneder før konkursdato. | Samme som for Accounts. |
| toDate (M) | Dagens dato. | Samme som for Accounts. |
Se HTTP error codes and specific error situations with associated message codes.
Endringslogg
| Dato | Versjon | Endring |
|---|---|---|
| 18.03.25 | 2.0.2 | Spesifisert grunnlaget for utlevering av kontoinformasjon i henhold til DSOP fellesstandard |
| 28.02.25 | 2.0.1 | Henvisning til “Principles for delivery of information via DSOP Control information common standard” lagt til under “Nødvendig friltrering av data ved utlevering per endepunkt”. Kategoriene er endret for å følge prinsippene. Alle tabellene over utlevering av felt er oppdatert med den nye kategoriseringen. |
| 20.03.24 | 2.0 | Lagt til løsningsbeskrivelse |