B2b下单接口

基本信息

接口名称 MCS_B2B_ACCESS
请求方式 Post application/x-www-form-urlencoded
功能描述 商家将B2b订单推送给菜鸟速递EDI
编码 UTF-8

入参

项目 名称 类型 必填 描述 备注
对接码 logistic_provider_id String 是 菜鸟速递提供
签名 data_digest String 是 Base64(Md5(logistics_interface+secretKey)) ,具体参见0.2 签名方法 x-www-form-urlencoded格式可能会出现加号变空格的情况，发请求之前可以对签名进行urlencode
业务报文 logistics_interface String 是 JSON

logistics_interface内容

项目 名称 类型 必填 描述 示例
订单号 storeOrderCode String 是 Test200327001
发件人信息 sender ContactDTO 是
收件人信息 receiver ContactDTO 是
商品信息 goodsDTOList List<GoodsDTO> 是
订单总金额 orderGMV String 是 单位元 1000.56
期望送达最早时间 expectEarliestTime String 否 格式：yyyy-MM-dd HH:mm:ss 2020-03-04 12:00:00
期望送达最晚时间 expectLatestTime String 否 格式：yyyy-MM-dd HH:mm:ss 2020-03-04 14:00:00
排线组别 group String 否
组序 groupNo String 否
车型描述 carType String 否
包裹数量 packageNums Long 是 10
订单服务 serviceList List 否 1：部分揽收(默认支持)/8：不支持部分揽收/2：部分签收(默认支)/9：不支持部分签收/3：温控常温/4：温控冷藏/5：温控冷冻/6：温控活鲜/7：温控组合 (3,4,5,6,7为温控，1,8为部分揽收，2,9为部分签收，相同类型只传一个，传多个时默认第一个传值，不传默认第一个值) ["1","2","3"]
备注 remark String 否

ContactDTO内容

项目 名称 类型 必填 描述 备注
名称 name String 是 张三
电话 phone String 是 13111111111
省 province String 是 浙江省
市 city String 否 杭州市
区县 area String 否 西湖区
城镇 town String 否 蒋村街道
详细地址 address String 是 中节能西溪首座
店铺/仓名称 storeName String 否 发件人信息必填
店铺/仓编码 storeCode String 否 发件人信息必填
目的地名称 destinationName String 否 收件人信息必填

GoodsDTO内容

项目 名称 类型 必填 描述 备注
商品名称 itemName String 是 书
商品编码 skuId String 否 155564868
商品数量 quantity Long 是 1
单价 unitPrice String 否 元 160.36
体积 volume String 否 立方米 1.23
重量 weight String 否 千克 10.25
总价 totalPrice String 否 3200.37
件数单位 itemCountUnit String 否 件/个/包/箱/盒...

出参

项目 名称 类型 必填 描述 备注
成功标识 success Boolean 是
错误码 errorCode String 否
错误说明 errorMsg String 否
订单信息 data OrderAcceptResponseDTO 否

OrderAcceptResponseDTO内容

项目 名称 类型 必填 描述 备注
运单号 mailNo String 是

示例报文：

测试URL
http://edi-daily.xpm.cainiao.com/ext/gateway/b2bReceivePlugin/b2bReceivePlugin/api
入参

仅供参考，实际测试账号需联系菜鸟速递开发提供

logistic_provider_id: edi_test_json

data_digest: wtAtVCFBbDAIxcJHzmmLzQ==

logistics_interface:

{
    "dataObjectId": "YZ1000000010",
    "receiver": {
        "area": "西湖区",
        "destinationName": "旺旺大礼包店",
        "address": "蒋村街道西溪谷",
        "province": "浙江省",
        "city": "杭州市",
        "phone": "13588882120",
        "name": "李四"
    },
    "customerCode": "xpm724",
    "storeOrderCode": "YZ1000000010",
    "orderGMV": "500",
    "responseClass": "com.taobao.pac.sdk.cp.dataobject.response.MCS_B2B_ACCESS.McsB2bAccessResponse",
    "sender": {
        "area": "西湖区",
        "storeName": "旺旺小礼包店",
        "storeCode": "sc888",
        "address": "蒋村街道西溪首座",
        "province": "浙江省",
        "city": "杭州市",
        "phone": "13700001111",
        "name": "张三"
    },
    "api": "MCS_B2B_ACCESS",
    "goodsDTOList": [{
        "itemName": "书",
        "quantity": 5
    }, {
        "itemName": "书",
        "quantity": 4
    }]
}
出参
{
    "data": {
        "mailNo": "FU13110007786918531"
    },
    "success": true
}