TimeMapAPI


Click here for a complete list of operations.

getAbsenceTypes

Always use Test server for test and development. All usage restrictions on test is 200 requests. Url: https://testservice.timemap.dk/timemapapi.asmx
Description:Get Absence Types
Note, Fair usage limit: 2 request 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.
Result: AbsenceTypes
  • absenceid: Internal TimeMap ID. Used to combine with Employee User Accounts.
  • absencename: Absence Name
  • include_salay: 1= Standard salary is included on absence. Empty or 0 = No salary included. Theese values can be overruled by the Employee Agreement.
  • paymentcode: Payroll system code
  • include_in_absencestatistic: 1= Absence is included when calculating absence percentage.
  • hours_per_absenceday: Hours created when the absence is created by absence functions. Special values: -1 = Workhours (Standard. Fills to normal workhours on the date), -0.2 = Avarage daily (Week worktime / Workdays per week), -0.3 = Normal stop time (Create only absence until normal stop time regardless of meeting time)
  • CASE WHEN a.flex = 'f0' THEN 'neutral' WHEN a.flex = 'f1' THEN 'absence' WHEN a.flex = 'f2' THEN 'overtimeonly' ELSE 'worktime'
  • flexitime: Empty = Absence counts as worktime, f0 = Flexitime will always be zero (neutral), f1 = Does not count as worktime and reduces flexitimer accounts, f2: Reduces flexitime account, but counts as worktime when calculating payroll.
  • shortcut: Shortcut to use on terminals with numeric keypad and no touchscreen.
  • show_on_terminal: 1 = Show the Absence Name on Terminals
  • flexitime_percent: The percentage to use when absence is included in worktime (empty is 100%)
  • hide_on_payroll: 1 = Hide row on Payroll Specification
  • salary_from_month: If specified the employee will recieve full salary after the number of months.
  • absence_code: Absence code.
  • use_approval: 1 = Absence must be approved by manager.
  • color: Color shown on lists etc.
  • description: Description
  • absence_groups: If specified the absence is only used by the groups
  • use_account: 1= Use account (earnings)
  • account_units: The account units. hh = hours, dd = days
  • account_earn: Number of units that is earned (full earnings)
  • account_allow_negative: 1= Negative account allowed, 0 = Negative account not allowed.
  • account_show_to_employee: 1 = The employee will be able to see the current account.
  • account_earn_logic: Earning logic to be used. 0 = Manual, 1 = Linary (1/12 per month), 2 = Vacation Law (Danish Vaction law), 3 = Full (Always full earnings), 4 = Monthly (1/12 is added every month during the year), 5 = Full after 9 months (Full earnings is added after 9 months of employment)
  • account_earn_year_startdate: Date of which the earn year starts. Usually 1th janary. Year is ignored (same date every year) (Date format: yyyy.MM.dd)
  • account_use_year_startdate: Date of which the account usage starts. Usually 1th janary. Year is ignored (same date every year) (Date format: yyyy.MM.dd)
  • account_exclude_from_earnings:
  • account_modify_log: Internal log for tracking changes in earnings setup.
  • inactive: 1 = Absence type is inactive and not used anymore.
  • modified_date: Date of last modification (Dateformat: yyyy.MM.dd)
  • modified_by: Email of the user that have modified the absencetype last

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

<?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>
    <getAbsenceTypes xmlns="http://tempuri.org/">
      <apikey>string</apikey>
      <apipwd>string</apipwd>
      <username>string</username>
    </getAbsenceTypes>
  </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>
    <getAbsenceTypesResponse xmlns="http://tempuri.org/">
      <getAbsenceTypesResult>string</getAbsenceTypesResult>
    </getAbsenceTypesResponse>
  </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>
    <getAbsenceTypes xmlns="http://tempuri.org/">
      <apikey>string</apikey>
      <apipwd>string</apipwd>
      <username>string</username>
    </getAbsenceTypes>
  </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>
    <getAbsenceTypesResponse xmlns="http://tempuri.org/">
      <getAbsenceTypesResult>string</getAbsenceTypesResult>
    </getAbsenceTypesResponse>
  </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/getAbsenceTypes?apikey=string&apipwd=string&username=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>