DokumentAdress
← Alla guider

Koppla ihop med er schemaläggning

Skicka in pass från ert eget schema så blir inrapporteringen avvikelsebaserad — planerat och verkligt utfall sparas sida vid sida.

Utvecklare · cirka 6 minuters läsning

Har ni redan schemaläggning i ert eget system ska personalen inte behöva skriva in samma pass två gånger. Schemalagret löser det: ni äger schemat, vi håller en kopia och jämför rapporterad tid mot det planerade passet.

Lagret slås på per organisation. Kunder utan schemaläggning påverkas inte — inrapporteringen ser då ut precis som förut.

Inställningar

InställningBetydelse
scheduling_enabledVisar pass för personalen och tar emot inskickade pass.
allow_unscheduled_entriesTillåter rapportering utan pass (extrainsats, jour).
clock_enabledStämpling in och ut.
mileage_rate_oreMilersättning i ören per kilometer.
default_break_minutesFörvald rast.

Skicka in pass

POST /shifts — scope documents:write, max 500 pass per anrop.

{ "shifts": [
  { "external_ref": "pass-90412",
    "staff_external_ref": "emp-9",
    "employee_number": "1042",
    "tenant_ref": "nordbutik-linkoping",
    "shift_date": "2026-01-15",
    "start_time": "08:00",
    "end_time": "16:30",
    "break_minutes": 30,
    "role_label": "Kassa",
    "note": "Dubbelbemanning",
    "status": "planned" }
] }
  • external_ref är passets id hos er. Samma referens uppdaterar passet i stället för att skapa ett nytt, så hela veckan kan skickas om utan dubbletter.
  • Personen hittas via staff_external_ref i första hand, annars employee_number. Okänd person ger unknown_staff för just det passet — lägg upp henne i personalregistret först.
  • tenant_ref kopplar passet till rätt enhet.
  • status: "cancelled" markerar ett inställt pass.

Svar 200, eller 207 om något pass inte gick igenom:

{ "data": { "saved": 1, "failed": 0,
            "results": [{ "external_ref": "pass-90412", "id": "…",
                          "status": "saved" }] } }

GET /shifts?from=…&to=… med scope documents:read returnerar era pass hos oss, för avstämning.

Avvikelsebaserad rapportering

När schema finns visas dagens pass förifyllt. Personen bekräftar eller anger avvikelse:

on_time, late_start, early_end, overtime, sick, vab, leave, swap, cancelled, other

Tidposten sparar både de planerade och de verkliga timmarna, samt vilket pass den hör till. Det är skillnaden mellan dem som chefen och lönesystemet faktiskt behöver.

Fri inmatning

Utan pass sparas posten som "utan schema" så chefen ser det. Är schemaläggning påslagen och fri inmatning avstängd avvisas posten i stället.

Ordningen att bygga i

  1. Lägg upp personalen (POST /staff-members).
  2. Skicka in schemat (POST /shifts) — gärna som ett nattligt jobb plus en direktsändning vid ändring.
  3. Låt personalen rapportera — förifyllt pass, avvikelse vid behov.
  4. Attestera, och läs ut till lönekörningen.

Fortsätt läsa