TimeMapAPI


Click here for a complete list of operations.

getEmployee

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 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 (You can specify eigther SalaryNo or TimeMapID to get one employee. Or leave both blank to get all active employees) ).
  • TimeMapId (string): The TimeMapID of the employee (You can specify eigther SalaryNo or TimeMapID to get one employee. Or leave both blank to get all active employees).
Returns: Array of object: "Employee"
  • SalaryNo: Salary/Payroll number
  • TimeMapID: Internal TimeMapID. Same as EmployeeID
  • SSN: Social security number
  • FirstName: Firstname
  • LastName: Lastname
  • Address: Address line 1
  • Address2: Address line 2
  • ZipCode: Zip code
  • City: City
  • EmailPrimary: Primary email address
  • PhonePrimary: Primary Phone (Mobile)
  • PhoneSecondary: Secondary Phone (Private)
  • HireDate: Hire date. Format: yyyy.MM.dd (e.g. 2010.08.02)

  • EndDate: The employees stop date in the firm. Format: yyyy.MM.dd
  • InActive: If the employee is active or inactive. (Empty or 0: The employee is active. 1: Employee is inactive)
  • Active: If the employee is active or inactive. (Empty or 0: The employee is inactive. 1: Employee is active)
  • ApprovedUntil: Date for approval. The period before this date is locked.
  • StandardWorkHoursPerWeek: Standard Work hours per week. E.g. 40
  • UseFlex: If the employee has flexitime accounts (1: Flexitime is active. Empty or 0: No flexitime)
  • FlexStartAccount: Flexitime start account in hours
  • FlexStartDate: Flexitime start date

    Example: {"Employee": [{"SalaryNo":"0001","TimeMapID":"1","SSN":"01 01 70-0000","FirstName":"John","LastName":"Doe","Address":"","Address2":"","ZipCode":"","City":"","EmailPrimary":"johnd@timemap.dk","PhonePrimary":"22112211","PhoneSecondary":"","HireDate":"1/1/2000","EndDate":"","InActive":"Active","ApprovedUntil":"2015.01.12","StandardWorkHoursPerWeek":"32.5","UseFlex":"Yes","FlexStartAccount":"0","FlexStartDate":"2016.06.27"}]}
\

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

<?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>
    <getEmployee xmlns="http://tempuri.org/">
      <apikey>string</apikey>
      <apipwd>string</apipwd>
      <username>string</username>
      <SalaryNo>string</SalaryNo>
      <TimeMapID>string</TimeMapID>
    </getEmployee>
  </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>
    <getEmployeeResponse xmlns="http://tempuri.org/">
      <getEmployeeResult>string</getEmployeeResult>
    </getEmployeeResponse>
  </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>
    <getEmployee xmlns="http://tempuri.org/">
      <apikey>string</apikey>
      <apipwd>string</apipwd>
      <username>string</username>
      <SalaryNo>string</SalaryNo>
      <TimeMapID>string</TimeMapID>
    </getEmployee>
  </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>
    <getEmployeeResponse xmlns="http://tempuri.org/">
      <getEmployeeResult>string</getEmployeeResult>
    </getEmployeeResponse>
  </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/getEmployee?apikey=string&apipwd=string&username=string&SalaryNo=string&TimeMapID=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>