Documentation for cooperation between brokers and accountants
Ambita has designed a set of api messages to capture the flow between a broker and an accountant. We have split the process into separate steps:
- Boliginformasjon (Information about the object). Used to inform the broker about which rules that apply to the sale of a given object.
- Forhåndsutlysing (Advance clarification). If the seller want to, he or she can clarify any preemption before the object is sold.
- Salgsmelding (Sales message). The broker informs the accountant about the object being sold.
- Endring overdragelsesdato (Change of transfer date). The broker requests a new transfer date
- Endring kjøpere (Change of buyers). The broken requests a change of buyers (new owners)
- Sluttbrev (Final letter). The accountant accepts that the process is completed.
- Restanse (Arrears). The broker requests what payment needs to be fulfilled.
The message format and process is described in more detail per product. You may take a look at typescript types for the messages here:
Each flow starts with an order from a broker using the Vitec Next platform. This order will trigger a request from our system to the accountant backend. The accountant will send one or more response messages back to us, and we will transform these into a series of operations on Vitec Next. The first version of the system relies heavily on PDF files that we deliver into the project archive, These files will gradually be replaced with API calls that push the structured data into the broker system. This will be done with little or no effect on the accountant integrations.
The messages are sent as JSON objects over HTTPS. The messages are sent as POST requests to the accountant. Responses are sent back to us as POST requests. In other words, the communication is asynchronous.
The following descriptions define a set of flows between us and the accountant system. The messages are described in a way that assumes that the process is fully automated and that the accountant can handle operations themselves. Sometimes part of the flow is handled outside the accountant system. In these cases we will inform the broker about this. The broker will then have to handle the operation manually.
To explain this in more detail the process can be viewed as three separate large operations:
- Clarification
- Ownership change
- Arrears
All messages interact with these three operations. Special handling is required if the accountant system is not used to handle any one of these.
The first thing a broker needs to do is to find out which operations can be done at all, which of them can be done digitally and which of them they need to continue to do manually. This can differ from one sales project to the next. This product can be ordered by the broker, and we will forward it to the correct recipient. If the recipient is not part of the system, we will inform the broker about this.
On behalf of the broker the following request is made:
{
"type": "boliginformasjon",
"ordreId": "1888e14e-1418-4d37-b3be-0d0b623681ba",
"registerenhet": {
"type": "matrikkel",
"ident": "3802-71-119-0-21"
},
"bestiller": {
"id": "TBF",
"navn": "Broker Doe",
"epost": "[email protected]",
"telefon": "79119911"
},
"meglerkontor": {
"orgnr": "987654323",
"avdelingsnr": "3",
"navn": "Avdeling3",
"adresse": {
"gateadresse": "Testvei 3",
"postnummer": "0030",
"poststed": "OSLO"
},
"telefon": "12345678"
},
"kontaktperson": {
"id": "AO",
"navn": "Anne Olsen",
"epost": "[email protected]",
"telefon": "12548630"
}
}- type - The request message type. Defines the following flow. Can be one of four different types:
- boliginformasjon
- forhandsutlysing
- salgsmelding
- restanse
- ordreId (order id) - A unique identifier that will be included in the responses
- registerenhet (realty) - A cadastre, share, stock or obligation property
- type - type of realty
- matrikkel (cadastre) - This is a cadastre in the Land Registry
- borettsandel (cooperative share) - This is a share in the Land Registry
- aksjeandel (stock share) - This is a privately held share property
- obligasjonsandel (bond share) - This is a privately held bond property
- ident - the unique identifier for the realty
- type - type of realty
- bestiller (orderer) - The broker making the product order
- id - A unique identifier within the broker office
- navn (name) - The name of the broker
- epost (e-mail) - The e-mail of the broker
- telefon (phone) - The phone number of the broker
- meglerkontor (broker department)
- orgnr (organisation number) - The organisation number of the broker
- avdelingsnr (department number) - The broker department number
- navn (name) - The name of the broker department
- adresse (address) - The address of the broker department
- gateadresse (street address) - The street address with number and letter
- postnummer (postal number) - The postal number of the address
- poststed (postal place) - The postal place name of the address
- telefon - The phone number of the broker department
- kontaktperson (person to contact) - Person to contact about the order, e.g. the main broker
- id - A unique identifier within the broker office
- navn (name) - The name of the broker
- epost (e-mail) - The e-mail of the broker
- telefon (phone) - The phone number of the broker
The accountant responds with information about the given object, here identified with the cadastre identity 3802-71-119-0-21. This response is just an example:
{
"forkjopsrett": {
"harForkjopsrett": true,
"kanForhandsutlyses": true,
"intern": true,
"bestillingsformat": "Elektronisk",
"gebyr": 7225
},
"styregodkjenning": {
"pakrevd": true,
"bestillingsformat": "Manuelt",
"mottakerType": "forretningsforer"
},
"salgsmelding": {
"bestillingsformat": "Manuelt",
"gebyr": 6850
},
"restanse": {
"bestillingsformat": "Manuelt"
},
"andreHensyn": "Kundeforhold avsluttes 1.1.2023 - det gjenstår endel i forbindelse med regnskap og TPO for 2022",
"type": "boliginformasjon",
"ordreId": "1888e14e-1418-4d37-b3be-0d0b623681ba",
"forretningsforer": {
"navn": "UNTL",
"adresse": {
"gateadresse": "Postboks 112 Lier",
"postnummer": "0501",
"poststed": "Oslo"
},
"epost": "[email protected]"
},
"klient": {
"klienttype": "Borettslag tilknyttet",
"organisasjonsnavn": "Skauen Borettslag",
"organisasjonsnummer": "948677202",
"epost": "[email protected]",
"styreleder": {
"navn": "Ole Styreleder",
"epost": "[email protected]",
"telefonnr": "99889988"
}
},
"levert": "2022-07-07T15:48:07.6328836Z",
"referanse": "622/1",
"eierform": "Seksjonseier"
}General comment. For each step in the process we have a field called "bestillingsformat". This field can be of two types; "Elektronisk" or "Manuelt". "Elektonisk" means that the step can be completed through the integration. "Manuelt" means it has to be done manually. In other words, it has to be done the same way as before.
- forkjopsrett (right of first refusal)
- harForkjopsrett (has right of first refusal) - true if the object supports right of first refusal
- kanForhandsutlyses (supports advance notice) - true if right of first refusal can be ordered in advance
- intern (internal) - true if right is only available inside the cooperative
- bestillingsformat (order format) - Elektronisk (Electronic) or Manuelt (Manually).
- mottakerType (recipient type) - if bestillingsformat is "Manuelt" then mottakerType is either "forretningsforer" (accountant) or "lag" (client)
- gebyr (fee) - The price of the right of first refusal clarification
- styregodkjenning (board approval)
- pakrevd (required) - need board approval before moving into object
- bestillingsformat (order format) - See above
- mottakerType (recipient type) - See above
- salgsmelding (sales message)
- bestillingsformat (order format) - See above
- gebyr (fee) - The price of performing the change of ownership
- restanse (arrears)
- bestillingsformat (order format) - See above
- andre hensyn (other considerations) - Textual explanation of things one need to consider
- type (message type)
- ordreId (order id)
- forretningsforer (accountant) - Information about the company that handles this object
- navn (name) - name of company
- adresse (address) - address of company
- epost (email) - email to company
- klient - Information about the company that is the owner of the realties. Required for all callback types except callback type "feil"
- klienttype (client type) - The type of client (see list of examples)
- organisasjonsnavn (organization name) - The client name
- organisasjonsnummer (organization number) - The client organization number
- epost (email) - Email to the client
- styreleder (chairperson) - The person leading the board
- navn (name) - Name of chair person
- epost (email) - Email to chair person
- telefonnr (phone numer) - The phone number to the chair person
- levert (delivered) - timestamp when the response message was created
- referanse (reference) - a reference to the assignment from the accountant
- eierform (type of ownership) - can be Andelseier, Seksjonseier or Aksjonær
When our system receives this message it will construct a styled document as a PDF and deliver it directly to the broker system.
List of client types:
- Borettslag tilknyttet
- Tilknyttet annet boligbyggelag
- Tilknyttet boligsameie
- Tilknyttet-Ikke forkjøpsrett/forr.førs
- Forkjøpsrettsavklaring/ikke forr.fører
- Forkjøpsrett selveier/ikke forr.førsel
- Boligsameie
- Forening
- Borettslag frittstående
- Aksjeselskap, Bolig AS
- Garasjelag
- Parkeringssameie
- Tingrettslig sameie
If the seller wants to clarify the preemption before the sale is concluded they may ask the broker to order this. The response will come in two messages. One early message that explains the process and one late message that comes after the process has been completed, which may take a while.
We will transmit the following request message:
{
"type": "forhandsutlysing",
"ordreId": "67289ec4-871d-4011-8bc9-c0e9de6e5a90",
"registerenhet": {
"type": "matrikkel",
"ident": "3802-71-119-0-21"
},
"bestiller": {
"id": "TBF",
"navn": "Broker Doe",
"epost": "[email protected]",
"telefon": "79119911"
},
"meglerkontor": {
"orgnr": "987654323",
"avdelingsnr": "3",
"navn": "Avdeling3",
"adresse": {
"gateadresse": "Testvei 3",
"postnummer": "0030",
"poststed": "OSLO"
},
"telefon": "12345678"
},
"kontaktperson": {
"id": "AO",
"navn": "Anne Olsen",
"epost": "[email protected]",
"telefon": "12548630"
},
"bolig": {
"prom": 120,
"bra": 130,
"braI": 120,
"braE": 5,
"braB": 5,
"bta": 140
},
"prisantydning": 1000000
}For the other fields explanations see earlier descriptions
- bolig (housing) - information about the object. Fetched from broker system
- prom (sum primærrom)
- bra (sum bruksareal)
- braI (sum internt bruksareal)
- braE (sum eksternt bruksareal)
- braB (sum innglasset balkong)
- braS (sum salgbart bruksareal, brukes for næring)
- bta (bruttoareal)
- tba (sum terrasse- og balkongareal/åpent areal)
- srom (sum sekundærrom)
- prisantydning - price suggestion
After some processing the following early response message is returned, this message explains the steps that will be taken:
{
"utlysingssted": "Sendt styre, utlysing i laget",
"utlysingsdato": "2022-06-22T02:00:00+02:00",
"meldefrist": "2022-06-30T12:00:00+02:00",
"type": "forhandsutlysingtidlig",
"ordreId": "67289ec4-871d-4011-8bc9-c0e9de6e5a90",
"ordreMottatt": "2022-07-06T15:48:07.6328836Z",
"forretningsforer": {
"navn": "UNTL",
"adresse": {
"gateadresse": "Postboks 112 Lier",
"postnummer": "0501",
"poststed": "Oslo"
},
"epost": "[email protected]"
},
"klient": {
"klienttype": "Borettslag tilknyttet",
"organisasjonsnavn": "Skauen Borettslag",
"organisasjonsnummer": "948677202"
},
"levert": "2022-07-07T18:42:51.3081344+02:00",
"referanse": "622/1",
"eierform": "Seksjonseier"
}- ordreMottatt (order received date) - when the clarification was received
- utlysingssted (announcement location) - where the clarification is announced
- utlysingsdato (announcement date) - when the clarification will be announced
- meldefrist (deadline) - respondents need to report before this time
In some cases the broker contacts the accountant to change the announcement period. Right now this will be done manually. The following response message with updated announcement date and deadline are sent to inform the broker about the change:
{
"utlysingssted": "Sendt styre, utlysing i laget",
"utlysingsdato": "2022-06-24T02:00:00+02:00",
"meldefrist": "2022-07-02T12:00:00+02:00",
"type": "forhandsutlysingutsatt",
"ordreId": "67289ec4-871d-4011-8bc9-c0e9de6e5a90",
"ordreMottatt": "2022-07-06T15:48:07.6328836Z",
"forretningsforer": {
"navn": "UNTL",
"adresse": {
"gateadresse": "Postboks 112 Lier",
"postnummer": "0501",
"poststed": "Oslo"
},
"epost": "[email protected]"
},
"klient": {
"klienttype": "Borettslag tilknyttet",
"organisasjonsnavn": "Skauen Borettslag",
"organisasjonsnummer": "948677202"
},
"levert": "2022-07-08T18:42:51.3081344+02:00",
"referanse": "622/1",
"eierform": "Seksjonseier"
}When the process is done the final message is sent, summing up the result. Only two extra fields are added here; number of interested parties and how long the advance clarification lasts.
{
"antallInteressenter": 2,
"varighetForkjopsrett": "2022-09-20T12:10:53+02:00",
"utlysingssted": "Sendt styre, utlysing i laget",
"utlysingsdato": "2022-06-22T02:00:00+02:00",
"meldefrist": "2022-06-30T12:00:00+02:00",
"type": "forhandsutlysingsen",
"ordreId": "67289ec4-871d-4011-8bc9-c0e9de6e5a90",
"ordreMottatt": "2022-07-06T15:48:07.6328836Z",
"forretningsforer": {
"navn": "UNTL",
"adresse": {
"gateadresse": "Postboks 112 Lier",
"postnummer": "0501",
"poststed": "Oslo"
},
"epost": "[email protected]"
},
"klient": {
"klienttype": "Borettslag tilknyttet",
"organisasjonsnavn": "Skauen Borettslag",
"organisasjonsnummer": "948677202"
},
"levert": "2022-07-27T18:44:15.8474644+02:00",
"referanse": "622/1",
"eierform": "Seksjonseier"
}- antallInteressenter (number of interested) - Number of respondents to the clarification.
- varighetForkjopsrett (clarification valid through) - The date that the clarification expires
A clarification is usually valid for three months. When it expires you need a new clarification. If not the following sales message will result in a fixed price clarification. The accountant may inform the broker about this expiration using a specific response message. This basic message does not contain any product specific data fields. It will result in a message to the broker.
{
"type": "forhandsutlysingutlopt",
"ordreId": "67289ec4-871d-4011-8bc9-c0e9de6e5a90",
"forretningsforer": {
"navn": "UNTL",
"adresse": {
"gateadresse": "Postboks 112 Lier",
"postnummer": "0501",
"poststed": "Oslo"
},
"epost": "[email protected]"
},
"klient": {
"klienttype": "Borettslag tilknyttet",
"organisasjonsnavn": "Skauen Borettslag",
"organisasjonsnummer": "948677202"
},
"levert": "2022-07-27T18:44:15.8474644+02:00",
"referanse": "622/1",
"eierform": "Seksjonseier"
}When the object has been sold the broker sends a sales message to the accountant. This request message contains all the necessary information needed for updating data and proceed with clarification and board approval.
After issuing a sale message order the system expects up to three unique response messages:
When sending:
salgsmelding
The following responses can be used once, in order of appearance:
salgsmeldingmottatt (optional - clarifies process, can be omitted if no process is needed)
salgsmeldingoppdatering (optional - can be sent before board approval process completed)
salgsmeldingfullfort (required - expected at the end of the process - marks sale process completed)
An example json request can look like this:
{
"type": "salgsmelding",
"ordreId": "60dbe743-3edf-44f4-92e5-0922dd82ba6e",
"oppdragsnummer": "8-0148/23",
"registerenhet": {
"type": "matrikkel",
"ident": "3802-71-119-0-21"
},
"bestiller": {
"id": "TBF",
"navn": "Broker Doe",
"epost": "[email protected]",
"telefon": "79119911"
},
"meglerkontor": {
"orgnr": "987654323",
"avdelingsnr": "3",
"navn": "Avdeling3",
"adresse": {
"gateadresse": "Testvei 3",
"postnummer": "0030",
"poststed": "OSLO"
},
"telefon": "12345678"
},
"kontaktperson": {
"id": "AO",
"navn": "Anne Olsen",
"epost": "[email protected]",
"telefon": "12548630"
},
"kjopere": [{
"id": "12345",
"fornavn": "Ola",
"etternavn": "Nordmann",
"adresse": {
"gateadresse": "Testveg 1",
"postnummer": "0010",
"poststed": "OSLO"
},
"epost": "[email protected]",
"telefon": "12345678",
"eierbrok": {
"teller": 1,
"nevner": 1
}
}],
"selgere": [{
"id": "54321",
"organisasjonsnavn": "Kari Nordmann AS",
"kontaktperson": "Kari Nordmann",
"adresse": {
"gateadresse": "Testveg 2",
"postnummer": "0010",
"poststed": "OSLO"
},
"epost": "[email protected]",
"telefon": "12345678",
"eierbrok": {
"teller": 1,
"nevner": 1
}
}],
"salg": {
"kjopesum": 2990000,
"datoAkseptBud": "2022-06-30T12:00:00+02:00",
"datoOverdragelse": "2022-09-01T12:00:00+02:00",
"forbeholdBud": "Innbo og parkeringsplass medfølger"
},
"bolig": {
"prom": 60,
"bra": 70,
"braI": 65,
"braE": 2,
"braB": 3,
"bta": 50,
"antallRom": 4,
"antallSoverom": 2,
"energibokstav": "F",
"energifargekode": "G",
"heis": false,
"veranda": true,
"parkering": "",
"oppvarming": "",
"adresse": {
"gateadresse": "Strandgaten 3",
"postnummer": 5000,
"poststed": "Bergen"
},
"leilighetsnummer": "H0101"
}
}- oppdragsnummer - assignment number in the broker system
- kjopere (buyers) - list of persons or organizations. The structure also includes eierbrok (ownership fraction):
- id - (identification) - A unique number that identifies the buyer, can be personal number or organization number
- fornavn (first name) - Required for persons
- etternavn (surname) - Required for persons
- organisasjonsnavn (organization name) - Required for organizations
- kontaktperson (contact person) - Required for organizations
- adresse (address) - The address of the person or organization
- gateadresse (street address) - The street address with number and letter
- postnummer (postal number) - The postal number of the address
- poststed (postal place) - The postal place name of the address
- epost (e-mail) - The contact e-mail
- telefon (phone) - The contact phone number
- eierbrok (ownership fraction) - defines how large fraction this person will get
- teller (numerator)
- nevner (denominator)
- selgere (sellers) - list of persons. Same structure as buyers.
- salg (sale) - information about the sale
- kjopesum (purchase price) - What the object was sold for
- datoAkseptBud (bid accepted date) - The date the bid was accepted
- datoOverdragelse (transfer date) - The date the object will be transferred
- forbeholdBud (bid reservation) - Any special considerations for the bid as free text
- bolig (housing) - information about the object. Fetched from broker system
- prom (sum primærrom)
- bra (sum bruksareal)
- braI (sum internt bruksareal)
- braE (sum eksternt bruksareal)
- braB (sum innglasset balkong)
- braS (sum salgbart bruksareal, brukes for næring)
- bta (bruttoareal)
- tba (sum terrasse- og balkongareal/åpent areal)
- srom (sum sekundærrom)
- antallRom (number of rooms)
- antallSoverom (number of bedrooms)
- energibokstav (energy letter) - How energy efficient the object is (A-G)
- energifargekode (energy color code) - (green, lightgreen, yellow, orange, red)
- heis (elevator) - If the object has an elevator (true/false)
- veranda (balcony) - If the object has a balcony (true/false)
- parkering (parking) - Text field about parking
- oppvaring (heating) - Text field about heating
- adresse (address) - housing address
- leilighetsnummer (apartment number)
After receiving and processing the sales request message a message received an immediate response with information about what will be done:
{
"ordreId": "60dbe743-3edf-44f4-92e5-0922dd82ba6e",
"type": "salgsmeldingmottatt",
"ordreMottatt": "2022-01-06T15:48:07.6328836Z",
"klient": {
"klienttype": "Borettslag tilknyttet",
"organisasjonsnavn": "Skauen Borettslag",
"organisasjonsnummer": "948677202"
},
"levert": "2022-06-30T12:00:00+02:00",
"referanse": "1571/2",
"eierform": "Seksjonseier",
"forretningsforer": {
"navn": "UNTL",
"adresse": {
"gateadresse": "Postboks 112 Lier",
"postnummer": "0501",
"poststed": "Oslo"
},
"epost": "[email protected]"
},
"harForkjopsrett": true,
"forkjopsrett": {
"typeAvklaring": "fastpris",
"statusForhandsutlysing": "ikke_forhandsutlysing",
"utlysingsdato": "2022-07-02T12:00:00+02:00",
"utlysingssted": "https://untl.no",
"meldefrist": "2022-07-12T12:00:00+02:00"
},
"styregodkjenningPakrevd": true,
"styregodkjenning": {
"handteresAvForretningsforer": true,
"initiertDato": "2022-07-12T12:00:00+02:00",
"meldefrist": "2022-07-22T12:00:00+02:00"
},
"tilknyttetLag": true
}- ordreMottatt (order received date) - when the sale message was received
- harForkjopsrett (has right of first refusal) - true if clarification needed
- forkjopsrett (clarification) - if clarification needed
- typeAvklaring (type of clarification) - if this block is needed the field may be Fastpris or Forhåndsutlyst
- statusForhandsutlysing (status clarification) - if previous clarification has been done and with what status
- utlysingsdato - see clarification response
- utlysingssted - see clarification response
- meldefrist - see clarification response
- styregodkjenningPakrevd (required) - true if board approval is needed
- styregodkjenning (board approval) - if board approval is needed
- handteresAvForretningsforer (handled by accountant) - true if handled by the accountant. If false no other fields should be filled out in styregodkjenning
- initiertDato (date initialised) - The date the board will be notified
- meldefrist (deadline) - The date the board needs to respond before
- tilknyttetlag (connected to a cooperative)
After clarification and change of ownership has been handled by the accountant an intermediate message may be
sent containing everything except the board approval status. Please note that this message is not considered
to be the final message. Every sale order is closed with the salgsmeldingfullfort message:
{
"ordreId": "60dbe743-3edf-44f4-92e5-0922dd82ba6e",
"type": "salgsmeldingoppdatering",
"ordreMottatt": "2022-01-06T15:48:07.6328836Z",
"klient": {
"klienttype": "Borettslag tilknyttet",
"organisasjonsnavn": "Skauen Borettslag",
"organisasjonsnummer": "948677202"
},
"levert": "2022-01-22T12:00:00+02:00",
"referanse": "1571/2",
"eierform": "Seksjonseier",
"forretningsforer": {
"navn": "UNTL",
"adresse": {
"gateadresse": "Postboks 112 Lier",
"postnummer": "0501",
"poststed": "Oslo"
},
"epost": "[email protected]",
"epostRestanse": "[email protected]"
},
"styregodkjenningPakrevd": true,
"harForkjopsrett": true,
"forkjopsrett": {
"statusForkjopsrett": "benyttet",
"typeAvklaring": "fastpris",
"statusForhandsutlysing": "med_interessenter",
"utlysingsdato": "2022-01-07T12:00:00+02:00",
"andreHensyn": "Tekst om andre hensyn kommer her"
},
"kjopere": [
{
"id": "01010112345",
"fornavn": "Ole",
"etternavn": "Duck",
"epost": "[email protected]",
"adresse": {
"gateadresse": "Testvegen 1",
"postnummer": "9999",
"poststed": "Test"
},
"telefon": "12345678",
"eierbrok": {
"teller": 1,
"nevner": 2
}
},
{
"id": "01010154321",
"fornavn": "Dole",
"etternavn": "Duck",
"epost": "[email protected]",
"adresse": {
"gateadresse": "Testvegen 1",
"postnummer": "9999",
"poststed": "Test"
},
"telefon": "12345678",
"eierbrok": {
"teller": 1,
"nevner": 2
}
}
]
}Later, when all the processes like clarification and board approval has been completed a final response is sent:
{
"ordreId": "60dbe743-3edf-44f4-92e5-0922dd82ba6e",
"type": "salgsmeldingfullfort",
"ordreMottatt": "2022-01-06T15:48:07.6328836Z",
"klient": {
"klienttype": "Borettslag tilknyttet",
"organisasjonsnavn": "Skauen Borettslag",
"organisasjonsnummer": "948677202"
},
"levert": "2022-01-22T12:00:00+02:00",
"referanse": "1571/2",
"eierform": "Seksjonseier",
"forretningsforer": {
"navn": "UNTL",
"adresse": {
"gateadresse": "Postboks 112 Lier",
"postnummer": "0501",
"poststed": "Oslo"
},
"epost": "[email protected]",
"epostRestanse": "[email protected]"
},
"styregodkjenningPakrevd": true,
"styregodkjenning": {
"handteresAvForretningsforer": true,
"statusStyregodkjenning": "godkjent_av_styret",
"andreHensyn": "Tekst om andre hensyn kommer her"
},
"harForkjopsrett": true,
"forkjopsrett": {
"statusForkjopsrett": "benyttet",
"typeAvklaring": "fastpris",
"statusForhandsutlysing": "med_interessenter",
"utlysingsdato": "2022-01-07T12:00:00+02:00",
"andreHensyn": "Tekst om andre hensyn kommer her"
},
"kjopere": [
{
"id": "01010112345",
"fornavn": "Ole",
"etternavn": "Duck",
"epost": "[email protected]",
"adresse": {
"gateadresse": "Testvegen 1",
"postnummer": "9999",
"poststed": "Test"
},
"telefon": "12345678",
"eierbrok": {
"teller": 1,
"nevner": 2
}
},
{
"id": "01010154321",
"fornavn": "Dole",
"etternavn": "Duck",
"epost": "[email protected]",
"adresse": {
"gateadresse": "Testvegen 1",
"postnummer": "9999",
"poststed": "Test"
},
"telefon": "12345678",
"eierbrok": {
"teller": 1,
"nevner": 2
}
}
]
}- styregodkjenning (board approval)
- statusStyregodkjenning - filled out if handled by the accountant
- "godkjent_av_styret" - approved by the board
- "avvist_av_styret" - not approved by the board
- "godkjent_av_bbl" - approved by the accountant
- "avvist_av_bbl" - not approved by the accountant
- "frist_utlopt" - no response from board, handled as approved
- andreHensyn (considerations) - Description of things to consider
- statusStyregodkjenning - filled out if handled by the accountant
- forkjopsrett (advance clarification)
- statusForkjopsrett
- "ikke_benyttet" - the initial buyers acquired the object
- "benyttet" - one of the preemption respondents acquired the object
- andreHensyn (considerations) - Description of things to consider
- statusForkjopsrett
- kjopere (buyers) - List of buyers registered by the business manager
The transfer date might change after the initial sales message has been sent from the broker to the accountant. If this happens this message can be used to inform about the change.
{
"type": "endringoverdragelse",
"ordreId": "1888e14e-1418-4d37-b3be-0d0b623681ba",
"oppdragsnummer": "8-0148/23",
"registerenhet": {
"type": "matrikkel",
"ident": "3802-71-119-0-21"
},
"bestiller": {
"id": "TBF",
"navn": "Broker Doe",
"epost": "[email protected]",
"telefon": "79119911"
},
"meglerkontor": {
"orgnr": "987654323",
"avdelingsnr": "3",
"navn": "Avdeling3",
"adresse": {
"gateadresse": "Testvei 3",
"postnummer": "0030",
"poststed": "OSLO"
},
"telefon": "12345678"
},
"kontaktperson": {
"id": "AO",
"navn": "Anne Olsen",
"epost": "[email protected]",
"telefon": "12548630"
},
"salgsmeldingOrdreId": "60dbe743-3edf-44f4-92e5-0922dd82ba6e",
"datoOverdragelse": "2024-02-01T12:00:00+02:00"
}The change of transfer date is a very simple change on the accountant side and the response will tell if the change will been done or not:
{
"ordreId": "1888e14e-1418-4d37-b3be-0d0b623681ba",
"type": "endringoverdragelse",
"forretningsforer": {
"navn": "UNTL",
"adresse": {
"gateadresse": "Postboks 112 Lier",
"postnummer": "0501",
"poststed": "Oslo"
},
"epost": "[email protected]"
},
"klient": {
"klienttype": "Borettslag tilknyttet",
"organisasjonsnavn": "Skauen Borettslag",
"organisasjonsnummer": "948677202"
},
"levert": "2022-07-08T14:48:03.7537667+00:00",
"referanse": "622/1",
"eierform": "Seksjonseier",
"datoEndret": false,
"avvisningsarsak": "Dato passert"
}There are two new fields in this message:
- datoEndret - true if date was changed, false if not
- avvisningsarsak - optional text field to explain the reason for not changing the transfer date
This product is in development
When the ownership transfer process is complete the broken can send a message to the accountant to inform about this. The accountant can then accept the change.
{
"type": "sluttbrev",
"ordreId": "30db5678-345f-4dh4-92e5-09d2dh82dase",
"oppdragsnummer": "8-0148/23",
"registerenhet": {
"type": "matrikkel",
"ident": "3802-71-119-0-21"
},
"bestiller": {
"id": "TBF",
"navn": "Broker Doe",
"epost": "[email protected]",
"telefon": "79119911"
},
"meglerkontor": {
"orgnr": "987654323",
"avdelingsnr": "3",
"navn": "Avdeling3",
"adresse": {
"gateadresse": "Testvei 3",
"postnummer": "0030",
"poststed": "OSLO"
},
"telefon": "12345678"
},
"kontaktperson": {
"id": "AO",
"navn": "Anne Olsen",
"epost": "[email protected]",
"telefon": "12548630"
},
"tinglysteEiere": [
{
"id": "12345",
"fornavn": "Ola",
"etternavn": "Nordmann",
"adresse": {
"gateadresse": "Testveg 1",
"postnummer": "0010",
"poststed": "OSLO"
},
"epost": "[email protected]",
"telefon": "12345678",
"eierbrok": {
"teller": 1,
"nevner": 1
}
}
],
"registerforteEiere": [
{
"id": "12345",
"fornavn": "Ola",
"etternavn": "Nordmann",
"adresse": {
"gateadresse": "Testveg 1",
"postnummer": "0010",
"poststed": "OSLO"
},
"epost": "[email protected]",
"telefon": "12345678",
"eierbrok": {
"teller": 1,
"nevner": 1
}
}
],
"datoOverdragelse": "2022-09-01T12:00:00+02:00",
"forkjopsrettAvklart": true,
"styregodkjenningAvklart": true
}New fields:
- tinglysteEiere - list of owners registered in the land register
- registerforteEiere - list of owners registered in the register
- forkjopsrettAvklart - true if right of first refusal has been clarified
- styregodkjenningAvklart - true if board approval has been clarified
The response here is a confirmation that the final letter has been processed.
{
"ordreId": "30db5678-345f-4dh4-92e5-09d2dh82dase",
"type": "sluttbrevbehandlet",
"ordreMottatt": "2022-07-08T14:48:03.7753374Z",
"klient": {
"klienttype": "Borettslag tilknyttet",
"organisasjonsnavn": "Skauen Borettslag",
"organisasjonsnummer": "948677202"
},
"levert": "2022-07-08T14:48:03.7537667+00:00",
"referanse": "622/1",
"eierform": "Seksjonseier"
}Not yet designed
Errors might happen. If we get into a situation where the responding system needs to send an error the following message may be used:
{
"tidspunkt": "2022-07-08T14:48:03.7753374Z",
"kansellert": true,
"feilmelding": "Forrige forhåndsutlysing-request har ikke utløpt ennå.",
"feilkode": 3,
"type": "feil",
"ordreId": "60dbe743-3edf-44f4-92e5-0922dd82ba6e",
"forretningsforer": {
"navn": "UNTL",
"adresse": {
"gateadresse": "Postboks 112 Lier",
"postnummer": "0501",
"poststed": "Oslo"
},
"epost": "[email protected]"
},
"klient": {
"klienttype": "Borettslag tilknyttet",
"organisasjonsnavn": "Skauen Borettslag",
"organisasjonsnummer": "948677202"
},
"levert": "2022-07-08T14:48:03.7537667+00:00",
"referanse": "622/1",
"eierform": "Seksjonseier"
}Here we include:
- feilkode (error code) - A predefined unique identifier for this error case
- feilmelding (error message) - A descriptive text explaining the error situation
- kansellert (cancelled) - A boolean field indicating if this error cancels the whole order