orderPush.md 5.3 KB

推送订单

请求URL
  • /api/order/push
请求方式
  • POST
参数
参数名 必选 类型 说明
appId string 系统分配的appId
timeStamp long 时间戳(毫秒级)
sign string 加签密文
outOrderSn string 接入方订单编号(唯一标识),最长不超过32个字符
categoryId int 物品ID,详情见附录-经营品类
weight int 物品重量,单位KG,范围1-50
remark string 订单备注
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 收件人城市code,最长不超过30个字符
shopCode string 猎豹AI门店编号,最长不超过45个字符
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 发件人纬度,火星坐标系,最长不超过40个字符
sendLat 特殊必填 string 发件人经度,火星坐标系,最长不超过40个字符
sendCityCode 特殊必填 string 发件人城市code,最长不超过30个字符
daySeq string 流水号,最长不超过5个字符
isAgain int 再次推送
goods array 商品明细,见下方
goods 参数说明
参数名 必选 类型 说明
foodId int 食物id
foodName string 食物
price string 单价 元
quantity string 数量
unit string 单位
spec string 规格
weight string 重量
weight string 图片
请求示例
  {
    "appId": "100001",
    "timeStamp" : 1647919332000,
    "sign": "A6015AEA071BED6BBFFAE93018DE8820",
    "outOrderSn": "2161313407662810813",
    "categoryId": 2,
    "weight": 10,
    "remark": "请快速取货",
	"receiverName": "李华",
    "receiverPhone": "16062163351",
	"receiverProvinceName":"江苏省",
	"receiverCityName":"苏州市",
	"receiverDistrictName":"虎丘区",
    "receiverAddress": "通园路xx产业园",
	"receiverHouseNumber": "6幢606室",
	"receiverLng": "31.26682",
    "receiverLat": "120.67025",
	"receiverCityCode": "010",
	"shopCode": "2104161111222174",
	"daySeq": "2",
	"isAgain": 0,
	"goods": [   {
                "foodId": 7,
                "foodName": "面包",
                "price": "7。9",
                "quantity": 1,
                "unit": 杯,
                "spec": "大杯",
				"weight": 1,
				"img": "http://aa.com",
            }....],
}
返回参数说明
参数名 必选 类型 说明
code int 状态码:0-成功 其他为错误
msg string 错误信息(code=0时,值为SUCCESS, code不等于0为具体错误信息)
data object 业务数据
code为0时返回业务数据如下
参数名 必选 类型 说明
outOrderSn string 接入方订单编号(唯一标识)
orderSn string 猎豹订单编号
返回示例
#成功
{
	"code": 0,
	"msg": "SUCCESS",
	"data": {
		"outOrderSn": "2161313407662810813",
		"orderSn": "210927103545271041";
	}
}

#失败
{
	"code": 1,
	"msg": "收件人联系电话不可为空",
	"data": null
}
备注
  • 更多返回错误代码请看首页的错误代码描述