TimeMapAPI Web Service

TimeMapAPI

Click here for a complete list of operations.

getProjectPayroll

Always use Test server for test and development. All usage restrictions on test is 200 requests. Url: https://testservice.timemap.dk/timemapapi.asmx

Description: Exports hours and payroll cost a given project/employee/date. A payroll must be completed before payroll amounts is included.
Note, Fair usage limit: 20 request per employee per hour.

Parameters:

apikey (string): Mandatory. The apikey is specified in the Company settings. Please see menu Settings->Company

apipwd (string): Mandatory. The api password must be specified in the Company settings. Please see menu Settings->Company

username (string): Mandatory. Specify the username/email of the user/developer calling this method. The user must exists in the EmployeeList.

SalaryNo (string): * The Payroll Number of the employee.

TimeMapId (string): * The TimeMapID of the employee.

FromDate (string): * Date where the new workhours starts (Format: yyyy.MM.dd). If not specified all hregs the last month is exported. Max allowed interval is 65 days

ToDate (string): * Date where the new workhours ends (Format: yyyy.MM.dd). If not specified all hregs the last month is exported. Max allowed interval is 65 days

projectid (int): * TimeMap projectid.

projectno (string): * Project number.

*) Please note: Date from/to must be specified if no SalaryNo/TimeMapID or projectid/projectno is specified.

Result: Hourregistrations

sortcolumn: sorting value (int)
PeriodeFra: Start date for the result set (eg. 2013-06-20 07:00:00)
PeriodeTil: End date for the result set
MedarbejderNr: Employee number (string)
Fornavn: First name (String)
Efternavn: Last name (String)
Tid Fra: Punch in date/time (eg. 2018-05-24 09:18:13)
Tid Til: Punch out date/time (eg. 2018-05-24 17:08:00)
Tid i Sekunder: Registration time in seconds (int)
Tid i timer: Registration time in hours (decimal)
Tid i timer/min/sek: Registration time in hours/minutes/seconds hh:MM:ss (string)
Pause: Break time in seconds (int)
Tid ekskl. pause (sek): Registration time in seconds ex. breaks (int)
Tid ekskl. pause (timer): Registration time in hours ex. breaks (decimal)
Tid ekskl. pause (timer/min/sek): Registration time in hours/minutes/seconds hh:MM:ss ex. breaks (string)
Fravær: Absence name (string)
ProjektNr: Project number (string)
ProjektNavn: Project name (string)
OpgaveNr Task number (string)
Opgave: Task name (string)
Kommentar: Comment (string)
ProjektTimePrisStandard: Standard hour price for the project (decimal)
TimePris: Hour price registrered on the registration (decimal)
Pris i alt: Total price (decimal)
Faktureret: Flag (0/1) indecating if this registration is marked as invoiced (int)
Loennr: Employee Salary Number (string)
ID: Internal TimeMap id for this registration (int)
Antal: Quantity entered for this registration. Normally used for indication how many items was produced during the registration (deimal)
Projekttype: Project type (string)
Projektstatuskode: Project status code (String)
Projektstatus: Project state (string)
Projektafdeling: Department name of the project (string)
Kontonr: Project Account number (string)
Projektunit: Project unit number (string)
Projektleder: Project managers name (string)
Projektkostpris: Project cost price (decimal)
Estimeredetimer: Estimated hours for the project (decimal)
Timekostpris: Project hour cost price (decimal)
Fakturatimepris: Project invoice hour price (decimal)
Godkendt: 0=Not Approved, 1=Approved (int)
Approved by: Approved by (string)
Date: Date of the registration (Date yyyy.mm.dd)
absenceid: Always null (int)
PayrollFromDate: Date of the Payroll from date that includes this registration (Date)
PayrollToDate: Date of the Payroll to date that includes this registration (Date)
cost: The payroll cost of the registration (total). Includes base salary and wages that can be mapped 1:1 to the registration (decimal)
costsplitted: The payroll cost of the registration (total). Includes wages that can not be mapped 1:1 to the registration (decimal)
costperhour: The payroll per hour cost of the registration. Includes base salary and wages that can be mapped 1:1 to the registration (decimal)
costsplittedperhour: The payroll cost per hour of the registration (total). Includes wages that can not be mapped 1:1 to the registration (decimal)

Test

The test form is only available for requests from the local machine.

SOAP 1.1

The following is a sample SOAP 1.1 request and response. The placeholders shown need to be replaced with actual values.

POST /TimeMapApi.asmx HTTP/1.1
Host: testservice.timemap.dk
Content-Type: text/xml; charset=utf-8
Content-Length: length
SOAPAction: "http://tempuri.org/getProjectPayroll"

<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
  <soap:Body>
    <getProjectPayroll xmlns="http://tempuri.org/">
      <apikey>string</apikey>
      <apipwd>string</apipwd>
      <username>string</username>
      <SalaryNo>string</SalaryNo>
      <TimeMapID>string</TimeMapID>
      <FromDate>string</FromDate>
      <ToDate>string</ToDate>
      <projectno>string</projectno>
      <projectid>string</projectid>
    </getProjectPayroll>
  </soap:Body>
</soap:Envelope>

HTTP/1.1 200 OK
Content-Type: text/xml; charset=utf-8
Content-Length: length

<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
  <soap:Body>
    <getProjectPayrollResponse xmlns="http://tempuri.org/">
      <getProjectPayrollResult>string</getProjectPayrollResult>
    </getProjectPayrollResponse>
  </soap:Body>
</soap:Envelope>

SOAP 1.2

The following is a sample SOAP 1.2 request and response. The placeholders shown need to be replaced with actual values.

POST /TimeMapApi.asmx HTTP/1.1
Host: testservice.timemap.dk
Content-Type: application/soap+xml; charset=utf-8
Content-Length: length

