1. LTC 订单与回款
微伴助手OpenAPI
  • OpenAPI基本介绍
  • 错误码参考表
  • 访问频率和并发限制
  • 消息订阅
    • 订阅消息加解密指南
    • 回调应用配置指南
    • 工单变更消息
      • 工单变更消息回调
      • 创建工单回调
      • 流转工单回调
      • 关闭工单回调
      • 重新打开工单回调
      • 评论工单回调
  • 获取访问凭据
    • 获取访问凭据
      POST
  • 员工管理
    • 获取员工列表
      GET
    • 获取员工详情
      GET
    • 发送员工通知
      POST
  • 自定义订单管理
    • 订单信息删除
      GET
    • 获取订单信息列表
      GET
    • 批量同步店铺信息
      POST
    • 批量同步商品信息
      POST
    • 批量同步订单信息v2
      POST
    • 批量删除商品信息
      POST
    • 删除店铺信息
      GET
    • 批量删除订单信息
      POST
    • 获取店铺信息详情
      POST
    • 获取店铺信息列表
      GET
    • 获取商品信息详情
      POST
    • 获取商品信息列表
      GET
  • 客户管理
    • 获取客户列表
    • 根据更新时间获取客户列表
    • 获取客户详情
    • 获取流失提醒客户列表
    • 导入客户信息
    • 添加客户评分
    • 添加自定义字段
    • 批量预设客户属性
    • 批量修改自定义字段的值
    • 创建批量加好友任务(批量创建添加客户任务)
    • 批量unionid&openid换external_user_id
    • external_user_id换unionid
    • unionid&openid换客户id
    • 获取客户自定义字段值列表
    • 批量获取客户详情
    • 获取批量加好友待添加列表
    • 批量转换客户 external_userid
  • 客户积分管理
    • 批量增减客户积分
    • 批量获取客户积分
    • 获取单个客户积分明细记录
    • 获取全部客户积分明细记录
  • 客户标签管理
    • 获取标签列表
    • 批量更新客户企业标签
    • 给客户添加企业标签
    • 删除客户的企业标签
    • 给客户添加微伴个人标签
    • 删除客户的微伴个人标签
    • 获取预打标签信息
    • 批量预打企业标签
    • 根据手机号删除预打标签任务
    • 根据unionid删除预打标签任务
    • 获取指定用户预打标签任务详情
    • 获取预打标签任务列表
    • 添加预打标签任务
  • 客户画像管理
    • 获取客户事件列表
    • 创建自定义客户事件
    • 获取自定义客户事件类型列表
    • 获取自定义客户事件类型详情
    • 添加自定义客户事件类型
    • 删除自定义客户事件类型
    • 更新自定义客户事件类型
    • 获取客户阶段状态
  • 标签库管理
    • 获取标签列表V2
    • 获取指定标签信息
    • 新增企业标签组
    • 新增企业标签
    • 删除企业标签
    • 更新企业标签
    • 同步企业微信标签
  • 群聊管理
    • 获取群聊列表
    • 获取群聊成员列表
    • 获取客户所在群聊
    • 查看客户是否在群聊中
    • 获取群聊详情
  • 工单管理
    • 工单模块OpenAPI开发必读
    • 获取工单列表
    • 获取工单详情
    • 获取工单流内处理人
    • 获取工单模板列表
    • 获取工单模板详情
    • 新建工单
    • 修改工单
    • 流转工单
    • 评论工单
    • 关闭工单
  • 销售过程管理
    • 获取商机列表
    • 获取商机详情
    • 修改商机阶段
    • 获取线索公海列表
    • 批量导入线索
    • 修改线索
    • 获取线索列表
    • 员工单条/批量领取线索
    • 获取线索客户列表
    • 获取线索客户详情
    • 获取跟进记录列表
  • 聊天记录管理
    • 获取会话消息
    • 获取会话消息2(按照消息时间逆序)
    • 获取员工会话
  • 拉新排行榜
    • 获取拉新排行榜列表
  • 群裂变
    • 获取群裂变活动列表
    • 获取群裂变任务详情
    • 获取群裂变客户详情列表
  • 群打卡
    • 获取群打卡活动列表
    • 获取群打卡任务详情
  • 企微任务宝
    • 获取企微任务宝活动列表
    • 获取企微任务宝任务详情
    • 获取企微任务宝对应的客户数据列表
    • 获取客户对应的企微任务宝数据列表
  • 拉新排行榜
    • 获取拉新排行榜活动列表
  • 自定义表单
    • 获取自定义表单列表
    • 自定义表单用户与表单关系列表
    • 自定义表单提交数据详情列表
    • 获取自定义表单分组列表
  • 客户转化
    • 批量新增手机线索转化
  • 员工个人群发记录管理
    • 获取员工个人群发记录列表
    • 获取员工个人群发记录结果列表
  • 渠道码管理
    • 获取渠道码列表
    • 获取渠道码加人数据
    • 根据指定日期获取渠道活码添加明细
  • 素材库管理
    • 获取素材库列表
    • 获取素材库标签列表
    • 新增素材
    • 更新素材
    • 删除素材
    • 新建素材分组
    • 修改素材分组
    • 添加素材库标签
    • 删除素材库标签
    • 删除素材分组
    • 素材分组列表
  • 互动雷达管理
    • 获取雷达列表
    • 获取雷达详情
    • 添加雷达
    • 修改雷达
    • 删除雷达
    • 上传file
    • 获取雷达分组列表
    • 获取雷达客户访问记录
  • 自定义侧边栏身份校验
    • 侧边栏模块化-自定义卡片功能说明
    • 自定义侧边栏Code校验
  • 有赞订单管理
    • 获取有赞订单
  • 小鹅通订单管理
    • 获取小鹅通TOKEN
  • 项目管理
    • 项目列表
  • 门店信息
    • 批量导入门店
    • 批量更新门店
    • 门店列表
  • 人群包
    • 人群包列表获取
    • 创建人群包
    • 更新人群包
    • 创建的人群包中添加数据
    • 获取人群包数据详情
  • 客户群发
    • 客户群发创建
    • 群发任务列表
    • 群群发详情获取
    • 员工群发结果
    • 客户群群发创建
    • 员工-群群发结果
    • 获取群发错误unionid/extid
  • 企微朋友圈
    • 企微朋友圈创建
    • 企微朋友圈任务列表
    • 企微朋友圈任务发表详情
  • 个人SOP
    • 个人SOP列表
    • 个人SOP详情-规则列表
    • 个人SOP详情-执行记录
  • 部门管理
    • 获取部门列表
  • 群标签管理
    • 获取群聊标签分组及其子列表
    • 群聊批量打标签
  • 话术库
    • 企业话术分组列表
    • 企业话术列表
  • 企微数据专区
    • 获取会话消息(企微数据专区)
  • 锁客二维码
    • 锁客二维码通过state获取详细信息
    • 根据客户unionid查询客户添加的锁客二维码渠道信息
  • 门店活码
    • 获取门店活码配置列表
    • 获取门店活码下的门店列表
    • 获取门店活码客户记录列表
  • 席位管理
    • 查询席位关系列表
  • LTC 订单与回款
    • 用于将未提交或审批未通过的 LTC 订单重新提交至审批流程首节点
      POST
    • 处理回款审批
      POST
    • 回款重新提交审批
      POST
    • 查询订单列表
      GET
    • 查询订单详情
      GET
    • 查询订单创建字段配置
      GET
    • 创建订单
      POST
    • 审批通过订单
      POST
    • 查询产品列表
      GET
    • 查询回款单列表
      GET
    • 查询回款单详情
      GET
    • 创建回款单
      POST
  • 新老分流码
    • 创建新老分流码
    • 更新新老分流码
    • 查询新老分流码列表
    • 查询新老分流码详情
  • 自动拉群
    • 查询群二维码自动拉群任务
  • 员工 ID 转换
    • 企微明文 userid 转换为密文 open_userid
  • 客户关系导出
    • 触发客户关系 V3 异步导出
    • 查询客户关系导出任务状态
  • 数据模型
    • CreateNewOldContactWayRequest
    • ConversionRequest
    • UpdateNewOldContactWayRequest
    • ConversionItem
    • NewOldContactWayWriteRequest
    • ConversionSuccess
    • OldUserConfigRequest
    • BusinessError
    • LinkMsgData
    • MiniProgramMsgData
    • PosterMsgData
    • StaffMsgData
    • NewUserConfigRequest
    • Creator
    • StaffSummary
    • DepartmentSummary
    • GroupSummary
    • OldUserConfigResponse
    • NewUserTarget
    • NewUserConfigResponse
    • NewOldContactWayDetail
    • DetailSuccessResponse
    • NewOldContactWayListItem
    • ListSuccessResponse
    • AutoJoinGroupListItem
    • AutoJoinGroupListSuccessResponse
    • ErrorResponse
  1. LTC 订单与回款

