Nu kan du automatisera löneöverföringar från Flex HRM Travel & Expense via API. Det innebär att du slipper logga in i webbgränssnittet för att manuellt starta varje överföring – istället triggar du hela flödet direkt från ditt externa system.

Från manuellt till automatiserat

Tidigare behövde du som administratör eller integratör logga in i Flex HRM och manuellt starta löneöverföringar från Travel-modulen. I automatiserade arbetsflöden skapade det onödiga mellansteg och flaskhalsar.

Nu finns API-stöd för att skapa, hämta och backa löneöverföringar i Flex HRM Travel & Expense. Om du redan använder motsvarande API för Flex HRM Time kommer du att känna igen strukturen – det nya API:et för Travel följer samma mönster.

Skapa en löneöverföring

Du startar en löneöverföring genom att skicka en POST-request till /api/travel/salaryTransfer. Systemet köar upp ett bakgrundsjobb och respekterar dina befintliga inställningar för lönekoppling, till exempel filnamn och om filen ska sparas. Överföringen syns sedan i vyn Löneöverföringar i gränssnittet.

Hämta en löneöverföring

Du kan följa upp status och hämta data för löneöverföringar på två sätt:

• Hämta en specifik överföring via dess ID: GET /api/travel/salaryTransfer/{id}
• Hämta alla överföringar för ett företag: GET /api/company/{companyId}/travel/salaryTransfer

Svaret innehåller information om överföringen, inklusive status och datumurval.

Backa en löneöverföring

Om en överföring har blivit felaktig kan du backa den genom att anropa POST /api/travel/rollbackSalaryTransfer. Systemet startar då ett bakgrundsjobb som återställer transaktionerna. Observera att du bara kan backa överföringar som inte har låsts. Det är i nuläget inte möjligt att göra en återöverföring via API.

Hämta löneunderlag

Det finns även ett nytt endpoint för att hämta detaljerat löneunderlag: GET /api/travel/salaryBasis. Med det kan du hämta information per anställd och löneart, inklusive konteringar, direkt via API. Det gör det möjligt att populera externa system med korrekt data, till exempel i en Paxml-struktur.

Svaret innehåller bland annat anställningsnummer, personnummer, löneart, antal, à-pris, belopp, konteringsfördelning, transaktionsdatum och referensnummer (reseräkningsnummer eller körjournalsavräkningsnummer).

Bra att veta

API:et använder standardiserade felkoder. Om till exempel utbetalningsdatum saknas eller ett anställningsnummer inte hittas får du ett tydligt felmeddelande. Alla endpoints kräver samma behörighetsnivå som övriga API-endpoints i Flex HRM.

Du hittar fullständig teknisk dokumentation med parametrar, svarsstrukturer och exempelanrop i API-hjälpen.