Slik eksporterer du skifteplaner som CSV eller kalenderfil (ICS) – stegvis mal

Hvorfor eksportere som CSV eller ICS?

CSV gir strukturert tabulardata som du kan importere i regneark eller HR-systemer. ICS (iCalendar) gir deg kalenderhendelser som kan abonnere på fra Google Calendar, Apple Calendar eller Outlook, og som oppdateres automatisk når kilden endres.

Valget avhenger av hva du skal bruke dataene til: gjør du manuell lønnssjekk eller viderebehandling i Excel, bruk CSV. Vil du se skiftene i samme kalenderapp som privatkalenderen din, bruk ICS/abonnement.

Eksportmuligheter i PayCheck AI (kort overblikk)

PayCheck AI lar deg bygge en arbeidskalender med individuelle skift, forhåndsinnstilte rotasjoner og egne dagsbaserte rotasjoner. Du kan sync'e til enheter og eksportere som CSV eller ICS.

Pro-brukere kan i tillegg konfigurere avanserte lønnsrelaterte innstillinger (daglig/ukentlig overtidsterskel, natt-vindu, helgetillegg og helligdager) i sin egen beregning, men disse er personlige innstillinger og vises kun i eksporten som du velger å inkludere eller ikke.

Du kan også opprette en privat read-only kalenderabonnement for Google, Apple eller Outlook som oppdateres fra PayCheck AI (én-veis; ikke toveiskobling).

Eksportmal: felter for CSV (forklaring)

Her er en praktisk mal for CSV-eksport slik at mottakere vet hva hvert felt betyr. Tilpass kolonnenavnene om nødvendig ved import i målprogrammet.

Forslag til kolonner (en rad per skift):

1) shift_id — Unik intern identifikator for skift (tekst).

2) user_id / navn — Bruker eller skifttaker (navn eller ID) — for teambruk vises synlig navn hvis du eksporterer teamkalenderen. Personlige sensitive felt som medisinske data eller private notater eksporteres ikke automatisk; sjekk hva du inkluderer før eksporten. 3) start_datetime — Startdato og tidspunkt i ISO 8601 (f.eks. 2026-12-01T07:00:00+01:00). 4) end_datetime — Sluttdato og tidspunkt i samme format. 5) duration_hours — Lengde i timer (desimal). 6) role / posisjon — Valgfritt tekstfelt for stilling eller teamrolle. 7) location — Valgfritt tekstfelt for sted eller avdeling. 8) pay_rate — Valgfritt: timesats angitt manuelt (merk at alle beregninger avlønn må kontrolleres manuelt med lokale regler). 9) notes — Private skiftnotater eller offentlig kommentar (merk: private skiftnotater kan være ekskludert avhengig av personverninnstillinger). 10) is_published — Om skiftet er publisert/tilordnet (true/false) — nyttig for teameksport.

Eksportmal: feltforklaring for ICS (iCalendar)

ICS bruker kalenderhendelser fremfor kolonner. Viktige iCalendar-felt og hvordan du bør bruke dem:

1) UID — Unik identifikator per hendelse (brukes for å oppdatere hendelser ved abonnentoppdatering).

2) DTSTART / DTEND — Start og slutt i UTC eller med lokal tidssone. Bruk korrekt tidssone slik at kalenderappen viser riktige klokkeslett. 3) SUMMARY — Kort tittel, f.eks. "Skift: Sjåfør - Dag". 4) DESCRIPTION — Lengre beskrivelse (inkluder rolle, sted, relevant notat). 5) LOCATION — Sted. 6) TRANSP — Transparency (default "OPAQUE"; eventuelle blokkerende hendelser beholdes slik at de vises som opptatt). 7) SEQUENCE — Øk ved hver oppdatering slik at abonnenter får endringen. 8) ORGANIZER / ATTENDEE — Brukes for teamhendelser der organisatør eller deltakere er relevante; merk at abonnementsfeed er read-only og vil ikke tillate redigering fra Google/Apple/Outlook.

Steg-for-steg: generer og last ned CSV eller ICS fra PayCheck AI

1) Velg kalender eller teamvisning du vil eksportere. Kontroller at visningen viser akkurat de skiftene du ønsker (periode, teammedlemmer, personlige filtre).

2) Velg eksporttype: CSV for tabulardata eller ICS for kalenderabonnement/fil. Hvis du trenger begge, gjør to eksportløp.

3) Tilpass feltene før eksport (hvis appen tilbyr feltvalg). Inkluder nødvendige kolonner som start/end, navn og eventuelle lønnsfelt du trenger. Husk å fjerne private notater hvis du deler filen utenfor teamet.