创建回款单

POST
/open-api/ltc/returned_money/create
创建一张未提交审批的回款单,成功时 audit_status 固定为 unsubmitted。
鉴权:使用 Apifox 项目现有的全局 Query 参数 access_token。调用方需有该企业的有效 OpenAPI 令牌。
客户:buyer_type=contact 时仅传 buyer_id,值必须是 /open-api/contact/list 返回对象的 contact_id,而不是该对象的 id;buyer_type=external_user 时必传 buyer_ext_id,可另传与其一致的 buyer_id。
幂等:同一企业、操作、request_id 和请求内容可重放,重放时 idempotent_replay=true。写入超时后使用原 body 和原 request_id 重试;同键不同内容返回 22408。
关联订单:relation_orders 可省略;若传入,金额合计必须等于回款金额,订单须与客户及企业匹配。
回款凭证:payment_receipt_list 中的文件须由调用方先上传到可公开访问的对象存储,传入 HTTPS URL。
常见业务错误码:10049 参数错误;20101 无 corp_id 访问权限;22402 操作员工无效或无席位;22403 客户或资源不存在;22408 幂等冲突;22409 请求正在处理;22412 客户、员工或关联资源关系无效;22413 金额无效;22414 LTC 服务不可用;22415 响应不符合契约;22420 回款创建后的状态异常;22422 回款单参数校验失败。业务错误仍使用 HTTP 200,具体结果看 errcode。

