1. LTC 回款审批
微伴助手OpenAPI
  • LTC 回款审批
    • 处理回款审批
      POST
    • 回款重新提交审批
      POST
默认模块LTC回款
默认模块LTC回款
  1. LTC 回款审批

处理回款审批

测试中
POST
/open-api/ltc/returned_money/audit/update
由回款单当前指定审批人执行通过或不通过。回款审批是单审批人流程,不传 module、audit_node_number 或 images。操作员工还必须保留企业当前回款审批配置权限。passed 的 comment 可选,传入时归一化并保存;audit_failed 的 comment 必填。

幂等规则#

幂等键为 corp_id + operation(returned_money_audit_update) + request_id。归一化 comment 属于幂等内容。POST 超时不自动重试;调用方必须使用原 request_id 和完全相同的业务参数重试。

错误码#

错误码含义
10001access_token 未设置、错误或过期
10049参数格式、组合或请求体校验失败
22402操作员工无效或没有 LTC 席位
22403回款单不存在或不属于当前企业
22408同一 operation + request_id 的业务参数不同
22409相同幂等请求正在处理中
22414LTC 服务暂不可用
22415LTC 内部处理异常或响应不符合契约
22416LTC 服务契约版本不受支持
22418回款单当前状态不允许审批
22419非当前指定审批人或审批权限已移除
22420回款审批人、配置、关联订单或流转结果异常

请求参数

Query 参数

Body 参数application/json必填

示例
仅传公开字段;超时重试使用完全相同的 request_id 和业务参数。
{
  "request_id": "ltc-return-audit-20260806-001",
  "returned_money_id": "1592417885008389571",
  "operator_staff_id": "ReturnAuditor",
  "update_type": "audit_failed",
  "comment": "资料不完整"
}

请求示例代码

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --globoff '/open-api/ltc/returned_money/audit/update?corp_id=1653682321878942721&access_token=' \
--header 'Content-Type: application/json' \
--data '{
  "request_id": "ltc-return-audit-20260806-001",
  "returned_money_id": "1592417885008389571",
  "operator_staff_id": "ReturnAuditor",
  "update_type": "audit_failed",
  "comment": "资料不完整"
}'

返回响应

🟢200成功
application/json
HTTP 状态通常为 200,请以 errcode 判断业务结果。errcode=0 表示成功。
Bodyapplication/json

示例
{
    "errcode": 0,
    "errmsg": "ok",
    "data": {
        "request_id": "ltc-return-audit-20260806-001",
        "returned_money_id": "1592417885008389571",
        "audit_status": "audit_failed",
        "auditor_staff_ext_id": "ReturnAuditor",
        "idempotent_replay": false
    }
}
修改于 2026-08-07 08:53:36
下一页
回款重新提交审批
Built with