Integrationer

Gå till Integrationer i navigeringen för att koppla SessionPilot OPS till HR- och löneplattformar från tredje part så att uppgifterna om anställda hålls i synk. Det här är ett nytt område i appen - just nu finns en integration: Nmbrs, en nederländsk/belgisk löne- och HR-plattform. Precis som Fakturering är sidan begränsad till ägare och driftchefer.

Nmbrs använder en säker inloggningsöverlämning (OAuth) snarare än en API-nyckel du kopierar och klistrar in - du loggar in i ditt eget Nmbrs-konto och SessionPilot ser eller sparar aldrig ditt Nmbrs-lösenord. Kopplingen begär precis fyra behörigheter från Nmbrs: läsåtkomst till uppgifter om anställda, anställningar och företag, plus offline_access - den tekniska behörighet som låter Nmbrs utfärda ett förnyelsetoken så att SessionPilot kan förbli ansluten utan att du behöver godkänna på nytt varje timme. Den kan inte göra ändringar i ditt Nmbrs-konto. Åtkomst- och förnyelsetokens krypteras innan de sparas.

Statusetiketten på kopplingskortet speglar vad som är sparat för din restaurang: Inte konfigurerad, Frånkopplad, Ansluten eller Fel.

Om det står “Inte tillgänglig än”

Visar Nmbrs-kortet Inte tillgänglig än har SessionPilots team ännu inte färdigställt den plattformsövergripande kopplingen till Nmbrs för ditt konto (det beror på en uppsättning inloggningsuppgifter på plattformsnivå, inte på något restaurangspecifikt). Kontakta supporten för att få det aktiverat - fram till dess finns inget att konfigurera i din ände.

Koppla Nmbrs

1. Klicka på Koppla Nmbrs.
2. Du skickas vidare till Nmbrs och ombeds logga in i ditt eget Nmbrs-konto (om du inte redan är inloggad) och ge SessionPilot åtkomst.
3. När du godkänt åtkomsten kommer du tillbaka till sidan Integrationer, som nu visar Ansluten.

Återvägen till SessionPilot bär ett signerat engångstoken som identifierar din restaurang och som går ut exakt 10 minuter efter att du klickat på Koppla Nmbrs. Nekar du åtkomst i Nmbrs-skärmen, eller tar det längre tid än så att komma igenom Nmbrs inloggning och samtycke, hamnar du helt enkelt tillbaka på sidan Integrationer utan koppling och utan felmeddelande - knappen Koppla Nmbrs finns kvar, så försök bara igen.

Misslyckas själva överlämningen efter att du godkänt åtkomsten (till exempel om Nmbrs inte går att nå, eller om den tillfälliga koden Nmbrs skickade tillbaka inte kan bytas in) visar kortet i stället Fel med ett meddelande om vad som gick snett. Klicka på Koppla Nmbrs igen för att göra om hela överlämningen från början.

Välja ett företag

När du är ansluten väljer du vilken Nmbrs-företagspost som ska kopplas:

1. Välj rätt företag i menyn Nmbrs-företag.
2. Klicka på Spara.

Sidan visar vilket företag som är kopplat som “Ansluten som [företagsnamn]” till ett valts. Företagslistan hämtas på nytt från Nmbrs varje gång du laddar sidan Integrationer (den cachas inte), så om SessionPilot inte kan hämta din företagslista från Nmbrs just då (oftast ett tillfälligt problem med Nmbrs API) ersätts menyn med ett felmeddelande i stället - att ladda om sidan eller koppla på nytt löser oftast det. Har ditt konto fler än 100 företag bläddrar SessionPilot automatiskt genom Nmbrs företagslista, så att menyn visar allt och inte bara första sidan.

Du kan byta valt företag när som helst genom att välja ett annat och klicka på Spara igen - du behöver inte koppla bort först. Vill du byta till ett annat Nmbrs-konto helt (inte bara ett annat företag inom samma konto), koppla bort först och koppla sedan på nytt - det finns ingen separat åtgärd för att byta konto.

Importera anställda

När ett företag är valt klickar du på Importera anställda för att hämta namn på anställda från Nmbrs in i SessionPilot. Bara Nmbrs-anställda som ligger på lön hämtas - själva förfrågan till Nmbrs filtreras på anställda av lönetyp, så sökande, tidigare personal och externa uppdragstagare i Nmbrs kommer aldrig med i resultaten.

