Filformat för fil som används vid import
Här beskriver vi format för fil som används vid import av tidsredovisningar eller utläggsregistreringar från annat program till Visma Lön 600.
1 Översikt
För att underlätta löneberedningen, och slippa dubbelarbete, kan du importera information från Resor & Utlägg, Tid eller ett annat system till Visma Lön 600. Information som kan läsas in är arbetad tid, olika typer av frånvaro samt utlägg den anställde har haft.
I avsnittet Importera utläggsregistreringar eller tidsredovisningar kan du läsa om importen.
2 Filformat
Filen som läses in är en XML-fil med innehåll enligt nedan. Namnet på filen är valfritt men den ska ha ändelsen .tlu.
XML-filen lagras i formatet ISO-8859-1 vilket anger vilken standard för teckenkodning som används. Filen ska sparas i detta format för att kunna tolkas av programmet.
Beroende på i vilket program man väljer att redigera filen har detta format olika benämningar:
- Sparas den i Notepad anges formatet ANSI.
- Sparas den i MS Visual Studio sparas den med kodning Western Eauropean (ISO) Codepage 28591.
Vissa attribut är obligatoriska uppgifter vid importen till Visma Lön 600 och måste finnas med i filen, de är nedan markerad som obligatorisk.
Det finns en del attribut som skickas med vid exporten från Tid, men som inte används av Visma Lön 600 idag. De behöver inte anges i filen och är i dokumentationen nedan markerade som används ej.
2.1 Förklaringar till begrepp i tabellen
| Begrepp | Förklaring |
|---|---|
| Text | Typen på information som ligger i attributet. |
| Datum | Ett datum i ISO-format, dvs ÅÅÅÅ-MM-DD. |
| Num | Numeriskt värde. Beroende på attributet kan det ha decimaler med decimalpunkt. Om inget annat anges så är tillåtna värden -999999.99 till -999999.99, med reservation för vad som är rimligt på grund av sammanhanget. |
| Element | Ett element i XML avser ett stycke/avsnitt med en viss betydelse. Kallas även för HTML-tag. |
| Attribut | En egenskap för ett element/tag. |
2.2 Element i filen
Följande element kan finnas i filen:
<xml>
<SalaryData>
<TimeCodes>
<TimeCode ... >
</TimeCode>
</TimeCodes>
<RegOutlayCodes>
<RegOutlayCode...>
</RegOutlayCode>
</RegOutlayCodes>
<Projects>
<Project ..>
</Project>
</Projects>
<ResultUnits>
<ResultUnit..>
</ResultUnit>
</ResultUnits>
<SalaryDataEmployee..>
<Employee..>
<NormalWorkingTimes>
<NormalWorkingTime ..>
</NormalWorkingTime>
</NormalWorkingTimes>
<Times>
<Time ..>
</Time>
</Times>
<TimeAdjustments>
<TimeAdjustment ..>
</TimeAdjustment>
</TimeAdjustments>
<TimeBalances>
</TimeBalances>
<BookDistributionProjects>
<BookDistributionProject..>
</BookDistributionProject>
</BookDistributionProjects>
<BookDistributionResultUnits>
<BookDistributionResultUnit..>
</BookDistributionResultUnit>
</BookDistributionResultUnits>
<RegOutlays>
<RegOutlay..>
</RegOutlay>
</RegOutlays>
</Employee>
</SalaryDataEmployee>
</SalaryData>
De element som är markerade med kursiv stil är inte obligatoriska.
2.2.1 XML
Elementet är obligatoriskt. Det ska ligga överst i filen och utan någon indragning. Påbörjas och avslutas med ?.
Exempel:
<?xml version="1.0" encoding="ISO-8859-1"?>
| Attribut | Typ | Längd | Tillåtna värden | Oblig | Kommentar |
|---|---|---|---|---|---|
| xml version | Text | Ska se ut exakt som i exemplet ovan | 1.0 | Ja | Ska se ut exakt som i exemplet ovan |
| encoding | Text | Ska se ut exakt som i exemplet ovan | ISO-8859-1 | Ja | Anger vilken standard för teckenkodning som används. XML-filen ska sparas i detta format för att kunna tolkas av programmet, beroende på i vilket program man väljer att redigera filen har detta format olika benämningar. Notepad: ANSI MS Visual Studio: Western Eauropean (ISO) Codepage 28591 |
2.2.2 SalaryData
Anger information om det exporterande programmet och vilket företag uppgifterna gäller för.
Elementet är obligatoriskt.
Elementet SalaryData startar och avslutar XML-filen.
Exempel:
<SalaryData ProgramName='Visma Tid' Version='2.41 20XX-01-10' ExportVersion='1.3' Created='20XY-01-12' Type='SalaryData' Language='Swedish' CompanyName='Testbolaget' OrgNo='555555-5555' Imported='0' BookDistributionProject='1' BookDistributionResultUnit='1'>
Exempel med minsta antal obligatoriska fält:
<SalaryData> om filen ska innehålla fördelning på projekt/resultatenhet
<SalaryData BookDistributionProject='1' BookDistributionResultUnit='1'>
Här kan version = 1.2 behöva anges annars förutsätter Lön version1,0 som inte har fördelning.
| Attribut | Typ | Längd | Tillåtna värden | Oblig | Kommentar |
|---|---|---|---|---|---|
| ProgramName | Text | Obegränsat | Alla värden | Nej | Namn på exporterande program. Namnet kommer att synas vid importen i Visma Lön 600. |
| Version | Text | Obegränsat | Alla värden | Nej | Version av systemet. |
| ExportVersion | Text | Obegränsat | Alla värden | Nej | Version av filformatet. Se avsnitt Versionshantering. Om attributet utelämnas eller om värdet är 1.0 används inte de övriga fälten/attributen. |
| Created | Text | 10 | Ett datum i ISO-format, dvs ÅÅÅÅ-MM-DD | Nej | Datum då filen exporterades. |
| Type | Text | Obegränsat | Alla värden | Nej | Anger vad det är för typ av XML-fil. Vårt förslag är SalaryData. |
| Language | Text | Obegränsat | Alla värden | Nej | Språkversion på exporterande program t ex Swedish. |
| CompanyName | Text | Obegränsat | Alla värden | Nej | Namnet på företaget som filen gäller för. Ska överensstämma med företagsnamnet i lön. Överensstämmer inte namnen kommer en varning vid importen, men XML-filen läses ändå in. |
| OrgNo | Text | 11 | Numeriskt | Nej | Företagets organisationsnummer som filen gäller för. Om angivet måste det stämma överrens med organisationsnumret i lön annars går inte importen igenom. T ex: 555555-5555 Saknas organisationsattributet helt i filen får användaren info om detta vid importen men XML-filen läses ändå in. |
| Imported | Num | 1 | 0 eller 1 | Nej Används ej | Sätts till 0 av exporterande program. I Visma Lön 600 ändras aldrig detta värde idag. I Visma Lön 600 tolkas allting annat än 1 som 0. |
| BookDistributionProject | Num | 1 | 0 eller 1 | Ja, om projekt exporteras i filen. | Anger om filen innehåller fördelning på projekt eller inte. |
| BookDistributionResultUnit | Num | 1 | 0 eller 1 | Ja, om resultatenhet exporteras i filen. | Anger om filen innehåller fördelning på resultatenhet eller inte. |
2.2.3 TimeCodes
Anger de tidkoder som tidssystemet kan använda sig av i XML filen. Läs mer under TimeCode.
Elementet är obligatoriskt.
2.2.4 TimeCode
Anger information per tidkod som tidssystemet kan använda sig av i XML filen.
Elementet är obligatoriskt.
Exempel:
<TimeCodes>
<TimeCode Code='010' TimeCodeName='Normal'/>
</TimeCodes>
Exempel med minsta antal obligatoriska fält:
Samma som ovan.
Alla dessa koder måste ha en koppling till en löneart alternativt snabbval i Visma Lön 600. Ett snabbval är att föredra att koppla till i Visma Lön 600. I ett snabbval för t ex sjuk håller programmet reda på regler som återinsjuknade, 10 karensavdrag på en rullande 12-månadersperiod och vilka lönearter som ska genereras vid dag 1, dag 2-14 o s v. Detta innebär att färre kopplingar måste göras eftersom snabbvalet genererar korrekt lönearter och dessutom innehåller intelligens gällande regler för avvikelsen.
Detta görs under Arkiv - Inställningar - Företagsinställningar - Integrationer och Tidkoder eller Utläggskoder. Skulle det saknas en koppling för en kod i Visma Lön 600 ges meddelande i samband med importen och detta måste åtgärdas innan XML-filen kan läsas in. Koden läggs upp automatiskt i kopplingsschemat.
| Attribut | Typ | Längd | Tillåtna värden | Oblig | Kommentar |
|---|---|---|---|---|---|
| Code | Text | 1-10 | Text och numeriskt | Ja | Kodens kod i systemet. |
| TimeCodeName | Text | 1-50 | Text och numeriskt | Ja | Tidkodens namn i systemet. |
| AbsenceType | Num | 0 = arbetad tid, 1 = frånvaro, 991 = flex, 992 = komptid i pengar |
Nej Används ej | Frånvarotyp | |
| RegularworkingTime | Num | 1 | 1 = ordinarie arbetstid 0 = annat |
Nej Används ej | Attributet är till för att ange ifall tidkoden gäller för ordinarie arbetstid (t ex månadslön eller timlön). |
| ConversionFactorTime | Num | Nej Används ej | Omräkningsfaktor för komptid. | ||
| Active | Num | 1 | Nej Används ej | Är tidkoden aktiv eller inte i tidssystemet. |
2.2.5 RegOutlayCodes
Anger de utläggskoder som systemet kan använda sig av i XML filen. Läs mer under RegOutlayCode.
Elementet är inte obligatoriskt.
2.2.6 RegOutlayCode
Anger information per utläggskod som systemet kan använda sig av i XML filen.
Elementet är inte obligatoriskt.
Exempel:
<RegOutlayCodes>
<RegOutlayCode Code=’010’ RegOutlayCodeName=’Logi’/>
</RegOutlayCodes>
Exempel med minsta antal obligatoriska fält:
Samma som ovan.
I Visma Lön 600 uppdateras utläggsregister utifrån de utläggskoder som finns i filen vid importen. Om nya utläggskoder har lagts till ska de kopplas till en löneart i Visma Lön 600. Läs mer i avsnittet Utläggskoder.
|
Attribut |
Typ |
Längd |
Tillåtna värden |
Oblig |
Kommentar |
|---|---|---|---|---|---|
|
Code |
Text |
1-10 |
Text och numeriskt |
Ja |
Utläggskodenskod |
|
RegOutlayCodeName |
Text |
1-50 |
Text och numeriskt |
Ja |
Utläggskodens namn i systemet |
2.2.7 Projects
Anger de projekt som systemet kan använda sig av i XML filen. Läs mer under Project.
Elementet är inte obligatoriskt.
2.2.8 Project
Anger information per projekt som systemet kan använda sig av i XML filen.
Elementet är inte obligatoriskt.
Exempel:
<Projects>
<Project Code='0010' Description='Projekt 1'/>
<Project Code='0020' Description='Projekt 2'/>
</Projects>
Exempel med minsta antal obligatoriska fält:
Samma som ovan.
Visma Lön 600 har en hantering för att uppdatera projektregistret utifrån de projekt som finns i filen.
| Attribut | Typ | Längd | Tillåtna värden | Oblig | Kommentar |
|---|---|---|---|---|---|
| Code | Text | 1-10 | Alla värden | Ja | Projektets kod |
| Description | Text | 1-50 | Alla värden | Ja | Projektets namn |
2.2.9 ResultUnits
Anger de resultatenheter som systemet kan använda sig av i XML filen. Läs mer under ResultUnit.
Elementet är inte obligatoriskt.
2.2.10 ResultUnit
Anger information per resultatenhet som systemet kan använda sig av i XML filen.
Elementet är inte obligatoriskt.
Exempel:
<ResultUnits>
<ResultUnit Code='R1' Description='Res 1'/>
<ResultUnit Code='R2' Description='Res 2'/>
</ResultUnits>
Exempel med minsta antal obligatoriska fält:
Samma som ovan.
Visma Lön 600 har en hantering för att uppdatera resultatenhetsregistret utifrån de resultatenheter som finns i filen.
| Attribut | Typ | Längd | Tillåtna värden | Oblig | Kommentar |
|---|---|---|---|---|---|
| Code | Text | 1-10 | Alla värden | Ja | Resultatenhetens kod |
| Description | Text | 1-50 | Alla värden | Ja | Resultatenhetens namn |
2.2.11 SalaryDataEmployee
Detta element hanterar uppgifter om anställd med data som löneperiod, arbetstid, tidssaldon och utlägg.
Elementet är obligatoriskt.
Underelement till detta är
- Employee
- NormalWorkingTimes
- Times
- TimeAdjustments
- TimeBalances
- RegOutlays
Exempel:
<SalaryDataEmployee FromDate='20XX-10-01' ToDate='20XX-10-31'>
Exempel med minsta antal obligatoriska fält:
Samma som ovan.
| Attribut | Typ | Längd | Tillåtna värden | Oblig | Kommentar |
|---|---|---|---|---|---|
| FromDate | Datum | 10 | Ett datum i ISO-format, dvs ÅÅÅÅ-MM-DD | Ja | Startdatum för löneunderlaget |
| ToDate | Datum | 10 | Ett datum i ISO-format, dvs ÅÅÅÅ-MM-DD | Ja | Slutdatum för löneunderlaget |
2.2.12 Employee
Detta element innehåller information om de anställda som finns med i filen.
Elementet är obligatoriskt.
Exempel:
<Employee EmploymentNo='101' FirstName='Siw' Name='Eriksson' FromDate='20XX-10-01' ToDate='20XX-10-31'>
Exempel med minsta antal obligatoriska fält:
Samma som ovan.
| Attribut | Typ | Längd | Tillåtna värden | Oblig | Kommentar |
|---|---|---|---|---|---|
| EmploymentNo | Text | 1-20 | Alla värden | Ja | Anställningsnr. Används för att hitta rätt anställd i Lön. Finns inte detta läses den anställde ej in. |
| Signature | Text | 1-10 | Nej Avänds ej | Signatur | |
| FirstName | Text | 1-50 | Alla värden | Ja | Förnamn Finns inte detta läses den anställde ändå in med en varning. |
| Name | Text | 1-50 | Alla värden | Ja | Efternamn Finns inte detta läses den anställde ändå in med en varning. |
| PersonalNo | Text | 0-12 | Nej Avänds ej | Personnummer | |
| HourlyWage | Num | 1 | 0 eller 1 | Nej Avänds ej | Timavlönad = 1 Månadsavlönade = 0 |
| EmplCategory | Num | 1 | 0 eller 1 | Nej Avänds ej | Tjänsteman = 0 Arbetare = 1. |
| FromDate | Datum | 10 | Ett datum i ISO-format, dvs ÅÅÅÅ-MM-DD | Ja | Startdatum för löneunderlaget. Kan vara senare än motsvarande attribut för SalaryDataEmployee om den anställde börjat sin anställning under löneperioden. |
| ToDate | Datum | 10 | Ett datum i ISO-format, dvs ÅÅÅÅ-MM-DD | Ja | Slutdatum för löneunderlaget. Kan vara tidigare än motsvarande attribut för SalaryDataEmployee om den anställde slutat sin anställning under löneperioden. |
2.2.13 NormalWorkingTimes
Anger normalarbetstiden enligt schema för de dagar som ingår i perioden. ( Som visas under salarydataemployee) för den anställde.
Läs mer under NormalWorkingTime.
Elementet är obligatoriskt när TLU-filen innehåller tidsregistreringar. Innehåller TLU-filen endast utlägg är elementet inte obligatoriskt.
2.2.14 NormalWorkingTime
Anger normalarbetstiden enligt arbetsschema för respektive dag.
Elementet är inte obligatoriskt.
Exempel:
För anställd utan arbetsschema
<NormalWorkingTimes>
</NormalWorkingTimes>
Exempel med minsta antal obligatoriska fält:
Samma som ovan.
Måste finnas minst en rad/dag för att filen ska gå igenom.
För anställd med arbetsschema
<NormalWorkingTimes>
</NormalWorkingTimes>
Exempel med minsta antal obligatoriska fält:
<NormalWorkingTimes>
</NormalWorkingTimes>
Måste finnas minst en rad/dag för att filen ska gå igenom.
| Attribut | Typ | Längd | Tillåtna värden | Oblig | Kommentar |
|---|---|---|---|---|---|
| DateOfReport | Datum | 10 | Ett datum i ISO-format, dvs ÅÅÅÅ-MM-DD | Ja | För vilket datum NormalWorkingTimeHours och FlexTimeHours ska gälla för. |
| NormalWorkingTimeHours | Num | 0-5 | Numeriskt Kan vara tomt |
Ja | Arbetstid för den här dagen. Tiden ska stämma överens med Löns schema. Om den anställde i lön har schematypen Oregelbunden arbetstid används ej fältet (och kan då uteslutas). |
| FlexTimeHours | Num | 0-5 | Kan vara tomt | Nej, används ej | Flextid för den här dagen. |
2.2.15 Times
Anger gjorda tidsregistreringar under löneperioden. Läs mer under Time.
Elementet är obligatoriskt när TLU-filen innehåller tidsregistreringar. Innehåller TLU-filen endast utlägg är elementet inte obligatoriskt.
2.2.16 Time
Anger gjorda tidsregistreringar per dag och tidkod.
Elementet är inte obligatoriskt.
Exempel:
<Times>
<Time DateOfReport='20XX-10-02' TimeCode='010' SumOfHours='8.00' ProjectCode='002IT' ResultUnitCode=''/>
<Time DateOfReport='20XX-10-03' TimeCode='010' SumOfHours='8.00' ProjectCode='002IT' ResultUnitCode=''/>
</Times>
Exempel med minsta antal obligatoriska fält vid fördelning:
<Times>
<Time DateOfReport='20XX-10-02' TimeCode='010' SumOfHours='8.00' ProjectCode='002IT' ResultUnitCode=''/>
<Time DateOfReport='20XX-10-03' TimeCode='010' SumOfHours='8.00'/>
</Times>
Raderna ska ligga sorterade efter datum och tidkod. Varje rad ska ha en unik kombination av datum, tidkod, projekt och resultatenhet.
| Attribut | Typ | Längd | Tillåtna värden | Oblig | Kommentar |
|---|---|---|---|---|---|
| DateOfReport | Datum | 10 | Ett datum i ISO-format, dvs ÅÅÅÅ-MM-DD | Ja | Datum för registreringen. |
| TimeCode | Text | 1-10 | Text | Ja | Tidkod |
| SumOfHours | Text | 1-5 | Numeriskt | Ja | Antalet registrerade timmar, exv 8.00. |
| PricePerUnit | Num | 0-11 | Numeriskt | Nej | A-pris. Används enbart till tidkoder kopplade till löneart (dvs funkar inte vid koppling till ett snabbval). Om den ej anges används värdet/formeln på lönearten. |
| TimeStart | Tid | Kan vara tomt | Nej Används ej | ||
| TimeEnd | Tid | Kan vara tomt | Nej Används ej | ||
| ProjectCode | Text | 0-10 | Kan vara tomt | Nej * | Projekt för fördelning. *Obligatoriska om fördelning på projekt exporteras. |
| ResultUnitCode | Text | 0-20 | Kan vara tomt | Nej * | Resultatenhet för fördelning. *Obligatoriska om fördelning på resultatenhet exporteras. |
2.2.17 TimeAdjustments
Detta element hanterar justering av tidssaldon. Det kan exempelvis vara justering av den anställdes komptimmar.
Elementet är obligatoriskt när TLU-filen innehåller tidsregistreringar. Innehåller TLU-filen endast utlägg är elementet inte obligatoriskt.
2.2.18 Adjustment
Detta element är inte obligatoriskt.
Exempel:
<TimeAdjustments>
</TimeAdjustments>
Exempel med minsta antal obligatoriska fält:
<TimeAdjustments>
</TimeAdjustments>
Attributen är obligatoriska i de fall man vill göra en justering av tidssaldon.
| Attribut | Typ | Längd | Tillåtna värden | Oblig | Kommentar |
|---|---|---|---|---|---|
| Date | Datum | 10 | Ett datum i ISO-format, dvs ÅÅÅÅ-MM-DD | Ja | Justeringsdag |
| TimeCode | Text | 1-10 | Text eller numeriskt | Ja | Tidkod |
| Hours | Num | 1-5 | Kan vara tomt. Numeriskt |
Ja | Antal timmar |
| Comment | Text | 0-100 | Text och numeriskt | Ja | Kommentar |
2.2.19 TimeBalances
Elementet är obligatoriskt när TLU-filen innehåller tidsregistreringar. Innehåller TLU-filen endast utlägg är elementet inte obligatoriskt.
2.2.20 TimeBalance
Detta element hanterar saldon för en tidkod.
Detta element är obligatoriskt.
Exempel:
<TimeBalances>
<TimeBalance TimeCode='Flex' ConvAccRegHours='0.00'/>
</TimeBalances>
Exempel med minsta antal obligatoriska fält:
<TimeBalances>
</TimeBalances>
Registrerade timmar ska lämnas blanka för den här tidkoden.
| Attribut | Typ | Längd | Tillåtna värden | Oblig | Kommentar |
|---|---|---|---|---|---|
| TimeCode | Text | 1-10 | Text eller numeriskt | Ja | Tidkod |
| PeriodRegHours | Num | Nej Används ej | Periodens registrerade timmar på den här tidkoden. | ||
| ConvPeriodRegHours | Num | Nej Används ej | Periodens registrerade timmar omräknade till flex-/komptimmar. | ||
| AccRegHours | Num | Nej Används ej | Ackumulerat registrerade timmar på den här tidkoden. | ||
| ConvAccRegHours | Num | 1-12 | Numeriskt | Ja | Ackumulerat registrerade timmar omräknade till flex-/komptimmar. |
2.2.21 BookDistributionProjects
Detta element hanterar fördelning av projekt. Hanteras endast av Visma Lön 600.
Elementet är inte obligatoriskt
2.2.22 BookDistributionProject
Detta element är inte obligatoriskt.
Exempel:
<BookDistributionProjects>
<BookDistributionProject ProjectCode='002IT' Distribution='100.000000'/>
</BookDistributionProjects>
Fördelningen räknas ut i ett externt system
Observera att summan inte behöver bli 100% utan ligger i intervallet 0-100%.
Fördelningsinformation för projekt rörande ordinarie arbetstid.
Timavlönade med arbetsschema:
(Ordinarie arbetstid)/(Normalarbetstiden enligt arbetsschema + flex - frånvaro)
Timavlönade utan arbetsschema:
(Ordinarie arbetstid)/(Summa arbetad tid)
Månadsavlönade med arbetsschema:
(Ordinarie arbetstid) / (normalarbetstiden enligt arbetsschema+ flex)
Månadsavlönade utan arbetsschema:
Räknas ingen fördelning ut.
Varje enskild procentsats avrundas. Skulle summan bli över 100% läggs differensen på det projekt som hade högst procent så att summan blir 100%.
Fördelningsrader utan projekt läggs inte ut utan dessa sköter löneprogrammet om på egen hand.
| Attribut | Typ | Längd | Tillåtna värden | Oblig | Kommentar |
|---|---|---|---|---|---|
| ProjectCode | Text | 1-10 | Text och numeriskt | Ja | Projekt |
| Distribution | Num | 1-10 | 0-100 med tre heltal och sex decimaler | Ja | Procentuell fördelning på det här projektet |
2.2.23 BookDistributionResultUnits
Detta element hanterar fördelning av resultatenheter.
Elementet är inte obligatoriskt
2.2.24 BookDistributionResultUnit
Detta element är inte obligatoriskt.
Exempel:
<BookDistributionResultUnits>
< BookDistributionResultUnit ResultUnitCode ='002IT' Distribution='100.000000'/>
</ BookDistributionResultUnits >
Fördelningen räknas ut i ett externt system
Observera att summan inte behöver bli 100% utan ligger i intervallet 0-100%.
Fördelningsinformation för resultatenhet rörande ordinarie arbetstid.
Timavlönade med arbetsschema:
(Ordinarie arbetstid)/(Normalarbetstiden enligt arbetsschema + flex - frånvaro)
Timavlönade utan arbetsschema:
(Ordinarie arbetstid)/(Summa arbetad tid)
Månadsavlönade med arbetsschema:
(Ordinarie arbetstid + frånvaro) / (normalarbetstiden enligt arbetsschema+ flex)
Månadsavlönade utan arbetsschema:
Räknas ingen fördelning ut.
Varje enskild procentsats avrundas. Skulle summan bli över 100% läggs differensen på den resultatenhet som hade högst procent så att summan blir 100%.
Fördelningsrader utan resultatenhet läggs inte ut utan dessa sköter löneprogrammet om på egen hand.
| Attribut | Typ | Längd | Tillåtna värden | Oblig | Kommentar |
|---|---|---|---|---|---|
| ResultUnitCode | Text | 1-10 | Text och numeriskt | Ja | Resultatenhet |
| Distribution | Num | 1-10 | 0-100 med tre heltal och sex decimaler | Ja | Procentuell fördelning på den här resultatenheten |
2.2.25 RegOutlays
Anger den anställdes utlägg.
Detta element är obligatoriskt.
2.2.26 RegOutlay
Anger den anställdes utlägg per dag och utläggskod.
Attributen är bara obligatoriska i de fall utlägg har gjorts.
Exempel:
<RegOutlays>
<RegOutlay DateOfReport='20XX-10-25' OutlayCode='050' OutlayCodeName='Bilersättning (km)' OutlayType='050 - Bilersättning (km)' NoOfPrivate='' Unit='km' SumOfPrivate='900.00' SumOfPrivateTax='' InternNote='' ProjectCode='002IT' ResultUnitCode='100'/>
<RegOutlay DateOfReport="20xx-10-21" OutlayCode="1184" OutlayCodeName="Skattepliktig milersättning" OutlayType="1184 - Skattepliktig milersättning" NoOfPrivate="250" Unit="St" SumOfPrivate="" SumOfPrivateTax="" PricePerUnit="1,75" InternNote="" ProjectCode="002IT" ResultUnitCode="100"/>
</RegOutlays>
| Attribut | Typ | Längd | Tillåtna värden | Oblig | Kommentar |
|---|---|---|---|---|---|
| DateOfReport | Datum | 10 | Ett datum i ISO-format, dvs ÅÅÅÅ-MM-DD | Ja | Dag för utlägget |
| OutlayCode | Text | 1-10 | Kan vara tomt | Ja | Utläggskod |
| OutlayCodeName | Text | 1-50 | Kan vara tomt | Ja | Utläggsnamn |
| OutlayType | Text | 1-50 | Kan vara tomt | Ja | Antingen utläggskod och utläggsnamn sammanslagna med - mellan eller en text som användaren matat in i samband med tidsregistreringen. Slås ihop med InternNote i Lön. |
| NoOfPrivate | Num | 0-50 | Kan vara tomt | Ja | Antal privata utlägg - finns detta så används detta före beloppen |
| Unit | Text | 0-50 | Kan vara tomt | Ja | Enhet |
| SumOfPrivate | Num | 0-50 | Kan vara tomt | Ja | Belopp för utlägget |
| SumOfPrivateTax | Num | 0-50 | Kan vara tomt | Ja | Varav moms för utlägget |
| InternNote | Text | 0-50 | Kan vara tomt | Ja | Intern anteckning för utlägget |
| ProjectCode | Text | 0-10 | Kan vara tomt | Nej *1 | Projekt för fördelning. *1) Obligatoriska om fördelning på projekt exporteras. |
| ResultUnitCode | Text | 0-20 | Kan vara tomt | Nej *2 | Resultatenhet för fördelning. *2) Obligatoriska om fördelning på resultatenhet exporteras. |
| PricePerUnit | Num | 0-11 | Numeriskt | Nej | A-pris. Används enbart till tidkoder kopplade till löneart (dvs funkar inte vid koppling till ett snabbval). Om den ej anges används värdet/formeln på lönearten. |
2.3 Versionshantering
Aktuell version av tidredovisningsfilen är 1.4.
Tid exporterar version 1.2 av filformatet.
Vissa fält exporteras från Tid som i nuläget inte används av Visma Lön 600, de är i dokumentationen markerade som "används ej". Det finns också fält som inte exporteras från Tid men som en tredjepartsleverantör har möjlighet att lägga in i filen, dessa fält finns fr o m version 1.3.
2.3.1 Version 1.0
- Attributen under elementet SalaryData används inte förrän i versioner senare än version 1.0. Om man utelämnar version i SalaryData tolkas detta som version 1.0 och attributen kommer inte att användas.
2.3.2 Version 1.1
Ingen dokumenterad ändring.
2.3.3 Version 1.2
- Attributet BookDistributionProject under elementet SalaryData
- Attributet BookDistributionResultUnit under elementet SalaryData
- Attributet RegularWorkingTime under elementet TimeCodes
- Attributet EmplCategory under elementet Employee
- Nytt element BookDistributionProjects med tillhörande attribut
- Nytt element BookDistributionResultUnits med tillhörande attribut
- Attributet ProjectCode under elementet Times
- Attributet ResultUnitCode under elementet Times
- Attributet ProjectCode under elementet RegOutlays
- Attributet ResultUnitCode under elementet RegOutlays
2.3.4 Version 1.3
-
Attributet PricePerUnit under elementet Time.
2.3.5 Version 1.4
- Attributet PricePerUnit under elementet RegOutlay
- Nytt element RegOutlayCodes med tillhörande attribut