Legge til ekstra produkter under plukking
Legg til ekstra produktlinjer mens man holder på med et plukk, som emballasje, pall osv.
Du kan legge til ekstra produktlinjer mens du plukker, for eksempel emballasje og paller. Funksjonen krever støtte i ERP-integrasjonen og riktig oppsett i BxAdmin. Denne artikkelen forklarer hvordan du aktiverer funksjonen, begrenser hvilke produkter som kan legges til, og kontrollerer eksporten til ERP.
Viktig: Det er forskjell på å gjøre et produkt tilgjengelig i BxMobile, legge produktlinjen til i ERP og ferdigmelde leveransen. Alle delene må være satt opp. Se også det egne avsnittet om VismaNet.
Denne funksjonaliteten krever BxLogistics Pro.
Innhold
- 1. Forutsetninger
- 2. Aktivere funksjonen i klientprofilen
- 3. Velge hvilke produkter som kan legges til
- 4. Eksport til ERP
- 5. Hente oppdatert oppsett i BxMobile
- 6. Kontroll og feilsøking
1. Forutsetninger
- ERP-systemet og den aktuelle eksportintegrasjonen må støtte at nye produktlinjer legges til under plukking. Oppsett og tilgjengelighet kan variere mellom integrasjoner og versjoner.
- Endringene må gjøres på riktig firma og klientprofil i BxAdmin.
- Produktene som skal kunne legges til, må være tilgjengelige i produktgrunnlaget som BxMobile bruker.
Oppsettet består av tre deler: pickinglist → addproducts i klientkonfigurasjonen, addwhenpicking i produktspørringen og en eksport som håndterer de nye linjene.
2. Aktivere funksjonen i klientprofilen
Åpne Configuration i BxAdmin og velg den aktuelle klientprofilen. Finn området pickinglist og sett egenskapen addproducts til true.
Denne innstillingen aktiverer muligheten til å legge til produkter. Den bestemmer ikke alene hvilke produkter som skal vises.

3. Velge hvilke produkter som kan legges til
Ja, du kan begrense utvalget slik at brukeren bare kan legge til bestemte produkter, i stedet for å velge fra hele produktregisteret. Åpne SQL Integration → Products for den aktuelle klientprofilen. Produktspørringen må returnere et felt med navnet addwhenpicking.
3.1 Hva betyr addwhenpicking?
| Felt/verdi | Forklaring |
|---|---|
| 0 addwhenpicking | Produktet skal ikke kunne legges til som en ekstra linje under plukking. |
| 1 addwhenpicking | Produktet kan legges til som en ekstra linje under plukking. |
Hvis spørringen returnerer 1 addwhenpicking for alle produkter, blir alle produktene som spørringen returnerer tilgjengelige. Bruk derfor normalt en betingelse som gir 1 bare for ønskede produkter og 0 for resten. Vi anbefaler ikke å bruke ren 1 addwhenpicking i spørringen da dette tillater alt av produkter å legges til, som fort kan føre til problemer ved feilskann etc., bruk derfor alltid en case for å begrense utvalget til varer som faktisk skal legges til.
Hvis feltet mangler, legg det til i SELECT-listen. Hvis det allerede finnes, endre det eksisterende uttrykket i stedet for å legge til en ny kolonne med samme navn.
3.2 Eksempler på produktutvalg
Visma Business: Dersom produktnummeret i den eksisterende spørringen er p.prodno, kan uttrykket være:
case when p.prodno in ('100', '101', '102') then 1 else 0 end addwhenpicking
BxEngine Cloud med BxProduct, for eksempel ved VismaNet: Dersom produktspørringen bruker BxProduct med alias p og kolonnen productno, blir tilsvarende uttrykk:
case when p.productno in ('100', '101', '102') then 1 else 0 end addwhenpicking
Bytt ut 100, 101 og 102 med produktnumrene dere ønsker å tillate. Tilpass tabellalias og kolonnenavn til den faktiske spørringen. Eksemplene er uttrykk som skal inn i SELECT-listen i den eksisterende produktspørringen, ikke komplette spørringer.
Anbefaling ved større produktutvalg: Bruk produktgrupper i stedet for å vedlikeholde lange lister med enkeltvarenummer. La betingelsen i produktspørringen sette addwhenpicking til 1 for produkter i de tillatte gruppene og 0 for øvrige produkter. Da kan utvalget vedlikeholdes gjennom produktenes gruppetilhørighet i ERP, fremfor at SQL-uttrykket må endres for hver ny vare.
Gruppefeltet og gruppeverdiene må tilpasses ERP-systemet og den aktuelle spørringen. Gruppestyringen forutsetter at gruppetilhørigheten er tilgjengelig i produktgrunnlaget som spørringen bruker. Etter endringer må oppdaterte produktdata være tilgjengelige for BxMobile.
Ikke begrens hele produktspørringen med WHERE til bare ekstravarene. Andre produkter skal fortsatt kunne finnes ved vanlig produktsøk og plukking. Bruk addwhenpicking til å styre hvilke av produktene som i tillegg kan legges til som nye linjer.
4. Eksport til ERP
I oppsett som bruker en separat eksport for nye linjer, må Export to ERP → pickinglist → addproduct være aktivert og ha riktige feltmappinger for den aktuelle ERP-integrasjonen. At funksjonen er synlig i BxMobile, betyr ikke at eksporten er ferdig satt opp.

