散客订单服务表达(预估价)接口

基本信息

请求方式 Post application/x-www-form-urlencoded
功能描述 商家下单前调用该接口判断是否可达,可达情况下返回预估价格
编码 UTF-8

入参

项目 名称 类型 必填 描述
对接码 logistic_provider_id String 菜鸟侧提供
签名 data_digest String Base64(Md5(logistics_interface+双方约定的secretKey)),0.2 签名方法
业务报文 logistics_interface Waybill JSON

出参

项目 名称 类型 必填
成功标识 success boolean
错误码 errorCode String
错误说明 errorMsg String
费用信息 feeInfo FeeInfoDTO

FeeInfoDTO信息:

项目 名称 类型 必填
原始总价(分) totalPrice Long
优惠后总价(分) actualTotalPrice Long
优惠金额(分) couponPrice Long
首重价格(分) startPrice Long
续重总价格(分) continueTotalPrice Long
费用明细 feeDetailList List<FeeDetailDTO>

FeeDetailDTO信息

项目 名称 类型 必填
费用项编码 code String
费用值(分) price Long

注意:

该接口必填参数:
字段 类型 描述
waybill->receiver->receiverProvince String(20) 收件人省份
waybill->receiver->receiverAddress String(256) 收件人详细地址 因部分区域行政区划没有市或者区,所以接口市和区县字段是非必填的,实际为了避免错分,需要把市和区县信息放到对应的字段传过来或者将完整地址信息放在详细地址里
waybill->sender->senderProvince String(20) 寄件人省份
waybill->sender->senderAddress String(256) 寄件人详细地址 因部分区域行政区划没有市或者区,所以接口市和区县字段是非必填的,实际为了避免错分,需要把市和区县信息放到对应的字段传过来或者将完整地址信息放在详细地址里
waybill->packageInfo->goodsItems->itemName String(128) 商品名称
waybill->packageInfo->goodsItems->itemNum Integer 商品数量
waybill->packageInfo->weight Integer 包裹重量(g)
waybill->order->logisticsId String(32) 订单号

示例报文

url:

http://edi-daily.xpm.cainiao.com/ext/gateway/smallBAbilityExpression/api

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

logistic_provider_id: edi_test_json

data_digest: Mq0TSL0kq6YZxgzJyOLxeQ==

logistics_interface:

{"order":{"logisticsId":"test190812001"},"packageInfo":{"goodsItems":[{"itemName":"测试商品","itemNum":1}],"weight":"870"},"receiver":{"receiverAddress":"中节能西溪首座","receiverDistrict":"蒋村街道","receiverArea":"西湖区","receiverCity":"杭州市","receiverMobile":"13111111111","receiverName":"张三","receiverProvince":"浙江省"},"sender":{"senderAddress":"宁波市北仑区保税南区九龙山路一号","senderDistrict":"大碶街道","senderArea":"北仑区保税南区","senderCity":"宁波市","senderCountry":"中国","senderMobile":"13111111111","senderName":"测试","senderProvince":"浙江省"}}

返回:

{"success":true,"feeInfo":{"totalPrice":1300,"actualTotalPrice":1300,"couponPrice":0,"startPrice":1100,"continueTotalPrice":200,"feeDetailList":[{"code":"transport_fee","name":"正向配送费","price":1300}]}}

附录

费用项说明

费用项名称 费用项编码 备注
正向配送费 transport_fee
保价费 insurance_fee