Skip to main content
_id
string

An identity that is automatically generated as a technical identification of a task.

organizationId
string

The identity of the organizational account where the task was created and processed.

flowId
string

Identity of a flow that is used in the task creation process, (supporting data in identifying flows).

hubId
string

Unique ID to identify a hub.

flow
string

The flow name used in making a task, refers to the existing flow in the organization. When creating a task, you cannot use the flow with the name Handover because it has been used as a reserved key.

organization
object

Organization Entity Information: Encompasses the organization's name, email, and ID. This information is present in the task data upon task creation and processing.

hub
object

Information of hub entity : contains hub name, hub id, coordinates.

title
string

The value of a task is used as the Title of the task, which will appear on task pages on the web and apps.

content
string

The value of a task is used as a Content, which will appear on task pages on the web and in apps.

label
string

The value of a task is used as a Label, which will appear on task pages on the web and in apps.

status
string

Status that describes the process of a task: Unassigned : Tasks that have been created but have not been assigned to the user field Ongoing : Tasks that have been assigned to the user field and are in progress Done : Tasks that have been completed by the user field.

assignee
string[]

List of email that has been assigned the task.

assignedTo
object

Detail information of assignee : contains field user name, email, hub, organization and user role.

assignedBy
string

Email that assigned the task.

assignedTime
string<date-time>

Date and time when the task is assigned.

startTime
string<date-time>

The initial time for working on a task that can be set by the admin user when the task is created.

endTime
string<date-time>

The deadline for completing tasks that can be set by the admin user when the task is created.

updatedTime
string<date-time>

Information of time when the task was last updated.

updatedBy
string

information about the user who last modified a task. It provides details about the user who made the most recent update to the task, typically including their email address.

createdBy
string

Email that created the task.

createdFrom
string

Identify where the task was created from: WEB, API, Automation, Mobile.

createdTime
string<date-time>

Date and time when the task is created.

doneBy
string

Email that processed the task until it is done.

doneCoordinate
number

Coordinate where the task is done.

doneTime
string<date-time>

Date and time when the task is finished.

doneFrom
string

Identify where the task was done from: WEB, MOBILE, System (for sample data).

openTaskTime
string<date-time>

openTaskTime is data when the task was last opened when it was still ongoing.

waitingTime
integer

Time provided (in minute) for a vehicle to wait before start travelling to the next visit.

travelDuration
number

The travelDuration is calculated as the time taken to travel between two consecutive visits and is measured in minutes. It is obtained by subtracting the doneTime of the current visit from the doneTime of the previous visit in the optimized route.

duration
integer

The duration in this context is also measured in minutes and represents the time taken to complete a particular visit or task. It is calculated by subtracting the doneTime of the current visit from th page1DoneTime of the same visit. This calculation allows us to determine the time it took to complete the specific task or visit, starting from when it was initiated (page1DoneTime) until it was marked as completed (doneTime).

distance
integer

Estimated vehicle mileage (in meter).

eta
string

Estimated Time Of Arrival at the destination.

etd
string

Estimated Time of Departure before start travelling to the next visit.

assignedVehicleId
string

The Unique ID is used to mark a vehicle during route optimization to ensure that the visit associated with this vehicle ID remains assigned to the same vehicle in the subsequent optimization route and does not get randomly assigned to another vehicle.

assignedVehicle
object

The purpose of marking a vehicle on a successfully optimized visit is to ensure that the visit can be assigned to the same vehicle in the next optimizer route.

routePlannedOrder
integer

The routePlannedOrder serves as the key to identify that a visit has been successfully optimized within a specific route. It also helps to determine the order of that visit within the optimized route.

idleDuration
integer

idleDuration is the total duration of the idle user while working on a task, the user is considered idle when the speed is less than 3 km/h

expectedCoordinate
string

Coordinates used in MileField to display routes on google maps.

expectedDoneTime
string

Timestamp for expectation done time for the task.

createdCoordinate
string

Coordinate where the task is created.

useGeoLock
boolean

A flag used to indicate whether a task employs geolock or not. Geolock is a feature that restricts task access based on predefined geographic locations and radius. When useGeoLock is set to true, it means that the task uses geolock to limit access based on the task's specified geographic parameters.

geoLock
object

Define geolocation-based access restrictions for tasks. It is an array of objects that contain information about allowed locations and their corresponding radius. Tasks are accessible only when accessed from within the specified locations and within the defined radius. If an attempt is made to access the task from outside the allowed area, access will be denied.

geoLockTrigger
string

The identifier for geolock usage is triggered when a task begins or when a task is completed.

refId
string

Task reference identity that involves multiple flows.

idLocal
string

Id / Identity of a task created by mobile.

orderIndex
number

By default this number is generated based on the task created time in epoch format, orderIndex is used to define the order of this Task in the Task list. User can define it by number value.

isSample
boolean

An identifier is used to distinguish whether this task is sample data or user-generated real data.

histories
object[]

History identity when a task was created, modified, or deleted.

deviceInformation
object[]

An information about device that used by user for complete the task.

routingResultId
string

This key is related to the Cross Docking configuration. When a user dispatches the result, a handover task is generated for the Sub Hub. This key serves to distinguish the Handover task from other tasks within MileApp.

parentTaskId
string

This key is associated with the Auto Split configuration. If the routing result suggests a visit that needs to be split into two or more visits, upon dispatch, we generate the split tasks. The parentTaskId signifies the main task that has been split.

autoSplit
string

This key indicates the type of Auto Split used, which can be either Equal or Maximize. It indicates the method employed for splitting tasks.

splitNumber
string

This key identifies the segment of the split task, corresponding to the Auto Split configuration. It helps in tracking the divided tasks effectively. Example: 1/2, 2/2

useVisitGroup
string

A flag indicating whether the routing optimization considers visits within the same group. This ensures that visits within the same group are assigned to the same vehicle and prioritized sequentially.

visitGroup
string

This key indicates that visits belong to the same group if they are set to the same name. The routing solution will suggest assigning visits with the same group to the same vehicle.

visitGroupPriority
string

Priority ranges from 0 to 100, with the default value set to 0. A lower number indicates a higher priority compared to other visits within the same group.

vehicleSubHubDistanceLimit
string

This key stores the value of the maximum distance a vehicle sub hub can travel. It is related to cross docking.

doneOrder
integer

Generated when the task done for flagging the sequence of completed tasks.

isLastDoneOrder
boolean

Generated when the task done for flagging the latest completed task.

inLocation
string

Generated when user enter the range (50m) of task coordinates. This feature activated when task has geoloc feature.

outLocation
string

Generated when user out the range (50m) of task coordinates after inLocation recorded.

travelDistance
string

This key depends on doneOrder key, generated when task done by calculating distance between done tasks and distance between Hub to task if done order is 1