• Anställda matchas på sitt Nmbrs-anställningsnummer, så att importera igen senare uppdaterar befintliga personers namn i stället för att skapa dubbletter.
• Bara grunduppgifter importeras (det fullständiga namnet, byggt av Nmbrs fält för förnamn, prefix och efternamn - så ett nederländskt “tussenvoegsel” som “van der” bevaras) - varje ny anställd skapas med en automatiskt genererad intern inloggning och anställningskod, placeras i restaurangens standardavtalskategori Heltid och lämnas utan enhet. Du behöver fortfarande öppna profilen i SessionPilot för att ange enhet, roll, lön och övriga uppgifter separat.
• När en import är klar visar sidan hur många anställda som lagts till, uppdaterats och hoppats över (överhoppade omfattar både en Nmbrs-post utan användbart namn och, i sällsynta fall, ett internt fel när kontot skulle skapas för just den posten), tillsammans med datum och tid för senaste importen.
• Har din plan en gräns för antal anställda räknas bara verkligt nya anställda mot den - att importera om någon som redan finns uppdaterar bara namnet och tar ingen plats (det kontrolleras mot ditt antal aktiva, icke-avslutade anställda). Skulle en ny anställd föra dig över gränsen stoppar importen direkt där och berättar hur många som lagts till innan gränsen nåddes; övriga Nmbrs-anställda berörs inte. Uppgradera din plan och kör Importera anställda igen för att hämta in resten (redan importerade personer matchas och hoppas över, inte dubbleras).
• Har din Nmbrs-koppling tyst gått ut (se nedan) när du klickar på Importera anställda körs importen inte alls - du får då “Din Nmbrs-koppling har gått ut. Koppla på nytt och försök igen.” Att koppla på nytt (via Koppla Nmbrs) löser det.
• Importera anställda är inaktiverad i gränssnittet till ett företag faktiskt valts och sparats.

Tokens som går ut och förnyas

Nmbrs åtkomsttokens är medvetet kortlivade. SessionPilot förnyar din automatiskt i bakgrunden så snart den är ungefär en minut från att gå ut, så i det dagliga arbetet märker du inget - det finns ingen synlig uppmaning att koppla om vid rutinmässiga förnyelser. Varje förnyelse roterar också själva förnyelsetoken (Nmbrs utfärdar ett nytt varje gång), som SessionPilot sparar i stället för det gamla automatiskt. Du märker bara något om själva förnyelsen misslyckas (till exempel om åtkomsten återkallats på Nmbrs sida, eller om kopplingen legat oanvänd så länge att Nmbrs ogiltigförklarat den): statusetiketten slår om till Fel, och nästa åtgärd du gör (ladda företagslistan eller importera) visar ett meddelande om att du behöver koppla på nytt. Att koppla på nytt via Koppla Nmbrs återställer allt, inklusive det företag du tidigare valt (du kan välja det igen, eller ett annat, direkt efteråt).

Koppla bort

Klicka på Koppla bort för att ta bort Nmbrs-kopplingen. Det rensar det sparade företagsvalet och alla sparade tokens; du behöver koppla på nytt och välja ett företag igen innan du kan importera.

Vanliga frågor

Nmbrs visar “Ansluten” men jag ser inga anställda att importera. Se till att du först valt ett företag under Välja ett företag - Importera anställda är inaktiverad till ett företag valts. Kontrollera också att själva Nmbrs-företaget har anställda av lönetyp; andra anställningstyper returneras inte.

Att klicka på “Koppla Nmbrs” verkade inte göra något. Du nekade troligen åtkomst i Nmbrs-skärmen, eller dröjde för länge där (inloggningsfönstret går ut exakt 10 minuter efter att du klickat på Koppla Nmbrs). Ingen skada skedd - klicka bara på Koppla Nmbrs igen.

Min import stoppade halvvägs. Du nådde gränsen för antal anställda i din plan. Sammanfattningen berättar hur många som lades till innan den stoppade. Kontakta supporten för att höja gränsen och kör sedan importen igen för att fortsätta där den slutade.

Menyn med Nmbrs-företag laddar inte. Det är oftast ett tillfälligt problem med att nå Nmbrs API - listan hämtas live vid varje sidladdning i stället för att cachas, så en störning hos Nmbrs märks direkt. Ladda om sidan; håller det i sig, koppla bort och koppla på nytt.