散客订单服务表达(预估价)接口
基本信息
| 请求方式 | 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 | boolean | 是 |
| 费用项名称 | name | 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":"normal_delivery_fee","name":"正向配送费","price":1300}]}}
附录
费用项说明
| 费用项名称 | 费用项编码 | 备注 |
|---|---|---|
| 正向配送费 | normal_delivery_fee | |
| 保价费 | insurance_fee |