万师傅开放平台文档中心
  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/test/encodeNewV2

请求参数

Body 参数application/json

示例
{
    "licenseId": "C2s3SB8y",
    "dataJson": [
        {
            "address": "航城街道梧桐岛14B",
            "buyerName": "杨永桃",
            "buyerNote": "",
            "buyerPhone": "18996475571",
            "buyerWangwang": "",
            "city": "深圳市",
            "contactName": "1231",
            "contactPhone": "0571-81902717",
            "county": "宝安区",
            "customArriveStatus": "1",
            "expectArriveTime": "",
            "expectCompleteTime": "2025-08-29",
            "expectDoorOnTimeInterval": "08-10",
            "extraField": "",
            "extraParams": {
                "dataMask": "0",
                "openPlatAppSecret": "a8f2cccdba304583a4daac163c229800",
                "openPlatAppKey": "80000005566"
            },
            "floorNum": 0,
            "goodsList": [
                {
                    "goodsPrice": "100",
                    "generalAttributesOne": "{\"FourthProductionCategoryName\":\"书桌\",\"SecondProductionCategoryName\":\"简装\",\"FirstProductionCategoryName\":\"板木\",\"ThirdProductionCategoryName\":\"桌类\"}",
                    "goodsNumber": 2,
                    "sku": "cesshangp",
                    "goodsName": "LS690V1-A",
                    "goodsImgUrl": "http://lsmy-devimage.oss-cn-shenzhen.aliyuncs.com/image/2024-06-23/917d022997134b9a97e7b30d2ea7c139_LSC22SZ001039.jpg",
                    "generalAttributes": "{\"FirstProductionCategoryCode\":\"BM\",\"ThirdProductionCategoryCode\":\"S006\",\"IsNeedInstallation\":\"是\",\"FourthProductionCategoryCode\":\"F108\",\"SecondProductionCategoryCode\":\"M020\"}",
                    "detectionContent": "检测内容描述1111111111111111111","goodsSpecification":"1117字板"
                }
            ],
            "hasLift": "y",
            "isAutoAppoint": "0",
            "isLogisticsArrived": 1,
            "logisticsCompany": "中通快递",
            "logisticsNo": "77113588428206",
            "needStrict": 0,
            "orderId": "723{% mock 'natural', 1, 99999999 %}",
            "originShop": "",
            "overrideDefault": false,
            "packNumber": "1",
            "payLcsfee": 0,
            "payMethod": 1,
            "pickupAddress": "",
            "pickupPhone": "18712341234",
            "province": "广东省",
            "isRateReward": true,
            "receiverAddress": "航城街道梧桐岛14B",
            "receiverName": "11一一",
            "receiverPhone": "13567855674",
            "returnNote": "配件商品名称",
            "salesAmount": 0.00,
            "salesman": "",
            "serialNumber": "2349319863057657243",
            "serveCategory": 1,
            "serveType": 5,
            "spType": "enterprise",
            "subAccount": "",
            "subscribeLogistic": "1",
            "toMasterId": 4957974691,
            "version": "v4",
            "urgentFee": 30,
            "rateRewardType": "1",
            "returnGoodsPreLcsfee": "30"
        }
    ]
}

示例代码

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/test/encodeNewV2' \
--header 'Content-Type: application/json' \
--data-raw '{
    "licenseId": "C2s3SB8y",
    "dataJson": [
        {
            "address": "航城街道梧桐岛14B",
            "buyerName": "杨永桃",
            "buyerNote": "",
            "buyerPhone": "18996475571",
            "buyerWangwang": "",
            "city": "深圳市",
            "contactName": "1231",
            "contactPhone": "0571-81902717",
            "county": "宝安区",
            "customArriveStatus": "1",
            "expectArriveTime": "",
            "expectCompleteTime": "2025-08-29",
            "expectDoorOnTimeInterval": "08-10",
            "extraField": "",
            "extraParams": {
                "dataMask": "0",
                "openPlatAppSecret": "a8f2cccdba304583a4daac163c229800",
                "openPlatAppKey": "80000005566"
            },
            "floorNum": 0,
            "goodsList": [
                {
                    "goodsPrice": "100",
                    "generalAttributesOne": "{\"FourthProductionCategoryName\":\"书桌\",\"SecondProductionCategoryName\":\"简装\",\"FirstProductionCategoryName\":\"板木\",\"ThirdProductionCategoryName\":\"桌类\"}",
                    "goodsNumber": 2,
                    "sku": "cesshangp",
                    "goodsName": "LS690V1-A",
                    "goodsImgUrl": "http://lsmy-devimage.oss-cn-shenzhen.aliyuncs.com/image/2024-06-23/917d022997134b9a97e7b30d2ea7c139_LSC22SZ001039.jpg",
                    "generalAttributes": "{\"FirstProductionCategoryCode\":\"BM\",\"ThirdProductionCategoryCode\":\"S006\",\"IsNeedInstallation\":\"是\",\"FourthProductionCategoryCode\":\"F108\",\"SecondProductionCategoryCode\":\"M020\"}",
                    "detectionContent": "检测内容描述1111111111111111111","goodsSpecification":"1117字板"
                }
            ],
            "hasLift": "y",
            "isAutoAppoint": "0",
            "isLogisticsArrived": 1,
            "logisticsCompany": "中通快递",
            "logisticsNo": "77113588428206",
            "needStrict": 0,
            "orderId": "723{% mock '\''natural'\'', 1, 99999999 %}",
            "originShop": "",
            "overrideDefault": false,
            "packNumber": "1",
            "payLcsfee": 0,
            "payMethod": 1,
            "pickupAddress": "",
            "pickupPhone": "18712341234",
            "province": "广东省",
            "isRateReward": true,
            "receiverAddress": "航城街道梧桐岛14B",
            "receiverName": "11一一",
            "receiverPhone": "13567855674",
            "returnNote": "配件商品名称",
            "salesAmount": 0.00,
            "salesman": "",
            "serialNumber": "2349319863057657243",
            "serveCategory": 1,
            "serveType": 5,
            "spType": "enterprise",
            "subAccount": "",
            "subscribeLogistic": "1",
            "toMasterId": 4957974691,
            "version": "v4",
            "urgentFee": 30,
            "rateRewardType": "1",
            "returnGoodsPreLcsfee": "30"
        }
    ]
}'

返回响应

🟢200成功
application/json
Body

示例
{}
修改于 2025-07-24 06:13:52
上一页
下单接口
下一页
服务节点通知
Built with