Instrumentregister på masterordren¶

Instrumentregisteret er oversikten over de fysiske instrumentene om bord på et skip — hvilket produkt de er, serienummeret, når de ble kjøpt, og hvilken masterordre som følger dem opp. Det er grunnlaget for fartøyets instrumentoversikt og for kontrollen av om ordren inneholder de forbrukslinjene instrumentets malpakke foreskriver.

Registeret vises i fanen «Instrumenter» i detaljpanelet på Abonnement → Masterordre.

Ett instrument hører til én ordre¶

Et instrument tilhører nøyaktig én masterordre. Én ordre har mange instrumenter; hvert instrument har én ordre. Fanen viser derfor instrumentene som er knyttet til denne ordren — ikke alle instrumentene på skipet. Har skipet to løpende ordrer, får de to ulike lister.

Ved fornyelse flyttes instrumentet til den nye ordren. Instrumentet er fysisk det samme; hvilken ordre som dekket det før ligger i endringsloggen.

Instrumenter som ikke er knyttet til noen ordre finnes fortsatt i skipets register, men vises ikke på noen ordre før noen tilordner dem.

Slik registrerer du et instrument¶

Et instrument opprettes vanligvis automatisk fra en bekreftet ordrelinje. Manuell registrering brukes når skipet har instrumenter fra før som videreføres når de blir kunde — de har ingen ordrelinje å bli opprettet fra.

Åpne masterordren og velg fanen «Instrumenter».
Klikk «Nytt instrument». Skuffen åpnes fra høyre.
Fyll ut feltene (se tabellen under). Bare Instrument (navnet) er påkrevd.
Klikk «Lagre».

Skipet og ordren settes automatisk fra ordren du står på — du velger dem ikke.

For å endre et instrument: klikk blyantikonet på raden i griden. Samme skuff åpnes med verdiene utfylt.

Instrumenter som opprettes automatisk¶

Instrumenter opprettes automatisk når en kunde aksepterer et tilbud som inneholder en instrumentlinje. De knyttes til masterordren aksepten lager, og får produktnummer og navn fra produktet i Business NXT.

Antallet på linja bestemmer hvor mange instrumenter som opprettes. En linje med 5 stk blir 5 instrumenter, ikke ett: hver enhet er en fysisk gjenstand med sitt eget serienummer, sitt eget kalibreringsløp og sitt eget sertifikat. 5 stk av ett produkt og 3 stk av et annet på samme tilbud gir derfor 8 rader i registeret. Aksepterer kunden det samme tilbudet flere ganger, blir det fortsatt 8 — ikke 16.

Antallet må være et helt tall, og høyst 999 999 999 — bestiller linja 2 500 instrumenter, opprettes 2 500 rader. Tabellen under viser hva de ulike verdiene betyr:

Antall på instrumentlinja	Hva skjer
Helt tall over 0 (for eksempel `5`)	Det opprettes så mange instrumenter
`0`	Ingen instrumenter opprettes — og masterordren opprettes som normalt. `0` er et svar: ingenting er bestilt av dette produktet
Negativt helt tall (for eksempel `-1`)	Ingen instrumenter opprettes — og masterordren opprettes som normalt. Et negativt antall er en retur: en enhet er kommet tilbake, ikke bestilt. Står det i tillegg et serienummer på linja, deaktiveres det instrumentet — se «Retur av et instrument» under
Desimaltall (for eksempel `2,5` eller `-2,5`)	Masterordren opprettes ikke. Halvparten av en gassdetektor finnes ikke, og å runde til 2 eller 3 ville vært en gjetning
Over 999 999 999	Masterordren opprettes ikke. Et slikt antall er i praksis en tastefeil, og skal rettes av et menneske

Skillet er at 0 og -1 sier hvor mange som skal opprettes — null — mens 2,5 ikke sier det. Desimaltall er den eneste verdien som stopper opprettelsen; se «Blir instrumentet borte hvis noe feiler?» under.

Antall med desimaler på vanlige forbruksvarer — meter slange, liter kalibreringsgass — er helt normalt og påvirker ingenting. Bare linjer som ville blitt et instrument kan stoppe en ordre.

Retur av et instrument¶

En linje med negativt antall og serienummer er en retur: instrumentet med det serienummeret settes til ikke aktivt i registeret, og notatet «Returnert» legges til på det. Raden slettes aldri — historikken, kalibreringene og sertifikatet står igjen, instrumentet forsvinner bare fra den aktive lista.

