PAXml

This guide details the usage of the PAXML integration for transferring data from Severa to your payroll system. The current integration uses PAXML specification version 2.0. The schema definition can be found at PAXml website. This schema is crucial for validating data, for example, to determine if a specific work type code is allowed.

Admin user permissions are required for the transfer to function correctly.

Setup requirements

To ensure smooth data transfer, please configure the following steps:

1. User employee number: Each user's employee number in Severa must match the employee number in your payroll system. This field cannot be left empty.
2. Work hour types & absence types: These types must have a code that corresponds to the tidkodTYPE list defined in the PAXML schema.
3. Travel expense types: For travel expenses, a numeric product code is required.

File contents

The PAXML file will contain the following data for the selected time period:

• Work hours per date
• Absences per date
• Travel expenses
• Users' expected working time per date (in hours)

Work hours

Work hours are transferred with a specific identifier. For example:

• Normal work hours: Set identifier to TID
• Overtime: Set identifier to ÖT1

If Work hour approval is enabled in Severa, only Approved hours will be transferred.

Example

<tidtrans anstid ="101" = employee number

<tidkod>TID</tidkod> = work type code

    <datum>2023-05-02</datum> = date of hour entry

    <timmar>8</timmar> = duration of entry

</tidtrans>

Absences

Absences are transferred with specific identifiers. For example:

• Sick leave: Set identifier to SJK
• Parental leave: Set identifier to FPE

The absence date must overlap with the given time period for inclusion in the transfer.

Important information about absences

If a single absence spans multiple days and extends beyond the selected time period, it will be truncated to match the given dates in the transfer file.

Absences spanning multiple dates are split into individual daily entries in the transfer file. This is done because external payroll systems might not support date ranges for absences.

If an absence is given the code FLX, its duration will be marked as negative.

Example

<tidtrans anstid="101"> = employee number

<tidkod>SEM</tidkod> = absence type code

    <datum>2023-07-05</datum> = date of absence

    <timmar>8</timmar> = duration of absence or users contracts work hours if full day absence

</tidtrans>

Travel expenses

Travel expenses are only transferred if the user has full permission to projects in Severa. If the Travel reimbursement addon is active, only Approved reimbursements are transferred, and their approval date must fall within the given time period. Otherwise, the expense date must overlap with the selected dates.

For mileage and daily allowance types, both quantity and price per unit are transferred. Other expenses are split into two parts:

1. The VAT for the expense with a static type code of 997.
2. The unit cost (amount without VAT). Other expenses use the lump sum of the expense instead of quantity and unit cost.

Example (Mileage/Daily Allowance)

<lonetrans anstid="101"> = employee number

<lonart>559</lonart> = product code

<datumfrom>2024-09-26T00:00:00</datumfrom> = start date

<datumtom>2024-09-26T00:00:00</datumtom> = end date

<antal>140.0000</antal> = quantity

<apris>14.0000</apris> = price

<varugrupp>Mileage</varugrupp> = travel expense type

</lonetrans>

Example (other expenses)

<lonetrans anstid="101"> = employee number

    <lonart>997</lonart> = static code 997 for VAT account

    <datumfrom>2025-01-28T00:00:00</datumfrom> = start date

    <datumtom>2025-01-28T00:00:00</datumtom> = end date

    <belopp>18.38710</belopp> = VAT amount

    <varugrupp>OtherTravelExpense</varugrupp> = travel expense type

    <samlingsid>2</samlingsid> = running number for connecting VAT to entry

</lonetrans>

<lonetrans anstid="101"> = employee number

    <lonart>179</lonart> = product code

    <datumfrom>2025-01-28T00:00:00</datumfrom> = start date

    <datumtom>2025-01-28T00:00:00</datumtom> = end date

    <belopp>76.6129</belopp> = amount without VAT

    <varugrupp>OtherTravelExpense</varugrupp> = travel expense type

    <samlingsid>2</samlingsid> = running number for connecting entry with VAT

</lonetrans>

Users' expected working hours

These entries are transferred for every day within the selected date range and for every user with an active working contract that specifies hours for that date.

Example

<schema anstid="101"> = employee number

    <dag datum="2023-05-02" timmar="8.00" /> = date and contract work hours

    <dag datum="2023-07-05" timmar="8.00" />

</schema>

How to use PAXml

Follow these steps to generate and use the PAXmlfile:

1. In Severa navigate to top right corner's wheel icon and go to Data transfer > PAXml export
2. Select the desired time range for the export
3. Select business unit
4. Download file to receive the PAXML file
5. Upload the file to your payroll system

Did you find it helpful? Yes No

Send feedback