万师傅开放平台文档中心
  1. 下单
万师傅开放平台文档中心
  • 一、平台介绍
    • 平台介绍
  • 二、接入流程指引
    • 对接场景介绍
    • 物流类平台接入
    • ERP类平台接入
    • 电商类平台接入
    • 万师傅业务流程
    • 接口报错快速排查指南
  • 三、开发前必读
    • 万师傅名词说明
    • 版本更新说明
    • 1、申请授权秘钥
    • 2、API 接口参数规范
    • 3、API 签名
    • 4、目前支持的服务类目和类型
    • 5、接口 code 码
  • 四、开发接口列表
    • 最小化对接
      • 下单
        • 下单接口文档
        • 下单接口
          POST
        • 下单参数加密接口
          POST
      • 服务节点回传
        • 服务节点通知
    • 更多能力接口
      • 订单催服务
      • 商品库查询接口
      • 订单支付接口
      • 更改子用户角色接口
      • 订单费用调整相关接口
        • 总包订单费用调整原因查询接口
        • 子订单审核接口
        • 增加子费用
          • 订单新增费用接口
          • 增加子费用示例
      • 完工验收相关接口
        • 订单完工验收接口
      • 退款相关接口
        • 订单退费接口
        • 退款仲裁
          • 仲裁类别查询接口
          • 仲裁撤销接口
          • 仲裁提交证据接口
          • 仲裁申请接口
      • 关单相关接口
        • 关单审核接口
        • 订单关闭接口
        • 第三方工单申请接口
      • 投诉相关接口
        • 获取支持赔付的银行卡列表接口
        • 发起投诉接口
        • 撤销投诉接口
        • 获取投诉类别接口
        • 提交举证接口
        • 补充举证
        • 赔付收款渠道
        • 获取投诉详情
      • 物流相关接口
        • 物流到货信息更新接口
      • 订单信息查询相关接口
        • 费用明细查询接口
        • 查询师傅完工图接口
        • 订单子费用明细查询接口
        • 订单费用明细查询
      • 更多服务节点回传
        • 定时单服务节点通知
        • 总包调整费用节点通知(非最小化对接内容)
        • 仲裁节点通知
        • 费用调整原因列表数据更新节点通知
        • 保外维修单节点通知
        • 催单回复通知
        • 总包发起关单申请通知
        • 旧件寄回通知
        • 二次上门节点通知
        • 总包审核关单申请回传
        • 售后单处理通知
        • 一口价订单服务节点通知
        • 师傅与客户已通话节点通知
        • 师傅发起子订单状态回传
      • 售后单相关接口
        • 创建售后单接口
        • 拉取售后单接口
    • 测试环境查下订单服务节点
      • 查询订单服务节点
    • 用户信息相关接口
  1. 下单

下单接口

正式环境
https://openapi.wanshifu.com/user-open
正式环境
https://openapi.wanshifu.com/user-open
POST
/order/batchCreateAsync
快速体验下单接口
选择用例【快速下单体验接口】 -> 在环境变量中填写 licenseId, companySecret -> 点击运行 -> 点击发送可以快速体验下单接口
licenseId: 用于识别用户的身份
companySecret: 用于接口加密接口签名
PS:
需要注意, 本用例接口已通过前置脚本对参数进行加密. 请求时会自动将参数转换为接口参数, 对接时请求参数和加密方式参考下单接口文档

请求参数

Body 参数application/json

示例
[
  {
    "orderId": "{% mock 'timestamp' %}",
    "buyerWangwang": "测试客户旺旺号",
    "address": "测试环境,订单不允许发货",
    "buyerName": "181932",
    "buyerNote": "",
    "buyerPhone": "13812341234",
    "city": "深圳市",
    "contactName": "测试",
    "contactPhone": "18974777883",
    "county": "宝安区",
    "customArriveStatus": "2",
    "version": "v2",
    "goodsList": [
      {
        "goodsNumber": "1",
        "sku": "lj-test"
      }
    ],
    "isAutoAppoint": "1",
    "originShop": "测试",
    "province": "广东省",
    "serveCategory": 1,
    "spType": "enterprise",
    "toMasterId": "3946828213",
    "serveType": 4
  }
]

示例代码

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://openapi.wanshifu.com/user-open/order/batchCreateAsync' \
--header 'Content-Type: application/json' \
--data-raw '[
  {
    "orderId": "{% mock '\''timestamp'\'' %}",
    "buyerWangwang": "测试客户旺旺号",
    "address": "测试环境,订单不允许发货",
    "buyerName": "181932",
    "buyerNote": "",
    "buyerPhone": "13812341234",
    "city": "深圳市",
    "contactName": "测试",
    "contactPhone": "18974777883",
    "county": "宝安区",
    "customArriveStatus": "2",
    "version": "v2",
    "goodsList": [
      {
        "goodsNumber": "1",
        "sku": "lj-test"
      }
    ],
    "isAutoAppoint": "1",
    "originShop": "测试",
    "province": "广东省",
    "serveCategory": 1,
    "spType": "enterprise",
    "toMasterId": "3946828213",
    "serveType": 4
  }
]'

返回响应

🟢200成功
application/json
Body

示例
{
    "retCode": "200",
    "retData": 1,
    "retMsg": "成功"
}
🔴500服务器错误
修改于 2024-10-30 06:17:22
上一页
下单接口文档
下一页
下单参数加密接口
Built with