Webservice-metode - reserverMerker

Reservere merker

Denne metoden oppretter en ny merkereservasjon for øremerker. Reservasjonsinformasjonen overføres i et ReserverRequest-objekt.

For å identifisere produsenten som skal ha merkene må enten 7-sifret dyreholdid eller 8-sifret produsentnummer og 9-sifret organisasjonsnummer oppgis.

For reservasjoner for elektroniske merker må det først ha blitt sendt inn reservasjon for de tilhørende visuelle merkene. Reservasjonen for de elektroniske merkene må inneholde reservasjonsnummeret til denne tilhørende reservasjonen i attributtet reservasjonsnummer. Det er også mulig å reservere elektroniske merker for visuelle merker som allerede eksisterer. Da er det ikke nødvendig å oppgi reservasjonsnummer for denne reservasjonen.

Kvittering på opprettelse av reservasjonen sendes i ReserverResponse. Dette objektet inneholder reservasjonsnummeret som identifiserer reservasjonen og må benyttes ved bekreftelse/kansellering av ordren, i tillegg til leveringsinformasjon for merkene. 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 ReserverRequest Dokumentert i request-objektet
andreHullfarge String Kode som representerer andre hulltappfarge
Gyldige verdier gitt i:
andreMerketype String Kode som representerer andre merketype
Gyldige verdier gitt i:
andreTappfarge String Kode som representerer andre tappfarge
Gyldige verdier gitt i:
antall Integer
Obligatorisk felt.
Antall merker i serien
Dersom feltet er tomt brukes standardverdien: 0.
dyreart String Kode som representerer dyreart
Gyldige verdier gitt i:
dyreholdId String Dyrehold identitet til produsent, kun aktuelt for småfe og storfehold.
formaal String Kode som representerer merkeformål
Gyldige verdier gitt i:
hullfarge String Kode som representerer hullgarge
Gyldige verdier gitt i:
individnumre String Bestilte individnummer. Kan være kommaseparert liste eller intervall.
land String Kode som representerer land.
Gyldige verdier gitt i:
merkeserie String Kode som representerer merkeserie
Gyldige verdier gitt i:
merketype String Kode som representerer merketype
Gyldige verdier gitt i:
orgNummer String Bedriftsnummer til produsent som bestiller merke.
produsentNrTilPreg String Produsentnummer eller dyrehold identitet som skal bli preget på merke.
Produsentnummer til preg må ha 7 eller 8 siffer.
produsentnummer String Produsentnummer til produsent
reservasjonsnummer String Reservasjonsnummer, blir brukt for å refrere til tidligere bestilling
tappfarge String Kode som representerer tappfarge
Gyldige verdier gitt i:

Respons

Parameterne vises ekspandert.
Navn Type Kommentar
response ReserverResponse Dokumentert i respons-objektet
dyreholdId String DyreholdId
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.
leveresTilAdresse String Adresse på mottaker av merke(r)
leveresTilDyreholdId String Dyreholdid til mottaker av merke(r)
leveresTilLand String Land til mottaker av merke(r)
leveresTilNavn String Navn på mottaker av merke(r)
leveresTilPostnr String Postnummer på mottaker av merke(r)
leveresTilPoststed String Poststed på mottaker av merke(r)
produsentnummer String Produsentnummer til produsent
reservasjonsnummer String Reservasjonsnummer, blir brukt for å refrere til tidligere bestilling
tilbakemelding Array <Melding> Liste med tilbakemeldinger fra tjenesten med kode og tilhørende tekst.
Feltet kan returnere verdier fra:
errorcodeId int Numerisk beskrivelse av meldingen
tekst String Tekstlig beskrivelse av meldingen.