View source for Timecard Soap API

== The Timecard SOAP API ==

The Timecard SOAP API is similar to the [[EService Soap API]], in that it provides methods for retrieving, updating, and deleting data stored on the Econz Timecard servers.

The API is published separately at the moment, as another interface for linking into the Timecard server, although there is some progress on integrating the two products together in a future release.

== The Interface Definition ==

Below is a summary of the important functions that make up the Timecard API (a full java doc style specification can be found [http://eservicewebtest.econz.com/SOAP/timecardsoap1/nz/co/econz/nads/timecard1/Timecard1Soap.html here] and even better the latest auto generated SOAP doc is available [http://eservicewebtest.econz.com/SOAP/timecard_wsdl_doc.html here] and here is the [http://timecardwebtest.econz.com/axis/services/timecard1Soap?wsdl wsdl]).  Each function is called, passing in at least one parameter, a [[UserIDBean]].  This bean contains the user name and password of a previously registered Timecard User, with administrative rights.  This ensures only authorised users are able to access the interface.
 
=== Timecard User Management Functions ===
{| border=1
!Method
!Summary
|---- bgcolor=#EDEDFF
|[[createUser]]
|Creates a new user based on the user data passed in.
|---- bgcolor=#EDEDFF
|[[getUserDetail]]
|Gets all the details of a specified user.
|---- bgcolor=#EDEDFF
|[[getUserDetailByLoginID]]
|Gets all the details of the user as specified by their Login ID (user name).
|---- bgcolor=#EDEDFF
|[[getUserDetails]]
|Gets all the details for all the users (returns an array of [[UserBean]]).
|---- bgcolor=#EDEDFF
|[[getUserSummaries]]
|Returns a list of all users (including managers).
|---- bgcolor=#EDEDFF
|[[getManagerSummaries]]
|Returns a list of just the managers.
|---- bgcolor=#EDEDFF
|[[updateUser]]
|Updates a particular user with new details.
|---- bgcolor=#EDEDFF
|[[updateUserPassword]]
|Updates a user's password.
|---- bgcolor=#EDEDFF
|[[deleteUser]]
|Deletes an existing user.
|---- bgcolor=#EDEDFF
|[[getUnsynchronisedUsers]]
|Retrieves all users who have not previously been synchronised and acknowledged, and all users that have changed since their last synchronisation.
|---- bgcolor=#EDEDFF
|[[ackUserSynchronisation]]
|Acknowledges that synchronisation has been performed on the selected users.
|}

=== Timecard Field Device Management Functions ===
{| border=1
!Method
!Summary
|---- bgcolor=#EDEDFF
|[[createFieldDevice (for Timecard)|createFieldDevice]]
|Creates a new field device based on the field device data passed in.
|---- bgcolor=#EDEDFF
|[[getFieldDeviceDetail]]
|Gets the full set of details for a specified field device.
|---- bgcolor=#EDEDFF
|[[getFieldDeviceDetails]]
|Gets the full set of details for all specified field devices.
|---- bgcolor=#EDEDFF
|[[getFieldDeviceDetailsUpdatedSince]]
|Gets the full set of details for all field devices that have been updated since the specified date and time.
|---- bgcolor=#EDEDFF
|[[updateFieldDevice]]
|Updates a field device with new details.
|---- bgcolor=#EDEDFF
|[[deleteFieldDevice]]
|Marks a field device as deleted.
|---- bgcolor=#EDEDFF
|[[getFieldDevicePKForName]]
|Gets the primary key of a field device, based on the name passed in.
|---- bgcolor=#EDEDFF
|[[getFieldDevicePKForDeviceID]]
|Gets the primary key of a field device, based on the device id passed in.
|}

=== Timecard functions to Retrieve Raw Event Data ===

{| border=1
!Returns
!Method
!Parameters
!Description
|---- bgcolor=#EDEDFF
|Array of [[#EventBean | EventBean]]
|[http://eservicewebtest.econz.com/SOAP/timecardsoap1/nz/co/econz/nads/timecard1/Timecard1Soap.html#getUserEvents(nz.co.econz.nads.soap2.UserIDBean,%20java.lang.String,%20java.util.Calendar,%20java.util.Calendar) getUserEvents]
|[[UserIDBean]], userPrimaryKey, start date, end date
|For a given user in a selected period, retrieves clock in/out dates and times and task descriptions.
|---- bgcolor=#EDEDFF
|Array of [[#EventBean | EventBean]]
|[http://eservicewebtest.econz.com/SOAP/timecardsoap1/nz/co/econz/nads/timecard1/Timecard1Soap.html#getAllUserEvents(nz.co.econz.nads.soap2.UserIDBean,%20java.util.Calendar,%20java.util.Calendar) getAllUserEvents]
|[[UserIDBean]], start date, end date
|Retrieves clock in/out dates and times and task descriptions for all users in a selected period.
|---- bgcolor=#EDEDFF
|Array of [[#EventBean | EventBean]]
|[http://eservicewebtest.econz.com/SOAP/timecardsoap1/nz/co/econz/nads/timecard1/Timecard1Soap.html#getUnsynchronisedUserEvents(nz.co.econz.nads.soap2.UserIDBean,%20java.lang.String,%20java.util.Calendar) getUnsynchronizedUserEvents]
|[[UserIDBean]],  [[SynchronisationBean | synchronisationID]],  createdOnOrAfter
|Retrieves array of [[#EventBean | EventBean]] (detailed further below) that have not previously been synchronized and acknowledged and all events that have changed since their last synchronization.
|---- bgcolor=#EDEDFF
|return
|[http://eservice.econz.co.nz/SOAP/timecardsoap1/nz/co/econz/nads/timecard1/Timecard1Soap.html#ackUserEventSynchronisation(nz.co.econz.nads.soap2.UserIDBean,%20nz.co.econz.nads.timecard1.UserEventSynchronisationBean%5B%5D)  ackUserEventSynchronization]
|[[UserIDBean]], [http://eservice.econz.co.nz/SOAP/timecardsoap1/nz/co/econz/nads/timecard1/UserEventSynchronisationBean.html UserEventSynchronizationBean]
|Acknowledges that synchronization has been performed on the selected events.
|}

=== Methods to Retrieve Processed Data ===

{| border=1
!Returns
!Method
!Parameters
!Description
|---- bgcolor=#EDEDFF
|[[#HourBreakdownBean | HourBreakdownBean]]
|[http://eservice.econz.co.nz/SOAP/timecardsoap1/nz/co/econz/nads/timecard1/Timecard1Soap.html#getUserHoursSummary(nz.co.econz.nads.soap2.UserIDBean,%20java.lang.String,%20java.util.Calendar,%20java.util.Calendar) getUserHoursSummary]
|[[UserIDBean]], UserPrimaryKey, start, end
|Gets the hourly breakdown for a single user.
|---- bgcolor=#EDEDFF
|Array of [[#HourBreakdownBean | HourBreakdownBean]]
|[http://eservice.econz.co.nz/SOAP/timecardsoap1/nz/co/econz/nads/timecard1/Timecard1Soap.html#getHourSummaries(nz.co.econz.nads.soap2.UserIDBean,%20java.util.Calendar,%20java.util.Calendar) getHourSummaries]
|[[UserIDBean]], start, end
|Hourly breakdowns for all users in the given time period.
|---- bgcolor=#EDEDFF
|Array of [[#DetailedHourBreakdownBean | DetailedHourBreakdownBean]]
|[http://eservice.econz.co.nz/SOAP/timecardsoap1/nz/co/econz/nads/timecard1/Timecard1Soap.html#getDetailedUserHourSummary(nz.co.econz.nads.soap2.UserIDBean,%20java.lang.String,%20java.util.Calendar,%20java.util.Calendar,%20boolean) getDetailedUserHourSummary]
|[[UserIDBean]], UserPrimaryKey, start, end, showUserTZFlag
|Gets the hourly breakdown, adhering to the [[IDI]] specification, for a single user.
|---- bgcolor=#EDEDFF
|Array of [[#DetailedHourBreakdownBean | DetailedHourBreakdownBean]]
|[http://eservice.econz.co.nz/SOAP/timecardsoap1/nz/co/econz/nads/timecard1/Timecard1Soap.html#getDetailedHourSummaries(nz.co.econz.nads.soap2.UserIDBean,%20java.util.Calendar,%20java.util.Calendar,%20boolean) getDetailedHourSummaries]
|[[UserIDBean]], start, end, showUserTZFlag
|Hourly breakdowns, adhering to the [[IDI]] specification, for all users in the given time period.

|---- bgcolor=#EDEDFF
|Array of [[#DetailedHourBreakdownBeanWithRateCode | DetailedHourBreakdownBeanWithRateCode]]
|getDetailedUserHourSummaryWithRateCode
|[[UserIDBean]], UserPrimaryKey, start, end, showUserTZFlag
|Gets the hourly breakdown, adhering to the [[IDI]] specification, for a single user. Provided results include a customer specified rate code for the associated task/device combination. This method does not return an additional row if worker time covers two days(eg night shift). The [http://eservice.econz.co.nz/SOAP/timecardsoap1/nz/co/econz/nads/timecard1/Timecard1Soap.html#getDetailedUserHourSummary(nz.co.econz.nads.soap2.UserIDBean,%20java.lang.String,%20java.util.Calendar,%20java.util.Calendar,%20boolean) getDetailedUserHourSummary] method returns two rows for this scenario for easy daily overtime calculation. 
|---- bgcolor=#EDEDFF
|Array of [[#DetailedHourBreakdownBeanWithRateCode | DetailedHourBreakdownBeanWithRateCode]]
|getDetailedHourSummariesWithRateCode
|[[UserIDBean]], start, end, showUserTZFlag
|Hourly breakdowns, adhering to the [[IDI]] specification, for all users in the given time period. Provided results include a customer specified rate code for the associated task/device combination. This method does not return an additional row if worker time covers two days(eg night shift). The [http://eservice.econz.co.nz/SOAP/timecardsoap1/nz/co/econz/nads/timecard1/Timecard1Soap.html#getDetailedHourSummaries(nz.co.econz.nads.soap2.UserIDBean,%20java.util.Calendar,%20java.util.Calendar,%20boolean) getDetailedHourSummaries] method returns two rows for this scenario for easy daily overtime calculation. 
|---- bgcolor=#EDEDFF
|Array of [http://eservicewebtest.econz.com/SOAP/timecard_wsdl_doc.html#op.d1e1586 getDetailedHourSummariesWithRateCodeAndPremiumPay]
|getDetailedHourSummariesWithRateCodeAndPremiumPay
|[[UserIDBean]], start, end, showUserTZFlag
|Hourly breakdowns, adhering to the [[IDI]] specification, for all users in the given time period. Provided results include a customer specified rate code for the associated task/device combination as well as an indication as to whether Premium Pay is due. This method does not return an additional row if worker time covers two days(eg night shift). The [http://eservice.econz.co.nz/SOAP/timecardsoap1/nz/co/econz/nads/timecard1/Timecard1Soap.html#getDetailedHourSummaries(nz.co.econz.nads.soap2.UserIDBean,%20java.util.Calendar,%20java.util.Calendar,%20boolean) getDetailedHourSummaries] method returns two rows for this scenario for easy daily overtime calculation. 
|---- bgcolor=#EDEDFF
|Array of Strings
|[http://eservicewebtest.econz.com/SOAP/timecard_wsdl_doc.html#op.idm45578449000880 getUserTypes]
|[[UserIDBean]]
|Returns array of UserType Names (FYI - The 'Operations Manager' user type has a PK of 9).
|---- bgcolor=#EDEDFF
|Array of [[#OverTimeRuleBean | OverTimeRuleBean]]
|[http://eservice.econz.co.nz/SOAP/timecardsoap1/nz/co/econz/nads/timecard1/Timecard1Soap.html#getOvertimeRulesBean(nz.co.econz.nads.soap2.UserIDBean) getOvertimeRulesBean]
|[[UserIDBean]]
|Returns array of OverTimeRuleBean.
|}

=== Retrieving and updating Organisation Details ===

{| border=1
!Returns
!Method
!Parameters
!Description
|---- bgcolor=#EDEDFF
|[[#OrganisationDetailsBean | OrganisationDetailsBean]]
|[http://eservice.econz.co.nz/SOAP/timecardsoap1/nz/co/econz/nads/timecard1/Timecard1Soap.html#getOrganisationDetail(nz.co.econz.nads.soap2.UserIDBean) getOrganisationDetail]
|UserIDBean
|Returns all details from admin screen (including standard open hours).
|---- bgcolor=#EDEDFF
|updateOrganisationDetailResult
|[http://eservice.econz.co.nz/SOAP/timecardsoap1/nz/co/econz/nads/timecard1/Timecard1Soap.html#updateOrganisationDetail(nz.co.econz.nads.soap2.UserIDBean,%20nz.co.econz.nads.timecard1.OrganisationDetailsBean) updateOrganisationDetail]
|UserIDBean, [[#OrganisationDetailsBean | OrganisationDetailsBean]]
|Updates all details on admin screen (including standard open hours).
|}

=== Various Maintenance Functions ===

{| border=1
!Returns
!Method
!Parameters
!Description
|---- bgcolor=#EDEDFF
|sendMessageToUserResult
|[http://eservice.econz.co.nz/SOAP/timecardsoap1/nz/co/econz/nads/timecard1/Timecard1Soap.html#sendMessageToUser(nz.co.econz.nads.soap2.UserIDBean,%20java.lang.String,%20java.lang.String) sendMessageToUser]
|UserIDBean, userPrimaryKey, messageString
|Sends a string message to the specified user.
|---- bgcolor=#EDEDFF
|wakeFieldDeviceResult
|[http://eservice.econz.co.nz/SOAP/timecardsoap1/nz/co/econz/nads/timecard1/Timecard1Soap.html#wakeFieldDevice(nz.co.econz.nads.soap2.UserIDBean,%20java.lang.String) wakeFieldDevice]
|UserIDBean, userPrimaryKey
|Sends a message to the phone, which forces the application to start and connect to the server.
|---- bgcolor=#EDEDFF
|getTeamListResponse
|getTeamList
|UserIDBean
|Returns the list of teams.
|---- bgcolor=#EDEDFF
|createNewTeamResult
|[http://eservice.econz.co.nz/SOAP/timecardsoap1/nz/co/econz/nads/timecard1/Timecard1Soap.html#createNewTeam(nz.co.econz.nads.soap2.UserIDBean,%20java.lang.String,%20java.lang.String) createNewTeam]
|UserIDBean, teamName, teamLeaderUserPrimaryKey
|Creates a new team with the specified user as the team leader.
|---- bgcolor=#EDEDFF
|deleteTeamResult
|[http://eservice.econz.co.nz/SOAP/timecardsoap1/nz/co/econz/nads/timecard1/Timecard1Soap.html#deleteTeam(nz.co.econz.nads.soap2.UserIDBean,%20java.lang.String) deleteTeam]
|UserIDBean, teamName
|Deletes the specified team.  Members of this team should be reallocated to existing teams.
|---- bgcolor=#EDEDFF
|addUserToTeamResult
|[http://eservice.econz.co.nz/SOAP/timecardsoap1/nz/co/econz/nads/timecard1/Timecard1Soap.html#addUserToTeam(nz.co.econz.nads.soap2.UserIDBean,%20java.lang.String,%20java.lang.String) addUserToTeam]
|UserIDBean, teamName, userPrimaryKey
|Adds the specified user to the specified team.  Note that each user can only belong to one team.
|---- bgcolor=#EDEDFF
|removeUserFromTeamResult
|[http://eservice.econz.co.nz/SOAP/timecardsoap1/nz/co/econz/nads/timecard1/Timecard1Soap.html#removeUserFromTeam(nz.co.econz.nads.soap2.UserIDBean,%20java.lang.String,%20java.lang.String) removeUserFromTeam]
|UserIDBean, teamName, userPrimaryKey
|Removes the user from the team specified.
|---- bgcolor=#EDEDFF
|sendMessageToTeamResult
|[http://eservice.econz.co.nz/SOAP/timecardsoap1/nz/co/econz/nads/timecard1/Timecard1Soap.html#sendMessageToTeam(nz.co.econz.nads.soap2.UserIDBean,%20java.lang.String,%20java.lang.String) sendMessageToTeam]
|UserIDBean, teamName, messageString
|Sends a string message to all users in the specified team.
|---- bgcolor=#EDEDFF
|wakeTeamFieldDevicesResult
|[http://eservice.econz.co.nz/SOAP/timecardsoap1/nz/co/econz/nads/timecard1/Timecard1Soap.html#wakeTeamFieldDevices(nz.co.econz.nads.soap2.UserIDBean,%20java.lang.String) wakeTeamFieldDevices]
|UserIDBean, teamName
|Sends a message to all phone devices, which forces the application to start and connect to the server.
|---- bgcolor=#EDEDFF
|AddTasksToTeamResult
|addTasksToTeam
|UserIDBean, teamName, tasks
|Add a list of tasks to the given team.
|---- bgcolor=#EDEDFF
|DeleteTasksFromTeamResult
|deleteTasksFromTeam
|UserIDBean, teamName, tasks
|Remove a list of tasks from the given team.
|---- bgcolor=#EDEDFF
|AddSubTasksToTaskResult
|addSubTasksToTaskAndTeam
|UserIDBean, teamName, taskName, subTasks
|Add a list of subTasks to the given team's task.
|---- bgcolor=#EDEDFF
|DeleteSubTasksFromTaskResult
|deleteSubTasksFromTask
|UserIDBean, teamName, taskName, subTasks
|Delete a list of subTasks from the given team's task.
|---- bgcolor=#EDEDFF
|DeleteTasksFromAllTeamsResponse
|deleteTasksFromAllTeams
|UserIDBean, tasks
|Delete a list of tasks from all teams.
|---- bgcolor=#EDEDFF
|Array of strings
|getSubtasksForTaskAndTeam
|UserIDBean, teamName taskName
|Gets the sub tasks list from the server for a given task and team.
|---- bgcolor=#EDEDFF
|Array of strings
|getTasksForTeam
|UserIDBean, teamName
|Gets the tasks/customers list from the server for a given team.
|---- bgcolor=#EDEDFF
|Array of strings
|[http://eservice.econz.co.nz/SOAP/timecardsoap1/nz/co/econz/nads/timecard1/Timecard1Soap.html#getTaskList(nz.co.econz.nads.soap2.UserIDBean) getTaskList]
|UserIDBean
|Gets the tasks/customers list from the server.
|---- bgcolor=#EDEDFF
|AddNewTaskResult
|[http://eservice.econz.co.nz/SOAP/timecardsoap1/nz/co/econz/nads/timecard1/Timecard1Soap.html#addNewTask(nz.co.econz.nads.soap2.UserIDBean,%20java.lang.String) addNewTask]
|UserIDBean, taskName
|Adds a new task/customer to the server list.
|---- bgcolor=#EDEDFF
|AddNewTaskResult
|[[addTaskWithAddress]]
|UserIDBean, [[DetailedTaskWithAddress]]
|Adds a new task/customer to the server list with custom fields and address information included.
|---- bgcolor=#EDEDFF
|AddNewTaskResult
|[[addTaskForManager]]
|UserIDBean, managerPK, [[DetailedTaskWithAddress]]
|Adds a new task/customer to the server list (with custom fields and address information included) and associate it with the specified Manager's UserPK.
|---- bgcolor=#EDEDFF
|UpdateTaskResult
|[http://eservicewebtest.econz.com/SOAP/timecard_wsdl_doc.html#op.idm45927087877664 updateTaskManager]
|UserIDBean, taskName, managerPK
|Updates the 'TaskManager' (i.e. specifically a user who is a 'Manager' type) associated with the given Task (specified by the taskName).
|---- bgcolor=#EDEDFF
|UpdateTaskResult
|[[updateTaskStartEnd]]
|UserIDBean, taskID, start, end
|Sets/updates the time period visibility of the given task.  The task will be visible on mobile devices from the given start date to the given end date.
|---- bgcolor=#EDEDFF
|UpdateTaskResult
|[http://eservicewebtest.econz.com/SOAP/timecard_wsdl_doc.html#op.idm45927087880272 updateTaskDetails]
|UserIDBean, taskName, taskDetails
|Sets/updates the task details.
|---- bgcolor=#EDEDFF
|removeTaskResult
|[http://eservice.econz.co.nz/SOAP/timecardsoap1/nz/co/econz/nads/timecard1/Timecard1Soap.html#removeTask(nz.co.econz.nads.soap2.UserIDBean,%20java.lang.String) removeTask]
|UserIDBean, taskName
|Remove task/customer from the server.
|---- bgcolor=#EDEDFF
|UpdateTaskResult
|[http://eservicewebtest.econz.com/SOAP/timecard_wsdl_doc.html#op.idm45927087882816 renameTask]
|UserIDBean, oldTaskName, newTaskName
|Update the task/customer name.
|---- bgcolor=#EDEDFF
|addSubtaskToTask
|[http://eservice.econz.co.nz/SOAP/timecardsoap1/nz/co/econz/nads/timecard1/Timecard1Soap.html#addSubtaskToTask(nz.co.econz.nads.soap2.UserIDBean,%20java.lang.String,%20java.lang.String) addSubtaskToTask]
|UserIDBean, taskName, subTaskName
|Add a new subtask to an existing task in the server list.
|---- bgcolor=#EDEDFF
|addSubtasksToTask
|[http://eservice.econz.co.nz/SOAP/timecardsoap1/nz/co/econz/nads/timecard1/Timecard1Soap.html#addSubtasksToTask(nz.co.econz.nads.soap2.UserIDBean,%20java.lang.String,%20java.lang.String%5B%5D) addSubtasksToTask]
|UserIDBean, taskName, subTaskNames
|Add new list of subtasks to an existing task in the server list.
|---- bgcolor=#EDEDFF
|deleteSubtask
|[http://eservice.econz.co.nz/SOAP/timecardsoap1/nz/co/econz/nads/timecard1/Timecard1Soap.html#deleteSubtask(nz.co.econz.nads.soap2.UserIDBean,%20java.lang.String,%20java.lang.String) deleteSubtask]
|UserIDBean, taskName, subTaskName
|Remove subtask with the provided name from the task with the name provided from the server list.
|---- bgcolor=#EDEDFF
|getSubtaskList
|[http://eservice.econz.co.nz/SOAP/timecardsoap1/nz/co/econz/nads/timecard1/Timecard1Soap.html#getSubtaskList(nz.co.econz.nads.soap2.UserIDBean,%20java.lang.String) getSubtaskList]
|UserIDBean, taskName
|Get a list of subtasks for the task with the provided name from the server list.

|---- bgcolor=#EDEDFF
|setFieldWorkerUnionCode
|setFieldWorkerUnionCode
|UserIDBean, userPK, unionCode
|Associte the specified unionCode for the provided userPK. The unionCode specified needs to be defined in the [https://eserviceweb.econz.com/timecard/do/union/list Manage Unions Page] in the Timecard Website.
|---- bgcolor=#EDEDFF
|addRateCode
|addRateCode
|UserIDBean, userPK, taskName, rateCode
|Associate the specified rateCode for the provided userPK/taskName combination
|---- bgcolor=#EDEDFF
|deleteRateCode
|deleteRateCode
|UserIDBean, userPK, taskName
|Remove the rateCode specified for the provided userPK/taskName combination
|}

=== Main Data Type Definitions ===
 
==== EventBean ====

{| border=1
!Name
!Type
!Size
!Required
!Description
|---- bgcolor=#EDEDFF
|whenOccured
|[[Calendar]]
|N/A
|N/A
|The date and time at which a clock in, clock out, start break, end break start task or end task event occurred
|---- bgcolor=#EDEDFF
|eventID
|String
|9
|N/A
|Unique identifier for the event
|---- bgcolor=#EDEDFF
|eventType
|Enumerated String
|9
|N/A
|One of the following: CLOCK_IN, CLOCK_OUT, TASK_START, TASK_END, BREAK_START, BREAK_END.
|---- bgcolor=#EDEDFF
|userName
|String
|25
|N/A
|The name of the user who generated the event.
|---- bgcolor=#EDEDFF
|deviceID
|String
|30
|N/A
|Device ID of the user who generated the event (unique identifier for the device).
|---- bgcolor=#EDEDFF
|userPK
|String
|9
|N/A
|Unique identifier for the user.
|---- bgcolor=#EDEDFF
|userType
|String
|50
|N/A
|Describes the type of user.
|}

==== TaskEventBean extends EventBean ====

{| border=1
!Name
!Type
!Size
!Required
!Description
|---- bgcolor=#EDEDFF
|taskName
|String
|50
|N/A
|The task name associated with the TASK_START or TASK_END event.
|}

==== HourBreakdownBean ====

{| border=1
!Name
!Type
!Size
!Required
!Description
|---- bgcolor=#EDEDFF
|userType
|String
|50
|N/A
|Describes the type of user.
|---- bgcolor=#EDEDFF
|userName
|String
|25
|N/A
|The name of the user who generated the event.
|---- bgcolor=#EDEDFF
|deviceID
|String
|30
|N/A
|Device ID of the user who generated the event (unique identifier for the device).
|---- bgcolor=#EDEDFF
|userName
|String
|25
|N/A
|The name of the user who generated the event.
|---- bgcolor=#EDEDFF
|normalHours
|Int
|0-24
|N/A
|The hours component of a normal working day.
|---- bgcolor=#EDEDFF
|normalMinutes
|Int
|0-59
|N/A
|The minutes component of a normal working day.
|---- bgcolor=#EDEDFF
|normalSeconds
|Int
|0-59
|N/A
|The seconds component of a normal working day.
|---- bgcolor=#EDEDFF
|overTimeHours
|Int
|0-24
|N/A
|The hours component of overtime in excess of a normal working day.
|---- bgcolor=#EDEDFF
|overTimeMinutes
|Int
|0-59
|N/A
|The minutes component of overtime in excess of a normal working day.
|---- bgcolor=#EDEDFF
|overTimeSeconds
|Int
|0-59
|N/A
|The seconds component of overtime in excess of a normal working day.
|---- bgcolor=#EDEDFF
|extraHours
|Int
|0-24
|N/A
|The hours component of extra time in excess of overtime and the normal working day.
|---- bgcolor=#EDEDFF
|extraMinutes
|Int
|0-59
|N/A
|The minutes component of overtime in excess of overtime and the normal working day.
|---- bgcolor=#EDEDFF
|extraSeconds
|Int
|0-59
|N/A
|The seconds component of overtime in excess of overtime and the normal working day.
|}

==== DetailedHourBreakdownBean ====

{| border=1
!Name
!Type
!Size
!Required
!Description
|---- bgcolor=#EDEDFF
|userPrimaryKey
|String
|9
|N/A
|User Primary Key in Timecard.
|---- bgcolor=#EDEDFF
|userType
|String
|50
|N/A
|Describes the type of user.
|---- bgcolor=#EDEDFF
|userName
|String
|25
|N/A
|The name of the user who generated the event.
|---- bgcolor=#EDEDFF
|deviceID
|String
|30
|N/A
|Device ID of the user who generated the event (unique identifier for the device).
|---- bgcolor=#EDEDFF
|dateStart
|Date
|N/A
|N/A
|The date/time of the start event.
|---- bgcolor=#EDEDFF
|dateEnd
|Date
|N/A
|N/A
|The date/time of the end event.
|---- bgcolor=#EDEDFF
|timezone
|String
|25
|N/A
|The timezone of the user who generated the event.
|---- bgcolor=#EDEDFF
|startEvent
|String
|25
|N/A
|The start event type.
|---- bgcolor=#EDEDFF
|endEvent
|String
|25
|N/A
|The end event type.
|---- bgcolor=#EDEDFF
|teamName
|String
|50
|No
|The team name that the user belongs to.
|---- bgcolor=#EDEDFF
|taskName
|String
|50
|No
|The task that the event belongs to.
|---- bgcolor=#EDEDFF
|subtaskName
|String
|50
|No
|The subtask that the event belongs to.
|---- bgcolor=#EDEDFF
|normalHours
|Int
|0-24
|N/A
|The hours component of a normal working day.
|---- bgcolor=#EDEDFF
|normalMinutes
|Int
|0-59
|N/A
|The minutes component of a normal working day.
|---- bgcolor=#EDEDFF
|normalSeconds
|Int
|0-59
|N/A
|The seconds component of a normal working day.
|---- bgcolor=#EDEDFF
|overTimeHours
|Int
|0-24
|N/A
|The hours component of overtime in excess of a normal working day.
|---- bgcolor=#EDEDFF
|overTimeMinutes
|Int
|0-59
|N/A
|The minutes component of overtime in excess of a normal working day.
|---- bgcolor=#EDEDFF
|overTimeSeconds
|Int
|0-59
|N/A
|The seconds component of overtime in excess of a normal working day.
|---- bgcolor=#EDEDFF
|extraHours
|Int
|0-24
|N/A
|The hours component of extra time in excess of overtime and the normal working day.
|---- bgcolor=#EDEDFF
|extraMinutes
|Int
|0-59
|N/A
|The minutes component of overtime in excess of overtime and the normal working day.
|---- bgcolor=#EDEDFF
|extraSeconds
|Int
|0-59
|N/A
|The seconds component of overtime in excess of overtime and the normal working day.
|---- bgcolor=#EDEDFF
|customFields
|Array of [[#CustomField | CustomField]]
|N/A
|N/A
|The custom fields that are belong to this task.
|}

==== DetailedHourBreakdownBeanWithRateCode ====

{| border=1
!Name
!Type
!Size
!Required
!Description
|---- bgcolor=#EDEDFF
|userPrimaryKey
|String
|9
|N/A
|User Primary Key in Timecard.
|---- bgcolor=#EDEDFF
|userType
|String
|50
|N/A
|Describes the type of user.
|---- bgcolor=#EDEDFF
|userName
|String
|25
|N/A
|The name of the user who generated the event.
|---- bgcolor=#EDEDFF
|deviceID
|String
|30
|N/A
|Device ID of the user who generated the event (unique identifier for the device).
|---- bgcolor=#EDEDFF
|dateStart
|Date
|N/A
|N/A
|The date/time of the start event.
|---- bgcolor=#EDEDFF
|dateEnd
|Date
|N/A
|N/A
|The date/time of the end event.
|---- bgcolor=#EDEDFF
|timezone
|String
|25
|N/A
|The timezone of the user who generated the event.
|---- bgcolor=#EDEDFF
|startEvent
|String
|25
|N/A
|The start event type.
|---- bgcolor=#EDEDFF
|endEvent
|String
|25
|N/A
|The end event type.
|---- bgcolor=#EDEDFF
|teamName
|String
|50
|No
|The team name that the user belongs to.
|---- bgcolor=#EDEDFF
|taskName
|String
|50
|No
|The task that the event belongs to.
|---- bgcolor=#EDEDFF
|subtaskName
|String
|50
|No
|The subtask that the event belongs to.
|---- bgcolor=#EDEDFF
|normalHours
|Int
|0-24
|N/A
|The hours component of a normal working day.
|---- bgcolor=#EDEDFF
|normalMinutes
|Int
|0-59
|N/A
|The minutes component of a normal working day.
|---- bgcolor=#EDEDFF
|normalSeconds
|Int
|0-59
|N/A
|The seconds component of a normal working day.
|---- bgcolor=#EDEDFF
|overTimeHours
|Int
|0-24
|N/A
|The hours component of overtime in excess of a normal working day.
|---- bgcolor=#EDEDFF
|overTimeMinutes
|Int
|0-59
|N/A
|The minutes component of overtime in excess of a normal working day.
|---- bgcolor=#EDEDFF
|overTimeSeconds
|Int
|0-59
|N/A
|The seconds component of overtime in excess of a normal working day.
|---- bgcolor=#EDEDFF
|extraHours
|Int
|0-24
|N/A
|The hours component of extra time in excess of overtime and the normal working day.
|---- bgcolor=#EDEDFF
|extraMinutes
|Int
|0-59
|N/A
|The minutes component of overtime in excess of overtime and the normal working day.
|---- bgcolor=#EDEDFF
|extraSeconds
|Int
|0-59
|N/A
|The seconds component of overtime in excess of overtime and the normal working day.
|---- bgcolor=#EDEDFF
|rateCode
|String
|50
|N/A
|Customer specified Rate Code setup for the provided device & task combination.
|---- bgcolor=#EDEDFF
|customFields
|Array of [[#CustomField | CustomField]]
|N/A
|N/A
|The custom fields that are belong to this task.
|}
==== OverTimeRuleBean ====

{| border=1
!Name
!Type
!Size
!Required
!Description
|---- bgcolor=#EDEDFF
|userTypeAppliedTo
|String
|50
|N/A
|User type this is applied to.
|---- bgcolor=#EDEDFF
|startDate
|[[Calendar]]
|N/A
|N/A
|When the overtime rule starts
|---- bgcolor=#EDEDFF
|endDate
|[[Calendar]]
|N/A
|N/A
|When the overtime rule ends.  This may be null if there is no definite end date for the rule.
|---- bgcolor=#EDEDFF
|includeBreakInTimeWorked
|boolean
|N/A
|N/A
|Defines if break time should be included in time worked calulations
|---- bgcolor=#EDEDFF
|overTimeRule
|[[#OverTimeBean | OverTimeBean]]
|N/A
|N/A
|Which overtime rule
|---- bgcolor=#EDEDFF
|extraTimeRule
|[[#OverTimeBean | OverTimeBean]]
|N/A
|N/A
|Which extratime rule
|}

==== OverTimeBean ====

{| border=1
!Name
!Type
!Size
!Required
!Description
|---- bgcolor=#EDEDFF
|applicable
|boolean
|N/A
|N/A
|Determines if this overtime information is applicable or not.
|---- bgcolor=#EDEDFF
|hoursPerDay
|[[#HoursPeriodBean | HoursPeriodBean]]
|N/A
|N/A
|Defines the limit of normal work per day (anything over this is considered as a form of overtime or extratime).  
|---- bgcolor=#EDEDFF
|hoursPerWeek
|[[#HoursPeriodBean | HoursPeriodBean]]
|N/A
|N/A
|Defines the limit of normal work per week (anything over this is considered as a form of overtime or extratime).  
|}

==== HoursPeriodBean ====

{| border=1
!Name
!Type
!Size
!Required
!Description
|---- bgcolor=#EDEDFF
|applicable
|boolean
|N/A
|N/A
|Determines if this hours period information is applicable or not.
|---- bgcolor=#EDEDFF
|hours
|Int
|0-168
|N/A
|Number of hours in this period.
|---- bgcolor=#EDEDFF
|minutes
|Int
|0-59
|N/A
|Numberof minutes in this period.
|}

==== OrganisationDetailsBean ====

{| border=1
!Name
!Type
!Size
!Required
!Description
|---- bgcolor=#EDEDFF
|name
|String
|25
|N/A
|The name of the organisation.
|---- bgcolor=#EDEDFF
|description
|String
|50
|N/A
|The description of the organisation.
|---- bgcolor=#EDEDFF
|accountNumber
|String
|25
|N/A
|The account number of the organisation.
|---- bgcolor=#EDEDFF
|contactName
|String
|30
|N/A
|The name of the contact person for the organisation.
|---- bgcolor=#EDEDFF
|contactWorkPhone
|String
|30
|N/A
|The contact person's work number.
|---- bgcolor=#EDEDFF
|contactMobilePhone
|String
|30
|N/A
|The contact person's mobile number.
|---- bgcolor=#EDEDFF
|contactEmailAddress
|String
|30
|N/A
|The contact person's email address.
|---- bgcolor=#EDEDFF
|address1
|String
|200
|N/A
|Address line 1 for the organisation (street address)
|---- bgcolor=#EDEDFF
|address2
|String
|30
|N/A
|Address line 2 for the organisation (suburb/town)
|---- bgcolor=#EDEDFF
|address3
|String
|30
|N/A
|Address line 3 for the organisation (city)
|---- bgcolor=#EDEDFF
|address4
|String
|30
|N/A
|Address line 4 for the organisation (state/region)
|---- bgcolor=#EDEDFF
|locale
|String
|10
|N/A
|Locale of the organisation (made up of language, country and variant codes - see [http://java.sun.com/j2se/1.5.0/docs/api/java/util/Locale.html java doc] for more info)
|}

==== CustomField ====

{| border=1
!Name
!Type
!Size
!Required
!Description
|---- bgcolor=#EDEDFF
|name
|String
|25
|N/A
|Name of the custom field set up in timecard.
|---- bgcolor=#EDEDFF
|value
|String
|500
|N/A
|Value entered for the custom field.
|}