EVRY AS. Funksjonell feltbeskrivelse for Enhetsregisteret

Transkript

1 EVRY AS Funksjonell feltbeskrivelse for Enhetsregisteret

2 Innholdsfortegnelse 1 Innledning Hensikten med dette dokumentet Overordnet tjenestebeskrivelse Produkter Årsregnskap (Aarsregnskap) Request Aarsregnskap (hentaarsregnskap) Respons Aarsregnskap Basisinformasjon (Basisdata / BasisdataFdato) Request Basisdata / BasisdataFdato (hentbasisdata / hentbasisdatafdato) Respons Basisdata / BasisdataFdato Basisinformasjon mini (BasisdataMini) Request BasisdataMini (hent BasisdataMini) Respons BasisdataMini Juridisk enhet med bedrifter (BedrifterVirksomheter) Request BedrifterVirksomheter (hentbedriftervirksomheter) Respons BedrifterVirksomheter BekreftelseKonkursregisteret Request BekreftelseKonkursregisteret (hentbekreftelsekonkursregisteret) Respons BekreftelseKonkursregisteret Bestillingsstatus Request Bestillingsstatus (hentbestillingsstatus) Respons Bestillingsstatus Generell informasjon om bedrift (EnBedriftVirksomhet) Request EnBedriftVirksomhet (hent EnBedriftVirksomhet) Respons EnBedriftVirksomhet Firmaattest (FirmaattestEngelskSignert / FirmaattestSignert) Request Firmaattest (hentfirmaattest) Respons Firmaattest Firmaattest på skjerm (FirmaattestOnline) Request FirmaattestOnline (hentfirmaattestonline) Respons FirmaattestOnline Grunndata Request Grunndata (hent Grunndata) Respons Grunndata Konsernstruktur (Konsern) Request Konsern (hent Konsern) Respons Konsern Kontaktdata EDB ErgoGroup AS Side 2 av 3

3 Request Kontaktdata (hent Kontaktdata) Respons Kontaktdata Navnesøk (Navneliste) Request Navneliste (hent Navneliste) Respons Navneliste Opplysninger fra tilknyttet register (OpplTilknRegister) Request OpplTilknRegister (hent OpplTilknRegister) Respons OpplTilknRegister Prokura/Signatur (ProkuraSignatur / ProkuraSignaturFdato) Request ProkuraSignatur / ProkuraSignaturFdato (hent ProkuraSignatur / ProkuraSignaturFdato) Respons ProkuraSignatur / ProkuraSignaturFdato Register utskrift (Registerutskrift / RegisterutskriftFdato) Request Registerutskrift / RegisterutskriftFdato (hent Registerutskrift / RegisterutskriftFdato) Respons Registerutskrift / RegisterutskriftFdato Roller i firma (Roller / RollerFdato) Request Roller / RollerFdato (hent Roller / RollerFdato) Respons Roller / RollerFdato Rollesøk i Foretaksregisteret (Rolleutskrift) Request Rolleutskrift (hent Rolleutskrift) Respons Rolleutskrift Særlige opplysninger (SaerligeOpplysninger) Request SaerligeOpplysninger (SaerligeOpplysninger) Respons SaerligeOpplysninger Globale definisjoner Leveringsadresse Kodeforklaring Leveringsmåte EDB ErgoGroup AS Side 3 av 3

4 1 Innledning 1.1 Hensikten med dette dokumentet Hensikten med dette dokumentet er å gi en oversikt over innhold i tjenesten Enhetsregisteret. Alle produkter er beskrevet. Det angis innhold på funksjonelt nivå, gruppert på de enkelte produkter. Dette dokumentet skal være tilstrekkelig til å avklare nødvendig innhold for implementering av tjenesten. 1.2 Overordnet tjenestebeskrivelse Tjenesten gir tilgang til de produktene som tilbys av webservices grensesnittet ved Brønnøysundregistrene. Dette er produkter som gir opplysninger om registrerte enheter og muligheter for å bestille utskrifter, attester og årsregnskap. Bruksområder Identifisere enheter og foretak. Oversikt over ansvarlige personer i enhet og foretak. Bestille firmaattest og årsregnskap. Dataeier Brønnøysundregistrene Søknad om tilgang Registeret er åpent for alle. EVRY AS Side 1 av 18

