Hogia HR IPA format 2011-01-21 Import löneberedning Innehållsförteckning Allmänt... 2 Förteckning över löneprogram och användbara filformat:... 2 Filnamn... 2 Viktigt om Lönearter (L) och avvikelsearter (A)... 3 XML-format (HogiaLön Plus)... 4 XML-schema... 4 Exempel... 4 WLI-format... 6 Förkortningar:... 6 Posttyp 214006... 6 Exempel på rader... 9 Posttyp 214005 (äldre format med begränsningar)... 10 Posttyp 214004 (äldre format med begränsningar)... 13 Posttyp 214003 (äldre format med begränsningar)... 14 Posttyp 214002 (äldre format med begränsningar)... 15 Posttyp 214001 (äldre format med begränsningar)... 16 Informationsposter wli-filer:... 17 Välja importfil i HogiaLön Plus.... 18
Hogia HR IPA 2011-01-21 2 (18) Allmänt Import - löneberedning är en funktion som möjliggör inläsning av underlag till löneberedningen från tidssystem, reseräkningsprogram och liknande. Det finns XML-format samt 6 stycken textfilsformat av typen med fasta positioner. Förteckning över löneprogram och användbara filformat: Program HogiaLön Plus HogiaLön Classic Hogia Lön Finsk Lön (f d WindowsLön +) Format XML X X ¹ 214001 X X X X 214002 X X X X 214003 X X X X 214004 X X 214005 X X 214006 X X ¹Beskrivs inte i detta dokument Filnamn XML-filer skall ha efternamnet.xml Övriga skall ha efternamnet.wli (Filnamn som inleds med ETIP accepteras t v också. Gäller endast formaten 214001 och 214002) Automatisk import i HogiaLön Plus. Om automatisk import används i HogiaLön Plus skall filnamnet inledas med tecken som anges under Arkiv / Inställningar / Import. Om den unika identifikationen anges till 515151 skall filnamnet inledas med 515151_. Exempel: 515151_oktober.xml 515151_oktober.wli
Hogia HR IPA 2011-01-21 3 (18) Viktigt om Lönearter (L) och avvikelsearter (A) I xml-filer samt i posttyperna 214005 och 214006 skall anges L för löneart och A för avvikelseart. Vad är då en avvikelseart? En avvikelseart förses i lönesystemet med regler och genererar utifrån dessa en eller flera lönearter. Ett exempel på detta är avvikelsearten Sjukdom som genererar lönearterna karensdag, sjukavdrag, sjuklön o s v. För att en avvikelseart skall kunna generera lönearter krävs att aktuell person har ett gällande arbetsschema i lönesystemet samt att exporterande program skickar datum fr o m t o m. Om händelsen inte avser hela startdagen eller hela slutdagen skall även klockslag anges. Det är ej relevant att ha timmar(antal) eller belopp på en avvikelseart. För att kunna använda avvikelsearter i HogiaLön Classic krävs tillägget Kalendarium. (Kalendarium ingår som standard i HogiaLön Plus) Vissa tidssystem har ej möjlighet att exportera klockslag. Om så är fallet föreslås att istället rapportera del av dag med hjälp av fältet Omfattning(Extent i xml-fil). Det är då viktigt att lönearter och avvikelsearter anpassas för detta. HogiaLön Plus/ HogiaLön Classic är inte utvecklat för dag-för-dag-rapportering. Händelser t ex sammanhängande sjukfrånvaro skall i möjligaste mån rapporteras med en transaktion där fr o m datum avser första dag och t o m datum avser sista dag. Om exporterande program i stället vill skicka timmar (timmar för timlön, övertid etc) eller belopp skall löneart(l) användas. Lönearter (L): Observera att i fälten Antal, A-pris och Belopp i wli-format är första positionen teckenposition som skall vara blank eller -. Vid utelämnat värde anges 0 även i teckenpositionen. Om raden innehåller Antal och A-pris kommer Belopp att beräknas oavsett om ett Belopp skilt från 0 finns på raden. Om Belopp skall importeras måste A-pris vara 0. Observera också att prissättning kan ske vid import(valbart) om aktuell löneart har en formel för A-pris. Om ett belopp i filen avser avdrag på lönen skall beloppet anges med minustecken.
Hogia HR IPA 2011-01-21 4 (18) XML-format (HogiaLön Plus) Viktigt! För att förstå skillnaden mellan lönearter (L) och avvikelsearter (A) rekommenderar vi att du läser om detta på sidan 3. XML-schema XML-formatet definieras i schema-filen Hogia_Payroll.xsd Teckenrepresentation Windows standard ISO 8859-1 (ISO Latin 1) Exempel Här följer ett exempel på hur innehållet i en XML-fil kan se ut: <?xml version="1.0" encoding="iso-8859-1"?> <PayRoll xmlns="http://www.hogia.se/xmlschemas/pa" xmlns:xsi="http://www.w3.org/2001/xmlschema-instance"> <FileInfo> <companyname>hogia Test AB</companyName> <softwareproduct></softwareproduct> <createdby></createdby> <createddate>2007-08-13</createddate> <message>meddelande 1</message> </FileInfo> <PayTypeInstruction> <employmentid>101</employmentid> <paytypecode>l</paytypecode> <paytypeid>10</paytypeid> <quantity>83.5</quantity> <project>projekt1</project> <note>meddelande</note> </PayTypeInstruction> <PayTypeInstruction> <employmentid>101</employmentid> <paytypecode>l</paytypecode> <paytypeid>210</paytypeid> <quantity>8.5</quantity> <periodstartdate>2007-08-10</periodstartdate> <periodenddate>2007-08-10</periodenddate> <costcentre>1234</costcentre> <project>33</project> </PayTypeInstruction> <PayTypeInstruction> <employmentid>102</employmentid> <paytypecode>l</paytypecode>
Hogia HR IPA 2011-01-21 5 (18) <paytypeid>10</paytypeid> <quantity>33</quantity> </PayTypeInstruction> <PayTypeInstruction> <employmentid>102</employmentid> <paytypecode>a</paytypecode> <paytypeid>600</paytypeid> <periodstartdate>2007-07-11</periodstartdate> <periodstarttime>13:00:00</periodstarttime> <periodenddate>2007-07-18</periodenddate> <periodendtime>17:00:00</periodendtime> <extent>100</extent> </PayTypeInstruction> <PayTypeInstruction> <employmentid>103</employmentid> <paytypecode>a</paytypecode> <paytypeid>374</paytypeid> <periodstartdate>2007-07-11</periodstartdate> <periodenddate>2007-07-18</periodenddate> <childname>021115-0123</childname> </PayTypeInstruction> <PayTypeInstruction> <employmentid>104</employmentid> <paytypecode>a</paytypecode> <paytypeid>375</paytypeid> <periodstartdate>2007-07-21</periodstartdate> <periodenddate>2007-07-25</periodenddate> <childname>vera</childname> </PayTypeInstruction> <PayTypeInstruction> <employmentid>201</employmentid> <paytypecode>l</paytypecode> <paytypeid>15</paytypeid> <quantity>66.00</quantity> <costunit>p66</costunit> </PayTypeInstruction> <PayTypeInstruction> <personalidentitynumber>7909029980</personalidentitynumber> <paytypecode>l</paytypecode> <paytypeid>832</paytypeid> <amount>932.00</amount> <periodstartdate>2007-08-13</periodstartdate> <periodenddate>2007-08-13</periodenddate> <costcentre>lk100</costcentre> </PayTypeInstruction> <PayTypeInstruction> <employmentid>222</employmentid> <paytypecode>l</paytypecode> <paytypeid>10</paytypeid> <quantity>3.14</quantity> <price>158</price> <costcentre>777</costcentre> <project>eriksdal</project> </PayTypeInstruction> </PayRoll>
Hogia HR IPA 2011-01-21 6 (18) WLI-format Filerna är en sekventiella ASCII-filer som inleds med en post med sex nollor(000000) och avslutas med en post med sex nior(999999). Alla poster avslutas med [CR]+[LF] Teckenrepresentation: Windows standard ISO 8859-1 (ISO Latin 1) Förkortningar: U - kan utelämnas, importeras ej. N - numeriskt Utelämnat värde markeras med nollutfyllnad i hela fältet AN - alfanumeriskt, vänsterställt Utelämnat värde = blankt i hela fältet Posttyp 214006 Start Slut Längd Innehåll Postidentifierare 1 6 6 '214006' Anställningsnummer 7 17 11 N,00000000001-99999999999 Avvikelse / Löneart 18 18 1 AN L = Löneart A = Avvikelseart Övrigt = Avvikelseart Avvikelse- / löneartsnummer 19 21 3 N,001-999 Antal 22 31 10 N,U, Antal*100, max 6 siffror A-pris 32 41 10 N,U, A-pris*100(ören), max 6 siffror Belopp 42 58 17 N,U Ex. 0000000000678000-0000000000678000 0000000 Belopp*100(ören),max 8 siffror Fr o m datum 59 66 8 N,U, formatet är YYYYMMDD Ex. 20000517
Hogia HR IPA 2011-01-21 7 (18) Fr o m kl 1 67 71 5 N,U, formatet är HH:MM Ex. 17:10 T o m datum 72 79 8 N,U, formatet är YYYYMMDD Ex. 20000517 T o m kl 1 80 84 5 N,U, formatet är HH:MM Ex. 21:45 Fr o m datum avvikelse 1,2 85 92 8 N,U, formatet är YYYYMMDD Ex. 20000517 T o m datum avvikelse 1,2 93 100 8 N,U, formatet är YYYYMMDD Ex. 20000517 Om så önskas t ex vid frånvaro. Källa 101 103 3 N,U, 001-999. Se kommentar nedan Attesterad 104 105 2 N, U, 00-01. 01 = Attesterad Behandlad 106 106 1 0. Används av HogiaLön32 Resultatenhet 107 126 20 AN Projekt 127 146 20 AN Konto 147 158 12 AN Kostnadsbärare 159 178 20 AN Omfattning 179 184 6 N,U, i procent med 2 decimaler. Max 100%, decimalåtskiljare =. eller, Utelämnad uppgift = 100% Anmärkning 185 - - AN, valfri längd, max 66 tecken 1 = Denna uppgift ignoreras om posten är en löneart 2 = För att korrekt hantera t.ex. tjänstledighet, föräldraledighet, vård av närstående etc där ersättningen skiljer sig beroende på hela periodens längd måste avvikelseperiod anges i posten. Om man har en avvikelseperiod som sträcker sig över flera ersättningsperioder kan man också välja att ange hela avvikelsens period i positionerna för Fr o m datum avvikelse samt T o m datum avvikelse. Dessa uppgifter kan utelämnas vilket då leder till att HogiaLön kommer sätta Fr o m datum avvikelse = Fr o m datum samt T o m datum avvikelse = T o m datum Minsta postlängd = 184 bytes, största postlängd = 250 bytes Källa Om Källa används skall det finnas informationsposter som kopplar de nummer som används till namnet på källan. Ex: ;Källa001= PA-intranet
Hogia HR IPA 2011-01-21 8 (18) ;Källa002= Reseräkningar
Hogia HR IPA 2011-01-21 9 (18) Exempel på rader En löneartsrad (observera att nedanstående är en rad i importfilen): 21400600000000013L200 000006025 000002000 0000012050000000200112270000020011228000000000000000000000001010 Projekt 1 100.00Anmärkning Kommentar: Anställningsnummer 13, löneart 200 med Antal = 60.25, á-pris=20.00, belopp = 1205.00 En avvikelserad (observera att nedanstående är en rad i importfilen): 21400600000000013A600000000000000000000000
Hogia HR IPA 2011-01-21 10 (18) Posttyp 214005 (äldre format med begränsningar) Start Slut Längd Innehåll Postidentifierare 1 6 6 '214005' Anställningsnummer 7 17 11 N,00000000001-99999999999 Avvikelse / Löneart 18 18 1 AN L = Löneart A = Avvikelseart Övrigt = Avvikelseart Avvikelse- / löneartsnummer 19 21 3 N,001-999 Antal 22 31 10 N,U, Antal*100, max 6 siffror A-pris 32 41 10 N,U, A-pris*100(ören), max 6 siffror Belopp 42 58 17 N,U Ex. 0000000000678000-0000000000678000 Belopp*100(ören),max 8 siffror Fr o m datum 59 66 8 N,U, formatet är YYYYMMDD Ex. 20000517 Fr o m kl 1 67 71 5 N,U, formatet är HH:MM Ex. 17:10 T o m datum 72 79 8 N,U, formatet är YYYYMMDD Ex. 20000517 T o m kl 1 80 84 5 N,U, formatet är HH:MM Ex. 21:45 Fr o m datum avvikelse 1,2 85 92 8 N,U, formatet är YYYYMMDD Ex. 20000517 T o m datum avvikelse 1,2 93 100 8 N,U, formatet är YYYYMMDD Ex. 20000517 Om så önskas t ex vid frånvaro. Källa 101 103 3 N,U, 001-999. Se kommentar nedan Attesterad 104 105 2 N, U, 00-01. 01 = Attesterad Behandlad 106 106 1 0. Används av HogiaLön Resultatenhet 107 126 20 AN Projekt 127 146 20 AN Konto 147 158 12 AN Kostnadsbärare 159 178 20 AN Anmärkning 179 - - AN, valfri längd, max 66 tecken
Hogia HR IPA 2011-01-21 11 (18) 1 = Denna uppgift ignoreras om posten är en löneart 2 = För att korrekt hantera t.ex. tjänstledighet, föräldraledighet, vård av närstående etc där ersättningen skiljer sig beroende på hela periodens längd måste avvikelseperiod anges i posten. Om man har en avvikelseperiod som sträcker sig över flera ersättningsperioder kan man också välja att ange hela avvikelsens period i positionerna för Fr o m datum avvikelse samt T o m datum avvikelse. Exempel: Tjänstledighet över månadsskifte Avvikelseart 620 används för tjänstledighet och genererar löneart 620 vid tjänstledighet mindre än 6 dagar eller löneart 621 vid tjänstledighet mer än 5 dagar. Personen är exvis tjänstledig 20070328 20070410 och löneperiod är hel månad. Tjänstledigheten kommer då att registreras i 2 perioder 20070328-20070331 och 20070401-20070410. För att applikationen skall använda löneart 621 istället för 620 så behövs information om hela tjänstledighetsperioden. Dessa uppgifter kan utelämnas vilket då leder till att HogiaLön kommer att sätta Fr o m datum avvikelse = Fr o m datum samt T o m datum avvikelse = T o m datum Minsta postlängd = 178 bytes, största postlängd = 244 bytes Förkortningar: U - kan utelämnas, importeras ej. Utelämnat värde markeras med nollutfyllnad i hela fältet N - numeriskt AN alfanumeriskt, vänsterställt Posttyp 214005 ger möjlighet att även importera Avvikelser/lönearter, Konto 12 tecken AN.
Hogia HR IPA 2011-01-21 12 (18) 00000000000000002001122713:002001122817:100000000000000000001010 Projekt 2 Konto 075.00Sjuk! Kommentar: Anställningsnummer 13, avvikelseart 600, 2001-12-27 13:00 2001-12-28 17:10, omfattning 75% Anställningsnummer kan ersättas av personnummer (ej bindestreck)
Hogia HR IPA 2011-01-21 13 (18) Posttyp 214004 (äldre format med begränsningar) Start Slut Längd Innehåll Postidentifierare 1 6 6 '214004' Anställningsnummer 7 16 10 N,0000000001-9999999999 Löneartsnummer 17 19 3 N,001-999 Antal 20 29 10 N,U, Antal*100, max 6 siffror A-pris 30 39 10 N,U, A-pris*100(ören), max 6 siffror Belopp 40 56 17 N,U Ex. 0000000000678000-0000000000678000 0000000 Belopp*100(ören),max 8 siffror Fr o m datum 57 62 6 N,U Ex. 960510 T o m datum 63 68 6 N,U Ex. 960510 Om så önskas t ex vid frånvaro Resultatenhet 69 88 20 AN Projekt 89 108 20 AN Konto 109 115 7 AN Kostnadsbärare 116 135 20 AN Anmärkning 136 - - AN, valfri längd, max 66 tecken Förkortningar: U - kan utelämnas, importeras ej. Utelämnat värde markeras med nollutfyllnad i hela fältet N - numeriskt AN alfanumeriskt, vänsterställt
Hogia HR IPA 2011-01-21 14 (18) Posttyp 214003 (äldre format med begränsningar) Start Slut Lgd Innehåll Postidentifierare 1 6 6 '214003' Anställningsnummer 7 16 10 N,0000000001-9999999999 Löneartsnummer 17 19 3 N,001-999 Resultatenhet 20 29 10 AN,U Projekt 30 43 14 AN,U Antal 44 53 10 N,U, Antal*100, max 9 siffror A-pris 54 63 10 N,U, A-pris*100(ören), max 9 siffror Belopp 64 80 17 N,U Ex. 0000000000678000-0000000000678000 0000000 Belopp*100(ören),max 11 siffror Fr o m datum 81 86 6 N,U Ex. 040510 T o m datum 87 92 6 N,U Ex. 040510 Anmärkning 93 - - AN, valfri längd, max 66 tecken Förkortningar: U - kan utelämnas Utelämnat värde markeras med nollutfyllnad i hela fältet N - numeriskt AN alfanumeriskt I formatet 214003 kan startpost med sex nollor(000000) utelämnas.
Hogia HR IPA 2011-01-21 15 (18) Posttyp 214002 (äldre format med begränsningar) Start Slut Lgd Innehåll Postidentifierare 1 6 6 '214002' Anställningsnummer 7 16 10 N,0000000001-9999999999 Löneartsnummer 17 19 3 N,001-999 Resultatenhet 20 25 6 N,U,000001-999999 Projekt 26 31 6 N,U,000001-999999 Anmärkning 32 37 6 AN,U Antal 38 47 10 N,U, Antal*100, max 6 siffror A-pris 48 57 10 N,U, A-pris*100(ören), max 6 siffror Belopp 58 74 17 N,U Ex. 0000000000678000-0000000000678000 0000000 Belopp*100(ören),max 8 siffror Fr o m datum 75 80 6 N,U Ex. 960510 T o m datum 81 86 6 N,U Ex. 960510 Om så önskas t ex vid frånvaro Förkortningar: U - kan utelämnas Utelämnat värde markeras med nollutfyllnad i hela fältet N - numeriskt AN alfanumeriskt
Hogia HR IPA 2011-01-21 16 (18) Posttyp 214001 (äldre format med begränsningar) Start Slut Längd Innehåll Postidentifierare 1 6 6 '214001' Anställningsnummer 7 16 10 N,0000000001-9999999999 Löneartsnummer 17 19 3 N,001-999 Resultatenhet 20 25 6 N,U,000001-999999 Projekt 26 31 6 N,U,000001-999999 Anmärkning 32 37 6 AN,U Antal 38 47 10 N,U, Antal*100, max 6 siffror A-pris 48 57 10 N,U, A-pris*100(ören), max 6 siffror Belopp 58 74 17 N,U Ex. 0000000000678000-0000000000678000 0000000 Belopp*100(ören),max 8 siffror Förkortningar: U - kan utelämnas, importeras ej. Utelämnat värde markeras med nollutfyllnad i hela fältet N - numeriskt AN alfanumeriskt Exempel: 000000 ; Kommentar 2140010000000201510000000000000 000000200000000000000000000000000000 99999
Hogia HR IPA 2011-01-21 17 (18) Informationsposter wli-filer: Info-poster får förekomma direkt efter startposten. Dessa används för att underlätta val av importfil. Infoposter skall ha semikolon(;) i pos 1. Följande typer finns: ;Innehåll= Ex: ;Innehåll= Reseräkningar för Karin Bengtsson 020501-020531 ;Företag= ;Företag= Hogia Lön AB ;Orgnr= ;Orgnr= 556677-1122 ;Källa ;Källa001= PA-intranet (används av 214005/214006, se dessa format) Om info-post med org-nr finns visas endast de filer som har rätt org-nr i dialogrutan för val av importfil.
Hogia HR IPA 2011-01-21 18 (18) Välja importfil i HogiaLön Plus. I dialogen i HogiaLön Plus visas.wli-filer samt.xml-filer om de följer xml-schemat Hogia_Payroll.xsd. Under <FileInfo> finns elementet <corporateidentity>. Detta är avsett för företagets organisationsnummer. Om <corporateidentity> finns med visas filen endast om organisationsnumret överensstämmer med det organisationsnummer som finns i databasen. (Motsvarande funktionalitet finns för.wli-filer, se sidan 12).