建站
咨询
售后
建站咨询
创新互联小程序教程：微信小程序小程序使用·addOrder
immediateDelivery.addOrder
本接口应在服务器端调用，详细说明参见 服务端API。
创新互联公司主营黄浦网站建设的网络公司,主营网站建设方案,重庆APP软件开发,黄浦h5重庆小程序开发搭建,黄浦网站营销推广欢迎黄浦等地区企业咨询
下配送单接口
请求地址
POST https://api.weixin.qq.com/cgi-bin/express/local/business/order/add?access_token=ACCESS_TOKEN
请求参数
| 属性 | 类型 | 默认值 | 必填 | 说明 |
|---|---|---|---|---|
| access_token | string | 是 | 接口调用凭证 | |
| delivery_token | string | 否 | 预下单接口返回的参数，配送公司可保证在一段时间内运费不变 | |
| shopid | string | 是 | 商家id，由配送公司分配的appkey | |
| shop_order_id | string | 是 | 唯一标识订单的 ID，由商户生成, 不超过128字节 | |
| shop_no | string | 是 | 商家门店编号，在配送公司登记，如果只有一个门店，美团闪送必填, 值为店铺id | |
| delivery_sign | string | 是 | 用配送公司提供的appSecret加密的校验串说明 | |
| delivery_id | string | 是 | 配送公司ID | |
| openid | string | 是 | 下单用户的openid | |
| sender | Object | 是 | 发件人信息，顺丰同城急送必须填写，美团配送、达达、闪送，若传了shop_no的值可不填该字段 | |
| receiver | Object | 是 | 收件人信息 | |
| cargo | Object | 是 | 货物信息 | |
| order_info | Object | 是 | 订单信息 | |
| shop | Object | 是 | 商品信息，会展示到物流通知消息中 | |
| sub_biz_id | string | 否 | 子商户id，区分小程序内部多个子商户 |
sender 的结构
| 属性 | 类型 | 默认值 | 必填 | 说明 |
|---|---|---|---|---|
| name | string | 是 | 姓名，最长不超过256个字符 | |
| city | string | 是 | 城市名称，如广州市 | |
| address | string | 是 | 地址(街道、小区、大厦等，用于定位) | |
| address_detail | string | 是 | 地址详情(楼号、单元号、层号) | |
| phone | string | 是 | 电话/手机号，最长不超过64个字符 | |
| lng | number | 是 | 经度（火星坐标或百度坐标，和 coordinate_type 字段配合使用，确到小数点后6位 | |
| lat | number | 是 | 纬度（火星坐标或百度坐标，和 coordinate_type 字段配合使用，精确到小数点后6位） | |
| coordinate_type | number | 0 | 否 | 坐标类型，0：火星坐标（高德，腾讯地图均采用火星坐标） 1：百度坐标 |
receiver 的结构
| 属性 | 类型 | 默认值 | 必填 | 说明 |
|---|---|---|---|---|
| name | string | 是 | 姓名，最长不超过256个字符 | |
| city | string | 是 | 城市名称，如广州市 | |
| address | string | 是 | 地址(街道、小区、大厦等，用于定位) | |
| address_detail | string | 是 | 地址详情(楼号、单元号、层号) | |
| phone | string | 是 | 电话/手机号，最长不超过64个字符 | |
| lng | number | 是 | 经度（火星坐标或百度坐标，和 coordinate_type 字段配合使用，确到小数点后6位 | |
| lat | number | 是 | 纬度（火星坐标或百度坐标，和 coordinate_type 字段配合使用，精确到小数点后6位） | |
| coordinate_type | number | 0 | 否 | 坐标类型，0：火星坐标（高德，腾讯地图均采用火星坐标） 1：百度坐标 |
cargo 的结构
| 属性 | 类型 | 默认值 | 必填 | 说明 |
|---|---|---|---|---|
| goods_value | number | 是 | 货物价格，单位为元，精确到小数点后两位（如果小数点后位数多于两位，则四舍五入保留两位小数），范围为(0-5000] | |
| goods_height | number | 否 | 货物高度，单位为cm，精确到小数点后两位（如果小数点后位数多于两位，则四舍五入保留两位小数），范围为(0-45] | |
| goods_length | number | 否 | 货物长度，单位为cm，精确到小数点后两位（如果小数点后位数多于两位，则四舍五入保留两位小数），范围为(0-65] | |
| goods_width | number | 否 | 货物宽度，单位为cm，精确到小数点后两位（如果小数点后位数多于两位，则四舍五入保留两位小数），范围为(0-50] | |
| goods_weight | number | 是 | 货物重量，单位为kg，精确到小数点后两位（如果小数点后位数多于两位，则四舍五入保留两位小数），范围为(0-50] | |
| goods_detail | Object | 否 | 货物详情，最长不超过10240个字符 | |
| goods_pickup_info | string | 否 | 货物取货信息，用于骑手到店取货，最长不超过100个字符 | |
| goods_delivery_info | string | 否 | 货物交付信息，最长不超过100个字符 | |
| cargo_first_class | string | 是 | 品类一级类目, 详见品类表 | |
| cargo_second_class | string | 是 | 品类二级类目 |
goods_detail 的结构
| 属性 | 类型 | 默认值 | 必填 | 说明 |
|---|---|---|---|---|
| goods | Array. | 是 | 货物列表 |
goods 的结构
| 属性 | 类型 | 默认值 | 必填 | 说明 |
|---|---|---|---|---|
| good_count | number | 是 | 货物数量 | |
| good_name | string | 是 | 货品名称 | |
| good_price | number | 否 | 货品单价，精确到小数点后两位（如果小数点后位数多于两位，则四舍五入保留两位小数） | |
| good_unit | string | 否 | 货品单位，最长不超过20个字符 |
order_info 的结构
| 属性 | 类型 | 默认值 | 必填 | 说明 |
|---|---|---|---|---|
| delivery_service_code | string | 否 | 配送服务代码 不同配送公司自定义, 顺丰和达达不填 | |
| order_type | number | 0 | 否 | 订单类型, 0: 即时单 1 预约单，如预约单，需要设置expected_delivery_time或expected_finish_time或expected_pick_time |
| expected_delivery_time | number | 0 | 否 | 期望派单时间(达达支持，表示达达系统调度时间, 到那个时间才会有状态更新的回调通知)，unix-timestamp, 比如1586342180 |
| expected_finish_time | number | 0 | 否 | 期望送达时间(美团、顺丰同城急送支持），unix-timestamp, 比如1586342180 |
| expected_pick_time | number | 0 | 否 | 期望取件时间（闪送、顺丰同城急送支持，闪送需要设置两个小时后的时间，顺丰同城急送只需传expected_finish_time或expected_pick_time其中之一即可，同时都传则以expected_finish_time为准），unix-timestamp, 比如1586342180 |
| poi_seq | string | 否 | 门店订单流水号，建议提供，方便骑手门店取货，最长不超过32个字符 | |
| note | string | 否 | 备注，最长不超过200个字符 | |
| order_time | number | 否 | 用户下单付款时间, 顺丰必填, 比如1555220757 | |
| is_insured | number | 0 | 否 | 是否保价，0，非保价，1.保价 |
| declared_value | number | 否 | 保价金额，单位为元，精确到分 | |
| tips | number | 否 | 小费，单位为元, 下单一般不加小费 | |
| is_direct_delivery | number | 否 | 是否选择直拿直送（0：不需要；1：需要。选择直拿直送后，同一时间骑手只能配送此订单至完成，配送费用也相应高一些，闪送必须选1，达达可选0或1，其余配送公司不支持直拿直送） | |
| cash_on_delivery | number | 否 | 骑手应付金额，单位为元，精确到分 | |
| cash_on_pickup | number | 否 | 骑手应收金额，单位为元，精确到分 | |
| rider_pick_method | number | 否 | 物流流向，1：从门店取件送至用户；2：从用户取件送至门店 | |
| is_finish_code_needed | number | 否 | 收货码（0：不需要；1：需要。收货码的作用是：骑手必须输入收货码才能完成订单妥投） | |
| is_pickup_code_needed | number | 否 | 取货码（0：不需要；1：需要。取货码的作用是：骑手必须输入取货码才能从商家取货） |
shop 的结构
| 属性 | 类型 | 默认值 | 必填 | 说明 |
|---|---|---|---|---|
| wxa_path | string | 是 | 商家小程序的路径，建议为订单页面 | |
| img_url | string | 是 | 商品缩略图 url | |
| goods_name | string | 是 | 商品名称 | |
| goods_count | number | 是 | 商品数量 | |
| wxa_appid | string | 否 | 若结算方式为：第三方向配送公司统一结算，商户后续和第三方结算，则该参数必填；在该结算模式下，第三方用自己的开发小程序替授权商户发起下单，并将授权小程序的appid给平台，后续配送通知中可回流授权商户小程序。 |
返回值
Object
| 属性 | 类型 | 说明 |
|---|---|---|
| errcode | number | 错误码, 当errcode==0或者不存在还需要看resultcode |
| errmsg | string | 错误描述 |
| resultcode | number | 运力返回的错误码 |
| resultmsg | string | 运力返回的错误描述 |
| fee | number | 实际运费(单位：元)，运费减去优惠券费用 |
| deliverfee | number | 运费(单位：元) |
| couponfee | number | 优惠券费用(单位：元) |
| tips | number | 小费(单位：元) |
| insurancefee | number | 保价费(单位：元) |
| distance | number | 配送距离(整数单位：米) |
| waybill_id | string | 配送单号 |
| order_status | number | 配送状态 |
| finish_code | number | 收货码 |
| pickup_code | number | 取货码 |
| dispatch_duration | number | 预计骑手接单时间，单位秒，比如5分钟，就填300, 无法预计填0 |
使用场景
商家可调用本接口向配送公司请求下配送单，配送公司会返回这一单的配送单号、配送费、预计骑手接单时间等信息。如遇下单错误，请先确认一下编码方式，python建议 json.dumps(b, ensure_ascii=False)，php建议 json_encode($arr, JSON_UNESCAPED_UNICODE) 可预约时间：达达：72小时内，闪送2小时以后，48小时以内
请求示例
{
"cargo": {
"cargo_first_class": "美食夜宵",
"cargo_second_class": "零食小吃",
"goods_detail": {
"goods": [
{
"good_count": 1,
"good_name": "水果",
"good_price": 10,
"good_unit": "元"
},
{
"good_count": 2,
"good_name": "蔬菜",
"good_price": 20,
"good_unit": "元"
}
]
},
"goods_height": 1,
"goods_length": 3,
"goods_value": 5,
"goods_weight": 1,
"goods_width": 2
},
"delivery_id": "SFTC",
"delivery_sign": "01234567890123456789",
"openid": "oABC123456",
"order_info": {
"delivery_service_code": "",
"expected_delivery_time": 0,
"is_direct_delivery": 0,
"is_finish_code_needed": 1,
"is_insured": 0,
"is_pickup_code_needed": 1,
"note": "test_note",
"order_time": 1555220757,
"order_type": 0,
"poi_seq": "1111",
"tips": 0
},
"receiver": {
"address": "xxx地铁站",
"address_detail": "2号楼202",
"city": "北京市",
"coordinate_type": 0,
"lat": 40.1529600000,
"lng": 116.5060300000,
"name": "老王",
"phone": "18512345678"
},
"sender": {
"address": "xx大厦",
"address_detail": "1号楼101",
"city": "北京市",
"coordinate_type": 0,
"lat": 40.4486120000,
"lng": 116.3830750000,
"name": "刘一",
"phone": "13712345678"
},
"shop": {
"goods_count": 2,
"goods_name": "宝贝",
"img_url": "https://mmbiz.qpic.cn/mmbiz_png/xxxxxxxxx/0?wx_fmt=png",
"wxa_path": "/page/index/index"
},
"shop_no": "12345678",
"sub_biz_id": "sub_biz_id_1",
"shop_order_id": "SFTC_001",
"shopid": "122222222",
"delivery_token": "xxxxxxxx"
}
返回示例
下单成功
{
"resultcode": 0,
"resultmsg": "ok",
"fee": 10,
"deliverfee": 10,
"couponfee": 0,
"tips": 0,
"insurancfee": 0,
"distance": 1000,
"waybill_id": "123456789",
"order_status": 101,
"finish_code": 1024,
"pickup_code": 2048,
"dispatch_duration": 300
}
下单失败
{
"resultcode": 1010,
"resultmsg": "收件人信息不正确"
}网页名称：创新互联小程序教程：微信小程序小程序使用·addOrder
标题URL：http://www.jxjierui.cn/article/cdppjjj.html