5 2 Produkter Nedenfor angis innhold i alle produkter. Det er opplistet feltinnhold med tilhørende beskrivelse samt henvisning til benevnelse i XML-dokument. For oppslag angis om feltet er mandatory eller optional dvs. om feltet må fylles ut ved oppslag eller om dette er valgfritt. 2.1 Årsregnskap (Aarsregnskap) Produktet Aarsregnskap gir mulighet for å bestille et komplett årsregnskap. Regnskapet leveres elektronisk ved at bestilleren mottar en epost med en lenke til et pdf-dokument som kan lastes ned Request Aarsregnskap (hentaarsregnskap) Aarsregnskap Orgnr til den enheten man ønsker å bestille regnskapet til Årstall Årstall for det regnskapet man ønsker å bestille. Format: ÅÅÅÅ Leveringsadresse Se kap 3.1 M M M orgnr aar Respons Aarsregnskap Aarsregnskap Status status Referansenummer Feiltekst referanse feiltekst 2.2 Basisinformasjon (Basisdata / BasisdataFdato) Produktet Basisdata / BasisdataFdato gir en oversikt over basis informasjonselementer som finnes registrert på hovedenheter i Enhetsregisteret. Produktene er helt like bortsett fra at Basisdata returnerer fødselsnummer på personer mens BasisdataFdato returnerer fødselsdato. Basisdata (fødselsnummer) er kun tilgjengelig for bruk av offentlig myndighet. EVRY AS Side 2 av 18

6 2.2.1 Request Basisdata / BasisdataFdato (hentbasisdata / hentbasisdatafdato) Basisdata / BasisdataFdato 9 sifret organisasjonsnummer. Skrives fortløpende uten mellomrom, el. M orgnr Respons Basisdata / BasisdataFdato Basisdata / BasisdataFdato Hovedstatus Gir status på spørringen hovedstatus Tilhører hovedstatus understatus Statusmelding Inkl regdato. organisasjonsnummer Navn Består av inntil 5 felter Inkl. regdato navn1, navn2, navn3, navn4 og navn5 Forretningsadresse Inkl. regdato adresse1, adresse2 og adresse3. postnr, poststed, kommunenummer, kommune, landkode, land Postadresse Inkl. regdato adresse1, adresse2 og adresse3. postnr, poststed, kommunenummer, kommune, landkode, land Organisasjonsform Formål Stiftelsesdato orgform, orgformbeskrivelse virksomhetartbransje, vedtektsfestetformaal stiftelsesdato Målform Reklame maalformkode, maalformtekst reklamekode, reklametekst Kontaktperson Rolle beskrivelse, rolletype EVRY AS Side 3 av 18

7 Person Enhet beskrivelse, rolletype, fodselsnr/fodselsdato, fornavn, mellomnavn, slektsnavn, adresse, postnr, poststed, land, valgtav, ansvarsandel, fratraadt, revisorkategori, revisorrkode orgnr, navn, adresse, postnr, poststed, land, valgtav, ansvarsandel, fratraadt, revisorkategori, revisorrkode Hovedforetak Foretak Register organisasjonsnummer, navn, forretningsadresse, organisasjonsform, lovgivendeland registreringsnummer, navn, postadresse 2.3 Basisinformasjon mini (BasisdataMini) Produktet BasisdataMini gir opplysninger om organisasjonsnummer, navn, forretningsadresse og postadresse på hovedenheter registrert i Enhetsregisteret Request BasisdataMini (hent BasisdataMini) BasisdataMini 9 sifret organisasjonsnummer. Skrives fortløpende uten mellomrom, el. M orgnr Respons BasisdataMini BasisdataMini Hovedstatus hovedstatus Statusmelding understatus Inkl regdato. organisasjonsnummer Navn Består av inntill 5 felter navn1, navn2, navn3, EVRY AS Side 4 av 18

