Feilsøking for integrasjonen mellom Tidsbanken og Front Systems
Finn årsaken når tilkobling, salgsoverføring, POS-kobling eller omsetning ikke virker.
Begynn med å kontrollere om feilen gjelder tilgangen til Front Systems, den automatiske salgsoverføringen, POS-koblingen eller selve omsetningsbeløpet.
Du får ikke åpnet eller konfigurert Front Systems
Slik kontrollerer du at du er administrator i Tidsbanken
- Logg inn i Tidsbanken.
- Å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.
Kontroller at Front Systems-modulen er aktiv
Velg Front Systems i Integrasjonssenteret. Modulen er aktiv når du kan opprette eller redigere integrasjonen. Hvis du ser en bestillingsknapp, er modulen ikke aktiv. Kontakt Tidsbanken for å aktivere modulen.
API-nøkkelen blir ikke godkjent
Symptom: Feltet viser at Front Systems API-nøkkelen er ugyldig, eller du kommer ikke videre.
- Kontroller at du bruker x-api-key fra en integrasjonsbruker, ikke subscription key fra Developer Portal.
- Kopier hele nøkkelen uten mellomrom før eller etter.
- Kontroller at integrasjonsbrukeren fortsatt er aktiv.
- Kontroller at nøkkelens omfang inkluderer butikkene som skal sende salg.
- Opprett om nødvendig en ny integrasjonsbruker i Admin → Integration users i Front Systems.
Hvis nøkkelen er tilbakekalt eller erstattet, fjerner du det gamle integrasjonsoppsettet i Tidsbanken og kobler til på nytt.
Den automatiske salgskoblingen kan ikke opprettes
Når API-nøkkelen er godkjent, kontrollerer Tidsbanken om den automatiske koblingen for fullførte salg finnes. Koblingen kalles en webhook, og den tekniske hendelsen heter SaleCreated. Hvis koblingen mangler, forsøker Tidsbanken å opprette den.
Kontroller at:
- integrasjonsbrukeren har tilgang til webhooker
- nøkkelen har riktig omfang
- Front Systems er tilgjengelig
- nøkkelen ikke er tilbakekalt
Prøv deretter å lagre API-nøkkelen på nytt. Hvis webhooken fortsatt ikke kan opprettes, kontakt Tidsbanken.
Det finnes flere automatiske salgskoblinger
Flere systemer kan ha opprettet webhooker for den tekniske hendelsen SaleCreated. Kontroller koblingene hvis oppsettet viser et varsel, eller hvis salg sendes til feil mottaker.
- Finn ut hvilke systemer eller integrasjoner som eier webhookene.
- Ikke slett en webhook før du har kontrollert at den ikke brukes av et annet system.
- Be Front Systems-administratoren eller integrasjonsansvarlig rydde duplikatene.
- Behold den webhooken som skal sende SaleCreated-hendelser til Tidsbanken.
- Koble integrasjonen til på nytt hvis webhooken som Tidsbanken bruker, ble endret.
Nye salg vises ikke i Tidsbanken
- Kontroller at integrasjonen er merket Aktiv.
- Kontroller at salget er fullført i POS. Omsetningen sendes når salgstransaksjonen fullføres.
- Kontroller at SaleCreated-webhooken fortsatt finnes og peker til Tidsbanken.
- Kontroller at API-nøkkelen ikke er tilbakekalt.
- Kontroller at POS-ID-en er lagt til i integrasjonsoppsettet.
- Kontroller at POS-ID-en er koblet til riktig avdeling.
- Gjennomfør ett nytt kontrollert testsalg.
Omsetningen havner på feil avdeling
- Finn POS-en som behandlet salget.
- Kontroller den numeriske POS-ID-en i Front Systems.
- Rediger integrasjonen i Tidsbanken.
- Fjern feil kobling.
- Koble POS-ID-en til riktig avdeling.
- Lagre og gjennomfør et nytt testsalg.
Endringen påvirker nye salg. Kontroller med support dersom tidligere mottatte salg også må korrigeres.
Du får ikke lagt til POS-ID-en
POS-ID-feltet godtar bare tall. Knappen Legg til er deaktivert når:
- avdeling ikke er valgt
- POS-ID mangler
- POS-ID-en allerede finnes i listen
Finn riktig ID under Admin → Settings → POS i Front Systems. Bruk ID-en i den første kolonnen, velg avdeling og kontroller om POS-ID-en allerede er koblet.
Hver POS-ID kan bare brukes én gang. Flere forskjellige POS-ID-er kan derimot kobles til samme avdeling.
Omsetningsbeløpet er høyere eller lavere enn forventet
Kontroller valget Inkluder MVA:
- Når valget er på, brukes omsetning med merverdiavgift.
- Når valget er av, brukes omsetning uten merverdiavgift.
Sammenlign også samme salg, dato, POS og kvitteringsreferanse i Front Systems og Tidsbanken. Pass på at rapporten og budsjettet bruker samme MVA-grunnlag.
Endringer blir ikke lagret
- Vent til lagringen er ferdig.
- Oppdater siden.
- Kontroller om aktiv status, MVA-valg og POS-koblinger er oppdatert.
- Prøv å lagre én gang til.
Hvis endringen fortsatt forsvinner, noter tidspunktet og hva du forsøkte å endre.
Etter at du har rettet en feil
- Lagre integrasjonsoppsettet.
- Fullfør et kontrollert testsalg i den berørte POS-en.
- Kontroller at salget vises på riktig avdeling.
- Kontroller omsetningsbeløpet mot MVA-valget.
Får du det fortsatt ikke til? Dette er informasjonen support trenger
Send med:
- virksomhetsnavn
- tidspunkt for testsalget
- POS-ID og avdelingsnummer
- om integrasjonen er aktiv
- om Inkluder MVA er valgt
- kvitterings- eller salgsreferanse
- full feilmelding
- om feilen gjelder API-nøkkel, webhook, POS-kobling eller omsetningsbeløp
- skjermbilde av oppsettet, uten API-nøkkel eller andre hemmeligheter
Se hvordan du setter opp integrasjonen mellom Tidsbanken og Front Systems.
Se også hvilke opplysninger som utveksles mellom Tidsbanken og Front Systems.