Anslut beläggningsdata från valfri källa

Så fungerar det

Organisationer beräknar beläggning på olika sätt: i timmar eller procent, per dag eller per period, och med olika regler för kapacitet. Därför publicerar ert team de poster ni redan har, i en av tre strukturer, och MuchSkills läser av dem enligt ett schema. Innan något går live bekräftar ert team och vår CTO mappningen under en teknisk genomgång.

Behöver ni bara frånvaro behöver ni inte den här sidan. Frånvaro kan komma från ert HR-system, från MuchSkills självt eller via MuchSkills API.

Innan ni börjar

• En teknisk kontaktperson som kan publicera ett säkrat HTTPS-API från ert system.
• Inloggningsuppgifter med enbart läsbehörighet för API:et: en API-nyckel, OAuth 2.0-klientuppgifter eller en tjänsteanvändare med lösenord.
• Timmar eller procent. Välj en och samma värdetyp för alla poster.
• Er kapacitetsregel. En standardvecka för alla, eller kapacitet per person.
• Kontrollera e-postadresserna. Varje post anger personen med e-postadress. Det måste vara samma adress som personen loggar in i MuchSkills med.

Steg

I ert system

1. Kartlägg vilka poster ni har. MuchSkills använder tre posttyper: Allocation (tid på ett projekt), Unavailability (tid då någon inte kan ta på sig nytt arbete, till exempel ledighet, utbildningsdagar eller helgdagar) och Capacity (hur mycket en person som mest kan arbeta under en period). Vilka fält varje typ kräver framgår av tabellen under Bra att veta.
2. Välj struktur. Ta den som ert system enklast kan leverera: A, B eller C, som beskrivs under Bra att veta.
3. Bestäm hur kapaciteten ska skickas. Antingen ett gemensamt värde för hela organisationen som vi ställer in en gång, eller Capacity-poster per person.
4. Publicera API:et. Gör en eller flera endpoints tillgängliga via HTTPS med inloggningsuppgifter som bara ger läsbehörighet. Om ni begränsar åtkomsten per IP-adress behöver ni tillåta 13.51.77.53 och 16.170.107.61.

Tillsammans med MuchSkills

5. Skicka över uppgifterna. Det gäller endpoint-adresserna, vald struktur, ett exempelsvar, er kapacitetsregel och inloggningsuppgifterna, som skickas via en säker kanal som vi kommer överens om.
6. Delta i den tekniska genomgången. Er tekniska kontaktperson och vår CTO stämmer av fältmappningen, dataformatet och autentiseringen. Ni bestämmer också tillsammans hur ofta MuchSkills ska läsa av, hur långt bakåt och framåt i tiden varje avläsning ska gå, vilken tidszon som gäller för datum, hur paginering ska ske och hur korrigerade historiska poster ska returneras.
7. Kontrollera den första avläsningen. Vi läser av ett testdataset eller några få personer och projekt. Ni kontrollerar beläggning och tillgänglighet i MuchSkills.
8. Aktivera kopplingen. Därefter läser MuchSkills av ert API enligt det överenskomna schemat.

Kontrollera att det fungerar

• I rapporterna under Team/Org › Reports ser ni beläggning per person och per projekt för den period ni har skickat.
• Otillgänglighet syns i respektive persons tillgänglighet, till exempel i My Circle.
• När ni bemannar ett team i Team Builder ser ni kandidaternas aktuella allokering.

Det här får ni

• En samlad bild av kompetens och arbetsbelastning. Se vem som har kompetensen och vem som har tid, på ett och samma ställe.
• Ingen dubbelregistrering. Allokeringarna ligger kvar i verktyget som era leveransteam redan använder.
• Bättre bemanningsbeslut. Se vem som är överbokad, vem som saknar uppdrag och vem som snart avslutar sitt uppdrag innan ni tillsätter personer.

Bra att veta

Fält per posttyp. Ni väljer själva vad fälten ska heta. Vi mappar dem under den tekniska genomgången.

De tre strukturerna.

• A. Projekt först. Endpoint 1 listar projekt. Varje projekt har sitt projekt-ID, projektnamn och sina användare, och varje användare har sin e-postadress och sina Allocation-poster (datum eller intervall, värde, värdetyp). Unavailability och Capacity hör inte till något projekt och kommer därför från endpoint 2: en lista över personer, var och en med sin e-postadress och sina Unavailability- och Capacity-poster.
• B. Personer först, med en projektlista. Endpoint 1 listar projekt (projekt-ID, projektnamn). Endpoint 2 listar personer. Varje person har sin e-postadress och sina poster, och varje post anger posttyp, datum eller intervall, värde och värdetyp. Allocation-poster anger även projekt-ID och, om så önskas, ett uppgifts-ID.
• C. Platta poster. En enda endpoint returnerar alla poster i en lista, där varje post innehåller alla sina fält. Det här är enklast att ta fram.

Ett exempel på struktur C, i timmar:

[
  {"recordType": "Allocation", "userEmail": "anna@yourcompany.com", "projectId": "P-1042", "projectName": "Relansering av webbplatsen", "start": "2026-11-02", "end": "2026-11-06", "value": 20, "valueType": "hours"},
  {"recordType": "Unavailability", "userEmail": "anna@yourcompany.com", "date": "2026-11-09", "value": 7.5, "valueType": "hours"},
  {"recordType": "Capacity", "userEmail": "anna@yourcompany.com", "start": "2026-11-02", "end": "2026-11-08", "value": 30, "valueType": "hours"}
]

MuchSkills hämtar data från er. Det finns ingen endpoint hos MuchSkills för att skicka allokeringar. MuchSkills anropar ert API enligt det överenskomna schemat.

Frånvaro från en enda källa. Om ert HR-system redan synkar frånvaro till MuchSkills, utelämna Unavailability-poster för ledighet i det här API:et, eller meddela oss vilken källa som ska gälla. När en HR-integration hanterar frånvaron vägrar MuchSkills API att skriva över den. Skickar ni frånvaro via API:et med PUT /api/v2/profile/{email}/pto ersätts all frånvaro för den personen varje gång.

Inga orsaker, inga hälsouppgifter. Skicka bara datum och tidsmängder. Följande blockeras när data tas emot och lagras aldrig: ålder eller födelsedatum, lön eller andra ersättningsuppgifter, prestationsbedömningar samt politiska, religiösa eller hälsorelaterade uppgifter.

Endast läsbehörighet. MuchSkills skriver aldrig tillbaka till ert system via den här kopplingen.

Våra IP-adresser. MuchSkills ansluter alltid från samma två adresser: 13.51.77.53 och 16.170.107.61. Om ert system eller nätverk begränsar åtkomsten med IP-adresser, lägg till båda i listan över tillåtna adresser.

Felsökning