结算中单据驳回接口
说明
在任何一张支付单没有标记为已支付的状态下,可以调用本接口进行支付驳回操作。
- 若该单据有多人收款情况,且部分支付流水状态为支付中/已支付,则不支持支付驳回。
- 若该单据的流水为支付中,则不支持支付驳回。
- 支付驳回后,将会回到草稿状态,可以由提单人编辑/删除/重新提交。
接口地址
报销单: /api/openapi/settle/reject/reimburse
借款单: /api/openapi/settle/reject/loan
请求方式
POST
请求参数
请求参数说明
参数名称 | 参数类型 | 长度 | 是否必填 | 默认值 | 备注 |
---|---|---|---|---|---|
formCode | string | 50 | Y | 无 | 单据编号 |
reason | string | 4000 | Y | 无 | 驳回原因 |
employeeId | string | 50 | Y | 无 | 驳回操作人工号 |
reSubmitMode | string | 枚举 | Y | 无 | 驳回方式: 默认驳回 "SUBMIT_NORMALLY" 驳回直达 "SUBMIT_TO_PREV_APPROVER" |
请求参数示例
{
"formCode": "FORM001",
"reason": "驳回原因",
"employeeId": "USER001",
"reSubmitMode": "SUBMIT_NORMALLY"
}
响应参数
响应参数说明
参数名称 | 参数类型 | 备注 |
---|---|---|
code | string | ACK 或者 NACK |
message | string | 消息 |
data | object | 当code为ACK的时候为null,当code为NACK的时候,会给出具体的错误详情 |
success | bool | 是否成功 |
data响应参数说明
参数名称 | 参数类型 | 备注 |
---|---|---|
errorCode | string | 具体错误编码,PAYING_REJECT_ERROR: 单据已部分支付,不允许驳回。COMMON_ERROR:其他类型错误 |
errorMessage | string | 具体错误消息 |
响应参数
成功响应示例
{
"code": "ACK",
"message": "成功",
"data":null,
"success": true
}
异常响应示例
{
"code": "NACK",
"message": "该单据支付未完成,无法驳回",
"data": {
"errorCode": "PAYING_REJECT_ERROR",
"errorMessage": "单据已部分支付,不允许驳回"
},
"success": false
}
更新日志:
2023-01-11 王晓阳更新