Utseende
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
| Felt | Eksempel | Hva det betyr |
|---|---|---|
eventId | "33e13319-60c5-449a-ad9d-6bac10114295" | Unik, stabil ID for hendelsen. Samme hendelse har alltid samme eventId. |
originalEventId | null eller en eventId | Satt bare når sletteHendelse er true. Peker på eventId til hendelsen som oppheves. |
sletteHendelse | true / false | true 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. |
detaljer | JSON-objekt eller null | Faktapayloaden, 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
| Kode | Betyr | Rapportert av | Slettbar |
|---|---|---|---|
HUSDYR_FOEDSEL | Nyfødt dyr merket første gang | Dyreholdet | Ja |
HUSDYR_TIL_DYREHOLD | Dyr mottatt/kjøpt | Mottakende dyrehold | Ja |
HUSDYR_FRA_DYREHOLD | Dyr avgitt/solgt | Avgivende dyrehold | Ja |
HUSDYR_FRA_UTLAND | Dyr mottatt fra utlandet | Mottakende dyrehold | Ja |
HUSDYR_TIL_UTLAND | Dyr levert til utlandet | Avgivende dyrehold | Ja |
HUSDYR_TIL_LIVDYR | Dyr mottatt hos livdyrhandler | Livdyrhandler | Ja |
HUSDYR_FRA_LIVDYR | Dyr avgitt fra livdyrhandler | Livdyrhandler | Ja |
HUSDYR_TIL_LIVDYRFJOES | Dyr mottatt hos livdyrfjøs | Livdyrfjøs | Ja |
HUSDYR_FRA_LIVDYRFJOES | Dyr avgitt fra livdyrfjøs | Livdyrfjøs | Ja |
HUSDYR_TIL_SLAKTING | Dyr sendt til slakt | Dyreholdet | Ja |
HUSDYR_MOTTATT_TIL_SLAKTING | Dyr mottatt til slakt | Slakteriet | Ja |
HUSDYR_SLAKTET | Dyr slaktet | Slakteriet | Ja |
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
| Kode | Betyr | Slettbar |
|---|---|---|
HUSDYR_SJOELDOED | Dyret er selvdødt | Ja |
HUSDYR_AVLIVET | Dyret er avlivet | Ja |
HUSDYR_TAPT | Dyr forsvunnet på beite | Ja |
HUSDYR_DYR_FUNNET | Gjenfunnet dyr – oppfølging til en tidligere HUSDYR_TAPT | Ja |
HUSDYR_HJEMMESLAKTET | Dyr hjemmeslaktet | Ja |
HUSDYR_UTSTILLING, HUSDYR_DYREHAGE, HUSDYR_MARKED, HUSDYR_FORSKNINGSSTASJON, HUSDYR_FELLESBEITE, HUSDYR_UNDERVISNING | Midlertidig låne-/leieopphold (utstilling, dyrehage, marked, forskning, fellesbeite, undervisning) | Ja |
HUSDYR_ANNEN_FORFLYTNING | Generell «annen forflytning» når ingen mer spesifikk kode er valgt | Ja |
Oppdatering og driftsansvar
| Kode | Betyr | Slettbar |
|---|---|---|
INDIVID_OPPDATER | Basisopplysninger 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_OVERFOERT | Dyret 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_EIERSKIFTE | Juridisk 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 øremerkemorsOpprinnelsesmerke– morens første norske øremerkefarge,kjoenn,raseCode,raseBetegnelsefoedtDato– registrert fødselsdato (formatYYYY-MM-DD)slaktetDato– slaktedato, hvis slaktetstatus– kode for individets siste livsfase, se §5. kan værenull.
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_:
| Kode | Betyr |
|---|---|
HR_MANGELFULL | Mangelfull registrering (uspesifisert hva som mangler) |
HR_KOMPLETT | Alle 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_KJOEPSRAPPORT | Flytting registrert, men rapport fra kjøper/mottaker mangler ennå |
HR_DYR_OVERFOERT_MANGLER_SALGSRAPPORT | Flytting registrert, men rapport fra selger/avgiver mangler ennå |
HR_DYR_OVERFOERT_FRA_LIVDYRHANDLER_MANGLER_BEGGE_RAPPORTER | Rapport om overføring/slakt mottatt, men begge parters rapporter mangler ennå |
HR_DYR_SLAKTET_MANGLER_SLAKTERIRAPPORT | Slakteforløp – rapport fra slakteriet mangler ennå |
HR_DYR_SLAKTET_MANGLER_DYREHOLDRAPPORT | Slakteforlø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øp | Meldinger som hører sammen |
|---|---|
| Direkte flytting | HUSDYR_FRA_DYREHOLD + HUSDYR_TIL_DYREHOLD |
| Via livdyrhandler | HUSDYR_FRA_DYREHOLD + HUSDYR_TIL_LIVDYR + HUSDYR_FRA_LIVDYR + HUSDYR_TIL_DYREHOLD |
| Via livdyrfjøs | HUSDYR_FRA_DYREHOLD + HUSDYR_TIL_LIVDYRFJOES + HUSDYR_FRA_LIVDYRFJOES + HUSDYR_TIL_DYREHOLD |
| Slakt | HUSDYR_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 = truebetyr at denne meldingen opphever en tidligere hendelse.originalEventIdforteller deg hvilken (eventId) som oppheves.detaljerkan værenullpå en slik slettehendelse. Det betyr ikke at du kan ignorere meldingen – den forteller fortsatt at en tidligere hendelse er opphevet.nullbetyr 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
- Bruk
eventIdsom stabil hendelsesidentitet. Bruk NATS' eget sekvensnummer/seq (transportmetadata, ikke et JSON-felt) for å spore fremgang og gjenoppta lesing. - Tolk
hendelsetypeut fra tabellene i §3 – ikke anta at typen alene beviser at et helt forløp er ferdig. - Les
detaljernår den finnes; husk at felt som mangler helt kobling mellom relaterte hendelser (overføring/eierskifte, forløp) må utledes selv. - Sjekk alltid
sletteHendelse/originalEventId– også nårdetaljerernull. - Ikke forveksle
detaljer.individ.status(rapportkompletthet) med om dyret lever eller om meldingen er "ferdigbehandlet" hos deg.