送件侠开放平台

闪时送开放平台


计算运费

简要描述:

请求URL:

  • /v1/order/queryDeliverFee

请求方式:

  • POST

参数:

参数名 必选 类型 说明
sss_shop_id int 送件侠门店id
order_id string 订单id,即该订单在合作方系统中的唯一标识,最长不超过32个字符
receiver_name string 收件人名称,最长不超过20个字符
receiver_address string 收件人地址,最长不超过150个字符
receiver_address_detail string 收件人详细地址,最长不超过150个字符
receiver_phone string 收件人电话,最长不超过20个字符
receiver_lng double 收件人经度,使用高德地图的坐标
receiver_lat double 收件人纬度,使用高德地图的坐标
goods_type int 货物类型,1:食品小吃 2:饮料 3:蛋糕 4:鲜花 5:生鲜果蔬 6:电子数码 7:百货 8:文印票务 9:医药 10:同城电商 11:小商品市场 12:小龙虾 100:其它
goods_weight int 货物重量,单位为kg
expected_pickup_time int 期望骑手上门时间,时区为GMT+8,当前距离Epoch(1970年1月1日) 以秒计算的时间,即unix-timestamp。传0则为立即上门
poi_seq int 门店订单流水号,指定店铺的每日订单顺序号,比如是今日第4单,那就传4
note string 订单备注,最长不超过200个字符,如果值为空,则不传此参数
coupon_alias string 优惠券唯一码,传入则表示指定一张优惠券,调用订单可用优惠券接口可获取, 如果不需要则不传此参数,系统默认会推出一张可用优惠券
insurance_fee int 此订单保价金额, 不传则不保价, 目前只固定支持 0,100,200,300,400,500元
attach int 发单成功后,如需要再次计价,传入attach:1, 此参数作用为过滤掉第一次发单时已选择的运力,并重新计价 (如attach:1,则sss_peisong_id必传)
sss_peisong_id string 送件侠订单号
notify_url string 自定义订单状态通知回调地址,无须参与sign签名

特别说明

 首次调用此接口,将返回一个sss_peisong_id值,如返回值为1
 再次调用此接口,将返回一个新的sss_peisong_id值,如返回值为2
 如果业务方订单号是同一个,可以在第一次调用接口之后,记录sss_peisong_id, 如需再次调用,可传入sss_peisong_id:最新的订单号如2
 这样的好处是业务方同一个订单号对应送件侠一个订单号

 如果需要发单后追加运力功能,流程为
 1. 调用计价->调用下单接口
 2. 再次调用计价接口,传入以下附加参数
 attach:1
 sss_peisong_id:第1步时返回的送件侠订单号
 3. 调用下单接口,third_logistics_ids 传入本次下单需要追加的运力ID

返回示例

