Skip to content
English
  • There are no suggestions because the search field is empty.

PAXml integration

Export people and absence from Huma as PAXml files you can import into Swedish payroll systems

 

Table of contents

 

 

Roles and access

Export Access you need in Huma
People (with or without salary) Access to export users in People
Absence Absence administrator, or access to manage other people's absence

 

💡 Not sure what access you have? Contact your Huma administrator.

 

 

What PAXml is

PAXml (Payroll XML) is a Swedish standard file format for moving payroll data between systems. Many Swedish payroll systems can import PAXml files.

 

In Huma, PAXml is an export format, not a live integration. You download a .pax file from Huma and import it into your payroll system yourself. Nothing is synced automatically.

 

Data Where you export it How you get the file
Employee details and salary People Downloaded right away
Approved absence Absence Sent to you by email

 

 

Export people

  1. Go to People.
  2. Click "Export users".
  3. Choose who to include.
  4. Choose what to include. Turn on "Include salary" if you want the salary in the file, and choose the date the salary should apply on.
  5. Choose the format "XML (PAXml)".
  6. Download the file. It is called "Huma User Export.pax".

 

⚠️ Employees with neither an employee ID nor a Swedish personal identity number are left out of the file.

⚠️ Salaries in other currencies than SEK are left out.

 

 

Export absence

  1. Go to Absence.
  2. Choose to export absence details.
  3. Choose the format "XML (PAXml)".
  4. Choose absence types, time period, who to include and account status.
  5. Start the export.
  6. You get an email with the .pax file attached.

 

💡 PAXml only supports approved absence. The status is set to "Approved" and can't be changed.

⚠️ Absence for employees with neither an employee ID nor a Swedish personal identity number is left out.

 

 

What the file contains

File header (both files)

PAXml element Value
version 2.2
format REGISTER
datum Date and time of the export
foretagid, foretagnamn Your organization's ID and name in Huma
kontaktperson, epost Name and email of the person who exported
programnamn Huma (www.humahr.com)

 

People file

Huma field PAXml element Notes
Employee ID anstid Employee ID or Swedish personal identity number is required.
Identifications persnr Only a Swedish personal identity number. Written with 12 digits, including the century.
Account status delete Set for deactivated employees.
Given name, Family name fornamn, efternamn  
Home address postadress, extraadress, postnr, ort, land  
Phone number arbetstelefon  
Email address epostarb  
Job title befattning From the current position.
Contract type anstform See the table below.
Bank account bankkonto, or bankiban and bankbic A national account goes to bankkonto. An account with a BIC goes to bankiban and bankbic.
Employment start and end date anstdatum, avgdatum  
Salary lonform, manlon, timlon, innevarande Only when "Include salary" is turned on, and only in SEK. Monthly salary is written as MÅN and hourly wage as TIM. Yearly salary is converted to a monthly salary (divided by 12). Weekly salary is not included. The salary's start date is set on the amount.

 

Contract types

Contract type in Huma anstform in PAXml
Permanent FAST
Temporary VISSTID, or PROV if the probation period has not ended
Casual VIKARIAT
Trainee PRAKTIK
Seasonal SÄSONG
Consultant, Freelance, Third party PROJEKT
Job training program, Other Not included

 

Absence file

Huma field PAXml element Notes
Employee ID anstid  
Identifications persnr Only a Swedish personal identity number, with 12 digits.
Absence type tidkod From the base type of the absence type. See Absence codes.
Dates datum, or datumfrom and datumtom One day is written as datum. Longer absence is written with start and end date.
Grade omfattning In percent, for example 100 or 50.
Bank account kontonr The employee's bank account number from Huma.

 

 

Absence codes

The time code (tidkod) comes from the base type of each absence type in Huma.

Base type in Huma tidkod
Vacation SEM (semester)
Sick child VAB (vård av barn)
Sick leave SJK (sjuk)
Self-certified sick leave SJK_KAR (karensdag)
Parental leave FPE (föräldraledig)
Paid time off KOM (kompledig)
Unpaid time off PEM (permission)

 

⚠️ The export code you set on an absence type is not used in the PAXml file. Absence types without one of these base types get an empty time code. Check the codes in your payroll system after import.

 

 

Systems that can import PAXml

Updated March 1, 2024.

 

🔗 Read more about PAXml on paxml.se

 

 

FAQ

Is PAXml synced automatically?
No. PAXml is a file you export from Huma and import into your payroll system. Export a new file when you need updated data.

 

Why is an employee missing from the file?
Employees with neither an employee ID nor a Swedish personal identity number are left out. Add one of them in Huma and export again.

 

Why is the salary missing?
Turn on "Include salary" when you export. Only salaries in SEK are included, and weekly salaries are left out.

 

Why can't I export pending absence?
PAXml only supports approved absence. Approve the absence first, then export.

 

Why does an absence have the wrong or no time code?
The time code comes from the base type of the absence type, not the export code. Absence types without a supported base type get an empty time code.

 

Where is my absence file?
The absence export is sent to your email when it's ready. Check your inbox and spam folder.

 

 

Related articles

🔗 Crona Lön integration

🔗 Fortnox integration