T_GJSH 000027-2023 医药类物品寄递信息交换规范.docx

ICS35.240.60CCSM 80GJSH 上 海 市 工 商 联 国 际 物 流 商 会 团 体 标 准T/GJSH 0000272023医药类物品寄递信息交换规范Information exchange standards for posting and delivery of pharmaceutical goods2023 - 08 - 25 发布2023 - 09 - 04 实施上海市工商联国际物流商会发 布目录前言II 1 范围1 2 规范性引用文件1 3 术语和定义1 4 缩略语1 5 信息交换需求2 6 信息交换流程3 7 通信接口4 8 信息安全要求4 9 报文规范4 参 考 文 献18 前言本文件按照GB/T 1.12020标准化工作导则 第1部分：标准化文件的结构和起草规则的规定起草。 本文件由上海市工商联国际物流商会提出。本文件由上海市工商联国际物流商会归口。 本文件起草单位：国家邮政局邮政业安全中心、邮政科学研究规划院有限公司、国药控股上海生物医药有限公司、华润医药商业集团有限公司、九州通医药集团物流有限公司、天津国药智辉科技有限公司、北海国药如倍健康科技有限公司、叮当健康科技集团有限公司、顺丰医药供应链有限公司、中科共配科技（北京）有限公司、北京宇卫科技有限公司（SCMsafe链四方）。 本文件主要起草人：李妍慧、孟硕、刘子瑛、刘俊林、孟凡磊、戴广胜、王维康、王霖岩、徐建军、王海生、邱培刚、王云鹏、何清文等。 本标准文件未涉及知识产权。 医药类物品寄递信息交换规范1 范围本文件规定了医药类物品在寄递服务过程中各个环节信息交换需求、信息交换流程、通信接口、信息安全要求和报文规范。 本文件适用于可采用寄递服务的医药类物品，包含药品、医疗器械等物品（法律另有规定的除外）。 2 规范性引用文件下列文件中的内容通过文中的规范性引用而构成本文件必不可少的条款。其中，注日期的引用文件， 仅该日期对应的版本适用于本文件；不注日期的引用文件，其最新版本（包括所有的修改单）适用于本文件。 GB/T 107572011 邮政业术语 GB/T 27917.12011 快递服务 第1部分：基本术语YZ/T 01692019 邮件快件实名收寄信息交换规范YZ/T 01852022 邮件快件实名收寄验视操作规范 YZ/T 01522016 邮政业信息系统安全等级保护基本要求 3 术语和定义下列术语和定义适用于本文件。 寄 递 posting and delivery接受用户委托,将信件、包裹、印刷品等物品,通过收寄、分拣、运输、投递等环节,按照封装上的名址递送给特定个人或单位的活动。 来源：GB/T 107572011,2.2 寄递企业 mail and express service organization邮政企业、快递企业、经营邮政通信业务的企业的统称。 来源：YZ/T 0185-2022,3.4 寄件人 sender交寄邮件或快件的个人或单位。 来源：GB/T 107572011,3.3 运单 waybill邮件详情单、快递运单、快递电子运单的统称。 来源：YZ/T 0185-2022,3.3医药类物品寄递信息数据交换平台 pharmaceutical goods posting and delivery data change platform接受寄递企业和寄件人信息系统数据，并对相关数据进行转发交换的信息系统，简称数据交换平台。 标识码 Identification code 在寄递过程对医药类物品进行唯一标识的代码。 4 缩略语下列缩略语适用于本文件。 GPS:全球定位系统（Global Positioning System） JSON: 对 象 简 谱 （Java Script Object Notation） XML:可扩展标记语言（Extensible Markup Language） HTTPS:安全超文本传输协议（Hyper Text Transfer Protocol over Secure Socket Layer） AMQP:高级队列消息协议（Advanced Message Queuing Protocol） 5 信息交换需求医药类物品的信息交换需求应符合表1的规定。 表1 信息交换需求信息分类 信息名称 信息属性 信息项 发送方 接收方 交换频次 基础数据信息 备案信息 静态数据信息人员备案信息 寄递企业 数据交换平台/ 寄件人 发生变化时交换一次 车辆备案信息 保温箱备案信息 温度计备案信息 动态数据信息设备档案信息 寄递企业 数据交换平台/ 寄件人 发生变化时交换一次 业务 （作业） 数 据 信息 单据信息 静态数据信息订单信息 寄件人 数据交换平台/ 寄递企业 发生变化时交换一次 运单信息 数据交换平台/ 寄递企业 寄件人/ 数据交换平台 发生变化时交换一次 回单信息 寄递企业 数据交换平台/ 寄件人 发生变化时交换一次 标识码信息静态数据信息标识码与面单绑定信息寄件人/寄递企业数据交换平台 发生变化时交换一次 标识码批量获取信息 寄件人/寄递企业数据交换平台 发生变化时交换一次 标识码状态信息 寄件人/寄递企业数据交换平台 发生变化时交换一次 状态信息 动态数据信息状态信息 寄递企业 数据交换平台 发生变化时交换一次 设备绑定信息 静态数据信息设备绑定关系信息 寄件人/寄递企业数据交换平台/ 寄件人 发生变化时交换一次 设备节点信息 寄件人/寄递企业数据交换平台/ 寄件人 发生变化时交换一次 设备数据信息 动态数据信息温度传感数据信息 寄递企业 数据交换平台/ 寄件人 定时上传，在运输过程中至少每5分钟自动记录一次实时温度数据，监测温度超过规定范围时至少每2分钟记录一次。在库房中至少每30分钟自动记录一次 GPS信息 寄递企业 数据交换平台/ 寄件人 定时上传 a) 寄递有温控要求的医药类物品，寄递企业应提前向数据交换平台提供备案信息，包括人员备案信息（表 4-表 6）、车辆备案信息（表 7）、保温箱备案信息（表 8）、温度计备案信息（表9）和设备档案信息（表 10），数据交换平台接受相关信息并记录，发送给寄件人。 b) 寄件人根据实际业务场景发送订单信息（表 11-表 17）给数据交换平台和寄递企业，寄递企业发送快递订单信息（表 18）和面单信息（表 20）给数据交换平台和寄件人。 c) 寄递企业根据实际运输状态向寄件人或数据交换平台实时回传运输中的状态节点信息(表 22）。d) 运输作业过程中寄递企业根据业务场景返回寄件人或数据交换平台设备绑定关系信息（表 23-表 24）与设备节点信息（表 25）。 e) 寄递企业根据业务场景，向数据交换平台及寄件人回传设备数据信息（表 26-表 27）和轨迹信息（表 28）。 f) 寄件人可向数据交换平台申请标识码（表 29），数据交换平台按订单号获取标识码，并将运单号和标识码绑定。 g) 寄递服务结束后，寄递企业发送回单信息（表 21）给数据交换平台和寄件人。 6 信息交换流程医药类物品信息交换流程如图1所示。 图1 医药类物品信息交换流程7 通信接口医药类物品寄递信息交换应采用常用报文协议和通信协议。常用报文协议有JSON和XML。常用的通信协议与方式有HTTPS、AMQP和数据库中间表等。 8 信息安全要求相关信息系统在进行数据交换时应采用安全通信通道进行，应采用国密算法对报文数据进行加解密、签名和验签，确保数据传输的安全性、完整性、一致性和不可抵赖性。 相关信息系统应对收件人、寄件人、收派员等相关从业人员及医药类物品的敏感信息进行脱敏处理，实现数据的可靠保护。 相关信息系统应具备不低于 YZ/T 0152-2016 中规定的第三级安全保护能力。相关信息宜采用区块链技术以确保信息不被篡改。 9 报文规范报文接口描述属性报文接口用序号、字段名、数据类型及格式、约束/条件、描述及要求5个属性描述，具体见表2。 表2 报文接口描述属性序号 描述属性 说明 1 序号 数据元在传入参数中的排序 2 字段名 数据库的字段名称 3 数据类型及格式 数据元的数据取值类型以及数据传输允许的最大长度，单位为字节（没有则默认最大限制为1000） 4 约束/条件 数据元是必备的或可选的，“M”表示该数据元是必备的，“O”表示该数据元是可选的，“C”表示条件必选 5 说明 数据源的简要解释和应用说明 数据类型报文信息的数据类型应符合表3的规定。 表3 报文信息数据类型序号 数据类型 说明 1 String 字符串类型 表示文本数据，通常用于表示名称、描述等 2 Bool 布尔类型 表示真或假的值 3 Integer 整型类型 表示整数数据，用于表示数量、计数等 4 Double 双精度类型 表示带有小数点的数值，用于表示浮点数、经纬度等 5 Timestamp 时间戳 表示日期和时间的数据类型 6 List 列表类型 表示多个相同类型的值的集合 7 Bean 对象类型 表示包含多个属性的复杂数据结构，每个属性都有自己的数据类型 报文接口9.3.1 备案信息9.3.1.1 人员备案信息人员备案信息应符合表 4 的规定。 表4 人员备案信息序号 字段名 数据类型及格式 约束/条件 描述及要求 1 idCard 司机或配送员的身份证号String(20) M 司机或者配送员身份证号 2 name 人员姓名 String(30) M 人员的真实姓名 3 phone 司机或配送员手机号 String(20) M 人员手机号 4 delivererDocument 司机配送员相关证件备案信息 List M 司机或配送员的相关证件列表见表5 5 remark 备注 String(100) O 人员相关备注 表5 人员基本信息序号 字段名 数据类型及格式 约束/条件 描述及要求 1 type 证件类型 Integer M 1:身份证，2:驾驶证，3:工作证，4:体检附件，5:健康证，6:从业资格证 2 code 证件编号 String(30) M 对应证件的编号 3 issuingAuthority 发证机关 String(100) M 发证机关单位名称 4 startTime 有效期开始时间 Timestamp O 证件有效期开始时间 5 endTime 有效期结束时间 Timestamp O 证件有效期结束时间 6 attachment 档案附件 List O 可传入多个附件，单个附件大小不能超过5M，附件总数不能超过10个，见表6 表6 附件信息序号 字段名 数据类型及格式 约束/条件 描述及要求 1 contentType 文件类型 String(10) M 描述文件的类型 2 size 文件大小 String(10) M 文件大小 3 url 文件URL String O 不上传文件，使用外链时才有用，文件上传时应为空 4 originalFilename 原文件名 String(64) M 文件命 5 content 文件内容 String M Base64编码的字节数组 9.3.1.2 车辆备案信息车辆备案信息应符合表7的规定。 表7 车辆备案信息序号 字段名 数据类型及格式 约束/条件 描述及要求 1 vehicleNo 车牌号唯一标识 String(30) M 车牌号 2 vehicleType 车辆型号 String(30) M 车辆型号 3 vehicleAge 车辆使用年限 Integer O 车辆的使用年限 4 vehicleRegDate 车辆注册日期 Timestamp O 车辆注册日期 5 vehicleRemarks 车辆备注 String O 车辆备注 9.3.1.3 保温箱备案信息保温箱备案信息应符合表8的规定。 表8 保温箱备案信息序号 字段名 数据类型及格式 约束/条件 描述及要求 1 boxCode 保温箱唯一识别码 String(30) M 保温箱编码 2 boxType 保温箱型号 String(10) M 保温箱型号 3 boxSpecs 保温箱规格 String(10) O 保温箱的规格 4 boxBrand 保温箱品牌 String(10) O 保温箱的品牌 5 boxName 保温箱名称 String(10) O 保温箱自定义的名称 6 remarks 备注 String O 保温箱备注 9.3.1.4 温度计备案信息温度计备案信息应符合表9的规定。 表9 温度计备案信息序号 字段名 数据类型及格式 约束/条件 描述及要求 1 thermometerCode 温度计唯一识别码 String（30） M 温度计的唯一编号 2 thermometerType 温度计型号 String（10） M 温度计的型号 3 thermometerBrand 温度计品牌 String（10） O 温度计品牌 4 thermometerName 温度计名称 String（10） O 温度计名称 5 remarks 备注 String O 温度计备注 9.3.1.5 设备档案信息设备档案信息为设备周期性备案档案信息，承运有温控要求的医药类物品前要做好备案，设备档案信息应符合表10的规定。 表10 设备档案信息序号 字段名 数据类型及格式 约束/条件 描述及要求 1 recordCode 档案编号 String（30） M 效期档案的唯一编号 2 recordType 档案类型 String（30） M 例如:车辆验证报告、温度计校准报告等 3 deviceType 设备类型 Integer M 1.车辆 2.保温箱 3.温度计 4 deviceModel 设备型号 String（10） O 设备型号 5 deviceCodes 车牌、保温箱编号、温度计编号 List M 当报告包含多个设备时可批量传入设备号6 periodStrTime 效期开始时间 Timestamp M 例如冷藏车辆验证报告或温度计校准的开始时间 7 periodEndTime 效期结束时间 Timestamp M 例如冷藏车辆验证报告或温度计校准的结束时间 8 attachment 档案附件 List O 可传入多个附件,单个附件大小不能超过5M,附件总数不能超过10个，见表6 9.3.2 单据信息9.3.2.1 订单信息 批量订单需要整车或者零担运输时按此规范进行批量订单下发，应符合表11的规定。 表11 批量订单信息序号 字段名 数据类型及格式 约束/条件 描述及要求 1 transportCode 任务单号 String(30) M 寄件人本次下发的整体任务单号 2 orders 订单信息 List M 包含的订单信息见表12 表12 订单信息序号 字段名 数据类型及格式 约束/条件 描述及要求 1 clientNo 客户单号 String(30) M 寄件人或寄件人客户发起寄件指令的单号 2 originalNo 原始单号 String(30) M 寄件人上游系统 3 totalNum 总件数 Integer M 货物总件数 4 totalWeight 总重量 Double(16,3) O 货物总重量 表12 订单信息（续）序号 字段名 数据类型及格式 约束/条件 描述及要求 5 totalVolume 总体积 Double(16,2) O 货物总体积 6 cargoType 货物类型 String（10） O 货物类型:药品、器械、疫苗 7 demand 寄递要求 Bean O 寄递的要求见表13 8 entrustName 委托方名称 String（30） O 寄件人的货主或者委托人的名称 9 sender 寄件人信息 Bean M 寄件人信息 见表14 10 Receiver 收件人信息 Bean M 收件人信息 见表15 11 orderItem 商品信息 List O 运输的商品信息 见表16 12 orderBox 货物包装信息 List O 运输的货物包装信息 见表17 表13 寄递要求信息序号 字段名 数据类型及格式 约束/条件 描述及要求 1 takePeriodStr 最早提货时间 Timestamp O 要求的提货最早到达时间 2 takePeriodEnd 最晚提货时间 Timestamp O 要求的提货最晚到达时间 3 arrivalPeriodStr 最早送达时间 Timestamp O 要求的最早送达时间 4 arrivalPeriodStr 最晚送达时间 Timestamp O 要求的最晚送达时间 5 controlType 温控要求 Integer O 0:常温；1:冷链 6 temperatureMin 温度要求:最低温度 Double(10,1) C 温区最低温度，精确到小数点后1位 7 temperatureMax 温度要求:最高温度 Double(10,1) C 温区最高温度，精确到小数点后1位 8 transportType 运输方式 Integer O 1:公路运输；2:航空运输；3:铁路运输；4：水路运输；9：综合运输方式 9 shippingType 运输类型 Integer O 1:整车；2:零担 10 demandVehicle 车辆要求 String（64） M 对车辆的要求 11 demandDriver 配送人员要求 String（64） M 对配送人员的要求 12 remarks 要求备注 String O 备注 13 returnReceipt 是否要求回单 Boolean O 可以不填写，默认为否 表14 寄件人信息序号 字段名 数据类型及格式 约束/条件 描述及要求 1 companyName 寄件人公司名称 String（30） O 寄件人的公司名称 2 linkman 寄件人联系人 String（30） M 寄件人联系人姓名 3 linkPhone 寄件人联系电话 String（20） M 寄件联系人电话 4 address 寄件人地址 String（200） M 寄件人联系地址 5 provinceName 省名称 String(30) O 寄件省 6 cityName 市名称 String(30) O 寄件市 7 county 所在县/区级行政区名称String(30) O 寄件区，必须是标准的县/区称谓，如：福田区，南涧彝族自治县、准格尔旗等 8 townName 乡/镇级的四级行政区 String(30) O 寄件乡镇 表15 收件人信息序号 字段名 数据类型及格式 约束/条件 描述及要求 1 companyName 收件人公司名称 String(30) M 收件人公司名称 2 linkman 收件人联系人 String(20) M 收件联系人姓名 3 linkPhone 收件人联系电话 String(20) M 收件人联系电话 4 address 收件人地址 String(200) M 收件人地址 5 provinceName 省名称 String(30) M 收件省 6 cityName 市名称 String(30) M 收件市 7 county 所在县/区级行政区名称String(30) M 收件区，必须是标准的县/区称谓，如： 福田区，南涧彝族自治县、准格尔旗等 8 townName 乡/镇级的四级行政区 String(30) M 寄件乡镇 表16 货品信息序号 字段名 数据类型及格式 约束/条件 描述及要求 1 code 货品编号 String(60) M 货品的编码 2 name 货品名称 String(30) M 货品名称 3 commonName 通用名称 String(30) O 货品通用名 4 commonName 批准文号 String(60) O 药品的批准文号编码或器械的备案唯一码 表16 货品信息（续）序号 字段名 数据类型及格式 约束/条件 描述及要求 5 approvalCode 批次 String(60) O 生产批次号 6 specification 规格 String(50) O 货品的规格 7 model 型号 String(50) O 货品型号 8 manufacturer 生产商 String(30) O 生产厂家 9 manufactureTime 生产日期 Timestamp O 生产日期 10 validityTime 有效期至 Timestamp O 有效期 11 num 数量 Integer M 数量 12 boxCode 箱码 String(60) O 货品所在包装箱码 表17 货物包装信息序号 字段名 数据类型及格式 约束/条件 描述及要求 1 boxType 装箱方式 String(20) O 装箱的方式，例如:整箱、拼箱 2 packageType 包装类型 String(20) O 如:纸箱、塑料箱 3 boxCode 箱码 String(60) O 箱码 4 cargoName 货物类型 String(20) O 货物类型，例如:药品、器械、疫苗 5 weight 重量 Double(16,3) O 重量，单位:KG 6 volume 体积 Double(16.2) O 体积，单位:立方毫米 7 length 长 Integer O 长，单位:毫米 8 width 宽 Integer O 宽，单位:毫米 9 height 高 Integer O 高，单位:毫米 9.3.2.2 快递订单信息 快递订单信息应符合表18的规定。 表18 快递订单信息序号 字段名 数据类型及格式 约束/条件 描述及要求 1 receiver 收件人信息 Bean M 收件人信息见表15 2 sender 寄件人信息 Bean M 寄件人信息 见表14 表18 快递订单信息（续）序号 字段名 数据类型及格式 约束/条件 描述及要求 3 payment 支付方式 String(20) O 由快递公司提供的支付方式 4 serviceType 业务类型 String(20) O 快递公司提供编码 5 totalNum 总件数 Integer M 总件数 6 totalWeight 总重量 Double(16,3) O 总重量 7 totalVolume 总体积 Double(16,2) O 总体积 8 remark 备注 String O 9 clientCode 客户订单号 String(60) M 客户订单号 10 requirePickupTimeFm 期望提货开始时间 Timestamp O 期望提货开始时间 11 requirePickupTimeTo 期望提货结束时间 Timestamp O 期望提货结束时间 12 requireDeliveryTimeFm 期望送达开始时间 Timestamp O 期望送达开始时间 13 requireDeliveryTimeTo 期望送达结束时间 Timestamp O 期望送达结束时间 14 transportType 运输方式 String(20) O 1:公路运输；2:航空运输；3:铁路运输；4：水路运输；9：综合运输方式 15 vehicleType 期望车型 String(20) O 整车或专车时使用 16 valinsPay 保价金额 Double(16,2) O 保价金额 17 temperatureRange 温度范围类型 Integer O 非空时候默认为医药温控件,可传入各快递自定义温控业务:冷冻、冷藏等 表19 运单信息序号 字段名 数据类型及格式 约束/条件 描述及要求 1 clientCode 客户订单号 String(60) M 客户订单号 2 waybillNoInfoList 运单号 List M 第一个为主单号，数量与下单时件数一致3 routeLabelInfo 快递面单附属属性 List M 根据各个快递公司返回属性 9.3.2.3 快递面单信息 下发快递订单后，寄递企业返回的面单信息应符合表20的规定。 表20 快递面单信息序号 字段名 数据类型及格式 约束/条件 描述及要求 1 bulkpen 大头笔 String(60) O 用于显示于电子面单上规定位置 2 waybillNo 快递公司运单号 String(60) O 快递快运单号 表20 快递面单信息（续）序号 字段名 数据类型及格式 约束/条件 描述及要求 3 orgCode 始发地区域编码 String(30) O 始发地区域编码 4 orgName 始发地/始发网点名称 String(30) O 始发地网点名称 5 destCode 目的地区域编码 String(30) O 目的地区域编码 6 destName 目的地/到达网点 String(30) O 目的地到达网点 7 orgSortingCode 始发分拣编码 String(30) O 始发分拣编码 8 orgSortingName 始发分拣名称 String(30) O 始发分拣名称 9 destSortingCode 目的分拣编码 String(30) O 目的分拣编码 10 destSortingName 目的分拣中心名称 String(30) O 目的分拣中心名称 11 orgExtra 始发其他信息 String(60) O 始发其他信息 12 destExtra 目的其他信息 String(60) O 目的其他信息 13 pkgCode 集包编码 String(60) O 集包编码 14 pkgName 集包地名称 String(30) O 集包地名称 15 road 路区 String(30) O 路区 16 qrCode 二维码 String O 二维码信息 17 expressCode 快递业务类型编码 String(20) O 业务类型编码 18 expressName 快递业务类型名称 String(30) O 业务类型名称 19 waterMark 水印 String O 水印 20 agingName 时效 String O 时效 21 proCode 时效产品图标 String O 时效产品图标 22 printIcon 图标名称 String O 图标名称 23 destRouteLabel 目的地 String O 路由信息 24 twoDimensionCode 二维码信息 String O 二维码信息 25 xbFlag 标识 String O 面单特殊标识 9.3.2.4 回单信息 寄递服务结束后，寄递企业返回的回单信息应符合表21的规定。 表21 电子回单信息序号 字段名 数据类型及格式 约束/条件 描述及要求 1 clientNo 客户单号 String(60) M 客户单号 2 waybillNoInfoList 运单号 List M 运单号 3 signPhoto 回单 List M 回单照片或文件 见表6 4 operator 操作人 String(30) O 回单上传人 5 operateCompany 操作人所属公司名称 String（30） O 回单上传公司 6 gatherDate 采集时间 Timestamp O 回单采集时间 7 hasException 是否有异常 Boolean O 回单是否有异常 8 memo 备注信息 String O 异常说明 9 machineCode 机器码 String O 上报设备码 10 phone 手机号 String(20) O 上报手机号 11 address 位置信息 String O 上报位置信息 12 longitude 真实经度 Double(10,7) O WGS-84坐标系 例如:121.535469 13 latitude 真实纬度 Double(10,7) O WGS-84坐标系 例如:31.209667 9.3.3 状态信息 快递启运后关键状态信息上报规范应符合表21的规定。 表22 状态信息序号 字段名 数据类型及格式 约束/条件 描述及要求 1 clientCodes 客户订单