This API finalizes a task within a work order. With this web service, you can set the task's start and end dates, failure information, and/or whether the asset was out of service.

This API is part of the ADVANCED APIS add-on

Body Parameters

Parameter	Type	Required	Description
`id_work_order_task`	Text	Yes	Task ID within the work order
`initial_date`	Text	Yes	Task start date in the format 'YYYY-MM-DDTHH:MM:SS-UTC', for example, '2016-07-12T20:00:00-03'. If the timezone format is not provided, the date will be assumed to be in UTC-0
`final_date`	Text	Yes	Task end date in the format 'YYYY-MM-DDTHH:MM:SS-UTC', for example, '2016-07-12T20:00:00-03'. If the timezone format is not provided, the date will be assumed to be in UTC-0
`real_duration`	Number	No	Time in seconds of the actual task duration
`is_done`	Boolean	No	True: if the task is completed False: if the task is not finished, this value is set by default if no value is sent
`code_account`	Text	Yes	Human resource code
`asset_failure`	Boolean	Optional	Value indicating whether the asset failed. False by default
`failure_type`	Text	Optional	Failure description
`failure_cause`	Text	Optional	Description of the failure cause
`failure_detection_method`	Text	Optional	Description of the failure detection method
`id_failure_severity`	Number	Optional	Failure severity ID 1: Very Low 2: Low 3: Medium 4: High 5: Very High
`id_damage_type`	Number	Optional	Type of damage caused: 1: None 2: Environmental damage 3: Facility damage 4: Internal personnel injuries 5: Third-party injuries 6: Other
`asset_out_of_service`	Boolean	Optional	Value to indicate if the task has an associated out-of-service period. False by default
`date_asset_out_of_service`	Date	Optional	Start date of the out-of-service period in the format 'YYYY-MM-DDTHH:MM:SS-UTC', for example, '2016-07-12T20:00:00-03'. If the timezone format is not provided, the date will be assumed to be in UTC-0

Output Parameters

Parameter	Type	Description
`id`	Number	Task ID associated with the work order
`id_work_order`	Number	Work order ID
`id_item_log`	Number	Item log ID associated with the task
`done`	Boolean	Description of the meter unit. Applies when it's a meter-type subtask
`units_code`	Text	Meter unit code. Applies when it's a meter-type subtask
`order_number`	Number	Position in which the subtask is displayed
`is_required`	Boolean	Whether the subtask is mandatory
`wo_folio`	Text	Work order ID
`creation_date`	Text	Work order creation date
`initial_date`	Text	Task initial date
`final_date`	Text	Task final date
`id_status_work_order`	Number	Work order status
`id_task_form_item_type`	Number	Subtask type

Example:

Request: (PUT)https://app.fracttal.com/api/work_orders_tasks/1776531

{
    "initial_date":"2020-06-29T20:00:00-05",
    "final_date":"2020-06-30T08:00:00-05",
    "real_duration":40000,
    "is_done":"true",
    "code_account":"7845123",
    "asset_failure": "true",
    "failure_type":"API FAILURE",
    "failure_cause":"API FAILURE CAUSE",
    "failure_detection_method":"API FAILURE DETECTION METHOD",
    "id_failure_severity": 3,
    "id_damage_type":1,
    "asset_out_of_service": "true"
}

{
    "success": true,
    "message": "200",
    "data": {
        "id": 1776531,
        "id_company": 69,
        "id_work_order": 633665,
        "id_item_log": 408,
        "id_task_log": 463106,
        "done": true,
        "last_date_maintenance": "2020-11-18T20:59:38.578043+00:00",
        "cal_date_maintenance": "2020-11-18T21:00:14.151688+00:00",
        "date_maintenance": "2020-11-18T21:00:14.151688+00:00",
        "trigger_description": "NO_SCHEDULE_TASK",
        "duration": 600,
        "id_task_trigger": null,
        "initial_date": "2020-06-30T01:00:00+00:00",
        "final_date": "2020-06-30T13:00:00+00:00",
        "real_duration": 40000,
        "stop_assets_sec": 0,
        "real_stop_assets_sec": 0,
        "id_items_availability": null
    },
    "total": 1
}

TEST CONNECTION