{
    "code": 0,
    "message": "ok",
    "data": {
        "sss_peisong_id": 2269722,
        "detail": [
            {
                "third_logistics_id": 14,
                "third_logistics_name": "蜂鸟即配",
                "third_logistics_icon": "https://sss-admin.oss-cn-zhangjiakou.aliyuncs.com/image/fn.png",
                "distance": 9.4,
                "fee": 18,
                "is_custom_capacity": 0,
                "custom_capacity_fee": 0,
                "custom_capacity_error_msg": "",
                "used_coupon_alias": "62400ce5c3e640b39da44db78d2207c3",
                "coupon_fee": 3,
                "is_use_insurance": 1,
                "insurance_deduct_fee": 2
            },
            {
                "third_logistics_id": 6,
                "third_logistics_name": "点我达",
                "third_logistics_icon": "https://sss-admin.oss-cn-zhangjiakou.aliyuncs.com/image/dwd.png",
                "distance": 9.8,
                "fee": 18.4,
                "is_custom_capacity": 0,
                "custom_capacity_fee": 0,
                "custom_capacity_error_msg": "",
                "used_coupon_alias": "62400ce5c3e640b39da44db78d2207c3",
                "coupon_fee": 3,
                "is_use_insurance": 0,
                "insurance_deduct_fee": 0
            },
            {
                "third_logistics_id": 12,
                "third_logistics_name": "快服务",
                "third_logistics_icon": "https://sss-admin.oss-cn-zhangjiakou.aliyuncs.com/image/kfw-logo.png",
                "distance": 9.8,
                "fee": 20,
                "is_custom_capacity": 0,
                "custom_capacity_fee": 0,
                "custom_capacity_error_msg": "",
                "used_coupon_alias": "62400ce5c3e640b39da44db78d2207c3",
                "coupon_fee": 3,
                "is_use_insurance": 0,
                "insurance_deduct_fee": 0
            },
            {
                "third_logistics_id": 8,
                "third_logistics_name": "UU跑腿",
                "third_logistics_icon": "https://sss-admin.oss-cn-zhangjiakou.aliyuncs.com/image/uu.png",
                "distance": 9.495,
                "fee": 21,
                "is_custom_capacity": 0,
                "custom_capacity_fee": 0,
                "custom_capacity_error_msg": "",
                "used_coupon_alias": "62400ce5c3e640b39da44db78d2207c3",
                "coupon_fee": 3,
                "is_use_insurance": 0,
                "insurance_deduct_fee": 0
            },
            {
                "third_logistics_id": 1,
                "third_logistics_name": "达达",
                "third_logistics_icon": "https://sss-admin.oss-cn-zhangjiakou.aliyuncs.com/image/dd.png",
                "distance": 9.41,
                "fee": 21,
                "is_custom_capacity": 0,
                "custom_capacity_fee": 0,
                "custom_capacity_error_msg": "",
                "used_coupon_alias": "62400ce5c3e640b39da44db78d2207c3",
                "coupon_fee": 3,
                "is_use_insurance": 1,
                "insurance_deduct_fee": 1
            },
            {
                "third_logistics_id": 11,
                "third_logistics_name": "顺丰",
                "third_logistics_icon": "https://sss-admin.oss-cn-zhangjiakou.aliyuncs.com/image/sf.png",
                "distance": 9.409,
                "fee": 21,
                "is_custom_capacity": 0,
                "custom_capacity_fee": 0,
                "custom_capacity_error_msg": "",
                "used_coupon_alias": "62400ce5c3e640b39da44db78d2207c3",
                "coupon_fee": 3,
                "is_use_insurance": 1,
                "insurance_deduct_fee": 1.5
            },
            {
                "third_logistics_id": 16,
                "third_logistics_name": "闪送v5",
                "third_logistics_icon": "https://sss-admin.oss-cn-zhangjiakou.aliyuncs.com/image/ss.png",
                "distance": "8.00",
                "fee": 23,
                "is_custom_capacity": 0,
                "custom_capacity_fee": 0,
                "custom_capacity_error_msg": "",
                "used_coupon_alias": "62400ce5c3e640b39da44db78d2207c3",
                "coupon_fee": 3,
                "is_use_insurance": 1,
                "insurance_deduct_fee": 1.5
            }
        ]
    }
}

返回参数说明

参数 说明 类型 必定返回
sss_peisong_id string 送件侠订单号
third_logistics_id int 运力公司标识ID,详见附录
third_logistics_name string 运力公司名,详见附录
third_logistics_icon string 运力logo
distance double 配送距离,单位为公里
fee double 最终运费,单位为元
is_custom_capacity int 是否使用自运力账号
custom_capacity_fee double 自运力账号-本次运费
custom_capacity_error_msg string 自运力计算运费错误信息
used_coupon_alias string 已使用的优惠券码,如无则为空字符
coupon_fee double 优惠券金额
is_use_insurance int 是否成功由运力方保价, 1:是 0:否
insurance_deduct_fee double 保价扣除金额 (如返回运费为10元,其中有2元为保价溢价金额)

请求示例demo x-www-form-urlencoded

appkey:4aa32923334940099ad6ecf6a552de33
timestamp:1575525613228
version:1.0
sign:xxxxxxx
sss_shop_id:18000016
receiver_name:李安
receiver_phone:15632131234
receiver_address:阿里巴巴西溪园区(淘宝城)
receiver_address_detail:1幢1402
receiver_lng:120.024393
receiver_lat:30.279713
goods_type:3
goods_weight:1
note:备注信息
poi_seq:30
expected_pickup_time:1589292000
order_id:11123123
notify_url:https://www.qq.com

页面列表

ITEM_HTML