Instrumentet finnes ved hjelp av skip + produktnummer + serienummer til sammen. Et serienummer alene er ikke entydig nok: samme nummer kan finnes på et annet produkt eller et annet skip.
Finner vi ikke instrumentet, skjer ingenting med registeret, og masterordren opprettes som normalt. En retur skal aldri stoppe en aksept — enheten kan være kjøpt før kunden kom inn i ePortal, eller serienummeret kan være tastet annerledes.
Mangler returlinja serienummer (eller produktnummer), er det ingenting å finne. Det er ikke en feil og stopper ingenting, men det logges som en advarsel med skip, produkt og serienummer, så det er mulig å finne igjen og deaktivere instrumentet manuelt. Konti-support ser advarselen under Systemadministrasjon → ePortal API-logg.
Har instrumentet et notat fra før, legges «Returnert» til på en ny linje under det. Er notatet helt fullt (1 000 tegn), er det den eldste teksten som viker — markøren kommer alltid med.
Aksepteres det samme tilbudet flere ganger, deaktiveres instrumentet bare første gang, og notatet legges til bare én gang.
Deaktiveringen loggføres i endringsloggen på instrumentet.

Merk: serienummer settes ikke på tilbudslinjer i dag (se avsnittet under), så denne regelen trer først i kraft når automatisk henting av serienummer fra logistikk kommer i en senere leveranse. Regelen er bygget og klar, men kan ikke utløses ennå.

Serienummer settes ikke ved aksept. Instrumentet får plassholderen Missing SN, fordi serienummeret først er kjent når logistikk sender enheten. Du kan taste det inn selv i instrumentfanen når som helst. For instrumenter som stammer fra importerte masterordrer kan serienumrene i tillegg hentes automatisk fra Business NXT av den interne jobben «Visma Business NXT: serienummer» - et serienummer du har tastet inn selv overskrives aldri av jobben. For instrumenter født av et akseptert tilbud (tilbudsveien) kommer automatisk henting i en senere leveranse (S4b).

Hva som regnes som et instrument avgjøres av produktets produkttype i Business NXT (ProductType2, som i eldre dokumentasjon kalles ved SQL-navnet prodTp2). Hvilke verdier som gjelder settes per kunde i innstillingen:

Innstilling	Standardverdi	Betydning
`Subscription.InstrumentClassifications`	`1,2,10`	Kommaseparert liste over produkttyper som skal bli instrumenter

Standardverdien er den opprinnelige Bruusgaard-oppsettet. Har din NXT andre produkttyper for instrumenter, endre lista — for eksempel 7 eller 1,2,7,10.

Når trer endringen i kraft: ved neste aksept eller import. Instrumenter som allerede er opprettet berøres ikke.

Hvis verdien er tom eller ugyldig, brukes standardlista 1,2,10. Systemet slår bevisst ikke av instrumentopprettelsen ved feil verdi — det ville sett ut som at funksjonen var ødelagt i stedet for feilkonfigurert.

Hvis innstillingen ikke lar seg lese i det hele tatt — altså at innstillings-lageret ikke svarer — er det noe annet, og behandles annerledes ved aksept av tilbud: masterordren opprettes ikke. Vi vet da ikke hvilke produkttyper denne kunden regner som instrumenter, og å gjette på standardlista kunne fått et instrument til å bli forkastet i stillhet. Kjør opprettelsen på nytt når innstillingen kan leses igjen.

Den eldre import-stien beholder standardlista også i dette tilfellet; den styres ikke av samme alt-eller-ingenting-regel som aksept.

Merk at 0 ikke kan brukes som produkttype: NXT bruker 0 for «ikke satt», og verdien leses som tom.

Blir instrumentet borte hvis noe feiler?¶

Nei — men de to feilmåtene oppfører seg med vilje ulikt.

Hvis Business NXT ikke svarer når produktet skal slås opp, blir masterordren ikke opprettet. Systemet vet da ikke om tilbudet inneholder et instrument, og en ordre som mangler instrumentet sitt i det stille er verre enn ingen ordre. Ingenting er skrevet på dette tidspunktet, så tilbudet står fortsatt som akseptert og du kjører opprettelsen på nytt når NXT svarer igjen.

Hvis antallet på en instrumentlinje ikke sier hvor mange enheter det er — altså et desimaltall — blir masterordren heller ikke opprettet. Systemet vet da ikke hvor mange instrumenter ordren skal ha, og å runde 2,5 opp eller ned ville vært en gjetning på kundens vegne. Se «Slik retter du et tilbud som ble stoppet» under.

(Antall 0 og negative antall stopper ikke opprettelsen — begge er gyldige svar, og ordren opprettes uten at det opprettes instrumenter fra den linja.)

Hvis selve lagringen av instrumentet feiler, rulles hele opprettelsen tilbake — verken ordren eller instrumentet blir stående. Aksepten kan da gjøres på nytt. Dette er bevisst: et halvferdig resultat, der ordren finnes men instrumentet mangler i det stille, ville vært verre, og ingenting i systemet kjører opprettelsen på nytt av seg selv.