请求参数

Query 参数

Body 参数application/json必填

示例
{
    "request_id": "erp-return-001",
    "operator_staff_id": "staff-1",
    "buyer_type": "contact",
    "buyer_id": "123",
    "returned_time": 1784800000,
    "amount": "50.00",
    "payer": "客户企业",
    "returned_money_way": "银行转账",
    "remark": "7月回款",
    "organization_id": "789",
    "relation_orders": [
        {
            "order_id": "456",
            "amount": "50.00"
        }
    ],
    "payment_receipt_list": [
        "https://example.com/receipt.png"
    ]
}

请求示例代码

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
cURL
curl --location --globoff 'https://open.weibanzhushou.com/open-api/ltc/returned_money/create?corp_id=1846560065709985793&access_token=' \
--header 'Content-Type: application/json' \
--data '{
    "request_id": "erp-return-001",
    "operator_staff_id": "staff-1",
    "buyer_type": "contact",
    "buyer_id": "123",
    "returned_time": 1784800000,
    "amount": "50.00",
    "payer": "客户企业",
    "returned_money_way": "银行转账",
    "remark": "7月回款",
    "organization_id": "789",
    "relation_orders": [
        {
            "order_id": "456",
            "amount": "50.00"
        }
    ],
    "payment_receipt_list": [
        "https://example.com/receipt.png"
    ]
}'

返回响应

🟢200
application/json
接口结果。errcode=0 表示创建成功;非 0 为业务错误。
Bodyapplication/json

示例
{
    "errcode": 0,
    "errmsg": "ok",
    "data": {
        "request_id": "erp-return-001",
        "returned_money_id": "60001",
        "returned_union_id": "60002",
        "audit_status": "unsubmitted",
        "idempotent_replay": false
    }
}
修改于 2026-10-29 07:21:27
上一页
查询回款单详情
下一页
创建新老分流码
Built with