Smartdok-integrasjon

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:

 

  1. 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.

  2. 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.

  3. 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

  1. Det fins både oppdrag og vikar i webtemp i forkant av nedlasting av timelister fra smartdok til webtemp

  2. Employeeno i smartdok er ensbetydig på hvem medarbeideren er

  3. Employeeno i smartdok er på maks 38 tegn

  4. Projectno i smartdok er på maks 38 tegn

  5. Projectno i smartdok kan knyttes direkte til et oppdrag i webtemp (nytt oppdrag trenger nytt projectno i smartdok også)

  6. Oppdragene involvert benytter firmaets standard periodisering

  7. Timer kan ikke importeres til dager som allerede har føringer på seg (fins elektronisk timelistelinje på dato)

  8. "Deres ref / prosjektnummer" må føres på underprosjekt i Smartdok

  9. 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

  10. 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

  1. Henter perioder, forrige, den før, og den etter

  2. 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

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)