创建/修改门店接口
基本信息
| 接口名称 | |
|---|---|
| 请求方式 | Post application/x-www-form-urlencoded |
| 功能描述 | 商家调用该接口将门店信息同步给菜鸟速递 |
| 编码 | 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内容
| 项目 | 名称 | 类型 | 必填 | 描述 | 示例 |
|---|---|---|---|---|---|
| 门店id/编码 | storeId | String | 是 | 10002 | |
| 门店名称 | storeName | String | 是 | 测试门店1 | |
| 门店电话 | storePhone | String | 是 | 13111111111 | |
| 省 | province | String | 否 | 浙江省 | |
| 省id | provinceId | String | 否 | 330000 | |
| 市 | city | String | 否 | 杭州市 | |
| 市id | cityId | String | 否 | 330100 | |
| 区县 | district | String | 否 | 西湖区 | |
| 区县id | districtId | String | 否 | 330106 | |
| 街道 | town | String | 否 | 蒋村街道 | |
| 街道id | townId | String | 否 | 330106011 | |
| 详细地址 | detailAddress | String | 是 | 中节能西溪首座 | |
| 经度 | longitude | String | 否 | 火星坐标系(高德、腾讯) | 120.074836 |
| 维度 | latitude | String | 否 | 火星坐标系(高德、腾讯) | 30.288697 |
出参
| 项目 | 名称 | 类型 | 必填 | 描述 | 备注 |
|---|---|---|---|---|---|
| 成功标识 | success | Boolean | 是 | ||
| 错误码 | errorCode | String | 否 | ||
| 错误说明 | errorMsg | String | 否 |
示例报文
请求:
url:
http://edi-daily.xpm.cainiao.com/ext/gateway/ediStandardStoreEdit/ediStandardStoreEdit/api
仅供参考,实际测试账号需联系菜鸟速递开发提供 logistic_provider_id: edi_test_json
logistics_interface: {"storeId":"testboc004","storeName":"测试boc门店122104","province":"浙江省","provinceId":"330000","city":"杭州市","cityId":"330100","district":"西湖区","districtId":"330106","town":"蒋村街道","townId":"330106011","detailAddress":"中节能西溪首座","storePhone":"13111111111"}
data_digest: GKT6RB/QxeGcHByUTZtxDw==
返回:
{"success":true}