Gå til innhold

Brønnøysund — Enhetsregisteret

CRM kan slå opp et organisasjonsnummer mot Brønnøysundregistrene (Enhetsregisteret) og hente firmanavn, adresse, poststed, bransje (NACE), e-post, telefon og nettside fra det offentlige, autoritative registeret. Oppslaget kjøres manuelt fra kunde-skjemaet — det er ingen bakgrunnsjobb, ingen nøkler og ingen oppsett. Enhetsregisteret sitt API er åpent.

Egenskap Verdi
Retning Enhetsregisteret → ePortal (kun lesing fra registeret)
Kilde (oppslag) GET https://data.brreg.no/enhetsregisteret/api/enheter/{orgnr}
Kilde (navnesøk) GET https://data.brreg.no/enhetsregisteret/api/enheter?navn={q}&size=10
Autentisering Ingen (åpent API)
Utløser Manuell knapp/typeahead i CRM → Kunde
Frekvens Når en bruker velger å kjøre den

Implementasjon: api/ePortal.API/ePortal.Base/Services/BrregEnrichmentService.cs (tjeneste) og endepunktene BrregLookup / BrregSearch i api/ePortal.API/ePortal.API/Controllers/CrmCustomerController.cs. Frontend: ui/ePortal.ui/src/app/components/crm/customer-detail/customer-detail.component.ts.

Tilgang

Hvem Hva trengs
Bruker Tilgang til CRM → Kunder (samme tilgang som å redigere en kunde)
Nettverk ePortal-API må nå data.brreg.no over HTTPS

Oppslaget krever kun at brukeren er innlogget ([Authorize]); det er ingen egen tilgangsregel eller wv_DataAccess-oppføring for selve oppslaget. Å skrive de hentede verdiene til kunden går gjennom den vanlige lagre-flyten for kunder.

Hvilke felt hentes

ePortal-felt Enhetsregisteret-kilde
Aktørnavn navn
Adresse forretningsadresse.adresse[] (postadresse som reserve)
Postnummer forretningsadresse.postnummer
Poststed forretningsadresse.poststed
NACE-kode naeringskode1.kode
Bransjebeskrivelse naeringskode1.beskrivelse
E-post epostadresse
Telefon telefon
Nettside hjemmeside (får automatisk https://-prefiks hvis registerverdien mangler skjema)

Organisasjonsform (organisasjonsform.beskrivelse) hentes og vises i søket, men lagres ikke som eget felt i v1. E-post, telefon og nettside er ofte fraværende for mindre enheter — feltet fylles da ikke ut/foreslås ikke.

Brukerens egne felt — mobil, rabatt, betalings-/kredittvilkår, selger/ansvarlig, kategorier, taggene og notater — røres aldri av et oppslag. E-post, telefon og nettside overskrives derimot av et Brønnøysund-oppslag på samme måte som navn/adresse/bransje (ny kunde: fylles inn automatisk; eksisterende kunde: egen avkrysning i oppdater-dialogen). Etter en oppdatering er Brønnøysund den autoritative kilden for de feltene som ble hentet fra registeret.

Slik gjør du — ny kunde

  1. Åpne CRM → Kunder → Ny kunde.
  2. Enten:
  3. Skriv organisasjonsnummeret i feltet «Org.nr.» og klikk knappen «Br.reg» ved siden av feltet, eller
  4. Bruk søkefeltet «Søk i Brønnøysundregistrene» øverst, skriv firmanavn (minst 2 tegn) og velg riktig treff i listen.
  5. Navn, adresse, postnummer, poststed, bransje, e-post, telefon og nettside fylles inn automatisk der registeret har verdien. Fyll ut resten (mobil, rabatt osv.) og lagre som vanlig.

Slik gjør du — oppdater eksisterende kunde

  1. Åpne en eksisterende kunde som har et organisasjonsnummer.
  2. Klikk «Oppdater fra Brønnøysund» i handlingsmenyen til venstre.
  3. En dialog viser hvert felt med nåværende verdi og verdien fra Brønnøysund. Felt som er endret er huket av på forhånd.
  4. Juster avhukingen om nødvendig og klikk «Oppdater valgte». Kun de feltene du huker av oppdateres; alle andre felt på kunden beholdes uendret.

Merk: Handlingen er skjult/deaktivert når kunden ikke har et organisasjonsnummer. Er alle registerverdiene like de nåværende, får du meldingen «Ingen endringer fra Brønnøysund» og ingen dialog åpnes.

Vanlige problemer

«Fant ikke organisasjonsnummeret i Brønnøysund»

Registeret har ingen enhet på det nummeret (eller nummeret er feil/ikke 9 siffer). Kontroller organisasjonsnummeret. Ingenting endres.

«Kunne ikke hente data fra Brønnøysund»

Enhetsregisteret svarte ikke, eller ePortal-miljøet mangler utgående HTTPS-tilgang til data.brreg.no. Prøv igjen senere. Ingenting endres.

Relaterte sider