VIP

2024-07-03 23:05| 来源: 网络整理| 查看: 265

接口：JITX获取面单数据接口顺丰（carrier_code：shunfeng）中通（carrier_code：zhongtong）面单坐标以及长高图例

图片1.png

面单示例

面单规范.jpg

详细字段说明序号说明字段样式描述 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 选择使用的打印机（出现下面的页面代表组件已在运行）

打印组件图.png {:width="100px" height="100px"}

1.3 沙箱切换方式

沙箱切换.png

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

【本文地址】

VIP

VIP

今日新闻

推荐新闻