SEA-760分拣机客户平台对接技术要求docx.docx

1、 深圳市欣视景科技股份有限公司 物流供应链及电商领域信息化服务供应商- 1 -SEA-760 分拣机客户平台对接技术要求深圳市欣视景科技股份有限公司深圳市欣视景科技股份有限公司 物流供应链及电商领域信息化服务供应商- 2 -Shenzhen Seagen Technology CO,.LTD.目录目录 .- 2 -1 目的 .- 3 -2 名词定义 .- 3 -3 主要技术要求及设备布局、环境要求 .- 3 -4 系统基本架构 .- 6 -5 技术要求覆盖范围 .- 6 -6 接口要求说明 .- 6 -6.1 DB 方式交接 .- 6 -6.2 HTTP 方式交接 .- 7 -7 接口要求 .

2、- 7 -7.1 通讯方式 .- 7 -7.2 基本要求 .- 7 -7.3 接口说明 .- 7 -深圳市欣视景科技股份有限公司 物流供应链及电商领域信息化服务供应商- 3 -7.3.1 运单数据接口 (WAYBILL).- 8 -7.3.2 散件数据接口 (SORTING) .- 10 -7.3.3 总包数据接口 (BOX) .- 12 -7.3.4 分拣方案数据接口（ SORT_SCHEME).- 13 -7.3.5 分拣方案明细接口（ SORTSCHEME_DETAIL) .- 14 -7.3.6 扫描记录接口 (SCAN_LISTS) .- 16 -7.3.7 运单 web 接口备用模

3、式 .- 18 -7.4 MYSQL 数据库版本 .- 19 -7.5 箱号打印 .- 19 -7.5.1 方式一 客户系统提供的箱号标签打印 .- 19 -7.5.2 方式二 客户系统提供的箱号标签打印 .- 22 -7.6 补码推送接口 .- 23 -7.7 分拣机开停状态接口 .- 24 -7.8 异常报警数据上传定义 .- 24 -深圳市欣视景科技股份有限公司 物流供应链及电商领域信息化服务供应商 - 4 -1 目的本技术要求主要描述了分拣机投入运营前，客户端需要对接的技术要求，包括客户须提供的分拣机运行所必需的供电、网络、硬件环境条件，相关数据、相关技术配合及数据交互的功能、方式、格

4、式要求等。该文档明确客户方的平台技术人员、实施人员在提供网络环境、平台功能、联调、测试时候的技术要求。本文档中，除要求客户提供的供电、网络、场地硬件环境条件外，其他部分是分拣机投入生产的必须条件。就 SEA-760 分拣机本身，在具备客户提供的供电、局域网络、场地硬件环境条件分拣机可以与客户平台系统联网独立单机运行，并对假件（包括假件数据）进行分拣处理，完成整个分拣机全部作业流程。2 名词定义1、客户平台、客户系统、客户平台系统：是指用户方接入 SEA-760 分拣机而必须提供的计算机系统的总称，只有客户平台具备了本文档的要求，SEA-760 才能具备生产条件。2、分拣机数据系统：指 SEA-

5、760 分拣机的计算机系统数据后台。3、本地：指 SEA-760 分拣所在场地。4、分拣系统：指 SEA-760 分拣机的计算机系统。5、接口：指 SEA-760 分拣机系统与客户平台系统之间的计算机数据交互协议，分拣机与客户平台系统要发生数据交互，双方必须遵守该协议。6、分拣方案：指分拣规则，包括目的地地址、条码的关联信息。3 主要技术要求及设备布局、环境要求760 交叉带分拣机实施，需要客户落实指定的网络环境及硬件环境、以及满足指定的设备运行的技术要求，具体如下： 千兆光纤网络部署：现场提供客户系统服务器和分拣机系统服务器之间的千兆光纤网络部署，配套提供一线品牌工业级千兆光纤交换机、服务器

6、千兆光纤网卡、光纤线缆等设备；深圳市欣视景科技股份有限公司 物流供应链及电商领域信息化服务供应商 - 5 - 主、备服务器及热备：客户系统和分拣系统数据服务器都要提供主从服务器并实现双机热备；由于数据量大及重要性，需要了采用如下的双机双柜热备方案；每套热备系统的设备例表如下：深圳市欣视景科技股份有限公司 物流供应链及电商领域信息化服务供应商 - 6 - 电源要求提供到柜内工业电源，电源功率满足设备使用需求，不低于 50KW。电源为三相五线制电源 380V5%，50HZ0.1HZ，接地电阻4 欧姆，现场分拣机工作期间，周边 10 米内不可存在强干扰源。 测试环境要求满足使用规格、数量的包裹。 最

