TimeMapAPI


Click here for a complete list of operations.

getEmployeeDetail

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 getting current Employee Details data in TimeMap
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): The Payroll Number of the employee (SalaryNo or TimeMapID must be specified).
  • EmployeeId (string): The TimeMap EmployeeID of the employee (SalaryNo or EmployeeID must be specified).
Returns: Object: "Employee"
  • employeeid: Internal employeeid. Same as timemapid
  • timemapid: Internal TimeMapID. Same as EmployeeID
  • employeeno: employee number (used for checking in/out when using terminals with keycode or cards)
  • salaryno: Salary/Payroll number
  • firstName: Firstname
  • lastName: Lastname
  • initials: Initials
  • ssn: Social security number
  • address: Address line 1
  • address2: Address line 2
  • zipcode: Zip code
  • city: City
  • email_primary: Primary email address
  • email_secondary: Secondary email address
  • phone_primary: Primary Phone (Mobile)
  • phone_secondary: Secondary Phone (Private)
  • hiredate: Hire date. Format: yyyy.MM.dd (e.g. 2010.08.02)
  • endingdate: The employees stop date in the firm. Format: yyyy.MM.dd
  • standardworkhours: Standard Work hours per week. E.g. 40
  • approveduntil: Date for approval. The period before this date is locked.
  • employeeagreementname: The name of the current employeeagreement used by the employee.
  • employeeagreementid: The id of the current employeeagreement used by the employee.
  • workbreakgroup: Standard workbreaks. This value is used when the employee does not have workbreakgroups defined in standard workhours.
  • groups: Name of the groups that the employee belongs to. Seperated by comma.
  • absencepct: Current absence percent (calculated daily).
  • UseFlex: If the employee has flexitime accounts (1: Flexitime is active. Empty or 0: No flexitime)
  • flexaccount: Current flexitime account (calculated on check in/out).
  • FlexStartAccount: Flexitime start account in hours
  • FlexStartDate: Flexitime start date
  • note: Note
  • timezone: Timezone
  • country: Country
  • InActive: If the employee is active or inactive. (Empty or 0: The employee is active. 1: Employee is inactive)
  • User Defined fields: The extra fields that is defined on the employee base data is added one at the time. Field name is the same as the Label for the field. Values is always string as entered.
\

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

<?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>
    <getEmployeeDetail xmlns="http://tempuri.org/">
      <apikey>string</apikey>
      <apipwd>string</apipwd>
      <username>string</username>
      <employeeid>string</employeeid>
      <salaryno>string</salaryno>
      <departmentno>string</departmentno>
    </getEmployeeDetail>
  </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>
    <getEmployeeDetailResponse xmlns="http://tempuri.org/">
      <getEmployeeDetailResult>string</getEmployeeDetailResult>
    </getEmployeeDetailResponse>
  </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>
    <getEmployeeDetail xmlns="http://tempuri.org/">
      <apikey>string</apikey>
      <apipwd>string</apipwd>
      <username>string</username>
      <employeeid>string</employeeid>
      <salaryno>string</salaryno>
      <departmentno>string</departmentno>
    </getEmployeeDetail>
  </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>
    <getEmployeeDetailResponse xmlns="http://tempuri.org/">
      <getEmployeeDetailResult>string</getEmployeeDetailResult>
    </getEmployeeDetailResponse>
  </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/getEmployeeDetail?apikey=string&apipwd=string&username=string&employeeid=string&salaryno=string&departmentno=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>