4.1 VismaNet: legge til en linje på en eksisterende leveranse
VismaNet-integrasjonen har en egen pickinglist → addproduct-eksport. I standardflyten for en eksisterende leveranse legges den nye linjen til via v1/shipment/{shipmentNumber}/action/addLine. Leveransen må være åpen og allerede inneholde minst én linje fra en salgsordre. VismaNet legger også den nye linjen til på salgsordren som tilhører den første leveranselinjen.
Kontroller følgende under Export to ERP → pickinglist → addproduct → Export Mapping:
| Sourcefield → Destination | Forklaring |
|---|---|
| lines.productno → inventoryNumber.value | Produktnummeret som skal legges til. |
| lines.quantity → shippedQty.value | Registrert plukkantall på den nye linjen. |
| lines.warehouse → warehouse.value | Lager for den nye linjen. |
| lines.unitname → uom.value | Enheten som antallet gjelder. |
| lines.location → location.value | Lokasjon der dette er nødvendig for produktet og lageroppsettet. |
Operasjonen for en ny linje kan settes med tom Sourcefield → operation og Static = Insert. Kontroller at mappingene er aktivert, og at produkt, lager, enhet og eventuell lokasjon er gyldige i VismaNet.
Merk: Tabellen gjelder addproduct mot en eksisterende leveranse. Den er ikke en komplett eksportmal for alle VismaNet-oppsett. Dersom integrasjonen oppretter leveransen fra salgsordren, bruker createShipment eller har en tilpasset eksportflyt, må oppsettet kontrolleres særskilt.
Kilder: VismaNet API-dokumentasjon – Shipment, addLine og Vismas forutsetninger for å legge til nye leveranselinjer.
4.2 VismaNet: antall og ferdigmelding
addproduct legger til linjen; den bekrefter ikke leveransen alene. For at den nye linjen skal få med riktig plukkantall, må lines.quantity være mappet til shippedQty.value i addproduct-eksporten som beskrevet over. En mapping til bare produktnummeret er ikke tilstrekkelig til å sende det registrerte antallet.
Den ordinære pickinglist → create-eksporten håndterer oppdatering og eventuell bekreftelse av leveransen. Kontroller derfor både addproduct-eksporten og den ordinære plukkeksporten dersom den nye linjen blir opprettet, men leveransen ikke blir ferdigmeldt.
I VismaNet-eksporten styrer innstillingen confirmShipment om leveransen skal bekreftes automatisk. Automatisk bekreftelse utføres som standard når innstillingen ikke er satt til false. Kontroller denne under Export to ERP → pickinglist → create → Export Config. Ikke endre en bevisst deaktivert bekreftelse uten å avklare ønsket arbeidsflyt.
Det er altså normalt ikke en ekstra «ferdigmeldingsmapping» på addproduct som mangler. Skill mellom antall på den nye linjen og bekreftelse av hele leveransen, og kontroller eventuelle eksportfeil før du endrer oppsettet.
5. Hente oppdatert oppsett i BxMobile
Etter at oppsettet er lagret, hent oppdaterte innstillinger i BxMobile via Oppsett → Innstillinger fra hovedmenyen, eller med F9 på terminaler med fysiske taster. Dersom enheten bruker et lokalt nedlastet produktregister, må også produktdataene oppdateres slik at de nye addwhenpicking-verdiene kommer med.
Se Hente innstillinger til BxMobile.
6. Kontroll og feilsøking
Kontroller oppsettet med en avtalt testordre før det tas i vanlig bruk:
- Søk etter ett tillatt og ett ikke-tillatt produkt i funksjonen for å legge til produkter. Bare det tillatte produktet skal kunne legges til der.
- Legg til det tillatte produktet og registrer et kjent antall, for eksempel 1 stk.
- Send plukket inn og kontroller at den ekstra linjen finnes i ERP med riktig produkt, antall, lager og enhet.
- For VismaNet: kontroller både den nye leveranselinjen og om leveransen er bekreftet i henhold til ønsket arbeidsflyt.
| Symptom | Kontroller |
|---|---|
| Alle produkter vises når du skal legge til en ny linje. | Kontroller om Products-spørringen gir 1 addwhenpicking til alle produkter, eller mangler feltet. Kontroller riktig klientprofil og oppdaterte produktdata på enheten. |
| Et ønsket produkt vises ikke. | Kontroller at produktet returneres av Products-spørringen, og at addwhenpicking er 1 for akkurat dette produktet. |
| Produktet kan legges til i BxMobile, men kommer ikke med i ERP. | Kontroller eksporten for nye linjer, at mappingene er aktivert, og eventuelle feilmeldinger fra innsendingen. En ekstra linje med antall 0 sendes ikke i den separate addproduct-flyten. |
| Linjen opprettes i VismaNet, men antall eller ferdigmelding blir feil. | Kontroller lines.quantity → shippedQty.value på addproduct, den ordinære pickinglist → create-eksporten, confirmShipment og feilmeldinger fra VismaNet. Ikke anta at opprettet linje betyr at leveransen også er bekreftet. |