Tidsbanken: Feilsøking

Finn først ut hvor feilen ligger

Tidsbanken er en egen leverandør. Vi kontrollerer ikke tjenesten deres, men Matrix Lønn viser så langt som mulig hva Tidsbanken svarte og hvem som må gjøre noe. Les derfor selve feilmeldingen først. Står det at noe er hos oss, er det ingenting dere kan rette i Tidsbanken eller i oppsettet deres.

Alle feilene under lar lønnskjøringen stå urørt. Hvis hentingen stopper før dere har bekreftet, blir ingenting skrevet halvveis inn på utkastet.

Tilkobling og status

Statusen står «Tilkoblet», men noe feiler

Tidsbanken-kortet kan vise Ikke satt opp, Tilkoblet eller Tidsbanken avviste oss. Bare et avslag på selve tilgangen gjør statusen rød, for eksempel at nøkkelen ikke godtas, API-tilgangen mangler eller databasen tb-key peker på ikke finnes. Hvis Tidsbanken avviser ett enkelt kall, ikke svarer, bruker for lang tid eller Matrix Lønn stopper kallet fordi en grense er nådd, kan statusen fortsatt stå som Tilkoblet.

Siste forsøk ble avvist. Denne linjen kan derfor stå med en feilkode samtidig som statusen fortsatt er Tilkoblet. Den forteller hva som skjedde ved siste forsøk, men betyr ikke nødvendigvis at selve tilkoblingen har sluttet å virke.

«Tilkoblet» beviser mindre enn det høres ut som. Testen leser ansattregisteret hos Tidsbanken, og det er alt. Den bekrefter ikke at alle andre kall, for eksempel henting av lønnsgrunnlag, nødvendigvis vil lykkes.

Tidsbanken slipper oss ikke inn

«Tidsbanken slapp oss ikke inn.» Kontroller først at dere har API-tilgang hos Tidsbanken. Dette er en egen lisens og følger ikke automatisk med et vanlig abonnement. Hvis API-tilgangen er i orden, kan det være vår tilgang mot Tidsbanken som mangler, og da må dere ta kontakt med Matrix support.

«Vi får ikke tilgang til Tidsbanken akkurat nå.» Dette gjelder abonnementsnøkkelen Matrix Lønn bruker mot Tidsbanken. Den nøkkelen er vår, ikke deres, så ikke bytt tb-key på grunn av denne meldingen. Feilen ligger hos oss.

«Tidsbanken fant ikke databasen tb-key peker på.» Nøkkelen kan leses, men peker ikke på en database Tidsbanken finner. Hver database har sin egen tb-key, så kontroller at nøkkelen gjelder riktig miljø, og at det ikke er opprettet en ny nøkkel i Tidsbanken etter at dere la den inn hos oss. Se Tidsbanken: Komme i gang.

«Tidsbanken er ikke satt opp for denne organisasjonen.» Det er ikke lagt inn noen tb-key for organisasjonen ennå. Følg oppsettet i Tidsbanken: Komme i gang.

Når dere må vente eller Tidsbanken ikke svarer

Dere har gjort for mange oppslag

«Tidsbanken ba oss vente litt.» Dette er Tidsbankens egen begrensning. Vent omtrent ett minutt og prøv igjen.

«Dere har gjort så mange oppslag mot Tidsbanken det siste minuttet at vi stopper selv.» Organisasjonen deres har gjort mange oppslag på kort tid. Meldingen viser hvor mange sekunder dere må vente før dere prøver igjen.

«Det er uvanlig mye trafikk mot Tidsbanken fra Matrix Lønn akkurat nå.» Dette gjelder den samlede trafikken fra alle Matrix-kunder. Kundene våre deler samme abonnementsnøkkel mot Tidsbanken, og vi bremser derfor kallene våre før Tidsbanken eventuelt stanser tilgangen for alle. Dette ligger hos oss, og dere trenger bare å vente og prøve igjen.

Selve hentingen har i tillegg en grense på tjue hentinger per kvarter, og tb-key kan lagres fem ganger per kvarter. Dette er særlig verdt å huske under feilsøking: prøver dere å lagre eller hente mange ganger på rad, kan dere ende med å måtte vente før dere får prøve igjen.

Tidsbanken svarer ikke

«Fikk ikke svar fra Tidsbanken innen 20 sekunder.» Tidsbanken svarte ikke innen tidsgrensen vår. «Fikk ikke kontakt med Tidsbanken.» Matrix Lønn klarte ikke å nå tjenesten i det hele tatt. «Tidsbanken svarte med en feil hos seg.» Tidsbanken svarte, men returnerte en feil fra sin egen tjeneste.

I alle tre tilfellene bør dere vente og prøve igjen senere. Ved manglende kontakt kan dere også kontrollere om Tidsbanken har driftsproblemer. Ingen av disse feilene betyr i seg selv at tb-key er ugyldig, og ingen av dem skriver noe til lønnskjøringen.

Problemer under hentingen

Forhåndsvisningen er utløpt eller borte

«Forhåndsvisningen er mer enn 30 minutter gammel.» Lønnsgrunnlaget i forhåndsvisningen er gyldig i 30 minutter. Etter det må dere hente på nytt, slik at dere ikke bekrefter andre tall enn dem dere faktisk har sett.

