Transcript PAXml xml fil format

PAXml 1.0
PAXml är ett standardformat för överföring av löneunderlag från ett försystem till ett
löneprogram. Förutom själva löneunderlaget kan även konteringsinformation, personuppgifter
och arbetstider enligt schema överföras. Överföring av lönedata kan ske enligt två olika
metoder. Antingen skickas en tid- eller lönekod som talar om för löneprogrammet vilken typ
av löneunderlag det är. Koderna är definierade i denna standard och det är upp till
löneprogrammet att fördela ut löneunderlaget på rätt lönearter beroende på t.ex.
personalkategori, kollektivavtal eller regler för sjukfrånvaro och semester. Med denna metod
behöver inte försystemet ha någon kunskap om hur lönen ska hanteras. För överföring av
löneunderlag som inte ryms inom denna standard eller där man vill att exporterande program
ska styra kan lönearten anges direkt i stället för kod.
Filnamn
Valfritt filnamn kan användas, filändelse .pax rekomenderas.
Schemafiler
Schemafiler för validering finns på följande plats:
http://www.paxml.se/1.0/paxml.xsd
Fält och attribut
*)
#)
Obligatorisk
Ej obligatorisk
Rotelementet <paxml>
Alla xml dokument skall omslutas av ett rotelement <paxml></paxml>.
Rotelementet i sig kan innehålla följande element.
Avsnitt
Avsnitt
Avsnitt
Avsnitt
Avsnitt
Avsnitt
Avsnitt
<header>
<dimensioner>
<resultatenheter>
<tidtransaktioner>
<lonetransaktioner>
<schematransaktioner>
<personal>
*) Allmän information om innehållet
#) Sätter namn på en dimension
#) Lista på resultatenheter per dimension
#) Närvaro- och frånvaroinformation
#) Löneunderlag övrigt
#) Arbetstidsschema
#) Personaluppgifter
Endast ett av varje element får förekomma i rotelementet.
Header
I varje fil måste det finnas ett Header-element.
Fält
<format>
Text
Fält
<version>
Text
Fält
<datum>
DatumTid
Fält
<foretagorgnr>
Text_12
Fält
<foretagnamn>
Text
Fält
<programnamn>
Text
Fält
<programlicens>
Text
*) "LÖNIN"
*) "1.0"
#) Exportdatum och klockslag
#) Organisationenummer företaget
#) Företagsnamn
#) Programnamn exportprogram
#) Licensnummer exportprogram
10-09-20 13:38
Dimensioner
Genom att exportera namnet på exporterade dimensioner blir det enklara att koppla en viss
dimension till rätt fält vid importen.
Avsnitt <dimensioner>
Fält
<dimension>
Attribut <dim>
Heltal 2
*) Dimensionsnummer 1-99
Attribut <namn>
Text
*) Namn på dimensionen
Exempel
<dimensioner>
<dimension dim="1" namn="Kostnadsställe"/>
<dimension dim="6" namn="Projekt"/>
</dimensioner>
Resultatenheter
För att uppdatera register över t.ex. projekt och kostnadsställe kan resultatenheter överföras.
Överföring av resultatenhet sker på ett viss dimensionsnummer mellan 1 och 99. För att
överföringen ska vara meningsfull krävs det att exporterande och importerande program är
överens om vad som exporteras på en viss dimension. Denna standard följer här samma
hantering som SIE där 1-19 är reserverade och fr.o.m. 20 fria. T.ex. skickas kostnadsställe /
resultatenhet på nivå 1 och projekt på nivå 6.
Avsnittet innehåller bara en fälttyp med resultatenhetens Dimension, Id och Namn
Avsnitt
Fält
Attribut
Attribut
Attribut
<resultatenheter>
<resultatenhet>
<dim>
Heltal 2
<id>
Text
<namn>
Text
*) Dimensionsnummer 1-99
* )Resultatenhet id eller nummer
*) Namn på resultatenheten
Exempel
<resultatenheter>
<resultatenhet dim="1" id="100" namn="Kostnadsställe 100"/>
<resultatenhet dim="1" id="110" namn="Kostnadsställe 110"/ >
<resultatenhet dim="6" id="100" namn="Projekt 100"/ >
</resultatenheter>
Tidtransaktioner
I tidtransaktioner ligger uppgifter om närvaro- och frånvarotid. Typen av tid styrs av tidkoden,
tidkoderna är definierade i denna standard och specificeras nedan. Det finns närvarokoder och
frånvarokoder. Närvaro ska alltid anges i timmar medan frånvaro kan anges i timmar eller
omfattning. Om omfattning anges krävs det att importerande program känner till rätt
schematid eller att schematiden finns angiven i avsnittet schematransaktioner. Det är upp till
det importerande programmet att föra över närvaro- och frånvarotiderna till rätt löneart och
med rätt belopp.
Avsnitt <tidtransaktioner>
Fält
<tidtrans>
En tidstransaktion
Attribut <postid>
Heltal
#) Unikt löpnummer för denna post
Attribut <anstid>
Text
1) Anställningsidentifikation/nummer
Attribut <persnr>
Text 12
1) Personnummer (ÅÅÅÅMMDDNNNN)
10-09-20 13:38
Fält
Fält
Fält
Fält
Fält
Fält
Fält
Fält
Fält
Avsnitt
*)
1)
2)
T)
A)
S)
<tidkod>
Text 10
<datum>
Datum
<datumfrom>
DatumTid
<datumtom>
DatumTid
<timmar>
Decimal
<omfattning>
Decimal
<samlingsid>
Text
<semgrund>
Boolean
<kontonr>
Text
<resenheter>
Fält
<resenhet>
Attribut <dim> Heltal 2
Attribut <id>
Text
*) Tidskod
2) Datum för enskild dag
2) Från och med datum-tid
2) Till och med datum-tid
T) Timmar för frånvaro eller närvaro
T) Omfattning % för frånvaro, kräver schema.
#) Samlingsid för t.ex. en reseräkning
S) Semestergrundande frånvaro
#) Kontonummer
#) Resultatenhet
*) Dimensionsnummer 1-99
* )Resultatenhet id eller nummer
Frånvarokod, Tidssaldo eller Närvarokod enligt specifikation nedan
Anställningsnummer eller personnummer måste finnas med.
Antingen datum eller datumintervall måste anges
Datumintervall får bara användas i kombination med omfattning, inte timmar.
Timmar eller omfattning ska anges, omfattning kräver schematid.
Omfattning får ej anges för lönekoder för närvaro och inte kombination med timmar.
Om omfattning och timmar utelämnas förutsätts 100% frånvaro enligt schema.
Får endast anges för löneart eller lönekod.
Ska normalt utelämnas så att importerande program bestämmer vad som är
semestergrundande.
Exempel
<tidtransaktioner>
<tidtrans anstid="101">
< tidkod >SJK</ tidkod >
<datumfrom>2008-06-02</datumfrom>
<datumtom>2008-06-05</datumtom>
<omfattning>100</omfattning>
</ tidtrans >
</tidtransaktioner >
Lönetransaktioner
I lönetransaktionerna ligger löneunderlag som inte behöver vara tid av en viss typ. Observera
att antingen löneart eller lönekod ska anges. Om båda uppgifterna finns med bör det
importerande programmet kontrollera att angiven löneart är inställd för angiven lönekod, om
kontrollen inte kan göras används lönearten. Många fält är valfria och om dom inte finns med
är det upp till importerande program att sätta rätt värden.
Avsnitt
Fält
Attribut
Attribut
Attribut
Fält
Fält
Fält
<lonetransaktioner>
<lonetrans>
<postid>
Heltal
<anstid>
Text
<persnr>
Text 12
<lonkod>
Text 10
<lonart>
Text
<benamning>
Text
En lönetransaktion
#) Unikt löpnummer för denna post
1) Anställningsidentifikation/nummer
1) Personnummer (ÅÅÅÅMMDDNNNN)
2) Lönekod enligt specifikation nedan
2) Löneart
#) Löneartsbenämning (ersätter ordinarie)
10-09-20 13:38
Fält
Fält
Fält
Fält
Fält
Fält
Fält
Fält
Fält
Fält
Avsnitt
1)
2)
3)
4)
<kommentar> Text
<datum>
Datum
<datumfrom>
DatumTid
<datumtom>
DatumTid
<antal>
Decimal
<apris>
Decimal
<belopp>
Decimal
<moms>
Decimal
<samlingsid>
Text
<kontonr>
Text
<resenheter>
Fält
<resenhet>
Attribut <dim> Heltal 2
Attribut <id>
Text
#) Extra textrad som hör ihop med lönearten
3) Datum för enskild dag
3) Från och med datum-tid
3) Till och med datum-tid
4) Antal (i löneartens enhet)
4) A-pris
4) Belopp (inkl ev. moms)
#) Momsbelopp (konteras på momskonto)
#) Samlingsid för t.ex. en reseräkning
#) Kontonummer
#) Resultatenhet
*) Dimensionsnummer 1-99
*) Resultatenhet id eller nummer
Anställningsnummer eller personnummer måste finnas med, om båda används görs
en kontroll
Lönekod eller löneart måste finnas med. Om båda anges används löneart.
Som lönekod används Närvarokod eller Övriga ersättningar enligt specifikation
nedan
Frivillig uppgift. Datum eller datumintervall anges, inte båda uppgifterna.
Antal, a'pris och belopp kan anges eller utelämnas. Det är upp till importerande
program att bestämma hur uppgifterna ska användas och fylla på med det som
saknas.
Exempel
<lonetransaktioner>
<lonetrans anstid="101">
<lonart>244</lonart>
<antal>8.4</antal>
<kontonr>6510</kontonr>
<resenheter>
<resenhet dim="1" id="12"/>
<resenhet dim="6" id="100"/ >
</resenheter>
</ lonetrans >
</ lonetransaktioner >
Arbetstidsschema
Om exporterande program är styrande för personens arbetstidsschema kan schematiden föras
över samtidigt som löneunderlaget. Om detta avsnitt utelämnas så är det importerande
program som håller reda på eventuell schematid.
Avsnitt
Fält
Attribut
Attribut
Fält
Attribut
Attribut
<schematransaktioner>
<schema>
<anstid>
Text
<persnr>
Text 12
<dag>
<datum>
Datum
<timmar>
Decimal
1) Anställningsidentifikation/nummer
1) Personnummer (ÅÅÅÅMMDDNNNN)
*) Datum
*) Schematid i timmar
10-09-20 13:38
1)
Anställningsnummer eller personnummer måste finnas med.
Exempel
<schematransaktioner>
<schema anstid="101">
<dag datum="2008-06-02" timmar="8"/>
<dag datum="2008-06-03" timmar="4.5"/>
<dag datum="2008-06-04" timmar="0"/>
</schema>
</ schematransaktioner >
Personaluppgifter
I samband med att lönedata exporteras eller som en egen export kan personaluppgifter
exporteras. Dom fält som är definierade är dom vanligaste personuppgifterna som namn,
adress och telefonnummer. Tanken är att ett exporterande program ska kunna rapportera t.ex.
ändrad adress till ett löneprogram.
Alla fält är valfria, utelämnad uppgift ska lämnas orört av importerande program om personen
redan finns upplagd. Importerande program behöver inte kunna importera alla fält om det inte
har något motsvarande fält internt.
Avsnitt
Fält
Attribut
Attribut
Fält
Fält
Fält
Fält
Fält
Fält
Fält
Fält
Fält
Fält
Fält
Fält
Fält
Fält
Fält
Fält
Attribut
Fält
Attribut
Fält
Attribut
<Personal>
<person>
<anstid>
<persnr>
<fornamn>
<efternamn>
<extraadress>
<postadress>
<postnr>
<ort>
<land>
<mobiltelefon>
<hemtelefon>
<arbetstelefon>
<bankclearing>
<bankkonto>
<anstdatum>
<avgdatum>
<lonform>
<timlon>
<datum>
<manlon>
<datum>
<sysgrad>
<datum>
1)
Anställningsnummer eller personnummer måste finnas med, om båda används görs
en kontroll
Text
Text 12
Text
Text
Text
Text
Text
Text
Text
Text
Text
Text
Text
Text
Datum
Datum
Text_3
Decimal
Datum
Decimal
Datum
Decimal
Datum
1) Anställningsidentifikation/nummer
1) Personnummer (ÅÅÅÅMMDDNNNN)
#) Förnamn
#) Efternamn
#) Extraadress, C/o adress
#) Postadress
#) Postnummer
#) Ort
#) Land
#) Mobiltelefon
#) Hemtelefon
#) Arbetstelefon
#) Bank clearingnummer
#) Bank kontonummer
#) Anställningsdatum
#) Avgångsdatum
#) Löneform 'TIM' / 'MÅN'
#) Timlön
#) Ändringsdatum för timlön
#) Månadslön
#) Ändringsdatum för månadslön
#) Sysselsättningsgrad %
#) Ändringsdatum för sysselsättningsgrad
10-09-20 13:38
Exempel
<personal>
<person anstid="51">
<fornamn>Siv</fornamn>
<efternamn>Ljunggren</efternamn>
<extraadress/>
<postadress> Föreningsgatan 33</postadress>
<postnr>447 34</postnr>
<ort>Vårgårda</ort>
<land>Sverige</land>
<mobiltelefon>070-996 96 96</mobiltelefon>
<arbetstelefon> 0322-21298</arbetstelefon>
<anstdatum>1995-01-01</anstdatum>
<manlon datum="2010-01-01">25000</manlon>
<sysgrad>100</sysgrad>
</person>
</personal>
Frånvaro (Endast tidkod)
Sjukdom
Sjukdom - Karensdag
Sjukdom - Sjuklön (Arbetsgivaren betalar)
Sjukdom - Sjukersättning (FK + 10% sjuklön)
Sjukdom - Sjukpenning (Försäkringskassan)
Arbetsskada
Havandeskapspenning
Föräldraledig
Vård av barn
Smittbärare
Utbildning (semestergrundande)
Militärtjänst (max 60 dagar)
Svenskundervisning för invandrare
Närståendevård
Tjänstledig
Semester
Semester - betald
Semester - sparad
Semester - obetald
Semester - förskott
Kompledig
Permission
Permitterad
Fackligt arbete
Arbetstidskonto
Kontaktdagar
Pappaledig
Frånvaro övrigt 1
Frånvaro övrigt 2
Frånvaro övrigt 3
Frånvaro övrigt 4
SJK
SJK_KAR
SJK_LÖN
SJK_ERS
SJK_PEN
ASK
HAV
FPE
VAB
SMB
UTB
MIL
SVE
NÄR
TJL
SEM
SEM_BET
SEM_SPA
SEM_OBE
SEM_FÖR
KOM
PEM
PER
FAC
ATK
KON
PAP
FR1
FR2
FR3
FR4
10-09-20 13:38
Frånvaro övrigt 5
Frånvaro övrigt 6
Frånvaro övrigt 7
Frånvaro övrigt 8
Frånvaro övrigt 9
FR5
FR6
FR7
FR8
FR9
Tidssaldon (endast tidkod)
Flextid +/Tidssaldo 1
Tidssaldo 2
Tidssaldo 3
Tidssaldo 4
Tidssaldo 5
Tidssaldo 6
Tidssaldo 7
Tidssaldo 8
Tidssaldo 9
FLX
TS1
TS2
TS3
TS4
TS5
TS6
TS7
TS8
TS9
Närvaro/tillägg (tidkod eller lönekod)
Arbetstid (arbetstid inom schematid)
Timlön (arbetstid utanför schema/timanställd)
Mertid
Övertid 1 - Betalning
Övertid 2 - Betalning
Övertid 3 - Betalning
Övertid 4 - Betalning
Övertid 5 - Betalning
Övertid 1 - Komptid
Övertid 2 - Komptid
Övertid 3 - Komptid
Övertid 4 - Komptid
Övertid 5 - Komptid
OB-ersättning 1
OB-ersättning 2
OB-ersättning 3
OB-ersättning 4
OB-ersättning 5
Jourtid 1
Jourtid 2
Jourtid 3
Beredskapstid 1
Beredskapstid 2
Beredskapstid 3
Restid 1
Restid 2
Restid 3
Helglön
Skifttillägg
TID
ARB
MER
ÖT1
ÖT2
ÖT3
ÖT4
ÖT5
ÖK1
ÖK2
ÖK3
ÖK4
ÖK5
OB1
OB2
OB3
OB4
OB5
JR1
JR2
JR3
BE1
BE2
BE3
RE1
RE2
RE3
HLG
SKI
10-09-20 13:38
Övriga ersättningar (endast lönekod)
Månadslön
Timlön
Bonus
Provision
Förskott
Utlägg
Reskostnadsersättning
Inrikes traktamente - skattefri
Inrikes traktamente - skattepliktig
Inrikes helt traktamente - skattefri
Inrikes helt traktamente - skattepliktig
Inrikes halvt traktamente - skattefri
Inrikes halvt traktamente - skattepliktig
Inrikes endagstraktamente - skattepliktigt
Inrikes nattraktamente - skattefri
Inrikes nattraktamente - skattepliktig
Utrikes traktamente - skattefri
Utrikes traktamente - skattepliktig
Utrikes helt traktamente - skattefri
Utrikes helt traktamente - skattepliktig
Utrikes halvt traktamente - skattefri
Utrikes halvt traktamente - skattepliktig
Utrikes endagstraktamente - skattepliktigt
Utrikes nattraktamente - skattefri
Utrikes nattraktamente - skattepliktig
Milersättning - skattefri
Milersättning - skattepliktig
Milersättning privatbil - skattefri
Milersättning privatbil - skattepliktig
Milersättning tjänstebil - skattefri
Milersättning tjänstebil - skattepliktig
Milersättning tjänstebil diesel - skattefri
Milersättning tjänstebil diesel - skattepliktig
Kostförmån
Kostförmån frukost
Kostförmån lunch
Kostförmån middag
Kostförmån frukost utrikes
Kostförmån lunch utrikes
Kostförmån middag utrikes
Måltidsreduktion
Måltidsreduktion frukost
Måltidsreduktion lunch
Måltidsreduktion middag
Måltidsreduktion frukost utrikes
Måltidsreduktion lunch utrikes
Måltidsreduktion middag utrikes
MÅNLÖN
TIMLÖN
BONUS
PROVISION
FÖRSKOTT
UTLÄGG
RESERS
INR_FRI
INR_SKT
INRHEL_FRI
INRHEL_SKT
INRHLV_FRI
INRHLV_SKT
INRDAG_SKT
INRNAT_FRI
INRNAT_SKT
UTR_FRI
UTR_SKT
UTRHEL_FRI
UTRHEL_SKT
UTRHLV_FRI
UTRHLV_SKT
UTRDAG_SKT
UTRNAT_FRI
UTRNAT_SKT
MIL_FRI
MIL_SKT
MILPRI_FRI
MILPRI_SKT
MILFTG_FRI
MILFTG_SKT
MILDIS_FRI
MILDIS_SKT
MATFRM
MATFRM_FRU
MATFRM_LCH
MATFRM_MID
UTRFRM_FRU
UTRFRM_LCH
UTRFRM_MID
MATRED
MATRED_FRU
MATRED_LCH
MATRED_MID
UTRRED_FRU
UTRRED_LCH
UTRRED_MID
10-09-20 13:38