1.1 接口说明

根据工单模板ID、工单编号、客户ID、手机号、时间范围等条件，分页查询工单记录列表。支持查询进行中或已完结的工单。

1.2 调用形式

https://ykf.uincall.com/openapi/workorder/record/list?tenant_id={tenant_id}&access_token={access_token}

1.3 调用方式

POST

1.4 传入参数

非必填参数，调用接口时请传递参数名，参数值可为空

序号 名称 类型 是否必填 说明
1 workflow_id String 否 工作流模板ID
2 transaction_id String 否 工单编号
3 customer_id String 否 客户id
4 mobile String 否 手机号
5 start String 是 查询开始时间（格式：YYYY-MM-DD HH:mm:ss） 注：传了工单编号或者客户id这个参数不必填，不传则必填
6 end String 是 查询结束时间（格式：YYYY-MM-DD HH:mm:ss） 注：传了工单编号或者客户id这个参数不必填，不传则必填
7 page Integer 是 当前页码，从0开始
8 size Integer 是 每页记录数，范围1-100

1.5 回应参数

序号 名称 类型 是否必填 说明
1 errcode Number 是 状态码：0成功，及其他非0错误码，详见错误码列表
2 errmsg String 是 状态说明
3 data Object 是 分页数据对象
3.1 current Integer 是 当前页码
3.2 total Integer 是 总记录数
3.3 pages Integer 是 总页数
3.4 records Array 是 工单记录列表
records 数组内字段
3.4.1 customer_id String 是 客户ID
3.4.2 transaction_id String 是 工单编号
3.4.3 truename String 是 客户名称
3.4.4 flow_name String 是 工单模板名称
3.4.5 workflow_id String 是 工单模板ID
3.4.6 process_instance_id String 是 流程实例ID
3.4.7 priority Integer 是 优先级：0-高，1-中，2-低
3.4.8 create_time String 是 创建时间（YYYY-MM-DD HH:mm:ss）
3.4.9 end_time String 否 完结时间，未完结时为null
3.4.10 is_suspended Boolean 是 是否暂存工单
3.4.11 is_finish Boolean 是 是否完结
3.4.12 create_agent_data Object 是 创建人信息
create_agent_data.num String 是 座席工号
create_agent_data.name String 是 座席名称
create_agent_data.id String 是 座席ID
3.4.13 due_date String 否 节点过期时间（YYYY-MM-DD HH:mm:ss）
3.4.14 assignee String 否 当前审批人
3.4.15 parent_assignee String 否 上一步审批人
3.4.16 version Integer 是 工单版本
3.4.17 workflow_record_id String 是 工单记录ID
3.4.18 session_infos Array 是 关联通话信息列表
session_infos[].session_id String 是 通话ID
session_infos[].time String 是 通话时间（YYYY-MM-DD HH:mm:ss）
3.4.19 histories Array 是 工单历史节点列表
histories 数组内字段
id String 是 历史记录ID
form Object 否 表单信息
form.rows Array 是 表单字段列表
rows[].val Object 是 字段值（类型根据kind变化，如字符串、数组、数字等）
rows[].kind Integer 是 字段类型（(0-文本，1-多行文本，2-单选，3-多选，4-选择，5-日期，6-时间，7-数字，8-附件，9-单选（多级联动））
rows[].id String 是 字段ID
rows[].title String 是 字段名称
approve String 否 审批意见/结果
task_id String 否 任务ID
activity_name String 否 节点名称
activity_type String 否 节点类型（如：startEvent、endEvent、userTask、exclusiveGateway）
start_time String 是 节点开始时间
end_time String 否 节点结束时间
due_date String 否 节点到期时间
assignee String 否 节点审批人
assign_history Array 是 转审记录列表
assign_history[].id String 是 转审记录ID
assign_history[].assign_agent_name String 是 操作座席名称
assign_history[].assign_agent_num String 是 操作座席编号
assign_history[].assign_at String 是 转审时间（YYYY-MM-DD HH:mm:ss）
assign_history[].assign_out_name String 是 转出座席名称
assign_history[].assign_out_num String 是 转出座席编号
assign_history[].assign_in_name String 是 转入座席名称
assign_history[].assign_in_num String 是 转入座席编号

1.6 使用样例

调用：

url：url：https://ykf.uincall.com/openapi/workorder/record/list?tenant_id=acf528a2-d0e2-4a7b-8513-74cb399xxxxx&access_token=670253572927b24acffc41078ddxxxxx

post数据：

JSON
{
  "workflow_id": "",
  "transaction_id": "",
  "customer_id": "",
  "mobile": "",
  "start": "2026-05-01 00:00:00",
  "end": "2026-05-23 23:59:59",
  "page": 0,
  "size": 10
}

响应：

JSON
{
    "errcode": 0,
    "errmsg": "success",
    "data": {
        "current": 0,
        "total": 1,
        "pages": 1,
        "records": [
        {
            "customer_id": "0003bf085f2043d7843dc070e35391c7",        //客户ID
            "transaction_id": "1779261728402",        //工单编号
            "truename": "测试客户备注3",        //客户名称
            "flow_name": "自己审批",        //工单模板名称
            "workflow_id": "5fa639b726c615313e535fda49007919",        //工单模板ID
            "process_instance_id": "9c4ff892-541c-11f1-a4b3-000c29cb18f1",        //流程实例ID
        "priority": 2,        //优先级 0高1中2低
        "create_time": "2026-05-20 15:22:08",        //创建时间
        "end_time": null,        //完结时间
        "is_suspended": false,        //是否暂存工单
        "is_finish": false,                //是否完结
        "create_agent_data": {        //创建人
            "num": "1008",        //座席工号
            "name": "1008",        //座席名称
            "id": "8dd17d73b771a05aa8178ba5b82307e5"        //座席ID
        },
        "due_date": "2026-05-21 09:53:08",        //节点过期时间
        "assignee": "座席1006（1006）",                //当前审批人
        "parent_assignee": "座席1006（1006）",        //上一步审批人
        "version": 2,        //工单版本
        "workflow_record_id": "cd0349c01c63eefb2cce0083c6e35f79",        //工单记录ID
        "session_infos": [        //关联通话信息
            {
                "session_id": "170bd550-21a8-11f1-aeff-07d466482299",        //通话ID
                "time": "2026-03-17 10:25:10"        //通话时间
            }
                        ],        
        "histories": [        //工单历史
            {
                "id": "bbd3c03b-541c-11f1-a4b3-000c29cb18f1",        //ID
                "form": {        //表单信息
                    "rows": [
                        {
                            "val": "123",        //字段值
                            "kind": 7,        //类型
                            "id": "db585cbc-69d6-4280-bd26-62f7c272b554",        //字段ID
                            "title": "数字"        //字段名称
                        }
                    ]
                },        
                "approve": null,        //审批信息
                "task_id": "bbd3e74c-541c-11f1-a4b3-000c29cb18f1",        //任务ID
                "activity_name": "发起人确认",        //节点名称
                "activity_type": "userTask",        //节点类型
                "start_time": "2026-05-20 15:23:01",        //节点开始时间
                "end_time": null,        //节点结束时间
                "due_date": null,        //节点到期时间
                "assignee": "座席1006（1006）",                //节点审批人
                "assign_history": [                //转审记录
                    {
                        "id": "9d3f683d07594383beabe3903fe4faa4",        //ID 
                        "assign_agent_name": "座席1006（1006）",        //操作座席名称
                        "assign_agent_num": "1006",                //操作座席编号
                        "assign_at": "2026-05-22 10:48:49",                //转审时间
                        "assign_out_name": "1008",        //转出座席名称
                        "assign_out_num": "1008",        //转出座席编号
                        "assign_in_name": "座席1006（1006）",        //转入座席名称
                        "assign_in_num": "1006"                //转入座席编号
                    }
                ]
            },
            {
                "id": "9c7ef7e7-541c-11f1-a4b3-000c29cb18f1",
                "form": {
                    "rows": [
                        {
                            "val": "123",
                            "kind": 7,
                            "id": "db585cbc-69d6-4280-bd26-62f7c272b554",
                            "title": "数字"
                        }
                    ]
                },
                "approve": null,
                "task_id": "9c7f1ef8-541c-11f1-a4b3-000c29cb18f1",
                "activity_name": "审批人",
                "activity_type": "userTask",
                "start_time": "2026-05-20 15:22:08",
                "end_time": "2026-05-20 15:23:01",
                "due_date": "2026-05-20 17:13:08",
                "assignee": "杨玉江（1006）",
                "assign_history": []
            },
            {
                "id": "9c5046ba-541c-11f1-a4b3-000c29cb18f1",
                "form": {
                    "rows": [
                        {
                                "val": "123",
                                "kind": 0,
                                "id": "0f02cc76-8a40-4c1e-ab43-5924e6a17db5",
                                "title": "名称"
                            },
                            {
                                "val": [
                                    "T60 Neo S"
                                ],
                                "kind": 4,
                                "id": "9c3e92cc-305c-48d1-81b3-0f04baa4fe48",
                                "title": "选择"
                            },
                            {
                                "val": "123",
                                "kind": 7,
                                "id": "db585cbc-69d6-4280-bd26-62f7c272b554",
                                "title": "数字"
                            },
                            {
                                "val": "2026-05-06 00:00:00",
                                "kind": 6,
                                "id": "4587212e-b18f-41a4-81e9-522760a9f12f",
                                "title": "时间"
                            }
                        ]
                    },
                    "approve": null,
                    "task_id": "9c5046bb-541c-11f1-a4b3-000c29cb18f1",
                    "activity_name": "创建",
                    "activity_type": "userTask",
                    "start_time": "2026-05-20 15:22:08",
                    "end_time": "2026-05-20 15:22:08",
                    "due_date": null,
                    "assignee": "1008",
                    "assign_history": []
                },
                {
                    "id": "9c5046b9-541c-11f1-a4b3-000c29cb18f1",
                    "form": null,
                    "approve": null,
                    "task_id": null,
                    "activity_name": null,
                    "activity_type": "startEvent",
                    "start_time": "2026-05-20 15:22:08",
                    "end_time": "2026-05-20 15:22:08",
                    "due_date": null,
                    "assignee": null,
                    "assign_history": []
                }
            ]
        }
        ]
    }
}
文档更新时间: 2026-05-26 11:08   作者：admin