SHARE IT MAMUT INTEGRASJONSMODUL BRUKERVEILEDNING

Transkript

1 SHARE IT MAMUT INTEGRASJONSMODUL Version 0.1 Share-it AS Page 1 Sentralbord:

2 Endringslogg... 3 Innledning... 4 Innledning... 4 Følgende moduler er tilgjengelig i Mamut Integrasjonsmodul... 4 Installasjon... 4 Ordreimport... 5 Grunnleggende bruk Kom i gang... 5 Innstillinger for ordreimport... 6 Valg av firmadatabase og kilde for ordreimport... 6 Opprett/Lagre oppsett for ordreimport... 7 Send ordrestatus fra Mamut... 7 Kunderegistrering ved ordreimport... 7 Kunderegistrering ved ordreimport... 8 Gjenkjenning av eksisterende kontakter... 8 Knytte kunder til en bestemt avdeling i Mamut... 8 Eksport til Nettbutikk... 9 Grunnleggende bruk Kom i gang... 9 Innstillinger for Export til nettbutikk...10 Valg av firmadatabase og mottaker for eksport Nullstill eksportlogg Fakturajournal til Visma Innledning Generelle innstillinger / oppsett Kontoplan /Mapping av regnskapskonti Bilagsart Mva koder Ansatt og Lønn Innledning Opprett/Lagre oppsett for lønnsimport Prinsipp for import og overføring Autorutine Opprett nye ansatte ved lønnsimport Aktivitetimport Innledning Installasjon og oppsett Oppsett Loggfiler Aktivitetimport Beskrivelse av XML felter Vedlegg: Ordreimport XML felter Returmelding tilbake til nettbutikk Vedlegg: PHP Script for generering av XML ordre Vedlegg: PHP Script for returmelding fra nettbutikk Vedlegg: Ordrestatus XML felter Vedlegg: Produkteksport XML felter...29 Vedlegg: Kontakteksport XML felter...30 Vedlegg: Lagerstatuseksport XML felter Vedlegg: Rabatteksport XML felter Ansatt&Lønn Beskrivelse av XML felter Eksempel på XML for lønnsimport Returmeldinger for lønnsimport HTTP bekreftelsemelding Kontroll på overførte produkter Share-it AS Page 2 Sentralbord:

3 Endringslogg Endringer og nye funksjoner for Mamut Integrasjonsmodul logges kontinuerlig i tabellen nedenfor. Dato Modul Beskrivelse Ansatt/Lønn Ny modul for Ansatt/Lønn Eksport til Nettbutikk Beskrivelse av enkel bruk. XML eksempler og feltbeskrivelser Ordreimport Lagt til beskrivelser av XML felter. Share-it AS Page 3 Sentralbord:

4 Innledning Velkommen til SHAREIT MAMUT INTEGRASJONSMODUL. Følgende moduler er tilgjengelig i Mamut Integrasjonsmodul Ordreimport fra nettbutikk/ekstern system Eksport av produkter, kontakter, rabattregister Import av leverandørfaktura System fakturaskanning Journalimport for regnskap. F.eks. fra Visma, 24/Seven, DnbNor osv. Journaleksport for regnskap. F.eks til Visma Multicase ordreimport og eksport av kundereskontro tilbake til Multicase Norgesfaktura eksport av faktura for betalingsoppfølging via Norgesfaktura Aktivitetimport Import av ansatte/lønnslister Installasjon Mamut Integrasjonsmodul kan lastes ned fra vår internettside. Evt. kan den bestilles pr. telefon og vi sender deg nødvendige filer og installasjonskode. Ved installasjon fra Internett må Internet Explorer benyttes og være satt som standard nettleser. Når installasjonen er ferdig kan du bytte tilbake til foretrukket nettleser. Følg instruksjonene for installasjon. Når Integrasjonsmodulen er ferdig installert vil den starte automatisk og skjermbildet Innstillinger vises. Her må følgende punkter utføres: 1. Installasjonskode Skriv inn installasjonskoden og klikk Registrer (Innstallasjonskoden får du tilsendt på etter bestilling/registrering.) 2. Sti til Mamut databasen Skriv inn sti til Mamut databasen. Dette er normalt C:\programfiler\mamut\data\ 3. Velg Mamut bruker Dette er mest aktuelt for import av regnskapsbilag hvor alle bilag registreres under denne brukeren. 3. Velg Firmadatabase som skal benyttes Fra listen over firmadatabaser huker du av den eller de du ønsker å benytte for import/eksport av data. De firmadatabaser som er valgt vil være tilgjengelige som kilder/valg i alle moduler. Share-it AS Page 4 Sentralbord:

5 Ordreimport Innledning Modul for ordreimport kan importere ordre fra ulike eksterne systemer som f.eks. ekstern nettbutikk, eksternt ordresystem eller andre type systemer. De mest vanlige kilder for ordreimport er: Nettbutikk. Normalt lager en her en webservice i nettbutikk som kan eksportere ordre på xml format. Integrasjonsmodulen kobler seg mot en http adresse I butikken og henter ordre automatisk direkte til Mamut. FTP. I tilfeller hvor ordrelister legges jevnlig ut på en ftp adresse, kan Integrasjonsmodulen koble seg mot ftp serveren, laste ned ordrefilen og importere ordre til Mamut. Ordrefiler. Den mest vanlige overføring av ordre mellom eksterne systemer er kommaseparerte filer (csv). ntegrasjonsmodulen tilpasses av SHARE IT for å støtte aktuelt innlesingsformatet i hvert enkelt tilfelle. Grunnleggende bruk Kom i gang 1. Velg den kilden du ønsker å importere fra. I denne listen ligger den/de kilder som er satt opp for din Mamut. F.eks. NettButikk I Nettbutikk II Internt salgssystem 2. Klikk på knappen Hent ordre. Ordre importeres nå til Mamut. 3. Status fra ordreimport vises i statuspanelet. Her ser du hvor mange som er importert og evt om det har oppstått feil. 4. Rapport. Når ordreimport er ferdig vises rapport over importerte ordre og evt. feil. Rapporten kan lagres automatisk på fil eller skrives ut på printer. Hovedprinsippene for enhver import er at ordre leses fra en ekstern kilde (HTTP, FTP eller Fil). Ordre registreres fortløpende i Mamut og det genereres til slutt en rapport med oversikt over hvilke ordre som er importert. Ved ordreimport opprettes både kontakt og produkt i tillegg til selve ordren hvis kontakten eller produktet ikke er registrert tidligere. Hvis kontakten eller produktet er registrert tidligere kan du velge om integrasjonsmodulen skal oppdatere kontakt- og/eller produktinformasjon. Dette gjør du ved å huke av i punkt 2 Start nedlasting av ordre. For å sikre at ikke samme ordre registreres flere ganger sender Integrasjonsmodulen bekreftelsesmelding tilbake til kilden for å informere om at ordre er importert. Hvis den ikke mottar en gyldig bekreftelse tilbake slettes ordren automatisk og importeres på nytt i neste forsøk. Ved import fra FTP eller fil flyttes den importerte filen automatisk til en egen loggkatalog etter fullført import. Dette sikrer at filen ikke blir lest inn to ganger. Se ellers vedlegg for teknisk informasjon om implementering og teknisk bruk. Share-it AS Page 5 Sentralbord:

