创建/修改门店接口
基本信息
接口名称 | |
---|---|
请求方式 | 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}