下单接口

快速体验下单接口
选择用例【快速下单体验接口】 -> 在环境变量中填写 licenseId, companySecret -> 点击运行 -> 点击发送可以快速体验下单接口

licenseId: 用于识别用户的身份
companySecret: 用于接口加密接口签名

PS:
需要注意, 本用例接口已通过前置脚本对参数进行加密. 请求时会自动将参数转换为接口参数, 对接时请求参数和加密方式参考下单接口文档

请求参数

Body 参数application/json

array of:

orderId

string

第三方订单号

必需

保证唯一性

serveCategory

integer

订单服务类目

必需

订单服务类目: 家具: 1 灯具: 2 卫浴: 4 浴霸: 12 智能锁: 15 晾衣架: 17 窗帘: 18

serveType

integer

订单服务类型

必需

订单服务类型: 送货到楼下：1 送货到家：2 送货到家并安装：3 安装：4 维修：5 返货：6

spType

string

指派类型

必需

指派类型
master 师傅
enterprise 总包

toMasterId

number

指派总包服务商ID

可选

如果是直接指派师傅或总包模式需要传该值

buyerName

string

客户姓名

必需

buyerPhone

string

客户手机号

必需

手机号校验规则: （^1[3456789][0-9]{9}$）

province

string

客户地址省份

必需

示例: 如广东省

city

string

客户地址市级

必需

示例: 深圳市

county

string

客户地址县（区）级

必需

示例: 宝安区

address

string

客户详细地址

必需

除省市区外的地址

goodsList

array [object {9}]

goodsList 商品列表

必需

一个订单可以有多个商品

goodsNumber

string

商品数量

可选

goodsName

string

商品型号

可选

sku

string

sku

可选

对应商品图库中的型号, 如果使用sku模型,下单前需要在商品图库添加对应型号的商品

needSku

string

是否使用 sku 模式

可选

true 需要 false 不需要(默认值)

goodsNote

string

特殊要求、故障描述【维修类型】

可选

serveType=5 该字段必传

goodsImgUrl

string

商品图片地址

可选

serveType=5 该字段必传

goodsId

string

第三方商品id

可选

不采用图库映射时必传

goodsVideoUrl

string

第三方商品视频url

可选

如果需要附带视频，万师傅一个商品只接收一个视频

isUseCustomImage

boolean

SKU模式是否使用自定义商品图片

可选

true: 使用自定义图片 false: 不使用自定义图片(默认)

version

string

版本号

必需

版本号: 固定 v3

subAccount

string

子账号登录名

可选

isAutoAppoint

integer

是否自动指派

可选

是否自动指派（1：是、0：否[默认]）在公开报价模式，自动指派指在平台发布订单，平台会自动分配一位服务商

isRateReward

boolean

是否需要好评返现

可选

true 需要 false 不需要

expectCompleteTime

string

期望服务商完工时间

可选

期望服务商完工时间（yyyy-MM-dd）

buyerNote

string

客户备注

可选

originShop

string

来源店铺

可选

buyerWangwang

string

客户旺旺号

可选

contactName

string

商家联系人姓名

必需

手机号校验规则: （^1[3456789][0-9]{9}$）,支持400电话

contactPhone

string

商家联系人手机号

必需

contactName2

string

备用商家联系人姓名

可选

contactPhone2

string

备用商家联系人手机号

可选

手机号校验规则: （^1[3456789][0-9]{9}$）,支持400电话

subscribeLogistic

integer

是否订阅物流信息

可选

是否订阅物流信息（物流轨迹和自动提醒师傅到货功能）（1：订阅、 0：不订阅[默认]）默认只支持安装类型

extraField

string

通用字段

可选

最大长度 100 个字符

checkRepeatOrder

integer

是否校验在（三个月内）下单历史是否存在相同的客户信息的订单

可选

是否校验在（三个月内）下单历史是否存在相同的客户信息的订单（判断依据为客户姓名+电话+地址），存在则会下单失败

extraParams

string

扩展参数

可选

key: value 的形式 key由对接平台自定义示例: { "params1":"value" }

expectDoorOnTimeInterval

string

期待上门时间段为每2小时的一个时间段

可选

期待上门时间段为每2小时的一个时间段，并且只能选择如下的时间段之一传参：06-08，08-10，10-12，12-14，14-16,16-18,18-20，20-22

expectDoorOnTimeAwardFee

number

准时上门奖励金额

可选

logisticsNo

string

物流运单号

可选

serveType=1,2,3 该参数为必传字段

clearanceType

string

核销类型，不传视为不需要核销

可选

serveType=1,2,3,4 该参数为必传字段

clearanceNo

string

核销单号，多个用英文逗号隔开

可选

serveType=1,2,3,4 该参数为必传字段

customArriveStatus

string

货物是否到客户家

可选

（1 已到货，2 未到货） serveType=4 该参数为必传字段

isLogisticsArrived

string

货物是否到物流签收点

可选

（1 已到货，2 未到货）serveType=1,2,3 该参数为必传字段

pickupAddress

string

提货物流地址

可选

serveType=1,2,3 该参数为必传字段

pickupPhone

string

提货电话

可选

serveType=1,2,3 该参数为必传字段

packNumber

string

包装件数

可选

serveType=1,2,3 该参数为必传字段

expectArriveTime

string

预计到货时间

可选

expectArriveTime 预计到货时间（yyyy-MM-dd） serveType=1,2,3 该参数为必传字段

payLcsfee

string

代付运费金额

可选

serveType=1,2,3 该参数为必传字段

receiverName

string

返货物流签收人姓名

可选

serveType=6 该参数为必传字段

receiverPhone

string

返货物流签收人电话

可选

serveType=6 该参数为必传字段

receiverAddress

string

返货物流收货地址

可选

serveType=6 该参数为必传字段

logisticsCompany

string

返货物流公司名

可选

serveType=6 该参数为必传字段

insuredAmount

string

报价金额

可选

报价金额（不保价填 0） serveType=6 该参数为必传字段

deliveryMode

string

送货方式

可选

送货方式（送货上门：1，物流点自提：2） serveType=6 该参数为必传字段

needPack

string

是否需要师傅自带包装

可选

needPack 是否需要师傅自带包装（不需要：0，需要：1） serveType=6 该参数为必传字段

needWoodpack

string

是否需要打木架

可选

是否需要打木架（不需要：0，需要：1） serveType=6 该参数为必传字段

needMasterpack

string

是否需要师傅打包

可选

是否需要师傅打包（不需要：0，需要：1） serveType=6 该参数为必传字段

payMethod

string

付费方式

可选

付费方式（下单方到付：1，师傅代付：2） serveType=6 该参数为必传字段

hasLift

string

客户家是否有电梯

可选

客户家是否有电梯 y有，n无 serveType=2,3,6 该参数为必传字段

floorNum

string

楼层高度

可选

(无电梯时必填) serveType=2,3,6 该参数为必传字段

示例

[
  {
    "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

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

application/json

Body

retCode

string

状态码

必需

200 表示成功

retData

string

数据

必需

接口返回数据

retMsg

string

消息

必需

错误消息

示例

{
    "retCode": "200",
    "retData": 1,
    "retMsg": "成功"
}

请求参数

示例代码

返回响应