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.

Please note: 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 Return type Description
SaveHour Hour Long Adds an hour into the time system
GetHours HourSearch Hour[] Returns a list of hours
GetHourList HourSearch Int[] Returns a list of hour IDs
GetProjectData ProjectDataSearch ProjectData Returns information about a project
GetProjectList ProjectSearch Project[] Returns a list of projects
GetWorkTypeList WorkTypeSearch WorkType[] Returns a list of work types
AddCost Cost Adds a cost
GetCosts CostSearchParameters Cost[] Gets a list of costs based on search parameters
DeleteHour Hour Boolean Deletes an hour
GetSalaryTypes SalaryType[] Gets a list of salary types
GetHoursForApproval ApprovalSearchParameters Hour[] Gets hours pending for approval
GetTimeSettings KeyValuePair[] Get settings for Time Module