Artikler i denne seksjonen

Integrasjon Tripletex

  • Oppdatert
Følg

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.

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")

mceclip0.png

Velg "Ny nøkkel" og et nytt vindu "Ny brukernøkkel" vises.

2020-09-09_Tripletex_new_API_key.png

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

 

 

Relaterte artikler