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.
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 |
* 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.
Utlegg/tillegg
(Utvikling pågår)
Utlegg/tillegg i Mobile Worker kan eksporteres til orderlinjer i prosjektet i Tripletex.
Produkt
Produkt eksporteres fra TT til varer i MW.
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
- 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
- Adresse
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 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 ignoreres ved synkronisering av data.
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
- 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
- Antall
Ordredeltakere
(Utvikling pågår)
Pr. i dag må disse settes i MW, om en ikke har valgt automatisk tildeling.
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
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.