«Forhåndsvisningen finnes ikke lenger.» Den midlertidige forhåndsvisningen er ryddet bort, eller en annen bruker forsøker å bekrefte en henting hun ikke startet. «Forhåndsvisningen ble lagret av en eldre versjon.» Dette kan skje dersom Matrix Lønn har blitt oppdatert mens forhåndsvisningen sto åpen. Løsningen er den samme i begge tilfeller: hent grunnlaget på nytt. Lønnskjøringen er fortsatt urørt.

Det er for mye å hente på én gang

«Perioden ga for mange linjer til å behandles i én omgang.» Kjør en kortere lønnsbehandling i Tidsbanken og hent den i stedet.

En rød melding i bekreftelsessteget kan også si at hentingen ble avkortet. Da er ikke hele lønnsgrunnlaget med, og dere skal ikke behandle hentingen som komplett. Matrix Lønn kan heller ikke bruke den avkortede hentingen til å vite hva som eventuelt er slettet eller endret i Tidsbanken, så løsningen er å kjøre en kortere behandling og hente på nytt.

Hentingen inneholder ansatte utenfor din tilgang

«Hentingen inneholder ansatte utenfor din tilgang.» Brukeren som henter mangler tilgang til alle virksomhetene grunnlaget gjelder. Be en administrator utvide tilgangen, eller la en kollega som allerede har nødvendig tilgang gjennomføre hentingen.

Matrix Lønn kan vise hvor mange linjer dette gjelder, men viser ikke navn på ansatte eller virksomheter dere ikke har tilgang til.

Problemer med ansatte og lønnsgrunnlaget

Vi klarte ikke å avgjøre hvem lønnsgrunnlagene tilhører

«Vi klarte ikke å avgjøre hvem lønnsgrunnlagene tilhører.» Tidsbanken har sendt to forskjellige ansattreferanser på samme linje, og de peker på hver sin person i Matrix Lønn. Da avviser vi hele hentingen, fordi vi ikke trygt kan avgjøre hvem grunnlaget tilhører. Ingen linjer blir lagt inn.

Ta kontakt med Matrix support dersom dette skjer. Ikke forveksle det med den blå boksen som foreslår å hente på nytt med det andre ansattfeltet. Den situasjonen kan dere løse selv og er beskrevet i Tidsbanken: Kontroller grunnlaget før du bekrefter.

Lønnsgrunnlaget stemmer ikke

Hvis hentingen fungerer, men timer, tillegg, overtid eller pauser ikke stemmer, er dette normalt ikke en feil i integrasjonen. Matrix Lønn henter lønnsgrunnlaget Tidsbanken allerede har beregnet, mens reglene for blant annet overtid, tillegg og pauser ligger hos Tidsbanken. Rett grunnlaget der, kjør lønnsbehandlingen på nytt og hent igjen.

Det kommer lønnsgrunnlag for en ansatt som har sluttet. Kontroller om personen fortsatt står aktiv i Tidsbanken. Dette bør oppdages før lønnen godkjennes, og dere kan bruke Tidsbanken: Sammenligne ansatte for å finne forskjeller mellom registrene.

Tekniske feil hos Matrix Lønn

Tidsbanken avviste forespørselen eller svaret kunne ikke brukes

«Tidsbanken avviste forespørselen vår.» Vi sendte en forespørsel som Tidsbanken ikke godtok. Meldingen kan be dere forsøke en kortere periode, men hvis feilen ligger i selve forespørselen vår, er det vi som må undersøke den. Ta kontakt dersom feilen gjentar seg.

«Forsto ikke svaret fra Tidsbanken.» Vi fikk svar, men ikke i en form Matrix Lønn klarte å lese. Prøv gjerne igjen én gang. Hvis det skjer flere ganger, ta kontakt slik at vi kan undersøke svaret Tidsbanken sender.

Integrasjonen er ikke ferdig satt opp hos oss

«Tidsbanken-integrasjonen er ikke ferdig satt opp hos oss.» Noe mangler på Matrix-siden. Avhengig av hva det er, kan dere enten bli stoppet når nøkkelen lagres, eller oppleve at nøkkelen lagres mens senere kall feiler. Dette er ikke noe dere kan rette selv, så ta kontakt med Matrix support.

«Nøklene kunne ikke leses på serveren.» Nøkkelen er lagret, men Matrix Lønn klarer ikke å lese den tilbake. Legg tb-key inn på nytt. Hvis feilen fortsetter, ta kontakt.

Når dere kontakter Matrix support

Hvis feilen ikke går over, kan noen få opplysninger gjøre det mye raskere for oss å finne igjen kallet. Send derfor:

• Referansen, dersom meldingen viser en. Den kan for eksempel se ut som ABCD-EFGH.
• Feilkoden, dersom den står under Siste forsøk ble avvist.
• Tidspunktet, så nær minuttet som mulig.
• Hva dere gjorde, for eksempel la inn nøkkel, testet tilkoblingen, hentet lønnsgrunnlag eller sammenlignet ansatte.
• Organisasjonsnavnet.

Send aldri tb-key eller Value i en e-post. Vi trenger ikke selve nøklene for å feilsøke. En nøkkel som har vært sendt gjennom en innboks bør byttes.