获取签约的快递公司

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

1.请求参数:

请求URL:

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

公共参数

参数名称 参数类型 是否必须 示例值 参数描述
appid String 合作伙伴AppId
timestamp String 1657525936 当前Unix时间戳,秒
seller_nick String 38173182 京东的账号,对应蜂巢授权返回jdseller字段
sign String

业务参数

名称 类型 必须 示例值 描述
- vendorCode String 商家编码

2. 请求示例代码(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", "12412981");// 商家ID
        data.put("sign", Utils.Sign(data, Config.AppSecret));
        doHttpRequest(Config.JDgetProviderSign, data);
    }

3. 返回结果如下:

{
    "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
            },
            {
                "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
            }
        ]
    }
}

说明: code为0表示成功,非0为失败,message会包含失败原因。业务成功与否见statusCode的值,0为成功.

4. 返回字段说明

名称 类型 示例值 描述
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 详细地址
文档更新时间: 2023-03-14 16:57   作者:admin