PAXml integration

PAXml stands for Payroll XML. It's a format based on the XML standard used for transferring payroll data from one system to another. Think of it as the middleman that ensures your data speaks the same language as your payroll software.

How Does It Work?

PAXml can transfer various types of data, including:

Employee personal data
Salary details
Absence data

It simplifies the process by using either time codes or salary codes, telling your payroll system how to classify different types of payroll data. The best part? The system sending the data doesn't need to know the nitty-gritty of payroll management – PAXml does the heavy lifting.

In Huma you will now get an .pax file in addition to .csv and .xlsx including personal data.

Here is an example of how the file looks like:

<?xml version="1.0" encoding="ISO-8859-1" standalone="yes"?>
<paxml xsi:noNamespaceSchemaLocation="http://www.paxml.se/2.2/paxml.xsd" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
    <header>
        <version>2.2</version>
        <format>Lönin</format>
        <datum>2024-02-29T12:30:28.705380841</datum>
        <foretagid>company-id</foretagid>
        <foretagnamn>Company</foretagnamn>
    </header>
    <personal>
        <person anstid="1">
            <fornamn>Karin</fornamn>
            <efternamn>Strand</efternamn>
            <postadress>Hagalia 5c</postadress>
            <postnr>291 84</postnr>
            <ort>Stockholm</ort>
            <land>SE</land>
            <arbetstelefon>+46 7123456789</arbetstelefon>
            <epostarb>karin@company.com</epostarb>
            <befattning>CEO</befattning>
            <anstform>FAST</anstform>
            <bankkonto>8150-5 914 919 079-6</bankkonto>
            <anstdatum>2013-09-26</anstdatum>
            <lonform>MÅN / TIM</lonform>
            <manlon datum="2023-11-10">70000</manlon>
            <timlon datum="2023-11-10">700</timlon>
            <innevarande>true</innevarande>
        </person>
        <person anstid="2">
            ...
        </person>
    </personal>
</paxml>

Absence

<?xml version="1.0" encoding="ISO-8859-1" standalone="yes"?>
<paxml xsi:noNamespaceSchemaLocation="http://www.paxml.se/2.2/paxml.xsd" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
    <header>
        <version>2.2</version>
        <format>LONIN</format>
        <datum>{Date of export}</datum>
        <foretagid>{Company ID}</foretagid>
        <foretagnamn>{Company name}</foretagnamn>
    </header>

    <tidtransaktioner>
        <tidtrans anstid="{employmentId}" persnr="{national identifications number}" postid="{absenceID}">
            <tidkod>{absenceExportCode}</tidkod>
            <datum>{absence date if one day}</datum>
            <datumfrom>{fromDate}</datumfrom>
            <datumtom>{toDate}</datumtom>
            <kontonr>{bankAccountNumber}</kontonr>
            <omfattning>{absencePercentage}</omfattning>
        </tidtrans>
    </tidtransaktioner>
</paxml>

Tidkod: We are using the exportCode added to the different absence types. If no exportCode is added we are using the following mapping for the value in the PAXml-format:

"vacation" = SEM (semester)

"sickChild" = VAB (sjukt barn)

"sickLeave" = SJK (sjuk)

"selfCertification" = SJK_KAR (karensdag)

"partentalLeave" = FPE (Föräldraledig)

"paidTimeOff" = KOM (Kompledig)

"unpaidTimeOff" = PEM (Permission)