Løsningen Konkursbehandling består av to selvstendige moduler, der begge skal implementeres:

  1. Konkursvarsel - en eNotifikasjonstjeneste der bankene henter konkursvarsler
  2. Innhenting av kontrollinformasjon – der bostyrer mottar kontoopplysninger fra bankene skyldnere hadde et kundeforhold til

alt text

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.

alt text

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.1.3

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 Verdien skal være “kkl.%20%C2%A7156%20(3)%20 og%20(4)%2C%20jf.%20kkfor.%C2 %A721” (encoded).
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 Verdien skal være “kkl.%20%C2%A7156%20(3)%20 og%20(4)%2C%20jf.%20kkfor.%C2 %A721” (encoded).
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:

Filtrering av data ved utlevering per endepunkt

Finansforetakene skal utlevere kontoopplysninger iht. gjeldende datamodell for DSOP Kontrollinformasjon API. Se Description of all input- and output parameters in the APIs.

Utlevering av kontoopplysninger på feltnivå til etat er kategorisert slik:

  • Teknisk obligatorisk: Denne opplysningen skal utleveres, ettersom det er teknisk påkrevet.
  • Skal utleveres: Denne opplysningen skal utleveres.
  • Kan utleveres: Dersom banken har denne opplysningen kan den gjerne utleveres.
  • Ingen behov: Etaten har ikke behov for denne opplysningen og banken bør ikke utlevere den.
  • NA: Ikke definert

Gjeldende utlevering for Accounts (Kontoliste) V.2.0:

Svar fra Accounts Datautlevering
responseDetails.status Teknisk obligatorisk
responseDetails.message Skal utleveres
   
accounts.status Skal utleveres
accounts.servicer.identifier.countryOfResidence NA
accounts.servicer.identifier.value Teknisk obligatorisk
accounts.servicer.identifier.type Teknisk obligatorisk
accounts.servicer.name NA
accounts.accountIdentifier Teknisk obligatorisk
accounts.accountReference Teknisk obligatorisk
accounts.type NA
accounts.currency NA
accounts.primaryOwner.permission NA
accounts.primaryOwner.identifier.countryOfResidence NA
accounts.primaryOwner.identifier.value Teknisk obligatorisk
accounts.primaryOwner.identifier.type Teknisk obligatorisk
accounts.primaryOwner.name NA
accounts.primaryOwner.startDate NA
accounts.primaryOwner.endDate NA
accounts.name NA
   
links.rel Teknisk obligatorisk
links.href Teknisk obligatorisk

Gjeldende utlevering for Account Details (Kontodetaljer) V.2.0:

Svar fra AccountDetails Datautlevering
responseDetails.status Teknisk obligatorisk
responseDetails.message Skal utleveres
   
account.status Skal utleveres
account.servicer.identifier.countryOfResidence NA
account.servicer.identifier.value Teknisk obligatorisk
account.servicer.identifier.type Teknisk obligatorisk
account.servicer.name NA
account.accountIdentifier Teknisk obligatorisk
account.accountReference Teknisk obligatorisk
account.type NA
account.currency NA
account.name NA
account.balances.creditLineIncluded NA
account.balances.amount NA
account.balances.creditDebitIdicator NA
account.balances.registered NA
account.balances.type NA
account.balances.creditLineAmount NA
account.balances.creditLineCurrency NA
account.balances.currency NA
account.primaryOwner.permission NA
account.primaryOwner.identifier.countryOfResidence NA
account.primaryOwner.identifier.value Teknisk obligatorisk
account.primaryOwner.identifier.type Teknisk obligatorisk
account.primaryOwner.name NA
account.primaryOwner.startDate NA
account.primaryOwner.endDate NA
account.startDate NA
account.endDate NA

Gjeldende utlevering for Transactions (Transaksjoner) V.2.0:

Svar fra Transactions Datautlevering
responseDetails.status Teknisk obligatorisk
responseDetails.message Skal utleveres
   
transactions.transactionIdentifier Teknisk obligatorisk
transactions.references.value NA
transactions.references.type NA
transactions.creditDebitIndicator NA
transactions.reversalIndicator NA
transactions.status NA
transactions.transactionCode.domain NA
transactions.transactionCode.family NA
transactions.transactionCode.subFamily NA
transactions.transactionCode.freeText NA
transactions.bookingDate NA
transactions.valueDate NA
transactions.counterParties.accountIdentifier NA
transactions.counterParties.identifier.countryOfResidence NA
transactions.counterParties.identifier.value Teknisk obligatorisk
transactions.counterParties.identifier.type Teknisk obligatorisk
transactions.counterParties.name NA
transactions.counterParties.type NA
transactions.counterParties.postalAddress.postCode NA
transactions.counterParties.postalAddress.type NA
transactions.counterParties.postalAddress.streetName NA
transactions.counterParties.postalAddress.buildingNumber NA
transactions.counterParties.postalAddress.townName NA
transactions.counterParties.postalAddress.country NA
transactions.counterParties.postalAddress.addressLines NA
transactions.additionalInfo NA
transactions.currencyExchange.originalAmount NA
transactions.currencyExchange.sourceCurrency NA
transactions.currencyExchange.targetCurrency NA
transactions.currencyExchange.unitCurrency NA
transactions.currencyExchange.exchangeRate NA
transactions.merchant NA
transactions.paymentCard.cardIdentifier Teknisk obligatorisk
transactions.paymentCard.holderName NA
transactions.paymentCard.startDate NA
transactions.paymentCard.expiryDate NA
transactions.paymentCard.cardIssuerName NA
transactions.paymentCard.type NA
transactions.paymentCard.cardStatus NA
transactions.paymentCard.versionNumber NA
transactions.paymentCard.cardIssuerIdentifier.countryOfResidence NA
transactions.paymentCard.cardIssuerIdentifier.value Teknisk obligatorisk
transactions.paymentCard.cardIssuerIdentifier.type Teknisk obligatorisk
transactions.registered NA
transactions.amount NA
transactions.currency NA
   
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

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.%20%C2%A7156%20(3)%20 og%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.%20%C2%A7156%20(3)%20 og%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.

Change Log

Date Version Change
20.03.24 2.0 New version of the DSOP Control API generating extensive changes throughout all documentation.