文档中心 > API类目 > 淘宝小时达履约

qimen.alibaba.xsd.logistics.order.create (配送正式下单)

配送正式下单

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
stationId String 可选 Station001 服务商配送站编码 门店发单该值必填
deliveryOrderNo String 必须 80002024101009 淘宝近场运力单号
deliveryType Number 必须 0 配送类型(0 门店发单,1 点对点发单)
deliveryOrderType Number 必须 0 运单类型(0 正向单,1 逆向单)
expectTimeMode Number 必须 0 送达时效类型 (0 即时单 1预约单)
preCreatedId String 可选 Order001 预下单标识 为null不校验配送费价格直接入单 不为null强校验配送费价格 与入参价格不一致拒绝入单
serialNo String 必须 6 订单小号
expectFetchTime Number 必须 1728379194000 期望取货时间,毫秒级时间戳
expectFetchEndTime Number 可选 1728379194000 期望取货最晚时间,毫秒级时间戳
expectReceiveTime Number 可选 1728379194000 期望送达时间,毫秒级时间戳 正向单该值必填
remark String 可选 放在门口 订单备注
sender DeliveryOrderSender 可选 发货人信息 点对点发单该值必填
  • └ senderName
  • String
  • 可选
  • 李四
  • 发货人姓名
  • └ senderPhone
  • String
  • 可选
  • 13789560890,0778
  • 发货人电话(示例 13789560890,0778)
  • └ senderAddress
  • String
  • 可选
  • xx省xx市xx区xx街道xx单元
  • 发货人地址
  • └ senderLat
  • String
  • 可选
  • 120.13
  • 发货人纬度(高德坐标数据),格式如120.13
  • └ senderLng
  • String
  • 可选
  • 120.13
  • 发货人经度(高德坐标数据),格式如120.13
  • └ prov
  • String
  • 可选
  • 330600
  • 省编码
  • └ city
  • String
  • 可选
  • 110621
  • 市编码
  • └ area
  • String
  • 可选
  • 392109
  • 区编码
  • └ town
  • String
  • 可选
  • 4021
  • 镇编码
  • └ provName
  • String
  • 可选
  • 浙江省
  • 省名称
  • └ cityName
  • String
  • 可选
  • 杭州市
  • 市名称
  • └ areaName
  • String
  • 可选
  • 西湖区
  • 区名称
  • └ townName
  • String
  • 可选
  • 康桥街道
  • 镇名称
receiver DeliveryOrderReceiver 必须 收货人信息
  • └ receiverName
  • String
  • 必须
  • 张三
  • 收货人姓名
  • └ receiverPhone
  • String
  • 必须
  • 13789560890,0778
  • 收货人电话(示例:13789560890,0778)
  • └ receiverAddress
  • String
  • 必须
  • xx区xx街道xx单元
  • 收货人地址
  • └ receiverLng
  • String
  • 必须
  • 120.13
  • 收货人纬度(高德坐标数据)
  • └ receiverLat
  • String
  • 必须
  • 120.13
  • 收货人经度(高德坐标数据)
  • └ prov
  • String
  • 可选
  • 330600
  • 省编码
  • └ city
  • String
  • 可选
  • 110621
  • 市编码
  • └ area
  • String
  • 可选
  • 392109
  • 区编码
  • └ town
  • String
  • 可选
  • 4021
  • 镇编码
  • └ provName
  • String
  • 可选
  • 浙江省
  • 省名称
  • └ cityName
  • String
  • 可选
  • 杭州市
  • 市名称
  • └ areaName
  • String
  • 可选
  • 西湖区
  • 区名称
  • └ townName
  • String
  • 可选
  • 康桥街道
  • 镇名称
goodsTotalAmount Number 必须 14500 订单原金额,单位:分
goodsActualAmount Number 必须 12500 订单用户实付金额,单位:分
goodsTotalWeight Number 必须 5000 商品总重量,单位:g
categoryId String 必须 30001 订单类目ID
isInsure Boolean 必须 false 是否保价单
fetchCode String 可选 4519 取件码,用于保价订单,骑手与商家交接
signCode String 可选 3001 签收码,用于保价订单,骑手与用户交接
returnCode String 可选 7865 退货码,用于保价订单,售中拦截骑手将货物退回到门店时,商家提供退货码
saleOrderId String 可选 300314101910 交易单号(不唯一,可再次呼叫)
timeMode Number 可选 1 时效类型 0 当日达 1 次晨达 2 次日达

响应参数

名称 类型 示例值 描述
success Boolean true 下单调用是否成功
code String SUCCESS 错误码,成功时非必填
message String 调用成功 错误说明,成功时非必填
data DeliveryOrderCreateResp 返回对象
  • └ channelDeliveryNo
  • String
  • DF00013
  • 配送商运力单号
  • └ createTime
  • Number
  • 1728379194000
  • 创单时间
  • └ deliveryOriginalFee
  • Number
  • 500
  • 配送原始运费,单位:分
  • └ deliveryDiscountFee
  • Number
  • 400
  • 优惠后运费,单位:分
  • └ basicFee
  • Number
  • 300
  • 基础运费,单位:分
  • └ distanceFee
  • Number
  • 100
  • 距离加价,单位:分
  • └ overweightFee
  • Number
  • 0
  • 重量加价,单位:分
  • └ timeFee
  • Number
  • 0
  • 时段加价,单位:分
  • └ typeFee
  • Number
  • 0
  • 品类加价,单位:分
  • └ deliveryDistance
  • Number
  • 3000
  • 配送距离,单位:米

请求示例

{"deliveryOrderType":0,"expectReceiveTime":0,"expectFetchEndTime":0,"goodsTotalWeight":5000,"receiver":{"area":"392109","townName":"康桥街道","provName":"浙江省","town":"4021","city":"110621","receiverName":"张三","receiverAddress":"xx区xx街道xx单元","receiverPhone":"13789560890,0778","cityName":"杭州市","areaName":"西湖区","receiverLng":"120.13","receiverLat":"120.13","prov":"330600"},"expectTimeMode":0,"preCreatedId":"Order001","deliveryType":0,"saleOrderId":"300314101910","remark":"放在门口","signCode":"3001","serialNo":"6","fetchCode":"4519","deliveryOrderNo":"80002024101009","returnCode":"7865","sender":{"senderLat":"120.13","area":"392109","senderAddress":"xx省xx市xx区xx街道xx单元","townName":"康桥街道","provName":"浙江省","town":"4021","city":"110621","senderPhone":"13789560890,0778","senderName":"李四","cityName":"杭州市","areaName":"西湖区","senderLng":"120.13","prov":"330600"},"goodsTotalAmount":14500,"expectFetchTime":0,"goodsActualAmount":12500,"isInsure":false,"timeMode":1,"categoryId":"30001","stationId":"Station001"}

响应示例

{
    "success":true,
    "code":"SUCCESS",
    "message":"调用成功",
    "data":{
        "channelDeliveryNo":"DF00013",
        "createTime":1728379194000,
        "deliveryOriginalFee":500,
        "deliveryDiscountFee":400,
        "basicFee":300,
        "distanceFee":100,
        "overweightFee":0,
        "timeFee":0,
        "typeFee":0,
        "deliveryDistance":3000
    }
}

验签示例

{"code":"sign-check-failure","success":"false","message":"Illegal request"}

错误码解释

错误码 错误描述 解决方案

API工具

FAQ

返回
顶部