获取打印模板列表
获取打印模板列表。
说明:2026年04月10后按官方启用最新的获取模板接口,返回字段和老接口不兼容,请注意升级调整。
1.请求参数:
请求URL:
POST https://kf.fw199.com/gateway/jd/printing/gettemplatelist
公共参数
| 参数名称 | 参数类型 | 是否必须 | 示例值 | 参数描述 |
|---|---|---|---|---|
| appid | String | 是 | 合作伙伴AppId | |
| timestamp | String | 是 | 1657525936 | 当前Unix时间戳,秒 |
| seller_nick | String | 是 | xxxxxx | 京东的账号,对应蜂巢授权返回jdseller字段 |
| sign | String | 是 |
业务参数
| 名称 | 类型 | 必须 | 示例值 | 描述 |
|---|---|---|---|---|
| param1 | com.jd.jcloud.wms.printing.dto.GetTemplateListReqDTO | 是 | 参数描述 | |
| - templateType | String | 否 | 1 | 模板类型:1,标准模板(各物流公司合作服务商标准运单模板);2自定义模板(用于商家自己定义的模板不限于运单,可以是其他单据类型模板);3、ISV自定义模板(ISV合作伙伴自定义模板,与合作伙伴签订软件服务协议的商家以及ISV合作伙伴都可以使用的模板,不限于运单);4、商家自定义区(运单模板或者其他模板中自定义项内容模板,用于商家自己使用) |
| - cpCode | String | 否 | JD | 物流公司编码。京东快递:JD |
|2. 请求示例代码(Java)
请求示例代码
@Test
public void getTemplateList() throws Exception {
String tb_seller_nick = Config.JDSellerNick ;
//业务参数
Map<String, String> data = new HashMap<String, String>();
data.put("appid", Config.AppId);
data.put("seller_nick", tb_seller_nick);
Long timestamp = System.currentTimeMillis() / 1000;
data.put("timestamp", timestamp.toString());
// 不传入param1参数,表示获取全部,否则可以根据入参条件进行查询。
// data.put("param1", "{\"cpCode\":\"YUNDA\"}");
// 参数签名
data.put("sign", Utils.Sign(data, Config.AppSecret));
doHttpRequest(Config.JDgetTemplateList, data);
}
3. 返回结果如下:
{
"code": 0,
"message": "ok",
"data": {
"devUserTemplateList": {},
"isvTemplateList": {
"customAreaList": null
},
"standardTemplateList": [
{
"providerCode": "YUNDA",
"templateList": [
{
"standardTemplateCode": "yundakd76x130",
"standardTemplateName": "韵达快递76x130",
"templateUrl": "https://template-content.jd.com/template-oss?tempCode=yundakd76x130"
},
{
"standardTemplateCode": "yundakd100x180",
"standardTemplateName": "韵达快递100x180",
"templateUrl": "https://template-content.jd.com/template-oss?tempCode=yundakd100x180"
}
]
}
],
"userTemplateList": {}
},
"trace_id": "339baa9d-de7d-4bf3-ac99-742c3cb796d2"
}
说明: code为0表示成功,非0为失败,message会包含失败原因。
4. 返回字段说明
参见https://open.jd.com/v2/#/doc/api?apiCateId=200416&apiId=100463&apiName=listPrintTemplates&gwType=1
文档更新时间: 2026-04-10 11:47 作者:admin