TimeService

This service is used for getting information about hours and costs saved in the 24SevenOffice system. You can search for recent changes or hours registered after a given date with the ChangedAfter and RegisteredAfter search parameters in GetHours. These dates are in UTC, seconds are disregarded in the search, so only changes to minutes will have an effect on the search query.

TimeService
TimeService WSDL

Data types

SaveHour

Below you will find a table that explains the status of a registered hour based on the settings of properties Locked, Approved and NeedApproval.

Important :

These are the main combinations that should be used to achieve a given status. Other combinations may result in hours that are registered as “needing approval” but not being visible in the approval list in the user interface.

Locked Approved NeedApproval Status
FALSE FALSE FALSE Registered
TRUE FALSE TRUE For Approval
TRUE TRUE TRUE Approved
FALSE TRUE TRUE Approved

Methods

Method Input type Input name Return type Description
SaveHour Hour Hour long Adds an hour into the time system
GetHours HourSearch hs Hour[] Returns a list of hours
GetHourList HourSearch hs int[] Returns a list of hour IDs
GetProjectData ProjectDataSearch Pds ProjectData Returns information about a project
GetProjectList ProjectSearch Ps Project[] Returns a list of projects
GetWorkTypeList WorkTypeSearch Wts WorkType[] Returns a list of work types
AddCost Cost cost Adds a cost
GetCosts CostSearchParameters costSearchParameters Cost[] Gets a list of costs based on search parameters
DeleteHour Hour Hour bool Deletes an hour
GetSalaryTypes SalaryType[] Gets a list of salary types
GetHoursForApproval approvalSearchParameters approvalSearchParameters Hour[] Gets hours pending for approval
GetTimeSettings KeyValue[] Get settings for Time Module