跳转到内容
返回官网

获取签约的快递公司

根据商家编码查询商家所有审核成功的签约信息

一、请求参数

请求URL:

https://kf.fw199.com/gateway/jd/alpha/getprovidersign

公共参数

参数名称参数类型是否必须示例值参数描述
appidString合作伙伴AppId
timestampStringxxxxxx当前Unix时间戳,秒
seller_nickStringxxxxxx京东的账号,对应蜂巢授权返回jdseller字段
signString
sysid可选应用标识,不清楚请咨询客服

业务参数

名称类型必须示例值描述
- cp_codeStringZTO快递公司编码,如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为成功.

四、返回字段说明

名称类型示例值描述
resultInfocom.jd.ldop.alpha.waybill.api.dto.response.ResponseDTO处理结果
- statusCodeNumber结果编码
- statusMessageString结果描述
datajava.util.List商家签约信息列表
com.jd.ldop.alpha.waybill.api.dto.response.SignSuccessQueryDTO
- providerCodeString承运商编码
- providerIdNumber承运商id
- providerNameString承运商名称
- providerType承运商类型
- supportCodBoolean是否支持货到付款
- operationType承运商经营类型
- branchCodeString网点编码
- branchNameString网点名称
- settlementCodeString财务结算编码
- amountNumber剩余单号量
addresscom.jd.ldop.alpha.waybill.api.dto.waybill.WaybillAddress签约发货地址
- provinceIdNumber省/直辖市id
- provinceNameString省/直辖市名称
- cityIdNumber市id
- cityNameString市名称
- countryIdNumber区/县id
- countryNameString区/县名称
- countrysideIdNumber乡镇/街道id
- countrysideNameString县镇/街道名称
- addressString详细地址