4) Generer eksporten. For CSV: last ned filen og åpne i Excel/Numbers eller last opp til målsystemet. For ICS: du kan enten laste ned en .ics-fil eller opprette en privat kalenderabonnement-URL (les neste punkt). 5) Test importen i målsystemet: for CSV, gjør en prøveimport i regneark og verifiser tidssoner og datofelt. For ICS, legg til abonnement i Google/Apple/Outlook (se eksempel). 6) Verifiser at oppdateringer i PayCheck AI reflekteres: gjør en liten endring i et skift (tid eller notat), og se at endringen dukker opp hos abonnenten etter kalenderens oppdateringsintervall.

Eksempel: lese-only abonnement i Google/Apple/Outlook

Du vil ofte få best brukeropplevelse ved å bruke kalenderabonnement fremfor manuell .ics-import. Abonnement gjør at endringer fra kilden (PayCheck AI) push/refreshes til abonnentene uten at de kan redigere hendelsene lokalt.

Slik fungerer det i praksis:

1) Opprett abonnement: fra PayCheck AI oppretter du en privat kalenderabonnement-URL. Denne er én-veis; abonnenten kan se, men ikke endre hendelser i kilden. 2) Legg til i Google Calendar: Åpne Google Calendar i nettleser > venstre side 'Other calendars' > 'Add by URL' > lim inn URL. Google oppdaterer abonnement med jevne mellomrom (intervallet bestemmes av Google, vanligvis hver få timer). 3) Legg til i Apple Calendar (macOS/iOS): Velg 'Add Subscription' og lim inn URL. Apple lar deg sette oppdateringsintervall for noen abonnementer, men ofte er standardintervall administrert av systemet. 4) Legg til i Outlook: Velg 'Add Calendar' > 'From Internet' og lim inn URL. Outlook oppdaterer abonnementet med et intervall som kan variere etter Outlook-versjon. 3) Sjekk read-only oppførsel: Abonnementskalendere fra PayCheck AI er ikke toveiskoblede; endringer må gjøres i PayCheck AI og publiseres på nytt for at abonnenten skal se dem.

Tips: bruk tydelige SUMMARY- og DESCRIPTION-felt slik at skiftinformasjon er enkel å forstå i tredjeparts-kalendere. Hvis du publiserer teamskift, sørg for at personlige opplysninger du ikke vil dele er skjult i feeden.

Praktisk eksempel – hypotetisk arbeidsscenario

Anta at du driver en liten vaktliste for et team: hver rad i CSV inneholder start/end, navn, stilling og notat. Du eksporterer og laster opp CSV til regneark for manuell lønnssjekk. Samtidig oppretter du en ICS-abonnement for hver teammedlem som vil se sine skift i sin egen Google Calendar.

Når teamlederen endrer et skift i PayCheck AI (flytter starttidspunkt), oppdateres ICS-feedens UID og SEQUENCE. Abonnentens kalenderprogram ser at SEQUENCE er høyere og henter den nye tiden ved neste synkronisering. Dette gir et praktisk read-only synkronisert system uten direkte redigering fra mottakerens kalender.

Praktisk sjekkliste

• Velg riktig eksportformat: CSV for regneark / ICS for kalenderabonnement.
• Kontroller tidssoner og bruk ISO 8601-format for CSV-datoer.
• Fjern private notater eller sensitive felt før deling.
• Test import i målsystemet (Excel eller Google/Apple/Outlook).
• Opprett kalenderabonnement for automatisk oppdatering hvis du trenger read-only synk.
• Bekreft at endringer i PayCheck AI reflekteres i mottakerkalenderen etter oppdatering.

Vanlige spørsmål

Hvor ofte oppdateres et kalenderabonnement?

Oppdateringsfrekvens for et kalenderabonnement bestemmes av den klienten (Google, Apple eller Outlook). PayCheck AI leverer en read-only feed, men det er klientens oppdateringsintervall som avgjør hvor raskt endringer vises hos abonnenter.

Kan mottakeren redigere skiftene fra Google Calendar eller Outlook?

Nei. En privat kalenderabonnement fra PayCheck AI er read-only. Endringer må gjøres i PayCheck AI og publiseres der for at abonnenten skal se dem.

Hva bør jeg inkludere i CSV for lønnskontroll?

Minimalt: start_datetime, end_datetime, duration_hours, navn, eventuelt timesats og rolle. Husk at alle lønnsberegninger må verifiseres manuelt; PayCheck AI kan hjelpe med estimater, men lokale regler og skatte-/overtidsregler varierer.

Er det trygt å dele en kalenderabonnement-URL?

En abonnements-URL bør behandles som privat: hvem som helst med URL-en kan se feeden. Del kun med personer eller tjenester som skal ha tilgang, og opphev abonnement hvis det deles ved en feil.

Kan jeg eksportere teammedlemmeres private data?

Teamvisninger viser synlige profilnavn og arbeidsskift, men personlige pay-innstillinger, private skiftnotater og medisinske detaljer er ikke delt i teamkalenderen. Eksporten speiler hva visningen tillater; sjekk alltid hvilke felt som inkluderes før du deler filen.