8 Inkl. regdato navn4 og navn5 Forretningsadresse Inkl. regdato adresse1, adresse2 og adresse3. postnr, poststed, kommunenummer, kommune, landkode, land Postadresse Inkl. regdato adresse1, adresse2 og adresse3. postnr, poststed, kommunenummer, kommune, landkode, land 2.4 Juridisk enhet med bedrifter (BedrifterVirksomheter) Produktet BedrifterVirksomheter gir en oversikt over de bedrifter/virksomheter (underenheter) som finnes registrert på en enhet i Enhetsregisteret Request BedrifterVirksomheter (hentbedriftervirksomheter) Bedrifter Virksomheter 9 sifret organisasjonsnummer. Skrives fortløpende uten mellomrom, el. M orgnr Respons BedrifterVirksomheter Bedrifter Virksomheter Hovedstatus Statusmelding organisasjonsnummer hovedstatus understatus Juridisk Enhet Opplysninger om hovedenhet organisasjonsnummer, organisasjonsform, navn, forretningsadresse, Bedrift/Virksomhet Opplysninger om underenheter tilknyttet angitt hovedenhet organisasjonsnummer, organisasjonsform, navn, beliggenhetsadresse, postadresse, naeringskoder EVRY AS Side 5 av 18

9 2.5 BekreftelseKonkursregisteret Her kan man bestille en bekreftelse fra Konkursregisteret Request BekreftelseKonkursregisteret (hentbekreftelsekonkursregisteret) Bekreftelse Konkursregisteret Organisasjonsnumme r Orgnr til den enheten man ønsker å bestille bekreftelse på. Leveringsadresse Se kap 3.1 M M orgnr Respons BekreftelseKonkursregisteret Bekreftelse Konkursregisteret Status Referansenummer Feiltekst status referanse feiltekst 2.6 Bestillingsstatus Viser status på et bestillingsprodukt Request Bestillingsstatus (hentbestillingsstatus) Bestillingsstatus Referansenummer M referanse Respons Bestillingsstatus Bestillingsstatus Referanse Produkt Bestillingsstatus referanse produkt bestillingsstatus, bestillingsstatustekst EVRY AS Side 6 av 18

10 Leveringsmåte Leveringsstatus Levert leveringsmaate, leveringsmaatetekst leveringsstatus, leveringsstatus levert 2.7 Generell informasjon om bedrift (EnBedriftVirksomhet) Produktet EnBedriftVirksomhet gir opplysninger om en underenhet og knytning til juridisk enhet Request EnBedriftVirksomhet (hent EnBedriftVirksomhet) EnBedriftVirkso mhet 9 sifret organisasjonsnummer. Skrives fortløpende uten mellomrom, el. M orgnr Respons EnBedriftVirksomhet EnBedriftVirkso mhet Hovedstatus BedriftVirksomhet Juridisk enhet organisasjonsnummer hovedstatus understatus, organisasjonsnummer, organisasjonsform, navn, beliggenhetsadresse, postadresse, naeringskoder, oppstartsdato, eierskiftedato, antall ansatte, saerligeopplysninger, telefonnummer, telefaksnummer, mobiltelefonnummer, epostadresse, hjemmesideadresse, reklame organisasjonsnummer, organisasjonsform, navn, forretningsadresse EVRY AS Side 7 av 18

11 2.8 Firmaattest (FirmaattestEngelskSignert / FirmaattestSignert) Disse produktene gir mulighet for å bestille ulike typer firmaattester. Her har vi kun beskrevet produktet for å hente vanlig Firmaattest. De andre produktene er helt like. Det er bare å bytte ut produktnavnet for å bestille de andre typene Request Firmaattest (hentfirmaattest) Firmaattest Orgnr til den enheten man ønsker å bestille regnskapet til Leveringsadresse Se kap 3.1 M M orgnr Respons Firmaattest Firmaattest Status status Referansenummer Feiltekst referanse feiltekst 2.9 Firmaattest på skjerm (FirmaattestOnline) Dette produktet henter frem alle informasjonselementene/produktene som inngår i en tradisjonell firmaattest. For beskrivelse av svarelementene henvises det til de respektive kapitler der disse produktene står beskrevet Request FirmaattestOnline (hentfirmaattestonline) Firmaattest Online Orgnr til den enheten man ønsker å bestille regnskapet til M orgnr Respons FirmaattestOnline Firmaattest Online Status Basisinformasjon se eget kapitel status Juridisk enhet med bedrifter se eget kapitel EVRY AS Side 8 av 18

