orderValuation.md 6.4 KB

订单计费

请求URL
  • /api/order/valuation
请求方式
  • POST
参数
参数名 必选 类型 说明
appId string 系统分配的appId
timeStamp long 时间戳(毫秒级)
sign string 加签密文
outOrderSn string 接入方订单编号(唯一标识),最长不超过50个字符
receiverName string 收件人名称,最长不超过50个字符
receiverPhone string 收件人联系电话,最长不超过40个字符
receiverProvinceName string 收件人所在省,最长不超过30个字符
receiverCityName string 收件人所在市,最长不超过30个字符
receiverDistrictName string 收件人所在区,最长不超过40个字符
receiverAddress string 收件人详细地址,最长不超过150个字符
receiverHouseNumber string 收件人门牌号,最长不超过30个字符
receiverLng string 收件人经度,火星坐标系,最长不超过40个字符
receiverLat string 收件人纬度,火星左边系,最长不超过40个字符
receiverCityCode string 收件人城市编码,最长不超过30个字符
shopCode string 猎豹AI门店编号(若传此字段, 则根据门店地址进行发单)
sendName 特殊必填 string 发件人名称,当传入shopCode时,不必填,根据门店信息发单,最长不超过50个字符
sendPhone 特殊必填 string 发件人联系电话,当传入shopCode时,不必填,根据门店信息发单,最长不超过40个字符
sendProvinceName 特殊必填 string 发件人所在省,当传入shopCode时,不必填,根据门店信息发单,最长不超过30个字符
sendCityName 特殊必填 string 发件人所在市,当传入shopCode时,不必填,根据门店信息发单,最长不超过30个字符
sendDistrictName string 发件人所在区,当传入shopCode时,不必填,根据门店信息发单,最长不超过30个字符
sendAddress 特殊必填 string 发件人详细地址,当传入shopCode时,不必填,根据门店信息发单,最长不超过150个字符
sendHouseNumber string 发件人门牌号,当传入shopCode时,不必填,根据门店信息发单,最长不超过30个字符
sendLng 特殊必填 string 发件人经度,火星坐标系,当传入shopCode时,不必填,根据门店信息发单,最长不超过40个字符
sendLat 特殊必填 string 发件人纬度,火星坐标系,当传入shopCode时,不必填,根据门店信息发单,最长不超过40个字符
sendCityCode 特殊必填 string 发件人城市编码,当传入shopCode时,不必填,根据门店信息发单,最长不超过30个字符
categoryId int 物品类型ID(参考附录-经营品类)
productAmount double 物品金额,单位为元(范围 1~9999元)
weight int 物品重量,单位为kg(范围 1~50kg)
platformType int 0-其他 1-美团 2-饿了么 3-饿百零售 5-美团闪购 6-京东到家
daySeq int 流水号。指定店铺的每日订单顺序号,比如是今日第2单,那就传2
exceptTime     否   long 期望送达时间 时间戳 到秒  
remark string 订单备注,最长不超过200个字符
请求示例
  {
    "appId": "100001",
    "timeStamp" : 1647919332000,
    "sign": "A6015AEA071BED6BBFFAE93018DE8820",
	"outOrderSn": "2161313407662810813",
	"receiverName": "李华",
    "receiverPhone": "15550958655",
	"receiverProvinceName":"江苏省",
	"receiverCityName":"苏州市",
	"receiverDistrictName":"虎丘区",
    "receiverAddress": "通园路108号xx产业园",
	"receiverHouseNumber": "6幢606室",
	"receiverLng": "120.67025",
	"receiverLat": "31.26682",
	"receiverCityCode": "0512",
	"shopCode": "2104161111222174",
	"sendName": "王五",
    "sendPhone": "15562162876",
	"sendProvinceName":"江苏省",
	"sendCityName":"苏州市",
	"sendDistrictName":"虎丘区",
    "sendAddress": "群星三路109号XX公寓",
	"sendHouseNumber": "106幢28楼",
	"sendLng": "120.66593",
    "sendLat": "31.26703",
	"sendCityCode": "0512",
	"categoryId": 2,
	"productAmount": 99.8,
    "weight": 2,
	"platformType": 1,
	"daySeq": 2,
	"remark": "请快速取货"
}
返回参数说明
参数名 必选 类型 说明
code int 状态码:0-成功 其他为错误
msg string 错误信息(code=0时,值为SUCCESS, code不等于0为具体错误信息)
data object 业务数据
code为0时返回下列数据
参数名 必选 类型 说明
outOrderSn string 接入方订单编号
valuationList array 运力计价结果,10分钟内有效,过期后下单时返回错误码,需重新获取计价
valuationList参数说明
参数名 必选 类型 说明
deliveryId int 运力平台ID,详见附录-运力平台
deliveryName string 运力平台名称
distance string 配送距离,单位: 米
deliveryAmount double 预估运费金额,单位: 元
discountAmount double 优惠金额,单位: 元
needPayAmount double 最终需支付金额,单位: 元
返回示例
  # 成功
  {
	"code": 0,
	"msg": "SUCCESS",
    "data": {
		"outOrderSn": "2161313407662810813",
		"valuationList": [
            {
                "deliveryId": 7,
                "deliveryName": "UU跑腿",
                "distance": "77m",
                "deliveryAmount": 9.6990,
                "discountAmount": 0,
                "needPayAmount": 9.6990
            },
            {
                "deliveryId": 1,
                "deliveryName": "达达",
                "distance": "49m",
                "deliveryAmount": 10.7732,
                "discountAmount": 2,
				"needPayAmount": 8.7732
            }
        ]
	}
  }
  
  # 失败
  {
	"code": 1,
	"msg": "计价异常...",
    "data":null
  }
备注
  • 更多返回错误代码请看首页的错误代码描述