获取打印模板列表

获取打印模板列表。 说明：2026年04月10后按官方启用最新的获取模板接口，返回字段和老接口不兼容，请注意升级调整。

一、请求参数

请求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

|

二、请求示例代码

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);
    }

三、返回结果

{
    "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会包含失败原因。

四、返回字段说明

　参见https://open.jd.com/v2/#/doc/api?apiCateId=200416&apiId=100463&apiName=listPrintTemplates&gwType=1