Systemet oppretter aldri det samme instrumentet to ganger, selv om kunden klikker «Aksepter» flere ganger.

Slik retter du et tilbud som ble stoppet¶

Når opprettelsen stoppes, står tilbudet igjen som Akseptert uten ordre. Linjene på et akseptert tilbud kan ikke redigeres direkte — du må først sette tilbudet tilbake til kladd.

Gå til Tilbud i listevisningen og finn tilbudet. Statusen er «Akseptert», og masterordrenummeret er tomt.
Åpne handlingsmenyen på raden og velg Gjenåpne tilbud. Valget vises bare når det ikke finnes en ordre — er ordren først opprettet, er tilbudet endelig, og da bruker du «Kopier tilbud» i stedet.
Bekreft i dialogen. Tilbudet får status Kladd, og den utsendte aksept-lenken slutter å virke med én gang. Kunden får ingen e-post om dette.
Rett antallet på instrumentlinja.
Produser og send tilbudet på nytt, eller registrer aksepten manuelt. Instrumentene opprettes nå med riktig antall.

Gjenåpningen loggføres i sporingsloggen på tilbudet, med hvem som gjorde det og når.

Merk: «Gjenåpne tilbud» krever redigeringstilgang til tilbud (samme tilgang som «Trekk tilbake»). Er valget ikke synlig på et akseptert tilbud uten ordre, mangler du den tilgangen.

Felt¶

Felt	Betydning
Instrument	Navnet på instrumentet, for eksempel `GX-9000A`. Påkrevd.
Produktnummer	Instrumentets eget produktnummer. Dette er nøkkelen som avgjør hvilken malpakke som gjelder for instrumentet — ikke et forbruksprodukt. Søkes opp i samme produktregister som ordrelinjene.
Serienr.	Serienummeret på den fysiske enheten. Kan også komme automatisk fra logistikk.
Instrumentgruppe	Gruppen instrumentet tilhører. Brukes sammen med produktnummeret når forbrukslinjer skal kobles til riktig instrument. Verdiene vedlikeholdes under Innstillinger → Masterordre → «Abonnement – feltoppsett».
Plassering	Hvor om bord instrumentet står, for eksempel `Bro` eller `Maskinrom`.
Status	Livsløpsstatus: Aktiv eller Inaktiv.
Kjøpsdato	Når instrumentet ble kjøpt.
Årsmodell	Modellår, som årstall.
Siste service	Datoen for sist utførte kalibrering/service.
Kalibreringsintervall (måneder)	Instrumentets egen syklus. Forbruksartiklenes sykluser ligger på malpakken og settes ikke her.
Sertifikat utløper	Utløpsdatoen på kalibreringsbeviset.
Aktiv i registeret	Kun ved redigering. Slås av for å pensjonere instrumentet uten å slette det.
Notat	Fritekst, inntil 1000 tegn.

Kolonnen Status i griden viser den avledede servicestatusen — OK, «Service forfaller» eller «Utløpt» — som beregnes fra siste service og sertifikatets utløpsdato. Den er ikke det samme som livsløpsstatusen du velger i skuffen, og kan ikke settes manuelt.

Tilgang¶

Handling	Datatilgang (`Subscription.ServiceObject`)
Se instrumentene på ordren	`CanView`
Registrere nytt instrument	`CanCreate`
Endre et instrument	`CanEdit`

Typen konfigureres under Innstillinger → Datatilgang → Abonnement. Uten en seedet rad faller tilgangen tilbake til «Egne».

Knappen «Nytt instrument» vises bare når du har CanCreate, og blyantikonet bare når du har CanEdit.

Vanlige problemer¶

