Slik virker smartdok-integrasjonen
I Webtemp Next Oppsett skal en kunne gå inn på integrasjoner og be om å få aktivert SmartDok integrasjonen. Det er mulig at SmartDok vil kreve å aktivere tilgang til for hvert firma som Websystemer sin integrasjonstoken skal få tilgang til. I såfall må vi lage en sånn "Jeg ønsker å aktivere SmartDok integrasjon"-knapp i oppsett istedenfor å bare slå på.
Når SmartDok-integrasjonen er slått på, vil følgende funksjonalitet dukke opp i Webtemp Next:
I Kundebildet vil det være knapp for å aktivere SmartDok for denne kunden - denne vil medføre at du må taste brukernavn og passord for smartdok-tilgang for denne kunden, slik at vi kan lage en token som skal brukes ifbm med kommunikasjon med smartdokapi mot denne kunden. Denne tokenen lagres og kan fornyes for framtidig api-uthentinger for akkurat denne kunden. Dersom tokenen er ugyldig, ikke eksisterer, eller gir feil, må det gå an å reautentisere med brukernavn og passord på nytt for å få en ny token som erstatter den gamle.
I Kundebildet vil det vise en gruppe elementer med SmartDok informasjon. Her vil det finnes litt enkel informasjon om når timelister er sist lastet ned, hvor mange medarbeidere som er mappet opp for denne kunden, samt knapper for å laste ned / synkronisere timelister nå. Det vil komme en liste med timelister/timer som en kan velge å importere, og når en faktisk velger å importere dem, blir de markert som eksportert fra smartdok, og vil ikke dukke opp igjen neste gang en synkroniserer med smartdok.
I Oppsett vil det være en smartdok oversikt tilsvarende som i kundebildet, bare på et overordnet nivå, dvs samlet for alle kunder som har smartdok aktivert.
Forutsetninger
Det fins både oppdrag og vikar i webtemp i forkant av nedlasting av timelister fra smartdok til webtemp
Employeeno i smartdok er ensbetydig på hvem medarbeideren er
Employeeno i smartdok er på maks 38 tegn
Projectno i smartdok er på maks 38 tegn
Projectno i smartdok kan knyttes direkte til et oppdrag i webtemp (nytt oppdrag trenger nytt projectno i smartdok også)
Oppdragene involvert benytter firmaets standard periodisering
Timer kan ikke importeres til dager som allerede har føringer på seg (fins elektronisk timelistelinje på dato)
"Deres ref / prosjektnummer" må føres på underprosjekt i Smartdok
Forløpig kan bare "arbeidstimer" type linjer importeres. Forslag vil være første produktet funnet som id_avtaler-grunnlonn i avtalehierarki eller globalt om ikke
WageCode i smartdok må alltid tilsvare samme produkt i webtemp alltid for samme firmakunde (for alle oppdrag for denne kunden)
Hva innebærer nedlasting av timelister
Henter perioder, forrige, den før, og den etter
Henter "WorkHours" som er klar for eksportering fra SmartDok for valgt periode. På disse hentes WorkhourId, prosjektnummer, dato, medarbeider, klokken fra/til, pause, kommentar - gruppert pr projectno / oppdrag
Token til smartdok
Token for kommunikasjon med smartdok-api blir lagret i innstillinger (sql only), knyttet til firmakunde, og heter "smartdoktoken".
Kundes smartdok-mapping
passord | knyttet til | tallparameterverdi | tekstparameter | beskrivelse |
---|---|---|---|---|
sde_<sdemployeeno> | firmakunde | id_vikarer | Dette passordet knytter en smartdok employee til en vikar | |
sdp_<sdprojectno> | firmakunde | id_oppdrag | Dette passordet knytter et smartdok prosjekt til et oppdrag | |
sdw_<sdwageno> | firmakunde | id_produkter | Dette passordet knytter et smartdok WageNo til et produkt (lønnsart) |