12 Kontaktdata Opplysninger fra tilknyttet register Prokura/Signatur i firma Roller i firma Særlige opplysninger se eget kapitel se eget kapitel se eget kapitel se eget kapitel se eget kapitel 2.10 Grunndata Produktet Grunndata gir utvalgte opplysninger hentet fra lokal indeksdatabase hos ErgoGroup AS Request Grunndata (hent Grunndata) Grunndata M orgnr Respons Grunndata Grunndata organisasjonsnummer Hovedstatus Navn Forretningsadresse Postadresse Organisasjonsform Stiftelsesdato Slettet dato Endret dato Hovedenhet Næringskoder hovedstatus understatus, navn forretningsadresse postadresse organisasjonsform stiftelsesdato slettetdato endretdato orgnr, navn, postnr, poststed kode, beskrivelse EVRY AS Side 9 av 18

13 2.11 Konsernstruktur (Konsern) Produktet Konsern gir en oversikt over konsernrelasjonene mellom enhetene Request Konsern (hent Konsern) Konsern M orgnr Respons Konsern Konsern organisasjonsnummer Hovedstatus hovedstatus understatus, 2.12 Kontaktdata Produktet Kontaktdata gir opplysninger om telefon, telefaks, epost og hjemmeside Request Kontaktdata (hent Kontaktdata) Kontaktdata M orgnr Respons Kontaktdata Kontaktdata organisasjonsnummer Hovedstatus hovedstatus EVRY AS Side 10 av 18

14 Telefonnummer Telefaksnummer Mobiltelefonnummer Epostadresse Hjemmeside understatus, telefonnummer telefaksnummer mobiltelefonnummer epostadresse hjemmesideadresse 2.13 Navnesøk (Navneliste) Produktet Navneliste gir muligheten for å gjøre et navnesøk mot Enhetsregisteret Request Navneliste (hent Navneliste) Navneliste Navn M navn Fonetisk Fonetisk eller Eksakt søk M fonetisk Fylke, kommune, post Filter for geografi O fylkesnr, kommunenr, postnr Næringskode O naeringskode Tilgjengelighet O tilgjengelighet Respons Navneliste Navneliste Status Ok, ingen, flere statuskode, statustekst Antall antall Navn Enhetstype Postnummer Poststed Kommunenummer Kommune Tilgjengelighet orgnr navn enhetstype postnr poststed kommunenr kommune tilgjengelighet EVRY AS Side 11 av 18

15 Slettet dato Historisk treff Orgnr hovedenhet Navn hovedenhet Postnr hovedenhet Poststed hovedenhet slettetdato histtreff orgnr navn postnr poststed 2.14 Opplysninger fra tilknyttet register (OpplTilknRegister) Produktet Opplysninger fra tilknyttet register gir opplysninger om næringskoder, sektorkode, aksjekapital, etc Request OpplTilknRegister (hent OpplTilknRegister) OpplTilknRegist er M orgnr Respons OpplTilknRegister OpplTilknRegist er Hovedstatus Næringskoder Sektorkode Ansvarskapital Antall ansatt Vedtektsdato organisasjonsnummer hovedstatus understatus, kode, beskrivelse kode, beskrivelse kapitaltype, valuta, innbetaling, bundetks antall vedtektsdato EVRY AS Side 12 av 18

16 2.15 Prokura/Signatur (ProkuraSignatur / ProkuraSignaturFdato) Produktet gir opplysninger om hvem som er registrert med prokura eller signatur Request ProkuraSignatur / ProkuraSignaturFdato (hent ProkuraSignatur / ProkuraSignaturFdato) ProkuraSignatur / ProkuraSignatur Fdato M orgnr Respons ProkuraSignatur / ProkuraSignaturFdato ProkuraSignatur / ProkuraSignatur Fdato Hovedstatus Prokura / Signatur Rolle Person Enhet organisasjonsnummer hovedstatus understatus, beskrivelse, rolletype beskrivelse, rolletype, fodselsnr/fodselsdato, fornavn, mellomnavn, slektsnavn, adresse, postnr, poststed, land, valgtav, ansvarsandel, fratraadt, revisorkategori, revisorrkode orgnr, navn, adresse, postnr, poststed, land, valgtav, ansvarsandel, fratraadt, revisorkategori, revisorrkode EVRY AS Side 13 av 18