Melding / symptom	Årsak og løsning
«Produktnummeret finnes ikke i produktregisteret»	Nummeret ble kontrollert mot produktregisteret ved lagring og finnes ikke. Kontroller nummeret, eller velg produktet fra søkelisten i stedet for å taste det.
«Nytt instrument» er grå, med teksten «Instrumenttypen er ikke satt opp i katalogen»	Typekatalogen mangler raden for instrument. Den seedes normalt ved installasjon; kontakt konsulent.
«Nytt instrument» er grå, med teksten «Ordren har ingen skipsaktør å knytte instrumentet til»	Masterordren mangler skip. Sett skipet på ordren først.
«Instrumentet må ha et navn»	Navnefeltet er tomt.
«Kalibreringsintervallet må være minst én måned»	Intervallet er 0 eller negativt. La feltet stå tomt hvis instrumentet ikke har et fast intervall.
Instrumentet vises ikke på ordren du forventet	Instrumentet er knyttet til en annen ordre, eller til ingen. Åpne ordren det faktisk hører til, eller registrer det på nytt på riktig ordre.
Et akseptert tilbud lagde ordre, men ingen instrumenter	Produkttypen på produktet står ikke i `Subscription.InstrumentClassifications`. Kontroller produktets `ProductType2` i NXT mot lista i innstillingen. Er antallet på linja `0` eller negativt, er det heller ingen instrumenter å opprette.
Et akseptert tilbud lagde færre instrumenter enn antallet på linja	Noen av enhetene finnes allerede fra en tidligere aksept. Systemet oppretter kun de som mangler, aldri duplikater.
Aksepten lager ingen masterordre i det hele tatt	Enten svarer ikke NXT, eller innstillingen for produkttyper lar seg ikke lese, eller antallet på en instrumentlinje er et desimaltall. Se «Blir instrumentet borte hvis noe feiler?» over.
En retur deaktiverte ikke instrumentet	Kombinasjonen skip + produktnummer + serienummer traff ingen aktiv rad. Kontroller serienummeret på instrumentet i registeret mot det som står på returlinja. Er instrumentet allerede deaktivert, er det ingenting mer å gjøre.

Uavklarte NXT-serienummer¶

Siden NXT-serienummer under Abonnement (modul 50) viser radene serienummer-synken ennå ikke har fått bundet til et instrument — og bundne rader som er borte fra kilden i NXT. Tabellen viser NXT-nøkkelen (selskap/ordre/linje/sekvens), det observerte serienummeret, produktet, status (Ubundet/Konflikt), årsakskoden og når raden sist ble sett. Tabellen er skrivebeskyttet, med ett unntak: rader med årsak AmbiguousOrder har handlingen Koble linjer (se under).

Siden ligger ikke i noen standardmeny. En administrator aktiverer den per kunde via Menyadministrasjon — velg ruten «NXT-serienummer» under Abonnement (modul 50). Dette er et bevisst valg (eierbeslutning 2026-08-11): siden er en smal operatørflate og følger samme opt-in-praksis som resten av masterordre-menyen.

Ubundet med årsak NoUnits eller NoLineMap løser seg normalt selv ved en senere kjøring (instrumentene finnes ikke ennå, eller koblingen mangler).
Ubundet med årsak AmbiguousOrder krever manuell kobling — se neste avsnitt.
Konflikt (ManualValueDisagrees, DuplicateSerialValue) krever en avgjørelse: rett verdien i NXT, rediger instrumentets serienummer, eller tøm det manuelle serienummeret for å gi eierskapet tilbake til synken.
Et rødt symbol betyr at raden er borte fra kilden i NXT — en bundet rad mister aldri bindingen automatisk, men bør undersøkes.

Manuell linjekobling for tvetydige ordrer (`AmbiguousOrder`)¶

Når et akseptert tilbud overføres til Visma Business NXT og samme produkt forekommer flere ganger på ordren, kan ikke systemet bevise hvilken tilbudslinje som ble hvilken NXT-ordrelinje. Ordren merkes da som en varig tvetydig sak, og serienumrene på de linjene blir stående som AmbiguousOrder til en operatør avklarer koblingen manuelt:

Trykk Koble linjer på en rad med årsak AmbiguousOrder. Et sidepanel åpnes med to kolonner: til venstre tilbudslinjene fra det aksepterte tilbudet (med opprinnelig tilbudsantall), til høyre ordrelinjene slik de står i NXT akkurat nå (med gjenstående og levert antall — NXT viser aldri opprinnelig bestilt antall; en ferdiglevert linje står med gjenstående 0).
Velg én tilbudslinje og én NXT-linje, og trykk Koble linjene. En bekreftelsesdialog navngir begge sidene før noe skrives. Linjer som allerede er koblet (automatisk eller manuelt) vises med et «Koblet»-merke og kan ikke velges på nytt.
Gjenta til alle linjene er koblet. Når siste linje er på plass lukkes saken automatisk, og neste synkkjøring binder serienumrene til instrumentene — koblingen i seg selv flytter aldri serienumre.

Alle kontrollene gjøres på serveren (linjen må tilhøre den fullførte overføringen, NXT-linjen må fortsatt finnes i ordren, og ingen av sidene kan være koblet fra før), og hver bekreftede kobling skrives til endringsloggen på tilbudet. Får du beskjed om at linjen behandles av synkjobben, prøv igjen om et øyeblikk.

Full beskrivelse av jobben, årsakskodene og SQL-reserven finnes under Interne jobber.

Se også¶

Malpakker (produktmaler) — hva instrumentets produktnummer slår opp
Masterordre-liste og detaljvisning