7、大尺寸 400MM*300MM*200MM，最小尺寸 100MM*100MM*10MM 最小重量 0.2KG，最大重量 5KG,包裹包括条码等级为 B 级以上，条码分辨率不小于 0.5MM。包裹不包含 圆形、球形、棒状、液体等非规则异形件。 实现客服平台系统 redis 服务器的搭建实施客户平台需要安装两台 redis 服务器做大数据缓存和实时数据访问； 实现生产原始数据批量预下载功能客户平台系统按照要求格式提供单号和分拣方案批量预下载功能，分拣机数据系统可以定时提取到本地用于分拣生产；详见本文 6.3 章节 实现箱号预下载功能客户平台系统按照要求格式提供集包所需箱号预下载功能；分拣机数据系统

8、可以定时提取到本地用于分拣生产；详见本文 6.3 章节 实现分拣模式和分拣方案的动态更新可以根据运营需要，客户平台可以配置新的分拣模式及分拣方案，分拣系统定期检查设置，检查到更新后清理现场、切换执行；详见本文 6.3 章节 实现分拣数据上传接收功能深圳市欣视景科技股份有限公司 物流供应链及电商领域信息化服务供应商 - 7 -客户平台实现接收分拣系统分拣后的每一单实时分拣数据；详见本文 6.3 章节 实现分拣集包数据上传接收功能客户平台实现接收分拣系统分拣后的实时集包数据信息上传；详见本文 6.3 章节 实现扫描数据接上传收功能客户平台实现接收分拣系统扫描数据实时上传功能；详见本文 6.3 章节

9、 实现运单 WEB 接口备用模式客户平台实现运单 WEB 接口备用模式，可以与预下载模式实现条件切换；详见本文 6.3 章节 实现补码图片接收 FTP 服务、以及补码推送功能客户平台实现人工补码图片接收 FTP 服务功能，以及补码信息的推送接口功能；详见本文 6.6 章节 实现开停机状态接口功能客户平台实现每次系统开停机时候，客户平台进行登记、确认、准备、允许的处理；详见本文 6.7 章节 实现报警信息推送接口功能 客户平台实现接收分拣机设备各种类型报警信息的接口功能；详见本文 6.8 章节文档后面内容是对客户平台系统要实现的上述功能的详细定义和说明；深圳市欣视景科技股份有限公司 物流供应链及

10、电商领域信息化服务供应商 - 8 -4 系统基本架构5 技术要求覆盖范围本技术要求用于指导客户平台系统完备地实现分拣机需要的数据访问和数据交互功能，让客户平台系统能与分拣机系统实现高效的数据对接和功能衔接；6 接口要求说明6.1 DB 方式交接分拣机和客户平台系统以 mysql 方式进行交互，分拣机数据系统定时轮训客户数据，回写数据并自己深圳市欣视景科技股份有限公司 物流供应链及电商领域信息化服务供应商 - 9 -维护数据转历史等工作6.2 http 方式交接分拣机打印箱号接口以 http 方式交接，http 接口需要对数据进行缓存和转历史需要分拣机对 json 格式兼容性支持，多属性少属性都

11、不要报错。7 接口要求7.1 通讯方式分拣管理系统与客户系统之间通过局域网络（LAN）对接，采用 DB 数据表（Table）的方式进行数据交换，DB 类型为 MySQL。7.2 基本要求 数据库分拣：分拣系统接收客户系统下发的运单数据，根据运单数据中的运单目的地代码，匹配分拣方案数据，完成包裹分拣。 重量比对 原始重量数据由客户系统提供。 客户平台系统 DB 具备与分拣机系统使用连接池进行数据操作能力。 客户平台系统数据所有日期时间类型字段采用 30 位字符串方式表示，格式采用”YYYY-MM-DD HH24:MI:SS.FF9” 时间精确到纳秒。如 2015-07-20 11:49:19.5

12、87204000 客户平台系统数据库字符集采用 utf8 客户平台系统提供箱号是 JSON 交互，要兼容 JSON 属性增多或者减少；同时也要兼容 DB 表字段的新增。 客户系统要能匹配分拣机多实例、多线程的运单数据抓取方式。；深圳市欣视景科技股份有限公司 物流供应链及电商领域信息化服务供应商 - 10 -7.3 接口说明编号名 称 表名 说 明1 运单数据接口 WAYBILL 运单业务数据，用于自动化分拣。2 散件数据接口 SORTING 分拣管理系统的分拣结果明细，包括成功分拣和失败的明细分拣信息。3 总包数据接口 BOX 分拣管理系统建包数据（主要指包号、包目的地、件数等）。4 分拣方案数据接口 SORT_SCHEME 用于存放当前分拣方案的信息。5 分拣方案明细接口 SORTSCHEME_DETAIL 用于存放当前分拣方案的明细信息。6 扫描记录接口 Scan_lists 扫描记录表