Duplikatkontroll for salgsordre
I noen tilfeller kan det opprettes dobbelt opp av en salgsordre, denne artikkelen tar for seg hvordan det kan løses
I noen tilfeller kan samme salgsordre eller samme plukk bli sendt to ganger til ERP. Denne artikkelen forklarer hvorfor det skjer, hvilke unike nøkler Bx sender med, og hvordan duplikater kan stoppes i Bx eller i ERP/API.
Innhold- 1. Hvorfor oppstår duplikater
- 2. Unike nøkler fra Bx
- 3. Duplikatkontroll i Bx for salgsordre
- 4. Duplikatkontroll i ERP eller API
- 5. Oppsummert
1. Hvorfor oppstår duplikater
Håndterminalen sletter/avslutter ordren eller plukket (i BxMobile) først når den har fått svar fra BxEngine om at sendingen gikk bra. Hvis ERP har tatt imot dataene, men svaret ikke kommer fram til håndterminalen (tidsavbrudd, dårlig nettverk eller lang behandlingstid i ERP), ligger ordren eller plukket fortsatt på håndterminalen. Sender brukeren på nytt, kommer de samme dataene inn i ERP en gang til.
Ved plukk der ERP tillater overplukk, gir dette dobbelt plukket antall på ordren.
2. Unike nøkler fra Bx
2.1 idempotencykey
Håndterminalen lager en unik nøkkel (GUID) i feltet idempotencykey når en ny ordre opprettes. Nøkkelen lagres sammen med ordren på håndterminalen og er den samme hvis ordren sendes på nytt. Den sendes for:
- Salgsordre (også ved kopiering av ordre, som da får en ny nøkkel)
- Innkjøpsordre som opprettes i appen
- Lageroverføring
- Lagerjustering
2.2 Plukk
Plukk har ikke idempotencykey. Plukklistenummeret (pickinglist) er heller ikke unikt per sending når det tillates restordre eller delplukk, siden samme plukkliste kan sendes flere ganger.
Bruk i stedet kombinasjonen av pickinglist og bxstartedtime. bxstartedtime er tidspunktet plukkeren åpnet plukklisten på håndterminalen:
- Sendes samme plukk på nytt, for eksempel etter et tidsavbrudd, er bxstartedtime den samme.
- Åpnes plukklisten på nytt for et restplukk etter at forrige plukk er sendt, får det nye plukket et nytt tidspunkt.
- Fortsetter brukeren på et påbegynt plukk som ligger på håndterminalen, beholdes tidspunktet.
3. Duplikatkontroll i Bx for salgsordre
For salgsordre kan BxEngine stoppe en ordre som allerede er sendt, før den sendes til ERP. Kontrollen kjører en SQL-spørring med navnet DuplicateOrderValidation. Gir spørringen en rad, stoppes ordren, og brukeren får meldingen i feltet bxMessage. Kontrollen finnes bare for salgsordre (salesorder: create).
3.1 Cloud
- Legg til DuplicateOrderValidation = true i Export to ERP → salesorder: create → Export config.
- Legg til en spørring under SQL Integration med navnet DuplicateOrderValidation:
select
customerno,
orderno,
'Duplikatkontroll! Ordre til kundenr ' || customerno || ' er allerede sendt. Denne ordren kan du ikke sende igjen.' bxMessage,
idempotencyKey
from
system.TransactionLog
where
idempotencyKey = '#idempotencyKey#'
limit 1
Spørringen leser Bx sin transaksjonslogg. Transaksjonsloggen skrives etter at ordren er sendt til ERP, så kontrollen virker ikke hvis TransactionLog = false er satt i Export config. Loggen skrives i bakgrunnen noen sekunder etter sendingen, så to sendinger med bare sekunders mellomrom kan begge slippe gjennom.
3.2 OnPrem
- Legg til DuplicateOrderValidation = true i Export to ERP → salesorder: create → Export config.
- Legg til mapping i salesorder: create → Export mapping med sourcefield = idempotencykey og destination = et ledig felt på ordren i ERP.
- Legg til en spørring under SQL Integration med navnet DuplicateOrderValidation. Bytt ut ordretabell og feltnavn med tabellen og feltet i ERP:
select top 1
customerno,
orderno,
concat('Duplikatkontroll! Ordre til kundenr ', customerno, ' er allerede sendt. Denne ordren kan du ikke sende igjen.') bxMessage
from
ordretabell --BxEngine.dbo.TransactionLog hvis BxEngine transaksjonslogg benyttes
where
feltnavn = '#idempotencyKey#' --idempotencyKey = '#idempotencyKey#' hvis BxEngine transaksjonslogg benyttes
4. Duplikatkontroll i ERP eller API
Den sikreste kontrollen er i ERP eller i API-et som tar imot dataene fra Bx, fordi ERP vet hva som faktisk er bokført. Send den unike nøkkelen med i Export mapping, og la ERP eller API-et sjekke om nøkkelen er mottatt før.
Hvis nøkkelen allerede er mottatt, bør ERP eller API-et svare OK uten å bokføre på nytt. Svarer det med feil, blir ordren eller plukket liggende på håndterminalen, og brukeren må slette/avbryte det selv.
4.1 Salgsordre, innkjøpsordre, lageroverføring og lagerjustering
Legg til mapping i Export to ERP → [routine]: create → Export mapping med sourcefield = idempotencykey og destination = feltet i ERP eller API-et som skal ta imot nøkkelen.
4.2 Plukk
Legg til mapping i Export to ERP → pickinglist: create → Export mapping med sourcefield = bxstartedtime og destination = feltet i ERP eller API-et som skal ta imot tidspunktet. Plukklistenummeret er normalt allerede mappet (sourcefield = pickinglist).
ERP eller API-et lagrer plukklistenummer og bxstartedtime for hvert mottatt plukk og hopper over plukk der kombinasjonen allerede finnes. Sammenlign bxstartedtime som tekst, nøyaktig slik den kommer inn.
5. Oppsummert
- Salgsordre: DuplicateOrderValidation i Bx, eventuelt i tillegg idempotencykey til ERP.
- Innkjøpsordre, lageroverføring og lagerjustering: send idempotencykey til ERP eller API, og la ERP stoppe duplikater.
- Plukk: send pickinglist og bxstartedtime til ERP eller API, og la ERP stoppe duplikater.