Gå til innhold
Norsk – Norge
ℹ️ Finner du ikke svaret? Opprett en sak her
Logg inn i Tidsbanken
  • Det finnes ingen forslag fordi søkefeltet er tomt.

Slik setter du opp integrasjonen mellom Tidsbanken og Front Systems

Koble sammen systemene, kontroller den automatiske salgsoverføringen og konfigurer omsetning og avdelinger.

Oppsettet består av tre deler:

  1. Opprett en integrasjonsbruker og API-nøkkel i Front Systems.
  2. Koble Tidsbanken til Front Systems og kontroller den automatiske overføringen av salg.
  3. Velg omsetningsgrunnlag og koble hver POS til riktig avdeling.

Før du begynner: kontroller tilgangene

Slik kontrollerer du at du er administrator i Tidsbanken

  1. Logg inn i Tidsbanken.
  2. Åpne Integrasjonssenter direkte, eller velg skiftenøkkelen nederst til høyre og deretter Integrasjoner.

Hvis du kan åpne Integrasjonssenteret og velge en integrasjon, har du administratortilgang. Hvis du får beskjed om at du ikke har tilgang, må en administrator i Tidsbanken gi deg nødvendig rolle eller utføre oppsettet.

Slik kontrollerer du at Front Systems-modulen er aktiv

  1. Åpne Integrasjonssenter.
  2. Velg Front Systems.

Modulen er aktiv når du kan velge Opprett ny integrasjon eller se det eksisterende integrasjonsoppsettet. Hvis du i stedet ser en bestillingsknapp, er modulen ikke aktiv. Kontakt Tidsbanken for å aktivere modulen.

Dette trenger du fra Front Systems

  • en Front Systems-bruker med rollen Company admin
  • tilgang til Front Systems Backoffice Portal
  • en egen x-api-key for Tidsbanken-integrasjonen
  • numerisk POS-ID for hver POS som skal kobles til en avdeling

Trinn 1: Opprett API-nøkkelen i Front Systems

  1. Logg inn i Front Systems Backoffice Portal.
  2. Gå til Admin → Integration users.
  3. Velg Create new.
  4. Gi integrasjonsbrukeren et tydelig navn, for eksempel Tidsbanken.
  5. Velg omfang:
    • Velg normalt Company hvis Tidsbanken skal motta salg fra alle butikker i selskapet.
    • Bruk et smalere butikk-omfang bare hvis integrasjonen bevisst skal begrenses til bestemte butikker.
  6. Lagre og generer API-nøkkelen.
  7. Kopier nøkkelen og oppbevar den sikkert.

API-nøkkelen vises bare én gang
Front Systems viser nøkkelen når den opprettes. Hvis den ikke blir lagret, må du generere en ny nøkkel.

Trinn 2: Koble Tidsbanken til Front Systems

  1. Åpne Integrasjonssenter i Tidsbanken.
  2. Velg Front Systems.
  3. Velg Opprett ny integrasjon.
  4. Lim inn Front Systems API-nøkkelen.
  5. Velg Lagre.

Tidsbanken kontrollerer nøkkelen og ser etter den automatiske koblingen som varsler Tidsbanken når et salg er fullført. Denne koblingen kalles en webhook, og den tekniske hendelsen heter SaleCreated:

  • Hvis webhooken ikke finnes, forsøker Tidsbanken å opprette den automatisk.
  • Hvis én gyldig SaleCreated-webhook finnes, går du videre til konfigurasjonen.
  • Hvis det finnes flere SaleCreated-webhooker, bør integrasjonsansvarlig kontrollere hvilke systemer som bruker dem. Ikke slett en webhook før du vet hva den brukes til.

Trinn 3: Konfigurer salgsflyten

Aktiver integrasjonen

La valget Aktiv være på når nye salg skal sendes til Tidsbanken. Slår du av valget, lagres oppsettet, men omsetning fra nye salg blir ikke overført til Tidsbanken.

Velg om omsetningen skal inkludere merverdiavgift

  • Velg Inkluder MVA når omsetningstallene i Tidsbanken skal inkludere merverdiavgift.
  • La valget være av når omsetningen skal vises uten merverdiavgift.

Bruk samme prinsipp som i virksomhetens budsjetter og OPAT-måltall. Ellers sammenligner du tall med ulikt grunnlag.

Koble POS-ID til avdeling

Hver POS har sin egen numeriske ID i Front Systems:

  1. Åpne Front Systems-portalen.
  2. Gå til Admin → Settings → POS.
  3. Finn riktig POS i listen.
  4. Bruk ID-en i den første kolonnen.

Gjenta dette for hver POS som skal sende salg:

  1. Velg avdelingen i Tidsbanken som skal motta omsetningen.
  2. Skriv inn den numeriske POS-ID-en fra Front Systems.
  3. Velg Legg til.
  4. Kontroller at koblingen vises i listen.

En POS-ID kan bare legges til én gang, men flere forskjellige POS-ID-er kan kobles til samme avdeling. Dette er aktuelt når en butikk eller avdeling har flere kasser. Bruk sletteknappen ved koblingen hvis den må erstattes.

Hvorfor må POS-ID kobles til en avdeling?
Salgsinformasjonen fra Front Systems forteller hvilken POS salget kommer fra. Koblingen bestemmer hvilken avdeling i Tidsbanken som får omsetningen. Feil POS-ID kan derfor gi manglende omsetning eller omsetning på feil avdeling.

Lagre oppsettet

  1. Kontroller at Aktiv og Inkluder MVA er riktig valgt.
  2. Kontroller alle koblinger mellom POS-ID og avdeling.
  3. Velg Lagre.

Kontroller at oppsettet virker

  1. Fullfør et kontrollert testsalg i en POS som er koblet til Tidsbanken.
  2. Kontroller at salget er fullført, ikke parkert eller avbrutt.
  3. Kontroller at integrasjonen er aktiv.
  4. Kontroller at POS-ID-en er koblet til riktig avdeling.
  5. Kontroller omsetningen for avdelingen i Tidsbanken.
  6. Kontroller at beløpet følger valget for merverdiavgift.

Endre eller koble fra integrasjonen

Velg redigeringsknappen i integrasjonsoppsettet for å endre aktiv status, MVA-valg eller POS-koblinger. Lagre når du er ferdig.

Bruk sletteknappen for å fjerne integrasjonsoppsettet. Hvis API-nøkkelen er tilbakekalt eller erstattet, fjerner du oppsettet og kobler til på nytt med en gyldig nøkkel.

Hvis noe feiler, se Feilsøking for integrasjonen mellom Tidsbanken og Front Systems.

Se også hvilke opplysninger som utveksles mellom Tidsbanken og Front Systems.