XLEDGER API

Oppsett i Xledger:

Først må API token opprettes i Xledger. Dette må gjøres for hvert firma i Webtemp som skal knyttes opp mot Xledger.

Velg administratorbruker, deretter trykk på Administrasjon - Tilgangskontroll - GraphQL - API Tokens, Trykk så på Generate new token.

Velg et navn og huk av for alle rettigheter, deretter trykk på genereate new token.

Kopier så strengen som blir generert, dette er din Token.

Oppsett i Webtemp:

Token legges inn her i Webtemp:

Annet - Oppsett - Integrasjoner - Xledger - Legg til ny token

Nå skal Webtemp være koblet sammen med Xledger for ditt firma.

Det neste steget er å vegle det riktige innstillingene som passer med din bruk av Webtemp og Xledger. Trykk på tannhjulet ved siden av Xledger integrasjon.

Innstillingene kan også åpnes fra eksport siden ved å trykke på nedtrekksmenyen på Eksport knappen, og velge innstillinger.

Dette vil åpne et vindu som ser slik ut:

I venstre siden ser man 3 valg. 1 Eksport er innstillinger for eksport av lønn og ansatte. 2. Faktura er intsillinger for eksport av faktura. 3. Payroll inneholder innstillinger med egne valg alternativer som hentes fra Xledger.

Eksport inntillinger:

Navn	Valg	Forklaring

Navn	Valg	Forklaring
Prosjekt og rate i tekst	Ja, Nei	Om dette valget er Ja, sendes tekstfeltet til lønnslinjer med produknavn, prosjektnavn og rate istedenfor bare produktnavn.
Prosjekt (Se under for standard logikk)	Skjul, Standard	Om prosjekt settes til Skul sendes ingen prosjekt fra Webtemp til Xledger. Hvis standard er valgt vil prosjekter fra Webtemp sendes med til Xledger. Dette kan også overstyres med et valgt prosjekt under 3. Payroll. Hvis prosjekt brukt i webtemp ikke finnes i Xledger vil dette gi en feilmelding. TODO: Vise til nøyaktig hvor prosjektene kommer fra timelister/oppdrag??
Koststed (Se under for standard logikk)	Skjul, Standard	Om koststed settes til Skjul sendes ingen koststed fra Webtemp til Xledger. Hvis standard er valgt vil koststed sendes med fra Webtemp til Xledger. Om koststed brukt i webtemp ikke finnes i Xledger vil dette gi en feilmelding. Koststed kan hentes bl.a. fra Avdelingsid/nr regnskap på oppdrag/avtale, eller fra avdeling vikaren hører til? todo: kan undersøkes nærmere.
Miljø	Demo, Produksjon	Xledger har 2 miljøer, et produksjonsmiljø og et test/demo miljø. Det er god praksis å teste en eksport til demomiljøet før man eksporterer til produksjonsmiljøet for å verifisere at eksporten blir riktig. Dette valget påvirker hvilket miljø Webtemp skal sende eksporten til. Dette gjelder eksport av lønn og av ansatte.
Bytt Prosjekt Koststed	Ja, Nei	Hvis Ja sendes koststed fra Webtemp som prosjekt til Xledger, og prosjekt sendes som koststed. Brukt av bl.a. Rotam.
Map prosjekt med Code	Ja, Nei	Prosjekter i Xledger er registrert med en code og en description. Hvis verdien registrert i Webtemp skal matche med description settes denne til Nei, hvis verdien i Webtemp skal matche med code settes denne verdien til Ja.
Payment Notification	Ja, Nei	Velg om dette feltet i Xledger skal setter til Ja eller Nei for alle kandidater overført til Xledger
Timesheet	Ja, Nei	Velg om dette feltet i Xledger skal setter til Ja eller Nei for alle kandidater overført til Xledger
Overtime	Ja, Nei	Velg om dette feltet i Xledger skal setter til Ja eller Nei for alle kandidater overført til Xledger
Flextime	Ja, Nei	Velg om dette feltet i Xledger skal setter til Ja eller Nei for alle kandidater overført til Xledger
Timebased	Ja, Nei	Velg om dette feltet i Xledger skal setter til Ja eller Nei for alle kandidater overført til Xledger
EmploymentFormFromStatus	Ja, Nei	Som standard hentes Ansettelsesform fra om kandidaten har garantilønn med mer enn 0% stilling eller ikke, og om ikke kandidaten har det, så sjekkes det om kandidatens status inneholder ordet “fast”. Hvis denne innstillingen settes til Ja vil garantilønnsperiodene ignoreres.
Lønnsart tekst fra Xledger	Ja, Nei	Hvis ja erstattes produktnavn fra webtemp med lønnsartens navn fra Xledger i tekstfeltet på lønnslinjer.
Yrkeskode fra stilling	Ja, Nei	Hvis ja hentes yrkeskode fra ekstraparameter på stillingen knytt til en kandidat i steden for fra oppdrag.
Ikke bruk stillingsregister	Ja, Nei	Ansettelsesforhold er basert på garantilønnsperioder. Hvis ja overføres ikke flere stillinger separat, abre det som legges direkte på kandidatene.
Kombiner stillingsendringer	Ja, Nei	Ansettelsesforhold er basert på garantilønnsperioder. Hvis Ja vil stillinger med en sluttdato som er 0-1 dager fra en annens startdato kombinert.
Inkluder Koststed på ansatte	Ja, Nei	Legger koststed på ansattkortet i Xledger
Bruk stilling fra medarbeider	Ja, Nei	Benytter yrkeskode o.l fra hoved-stilling tilknyttet medarbeider

