purchaseorder/tasks
目录 |
1.接口说明
1.1接口描述
获取采购订单待办任务
1.2适用版本
支持U8V12.0 及更高版本
2.使用场景
业务流程应用
3.接口调用说明
3.1请求说明
| url | https://api.yonyouup.com/api/purchaseorder/tasks |
| 格式 | JSON |
| https请求方式 | GET |
| 编码类型 | UTF-8 |
3.2url参数说明
| 参数 | 是否必填 | 类型 | 描述 |
|---|---|---|---|
| from_account | 是 | string | 调用方id |
| to_account | 是 | string | 提供方id |
| app_key | 是 | string | 应用编码 |
| token | 是 | string | 全局访问唯一识别码 |
| ds_sequence | 否 | number | 数据源序号（默认取应用的第一个数据源） |
| page_index | 否 | string | 页号 |
| rows_per_page | 否 | string | 每页行数 |
| person_code | 否 | string | 审批人(人员编码)，可以通过 api/person 获取 |
| user_id | 否 | string | 审批人用户编码 |
| state | 否 | string | 状态(0=待审;2=审批完成) |
| task_type_begin | 否 | number | 起始类型值(1=正常;4=退回;5=退回到提交人) |
| task_type_end | 否 | number | 结束类型值(1=正常;4=退回;5=退回到提交人) |
| task_desc | 否 | string | 描述 |
| submitter_code_begin | 否 | number | 起始发起人编码 |
| submitter_code_end | 否 | number | 结束发起人编码 |
| submitter_name | 否 | string | 发起人名称关键字 |
3.3请求示例
GET https://api.yonyouup.com/api/purchaseorder/tasks?from_account=openapi_dev&to_account=openapi_ent&app_key=opa6fdd4bea98b95ad7&token=843d03f66e6544e19707ccec11030296&person_code=00001&ds_sequence=1
3.4返回参数说明
| 参数说明 | 类型 | 参数路径 | 描述 |
|---|---|---|---|
| errcode | string | 错误码，0 为正常。 | |
| errmsg | string | 错误信息。 | |
| account_id | string | 帐套号 | |
| state | number | 状态(0=待审;2=审批完成) | |
| task_type | number | 类型(1=正常;4=退回;5=退回到提交人) | |
| last_time | date | 上一次审批时间 | |
| person_code | string | 审批人编码 | |
| person_name | string | 审批人 | |
| user_id | string | 审批人用户编码 | |
| voucher_code | string | 单据号 | |
| start_time | date | 流程发起时间 | |
| task_desc | string | 描述 | |
| submitter_code | string | 发起人编码 | |
| submitter_name | string | 发起人 |
3.5正确返回示例
JSON示例:
application/json;charset=UTF-8
{
"page_index":"1",
"rows_per_page":"10",
"row_count":"1",
"errmsg":"",
"errcode":"0",
"page_count":"1",
"tasks":{
"account_id":"999",
"person_name":"冯建国",
"state":"0",
"task_type":"1",
"last_time":"2015-12-1716:56:58.183",
"task_desc":"王铭提交的采购订单0000000057已进入审批流，等待您的审批！",
"voucher_code":"0000000057",
"start_time":"2015-12-1716:56:58.447",
"user_id":"leaf",
"person_code":"00002"
}
}
3.6错误返回示例
application/json;charset=UTF-8
{
"errcode" : "30021",
"errmsg" : "此应用未上线"
}