Denne artikkelen vil gi deg en oversikt over hva integrasjonen mellom Mobile Worker (MW) og Tripletex (TT) inneholder av integrasjonspunkt. Selv om hvert register i utgangspunktet kan slås av og på individuelt, er flere av registrene tilknyttet hverandre og må være på samtidig (f.eks. kunder vs. prosjekt/ordre).
Krav før integrasjon kan settes opp
Det er et krav at kunden abonnerer på Time- og Prosjekt-modulene i Tripletex.
Innen en går i gang med å sette opp integrasjon mellom systemene er det noen punkter som må sjekkes opp og være på plass, ellers vil ikke registrene synkronisere riktig:
- Ansatt
Ansatt nummer på være definert i Tripletex. PS: Husk også å sette dette ansattnummeret på vedkommende som blir lagt inn når ny MW klient lages før en drar i gang ansatt synkronisering!
Ansatt må ha 2 navn (fornavn/etternavn) skilt med et mellomrom.
I tillegg må alle ansatte ha en unik epost adresse, da dette er brukernavnet ved pålogging. - Timearter/Aktiviteter
Dersom MW skal benyttes for timeføring, må aktiviteter være definert i Tripletex. Disse finner du under TImeliste - Innstillinger.
Hver aktivitet må ha et unikt nummer. Det betyr at en ikke kan blande nummerering i intern aktiviteter og prosjekt aktiviteter. - Varenummer
Varene må ha unike varenummer. Dette kan godt være alfanumerisk.
PS: Varer som er lest inn som NRF- eller El-nummer, har andre referanser til varenummer og vil ikke fungere mot Mobile Worker! - Prosjekt
Dersom prosjekt er registrert i Tripletex uten kunde vil ikke prosjektet bli overført til Mobile Worker.
Oversikt over registre
Eksport = Fra Mobile Worker til Tripletex
Import = Til Mobile Worker fra Tripletex
Register = register i MW
| Register |
Retning | Kommentar |
| Ansatt | Import | |
| Timeart | Import | Aktiviteter i TT importeres som timearter i MW |
| Timelinjer | Eksport | |
| Utlegg/tillegg | Eksport | Utlegg/tillegg kan eksporteres til ordrelinjer i prosjektet i TT |
| Produkt | Import | |
| Kunde | Begge | Enkelte verdier synkroniseres kun èn vei. |
| Prosjekt | Begge | Hovedprosjekt i TT (toppnoden) importeres både som prosjekt og ordre |
| Ordre | Begge | Underprosjekt i TT importeres som ordre, og kobles til hovedprosjektet |
| Varelinjer | Eksport | Vareforbruk i MW eksporteres til ordrelinjer i prosjektet i TT |
| Ordredeltaker | Begge | |
| Lager | Import | |
| Kontakter | Begge | Kundekontakter. |
* Av hensyn til ytelse vil integrasjonen maks behandle 100 000 enheter per register per kjøring. Det vil si, 100 000 enheter som ikke tidligere er sendt eller som har blitt oppdatert siden sist. Har et register mer enn 100 000 nye/oppdaterte enheter, vil neste kjøring fortsette der forrige stoppet. Om man ikke kan vente til neste planlagte kjøring, kan man manuelt igangsette synk via integrasjonsbildet.
Detaljert informasjon per register
Ansatt
Ansattregisteret overføres fra TT til MW, og følgende verdier settes:
- Ansattnummer
- Fornavn
- Etternavn
- Epost-adresse
- Mobil-nummer
Ansatte som det er satt sluttdato på i TT vil ignoreres ved synkronisering av data.
Dersom ansatte finnes i begge systemer på forhånd, må de settes opp med like numre i begge systemer om integrasjonen skal kobles disse. Dersom det er ulike numre vil det opprettes nye.
Timeart
Aktiviteter i TT importeres som timearter (hour types) i MW. Følgende verdier settes:
- Timeart-nummer
- Aktiviteter i TT uten nummer blir ignorert av integrasjonen.
- Evt. duplikate numre vil føre til at import av aktivitet feiler.
- Navn
- Beskrivelse
- Aktiv/inaktiv
Timelinje
Godkjente timer ført i MW eksporteres til TT sin timeføring. MERK: Kun timearter (hour types) eksporteres. Utlegg/tillegg overføres ikke som timelinjer.
Følgende verdier settes i TT:
- Prosjekt
- Ordre i MW
- Denne verdien blir ignorert dersom aktiviteten i TT er en internaktivitet.
- Aktivitet
- Timeart i MW
- Dato
- Antall
- Dersom det allerede er lagret et antall i TT på denne dagen/prosjektet/aktiviteten, vil det nye timeantallet legges til det eksisterende antallet.
- Beskrivelse som ansatt har lagt inn i timeføringen
Utlegg/tillegg
(Utvikling pågår)
Utlegg/tillegg i Mobile Worker skal kunne eksporteres til orderlinjer i prosjektet i Tripletex. Under utvikling.
Produkt
Produkt eksporteres fra TT til varer i MW.
MERK: Integrasjonen støtter ikke bransjetilpassede løsninger i TT, dvs. El-nummer (for elketrikere) og NRF-nr. (for rørleggere).
Det kan være potensielt svært mange produkter som blir oppdatert i TT hver natt. Av den grunn er synkronisering av dette registereret delt i to. Alle manuelle endringer av produkt i TT blir importert raskt i MW (Webhooks). Om det er større automatiske oppdateringer som kjøres, må dette importeres manuelt via synk-innstillinger i MW.
Følgende verdier settes i MW:
- Varenummer
- Navn
- Enhet
- GTIN
- Aktiv/inaktiv
Produkt merket som "inaktiv" i TT vil ignoreres ved synkronisering av data.
Dersom produkter finnes i begge systemer på forhånd, må de settes opp med like numre i begge systemer om integrasjonen skal kobles disse. Dersom det er ulike numre vil det opprettes nye.
Kunde
Kunderegisteret synkroniseres begge veier, men enkelte verdier settes kun den ene veien.
Følgende verdier er med:
- Kundenummer
- Nye kunder fra MW vil få et temporært kundenummer inntil kunden opprettes i TT.
- Navn
- Organisasjonsnummer
- Epost
- Telefonnummer/mobilnummer
- Adresse
- Kundekontakter
Kunder merket som "inaktiv" i TT vil ignoreres ved synkronisering av data.
Dersom kunder finnes i begge systemer på forhånd, må de settes opp med like numre i begge systemer om integrasjonen skal kobles disse. Dersom det er ulike numre vil det opprettes nye.
Prosjekt
Prosjektregisteret synkroniseres begge veier.
Hovedprosjekt (kun toppnode) i TT importeres som prosjekt i MW. Nytt prosjekt i MW legges inn som nytt hovedprosjekt (toppnode) i TT. Underprosjekt i TT overføres kun til ordre under hovedprosjekt i MW.
Følgende verdier settes:
- Prosjektnummer
- Ved nytt prosjekt i MW, vil prosjektnummer overstyres i TT og returneres til MW.
- Navn
- Beskrivelse
- Kunde
- Ansvarlig
- Om ansatt ikke er satt opp som "Ansvarlig" i ansattkortet i MW, vil dette feltet ignoreres.
- Startdato
- Sluttdato
- Aktiv/inaktiv
Prosjektet merket som "Avsluttet" i TT vil avluttes i MW. Dette fungerer kun fra TT. Prosjekter avsluttet i MW vil ikke avlutte prosjekter i TT.
Dersom prosjektet finnes i begge systemer på forhånd, må de settes opp med like numre i begge systemer om integrasjonen skal kobles disse. Dersom det er ulike numre vil det opprettes nye.
Ordre
Dette registeret synkroniseres begge veier
Alle prosjekt i TT (også toppnoden) importeres som ordre i MW.
Ny ordre i MW opprettes som underprosjekt i TT.
Følgende verdier settes:
- Ordrenummer
- Ved ny ordre i MW, vil ordrenummer overstyres i TT og returneres til MW.
- Navn
- Beskrivelse
- Ansvarlig
- Om ansatt ikke er satt opp som "Ansvarlig" i MW, vil dette feltet ignoreres
- Kunde
- Kundekontakt valgt i prosjekt i TT
- Leveringsadresse
- Kun fra TT til MW.
- Startdato
- Sluttdato
- Ordrestatus
- Dette sendes kun fra TT når prosjektet settes til "Avsluttet". Ordren settes til "Ferdig" i MW.
Evt. gjenåpning av prosjekt og ordre må gjøres manuelt i MW.
- Dette sendes kun fra TT når prosjektet settes til "Avsluttet". Ordren settes til "Ferdig" i MW.
Prosjekt/ordre merket som "Avsluttet" i TT vil ignoreres ved synkronisering av data.
Dersom ordren finnes i begge systemer på forhånd, må de settes opp med like numre i begge systemer om integrasjonen skal kobles disse. Dersom det er ulike numre vil det opprettes nye.
Varelinjer
Varelinjer synkroniseres fra MW til TT. Varelinjene finner du i TT under Prosjekt - Ordrelinjer.
Følgende verdier sendes til prosjektets ordrelinje:
- Varenummer
- Beskrivelse
- Enhet
- Antall
Ordredeltakere
(Utvikling pågår)
Pr. i dag må disse settes i MW, om en ikke har valgt automatisk tildeling i MW.
De blir m.a.o. ikke hentet fra TT.
Lager
Lagre synkroniseres fra TT til MW, og det er kun lagre med et angitt lagernummer som vil bli importert.
Følgende verdier settes:
- Lagernummer
- Lagernavn
Kontakter
Kontakter lagt på kundene i TT blir sendt til kundekortet i MW.
Disse kan legges som kundekontakter på ordrer i MW. Legges kundekontakt på prosjekt i TT, blir dette oversendt til MW og lagt som kundekontakt på ordren.
Følgende verdier settes:
- Navn
- Mobil/Telefon
- E-post
Opprette API-nøkkel i Tripletex
Her er en beskrivelse av hvordan man setter opp API-nøkkel i Tripletex. Se også Tripletex sitt hjelpedokument rundt API-nøkler.
Logg på Tripletex, og velg "Selskap" og "Ansatte" i menyen på venstre side. Klikk deg inn på den ansatte som API-nøkkelen skal opprettes på. I ansattbildet, velg arkfanen "API-tilgang". (Denne kan også finnes under "MER")
Velg "Ny nøkkel" og et nytt vindu "Ny brukernøkkel" vises.
- Velg "Tilpasset" oppsett
- Velg tilgangen som integrasjonen skal få. Viktig at integrasjonen har tilstrekkelig med tilganger.
- Skriv inn applikasjonsnavn MobileWorker. Viktig at applikasjonsnavnet skrives akkurat slik, med store og små bokstaver, og uten mellomrom.
- Legg inn en beskrivelse av nøkkelen, dette er kun en beskrivelse for din egen del og har ingen konsekvens for integrasjonen.
Når du klikker "Opprett nøkkel" vil et vindu vise den opprettede nøkkelen. Denne må kopieres fra vinduet, for du kan ikke hente den fram igjen senere. Nøkkelen kopieres med inn til integrasjonsoppsettet i Mobile Worker.
Viktig! Dersom du senere velger "Gjenopprett nøkkel" vil den eksisterende nøkkelen slettes og ny opprettes. Integrasjonen vil i det øyeblikket ha en ugyldig nøkkel, og den nye nøkkelen må kopieres med inn til integrasjonen i Mobile Worker for at integrasjonen skal fungere.