Skip to content

Storfehendelser: guide for konsumenter ​

Denne guiden er skrevet for deg som skal lese og tolke meldingene om storfeindivider. Den forklarer hvordan en melding ser ut, hvilke koder som finnes, og hva de betyr i praksis.

1. Hva er en melding? ​

Hver melding er én hendelse om ett storfeindivid – for eksempel en fødsel, en flytting, en slakting eller en rettelse. Meldingen er et JSON-objekt med faste felt øverst og en detaljer-del med fakta om individet og driftsansvarlig:

json
{
  "eventId": "33e13319-60c5-449a-ad9d-6bac10114295",
  "originalEventId": null,
  "sletteHendelse": false,
  "opprinnelsesmerke": "1234567-00042",
  "hendelsetype": "HUSDYR_FOEDSEL",
  "skjedde": "2026-03-01T00:00:00",
  "opprettet": "2026-03-02T08:15:00.123456",
  "detaljer": {
    "driftsansvarlig": { "...": "se §4" },
    "individ": { "...": "se §4" }
  }
}

I tillegg til selve JSON-innholdet gir NATS deg et eget tidsstempel og et eget sekvensnummer (seq) for hver melding på strømmen/køen. Dette er transportmetadata fra NATS selv, ikke noe som ligger inni JSON-kroppen. Det er NATS' eget sekvensnummer du skal bruke for å spore fremgang og gjenoppta lesing – ikke noe felt i JSON-kroppen. Meldingen inneholder ikke noe eget kildesystem-internt sekvensnummer.

2. Feltene i meldingen ​

FeltEksempelHva det betyr
eventId"33e13319-60c5-449a-ad9d-6bac10114295"Unik, stabil ID for hendelsen. Samme hendelse har alltid samme eventId.
originalEventIdnull eller en eventIdSatt bare når sletteHendelse er true. Peker på eventId til hendelsen som oppheves.
sletteHendelsetrue / falsetrue betyr at meldingen opphever en tidligere hendelse (se §7). false er en ordinær hendelse.
opprinnelsesmerke"1234567-00042"Individets første norske øremerke. Samme verdi finnes også i detaljer.individ.opprinnelsesmerke. Ikke nødvendigvis gjeldende merke i dag.
hendelsetype"HUSDYR_FOEDSEL"Hva slags hendelse dette er. Se kodetabellen i §3.
skjedde"2026-03-01T00:00:00"Når hendelsen faktisk skjedde (forretningstidspunkt). Rene datoer vises ved midnatt.
opprettet"2026-03-02T08:15:00.123456"Når meldingen ble opprettet i MATS – ikke når hendelsen skjedde, og ikke når du mottar den på køen.
detaljerJSON-objekt eller nullFaktapayloaden, se §4. null kun ved en bestemt type slettehendelse (§7).

Viktig om identitet: eventId er den eneste ID-en du trenger for å følge en hendelse over tid. Den endrer seg ikke selv om det underliggende objektet byttes ut ved en slettehendelse.

Merk: meldingen inneholder verken et kildesystem-internt sekvensnummer, en teknisk individ-ID, eller informasjon om hvem som rapporterte hendelsen. Du har kun feltene i tabellen over, pluss NATS' eget tidsstempel og sekvensnummer.

3. Hendelsestyper (hendelsetype) – hva betyr kodene? ​

Du mottar hendelsestypen som en lesbar tekstkode i hendelsetype, ikke som tall. Kodene er gruppert etter betydning nedenfor.

Flytting, mottak og avgivelse ​

KodeBetyrRapportert avSlettbar
HUSDYR_FOEDSELNyfødt dyr merket første gangDyreholdetJa
HUSDYR_TIL_DYREHOLDDyr mottatt/kjøptMottakende dyreholdJa
HUSDYR_FRA_DYREHOLDDyr avgitt/solgtAvgivende dyreholdJa
HUSDYR_FRA_UTLANDDyr mottatt fra utlandetMottakende dyreholdJa
HUSDYR_TIL_UTLANDDyr levert til utlandetAvgivende dyreholdJa
HUSDYR_TIL_LIVDYRDyr mottatt hos livdyrhandlerLivdyrhandlerJa
HUSDYR_FRA_LIVDYRDyr avgitt fra livdyrhandlerLivdyrhandlerJa
HUSDYR_TIL_LIVDYRFJOESDyr mottatt hos livdyrfjøsLivdyrfjøsJa
HUSDYR_FRA_LIVDYRFJOESDyr avgitt fra livdyrfjøsLivdyrfjøsJa
HUSDYR_TIL_SLAKTINGDyr sendt til slaktDyreholdetJa
HUSDYR_MOTTATT_TIL_SLAKTINGDyr mottatt til slaktSlakterietJa
HUSDYR_SLAKTETDyr slaktetSlakterietJa

Disse hendelsene henger ofte sammen i et forløp (en flytting eller en slakting kan bestå av flere meldinger fra ulike parter). Se §6 for hvordan dette skal leses.

Livdyrhandler og livdyrfjøs er to ulike typer mellomledd et dyr kan passere på vei mellom to dyrehold. En livdyrhandler er en registrert dyrehandler som midlertidig kjøper og holder levende dyr for videresalg. Et livdyrfjøs er en samlestall der dyr fra flere dyrehold samles midlertidig før videre transport. Begge forløpene ender tilbake hos et mottakende dyrehold (HUSDYR_TIL_DYREHOLD), ikke hos slakt – slakting er et eget forløp med egne koder (HUSDYR_TIL_SLAKTING, HUSDYR_MOTTATT_TIL_SLAKTING, HUSDYR_SLAKTET).

Merk: hendelsetype sier bare hva denne ene meldingen rapporterer – f.eks. at et dyr er mottatt hos et dyrehold. Den sier ingenting om hvorvidt motpartens melding i samme forløp (f.eks. avgiverens HUSDYR_FRA_DYREHOLD, eller neste steg i en slakting) faktisk er mottatt. Du kan altså motta en HUSDYR_TIL_DYREHOLD uten at den tilhørende HUSDYR_FRA_DYREHOLD noen gang dukker opp (eller omvendt). Om hele forløpet er komplett, avgjøres av rapportkompletthet-statusen i §5 (HR_KOMPLETT m.fl.) – ikke av hendelsetypen alene.

Død, tap og midlertidig opphold ​

KodeBetyrSlettbar
HUSDYR_SJOELDOEDDyret er selvdødtJa
HUSDYR_AVLIVETDyret er avlivetJa
HUSDYR_TAPTDyr forsvunnet på beiteJa
HUSDYR_DYR_FUNNETGjenfunnet dyr – oppfølging til en tidligere HUSDYR_TAPTJa
HUSDYR_HJEMMESLAKTETDyr hjemmeslaktetJa
HUSDYR_UTSTILLING, HUSDYR_DYREHAGE, HUSDYR_MARKED, HUSDYR_FORSKNINGSSTASJON, HUSDYR_FELLESBEITE, HUSDYR_UNDERVISNINGMidlertidig låne-/leieopphold (utstilling, dyrehage, marked, forskning, fellesbeite, undervisning)Ja
HUSDYR_ANNEN_FORFLYTNINGGenerell «annen forflytning» når ingen mer spesifikk kode er valgtJa

Oppdatering og driftsansvar ​

KodeBetyrSlettbar
INDIVID_OPPDATERBasisopplysninger om individet er oppdatert. F.eks. endring av rase. Det som oppgis her bør ansees å være rettinger av informasjon som var feil. Altså er dette tilstanden den burde hatt fra starten av. En rase kan tross alt ikke endre seg over tid.Nei
HUSDYR_OVERFOERTDyret er overført operasjonelt til nytt driftsansvar, f.eks. ved eierskifte. Dette er ikke en ny fysisk flytting, bare en bekreftelse av fakta etter overføringen.Nei
HUSDYR_EIERSKIFTEJuridisk eierskifte av foretaket som eier dyreholdet (fra Enhetsregisteret). Dette er en annen og normalt tidligere hendelse enn HUSDYR_OVERFOERT i samme forretningsprosess – de to er per i dag ikke koblet med en felles ID i meldingen.Nei

Slettbar = Nei betyr at det per i dag ikke finnes en mekanisme for å oppheve denne meldingen med en senere slettehendelse (sletteHendelse/ originalEventId, se §7). Du vil altså ikke motta en slettehendelse som peker tilbake på denne typen.

4. Faktapayloaden (detaljer) ​

detaljer er null kun ved én bestemt type slettehendelse: en full «nullstilling» av et individ (se §7). For alle andre meldinger – også ordinære slettehendelser som opphever én enkelt hendelse – har detaljer innhold med to deler: individ og driftsansvarlig.

Merk om feltnavn: i motsetning til enkelte andre kilder dere kan ha sett tidligere, følger feltnavnene inni detaljer ikke en konsekvent lowercase-konvensjon. Noen felt er camelCase (raseCode, raseBetegnelse, foedtDato, slaktetDato), mens andre er rene lowercase (opprinnelsesmerke, farge, kjoenn, status, morsOpprinnelsesmerke – merk stor forbokstav kun i Opprinnelsesmerke- delen av dette ene feltnavnet). Bruk feltnavnene nøyaktig slik de står i eksempelet under.

individ – fakta om dyret:

  • opprinnelsesmerke – første norske øremerke
  • morsOpprinnelsesmerke – morens første norske øremerke
  • farge, kjoenn, raseCode, raseBetegnelse
  • foedtDato – registrert fødselsdato (format YYYY-MM-DD)
  • slaktetDato – slaktedato, hvis slaktet
  • status – kode for individets siste livsfase, se §5. kan være null.

driftsansvarlig – hvem som har ansvar for dyret:

  • Virksomhetsidentifikatorer: foretaksnummer, bedriftsnummer, foedselsnummer

Eksempel – melding med fiktive verdier, HUSDYR_FOEDSEL for et dyr eid av en virksomhet (ikke en privatperson):

json
{
  "eventId": "33e13319-60c5-449a-ad9d-6bac10114295",
  "originalEventId": null,
  "sletteHendelse": false,
  "opprinnelsesmerke": "1234567-00042",
  "hendelsetype": "HUSDYR_FOEDSEL",
  "skjedde": "2026-03-01T00:00:00",
  "opprettet": "2026-03-02T08:15:00.123456",
  "detaljer": {
    "driftsansvarlig": {
      "bedriftsnummer": "319876545",
      "foretaksnummer": "312345676",
      "foedselsnummer": null
    },
    "individ": {
      "opprinnelsesmerke": "1234567-00042",
      "farge": null,
      "kjoenn": "HAN",
      "raseCode": "03100202001025",
      "raseBetegnelse": "22222222222222220122242424242424",
      "foedtDato": "2026-02-28",
      "slaktetDato": null,
      "morsOpprinnelsesmerke": "1234567-00017",
      "status": "HR_KOMPLETT"
    }
  }
}

driftsansvarlig.foedselsnummer settes kun når driftsansvarlig er en privatperson, og da er foretaksnummer/bedriftsnummer begge null – de to kombinasjonene opptrer aldri samtidig.

Felt du ikke får i payloaden: operasjonstype, fra-/til-driftsansvarlig ved overføring, og en felles ID som kobler eierskifte og overføring. Du må per i dag utlede sammenheng selv, basert på virksomhet/dyrehold og tidsnærhet.

5. Statuskoden i detaljer.individ.status ​

Status forteller om rapportkompletthet for individets siste livsfase – ikke om dyret lever, og ikke om meldingen er levert til deg. Kodene starter med HR_:

