获取签约的快递公司
根据商家编码查询商家所有审核成功的签约信息
一、请求参数
请求URL:
公共参数
| 参数名称 | 参数类型 | 是否必须 | 示例值 | 参数描述 |
|---|---|---|---|---|
| appid | String | 是 | 合作伙伴AppId | |
| timestamp | String | 是 | xxxxxx | 当前Unix时间戳,秒 |
| seller_nick | String | 是 | xxxxxx | 京东的账号,对应蜂巢授权返回jdseller字段 |
| sign | String | 是 | ||
| sysid | 可选 | 应用标识,不清楚请咨询客服 |
业务参数
| 名称 | 类型 | 必须 | 示例值 | 描述 |
|---|---|---|---|---|
| - cp_code | String | 否 | ZTO | 快递公司编码,如ZTO中通,传空值表示全部 |
二、请求示例代码
Java
请求示例代码
@Test public void getProviderSign() throws Exception {
String sellerNick = Config.JDSellerNick ; //业务参数 Map<String, String> data = new HashMap<String, String>(); data.put("appid", Config.AppId); data.put("seller_nick", sellerNick); Long timestamp = System.currentTimeMillis() / 1000; data.put("timestamp", timestamp.toString()); data.put("vendorCode", "ZTO"); data.put("sign", Utils.Sign(data, Config.AppSecret)); doHttpRequest(Config.JDgetProviderSign, data); }三、返回结果
{ "code": 0, "message": "ok", "data": { "statusCode": 0, "statusMessage": "调用成功" , "data": [ { "address": { "address": "上海浦东新区陆家嘴街道商场路28号", "cityId": 310100, "cityName": "上海市", "countryId": 310115, "countryName": "浦东新区", "countrysideId": 310115005, "countrysideName": "陆家嘴街道", "provinceId": 310000, "provinceName": "上海市" }, "branchName": "", "operationType": 1, "providerCode": "SF", "providerId": 467, "providerName": "顺丰快递", "providerType": 1, "settlementCode": "021314312412", "supportCod": false, "amount": 420, }, { "address": { "address": "上海浦东新区陆家嘴街道商城路28号", "cityId": 310100, "cityName": "上海市", "countryId": 310115, "countryName": "浦东新区", "countrysideId": 310115005, "countrysideName": "陆家嘴街道", "provinceId": 310000, "provinceName": "上海市" }, "branchName": "", "operationType": 1, "providerCode": "SF", "providerId": 467, "providerName": "顺丰快递", "providerType": 1, "settlementCode": "021314312412", "supportCod": false, "amount": 40, } ] }}说明: code为0表示成功,非0为失败,message会包含失败原因。业务成功与否见statusCode的值,0为成功.
四、返回字段说明
| 名称 | 类型 | 示例值 | 描述 |
|---|---|---|---|
| resultInfo | com.jd.ldop.alpha.waybill.api.dto.response.ResponseDTO | 处理结果 | |
| - statusCode | Number | 结果编码 | |
| - statusMessage | String | 结果描述 | |
| data | java.util.List | 商家签约信息列表 | |
| — | com.jd.ldop.alpha.waybill.api.dto.response.SignSuccessQueryDTO | ||
| - providerCode | String | 承运商编码 | |
| - providerId | Number | 承运商id | |
| - providerName | String | 承运商名称 | |
| - providerType | 承运商类型 | ||
| - supportCod | Boolean | 是否支持货到付款 | |
| - operationType | 承运商经营类型 | ||
| - branchCode | String | 网点编码 | |
| - branchName | String | 网点名称 | |
| - settlementCode | String | 财务结算编码 | |
| - amount | Number | 剩余单号量 | |
| address | com.jd.ldop.alpha.waybill.api.dto.waybill.WaybillAddress | 签约发货地址 | |
| - provinceId | Number | 省/直辖市id | |
| - provinceName | String | 省/直辖市名称 | |
| - cityId | Number | 市id | |
| - cityName | String | 市名称 | |
| - countryId | Number | 区/县id | |
| - countryName | String | 区/县名称 | |
| - countrysideId | Number | 乡镇/街道id | |
| - countrysideName | String | 县镇/街道名称 | |
| - address | String | 详细地址 |