Nå kan du automatisere lønnsoverføringer fra Flex HRM Travel & Expense via API. Det betyr at du slipper å logge inn i webgrensesnittet for å manuelt starte hver overføring – i stedet trigger du hele flyten direkte fra ditt eksterne system.
Fra manuelt til automatisert
Tidligere måtte du som administrator eller integratør logge inn i Flex HRM og manuelt starte lønnsoverføringer fra Travel-modulen. I automatiserte arbeidsflyter skapte dette unødvendige mellomsteg og flaskehalser.
Nå finnes det API-støtte for å opprette, hente og reversere lønnsoverføringer i Flex HRM Travel & Expense. Hvis du allerede bruker tilsvarende API for Flex HRM Time, vil du kjenne igjen strukturen – det nye API-et for Travel følger samme mønster.
Opprette en lønnsoverføring
Du starter en lønnsoverføring ved å sende en POST-request til /api/travel/salaryTransfer. Systemet legger et bakgrunnsjobb i kø og respekterer dine eksisterende innstillinger for lønnskobling, for eksempel filnavn og om filen skal lagres. Overføringen vises deretter i visningen Lønnsoverføringer i grensesnittet.
Hente en lønnsoverføring
Du kan følge opp status og hente data for lønnsoverføringer på to måter:
- Hente en spesifikk overføring via dens ID:
GET /api/travel/salaryTransfer/{id} - Hente alle overføringer for en bedrift:
GET /api/company/{companyId}/travel/salaryTransfer
Svaret inneholder informasjon om overføringen, inkludert status og datoutvalg.
Reversere en lønnsoverføring
Hvis en overføring har blitt feilaktig, kan du reversere den ved å kalle POST /api/travel/rollbackSalaryTransfer. Systemet starter da et bakgrunnsjobb som reverserer transaksjonene. Merk at du bare kan reversere overføringer som ikke er låst. Det er for øyeblikket ikke mulig å gjøre en gjenoverføring via API.
Hente lønnsgrunnlag
Det finnes også et nytt endpoint for å hente detaljert lønnsgrunnlag: GET /api/travel/salaryBasis. Med dette kan du hente informasjon per ansatt og lønnsart, inkludert konteringer, direkte via API. Det gjør det mulig å populere eksterne systemer med korrekte data, for eksempel i en Paxml-struktur.
Svaret inneholder blant annet ansattnummer, personnummer, lønnsart, antall, enhetspris, beløp, konteringsfordeling, transaksjonsdato og referansenummer (reiseregningsnummer eller kjørebokavregningsnummer).
Greit å vite
API-et bruker standardiserte feilkoder. Hvis for eksempel utbetalingsdato mangler eller et ansattnummer ikke finnes, får du en tydelig feilmelding. Alle endpoints krever samme tilgangsnivå som øvrige API-endpoints i Flex HRM.
Du finner fullstendig teknisk dokumentasjon med parametere, svarstrukturer og eksempelkall i API-hjelpen.
