TimeMapAPI


Click here for a complete list of operations.

setEmployeeWorkhours

Always use Test server for test and development. All usage restrictions on test is 200 requests. Url: https://testservice.timemap.dk/timemapapi.asmx
Description:Used for updating employee workhours
Note, Fair usage limit: 2 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): Mandatory. Employees salary no. This is the key for the employee.
  • ValidFrom (string): Date where the new workhours starts (Format: yyyy.MM.dd). If empty current date is used.
  • ValidTo (string): Date where the new workhours ends (Format: yyyy.MM.dd). If empty 2025.01.01 is used.
  • StartTimes (string): String of start hours starting monday and ending sunday. Must be seperated by semicolon. Example (starting at 08:00 monday to thursday and starting 09:00 friday: 08:00;08:00;08:00;08:00;09:00;
  • EndTimes (string): String of end hours starting monday and ending sunday. Must be seperated by semicolon.
  • WorkBreakTimes (string): String of auto breaks that should be subtracted at check out. Starting mondag and ending sunday. Must be seperated by semicolon. Example ( 30 minute break monday, wedensday and friday): 00:30;00:00;00:30;;00:30;;;
  • OnCallTypes (string): String of On Call Swifts. Starting mondag and ending sunday. Normally this value should be empty. 0 <=> Not on call. 1 <=> On Call
  • Week (string): This value indicates if workhours is all weeks (empty value), Even weeks (0), Odd weeks (1)


If the employee doesn't have fixed workhours or the fixed workhours changes more than every second week, thep ImportWorkplan mothod should be used.

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/setEmployeeWorkhours"

<?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>
    <setEmployeeWorkhours xmlns="http://tempuri.org/">
      <apikey>string</apikey>
      <apipwd>string</apipwd>
      <username>string</username>
      <SalaryNo>string</SalaryNo>
      <ValidFrom>string</ValidFrom>
      <ValidTo>string</ValidTo>
      <StartTimes>string</StartTimes>
      <EndTimes>string</EndTimes>
      <WorkBreakTimes>string</WorkBreakTimes>
      <OnCallTypes>string</OnCallTypes>
      <Week>string</Week>
    </setEmployeeWorkhours>
  </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>
    <setEmployeeWorkhoursResponse xmlns="http://tempuri.org/">
      <setEmployeeWorkhoursResult>string</setEmployeeWorkhoursResult>
    </setEmployeeWorkhoursResponse>
  </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>
    <setEmployeeWorkhours xmlns="http://tempuri.org/">
      <apikey>string</apikey>
      <apipwd>string</apipwd>
      <username>string</username>
      <SalaryNo>string</SalaryNo>
      <ValidFrom>string</ValidFrom>
      <ValidTo>string</ValidTo>
      <StartTimes>string</StartTimes>
      <EndTimes>string</EndTimes>
      <WorkBreakTimes>string</WorkBreakTimes>
      <OnCallTypes>string</OnCallTypes>
      <Week>string</Week>
    </setEmployeeWorkhours>
  </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>
    <setEmployeeWorkhoursResponse xmlns="http://tempuri.org/">
      <setEmployeeWorkhoursResult>string</setEmployeeWorkhoursResult>
    </setEmployeeWorkhoursResponse>
  </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/setEmployeeWorkhours?apikey=string&apipwd=string&username=string&SalaryNo=string&ValidFrom=string&ValidTo=string&StartTimes=string&EndTimes=string&WorkBreakTimes=string&OnCallTypes=string&Week=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>