Webservice-metode - soekMerker

Søke etter merker

Denne metoden tilbyr søk på merker for en gitt produsent eller et gitt dyrehold. Andre søkeparametre er dyreart, merkeformål, merketype, merkestatus.

Det kan også søkes med bare merkeidentifikator for å søke på et spesifikt merke. Merkeidentifikator må oppgis som en tekststreng med produsentnummer som er preget på merket (7-sifret dyreholdid eller 8-sifret produsentnummer) og individnummer adskilt med bindestrek (-), f.eks. 12345678-0001.

Søkeresultatet returneres i MerkerResponse. I tillegg inneholder responsobjektet feilinformasjonsattributtene feilkode og feiltekst, som ligger i alle responsobjekter og alltid må sjekkes for å håndtere evt. feilsituasjoner.

Parametere

Parameterne vises ekspandert.

Navn	Type	Kommentar
request	MerkerRequest	Dokumentert i request-objektet
dyreart	String	Kode som representerer dyreart. Dersom feltet er tomt brukes standardverdien: 03100202001. Gyldige verdier gitt i: Landdyr (no)
dyreholdId	String	DyreholdId til produsent, kun aktuelt for småfe og storfehold.
formaal	String	Kode som representerer merkeformål. Gyldige verdier gitt i: Merkeformaal (no)
merkeidentifikator	String	Merkets identifikator. Består av produsentnummer/dyreholdid og individnummer, satt sammen i en sammenhengende tekststreng, atskilt med bindestrek (-). Merkeidentifikator må angis som 8+4 eller 7+5, med bindestrek mellom. Eksempel: 12345678-1234
merkestatus	String	Status på merke. [UBRUKT, BRUKT, UTRANGERT]
merketype	String	Kode som representerer merketype. Gyldige verdier gitt i: Merketype (no)
produsentnummer	String	Produsentnummer til produsent. Produsentnummer må ha 8 eller 10 siffer.

Respons

Parameterne vises ekspandert.

Navn	Type	Kommentar
response	MerkerResponse	Dokumentert i respons-objektet
errorlevel	ErrorLevel	Feilnivå: 0: Alt OK, ingen feil. 1: Advarsel, tjenesten har fullført, men sjekk eventuelle tilbakemeldinger. 2: Valideringsfeil; en eller flere av inn-parameterne var ikke gyldige. 3: Teknisk feil: Noe har gått galt på serversiden.
merke	Array <Merke>	Liste over merker
andreHullfarge	String	Kode som representerer hullfarge for det andre visuelle merket Gyldige verdier gitt i: Farge (no)
andreMerketype	String	Kode som representerer merketype for det andre visuelle merket Gyldige verdier gitt i: Merketype (no)
andreTappfarge	String	Kode som representerer tappfarge for det andre visuelle merket Gyldige verdier gitt i: Farge (no)
bedriftsnummer	String	Bedriftens organisasjonsnummer
bestillingstidspunkt	Dato	Tidspunkt for bestilling
dyreart	String	Kode som representerer dyreart Gyldige verdier gitt i: Landdyr (no)
elektronisk	Boolean	Elektronisk merke
formaal	String	Kode som representerer merkeformål Gyldige verdier gitt i: Merkeformaal (no)
hullfarge	String	Kode som representerer hullfarge Gyldige verdier gitt i: Farge (no)
land	String	Kode som representerer land Gyldige verdier gitt i: Land (no)
merkeidentifikator	String	Preget nummer
merketype	String	Kode som representerer merketype Gyldige verdier gitt i: Merketype (no)
produsentnummer	String	Produsentnummer
serie	String	Kode som representerer merkeserie Gyldige verdier gitt i: Merkeserie (no)
tappfarge	String	Kode som representerer tappfarge Gyldige verdier gitt i: Farge (no)
tattIBrukDato	Dato	Dato merke ble registrert tatt i bruk
utrangertDato	Dato	Dato dyr merket med aktuelt merke ble registrert dødt
tilbakemelding	Array <Melding>	Liste med tilbakemeldinger fra tjenesten med kode og tilhørende tekst. Feltet kan returnere verdier fra: Standardmelding
errorcodeId	int	Numerisk beskrivelse av meldingen
tekst	String	Tekstlig beskrivelse av meldingen.