Orakel-dokumentasjon
Datakilder

Helsedirektoratet: skjenke- og salgsbevillinger

Bevillinger for salg av alkohol og tobakk: hvem som har lov til å selge hva, hvor.

Kildehenvisning

Kilde: Helsedirektoratet (TBR, Tobakks- og alkoholregisteret)
Data: bevillinger for salg av alkohol og tobakk
Lisens: NLOD 2.0
Kreditering påkrevd: ja, «Helsedirektoratet»
Lenke: https://tbr.helsedirektoratet.no
Oppdatering: full oppdatering ukentlig (mandag 07:00), alle tre delregistre

Hva det er

TBR er Norges sentrale register for bevillinger til salg av alkohol og tobakk. Det dekker tre delregistre: alkoholbevillinger, tobakksbevillinger og registreringer for tobakkssalg. Hver post kobles til en bedrift på orgNumber og sier hva slags bevilling det er (skjenking, salg, engros, import), hvilke varegrupper den gjelder, hvilket sted den er knyttet til, hvilken kommune som har gitt den, og hvor lenge den varer.

Orakel henter hvert register i sin helhet én gang i uken, og oppdaterer på (licenseNumber, registerType).

Felt som følger med

FeltTypeMerknad
licenseNumberheltallBevillingsnummer, eller registreringsnummer for tobakkssalg. Unikt innenfor hver registerType
orgNumbertekst (9 siffer)Organisasjonsnummeret til bevillingshaveren
holderNametekstInnehaver slik den er registrert
venueNametekstStedet bevillingen gjelder
venueOrgNumbertekstUnderenhetens organisasjonsnummer, der det avviker fra bevillingshaveren
registerTypetekstAlkoholsbevilling eller Tobakksbevilling. Både tobakksbevillinger og tobakkssalg bruker den siste
licenseTypeCode / licenseTypeDesctekstTillatelsestype, for eksempel 01SKJE (skjenking), 11ENGR (engros), 18TBIM (tobakksimport), 19TBEK (tobakkssalg)
productGroupsliste med tekstVaregrupper: GRP1 (øl til og med 4,7 prosent), GRP2 (vin fra 4,7 til 22 prosent), GRP3 (brennevin over 22 prosent), TROY (røyketobakk), TINN (tobakk til annet bruk)
address / postnr / poststedtekstStedets adresse
municipality / municipalityNotekstKommunen som har gitt bevillingen, med navn og firesifret SSB-kode
validFrom / validTodatoBevillingens gyldighetsperiode
syncedAttidspunktSist gang Orakel oppdaterte posten

Endepunkter som gir deg dette

  • GET /api/licenses: søk i bevillinger. Filtrer på orgNumber, registerType, licenseTypeCode, municipalityNo eller activeOnly=true (gyldig til og med i dag). Med markørsidevisning.

Begrensninger

  • Dekker bare de som har bevilling. De aller fleste norske bedrifter har ingen post i TBR.
  • Ordlisten for bevillingstyper følger Helsedirektoratets egen ordning. Enkeltkommuner har sine særegenheter hos kilden, og de omskrives ikke her.
  • Utløpte bevillinger beholdes. Bruk activeOnly=true, eller filtrer på validTo, for å utelate dem.

Verdt å vite

  • Én bedrift kan ha mange bevillinger, én per sted og per registertype. Slå sammen på orgNumber framfor å regne med én rad.
  • venueOrgNumber kan avvike fra orgNumber: morselskapet har bevillingen, underenheten er det fysiske stedet. Verdien "0" hos kilden gjøres om til tom verdi.
  • Noen poster for tobakkssalg bærer registreringsnummer i stedet for bevillingsnummer. Begge havner i licenseNumber, og registerType skiller dem.