Polygon Retail Solutions Dok.nummer: Tittel: Integrasjon Nettbutikk Status: Under arbeid Versjon: 1.9 Godkjent: Skrevet av: Tom Nøkleby Integrasjon Nettbutikk Endringslogg Ver Dato Sign Merknad 1.0 22/2-09 TN Dokument opprettet og ferdigstilt for driftsmodell 1. 1.1 16/4-09 TN Oppdatert filbeskrivelser som manglet. Lagt inn skisse av datamodell for data som eksporteres til Nettbutikk Det er lagt inn flere tabeller som det eksporteres data fra. Blant annet kunde og medlemsregisteret. 1.2 19/5-09 TN - Varefil WBART er utvidet med felt som alltid viser normalpris og et felt for anbefalt pris. - Utlegg av størrelsestyper er lagt inn. - Utlegg av fargekodetabellen er lagt inn. 1.3 25/5-09 TN WBART filen. Nytt felt ArtBas.Farg som inneholder fargekoden er lagt ut. 1.4 29/5-09 TN WBART filen nye felt for post og web informasjon lagt til. 1.5 26/6-09 TN WBORD og WBKO filene er ferdig og beskrevet. Forretningsprosesser bskrevet. 1.6 30/6-09 TN Lagt inn beskrivelse av integrasjon mot WinEDI. 1.7 9/4-10 TN Lagt inn nytt felt Kode i WbLag (Lager) utlegget. 1.8 10/6-10 TN - Etablering av kundeidentitet mellom nettbutikk og butikksystem. Kunder opprettet i butikksystem, får sitt kundenummer lagt inn som eksternt kundenummer, når de markeres som nettbutikkunde. 1.9 18/6-10 TN To nye felt i WbArt - Kun kunder som er markert som nettbutikkunde, eksporteres fra butikksystem. - Bonus_Givende (Artikkelen er med i grunnlag for medlemsbonus) - PubliserINettbutikk (Styrer om artikkelen skal publiseres direkte i nettbutikk) Integrasjon Nettbutikk 1 Bakgrunn... 3 Forutsetninger... 3 Generelle forutsetninger Alle driftsmodeller... 3 Forutsetninger driftsmodell... 3
Driftsmodeller for ulike typer av integrasjon... 3 Generelt... 3 Generelle forutsetninger... 3 Driftsmodell 1 - Logistikk og vareutlevering fra nettbutikk... 5 Forutsetninger... 5 Skjematisk oversikt meldingsflyt... 6 Meldingsoversikt faste registre, vare og prisinformasjon... 9 Meldingsoversikt kunde, medlem, lager og ordremeldinger... 9 Databasemodell hvordan data i meldingene relaterer seg til hverandre... 11 Forretningsprosesser... 12 Driftsmodell 2 - Logistikk og vareutlevering fra butikksystem... 13 Forutsetninger... 13 Skjematisk oversikt meldingsflyt... 13 Meldingsoversikt... 14 Forretningsprosesser... 14 Her beskrives kort de forretningsprosesser som avviker fra driftsmodell 1.... 14 Meldingsspesifikasjoner... 15 Generelt... 15 Faste registre, vare og prisinformasjon... 15 Kunde, lager og ordremeldinger... 26 Definisjoner... 41 Definisjoner... 41 Vedlegg WinEDI integrasjon... 42 Spesifikasjon av etikettfil til WinEDI... 42 Spesifikasjon av kvitteringsfil fra WinEDI... 44 Polygon Software AS Integrasjon Nettbutikk 2
Bakgrunn Stadig flere ønsker en kombinert drift av nettbutikk og ordinær butikkdrift. Videre er det også varierende behov og ønsker i forhold til hvordan man ønsker å integrere nettbutikk og butikksystem. Integrasjonen som er tatt frem for PRS, er basert på 2 ulike driftsmodeller. 1. Ordresetting, betaling og ordrebehandling utføres i Nettbutikk 2. Ordresetting og betaling utføres i Nettbutikk, mens ordrebehandling foretas i butikksystemet. Forutsetninger Generelle forutsetninger Alle driftsmodeller Forutsetninger driftsmodell Driftsmodeller for ulike typer av integrasjon Generelt Selv om flere kunder benytter samme systemer og integrasjon, vil det forekomme at kunden velger ulik type av driftsmodell. Utfordringen for systemene som er integrert, er å kunne støtte ulike typer av driftsmodeller basert på samme integrasjon. Kunden skal optimalt sett kunne velge den driftsform som passer hans organisasjon best. Det som gjør det mulig for en kunde å kunne velge mellom ulike typer av driftsmodeller, er blant annet at de integrerte systemer har overlappende funksjonalitet, og at denne funksjonaliteten kan styres fra det integrerte system, eller at den kan kobles ut. Generelle forutsetninger Som grunnlag for integrasjonen er det lagt en del forutsetninger som virker bestemmende for den måten integrasjonen er løst på. Forutsetninger som ikke er generelle, men gjelder en spesifikk driftsform, er beskrevet under driftsform. De generelle forutsetningene er: 1. Det kan bare integreres en nettbutikk mot et butikksystem Årsaken til denne begrensing ligger i det oppsett som er gjort i meldingshåndteringen. Butikksystemet vil kunne utvides til å håndtere integrasjon mot mer enn en nettbutikk, men dette vil kreve en god del utviklingsarbeide i butikksystemet. Det ble ikke ansett som aktuelt å skulle integrere mer enn en nettbutikk mot et butikksystem. 2. Med faste registre menes grunnregistre som endres sjelden. For eksempel sesongkoder, farger m.m. Men faste registre omfatter også registre som beskriver varestruktur, som avdeling, hovedgruppe og varegrupperegistre. Polygon Software AS Integrasjon Nettbutikk 3
3. Butikksystemet er artikkelmaster Butikksystemet skal være artikkelmaster. Og det skal ha funksjoner for å kunne velge ut hele eller deler av artikkelregisteret og overføre dette til nettbutikken. Så mye som mulig av artikkelvedlikeholdet skal kunne foregå i butikksystemet. Data som ikke kan vedlikeholdes der og som er nødvendig for nettbutikken, må vedlikeholdes i nettbutikken. 4. Nettbutikken tildeles et butikknummer i butikksystemet Nettbutikkens salg og lagerbevegelser rapporteres inn på et butikknummer i butikksystemet. - Dette gjør at nettbutikken kan følges opp i butikksystemet på samme måte som de andre butikkene i systemet. - Logistikkfunksjoner som benyttes mellom butikkene kan også benyttes mot nettbutikken. - Dagsoppgjør følges opp i butikksystemet på samme måte som butikksystemets øvrige butikker 5. Nettbutikkens tilgjengelige lager skal kunne omfatte en eller flere butikkers lager Det lager som er tilgjengelig for nettbutikken, skal kunne bestå av en eller flere av butikkenes lager i butikksystemet, i tillegg til nettbutikkens eget lager. 6. Oppdateringsfrekvens mellom systemene Fra butikksystem, legges register, artikkel og lagerendringer ut fortløpende. Det er benyttet databasetriggere som umiddelbart logger endringer, kombinert med en dataeksport server som kontinuerlig leser endringsloggen og legger ut endrede poster til nettbutikk (og kasser i butikkene). Informasjon om normalprisendringer og tilbudspriser sendes nettbutikk på lik linje med kassene i butikksystemet. Fra nettbutikk legges ut ordre når disse registreres og endrer status. 7. Frihet i valg av driftsmodell Hvis nettbutikken har funksjoner for det, skal ordrebehandling og vareutlevering valgfritt kunne gjøres i nettbutikk eller i butikksystem. Med valgfritt menes at man kan velge driftsmodell, ikke at man kan blande ulike driftsmodeller i samme installasjon. 8. Prisvedlikehold og kampanjehåndtering Kampanjer og priser for nettbutikken, vedlikeholdes i nettbutikken hvis disse avviker fra butikksystemet. Butikksystemet har samme prisbilde i alle butikkene. Dette gjelder også for nettbutikken. Dette innebærer at hvis nettbutikken skal ha avvikende priser i forhold til butikksystem, må nettbutikken ha funksjoner for lokalt vedlikehold av pris samt at det ved import av prisendringer fra butikksystemet, finnes mulighet for å godkjenne eller endre prisoppdateringer derfra, før de aktiveres i nettbutikken. 9. Opprettelse og vedlikehold av kunderegister Nettbutikken har behov for å holde orden på alle kunder som handler i nettbutikken. Butikksystemet har behov for å holde orden på alle kunder som skal ha kunderabatt og/eller kan handle på kreditt. Som følge av dette, skal kunderegister overføres fra butikksystem til nettbutikk fortløpende når det gjøres nyregistrering eller endringer, mens det fra nettbutikken bare legges ut kundeinformasjon på kunder som er kjent i butikksystemet. Dvs. kunder som bare handler i nettbutikken, vil ikke bli opprettet som kunder i butikksystemet. Det er bare kunder som er markert som nettbutikkunde, som legges ut til nettbutikken fra butikksystemet. Polygon Software AS Integrasjon Nettbutikk 4
10. Etablering av felles identitet på kunde i begge systemer Kunder som opprettes i butikksystemet, får kopiert sitt eget kundenummer over i feltet Eksternt kundenummer, når kunden markeres som nettbutikk kunde (Egen kryssboks for dette i kundebildet). Slik at nettbutikken skal benytte dette feltet, når kunden etableres i nettbutikkens kunderegister. Kunder som opprettes i nettbutikk, får tildelt sitt kundenummer der. Ved eksport og import i butikksystem. Dette har som konsekvens, at det kan få uønskede konsekvenser å endre eksternt kundenummer i kundebildet i butikksystemet, hvor feltet er åpent for redigering. Brukerne av butikksystemet må være klar over dette. 11. Kreditsalg Kreditsalg forekommer bare i butikksystem. Alt salg i nettbutikk forhåndsbetales i nettbutikk. Ordre som sendes over til butikksystem er alltid ferdig betalt, og det genereres ikke faktura på disse ordrene når de utleveres fra butikksystemet. 12. Oppfølging av vareforsendelser Oppfølging av vareforsendelser er løst ved integrasjon mot WinEDI. WinEDI er et program som skriver ut postetiketter til vareforsendelser. Samt at det også genererer unike sendingsnummer som kan benyttes i postens system for å spore hvor langt varen har kommet. 13. Retur av varer Retur av varer foretas i sin helhet i butikksystemet. Det går ingen melding til nettbutikken om dette. 14. Reklamasjonshåndtering Reklamasjonshåndteringen foretas i sin helhet i butikksystemet. Det går ingen melding til nettbutikken om dette. 15. Kundeklubb (Sluttkunder som har medlemskap mot nettbutikk/butikksystem) Funksjoner for dette finnes i butikksystem. Disse er ikke integrert mot nettbutikken. 16. Klubbsalg med medlemsoppfølging (Medlemskap via sports eller fritidsklubb) Funksjoner for dette finnes i butikksystem. Disse er ikke integrert mot nettbutikken. Driftsmodell 1 - Logistikk og vareutlevering fra nettbutikk Forutsetninger 1. Nettbutikken må ha egen logistikkfunksjon som omfatter alle funksjoner for ordrebehandling og vareutlevering. Polygon Software AS Integrasjon Nettbutikk 5
Skjematisk oversikt meldingsflyt Oversiktsdiagram meldingsflyt faste registre, vare og prisinformasjon Figur 1 Meldingsflyt faste registre, vare og prisinformasjon I butikksystemet er det databasetriggere som logger at det er skjedd endringer i de ulike registrene. 1. Detekteres en endring, skapes en post i tabell ELogg, som peker på den posten som er endret. 2. En prosess som går kontinuerlig - Elogg server sjekker ELogg tabellen, for å se om det er gjort endringer som skal sendes til kasser og/eller nettbutikk. 3. Alle loggposter som er opprettet siden forrige sjekk, blir tatt hånd om og lagt ut for overføring til nettbutikk. 4. I hvert utlegg, kan det ligge poster fra flere ulike tabeller. Hvert utlegg skapes som et filsett og er tildelt samme sekvensnummer (Sekvensnummer i filnavn). Det er alltid bare siste instans av en endret post som sendes. Gjøres det flere uavhengige endringer mellom to sendinger av samme post (F.eks en leverandør), er det bare den sist oppdaterte informasjonen som sendes. Endringer i prisinformasjon oppstår som konsekvens av at en pris er endret, eller at en priskøpost er aktivert. Prisendringer kan i butikksystemet settes til en Polygon Software AS Integrasjon Nettbutikk 6
aktiveringsdato/tid frem i tid. Slike endringer legges i en priskøtabell. Klargjøring av priskøen gjøres av en automatisk prosess. Kampanjer som aktiveres, legges alltid først i priskøen, og aktiveres derfra inn i prisregisteret. Ved endring av pris, legges også alltid artikkelinformasjonen ut. Likeledes - ved endring av artikkelinformasjonen, legges også alltid prisinformasjonen ut. Artikkelen er utstyrt med er aktiveringsflagg som indikerer om den også er lagt ut til nettbutikk. Ved å sette dette flagget, skapes en post i ELogg tabellen, og varen med tilhørende prisinformasjon legges ut. Fillogg For at det for nettbutikken skal være mulig å se hvilken rekkefølge filene skal leses i, legges det ut en fillogg. Filnavn: webfillog04-02-09.csv (webfillogdd-mm-åå.csv) Denne inneholder en sekvensiell liste over alle filer som legges ut. Det startes en ny logg pr. døgn. Filinnhold: Eksempel på filinnhold "04/02/09";"13:31:46";"WBART00000106.xml";19794;17313295 "04/02/09";"13:31:46";"WBAVD00000106.xml";9;1085 "04/02/09";"13:31:46";"WBHGR00000106.xml";80;9221 "04/02/09";"13:31:47";"WBVGR00000106.xml";660;113008 "04/02/09";"13:31:47";"WBKAT00000106.xml";4;486 "04/02/09";"13:31:47";"WBAKT00000106.xml";3;383 "04/02/09";"13:31:47";"WBLEV00000106.xml";238;23336 "04/02/09";"13:31:47";"WBPRO00000106.xml";3;380 "04/02/09";"13:31:47";"WBVMI00000106.xml";888;114128 "04/02/09";"13:31:48";"WBSAS00000106.xml";32;3127 "04/02/09";"13:31:48";"WBMAT00000106.xml";3;380 "04/02/09";"13:31:49";"WBLAG00000106.xml";335;94772 "04/02/09";"13:53:43";"WBART00000107.xml";32;28557 Polygon Software AS Integrasjon Nettbutikk 7
Oversiktsdiagram driftsmodell 1 Figur 2 Oversiktsdiagram logistikkstyring og vareutlevering Her er også databasetriggere benyttet for å trigge utlegg av noen av meldingene. Dette gjelder kundemelding (WBKUN) og lagermelding (WBLAG). Mottak av en WBREQ melding fra nettbutikken, medfører at det skapes en loggpost i ELogg tabellen. Endring av kundeinformasjon medfører at databasetrigger skaper en post i ELogg tabellen. NB: Dette innebærer at en kundemelding fra nettbutikken alltid resulterer i at det sendes en kundemelding tilbake til nettbutikken. Endring av lagerteller på en artikkel som også er flagget som nettbutikkartikkel, medfører at artikkelen logges i ELogg tabellen. Samtlige lagertellere på artikkelen (Alle butikker og alle størrelser) legges ut. Ordrebehandling og vareutlevering skjer i nettbutikk. Det er derfor bare nødvendig å sende overføringsordre og salgsordre til butikksystemet. Butikksystemets kundeordremodul benyttes ikke. For å unngå problemer med automatisk utskrift på skriver i butikk, er det valgt en løsning hvor det istedenfor sendes en email til butikken med nødvendig informasjon om hvilken vare og hvor varen skal sendes. Polygon Software AS Integrasjon Nettbutikk 8
Meldingsoversikt faste registre, vare og prisinformasjon Meldingsnavn Retning Drifts Beskrivelse Modell WBAVD<Sekv.nr>.xml N B Alle Avdelingsregister. Øverste nivå i varestrukturen. WBHGR<Sekv.nr>.xml N B Alle Hovedgrupperegister. Mellomste nivå i varestrukturen. WBVGR<Sekv.nr>.xml N B Alle Varegrupperegister. Laveste nivå i varestrukturen. WBKAT<Sekv.nr>.xml N B Alle Kategoriregister. Sideordnet varestruktur på artikkelnivå. WBAKT<Sekv.nr>.xml N B Alle Aktivitetsregister. Sideordnet varestruktur på varegruppenivå. WBVAK<Sekv.nr>.xml N B Alle Kobling mellom aktivitetsregister og varegruppe. WBLEV<Sekv.nr>.xml N B Alle Leverandørregister. WBPRO<Sekv.nr>.xml N B Alle Produsentregister. WBVMI<Sekv.nr>.xml N B Alle Varemerkeregister. WBSAS<Sekv.nr>.xml N B Alle Sesongregister. WBMAT<Sekv.nr>.xml N B Alle Materialkoderegister. WBFAR<Sekv.nr>.xml N B Alle Fargekoderegister WBART<Sekv.nr>.xml N B Alle Artikkel og prisinformasjon WBRAB<Sekv.nr>.xml N B Alle Overføring av rabattmatrise til nettbutikk. WBMVA<Sekv.nr>.xml N B Alle Momskoderegister WBSTR<Sekv.nr>.xml N B Alle Størrelseskoderegister WBSTT<Sekv.nr>.xml N B Alle Størrelsestyper Meldingsoversikt kunde, medlem, lager og ordremeldinger Meldingsnavn Retning Drifts Modell Beskrivelse WBKUN<Sekv.nr> N B Alle Melding om ny/endret kreditkunde til nettbutikk WBKUN<Sekv.nr> N B Alle Melding om ny/endret kunde fra nettbutikk. WBKGR<Sekv.nr> N B Alle Melding om ny/endret kundegruppe til nettbutikk WBKKO<Sekv.nr> N B Alle Melding om ny/endret kundekort til nettbutikk WBKSA<Sekv.nr> N B Alle Melding om ny/endret kundesaldo til nettbutikk WBMED<Sekv.nr> N B Alle Melding om ny/endret medlem til nettbutikk WBMGR<Sekv.nr> N B Alle Melding om ny/endret medlemsgruppe til nettbutikk WBMKO<Sekv.nr> N B Alle Melding om ny/endret medlemskort til nettbutikk WBMSA<Sekv.nr> N B Alle Melding om ny/endret medlemsaldo til nettbutikk WBART<Sekv.nr>.xml N B Alle Melding om deaktivering av artikkel i nettbutikk. WBLAG<Sekv.nr>.xml N B Alle Lagerinformasjon. Lager i alle butikker for en artikkel og størrelse Polygon Software AS Integrasjon Nettbutikk 9
Meldingsnavn Retning Drifts Beskrivelse Modell WBREQ<Sekv.nr>.xml N B Alle Nettbutikk ber om å få overført lagersaldo på angitt(e) artikler JOURNAL overføringsordre N B Modell 1 Overføringsordre fra nettbutikk JOURNAL salgsordre N B Modell 1 Salgsordre fra nettbutikk (Oppdateres som kontantsalg) email overføringsordre N B Alle Overføringsordre sendt pr. email til den butikk som vare skal overføres fra. Faktura N Kunde Modell 1 Når vare utleveres fra nettbutikk, utstedes også faktura som følger vare til kunde. Polygon Software AS Integrasjon Nettbutikk 10
Databasemodell hvordan data i meldingene relaterer seg til hverandre For å få en lettere forståelse av hvordan data i de ulike meldingene relaterer seg til hverandre, er det her satt opp et relasjonsskjema for de tabellene som berøres av meldingene i butikksystemet. Figur 3 Datamodell for data som legges ut til nettbutikk Artikkelinformasjonen legges ut til nettbutikk på EAN kode nivå. Dette er en flatere struktur enn den som ligger i butikksystemet, hvor en artikkel holder på flere størrelser og hvor hver størrelse igjen kan holde på en eller flere EAN koder. Polygon Software AS Integrasjon Nettbutikk 11
Rabattmatrisen er gitt ved en prosentsats pr. varegruppe og kundegruppe. Kunde er koblet til kundegruppe og gis derigjennom en kundegrupperabatt basert på hvilken varegruppe artikkelen tilhører. I figuren er navn på koblingsfelt satt inn på koblingene. Forretningsprosesser Integrasjonen mellom nettbutikk og butikksystem er laget for å dekke de forretningsprosesser som er beskrevet under. Noen av disse prosessene går over begge systemene. Oversikt over funksjoner og meldinger mellom systemenes funksjoner/moduler, er skissert i figurer. Datastrømmene er også tegnet inn i figurene. For nettbutikken er det kun tatt med de prosesser som berører integrasjonen med butikksystemet. Tilsvarende gjelder for butikksystemet. Registervedlikehold Ønsket registervedlikeholdsprogram åpnes. Ny post opprettes eller den som skal endres søkes frem. Data registreres. Ved lagring av ny eller endret post, logges endring i ELogg tabellen. En automatisk prosess (ELogg server) detekterer at det er skjedd en endring og legger denne ut til nettbutikken. Nettbutikken ser at det er kommet en endringsfil. Leser inn denne og oppdaterer aktuelt register. Aktivering / deaktivering av varer i nettbutikk Vare som skal aktiveres i nettbutikk søkes fram og nettbutikkflagget settes. Endring logges i ELogg. Vare med vareinformasjon og priser legges ut til nettbutikk. Nettbutikk leser inn og oppretter ny vare. Ny vare må godkjennes i nettbutikken før den tilgjengeliggjøres i nettbutikk for nettbutikkundene. Godkjenning innebærer kontroll/rediger av vareinformasjon og priser. Vare og prisvedlikehold Vare som skal endres søkes frem og endring gjøres i vareinformasjon og/eller pris. Endring logges i ELogg. Vare med vareinformasjon og priser legges ut til nettbutikk. Nettbutikk leser inn og oppdaterer varen. Prisendringer aktiveres ikke i nettbutikk før de er godkjent. Salg Kunde logger på nettbutikk, søker frem varer som skal kjøpes, godkjenner ordre og gjennomfører betaling. Når salgsordre er godkjent og betalt av kunde, sendes journalfil med overføringsordre til butikksystemet. I butikksystemet genereres en overføringsordre som oppdateres direkte, samt at en email med informasjon om overføringsordren sendes til butikken som skal sende varen nettbutikken. Det genereres også en lagermelding som oppdaterer lager i nettbutikken med det antall av en vare/størrelse som den har bedt om. Når nettbutikken mottar varen, pakkes og sendes denne til kunde. Når ordren markeres som utlevert, genereres en journal salgsordre som sendes butikksystemet. Denne oppdaterer lager og statistikker i butikksystemet. Nettbutikken ligger her med et eget butikknummer hvor lager og statistikk posteres. Polygon Software AS Integrasjon Nettbutikk 12
Driftsmodell 2 - Logistikk og vareutlevering fra butikksystem I dette kapitlet beskrives det som avviker i driftsmodell 2 i forhold til driftsmodell 1. Forutsetninger 1. Logistikkfunksjonen for nettbutikken ligger i butikksystemet. Ordrebehandling og vareutlevering foretas i butikksystemet. 2. Nettbutikk håndterer ordreregistrering fra kunde og betaling. Samt transaksjonshåndteringen mot bank. Skjematisk oversikt meldingsflyt Meldingsflyt faste registre, vare og prisinformasjon Alle meldinger som gjelder faste registre, artikkelinformasjon og lagerinformasjon, er det samme som er beskrevet i driftsmodell 1. Oversiktsdiagram driftsmodell 2 Figur 4 Oversiktsdiagram logistikk og vareutlevering driftsmodell 2. Ordre fra nettbutikk sendes som en melding (WBORD) til butiksystemet, hvor ordrene leses inn og legges inn i ordreregisteret med status bekreftet. Ordrene er Polygon Software AS Integrasjon Nettbutikk 13
også merket med nettbutikk som opphav. Slik at det er lett å finne igjen disse i butikksystemet. Når butikksystemet oppdaterer ordrestatus eller annen relevant ordreinformasjon, legges det ut en melding til nettbutikken om dette (WBKOR). Databasemodell hvordan data i meldingene relaterer seg til hverandre Også meldingene i driftsmodell 2 er dekket i databasemodellen som er vist under driftsmodell 1. Meldingsoversikt Meldingsnavn Retning Drifts Øvrige meldinger er beskrevet under driftsmodell 1. Modell Beskrivelse WBKOR<Sekv.nr> N B Alle Melding om endret salgsordre fra butikksystem til nettbutikk WBORD<Sekv.nr> N B Alle Melding om ny salgsordre fra nettbutikk til butikksystem Forretningsprosesser Her beskrives kort de forretningsprosesser som avviker fra driftsmodell 1. Salg Nettbutikken sender bekreftet og betalt salgsordre til butikksystemet (WBORD). Butikksystemet tar imot salgsordren og lagrer den som bekreftet ordre. Den merkes også med nettbutikk som opphav. Vareutlevering og sending Bekreftet ordre hentes opp. Lager kontrolleres og varene klargjøres for utsendelse. Salgsordre markeres som utlevert. Salgsordren kjøres automatisk helt opp til ferdigbehandlet. Endret salgsordre legges ut til nettbutikk hvor den importeres og endringer oppdateres på salgsordre der. Det reserverte beløp trekkes fra kundens konto. Ved utlevering av en ordre, sendes en melding til WinEDI som skriver ut en postetikett til forsendelsen. WinEDI genererer et sendingsnummer som sendes tilbake til butikksystemet hvor ordren oppdateres. Den oppdaterte ordren legges så ut til nettbutikken som igjen oppdaterer sin versjon avordren. Hver gang salgsordren senere endrer status, legges den ut til nettbutikken (WBKOR), slik at denne kan oppdatere salgsordren i nettbutikken, hvor den også er synlig for kunden. Varemankohåndtering Kunde kontaktes og informeres om situasjonen. Salgsordre endres eller kanselleres avhengig av hva man blir enige om med kunden. De varelinjer som fortsatt skal sendes til kunden, utleveres. Endret salgsordre legges ut til nettbutikk hvor endringer oppdateres. Beløp på utleverte varelinjer trekkes fra kundens konto. Eventuelt overskytende reservert beløp, frigis. Endringer på salgsordre kan innbefatte sletting av linjer, endring av linjer og opprettelse av nye linjer på salgsordren. Polygon Software AS Integrasjon Nettbutikk 14
Returer Håndteres i butikksystemet. Her er ordren sluttført i nettbutikken og betaling er allerede trukket fra kundens konto. Utlevering av ny vare eller utbetaling av kontanter til kunden, gjøres fra butikken, ikke fra nettbutikken. Reklamasjon Håndteres i butikksystemet. Her er ordren sluttført i nettbutikken og betaling er allerede trukket fra kundens konto. Utlevering av ny vare eller utbetaling av kontanter til kunden, gjøres fra butikken, ikke fra nettbutikken. Meldingsspesifikasjoner Generelt Alle poster har et felt irectype som kan inneholde verdiene 1-Ny, 2-Endring eller 3-Slett. Normalt sendes irectype = 1 for både ny og endring. Mottager må derfor sjekke om posten finnes fra før. Gjør den ikke det, opprettes den, finnes den, skrives den over. Videre legges feltene i den unike indeksen ut på et høyere nivå enn de øvrige feltene. Dette åpner for at mottaker kan sjekke om posten finnes og eventuelt forkaste posten hvis den gjør det, uten å måtte lese alle feltene i posten først. Faste registre, vare og prisinformasjon Avdelingsregister (WBAVD Til nettbutikk) Filnavn: WBAVD<Sekv.nr>.xml Avdeling int >>>9 AvdelingNavn char X(30) Hovedgrupperegister (WBHGR Til nettbutikk) Filnavn: WBHGR<Sekv.nr>.xml Hg int >>>9 HgBeskr char X(30) AvdelingNr Int >>>9 Polygon Software AS Integrasjon Nettbutikk 15
Varegrupperegister (WBVGR Til nettbutikk) Filnavn: WBVGR<Sekv.nr>.xml Vg int zzzzz9 VgBeskr char X(30) Hg Int >>>9 Momskod Int z9 Kost_Proc Dec zz9.9 Mva_Proc dec zz9.9 Kategoriregister (WBKAT Til nettbutikk) Filnavn: WBKAT<Sekv.nr>.xml KatNr int z9 Beskrivelse Char X(30) Koblingstabell varegruppe og kategoriregister (WBVKA Til nettbutikk) En varegruppe kan få en eller flere kategorier knyttet til seg. Denne koblingstabellen forteller hvilke kategorier som er knyttet til varegruppen. Polygon Software AS Integrasjon Nettbutikk 16
Artikler som ligger i varegruppen, kan bare knyttes til en av de kategoriene som er tilgjengeligjort på varegruppen. Derfor er begge feltene Vg og VgKat lagt inn på artikkel. Filnavn: WBVKA<Sekv.nr>.xml Vg int >>>>>9 VgKat Int >9 KatNr Int >9 Aktivitetsregister (WBAKT Til nettbutikk) Aktivitet beskriver aktivitet som en (eller flere) varegrupper kan inngå i. Filnavn: WBAKT<Sekv.nr>.xml AktNr int >>9 Beskrivelse Char X(30) Koblingstabell varegruppe og aktivitetsregister (WBVAK Til nettbutikk) En varegruppe kan få en eller flere aktiviteter knyttet til seg. Denne koblingstabellen forteller hvilke aktiviteter som er knyttet til varegruppen. Det er ingen kobling mellom aktivitet og artikkel. Dvs. at alle artikler som ligger på en varegruppe også inngår i de aktiviteter som knyttes til varegruppen. Filnavn: WBVAK<Sekv.nr>.xml Vg int >>>>>9 AktNr Int >>9 Polygon Software AS Integrasjon Nettbutikk 17
Leverandørsregister (WBLEV Til nettbutikk) Filnavn: WBLEV<Sekv.nr>.xml LevNr int >>>>>9 LevNamn Char X(30) Produsentregister (WBPRO Til nettbutikk) Filnavn: WBPRO<Sekv.nr>.xml ProdNr int >>>>>9 Beskrivelse Char X(30) Varemerkeregister (SBVMI Til nettbutikk) Filnavn: WBVMI<Sekv.nr>.xml VmId int >>>9 Beskrivelse Char X(30) KortNavn char X(10) Polygon Software AS Integrasjon Nettbutikk 18
Sesongregister (WBSAS Til nettbutikk) Filnavn: WBSAS<Sekv.nr>.xml Sasong int >>9 SasBeskr Char X(30) Materialkoderegister (WBMAT Til nettbutikk) Filnavn: WBMAT<Sekv.nr>.xml MatKod int >9 MatBeskr Char X(30) Fargekoderegister (WBFAR Til nettbutikk) Filnavn: WBFAR<Sekv.nr>.xml Farg int >>>>9 FarBeskr Char X(30) Polygon Software AS Integrasjon Nettbutikk 19
Mvaregister (WBMVA Til nettbutikk) Mvaregister som inneholder oppsettett av mvakoder og mva% for de respektive kodene. Filnavn: WBMVA<Sekv.nr>.xml MomsKod Int >9 MomsProc Dec >>9.99 Beskrivelse Char X(30) Rabattmatrise (WBRAB Til nettbutikk) Rabattmatrisen er gitt av kobling mellom varegruppe og kundegruppe. Det kan legges opp en rabatt% pr. kundegruppe for hver varegruppe. Det er en begrensing i kassasystemet på maks 9 kundegrupper. Derav følger at det kan legges opp maks 9 kundegrupperabatter på en varegruppe. Filnavn: WBRAB<Sekv.nr>.xml Vg int >>>>>9 Polygon Software AS Integrasjon Nettbutikk 20
GruppeId Int >>9 Rabatt_Proc Dec ->>,>>9.99 Størrelseskoderegister (WBSTR Til nettbutikk) Størrelseskoderegisteret inneholder alle størrelser som er tillatt brukt i systemet. Registeret inneholder et alfanumerisk størrelsesfelt og en numerisk størrelseskode. Den numeriske størrelseskoden er benyttet ved generering av bedriftsinterne EAN for å kunne få størrelsen inn i en EAN kode. Videre er det i nyere tabeller i databasen lagt inn StrKode istedenfor Storl feltet. Dvs. at programmene nå slår opp mot StrKonv tabellen for å finne den alfanumeriske verdien på størrelsen. Filnavn: WBSTR<Sekv.nr>.xml StrKode Int >>9 Storl Char X(10) Merknad Char X(30) Polygon Software AS Integrasjon Nettbutikk 21
Størrelsestyper (WBSTT Til nettbutikk) Størrelsestypen knyttes til artikkel og bestemmer derved hvilke størrelser som kan forekomme på artiklene den er knyttet til. En størrelsestype kan ha mange artikler knyttet til seg. Databasestrukturen har en hode linje struktur som består av tabellene StrType og StrTStr. StrTStr har strtypeid i seg som fremmednøkkel. Dvs. at det ligger en post pr. størrelse i StrTStr for hver størrelse som er koblet til størrelsestypen. StrTypeId binner sammen en størrelsestype. I tillegg må størrelsen være definert i størrelseskoderegisteret (StrKonv se over). I utlegget til xml filen er det lagt ut en record pr. post i StrTStr. Informasjonen fra StrType posten er lagt inn som som egne felt. Dvs. at informasjonen i disse gjentas for alle postene i en størrelsestype. Dette gjelder feltene Beskrivelse, Intervall, Fordeling, KortNavn, AlfaFordeling, Hg og AvdelingNr. Av historiske årsaker har ikke StrTStr tabellen feltet StrKode. Ønsker man å finne StrKode som motsvarer SoStorl (Størrelsesfeltet), må det gjøres oppslag i StrKonv tabellen med StrKonv.Storl = StrTStr.SoStorl. Av historiske årsaker er også Storl (og SoStorl) feltene formatert opp med space som første karakter på noen størrelser. Dette var tidligere nødvendig for å få en riktig rekkefølge på størrelsene når de skulle vises frem. Feltet StrTStr.SeqNr bestemmer nå rekkefølgen på størrelsene i størrelsestypen. Ved utlegg av varefil er både StrKode og Storl feltene lagt ut. Så dette skulle ikke by på noen problemer. Filnavn: WBSTT<Sekv.nr>.xml StrTypeId Int >>>>>9 Beskrivelse Char X(30) Intervall Char X(30) Fordeling Char X(30) KortNavn Char X(10) AlfaFordeling Char X(30) Hg Int >>>9 AvdelingNr Int >>9 SoStorl Char X(10) SeqNr Int >>9 StrKode Int >>>9 Polygon Software AS Integrasjon Nettbutikk 22
Artikkel og prisregister (Til nettbutikk) Filnavn: WBART<Sekv.nr>.xml ArtikkelNr Dec >>>>>>>>>>>>9 ModellFarge dec >>>>>>>>>>>>9 LevKod Char X(20) Beskr Char X(30) LevFargKod char X(20) StrTypeId int >>>>>9 StrKode int >>9 Storl Char X(10) Kode (EAN) char X(20) Salgsenhet char X(10) AntIPakn int >>>9 Lokasjon char X(20) LevNr int >>>>>9 Varefakta char X(40) VPIBildeKode char X(30) Polygon Software AS Integrasjon Nettbutikk 23
VmId int >>>9 ProdNr int >>>>>9 Sasong int >>9 MatKod int >9 Vg int >>>>>9 VgKat int >9 Anv-Id int >9 InnkjopsPris dec ->>>,>>9.99 Rab1_Proc dec ->>,>>9.99 Varekost dec ->>>,>>9.99 MvaKode int >9 Mva_Proc Dec ->>,>>9.99 Db_Proc dec ->>,>>9.99 Pris dec ->>>,>>9.99 Tilbud log Yes/no Aktiveringsdato Date DD:MM:YYYY Aktiveringstid char HH:MM:SS AvsluttDato Date DD:MM:YYYY AvsluttTid char HH:MM:SS InnkjopsPris dec ->>>,>>9.99 Rab1_Proc dec ->>,>>9.99 Varekost dec ->>>,>>9.99 MvaKode int >9 Mva_Proc Dec ->>,>>9.99 Db_Proc dec ->>,>>9.99 Pris dec ->>>,>>9.99 AnbefaltPris Dec ->>>,>>9.99 PostVekt Dec ->>>,>>9.999 PostLengde Int ->>>,>>9 PostBredde Int ->>>,>>9 PostHoyde Int ->>>,>>9 WebMinLager Dec ->>>,>>9.999 Kampanjekode Char X(20) WebLeveringstid Int >9 Varetype Int 9 Varetypetekst Char X(20) Leveringstid Int >9 Bonus_Givende Log Yes/No PubliseINettbutikk Log Yes/No Polygon Software AS Integrasjon Nettbutikk 24
Bilde av varefilen under, viser ikke alle nodene. For fullstendig oversikt over nodene se tabell over. Polygon Software AS Integrasjon Nettbutikk 25
Kunde, lager og ordremeldinger Kunderegister (WBKUN Til nettbutikk) Informasjon fra kunderegister. En kunde kan ha et eller flere kundekort koblet til seg. En kunde har (kan ha) en kundesaldo pr. butikk. Filnavn: WBKUN<Sekv.nr> Adresse1 char "X(40)" Adresse2 char "X(40)" Aktiv Log Alder Int >>9 BankKonto Char X(20) BetBet Int >>9 BetType Int >9 BrukerID Char X(10) ButikkNr Int >>>>>9 BydelsNr Char X(8) DeresRef Char X(30) EDato Date 99/99/9999 EksterntKundeNr Char X(20) epostadresse Char X(40) Etablert Date 99/99/99 ETid Int >>>>>>>9 FaktAdresse1 Char X(30) FaktAdresse2 Char X(30) FaktLand Char X(30) FaktPostNr Char X(15) FaktTekstNr Int >>9 Fakturagebyr Log Faktureringsperiode Int 9 FodtDato Date 99/99/99 ForsteKjop Date 99/99/99 GruppeId Int >>9 Hovedkunde Log Kilde Char X(30) Kjon Int 9 KobletTilKunde Dec >>>>>>>>>>>>9 KontE-Post Char X(40) KontMobilTlf Char X(15) KontNavn Char X(40) KontTelefaks Char X(40) KontTelefon Char X(15) Polygon Software AS Integrasjon Nettbutikk 26
KreditSperret Log KundeNr Dec >>>>>>>>>>>>9 KundeSaldo (Ikke i bruk) Dec ->,>>>,>>9.99 Land Char X(30) LevAdresse1 Char X(30) LevAdresse2 Char X(30) LevLand Char X(30) LevPostNr Char X(10) MaksKredit Dec ->,>>>,>>9.99 MobilTlf Char X(15) Momskod Int >>9 Navn Char X(40) Opphort Date 99/99/99 OrgNr Char X(15) Postgiro Char X(20) PostNr Char X(10) Privat Log PrivatTlf Char X(15) Purregebyr Log RegistrertAv Char X(10) RegistrertDato Date 99/99/99 RegistrertTid Int >>>>>>>9 SamleFaktura Log SisteKjop Date 99/99/99 Stilling Char X(30) Telefaks Char X(15) Telefon Char X(15) TilgKilde Char X(30) TotalRabatt% Dec ->9.99 TypeId Int >>>9 ValKod Char X(3) WebKunde Log Polygon Software AS Integrasjon Nettbutikk 27
Kundegruppe (WBKGR Fra nettbutikk) For inndeling av kundene i for eksempel 1-Kreditkunder 10% rab, 2- Kreditkunder 15% rab 3-Kontantkunder 10% rab 9-Ansatte. Kundegruppene inngår i rabattmatrisen sammen med varegruppene. Filnavn: WBKGR<Sekv.nr>.xml Polygon Software AS Integrasjon Nettbutikk 28
GruppeId Int >>9 Beskrivelse Char X(30) Kundkort (WBKKO Fra nettbutikk) En kunde kan ha et eller flere kundekort knyttet til seg. For kundeklubb håntering er det også mulig å koble et medlemskort mot et kundekort. Filnavn: WBKKO<Sekv.nr>.xml AktivertDato Date 99/99/99 BrukerID Char X(10) EDato Date 99/99/9999 ETid Int >>>>>>>9 Innehaver Char X(30) InterntKKortId Dec >>>>>>>>>>>>9 InterntMKortId Dec >>>>>>>>>>>>9 KortNr Char X(22) KundeNr Dec >>>>>>>>>>>>9 MedlemsNr Dec >>>>>>>>>>>>9 Merknad Char X(40) RegistrertAv Char X(10) RegistrertDato Date 99/99/99 RegistrertTid Int >>>>>>>9 Sperret Log UtgarDato Date 99/99/99 Polygon Software AS Integrasjon Nettbutikk 29
Kundesaldo (WBKSA Fra nettbutikk) Filnavn: WBKSA<Sekv.nr>.xml BrukerId Char X(10) ButikkNr Int >>>>>9 DatoSiste Date 99/99/99 EDato Date 99/99/99 ETid Int >>>>>>>9 ForsteDato Date 99/99/9999 ForsteTid Int >>>>>>>9 KundeNr Dec >>>>>>>>>>>>9 RegistrertAv Char X(10) RegistrertDato Dato 99/99/9999 RegistrertTid Int >>>>>>>9 Saldo Dec ->>>,>>>,>>9.99 SisteTid Int >>>>>>>9 Totalkjop Dec ->>>,>>>,>>9.99 Polygon Software AS Integrasjon Nettbutikk 30
Medlem (WBMedlem Fra nettbutikk) Filnavn: WBMED<Sekv.nr>.xml Adresse1 Char X(40) Adresse2 Char X(40) Aktiv Log AktivertFraWeb Date 99/99/9999 BrukerId Char X(10) ButikkNr Int >>>>>9 BydelsNr Char X(8) EDato Date 99/99/9999 EksterntMedlemsNr Char X(20) epostadresse Char X(40) ETid Int >>>>>>>9 EtterNavn Char X(40) FodselsDato Date 99/99/9999 FodtAr Int 9999 Fornavn Char X(40) HovedMedlemFlagg Log HovedMedlemsNr Dec >>>>>>>>>>>>9 Kilde Char X(30) Kjonn Log M/K KundeNr Dec >>>>>>>>>>>>9 Land Char X(30) MedGruppe Int >>9 Polygon Software AS Integrasjon Nettbutikk 31
MedlemsNr Dec >>>>>>>>>>>>9 MedType Int >>>9 MobilTlf Char X(15) Opphort Log PostNr Char X(10) Rabatt Dec ->>.9 RegistrertDato Date 99/99/9999 RegistrertTid Int >>>>>>>>>>>>9 RegistrertAv Char X(10) RegKode Char X(10) Telefaks Char X(15) Telefon Char X(15) TilgKilde Char X(30) WebBrukerId Char X(15) WebPassord Char X(15) Medlemsgruppe (WBMGR Fra nettbutikk) Filnavn: WBMGR<Sekv.nr>.xml Polygon Software AS Integrasjon Nettbutikk 32
MedGruppe Int >>>9 Beskrivelse Char X(30) BrukerId Char X(10) EDato Date 99/99/9999 ETid Int >>>>>>>9 Notat Char X(40) RegistrertDato Date 99/99/9999 RegistrertTid Int >>>>>>>>>>>>9 RegistrertAv Char X(10) Medlemskort (WBMKO Fra nettbutikk) Filnavn: WBMKO<Sekv.nr>.xml AktivertDato Date 99/99/99 BrukerID Char X(10) EDato Date 99/99/9999 ETid Int >>>>>>>9 Innehaver Char X(30) InterntKKortId Dec >>>>>>>>>>>>9 InterntMKortId Dec >>>>>>>>>>>>9 KortNr Char X(22) KortType Int 9 KundeKortNr Char X(22) KundeRabattKort Log Yes/no MedlemsNr Dec >>>>>>>>>>>>9 Merknad Char X(40) RegistrertAv Char X(10) RegistrertDato Date 99/99/99 RegistrertTid Int >>>>>>>9 Sperret Log Yes/no UtgarDato Date 99/99/99 Polygon Software AS Integrasjon Nettbutikk 33
Medlemsaldo (WBMSA Fra nettbutikk) Filnavn: WBMSA<Sekv.nr>.xml DatoSiste Date ForsteDato Date 99/99/99 ForsteTid Int >>>>>>>9 SisteTid Int >>>>>>>9 TotalKjop Dec ->>>,>>>,>>9.99 Saldo Dec ->>>,>>>,>>9.99 RegistrertAv Char X(10) RegistrertDato Date 99/99/9999 RegistrertTid Int >>>>>>>9 BrukerID Char X(10) EDato Date 99/99/9999 ETid Int >>>>>>>9 Lagerinformasjon (WBLAG Til nettbutikk) Filnavn: WBLAG<Sekv.nr>.xml Polygon Software AS Integrasjon Nettbutikk 34
ArtikkelNr Dec >>>>>>>>>>>>9 Butik int >>>>>9 LevKod Char X(20) Beskr Char X(30) LevFargKod char X(20) StrTypeId int >>>>>9 StrKode Int >>9 Storl char X(10) VVarekost Dec ->>>,>>9.99 LagAnt int ->>>>>9 Kode Char X(14) Artikkelutmelding (WBART Fra nettbutikk) Filnavn: WBART<Sekv.nr>.xml ArtikkelNr dec >>>>>>>>>>>>9 WebButikkArtikkel log Yes/no Publisert Log Yes/No Polygon Software AS Integrasjon Nettbutikk 35
Artikkelomsending (WBREQ Fra nettbutikk) Filnavn: WBREQ<Sekv.nr>.xml ArtikkelNr dec >>>>>>>>>>>>9 Salgsordre (WBORD Fra nettbutikk) Dette er ordreformatet fra BITS epages (www.bits.no). Filnavn: WBORD<Sekv.nr>.xml Feltformater og felt beskrives ikke her. Henviser til relevant dokumentasjon fra BITS. Her er det bare tatt med et eksempel på salgsordrefil fra epages. dec >>>>>>>>>>>>9 Polygon Software AS Integrasjon Nettbutikk 36
Polygon Software AS Integrasjon Nettbutikk 37
Salgsordre (WBKOR Til nettbutikk) Filnavn: WBKOR<Sekv.nr>.xml Feltformater ikke ferdig beskrevet dec >>>>>>>>>>>>9 Polygon Software AS Integrasjon Nettbutikk 38
Polygon Software AS Integrasjon Nettbutikk 39
Polygon Software AS Integrasjon Nettbutikk 40
JOURNAL Salgsordre Filnavn: journal<bongnr>.<butnr> JOURNAL Overføringsordre Definisjoner Definisjoner Salgsordre Ordren som kunden selv registrerer i nettbutikken Faste registre Registre som inneholder varestruktur (Avdeling, hovedgruppe og varegruppe) og andre registre som er koblet til artikkelinformasjonen. Reservasjonsmelding Melding fra nettbutikk som reserverer varen hvis denne selges fra andre butikker enn nettbutikkens eget lager. Denne meldingen sendes bare når videre behandling av salgsordren skjer i nettbutikken. Salgsmelding Melding om at en salgsordre er ferdigbehandlet og at salget skal oppdateres i lager og statistikker. Salgsordremelding Melding om at en salgsordre er registrert og innholdet i denne. Denne meldingen sendes fra nettbutikk til butikksystem når videre oppfølging av salgsordren skal skje i butikksystemet. Deaktiveringsmelding Når det i nettbutikken er nødvendig å deaktivere en vare, sendes en melding om dette til butikksystemet. Dette kan skje når varens lager kommer under sperregrense som er satt på tilgjengelig lager i nettbutikk. Forretningsprosess Arbeidsprosess Polygon Software AS Integrasjon Nettbutikk 41
Vedlegg WinEDI integrasjon Nettbutikkens ordre håndteres i butikkens kundeordremodul. Denne er integrert med WinEDI for generering og utskrift av postpakke etiketter. Integrasjonsmetoden som er valgt er File Drop. Som innebærer at det legges ut en etikettfil til WinEDI, som importeres og behandles. Når behandling er ferdig, legges det ut en kvitteringsfil som inneholder referanse til ordre og sendingsnummer som skal påføres ordren. Som det fremgår av figuren, sendes en melding fra butikksystemet til WinEDI. WinEDI genrerer en postetikett og et sendingsnummer. Deretter sendes en melding tilbake til butikksystemet. I butikksystemet er det datamottaksserver som leser inn og oppdaterer ordren med sendingsnummer fra WinEDI. For brukeren virker det som om det er ordreprogrammet som leser inn og oppdaterer ordren, men dette er valgt lagt til datamottaksserver for å sikre at det ikke blir liggende filer som ikke blir lest inn ved eventuelt avbrudd fra bruker eller system. Spesifikasjon av etikettfil til WinEDI Folder: Filen skal plasseres som standard i katalog c:\home\lindbak\sendes. Er innkommende filer styrt til en annen katalog i installasjonsoppsettet av PRS, skal denne katalogen benyttes. FilNavn: P<SekvensNr>.csv hvor sekvensnummer kan være opptil syv siffer langt. Polygon Software AS Integrasjon Nettbutikk 42