YZ∕T 0173-2020 智能信包箱和智能快件箱监管数据接入规范

目　　次前言Ⅱ…………………………………………………………………………………………………………1　范围1………………………………………………………………………………………………………2　规范性引用文件1…………………………………………………………………………………………3　术语和定义1………………………………………………………………………………………………4　缩略语2……………………………………………………………………………………………………5　数据接入类型2……………………………………………………………………………………………6　数据接入业务流程3………………………………………………………………………………………　6.1　数据接入业务流程图3………………………………………………………………………………　6.2　数据接入业务流程3…………………………………………………………………………………7　通信协议4…………………………………………………………………………………………………　7.1　传输协议4……………………………………………………………………………………………　7.2　报文格式4……………………………………………………………………………………………8　信息报文4…………………………………………………………………………………………………　8.1　报文种类4……………………………………………………………………………………………　8.2　报文数据类型5………………………………………………………………………………………　8.3　智能信包箱监管数据报文接口5……………………………………………………………………　8.4　智能快件箱监管数据报文接口12……………………………………………………………………　8.5　接入流程19……………………………………………………………………………………………9　数据控制20…………………………………………………………………………………………………　9.1　数据兼容性要求20……………………………………………………………………………………　9.2　加密方式20……………………………………………………………………………………………　9.3　数据完整性20…………………………………………………………………………………………　9.4　数据网络传输安全性20………………………………………………………………………………10　数据接入频次20…………………………………………………………………………………………ⅠYZ/T0173—2020前　　言本文件按照GB/T1.1—2020《标准化工作导则　第1部分:标准化文件的结构和起草规则》的规定起草。请注意本文件的某些内容可能涉及专利。本文件的发布机构不承担识别专利的责任。本文件由国家邮政局提出。本文件由全国邮政业标准化技术委员会(SAC/TC462)归口。本文件起草单位:国邮恒安(北京)科技有限公司、国家邮政局邮政业安全中心。本文件主要起草人:许良锋、陈嵩、王丰、任仰奇、杨阳、靳宗振、宫良一、张彬、简耀耀。ⅡYZ/T0173—2020智能信包箱和智能快件箱监管数据接入规范1　范围本文件规定了智能信包箱和智能快件箱监管数据的接入类型、接入流程、通信协议、信息报文、数据控制、数据接入频次等内容。本文件适用于智能信包箱和智能快件箱监管数据的接入。2　规范性引用文件下列文件的内容通过文中的规范性引用而构成本文件必不可少的条款。其中,注日期的引用文件,仅该日期对应的版本适用于本文件;不注日期的引用文件,其最新版本(包括所有的修改单)适用于本文件。GB/T10757　邮政业术语GB/T24295　智能信包箱GB/T27917.1　快递服务　第1部分:基本术语YZ/T0132—2013　邮政业机构代码编制规则YZ/T0133—2013　智能快件箱YZ/T0143—2015　快件基础数据元3　术语和定义GB/T10757、GB/T24295、GB/T27917.1和YZ/T0133界定的以及下列术语和定义适用于本文件。　3.1智能信包箱　intelligentmail&parcellocker应用信息技术控制与管理,通过密码验证、电子验证、生物识别和其他身份识别方式进行操作,供用户接收邮件和快件的智能服务终端。[来源:GB/T24295,3.1]3.2智能快件箱　intelligentself-expressservicemachine设立在公共场合,可供寄递企业投递和用户交寄、提取快件的自助服务设备。[来源:YZ/T0133—2013,3.1,有修改]3.3邮件　mail通过邮政企业寄递的信件、包裹、汇款通知、报刊和其他印刷品等的统称。[来源:GB/T10757—2011,5.1.1]3.4快件　expressitem快递服务组织依法递送的信件、包裹、印刷品等的统称。[来源:GB/T27917.1—2011,2.3]1YZ/T0173—20203.5收件人　receiver邮件或快件名址中指定的接收个人或单位。[来源:GB/T10757—2011,3.4]3.6寄件人　sender交寄邮件或快件的个人或单位。[来源:GB/T10757—2011,3.3]4　缩略语下列缩略语适用于本文件,见表1。表1　缩　略　语编号缩　略　语中文名称英文名称1HTTP超文本传输协议HyperTextTransferProtocol2HTTPS安全超文本传输协议HyperTextTransferProtocoloverSecureSocketLayer3JSONJavaScript对象简谱JavaScriptObjectNotation4DES数据加密标准DataEncryptionStandard53DES三重数据加密标准TripleDataEncryptionStandard6URL统一资源标识符UniformResourceLocator7FTP文件传输协议FileTransferProtocol5　数据接入类型智能信包箱和智能快件箱运营组织信息系统接入邮政管理部门信息系统数据类型见表2。表2　智能信包箱和智能快件箱运营组织信息系统接入邮政管理部门信息系统数据类型接入类型接入数据项发　送　方接　收　方智能信包箱监管数据投递信息取件信息取回信息投递员(包含邮政投递员和快递员)信息设备信息视频信息智能信包箱运营组织信息系统邮政管理部门信息系统智能快件箱监管数据投递信息取件信息取回信息智能快件箱运营组织信息系统邮政管理部门信息系统2YZ/T0173—2020表2(续)接入类型接入数据项发　送　方接　收　方智能快件箱监管数据寄件信息揽件信息快递员信息设备信息视频信息智能快件箱运营组织信息系统邮政管理部门信息系统6　数据接入业务流程6.1　数据接入业务流程图智能信包箱和智能快件箱运营组织信息系统接入邮政管理部门信息系统的业务流程如图1所示。图1　信息接入业务流程6.2　数据接入业务流程智能信包箱和智能快件箱运营组织信息系统接入邮政管理部门信息系统的业务流程说明如下:a)　智能信包箱运营组织信息系统将投递信息、取件信息、取回信息等运营数据实时发送至邮政管理部门信息系统,投递员信息、设备信息、视频信息等数据按需发送至邮政管理部门信息系统,邮政管理部门信息系统实时返回数据接收结果;b)　智能快件箱运营组织信息系统将投递信息、取件信息、取回信息、寄件信息、揽件信息等运营数据实时发送至邮政管理部门信息系统,快递员信息、设备信息、视频信息等数据按需发送至邮政管理部门信息系统,邮政管理部门信息系统实时返回数据接收结果。3YZ/T0173—20207　通信协议7.1　传输协议智能信包箱和智能快件箱运营组织信息系统与邮政管理部门信息系统的报文传输应采用HTTP协议,数据发送采用POST方式。对涉及安全信息的报文,应采用HTTPS协议。7.2　报文格式智能信包箱和智能快件箱监管数据接入报文应采用JSON格式。8　信息报文8.1　报文种类智能信包箱和智能快件箱监管数据接入的报文种类见表3、表4。表3　智能信包箱数据接入报文类型序号报文代码报文名称发　送　方接　收　方121101投递信息智能信包箱运营组织信息系统邮政管理部门信息系统221102取件信息智能信包箱运营组织信息系统邮政管理部门信息系统321103取回信息智能信包箱运营组织信息系统邮政管理部门信息系统421201投递员信息智能信包箱运营组织信息系统邮政管理部门信息系统521202设备信息智能信包箱运营组织信息系统邮政管理部门信息系统621203视频信息智能信包箱运营组织信息系统邮政管理部门信息系统表4　智能快件箱信息接入报文类型序号报文代码报文名称发　送　方接　收　方131101投递信息智能快件箱运营组织信息系统邮政管理部门信息系统231102取件信息智能快件箱运营组织信息系统邮政管理部门信息系统331103取回信息智能快件箱运营组织信息系统邮政管理部门信息系统4YZ/T0173—2020表4(续)序号报文代码报文名称发　送　方接　收　方431104寄件信息智能快件箱运营组织信息系统邮政管理部门信息系统531105揽件信息智能快件箱运营组织信息系统邮政管理部门信息系统631201快递员信息智能快件箱运营组织信息系统邮政管理部门信息系统731202设备信息智能快件箱运营组织信息系统邮政管理部门信息系统831203视频信息智能快件箱运营组织信息系统邮政管理部门信息系统8.2　报文数据类型智能信包箱和智能快件箱监管数据接入报文中使用的数据类型见表5。表5　数据类型序　　号数据类型说　　明1String字符串2Number数值型3Long长整型8.3　智能信包箱监管数据报文接口8.3.1　投递信息8.3.1.1　描述投递员通过智能信包箱完成邮件、快件投递时的基本信息,包括运单信息、收件人信息、投递时间等,由智能信包箱运营组织信息系统发送信息给邮政管理部门信息系统。8.3.1.2　信息项说明该信息接入项所涉及的邮件、快件主要投递信息数据元分别见表6、表7。表6　邮件投递信息数据元序号字　段　名中　文　名数据类型最大长度是否为空说　　明1messageNumber报文流水号String20N　标识报文的唯一编码2messageCode报文代码String5N　见表33serviceOrganizationCode智能信包箱运营组织代码String18N　标识智能信包箱运营组织的代码,可采用企业社会信用代码5YZ/T0173—2020表6(续)序号字　段　名中　文　名数据类型最大长度是否为空说　　明4postalManageCode邮政管理部门代码String10N　编制规则符合YZ/T0132—2013相关要求5trackNumber邮件编号String35N　邮件包裹、平信、函件可使用包裹单编号、条码编号等;其他没有条码的邮件可采用智能信包箱运营组织系统为记录邮件唯一性生成的编号6mailType邮件类型String3N　101:包裹;　102:平信、平刷;　103:报刊;　104:挂号函件;　999:其他7receiverName收件人名称String32Y　见YZ/T0143—2015中的6.5.18receiverMobilePhone收件人电话String32Y　见YZ/T0143—2015中的6.5.79receiverAddress收件人地址String256Y　见YZ/T0143—2015中的6.5.610cabinetCode智能信包箱代码String26N　见GB/T24295中的9.111pigeonholesNumber格口代码String6N　见GB/T24295中的9.2　12pigeonholesType格口类型String3N　201:超小型格口;　202:小型格口;　203:中型格口;　204:大型格口13inCabinetTime投递时间Long24N　投递员将邮件放入设备中的时间,格式:　YYYYMMDDhhmmss14de