TimeMapAPI


Click here for a complete list of operations.

CreateHourregistration

Always use Test server for test and development. All usage restrictions on test is 200 requests. Url: https://testservice.timemap.dk/timemapapi.asmx
Description:Create an hourregistration (work or absence). Create hourregistration or Update hourregistration.
Note, Fair usage limit: In production this function is only allowed between 01:00 and 03:59 (UTC).
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.
  • employeeid (long): Optional. Internal TimeMap ID for the employee (must be specified if no salaryno)
  • salaryno (string): Optional. Employee salary number (must be specified if no employeeid)
  • starttime (datetime): Mandatory. Start time/date of the registration. (Format: yyyy.MM.dd hh:mm:ss).
  • endtime (string): Mandatory. End time/date of the registration. (Format: yyyy.MM.dd hh:mm:ss).
  • breaktime (int): Optional. Workbreak minutes within this registration. If empty the standard workbreak will be calculated.
  • projectno (string): Optional. Project number
  • projectid (int): Optional. Project id (internal TimeMap project id)
  • taskno (string): Optional. Task no
  • taskid (int): Optional. Task id (internal TimeMap task id)
  • absenceid (int): Optional. Absence id (internal TimeMap absence id)
  • hourregistrationid (int): Optional. Internal hourregistrationid. This should be empty for inserts and specified for an update.
  • comment (string): Optional. Comment on the hreg.
  • quantity (int): Optional. Number of items produced.
  • hourprice (decimal): Optional. Hourprice for this registration.
  • workdate (string): Optional. Workdate of the registration. ONLY if different from the starttime date! (Format: yyyy.MM.dd).
Result: Status
  • hourregistrationid: the TimeMap hourregistrationid of the updated/inserted registration
  • status: status message

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

<?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>
    <CreateHourregistration xmlns="http://tempuri.org/">
      <apikey>string</apikey>
      <apipwd>string</apipwd>
      <username>string</username>
      <employeeid>string</employeeid>
      <salaryno>string</salaryno>
      <starttime>string</starttime>
      <endtime>string</endtime>
      <breaktime>string</breaktime>
      <projectno>string</projectno>
      <projectid>string</projectid>
      <taskno>string</taskno>
      <taskid>string</taskid>
      <absenceid>string</absenceid>
      <hourregistrationid>string</hourregistrationid>
      <comment>string</comment>
      <quantity>string</quantity>
      <hourprice>string</hourprice>
      <workdate>string</workdate>
    </CreateHourregistration>
  </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>
    <CreateHourregistrationResponse xmlns="http://tempuri.org/">
      <CreateHourregistrationResult>string</CreateHourregistrationResult>
    </CreateHourregistrationResponse>
  </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>
    <CreateHourregistration xmlns="http://tempuri.org/">
      <apikey>string</apikey>
      <apipwd>string</apipwd>
      <username>string</username>
      <employeeid>string</employeeid>
      <salaryno>string</salaryno>
      <starttime>string</starttime>
      <endtime>string</endtime>
      <breaktime>string</breaktime>
      <projectno>string</projectno>
      <projectid>string</projectid>
      <taskno>string</taskno>
      <taskid>string</taskid>
      <absenceid>string</absenceid>
      <hourregistrationid>string</hourregistrationid>
      <comment>string</comment>
      <quantity>string</quantity>
      <hourprice>string</hourprice>
      <workdate>string</workdate>
    </CreateHourregistration>
  </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>
    <CreateHourregistrationResponse xmlns="http://tempuri.org/">
      <CreateHourregistrationResult>string</CreateHourregistrationResult>
    </CreateHourregistrationResponse>
  </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/CreateHourregistration?apikey=string&apipwd=string&username=string&employeeid=string&salaryno=string&starttime=string&endtime=string&breaktime=string&projectno=string&projectid=string&taskno=string&taskid=string&absenceid=string&hourregistrationid=string&comment=string&quantity=string&hourprice=string&workdate=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>