VIP |
您所在的位置:网站首页 › 易打单打印组件是什么 › VIP |
接口:JITX获取面单数据接口顺丰(carrier_code:shunfeng)中通(carrier_code:zhongtong)面单坐标以及长高图例面单示例详细字段说明
序号
说明
字段
样式描述
1
包裹序号[值]
packageSeq
粗体,黑体,10.5pt,水平居中,垂直居中
1
订单总包裹数[值]
packageNum
组装格式为包裹序号[值] + 半角/*1 + 订单总包裹数[值]。如:[1]/[2]
1
订单号[标签]
labelOrderSn
黑体,15pt,水平靠左,垂直居中
1
订单号[值]
orderSn
黑体,8pt,水平靠左,垂直居中
2
承运商名称[值]
thirdCustName
黑体,15pt,水平靠左,垂直居中
2
配送时间要求[值]
transportDay
黑体,8pt,水平靠左,垂直置顶,自动换行
3
运单[标签]
labelTransportNo
黑体,9pt,水平靠左,垂直居中
3
运单[值]
transportNo
黑体,9pt,水平靠左,垂直居中
4
订单号条形码[值][条形码]
orderSn
使用该值展示条形码,也展示原值条。形码的码制 = code128A。原值的样式 = 黑体,9pt,水平居中,垂直居中
4
订单号[值]
orderSn
黑体,8pt,水平靠左,垂直居中
5
收[标签]
buyerLabel
黑体,14pt,水平居中,垂直居中
5
收件人[值]
buyer
粗体,黑体,12pt,水平靠左,垂直置顶该两字段在同框内展示,组装格式为收件人[值] + 半角空格*1 + 收件人电话[值]。如:[林*欣] [180****6515,181****0173]
5
电话[值]
buyerMobile
5
收件人四级地址[值]
buyerAddressNorm
四级地址的样式 = 粗体,黑体,12pt
5
收件人具体地址[值]
buyerAddressDetail
具体地址的样式 = 黑体,10pt
两值组合后,水平靠左,垂直置顶,并向下超框的部分不再展示
该两字段在同框内展示,组装格式为
四级地址[值] + 半角.*1 + 具体地址[值]
如:[广东省.广州市.荔湾区.花海街道].[花海街10号广新信息大厦8楼AAA座BBB室]
6
包裹序号[值]
packageSeq
粗体,黑体,10.5pt,水平居中,垂直居中
6
订单总包裹数[值]
packageNum
包裹序号[值] + 半角/*1 + 订单总包裹数[值]。如:[1]/[2]
6
运单号[值][条形码]
transportNo
使用该值展示条形码,也展示原值
条形码的码制 = code128
顺丰要求 长 = 66mm(为了避免打印环节的误差,条形码的宽度要比顺丰要求的最小宽度54大一些),高 = 13mm
上下间隔 = 2mm(上到三段码,下到子运单号)
原值的样式 = 粗体,黑体,13.5pt,水平居中,垂直居中
6
入港映射码[值]
codemapping
黑体,22pt,水平靠右,垂直居中
6
子运单[标签][值]
childTransportNo
黑体,9pt,水平靠左,垂直居中
6
母运单[标签][值]
parentTransportNo
黑体,9pt,水平靠左,垂直居中
6
运单[标签][值]
transportNo
黑体,9pt,水平靠左,垂直居中
7
时效类型[值]
proCode
图片【宽*高:20mm*20mm】
8
三段码[值]
pickCode
粗体,黑体,22pt,水平居中,垂直居中
9
二维码[图]
qrCodeImg
图片【宽*高:23mm*23mm】二维码容错率改为低
9
二维码[值]
qrCode
【注:为避免目的地与二维码重叠,需要将目的地置为底层,以保证二维码信息完整清晰显示】
10
包裹内的商品信息[值][数组]
goodsInfo
每行的样式 = 黑体,7.5pt,水平靠左,垂直置顶。超出该框范围,则文本不再展示
该值当前为供应商自行控制,为了方便拣选和核实,建议填写商品相关信息,格式为
$货号*$颜色*$尺寸*$数量,如:6891231021*红色*XL*1
10
打印时间[标签]
labelPrintDay
黑体,7pt,水平居中,垂直居中
10
打印时间[日期]
labelPrintDate
黑体,7pt,水平居中,垂直居中
10
打印时间[时间]
labelPrintTime
黑体,7pt,水平居中,垂直居中
10
已安检[标签]
lableChecked
黑体,7pt,水平居中,垂直居中
10
已验视[标签]
lableInspected
黑体,7pt,水平居中,垂直居中
10
签收[标签]
labelSign
黑体,7pt,水平居中,垂直居中
10
订单号[标签]
labelSuborderSn
黑体,7pt,水平居中,垂直居中
10
订单号[值]
suborderSn
黑体,7.5pt,水平靠左,垂直居中
10
承载物类型
transportType
粗体,黑体,9pt,水平靠左,垂直居中
11
JITX[标签]
jitxLabel
粗体,黑体,9pt,水平靠左,垂直居中
12
预包装标识[值]
prePackageLabel
粗体,黑体,10.5pt,水平靠左,垂直居中
12
换货标识[值]
changeLabel
粗体,黑体,10.5pt,水平靠左,垂直居中(揽换订单可不打印此标记,已在三段码体现)
打印组件 打印组件下载:唯品会打印组件下载 1、安装唯品会打印组件1.1 下载打印组件后,直接打开1.2 选择使用的打印机(出现下面的页面代表组件已在运行){:width="100px" height="100px"} 1.3 沙箱切换方式2、获取面单数据2.1 获取面单数据接口: 获取JITX面单数据接口 3、统一请求协议启用打印机请求地址: ws://127.0.0.1:12233 请求通用协议头 字段名 类型 说明 是否必须 cmd string 请求的命令名称,具体如下:getPrinters:获取打印机列表; setPrinter:设置默认打印机; print:打印面单 是 requestID string 请求的ID,用于唯一标识每个请求,每个客户端自己保证生成唯一ID,如UUID 是 响应通用协议头 字段名 类型 说明 cmd string 请求的命令名称 (setPrinter、getPrinters、print) requestID string 发送请求中的ID,原封不动返回,使客户端能识别出哪个请求对应的响应 code int 200: 成功; 201:存在打印失败的数据;202:参数无效;203:业务参数缺失;204:面单渲染失败;500:系统处理异常;9999:未知异常 msg string 返回信息 3.1 获取打印机列表(getPrinters)请求示例: { "cmd": "getPrinters", "requestID": "123458976" } 响应示例: { "cmd": "getPrinters", "requestID": "123458976", "code": 200, "defaultPrinter": "XX快递打印机", "printers": [{ "name": "XX快递打印机" }, { "name": "YY物流打印机" }] } 字段名 类型 说明 defaultPrinter string 默认打印机 name string 打印机的名字 3.2 设置默认打印机(setPrinter)请求示例: { "cmd": "setPrinter", "requestID": "147258369", "printer": "XX快递打印机" , "printerMargin": "10,0,0,0" } 字段名 类型 说明 printer string 打印机的名字 printerMargin string 非必填,持久性修改,打印机的偏移量。格式为 left,right,top,bottom(,为半角英文逗号,数字格式为非负数,两个小数内,不符合格式要求的会处理成0)。例如:0,0,0,0 成功响应示例: { "cmd": "setPrinter", "requestID": "147258369", "code": 200, "msg": "设置默认打印机成功" "printer": "当前打印机" , "printerMargin": "10,0,0,0" } 失败响应示例: { "cmd": "setPrinter", "requestID": "147258369", "code":202, "msg": "设置默认打印机失败,请检查传入参数是否为可用打印机名称" } 3.3 打印面单(print)请求样例下载:JIT&JITX面单组件请求样例提取码: (提取码:murd) 请求字段说明: 层级 字段 中文 类型 必填/可选 描述 1 cmd 指令 String 必填 请求的命令名称,具体如下:getPrinters:获取打印机列表。setPrinter:设置默认打印机。print:打印面单 1 requestID 请求的ID String 必填 请求的ID,用于唯一标识每个请求,每个客户端自己保证生成唯一ID,如UUID 1 task 打印任务 String 必填 打印任务 2 traceId 打印请求ID String 必填 每次请求唯一,长度不超过20位 2 actionType 打印方式 String 必填 传PRINT: 直接打印 PREVIEW:预览 2 storeId 供应商编码 String 必填 供应商编码 2 channel 业务渠道 String 必填 传600,代表JITX 2 printerName 打印机名称 String 可选 不填时为默认打印机 2 printerMargin 打印机偏移量 String 可选 当次打印的打印机偏移量。格式为 left,right,top,bottom(,为半角英文逗号,数字格式为非负数,两个小数内,不符合格式要求的会处理成0)。例如:0,0,0,0 2 printParamDTO 面单数据对象 PrintParamDTO 必填 2 platformTemplateURL 平台模板url String 选填 取【JITX获取面单数据接口】返回的 platformTemplateURL,并且当customerTemplate、platformTemplateURL同时有值才自行组合形成打印模板内容,否则默认打印标准平台模板内容 2 customerTemplate 自定义区域模板 String 选填 自行设计区域模板,customerTemplate仅支持符合http://hiprint.io/design配置的json格式,区域大小宽60高18,并且当customerTemplate、platformTemplateURL同时有值才自行组合形成打印模板内容,否则默认打印标准平台模板内容,注意 打印组件8.44以上版本才支持自定义区域 3 templateUrl 模板url String 必填 取【JITX获取面单数据接口】返回的 template_url 3 printDatas 面单数据 List 必填 面单数据的列表 4 printData 面单数据 String 必填 取【JITX获取面单数据接口】返回的 order_label,不用解析,直接传入 4 printId 打印任务ID String 必填 打印任务ID,区别每次打印任务 4 customData 自定义内容配置 Map 选填 1.标准模板仅支持一个key:goodsInfos,可将内容组装到这个key 输出,支持br换行符。 2. customerTemplate自定义区域自定义的字段值,需要在此传入对应的key和值 响应字段说明 层级 字段 中文 类型 必填/可选 描述 1 traceId 打印请求ID String 可选 每次请求唯一(返回你入参的traceId) 1 code 响应结果 String 必填 枚举值 : 200:打印成功, 201:存在打印失败的数据, 202:参数格式问题 (传参不为JSON,或传参缺少必填参数等), 203:业务参数缺失(例如店铺缺少密钥,根据templateUrl找不到有效的模板信息),500 :系统处理异常 1 total 传入打印数据数 int 可选 1 requestID 请求ID String 可选 原封不动返回 1 msg 错误描述 String 可选 1 details 打印结果 String 可选 打印结果 2 row 打印数据行号 int 可选 标识哪一行,避免printId不传的时候区分不了 2 status 打印状态 String 可选 success:成功;fail:失败 2 msg 打印信息 String 可选 2 printId 打印ID String 可选 区别每次打印任务 3.4 常见问题 序号 问题描述 排查方式 1 打印报错:打印模板不存在或非在用模板,请尝试重新获取模板后重试! 查看打印插件下的日志,发现提示店铺未生成对应的密钥对,请联系业务人员配置! a.组件版本是不是8.36以上 b. 检查打印传参是不是没有传channel 参考3.3 请求字段说明 c. 检查打印组件高级设置的调用环境是不是选择错误 d. templateurl是来源于getprinttemplate服务;调用接口getPrintTemplate 时,字段template_type要入参PRINT,且必须大写的PRINT 2 面单打印失败,打印不出来,或者自定义字段显示值不对 a.检查打印传参是不是按3.3 请求字段说明的层级传参b. 检查printData传参是不是做了处理,直接取平台返回值不需要做处理其他问题可提供打印插件的debug日志给平台技术排查 附件下载:JITX包裹面单 提取码:czvl请求样例下载:JIT&JITX面单组件请求样例提取码: jxqy |
今日新闻 |
推荐新闻 |
CopyRight 2018-2019 办公设备维修网 版权所有 豫ICP备15022753号-3 |