17 2.16 Register utskrift (Registerutskrift / RegisterutskriftFdato) Produktene Registerutskrift / RegisterutskriftFdato gir muligheten for å bestille en registerutskrift med eller uten fødselsnummer fra Brønnøysundregistrene. Utskrift med fødselsnummer er forbeholdt offentlig myndighet Request Registerutskrift / RegisterutskriftFdato (hent Registerutskrift / RegisterutskriftFdato) Registerutskrift / Registerutskrift Fdato M orgnr Leveringsadresse Se kapittel 3.1 M leveringsadresse Respons Registerutskrift / RegisterutskriftFdato Registerutskrift / Registerutskrift Fdato Status Referansenummer Feiltekst status referanse feiltekst 2.17 Roller i firma (Roller / RollerFdato) Produktet gir opplysninger om hvilke roller som er registrert på en enhet. Opplysninger om fødselsnummer på rollehaver er forbeholdt offentlig myndighet Request Roller / RollerFdato (hent Roller / RollerFdato) Roller / RollerFdato M orgnr Respons Roller / RollerFdato Roller / RollerFdato Hovedstatus organisasjonsnummer hovedstatus EVRY AS Side 14 av 18

18 understatus, Kontaktperson, Deltakere, Komplementar, Sameiere, Styre, Revisor, Regnskapfører, Eierkommune, Rolle Person Enhet beskrivelse, rolletype beskrivelse, rolletype, fodselsnr/fodselsdato, fornavn, mellomnavn, slektsnavn, adresse, postnr, poststed, land, valgtav, ansvarsandel, fratraadt, revisorkategori, revisorrkode orgnr, navn, adresse, postnr, poststed, land, valgtav, ansvarsandel, fratraadt, revisorkategori, revisorrkode 2.18 Rollesøk i Foretaksregisteret (Rolleutskrift) Produktet Rolleutskrift er det samme som Rollesøk. Det gir oversikt over innførte roller i Foretaksregisteret og innførte roller i tilknytning til næringsvirksomhet i Enhetsregisteret Request Rolleutskrift (hent Rolleutskrift) Rolleutskrift Fødselsnummer 11 sifret fødselsnummer. Skrives fortløpende uten mellomrom, punktum, el. O foedselsnr O orgnr Respons Rolleutskrift Rolleutskrift, Fødselsnummer Hovedstatus orgnr, fodselsnr hovedstatus understatus, EVRY AS Side 15 av 18

19 Rolleinnehaver Roller orgnr/fodselsnr/fodselsdato, navn, adresse rollebeskrivelse, orgnr, navn, forretningsadresse, postadresse 2.19 Særlige opplysninger (SaerligeOpplysninger) Produktet Særlige opplysninger gir informasjon om i hvilke registre en enhet er registrert. Det gir også opplysninger om status på enheten og eventuelle fusjonspartnere Request SaerligeOpplysninger (SaerligeOpplysninger) SaerligeOpplysni nger M orgnr Respons SaerligeOpplysninger SaerligeOpplysni nger Hovedstatus Særlige opplysninger organisasjonsnummer hovedstatus understatus, paategning, tekstlinje EVRY AS Side 16 av 18

20 3 Globale definisjoner Her angis definisjoner av elementer som benyttes i flere ulike produkter og spørringer. 3.1 Leveringsadresse Delgruppe Felt-ledetekst Beskrivelse Leveringsadresse Navn Kundenavn navn Postadresse Postnummer Poststed Land postadresse postnr poststed landkode Kontaktperson Navn på kontaktperson kontaktperson Leveringsmåte post, telefaks eller epost leveringsmaate Telefaks Epost Telefaksnummer. Angis fortløpende uten mellomrom el. telefaks epost EVRY AS Side 17 av 18

21 4 Kodeforklaring 4.1 Leveringsmåte Gyldige valg Post Epost EVRY AS Side 18 av 18