2. Faktura (se Eksport for forklaring på felter som finnes i begge):

Navn	Valg	Forklaring

Navn	Valg	Forklaring
Inkluder Produkter	Ja, Nei	Hvis ja inkluderes alle produkter i eksporten, noe som fører til flere linjer med noe mer detaljer.
AutoExport	Ja, Nei	Eksporter faktura i det eksporten genereres.

3. Payroll

Prosjekt og Koststed alternativer:
Under oppdrag:
Bokfør mot Avdelingsid/nr
Bokfør mot Prosjektid/nr

Eksempel fra 88:

Ref merking.

Eksportering

For å gjøre en eksport må man først gå til Timelister/Faktura - Eksport til lønn

Her må det Genereres en eksport med den dataen man ønker å eksportere.

Når det er gjort kan man se i listen over eksporter, ved å trykke på “Tidligere eksportert” enten rett over Oprett ny eksportfil knappen, elelr fra Timerlister/faktura - Tidligere eksportert lønn.

I denne listen velges eksporten man ønsker å sende til Xledger.

Når en eksport er valgt, og Xledger er slått på for firmaet kan man se en knapp som heter Eksporter til Xledger. Denne knappen kan brukes til å sende eksporten til Xledger. Da vil automatisk de ansatte bli oppdatert først. I nedtrekksmenyen er det også et valg for å bare eksportere ansatte.

Før en eksport gjøres kan det være veldig nyttig å prøve “Valider data uten eksport”.

Dette verktøyet lar deg verifisere alle kandidatenes info. Dette gjelder adresse, personnummer, fødselsdato, bankkonto, iban og swift. I tillegg til at den kan sjekke prosjekter og koststed. Her kan man redigere kandidatene direkte og rette opp i feil enkelt.

Feilmeldinger:

Feilmelding	Forklaring	Løsning

Feilmelding	Forklaring	Løsning
PdSetup	Lønnsart mangler i Xledger.	Registrer manglende lønnsart i Xledger.
payrollRunSetupId: No value matching...	PayrollRunSetup er registrert feil i innstillinger i webtemp	nedslags meny → eksport innstillinger → Payroll → velg ny standard payroll, deretter lagre.
Token missing	Token finnes ikke eller fungerer ikke til valgt miljø.	Sjekk om token er regitrert til produksjon eller demo, deretter sjekk i innstillinger om produksjon eller demo er valgt der. Når produksjon er valgt hentes produksjonstoken. Når demo er valgt hentes demo token.

Hva må gjøres i forkant av kunden selv:

Vær nøye med adresser - husk land

Vært nøye med fødselsdato og at denne må stemme med personnummer/D-nummer

Kontonummer, IBAN, SWIFT må skrives med store bokstaver. Husk kontant betaling og å ta dette vekk om medarbeider har fått norsk konto i ettertid.

Ved eksport:

Først kan man kjøre en validering i WT der man vil få opp feilmeldinger dersom det er noe som avviker, feil eller mangler i personnummer, IBAN etc. Dette er noe strengere enn Xledger men en fin måte å kvalitetssikre det man sender over. I dette bildet kan man registrere den ansatte direkte, uten å måtte bytte bilde. (legg ved bilde/eksempel)

Tilleggsparametre

Ansatte uten timelister ol. kan bli eksludert. For å unngå dette kan denne settes:
eksporteraltvikarer=1

Pågående saker: https://jira.websystemer.as/browse/WTD-2945