1. LTC 订单与回款
微伴助手OpenAPI
  • LTC 订单与回款
    • 查询订单列表
      GET
    • 查询订单详情
      GET
    • 查询订单创建字段配置
      GET
    • 创建订单
      POST
    • 审批通过订单
      POST
    • 查询产品列表
      GET
    • 查询回款单列表
      GET
    • 查询回款单详情
      GET
默认模块默认模块
默认模块默认模块
  1. LTC 订单与回款

审批通过订单

测试中
POST
/open-api/ltc/order/audit/pass
由当前审批节点的审批人通过订单。调用前应先查询订单详情,读取最新 audit_status 和 audit_node_number,不能缓存旧节点长期使用。
中间节点通过时返回 pending_review、下一节点序号和 approval_completed=false;最终节点通过时返回 passed、audit_node_number=null 和 approval_completed=true。

幂等规则#

幂等键为 corp_id + operation(order_audit_pass) + request_id。超时重试必须复用原 request_id、order_id、节点、操作人和规范化后的 comment。

通用错误码#

错误码含义
10001access_token 未设置、错误或过期
10045limit 超过最大值 50
10046offset 非法或超出范围
10047limit 不是正整数
10048时间参数不是 10 位秒级或 13 位毫秒级时间戳
10049参数格式、组合、枚举或请求体校验失败
22401企业未开通对应的 LTC OpenAPI 能力
22403订单、商品、回款等资源不存在或不属于当前企业
22414LTC 服务暂不可用
22415LTC 内部处理异常或响应不符合契约
22416LTC 服务契约版本不受支持

审批专用错误码#

错误码含义
22402操作员工无效或没有 LTC 席位
22404订单当前状态不允许审批,例如已经审批完成
22405operator_staff_id 不是当前节点审批人
22406audit_node_number 已过期或不是当前节点
22407审批节点或流转结果数据异常
22408同一 operation + request_id 已成功,但本次业务参数不同
22409相同幂等请求正在处理中,可稍后使用原请求重试

请求参数

Query 参数

Body 参数application/json必填

示例
{
  "request_id": "ltc-order-audit-20260730-001",
  "order_id": "240052099",
  "audit_node_number": 1,
  "operator_staff_id": "SuMao",
  "comment": "同意\n审批通过"
}

请求示例代码

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --globoff 'https://open.weibanzhushou.com/open-api/ltc/order/audit/pass?access_token=' \
--header 'Content-Type: application/json' \
--data '{
  "request_id": "ltc-order-audit-20260730-001",
  "order_id": "240052099",
  "audit_node_number": 1,
  "operator_staff_id": "SuMao",
  "comment": "同意\n审批通过"
}'

返回响应

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

示例
{
    "errcode": 0,
    "errmsg": "ok",
    "data": {
        "request_id": "ltc-order-audit-20260730-001",
        "order_id": "240052099",
        "audit_status": "passed",
        "previous_node_number": 1,
        "audit_node_number": null,
        "approval_completed": true,
        "idempotent_replay": false
    }
}
修改于 2026-07-30 07:39:54
上一页
创建订单
下一页
查询产品列表
Built with