计算配送费 - 开发接口文档

简要描述：

计算快跑者商户发单费用,下单时若商户有优惠券，会自动进行使用最优优惠券进行抵扣

请求URL：

https://open.keloop.cn/open/order/getFee

请求方式：

GET

请求参数：

参数名	必选	类型	说明
`version`	是	`string`	版本号，固定为：`1`
`timestamp`	是	`string`	当前时间戳
`ticket`	是	`string`	唯一标识符
`team_token`	是	`string`	团队Token
`dev_key`	是	`string`	开发者中心的开发密钥
`sign`	是	`string`	参数签名，生成规则请参考
`body`	是	`string`	请求方法所需要的参数`json字符串`

body 所需参数：

参数名	必选	类型	说明
`shop_id`	`是`	`int`	第三方系统商户ID
`get_tag`	`是`	`string`	取单坐标`火星坐标`,如：`116.459226,40.007126`,`经度`在前，`纬度`在后
`customer_tag`	`是`	`string`	送达坐标`火星坐标`,如：`116.459226,40.007126`,`经度`在前，`纬度`在后
`pay_fee`	`否`	`string`	第三方订单原配送费
`order_price`	`是`	`string`	第三方订单总价
`shop_tel`	`否`	`string`	第三方系统商户电话 `21.07.05新增参数` 用于在未发单情况下获取相关商户配送费，系统进行自动关联(快跑者存在该商户时)
`distance`	`否`	`float`	第三方系统中的距离单位`km` 最小值`0.01km`,若传了该值，计算配送费将以该值为准
`weight`	`否`	`float`	重量单位`kg`
`is_special`	`否`	`int`	是否专人直送订单时间戳（10 位) 1：是专人直送 2：普通订单
`merchant_code`	`否`	`int`	商户类型 1:美食,2:甜品奶茶,3:烘焙蛋糕,4:鲜花绿植,5:生鲜果蔬,6:超市百货,7:酒水茶饮,8:数码家电,9:医药健康,0:其他

返回示例

有该商户计价方案成功示例

{
    "code": 200,
    "message": "",
    "data": {
        "pay_fee": "67.4",
		"distance": "0",
        "pay_fee_detail": [
            "按单计价：¥ 31(每单31元)",
            "比例计价：¥ 0.4(按订单原价2 元抽取20% 计算)",
            "里程计价：¥ 36(00:00-12:55：1km内收1元，每增加1km加收2元，超过5km，每增加1km，加收3元，配送距离13.32km，应收36元; )",
			"优惠券抵扣：¥ -0.01(好的哈大家奉上倒计时优惠券抵扣金额0.01元)"
        ],
		"coupon_desc": {
			"primary_merchant_pay_fee": "0.02",
			"merchant_pay_fee": "0.01",
			"discount_fee": "0.01",
			"use_coupon": "1"
		}
    }
}

该商户没有计价方案成功示例

{
    "code": 200,
    "message": "",
    "data": {
        "pay_fee": "23",
        "pay_fee_detail": [
            "原始计价：¥ 23(暂未设置计价方案，以原始配送费为准)"
        ],
    }
}

调用失败示例

{
    "code": 204,
    "message": "未能获取距离",
    "data": []
}

返回参数说明

参数名	类型	说明
`pay_fee`	string	商户发单配送费，优惠后的配送费
`pay_fee_detail`	string	计算方式详情
`distance`	string	距离单位 `km`
`coupon_desc`	string	优惠券信息详情

coupon_desc返回参数说明

参数名	类型	说明
`primary_merchant_pay_fee`	string	商户发单配送费，优惠后的配送费
`merchant_pay_fee`	string	计算方式详情
`discount_fee`	string	优惠券信息详情
`use_coupon`	string	是否使用优惠券 1 使用 0 未使用