<?xml version="1.0" encoding="utf-8"?>
<soap12:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap12="http://www.w3.org/2003/05/soap-envelope">
  <soap12:Body>
    <getProjectPayroll xmlns="http://tempuri.org/">
      <apikey>string</apikey>
      <apipwd>string</apipwd>
      <username>string</username>
      <SalaryNo>string</SalaryNo>
      <TimeMapID>string</TimeMapID>
      <FromDate>string</FromDate>
      <ToDate>string</ToDate>
      <projectno>string</projectno>
      <projectid>string</projectid>
    </getProjectPayroll>
  </soap12:Body>
</soap12:Envelope>

HTTP/1.1 200 OK
Content-Type: application/soap+xml; charset=utf-8
Content-Length: length

<?xml version="1.0" encoding="utf-8"?>
<soap12:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap12="http://www.w3.org/2003/05/soap-envelope">
  <soap12:Body>
    <getProjectPayrollResponse xmlns="http://tempuri.org/">
      <getProjectPayrollResult>string</getProjectPayrollResult>
    </getProjectPayrollResponse>
  </soap12:Body>
</soap12:Envelope>

HTTP GET

The following is a sample HTTP GET request and response. The placeholders shown need to be replaced with actual values.

GET /TimeMapApi.asmx/getProjectPayroll?apikey=string&apipwd=string&username=string&SalaryNo=string&TimeMapID=string&FromDate=string&ToDate=string&projectno=string&projectid=string HTTP/1.1
Host: testservice.timemap.dk

HTTP/1.1 200 OK
Content-Type: text/xml; charset=utf-8
Content-Length: length

<?xml version="1.0" encoding="utf-8"?>
<string xmlns="http://tempuri.org/">string</string>

Always use Test server for test and development. All usage restrictions on test is 200 requests. Url: https://testservice.timemap.dk/timemapapi.asmx
Description:	Exports hours and payroll cost a given project/employee/date. A payroll must be completed before payroll amounts is included. Note, Fair usage limit: 20 request per employee per hour.
Parameters:	apikey (string): Mandatory. The apikey is specified in the Company settings. Please see menu Settings->Company apipwd (string): Mandatory. The api password must be specified in the Company settings. Please see menu Settings->Company username (string): Mandatory. Specify the username/email of the user/developer calling this method. The user must exists in the EmployeeList. SalaryNo (string): * The Payroll Number of the employee. TimeMapId (string): * The TimeMapID of the employee. FromDate (string): * Date where the new workhours starts (Format: yyyy.MM.dd). If not specified all hregs the last month is exported. Max allowed interval is 65 days ToDate (string): * Date where the new workhours ends (Format: yyyy.MM.dd). If not specified all hregs the last month is exported. Max allowed interval is 65 days projectid (int): * TimeMap projectid. projectno (string): * Project number. *) Please note: Date from/to must be specified if no SalaryNo/TimeMapID or projectid/projectno is specified.
Result:	Hourregistrations sortcolumn: sorting value (int) PeriodeFra: Start date for the result set (eg. 2013-06-20 07:00:00) PeriodeTil: End date for the result set MedarbejderNr: Employee number (string) Fornavn: First name (String) Efternavn: Last name (String) Tid Fra: Punch in date/time (eg. 2018-05-24 09:18:13) Tid Til: Punch out date/time (eg. 2018-05-24 17:08:00) Tid i Sekunder: Registration time in seconds (int) Tid i timer: Registration time in hours (decimal) Tid i timer/min/sek: Registration time in hours/minutes/seconds hh:MM:ss (string) Pause: Break time in seconds (int) Tid ekskl. pause (sek): Registration time in seconds ex. breaks (int) Tid ekskl. pause (timer): Registration time in hours ex. breaks (decimal) Tid ekskl. pause (timer/min/sek): Registration time in hours/minutes/seconds hh:MM:ss ex. breaks (string) Fravær: Absence name (string) ProjektNr: Project number (string) ProjektNavn: Project name (string) OpgaveNr Task number (string) Opgave: Task name (string) Kommentar: Comment (string) ProjektTimePrisStandard: Standard hour price for the project (decimal) TimePris: Hour price registrered on the registration (decimal) Pris i alt: Total price (decimal) Faktureret: Flag (0/1) indecating if this registration is marked as invoiced (int) Loennr: Employee Salary Number (string) ID: Internal TimeMap id for this registration (int) Antal: Quantity entered for this registration. Normally used for indication how many items was produced during the registration (deimal) Projekttype: Project type (string) Projektstatuskode: Project status code (String) Projektstatus: Project state (string) Projektafdeling: Department name of the project (string) Kontonr: Project Account number (string) Projektunit: Project unit number (string) Projektleder: Project managers name (string) Projektkostpris: Project cost price (decimal) Estimeredetimer: Estimated hours for the project (decimal) Timekostpris: Project hour cost price (decimal) Fakturatimepris: Project invoice hour price (decimal) Godkendt: 0=Not Approved, 1=Approved (int) Approved by: Approved by (string) Date: Date of the registration (Date yyyy.mm.dd) absenceid: Always null (int) PayrollFromDate: Date of the Payroll from date that includes this registration (Date) PayrollToDate: Date of the Payroll to date that includes this registration (Date) cost: The payroll cost of the registration (total). Includes base salary and wages that can be mapped 1:1 to the registration (decimal) costsplitted: The payroll cost of the registration (total). Includes wages that can not be mapped 1:1 to the registration (decimal) costperhour: The payroll per hour cost of the registration. Includes base salary and wages that can be mapped 1:1 to the registration (decimal) costsplittedperhour: The payroll cost per hour of the registration (total). Includes wages that can not be mapped 1:1 to the registration (decimal)