KodeBetyr
HR_MANGELFULLMangelfull registrering (uspesifisert hva som mangler)
HR_KOMPLETTAlle forventede rapporter for dette forløpet er mottatt. Kan forekomme selv om dyret er slaktet – det sier bare noe om rapportkompletthet.
HR_DYR_OVERFOERT_MANGLER_KJOEPSRAPPORTFlytting registrert, men rapport fra kjøper/mottaker mangler ennå
HR_DYR_OVERFOERT_MANGLER_SALGSRAPPORTFlytting registrert, men rapport fra selger/avgiver mangler ennå
HR_DYR_OVERFOERT_FRA_LIVDYRHANDLER_MANGLER_BEGGE_RAPPORTERRapport om overføring/slakt mottatt, men begge parters rapporter mangler ennå
HR_DYR_SLAKTET_MANGLER_SLAKTERIRAPPORTSlakteforløp – rapport fra slakteriet mangler ennå
HR_DYR_SLAKTET_MANGLER_DYREHOLDRAPPORTSlakteforløp – rapport fra dyreholdet mangler ennå

status kan være null når individet mangler en siste livsfase eller livsfasen mangler status.

6. Flere meldinger kan høre til samme forløp ​

Mange hendelser kommer i par eller grupper fordi flere parter rapporterer hver sin del av samme flytting eller slakting. Eksempler:

ForløpMeldinger som hører sammen
Direkte flyttingHUSDYR_FRA_DYREHOLD + HUSDYR_TIL_DYREHOLD
Via livdyrhandlerHUSDYR_FRA_DYREHOLD + HUSDYR_TIL_LIVDYR + HUSDYR_FRA_LIVDYR + HUSDYR_TIL_DYREHOLD
Via livdyrfjøsHUSDYR_FRA_DYREHOLD + HUSDYR_TIL_LIVDYRFJOES + HUSDYR_FRA_LIVDYRFJOES + HUSDYR_TIL_DYREHOLD
SlaktHUSDYR_TIL_SLAKTING + HUSDYR_MOTTATT_TIL_SLAKTING + HUSDYR_SLAKTET

Det finnes ingen egen ID i meldingen som binder disse sammen – du må gruppere på individ (opprinnelsesmerke) og tidsnærhet. Meldingene kan også komme i vilkårlig rekkefølge (med noen få unntak i det underliggende regelverket). NATS' eget sekvensnummer sier bare i hvilken rekkefølge du mottok meldingene – ikke hvilken rekkefølge hendelsene faktisk skjedde i, og ikke hvilket ledd i forløpet de representerer.

7. Slettehendelser (rettinger og tilbaketrekking) ​

En allerede sendt melding endres aldri. Rettinger og tilbaketrekking sendes som nye meldinger med sletteHendelse = true, men bare for hendelsestyper merket «Slettbar: Ja» i §3:

  • sletteHendelse = true betyr at denne meldingen opphever en tidligere hendelse. originalEventId forteller deg hvilken (eventId) som oppheves.
  • detaljer kan være null på en slik slettehendelse. Det betyr ikke at du kan ignorere meldingen – den forteller fortsatt at en tidligere hendelse er opphevet. null betyr heller ikke at dyret er dødt eller fysisk slettet.
  • Ved en større «nullstilling» av et individ kan du motta flere slettehendelser etter hverandre (nyeste hendelse først, eldste – typisk fødsel – sist). Alle beskriver samme sluttilstand for individet, ikke mellomsteg.

Praktisk konsekvens for deg som konsument: behandle sletteHendelse og originalEventId som de viktigste feltene på en slettehendelse, uavhengig av om detaljer har innhold.

8. Oppsummert sjekkliste for lesing ​

  1. Bruk eventId som stabil hendelsesidentitet. Bruk NATS' eget sekvensnummer/seq (transportmetadata, ikke et JSON-felt) for å spore fremgang og gjenoppta lesing.
  2. Tolk hendelsetype ut fra tabellene i §3 – ikke anta at typen alene beviser at et helt forløp er ferdig.
  3. Les detaljer når den finnes; husk at felt som mangler helt kobling mellom relaterte hendelser (overføring/eierskifte, forløp) må utledes selv.
  4. Sjekk alltid sletteHendelse/originalEventId – også når detaljer er null.
  5. Ikke forveksle detaljer.individ.status (rapportkompletthet) med om dyret lever eller om meldingen er "ferdigbehandlet" hos deg.