purchasereturn/history
目录 |
1.接口说明
1.1接口描述
查看采购退货单审批进程
执行审批动作前，需要保证审批人已经进行 ERP 登录授权，登录接口请参考 user/login_v2 。
1.2适用版本
支持U8V12.0 及更高版本
2.使用场景
业务流程应用
3.接口调用说明
3.1请求说明
| url | https://api.yonyouup.com/api/purchasereturn/history |
| 格式 | JSON |
| https请求方式 | GET |
| 编码类型 | UTF-8 |
3.2url参数说明
| 参数 | 是否必填 | 类型 | 描述 |
|---|---|---|---|
| from_account | 是 | string | 调用方id |
| to_account | 是 | string | 提供方id |
| app_key | 是 | string | 应用编码 |
| token | 是 | string | 全局访问唯一识别码 |
| ds_sequence | 否 | number | 数据源序号（默认取应用的第一个数据源） |
| user_id | 否 | string | 审批人(用户编码)，user_id与pserson_code输入一个参数即可 |
| person_code | 否 | string | 审批人(人员编码)，可以通过 api/person 获取。user_id与pserson_code输入一个参数即可 |
| voucher_code | 是 | string | 单据编号 |
3.3请求示例
GET https://api.yonyouup.com/api/purchasereturn/history?from_account=openapi_dev&to_account=openapi_ent&app_key=opa6fdd4bea98b95ad7&token=843d03f66e6544e19707ccec11030296&person_code=00001&voucher_code=0000000248&ds_sequence=1
3.4返回参数说明
| 参数说明 | 类型 | 参数路径 | 描述 |
|---|---|---|---|
| errcode | string | 错误码，0 为正常。 | |
| errmsg | string | 错误信息。 | |
| auditTime | date | 审核时间 | |
| action | number | 类型(0=提交,1=同意,2=不同意,3=转签,4=打回,5=撤销,6=退回,7=弃审,8=打回后重新提交,9=没有任务项未作处理,10=变更审批) | |
| opinion | string | 审批意见 | |
| taskName | string | 任务名称 | |
| operator | string | 审批人 |
3.5正确返回示例
JSON示例:
application/json;charset=UTF-8
{
"errcode":"0",
"errmsg":"",
"history":[
{
"action":1,
"auditTime":"2015-12-910:24:45",
"operator":"王铭",
"opinion":"ww",
"taskName":"王铭提交的销售订单0000000249已进入审批流，等待您的审批！"
},
{
"action":0,
"auditTime":"2015-12-816:02:40",
"operator":"王铭",
"opinion":"",
"taskName":"提交审批"
}
]
}
3.6错误返回示例
application/json;charset=UTF-8
{
"errcode" : "30021",
"errmsg" : "此应用未上线"
}