6 Innstillinger for ordreimport Valg av firmadatabase og kilde for ordreimport. I arkfanen Innstillinger settes innstillinger for: Hvilken firmadatabase ordre skal importeres til Hvor orde skal hentes fra Hvor bekreftelse for fullført import skal sendes Hvor ordrestatus skal sendes Produktnummer for eventuelle betalings-, leverings- eller administrasjonskostnader Hent orde fra Her angir du hvor Integrasjonsmodulen skal hente ordre fra. Du kan angi en http, ftp eller en fysisk fillokasjon. F.eks. ftp:// /orderfiles/ c:\ordrefiler\ Ved ftp eller fillokasjon er det normalt at det kun oppgis en katalog. Integrasjonsmodulen vil lese inn alle filer i denne katalogen og reigstrere ordre. Godkjente ordre flyttes til loggkatalog når ordreimport er fullført. Send bekreftelse til Dette feltet angir hvor Integrasjonsmodulen skal sende bekreftelsesmelding for fullført ordreimport. F.eks. en egen webservice som mottar bekreftelsen. Bekreftelsen inneholder informasjon om ordrenummer og kontaktnummer fra Mamut slik at eksternt system kan registrere denne informasjon og ha referanse til Mamut. Send ordrestatus til Dette feltet angir hvor Integrasjonsmodulen skal sende ordrestatus. Dvs. informasjon om ordre i Mamut som fakturadato, forfallsdato, om faktura er betalt osv. Felt for bekreftelse og ordrestatus trenger ikke å være utfylt for at ordreimport skal fungere. Disse feltene er tillegg som sikrer ordreimport og gir tilleggsinformasjon fra Mamut hvis det er av interesse for eksternt system. Share-it AS Page 6 Sentralbord:

7 Opprett/Lagre oppsett for ordreimport Et oppsett for ordreimport består av: Kilde for hvor ordre skal hentes fra Lokasjon for hvor bekreftelse og ordrestatus skal sendes Link til en Mamut firmadatabase Integrasjonsmodul for ordreimport kan settes opp med flere ulike oppsett. Det gjør det mulig å hente ordre fra flere ulike kilder. F.eks. om du skal importere ordre både fra nettbutikk, eksternt ordresystem og evt. et tredje system. Lagre et eksisterende oppsett 1. Klikk på Lagre. Et nytt vindu åpnes hvor innstillinger for eksisterende oppsett vises. 2. Endre ønskede verdier og klikk OK. Opprett nytt oppsett 1. Klikk på Opprett ny 2. Skriv inn ønsket navn på oppsettet. Dette vil vises i nedtrekksmenyen. 3. Fyll inn URL, FTP eller fil-lokasjon for hvor ordre skal hentes fra. 4. Skriv inn lokasjon for bekreftelse og evt. lokasjon for ordrestatus. 5. Klikk OK. Send ordrestatus fra Mamut I mange tilfeller er det ønskelig at eksterne systemer får oppdatert informasjon om ordrestatus. Ordrebekreftelsen etter import returnerer ordrenummer og kontaktnummer fra Mamut ved ordreopprettelse, men dette gir ingen informasjon om hva som skjer med ordren videre. Det er derfor lagt inn mulighet for at Integrasjonsmodulen kan sende oppdatert informasjon om ordre til eksternt system. Ordrestatus sendes etter hver utførte ordreimport hvis feltet Send ordrestatus til er utfylt. Informasjon om ordrenummer, fakturanummer, fakturadato og betaltdato overføres. Evt. gis det beskjed om ordre er kreditert eller slettet. Se vedlegg Ordrestatus XML felter for detaljer om hvilke felter som overføres. Figuren vise instillinger som kan settes for ordrestatus. Skjermbildet ligger under arkfanen Ordrestatus eksport på den nedre arkfanen. Status for alle ordre registrert siste 20 dager blir overført. Juster antall dager slik at denne dekker hele perioden fra ordre registreres til den normalt blir betalt. F.eks. 90 dager. Manuell overføring. Klikk på Start overføring for manuell overføring av ordrestatus. (Normalt går overføring automatisk etter ordreimport). Overfør kun fakturerte ordre. Share-it AS Page 7 Sentralbord:

8 Kunderegistrering ved ordreimport Gjenkjenning av eksisterende kontakter Integrasjonsmodulen kan settes opp med ulike innstillinger for hvordan kunder skal gjenkjennes ved import. Gjenkjenning av kontakter hindrer at det opprettes flere like kontakter i Mamut. Det anbefales at eksternt system lagrer kontaktnummeret fra Mamut og sender dette over i feltet mamutcontactid. Dette er en sikker identifikasjon for å gjenkjenne eksisterende kunder. Følgende kontrollmuligheter for gjenkjenning av kontakter er tilgjengelig: Mamut kontaktnummer Ekstern kundeid Organisasjonsnummer Annen kontaktinfo Mamut kontaktnummer lagres i eksternt system og sendes over i mamutcontactid. Sikker identifikasjon som alltid utføres av Integrasjonsmodulen hvis mamutcontactid er oppgitt. Integrasjonsmodulen kan lagre kontaktens id fra eksternt system i et skjult felt (ExtId) i Mamut. Ved import kan Integrasjonsmodulen sjekke om det finnes en kontakt registrert med id fra eksternt system. Søk på eksiterende kontakter etter organisasjonsnummer. Sikker gjenkjenning for bedriftskunder. Søk etter eksisterende kontakter med frisøk på navn og/eller . Ikke sikker identifikasjon, men gir en treffprosent på ca. 90% og hindrer dermed de fleste duplikate registreringer. Knytte kunder til en bestemt avdeling i Mamut Kunder som importeres kan knyttes til en valgt avdeling i Mamut ved ordreimport. F.eks. hvis bedriften opererer med mange salgskanaler og ønsker å samle alle kunder registrert i nettbutikken i egen avdeling. 1. Velg arkfanen Kontaktinnstillinger. 2. Huk av for å angi at alle kunder skal knyttes til en avdeling ved ordreimport. 3. Velg hvilken avdeling kunden skal knyttes til. Husk at oppdatering av avdeling på eksiterende kunder kun utføres hvis det er huket av for Oppdater kontaktinfo hvis kontakten eksisterer. Share-it AS Page 8 Sentralbord:

9 Eksport til Nettbutikk Innledning Modul for eksport kan overføre kontakter, produkter, lagerstatus og rabattregister fra Mamut til ekstern nettbutikk eller annen ekstern løsning. Overføring er basert på XML over standard HTTP protokoll og kan tilpasses de aller fleste nettbutikker. Grunnleggende bruk Kom i gang 1. Velg den kilden du ønsker å eksportere til. I denne listen ligger den/de kilder som er satt opp for din Mamut. F.eks. NettButikk I 2. Velg hva som skal eksporteres F.eks. alle produkter og/eller alle kontakter 3. Status på eksport. Her ser du hva som er oppdatert i Mamut siden forrige eksport og hva som er eksportert ved siste eksport. 4. Rapport. Rapport vises etter ferdig utført eksport. Rapporten kan lagres automatisk på fil eller skrives ut på printer. Eksportmodulen for Mamut henter informasjon fra Mamut etter de innstillinger som er mest aktuelle for din nettbutikk. Integrasjonsmodulen holder rede på hva som er overført tidligere og gjør at nettbutikken alltid vil være oppdatert med den siste informasjonen uten at store datamengder må overføres hver gang. Endrer du f.eks. en kontaktperson eller gjør en prisoppdatering på et produkt, vil dette vises i Integrasjonsmodulen og tas med ved neste eksport. Setter du opp Integrasjonsmodulen til automatisk kjøring, vil nettbutikken alltid være oppdatert med de siste endringene. Produktbilder overføres via FTP fra Mamut maskinen til nettbutikken. For bedrifter med flere tusen bilder levert og oppdatert jevnlig fra leverandør, kan det opprettes en egen bildekatalog adskilt fra Mamut slik at bildebehandling automatiseres og ikke trenger manuell oppdatering i Mamut. Se vedlegg for teknisk informasjon om implementering og teknisk bruk. Share-it AS Page 9 Sentralbord:

10 Innstillinger for Export til nettbutikk Valg av firma database og mottaker for eksport. I arkfanen Innstillinger settes innstillinger for: Hvilken firmadatabase det skal eksporteres fra Hvor produkteksport, kontakteksport, rabatteksport og lagerstatus skal sendes til Send eksport til Her angir du hvor Integrasjonsmodulen skal sende eksport. Du kan angi en http, ftp eller en fysisk fillokasjon. F.eks. ftp:// /exportfiles/ c:\exportfiles\ *Eksisterende versjon har kun støtte for http overføring. Nullstill eksportlogg Integrasjonsmodulen logger hva som er eksportert og hva som oppdateres i Mamut slik at informasjon ikke må overføres dobbelt. I enkelte tilfeller vil det være nødvendig og nullstille overføringslogg slik at alle data kan overføres på nytt. I bildet ovenfor er knappen Nullstill eksportlogg vist under arkfanen Innstillinger. Klikk på denne knappen og bildet til venstre vises. Velg hvilke eksportlogger som skal nullstilles og klikk OK. I infopanelet vil du se at antall som skal eksportes har økt. Share-it AS Page 10 Sentralbord:

11 Fakturajournal til Visma Innledning Eksportmodulen for Visma lar deg på en enkel og oversiktelig måte overføre fakturajournal i Mamut over til Visma. Dette er aktuelt hvis du har regnskapsfører som benytter Visma, men selv fakturerer i Mamut og fortsatt ønsker å ha full oversikt der. Med to klikk er fakturajournalen oversendt til regnskapsfører på Velg hvilken Visma-versjon som det skal overføres til. Visma Business Visma Rubicon Visma Global* 2. Velg hvilken firmadatabase det skal overføres fra. 3. Klikk på knappen Eksporter for å hente ut fakturajournal fra Mamut. 4. Klikk på knappen Send for å sende fakturajournal på til mottaker. Generelle innstillinger / oppsett Under generelle innstillinger må det angis hvor Integrasjonsmodulen skal lagre journalfilen som blir generert fra Mamut, hvor Mamut ImportExport programmet er plassert og informasjonfilen som inneholder informasjon om hvilke fakturaer som er overført tidligere. Ta kontakt med administrator eller Share-it om du er usikker på disse innstillingene. Under Generelle innstillinger setter du også opp innstillinger som må oppgis dersom filen skal sendes på . Her angis utgående server, mottaker, avsender og evt brukernavn/passord. Share-it AS Page 11 Sentralbord:

12 Kontoplan /Mapping av regnskapskonti Det normalt ikke samsvar mellom kontoplanen i Mamut og Visma. Standard salgskonto 3010 i Mamut kan f.eks. være 3000 i Visma. For at dette skal bli riktig ved overføring, er det nødvendig å sette opp en tabell som angir hvilke konti som samsvarer. I skjermbildet under ser du et eksempel. Bilagsart Det må angis hvilke ko der for bilagsart som benyttes i Visma. Dette finner du under arkfanen Bilagsart. Share-it AS Page 12 Sentralbord:

13 Mva koder Mva koder må på samme måte som kontoplanen samsvare mellom Mamut og Visma. Under arkfanen Mva koder finner du en tabell for å angi mva koden i Mamut og legge inn hvilken mva kode som skal benyttes i Visma. Det er viktig at du får med alle relevante mva koder som benyttes i din bedrift. Share-it AS Page 13 Sentralbord:

14 Ansatt og Lønn Innledning Modulen for Ansatt og Lønn importerer ansatte og lønnslister fra eksternt system til Mamut. 1. Velg hvilken kilde det skal importeres fra. Det kan opprettes flere kilder for import. Se Opprett/Lagre oppsett for lønnsimport under. 2. Klikk på knappen Importer lønn. Import av ansatte og lønnslister starter. 3. Etter endt import vises fullstendig rapport over ansatte og lønnslister som er importert. Evt. feil i import er angitt i rødt. Rapporten lagres automatisk på fil hvis du har angitt dette under arkfanen Loggfiler. Klikk på knappen Skriv ut for utskrift av rapporten. Infopanelet viser informasjon om hvor mange lønnslinjer og ansatte som er importert. Modulen for Ansatt og Lønn er beregnet på systemer hvor lønn, provisjon eller andre lønnsarter beregnes i andre systemer enn Mamut. F.eks. en salgsløsning hvor Mamut har informasjon om normal månedslønn og det eksterne salgssystemet beregner provisjon. Provisjon overføres da fra den eksterne salgsløsningen til Mamut, f.eks en gang hver måned, og normal lønnskjøring utføres i Mamut. Overføring av lønnslister til Mamut er basert på vanlige lønnslinjer hvor det må spesifiseres lønnsart, antall, pris og eventuelt hvilket prosjekt eller avdeling lønnen skal knyttes til. Tabellen under viser eksempel på data som normalt overføres og hvordan resultatet vises i Mamut. Ansatt alias Ansatt navn Lønnsart Antall Pris Prosjekt Avdeling Notat JonH Jon Holstad 45 (Provisjon) Logistikk Provisjon JonH Jon Holstad 10 (Timelønn) Berg Pensjonat Logistikk Konsulent... Share-it AS Page 14 Sentralbord:

15 3. Skriv inn hvor bekreftelse på godkjent importansatte/lønnslister skal hentes fra. MAMUT INTEGRASJONSMODUL For detaljer på format og XML felter se vedlegg: Ansatt&Lønn Beskrivelse av XML felter Opprett/Lagre oppsett for lønnsimport Under arkfanen Import oppsett angis hvor lønnslister/ansatte skal importeres fra. Det kan opprettes flere kilder for import. F.eks. hvis bedriften har flere ulike systemer som genererer informasjon om lønn. 1. Velg hvilken firmadatabase det skal importeres til. Alle fimadatabaser du har oppgitt som aktive under Innstillinger vises i denne listen. 2. Skriv inn hvor ansatte/lønnslister skal hentes fra. 2. Skriv inn hvor bekreftelsesmelding skal sendes. Evt. hvor importfiles skal lagres etter fullført import. Klikk på knappen Opprett ny for å lage et nytt oppsett for import. I bildet som vises skriver du inn hva det nye oppsettet skal hete, hvilken firmadatabase oppsettet skal knyttes til og lokasjon for importfil/webservice og bekreftelsesmelding. 1. Skriv inn navn på import-oppsett. Dette vises i nedtrekkslisten hvor du velger hvor ansatt/lønnslister skal importeres fra. 2. Velg hvilken firmadatabase oppsettet skal importere ansatte og lønnslister til. 3. Skriv inn hvor oppsettet finner data som skal importeres. Dette kan være en webservice (HTTP-adresse), FTP lokasjon eller en filkatalog. 4. Skriv inn hvor oppsettet skal sende retu rmelding for bekreftet import. Dette kan kan være en webservice (HTTP-adresse) eller en filkatalog hvor importerte filer flyttes til. Prinsipp for import og overføring Normal import av lønnslister starter med at du har lagret et oppsett for import. Når du velger dette oppsettet fra nedtrekksmenyen og klikker Start import kobler integrasjonsmodulen seg mot den kilden du har oppgitt. Ansattdata og lønnslister hentes og registreres i Mamut. For hver registrering sendes det en returmelding tilbake til ekstern løsning hvis det er oppgitt en lokasjon i feltet Send bekreftelse til. Integrasjonsmodulen venter deretter på en ny returmelding fra ekstern løsning som bekrefter at ekstern løsning har registrert overføringen som ok. Dette sikrer at ingen duplikater blir overført. Hvis oppsettet for import benytter ordinære filer eller ftp benyttes ikke returmeldinger, men importfilene flyttes til egen filkatalog etter import. Share-it AS Page 15 Sentralbord:

16 Autorutine Integrasjonsmodulen kan sette opp til å importere ansatt/lønnslister automatisk etter ønsket intervall. Innstilinger for dette ligger under arkfanen Autorutine. Husk at Integrasjonsmodulen må være aktivert for at automatisk import skal kunne utføres. 1. I denne listen vises alle oppsett for import du har lagret. Kryss av for de oppsett som skal importeres automatisk. 3. Velg hvor ofte importjobben skal utføres. 2. Kryss av her for å aktivere automatisk import. Opprett nye ansatte ved lønnsimport Hvis nye ansatte skal opprettes automatisk ved import av lønnslister, kan dette angis under arkfanen Innstilinger. Share-it AS Page 16 Sentralbord:

17 Aktivitetimport Innledning Med modulen Aktivitetimport kan aktiviteter med kontaktinformasjon importeres fra ekstern løsning via HTTP, FTP eller fil til Mamut. Når modulen er installert og nødvendige tilpassninger for overføring er utført leser modulen inn data fra ekstern løsning og registrerer aktivitetene i Mamut med et enkelt tastetrykk. Modulen kan settes opp til automatisk import og dermed fungere skjult i bakgrunnen. Loggfiler genereres for hver import og sørger for full oversikt og kontroll. Installasjon og oppsett Installasjon av selve Integrasjonsmodulen er dekket tidligere i brukerveiledning. Vennligst følg disse instruksjonene for installasjon av Integrasjonsmodulen. Ved ferdig installasjon skal Aktivitetimport være tilgjengelig som egen arkfan i toppmenyen på Integrasjonsmodulen sammen med Innstillinger og Support/Hjelp. Oppsett Modul for Aktivitetimport kan settes opp til å importere fra flere ulike kilder. Dette settes normalt opp av SHARE IT i forkant av installasjon. De ulike kildene vil vises i nedtrekksmenyen under Velg nedlasting av aktiviterer fra. Hvert valg i denne nedtrekkslisten har et eget oppsett av innstillinger som angir hvilken firmadatabase i Mamut aktiviteten skal registreres på, hvilken kilde som skal benyttes for innlesing av akitviteter. og andre innstillinger knyttet til import av aktiviteter. Instillinger for hvert valg settes i den nedre arkfanen Innstillinger. Her angis følgende: 1. Hvilken firmadatabase aktivitene skal importeres til i Mamut. Alle firmadatabaser som er krysset av som aktive under Innstillinger vil vises her. Den firmadatabasen som er knyttet til en bestemt importjobb (figur ovenfor) står automatisk valgt. 2. Lokasjon for hvor Integrasjonsmodulen skal hente aktiviteter fra. Lokasjon kan angis enten som HTTP, FTP eller en lokal filkatalog. Formatet som innleses må være tilpasset XML formatet for aktivitetimport. Se vedlegg xx for detaljer angående format. 3. Lokasjon for bekreftelsemeldinger. HTTP: For innlesing via HTTP angis en URL adresse hvor bekreftelsesmelding skal sendes. Dette vil sikre at eksternt system får beskjed når aktivitet er korrekt lagret i Mamut og samtidig kan oppdatere eksternt system med AktivitetId og kontaktid fra Mamut. Share-it AS Page 17 Sentralbord:

18 For FTP og lokal filkatalog angis en lokal filkatalog hvor de filene som er importert flyttes etter at import er ferdig utført. Dette fører til at filer som er innlest flyttes til en egen katalog hvor de kan slettes eller fungere som en historisk logg på importerte filer. Filer som feiler ved innlesing vil ikke bli flyttet. Loggfiler Det kan opprettes en loggfil for hver import som lagres på en egen filkatalog. Dette settes opp under arkfanen Loggfiler. 1. Skriv inn ønsket filkatalog for loggfiler. 2. Klikk Lagre Share-it AS Page 18 Sentralbord:

19 Aktivitetimport Beskrivelse av XML felter Feltnavn Type Eksempel Beskrivelse activityexternalid Numeric 789 Id på aktivitet i eksternt system. Normalt løpenummer fra database. activitymamutid Numeric 189 Id på aktivitet i Mamut. Denne oppgis kun dersom eksternt system har referanse (id) til aktiviteten i Mamut. F.eks. tilfeller hvor aktiviteten har blitt registrert i Mamut tidligere og aktivitetid fra Mamut er overført til eksternt system. activitysubject Text Telefonmøte Navn på aktivitet activitymamuttypeid Text 4 Support Hvis activitymamutid er oppgitt vil aktiviteten i Mamut bli oppdatert med ny informasjon. Det vil ikke bli opprettet ny aktivitet. Type aktivitet. F.eks. Support /Utg. . Tilsvarer verdiene som vises i listen i Mamut. Verdien kan oppgis som numerisk eller tekst. Hvis verdien oppgis som numerisk antas det at dette tilsvarer korresponderende id for aktivitettypen i Mamut. Hvis verdien oppgis som tekst sjekker integrasjonsmodulen om angitt aktivitetstype finnes i Mamut og benytter denne. activitystartdate DateTime Dato og tid for aktivitet start 10T12:00:00 activityenddate DateTime Dato og tid for aktivitet slutt 10T13:00:00 activitydescription Text Telefonmøte Beskrivelse av aktivitet med kunde activityisfinished Bool True/False Angir om aktiviteten er avsluttet activityisdeleted Bool True/False Angir om aktiviteten er slettet fra eksternt system. Hvis activitymamutid er oppgitt og activityisdeleted=true slettes aktiviteten fra Mamut. (Foreløpig ikke mulig i Mamut). activityisprivate Bool True/False Angir om aktiviteten er privat activityusealarm Bool True/False Angir om aktiviteten skal benytte Alarm activitylengthbeforealarm Numeric 3 Angir hvor lang tid før aktiviteten alarmen skal aktiveres. activitypriority Text None High Medium Angir aktivitetens prioritet. Low activitymamutemployeeid Text 2 Erik activityexternalemployeeid Text 4 Erik activitymamutourref activitymamutextid activitymamutstatusid Angir ansatt id i Mamut. Verdien henviser til feltet Ansatt ID på ansatt-kortet i Mamut. Verdien kan være numerisk eller text. Angir ansatt id i eksternt system Share-it AS Page 19 Sentralbord:

20 activitymamutprojectnumber contactexternalid Numeric 1234 Angir kontaktens id i eksternt system. Normal løpenummer i database. contactmamutid Numeric Angir kontaktnummer i Mamut. Hvis denne verdien er oppgitt vil Integrasjonsmodulen vite at det er en eksiterende kontakt som skal benyttes i Mamut. Hvis verdien ikke er oppgitt, vil Integrasjonsmodulen opprette en ny kontakt i Mamut. contactpersonmamutid Numeric Angir kontaknummer på en kontaktperson i Mamut. contactname Text Hansen Flis Angir kontaktens navn. AS contactiscompany Numeric True/False Angir om kontakten er bedrift. Hvis False settes kontakten som privatperson. contactpersonname contactorganizationnumber contactaddress contactzipcode contactzipaddress contactcountry contactdeliveryaddress contactdeliveryzipcode contactdeliveryzipaddress contact contactphone1 contactphone2 contactfax contactnote Share-it AS Page 20 Sentralbord:

21 Vedlegg: Ordreimport XML felter XML felter for ordrehode Feltnavn Type Påkrevd Eksempel Beskrivelse orderid Numeric JA 189 OrdreId fra nettbutikk. Normalt benyttes løpenummer på ordretabellen i nettbutikken. Denne blir sendt tilbake i returbekreftelsen til nettbutikken og benyttes når ordren skal oppdateres som eksportert i databasen. orderdatetime DateTime JA 310 Ordredato fra nettbutikk customerid Numeric NEI KundeId fra nettbutikk. mamutcontactid Numeric NEI Kontaktnummer på kunden i Mamut. Hvis oppgitt, benyttes denne for å linke ordre mot riktig kontakt i Mamut. customercompanyname Text NEI (hvis customer Hemsen Hotell Navn på kunde (bedriftskunde). Kunden opprettes som bedriftskunde i Mamut. Name er oppgitt.) customername Text NEI (hvis Line Hansen Navn på kunde (privatkunde). Kunden customer- companyname er oppgitt) opprettes som privatkunde i Mamut. Hvis customername er oppgitt i tillegg til bedriftskunde i feltet over, settes denne som kontaktperson på bedriftskunden ovenfor. customeraddress1 Text NEI Fjellveien 2 Gateadresse til kunden customeraddress2 Text NEI Evt. Adresselinje 2 til kunden. customerzipcode Text NEI 0105 Postnummer customerzipaddress Text NEI OSLO Poststed customercountry Text NEI NORGE Land customer Text NEI [email protected] adresse til kunden customerphone Text NEI Telefonnummer til kunden customermobile Text NEI Mobiltelefon til kunder customersendinfo Text NEI JA / NEI Angir om kunden ønsker å motta nyhetsmail. YES / NO 1 / 0 True / False invoicestreetaddress Text NEI Postboks 1 Fakturaadresse til kunden invoicezipcode Text NEI 0105 Postnummer for fakturaadresse invoicezipaddress Text NEI OSLO Poststed for fakturaadresse invoicecountry Text NEI NORWAY Land for fakturaadresse deliveryname Text NEI Anders Olsen Navn på mottaker hvis leveringsadresse er oppgitt. deliverystreetaddress Text NEI Strandveien 2 Leveringsadresse deliveryzipcode Text NEI 0102 Postnummer for leveringsadresse deliveryzipaddress Text NEI OSLO Poststed for leveringsadresse deliverycountry Text NEI NORWAY Land for leveringsadresse orderreference Text NEI BA Referansenummer for ordren. Lagres under Referanse på ordren i Mamut. orderadditionalinfo Text NEI Leveres så raskt som mulig. Ekstrainformasjon på ordren. Lagres under Notat på ordren i Mamut. Share-it AS Page 21 Sentralbord:

22 orderpaymentterms Text NEI Visa Betalingsbetingelser for ordre. Verdien må samsvare med et av valgene for Betalingsbetingelser i Mamut. Hvis import ikke finner angitt valg, velges standard fra kontaktkortet. Det er mulig å legge inn mapping på disse verdiene slik at verdier fra nettbutikk oversettes til et eksiterende valg i Mamut. Ta kontkakt med Share-it hvis dette er ønskelig. orderpaymentcost Numeric Nei Betalingskostnader knyttet til ordren. Hvis oppgitt, opprettes det en egen ordrelinje på ordren i Mamut for betalingskostnader. orderdeliverymethod Text Nei Postpakke Leveringsmetode for ordre. Verdien må samsvare med et av valgene for leveringsmetode i Mamut. Hvis import ikke finner angitt valg, velges standard fra kontaktkortet. Feltet kan benytte mappingverdier slik at verdier fra nettbutikken oversettes til et eksiterende valg i Mamut. orderdeliveryterms Text Nei Avsender betaler Leveringsbetingelser for ordre. Verdien må frakt samsvare med et av valgene for leverings- betingelser i Mamut. Hvis import ikke finner angitt valg, velges standard fra kontaktkortet. Feltet kan benytte mappingverdier slik at verdier fra nettbutikken oversettes til et eksiterende valg i Mamut. orderdeliverycost Numeric Nei Leveringskostnader knyttet til ordren. Hvis oppgitt, opprettes det en egen ordrelinje på ordren i Mamut for leveringskostnader. ordercosttaxpercent Numeric Nei 25.0 Mva prosentsats på kostnader oppgitt i ordrehode (frakt, administrasjon, betaling) orderkid Text Nei KID nummer som skal benyttes på ordre. orderdepartmentname Text Nei Internetsalg Den avdeling ordren skal registreres under i Mamut. Avdelingsnavnet må samsvare med en eksisterende avdeling i Mamut. ordershiptext Text Nei Tekst/Informasjon som skal vises på fraktbrev orderpicktext Text Nei Tekst/Informasjon som skal vises på pakkseddel. ordercurrencycode Text Nei SEK Valutakode hvis odre er betalt i annen valuta ordercurrencyrate Text Nei 8.16 Valutakurs ordercurrencyunit Text Nei Valutaunit. XML felter for ordrelinjer Feltnavn Type På krevd Eksempel Beskrivelse orderlineid Numeric Ja OrdrelinjeId fra nettbutikk. Normalt benyttes løpenummer for ordrelinjetabell. quantity Numeric Ja 2 Antall varer på den aktuelle ordrelinjen 2.6 retailprice Numeric Ja Veiledende enhetspris for produktet eks.mva. Integrasjonsmodulen benytter denne prisen hvis det er angitt at produktinformasjon skal oppdateres ved ordreimport. discountpercentonretailprice Numeric Nei 20.0 Prosentrabatt på veiledende pris. customerprice Numeric Nei Salgspris for denne ordre/kunde eks.mva. Denne prisen vil overstyre retailprice og evt prosent- Benyttes f.eks. hvis det er gitt en rabatter. Share-it AS Page 22 Sentralbord:

23 spesialpris som kun skal benyttes for denne ordre. productid Numeric Ja 235 Produkt Id fra nettbutikken. Normalt benyttes løpenummer fra databasen. productnumber Text Ja AS-219-SM Produktnummer mamutproductnumber Text Nei AS-219-SM Produktnummer benyttes i Mamut. I tilfelle produktnummer fra nettbutikk ikke samsvarer direkte med Mamut productname Text Ja Stiftemaskin Produktnavn orderlinedescription Text Nei Stitemaskin med Tilleggsbeskrivelse på ordrelinjen. batterier orderlinememo Text Nei Tilleggsinfo Ytterligere ordrelinjebeskrivelse deliverydate DateTime Nei Leveringsdato for ordrelinjen inprice Numeric Nei Innkjøpspris for produktet eks.mva costprice Numeric Nei Kostpris for produktet eks.mva vendorid Numeric Nei Leverandør Id vendorname Text Nei Min Lev AS Leverandørens navn taxpercent Numeric Nei 25.0 Mva prosentsats for produktet. taxcode Numeric Nei 34 Mva kode for produktet. Overstyrer mva prosent i feltet ovenfor. Eksempel på ordreeksport på XML Denne koden er tilgjengelig på <?xml version="1.0" encoding="iso "?> <OrderExport xmlns=" <Order> <orderid>1090</or derid> <orderdatetime> t12:42:20</orderdatetime> <customerid>56378 </customerid> <mamutcontactid /> <customercompanyname> ShareIt AS</ customercompanyname> <customername>ole Hansen</customerName> <customeraddress1>fjodvangveien 70< /customeraddress1> <customeraddress2 /> <customerzipcode>6610</customerzipcode> <customerzipaddress>øksendal</customerzipaddress> <customercountry> Norg e</customercountry> <customer >[email protected]</customer > <customerphone> </customerphone> <customermobile> </customermobile> <customersendinfo>ja</customersendinfo> <invoicestreetadd ress>fjodvangveien 70</ invoicestreetaddress> <invoicezipcode>1 450< /invoicezipcode> <invoicezipaddress>nesoddtangen</ invoicezipaddress> <invoicecountry>norge</invoicecountry> <deliveryname>ole Hansen</deliveryName> <deliverystreetad dress >Fjodvangveien 70</deliveryStre etaddress> <deliveryzipcode>1450</deliveryzipcode> <deliveryzipaddress>nesoddtange N</deliveryZipAddress > <deliverycountry>norge</deliverycountry> <orderreference /> <orderadditionalinfo /> <orderpaymentterms>visa</orderpaymentterms> <orderpaymentcost>40.00</ orderpaymentcost> <orderdeliverymethod>postpakke</orderdeliverymethod> <orderdeliveryterms>avsender betaler frakt</orderdeliveryterms> <orderdeliverycost>70.00</orderdeliverycost> <OrderLine> <orderlineid >2507</orderLineId> <quantity>1</quantity> <retailprice>69.00</retailprice> Share-it AS Page 23 Sentralbord:

24 <productid>1315</productid> <productnumber>41-001</productnumber> <productname>stiftemaskin</productname> <vendorid>6< /vendorid> <vendorname> Damm< /vendorna me> <taxpercent>0.00</taxpercent> </OrderLine> <OrderLine> <orderlineid>2508</orderlineid> <quantity>1</ quantity> <retailprice>69. 00</retailPrice> <productid> 1316</productId> <productnumber>41-002</productnumber> <productname>internett Gu ide< /productname> <vendorid>6</vendorid> <vendorname>damm</vendorn ame> <taxpercent>0.00</taxperc ent> </OrderLine> </Order> </OrderExport> Returmelding tilbake til nettbutikk For hver ordre som importeres sendes det en returmelding tilbake til webserver. Returmeldingen inneholder ordrenummer og kontaktnummer for den nyopprettede ordren i Mamut. I tillegg returneres den ordreid som ble sendt fra nettbutikken slik at databasen på nettbutikken kan oppdatere ordren som eksportert og legge til ordrenummer og kontaktnummer fra Mamut. Returmeldingen sendes til en angitt URL på webserver til nettbutikken. I boksen nedenfor s er du eksempel på returmeldingen som sendes. Eksemp el på returmelding myshop.no/confirm.php?websiteorderid=23&mamutorderid=19&mamutcontactnumber=3088 Når returmeldingen er behandlet i nettbutikken og ordren er oppdatert med informasjon fra Mamut og markert som eksportert sendes det ny XML returmelding tilbake til Mamut. Eksempel på XML returmelding tilbake til Mamut <?xml version="1.0" encoding="iso "?> <message> <description>ordreretur bekreftet.</description> <isconfirmok>true</isconfirmok> </message> Hvis denne returmeldingen ikke når frem til Integrasjonsmodulen eller indikerer feil fra nettbutikken, vil ordren bli slettet i Mamut. Normalt vil den da bli prøvd registrert på nytt ved neste import. PHP k ode for å håndtere returmeldinger er vist senere i dette dokumentet. Share-it AS Page 24 Sentralbord:

25 Vedlegg: PHP Script for generering av XML ordre Koden under v iser et eksempel for uttrekk av ordre fra nettbutikk for PHP <?php $dbconnect 'database', 'passord'); if (!$dbconnect ) { $error = 'Could not connect: '. mysql_error(); echo $error; } $strsql = "SELECT orders_id as orderid, date_purchased as orderdatetime, customers_id as customerid, customers_name as customername, customers_company as companyname, delivery_name as deliveryname, customers_street_address as customeraddress1, customers_postcode as customerzipcode, customers_city as customerzipaddress, customers_country as customercountry, customers_telephone as customerphone, customers_ _address as customer , delivery_street_address as deliverystreetaddress, delivery_postcode as deliveryzipcode, delivery_city as deliveryzipaddress, delivery_country as deliverycountry, payment_method as orderpaymentterms, shipping_method as orderdeliverymethod FROM orders"; $dbresult if (!$dbresult) { $error = 'No records: '. mysql_error(); echo $error; } echo phpversion(); // create a new XML document $doc = new DOMDocument('1.0', 'utf-8'); //php4.4 // create root node $root = $doc->createelement('orderexport'); $root->setattribute('xmlns', ' $root = $doc->appendchild($root); /* // process one row at a time while($row = mysql_fetch_assoc($dbresult)) { // add node for each row $order = $doc->createelement('order'); $order = $root->appendchild($order); // add a child node for each orderheadfield foreach ($row as $fieldname => $fieldvalue) { $child = $doc->createelement($fieldname); $child = $order->appendchild($child); //$value = $doc->create_text_node($fieldvalue); //$value = $child->append_child($value); } // foreach Share-it AS Page 25 Sentralbord:

26 ?> /* $query = "SELECT mc_product2order.id as orderlineid, mc_product2order.amount as quantity, mc_product2order.price as retailprice, mc_product2order.product_id as productid, mc_products.name as productnumber, mc_products.name as productname FROM mc_product2order LEFT JOIN mc_products ON mc_product2order.product_id=mc_products.id WHERE mc_product2order.order_ref_id=". $row['orderid']; $dbresultorderline = mysql_query($query, $dbconnect); while($row = mysql_fetch_assoc($dbresultorderline)) { $orderline = $doc->create_element('orderline'); $orderline = $order->append_child($orderline); // add a child node for each orderlinefield foreach ($row as $fieldname => $fieldvalue) { $child = $doc->create_element($fieldname); $child = $orderline->append_child($child); $value = $doc->create_text_node($fieldvalue); $value = $child->append_child($value); } // foreach } //While */ } // while */ // get completed xml document $xml_string = $doc->savexml(); echo $xml_string; Share-it AS Page 26 Sentralbord:

27 Vedlegg: PHP Script for returmelding fra nettbutikk <?php header('content-type: text/xml'); if(!mysql_connect('host', 'user', 'password')) { die("connection failed to the host"); } if (!mysql_select_db('database')) { die("cannot connect to database"); } mysql_query("update Ordre set ErEksportert=1,MamutOrderId= ".intval($_get['mamutorderid']).", MamutContactId= ".intval($_get['mamutcontactnumber'])." where OrdreId= ".intval($_get['websiteorderid'])); $domd = new DomDocument(); $msg = $domd->appendchild($domd->createelement('message')); $desc = $domd->createelement('description'); $isconfirm = $domd->createelement('isconfirmok'); $desctext = $domd->createtextnode('ordreretur bekreftet'); $isconfirmtext = $domd->createtextnode('true'); $desc->appendchild($desctext); $isconfirm->appendchild($isconfirmtext); $msg->appendchild($desc); $msg->appendchild($isconfirm); echo $domd->savexml();?> Share-it AS Page 27 Sentralbord:

28 Vedlegg: Ordrestatus XML felter Feltnavn Type Eksempel Beskrivelse orderid Numeric 189 Ordrenummer fra Mamut invoiceid Numeric 310 Fakturanummer fra Mamut. Blank/Ikke oppgitt hvis ordre ikke er fakturert. contactname Text Mitt Firma AS Kontaktnavn på ordre i Mamut. registerdate DateTime Dato for når ordren ble opprettet i Mamut. 10T12:00:00 invoicedate DateTime T13:00:00 Dato for når ordren ble fakturert i Mamut. Blank/ikke oppgitt hvis ordren ikke er fakturert. duedate DateTime Forfallsdato på ordren i Mamut. Blank/ikke oppgitt hvis 26T13:00:00 forfallsdato ikke er angitt. paydate DateTime Dato for når faktura ble betalt. 26T13:00:00 orderstatus Text Ubehandlet Status på faktura i Mamut. ordre Fakturert Eksempel på XML som overføres fra Integrasjonsmodulen. <?xml version="1.0" standalone="yes"?> <DataSetOrderStatus xmlns=" <OrderStatus> <orderid>301</orderid> <invoiceid>567</invoiceid> <contactname>møbelbutikken</contactname> <registerdate> t00:00:00+01:00</registerdate> <invoicedate> t00:00:00+01:00</invoicedate> <duedate> t00:00:00+01:00</duedate> <paydate> t00:00:00+01:00</paydate> <orderstatus>fakturert</orderstatus> </OrderStatus> <OrderStatus> <orderid>108</orderid> <invoiceid>0</invoiceid> <contactname>juletilbud på Stol Melbourne</contactName> <registerdate> t00:00:00+01:00</registerdate> <invoicedate> t00:00:00+01:00</invoicedate> <duedate> t00:00:00+01:00</duedate> <orderstatus>ukjent (1300)</orderStatus> </OrderStatus> </DataSetOrderStatus> Share-it AS Page 28 Sentralbord:

29 Vedlegg: Produkteksport XML felter Eksempel på XML produkteksport fra Integrasjonsmodulen til nettbutikk <?xml version="1.0" encoding="iso "?> <DataSetMamutProduct s xmlns= " shareitservices.no/namespace/mamutproducts.xsd"> <MamutProduct> <ProductId>4</ProductId> <TypeId>1</TypeId> <TypeName>Product</TypeName> <ParentProductId> 0</ParentProductId> <ProductNumber>100004</Pr oductnumber> <ProductName>St ol, AVANT</ ProductName> <ProductNote>Produktinformasjon</ProductNote> <ProductSalesNote>Salgsinformasjon</ ProductSalesNote> <ProductTechNote>Teknisk informasjon</producttechnote> <ProductProductionNote>Produksjon</ProductProductionNote> <ProductSupportNote>Supportinformasjon</ ProductSupportNote> <WebInfo /> <PictureLocal>softwarepack.jp g</picturelocal> <PictureThumb /> <PictureMedium /> <CreatedDate> T00:00:00+02:00</CreatedDate> <TimeStamp> </TimeStamp> <CategoryId>6</CategoryId> <CategoryName>Konferanse</CategoryName> <ProductGroupId>1</ProductGroupId> <ProductGroupName>Stol</ProductGroupName> <ProductSubGroupId>77</ProductSubGroupId> <ProductSubGroupName>Konferanse</ProductSubGroupName> <ProductSubCGroupId>143</ProductSubCGroupId> <ProductSubCGroupName>Bjørk</ProductSubCGroupName> <ProductSubDGroupId>0</ProductSubDGroupId> <ProductSubDGroupName /> <PriceOut>1690</PriceOut> <VatCodeId>353</VatCodeId> <VatCodePercent>25</VatCodePercent> <VatCodeName>25% Utgående mva</vatcodename> <DeliveryTimeDaysToCustomer>1</DeliveryTimeDaysToCustomer> <DeliveryTimeDaysOnStock>0</DeliveryTimeDaysOnStock> <DeliveryTimeDaysFromSupplier>9999</DeliveryTimeDaysFromSupplier> <Stock>4</Stock > </MamutProduct> </DataSetMamutProducts> XML sendes til den URL som er angitt under arkfanen Innstillinger og kan leses med eksempelvis: PHP: ASP.NET: $xml = $HTTP_RAW_POST_DATA; dataset.readxml(request.inputstream, XmlReadMode.Auto); Share-it AS Page 29 Sentralbord:

30 Vedlegg: Kontakteksport XML felter Eksempel på XML kontakteksport fra Integrasjonsmodulen til nettbutikk <?xml version="1.0" encoding="iso "?> <DataSetMamutContact xmlns=" <Contact> <ContId>30000</ContId> < Name>Hemsen Hotel</Name> < Phone1> </ Phone1> <Phone2 /> <Fax1> </Fax1> <Type>1</Type> <Disc>0</Disc> <Disc1>0</Disc1> <Disc2>0</Disc2> <Timestamp> </Timestamp> <Street /> <City>HEMSEDAL</City> <ZipCode>3560</ZipCode> <Country /> <Data56>1</Data56> <ContactCategoryId>2</ContactCategoryId> <DefaultDeliveryForm>Postpakke</DefaultDeliveryForm> <DefaultDeliveryFormId>1</DefaultDeliveryFormId> <DefaultDeliveryTerm>Mottaker betaler frakt</defaultdeliveryterm> <DefaultDeliveryTermsId>1</DefaultDeliveryTermsId> <DefaultPaymentTerms>Netto 20 dager</defaultpaymentterms> <DefaultPaymentTermsId>3</DefaultPaymentTermsId> <AccountIsOnHold>false</AccountIsOnHold> <ContactPerson> <CPersId>1</CPersId> <ContId>30000</ContId> <FirstName>Per</FirstName> <LastName>Bjoner</LastName> <ContName>Hemsen Hotel</ContName> <PhoneWork> </PhoneWork> <Celluar> </Celluar> <Username /> <Password /> </ContactPerson> </Contact> </DataSetMamutContact> XML sendes til den URL som er angitt under arkfanen Innstillinger og kan leses med eksempelvis: PHP: ASP.NET: $xml = $HTTP_RAW_POST_DATA; dataset.readxml(request.inputstream, XmlReadMode.Auto); Share-it AS Page 30 Sentralbord:

31 Vedlegg: Lagerstatuseksport XML felter Eksempel på XML lagerstatuseksport fra Integrasjonsmodulen til nettbutikk <?xml version="1.0" encoding="iso "?> <DataSetWareHouseStatus xmlns=" <WareHouseStatus> <ProductId>1</ProductId> <Stock>4</Stock> <DeliveryTimeDaysFromSupplier>5</DeliveryTimeDaysFromSupplier> </WareHouseStatus> <WareHouseStatus> <ProductId>3</ProductId> <Stock>4</Stock> <DeliveryTimeDaysFromSupplier>7</DeliveryTimeDaysFromSupplier> </WareHouseStatus> </DataSetWareHouseStatus> XML sendes til den URL som er angitt under arkfanen Innstillinger og kan leses med eksempelvis: PHP: ASP.NET: $xml = $HTTP_RAW_POST_DATA; dataset.readxml(request.inputstream, XmlReadMode.Auto); Share-it AS Page 31 Sentralbord:

32 Vedlegg: Rabatteksport XML felter Eksempel på XML rabatteksport fra Integrasjonsmodulen til nettbutikk <?xml version="1.0" encoding="iso "?> <DataSetMamutDiscount xmlns=" <Discount> <DiscountId>1</DiscountId> <FkProductId>-1</FkProductId> <ProdId /> <TypeId>2</TypeId> <V aluetypeid>1</valuetypeid> <C ontactcategoryid>3< /ContactCategoryId> <ContactCategoryName /> <DiscountPercent>10</DiscountPercent> <ProductGroupId>11</ProductGroupId> <ProductGroupName /> <ContactId>0</ContactId> <DiscountFromQuantity>0</DiscountFromQuantity> <FixedPrice>0</FixedPrice> <DiscountExpiresDate> T00:00:00+01:00</DiscountExpiresDate> <Timestamp> </Timestamp> </Discount> <Discoun t> <DiscountId>2</DiscountId> <FkProductId>7</FkProductId> <ProdId /> <TypeId>4</TypeId> <ValueTypeId>1</ValueTypeId> <ContactCategoryId>0</ContactCategoryId> <ContactCategoryName /> <DiscountPercent>10</DiscountPercent> <ProductGroupId>0</ProductGroupId> <ProductGroupName /> <ContactId>0</ContactId> <DiscountFromQuantity>5</DiscountFromQuantity> <FixedPrice>0</FixedPrice> <DiscountExpiresDate> T00:00:00+01:00</DiscountExpiresDate> <Timestamp> </Timestamp> </Discount> </DataSetMamutDiscount> XML sendes til den URL som er angitt under arkfanen Innstillinger og kan leses med eksempelvis: PHP: ASP.NET: $xml = $HTTP_RAW_POST_DATA; dataset.readxml(request.inputstream, XmlReadMode.Auto); Share-it AS Page 32 Sentralbord:

33 Ansatt&Lønn Beskrivelse av XML felter Lønnsliste/Ansatt Feltnavn Type Eksempel Beskrivelse payrollid Numeric 1 Id fra eksternt system. Normal løpenummer fra databasen. Denne sendes i retur til eksternt system for å bekrefte import til Mamut. sid Text 12AH-2mamutEmployeeAlias Security Id. Kan benyttes for å øke sikkerheten ved overføring av data mellom systemene. Sid overført til Mamut vil bli returnert tilbake i bekreftelsen og eksternt system kan deretter kontrollere at overføring er korrekt og sendt fra eksternt system. Feltet har ingen funksjon ved registering av lønnslister eller ansatt. Text HansO 12 Ansatt ID/Alias for ansatt i Mamut. Denne kan oppgis som tekst eller nummer. Hvis verdien ikke er oppgitt betraktes dette som en ny ansatt og denne vil bli opprettet i Mamut. employeefirstname Text Laila Fornavn på ansatt. Kun nødvendig hvis ansatt skal opprettes eller oppdateres. employeelastname Text Stenstad Etternavn på ansatt. Kun nødvendig hvis ansatt skal opprettes eller oppdateres. employ eephone Text Telefon til ansatt. Ikke påkrevet. employeemobilephone Text Mobilnummer til ansatt. Ikke påkrevet. employee Text [email protected] til ansatt. Ikke påkrevet. employeemamutdepartmentid Numeric 1 Avdeling ansatt tilhører i Mamut. Ikke påkrevet. employeestartdate Date Ansatt dato. Ikke påkrevet. 10T12:00:00 Lønnslinjer Feltnavn Type Eksempel Beskrivelse payrollid Numeric 1 Link til lønnsliste/ansatt i tabellen ovenfor. Det er et en til mange forhold mellom Lønnsliste og Lønnslinjer. Det opprettes normalt flere lønnslinjer pr lønnsliste. paylineid Numeric 23 Id fra eksternt system. Normal løpenummer fra databasen for den aktuelle lønnslinjen mamutpayrollartid Numeric 10 Angir lønnsart i Mamut. Gyldige verdier er lønnsart i kolonnen L-Art under Lønnsregistrering i Mamut. Eksempel: 10 = Timelønn 30 = Månedslønn r lønnsregistrering. (Fungerer ikke via Mamut API. Lønn blir kun registrert for periode Denne i Mamut. period Numeric 1 = Denne 2 = Neste Periode fo 3 = Senere note Text Utbetalt etter Beskrivende tekst for lønnslinjen. salg amount Numeric 8 Antall. Desimaltegn kan være komma eller punktum. price Numeric Enhetspris for utbetaling. Desimaltegn kan være komma eller 150 punktum. 100,10 mamutdepartmentid Numeric 3 Id link til avdeling i Mamut mamutprojectid Numeric 6 Id link til prosjekt i Mamut. Share-it AS Page 33 Sentralbord:

34 Eksempel på XML for lønnsimport XML eksempel ligger også på internet: shareit.no/ Eksempler/XML_PayrollTest.xml <?xml version="1.0"?> <DataSetPayrollImport xmlns=" <PayRoll> <payrollid>1</payrollid> <mamutemployeealias>lailas</mamutemployeealias> <employeefirstname>laila</employeefirstname> <employeelastname>stenstad</employeelastname> <PayLine> <paylineid>1</paylineid> <payrollid>1</payrollid> <mamutpayrollartid>10</mamutpayrollartid> <mamutprojectid>1</mamutprojectid> <mamutdepartmentid>1</mamutdepartmentid> <financialyear> 2007< /finan cialyear> <period>1</period> <note>testlønn fra Integrasjonsmodul(Månedslønn)</note> <amount>7,5</am ount> <price>250</price> </PayLine> <PayLine> <paylineid>2</paylineid> <payrollid>1</payrollid> <mamutpayrollartid>45</mamutpayrollartid> <mamutprojectid>2</mamutprojectid> <mamutdepartmentid>4</mamutdepartmentid> <financialyear> 2007< /financialyear> <period>1</period> <note>testlønn (Provisjon)</note> <amount>5,5</amount> <price>150,50</price> </PayLine> </PayRoll> <PayRoll> <payrollid>3</payrollid> <sid>2234</sid> <employeefirstname>ole</employeefirstname> <employeelastname>jensen</employeelastname> <employeephone> </employeephone> <employeemobilephone> </employeemobilephone> mittfirma. no</employee > <employeemamutdepar tmentid>1</employeemamutdepartmentid> <employeestartdate> T12:00:00</employeeStartDate> <PayLine> <paylineid>5< /paylin eid> <payrollid>3< /payrol lid> <mamutpayrollartid>10</mamutpayrollartid> <financialyear>2007</financialyear> <period>5</period> <note>konsulentbistand annet prosjekt</note> <amount>10</amount> <price>250</price> </PayLine> </PayRoll> </DataSetPayrollImport > Share-it AS Page 34 Sentralbord:

35 Returmeldinger for lønnsimport HTTP bekreftelsemelding Hvis det er oppgitt en HTTP lokasjon i feltet Send bekreftelse til, vil Integrasjonsmodulen sende en returmelding tilbake til ekstern løsning når en lønnslinje er importert og registrert uten feil i Mamut. Integrasjonsmodulen forventer en returmelding tilbake fra ekstern løsning for å sikre at overføringen er utført. Hvis denne returmeldingen ikke mottas vil lønnslinjen bli nullstilt i Mamut. Feltnavn Type Eksempel Beskrivelse externalpayrollid Numeric 1 Id for lønnsregistrering fra eksternt system. externalpaylineid Numeric 12AH-23 Id for lønnslinje fra eksternt system sendes tilbake i bekreftelsesmeldiing. emplyeealias Text HansO Ansatt ID/Alias for ansatt i Mamut. sid Text Security Id. Hvis ekstern løsning inkluderte security id for registrering av lønnslinjer, sendes denne tilbake i bekreftelsesmelding. Ekstern løsning kan sjekke om dette er den samme sid som ble sendt og sikre at overføring er autentisk. Eksempel på bruk av bekreftelsesmelding 1. Integasjonsmodulen sender bekreftelsesmelding til ekstern løsning via HTTP 2. Ekstern løsning håndterer bekreftelsesmeldingen. Lønnslinjer blir registrert som overført og evt. andre innstillinger registreres. For å lese verdiene fra f.eks. en asp siden benyttes følgende kode: externalid = Request( externalpayrollid ) employeealias = Request( employeealias ) sid = Request( sid ) 3. Ekstern løsning sender returmelding tilbake til Integrasjonsmodulen. Dette er en XML vist i eksempelet under.?xml version="1.0" encoding="utf-8"?> <message> <description>ordreretur bekreftet.</description> <isconfirmok>true</isconfirmok> </message> Description: Melding om evt feil. Informasjon her blir vist i rapporten. isconfirmok: true/false. Angir om alt har gått bra. Hvis true lagres lønnslinje i Mamut. Share-it AS Page 35 Sentralbord:

36 Kontroll på overførte produkter Integrasjonsmodulen har et eget skjermbilde for kontroll av overførte produkter til nettbutikk. Kontrollene sjekker alle produkter som finnes på nettbutikken og sjekker dette opp mot produkter i Mamut. Hvis det avdekkes produkter i Mamut som ikke finnes i nettbutikken vises dette i en egen liste og de enkelte produkter kan overføres manuelt. Denne funksjonen er aktuell for butikker med stort vareutvalg hvor det ikke er mulig å ha oversikt over alle produkter manuelt. Kontroll på overførte produkter krever at nettbutikken kan levere en enkel XML rapport på hvilke produkter som er registrert i nettbutikken. Følgende XML må kunne hentes. Feltnavn Type Eksempel Beskrivelse productid Numeric 189 Unik produkt id fra nettbutikk. Vanligvis løpenummer i databasen productnumber Text Produktnummer i nettbutikk. Produktnummeret forventes å være det samme som i Mamut og blir brukt for å kontrollere om produktet er overført. productname Text Stol, PROFIL Navn på produktet. Vises som informasjonsfelt i Integrasjonsmodulen for enklere gjenkjenning av produkter. mamutproductid Numeric 238 Unik id på produktet i Mamut (pk_prodid). Hvis denne id finnes i nettbutikken og tas med i XML, kontrolleres produktoverføring mot denne istedenfor productnumber. Dette er en sikrere test, men ikke alle nettbutikker har mamutproductid tilgjengelig i databasen. Eksempel på XML som overføres fra Integrasjonsmodulen. <?xml version="1.0" encoding="utf-8"?> <WebShopProducts> <Product> <productid>13</productid> <productnumber>100000</productnumber> <productname>reise</productname> <mamutproductid>57</mamutproductid> </Product> <Product> <productid>12</productid> <productnumber>100001</productnumber> <productname>stol, AKKO EXIT</productName> <mamutproductid>1</mamutproductid> </Product> </WebShopProducts> Share-it AS Page 36 Sentralbord: