CATAGS
中国航空运输协会团体标准T/CATAGS 63.4—2023
不正常行李交互规范第 4 部分：数据接口
Abnormal luggage interaction specification—Part 4: Data interface
2023-05-22 发布 2023-05-22 实施
中国航空运输协会发布
目次
前言
本文件按照GB/T 1.1—2020《标准化工作导则第1部分：标准化文件的结构和起草规则》的规定起草。
本文件是T/CATAGS 63《不正常行李交互规范》的第4部分，T/CATAGS 63《不正常行李交互规范》包括以下部分：
——第 1 部分：服务平台建设;
——第 2 部分：处理流程;
——第 3 部分：流程数据;
——第 4 部分：数据接口。
本文件由中国航空运输协会归口。
请注意本文件的某些内容可能涉及专利。本文件的发布机构不承担识别专利的责任。
本文件起草单位：中国民航信息网络股份有限公司、上海民航华东凯亚系统集成有限公司、中国民航大学。
本文件主要起草人：智慧、孙琼巍、潘乃槟、董云杉、耿思、胡冰、刘王君、王军峰、王道明、黄小东、洪泽琳、毛丹、马晓宁、胡泽。
引言
新时代民航高质量发展要求加快推进智慧民航的建设，着力改善旅客出行的便利性和体验。近年来，中国民航大力投入以提升行李服务的水平，推动全行业行李运输的信息化、智能化发展。以往行李丢失是旅客行李服务的痛点, 民航旅客不正常行李服务平台用于解决旅客行李丢失的问题。
T/CATAGS 63旨在建立普遍适用于不正常行李处理的业务交互中服务平台建设、处理流程、流程数据，以及数据接口的准则，拟由四个部分构成：
——第 1 部分服务平台建设。目的在于明确不正常行李处理服务平台建设的功能。
——第 2 部分处理流程。目的在于规范不正常行李交互的处理流程。
——第 3 部分流程数据。目的在于规范不正常行李交互的流程数据。
——第 4 部分数据接口。目的在于规范不正常行李交互的数据接口。
为促进航空公司、机场行李相关系统与不正常行李服务平台间数据接口的规范化，特制定本文件。
不正常行李交互规范第 4 部分数据接口
1 范围
本文件规定了与不正常行李服务平台(简称服务平台)交互的数据接口涉及的通信接口、网络交换的安全控制、数据交换频次、及数据交换接口。
本文件适用于航空公司、机场及第三方与服务平台的数据接口。
2 规范性引用文件
下列文件中的内容通过文中的规范性引用而构成本文件必不可少的条款。其中，注日期的引用文件，仅该日期对应的版本适用于本文件;不注日期的引用文件，其最新版本(包括所有的修改单)适用于本文件。
GM/T 0054-2018 信息系统密码应用基本要求
T/CATAGS 63.3-2023 不正常行李交互规范第3部分流程数据
3 术语和定义
本文件没有需要界定的术语和定义。
4 缩略语
下列缩略语适用于本文件。
ACK：确认字符(Acknowledge Character)
HTTP：超文本传输协议(Hyper Text Transfer Protocol)
HTTPS：超文本传输安全协议(Hyper Text Transfer Protocol over Secure Socket Layer)
ID：身份标识(Identity)
json：JavaScript对象简谱(JavaScript Object Notation)
URL：统一资源定位系统(Uniform Resource Locator)
5 通信协议
不正常行李交互信息传输应采用HTTPS协议，数据发送应采用POST方式。
6 数据交换安全控制
6.1 访问授权
数据传输应设置访问授权，并在交互过程中进行合法性验证，确保数据交换安全合法。
6.2 通信加密
应采用符合GM/T 0054-2018等国家标准规定的密码技术确保通信过程数据保密性和完整性。
6.3 过程追溯
应跟踪和记录数据交互过程，记录包括数据格式记录、数据提供方记录、共享数据服务方记录、数据使用方记录等。
6.4 数据兼容性
为保证信息系统间信息编码兼容性，数据发送方编码格式应与数据接收方编码格式保持一致。
6.5 数据网络传输安全性
报文传输网络应采取必要安全措施，如增加用户验证、两端添加防火墙、安装杀毒软件并定期杀毒等。
7 数据交换频次
数据交换频次应符合表1要求。
表 1 数据交换频次
8 数据交换接口
8.1 接口说明
8.1.1 接口采用格式
json格式的少收、多收、破损案件数据。
8.1.2 调用方式
基于HTTP/HTTPS协议，POST方式传递，在POST方法BODY中，上传json格式，或文本/字符串参数。为支持该格式，调用者需对HTTP Header参变量Content-type设定为application/json。
8.1.3 返回结果状态码说明
返回结果状态码code说明如下：
——000 成功
——001 失败
——002 存在冲突
——003 参数校验错误
——004 系统异常
8.2 登录验证
8.2.1 应用场景
服务平台提供的接口，调用者在调用过程中，须先验证用户账户、密码正确性。
调用者通过调用该接口，提交服务平台分配的账号、密码，通过返回调用结果json字符串，取得access_token;当调用者没有调用登录接口，没有获取正确的access_token，或access_token过期，后续其它接口调用应返回异常。
注：该access_token在后续接口调用过程中，唯一识别当前调用者身份，有效时长为1天。
8.2.2 登录验证的接口
登录验证接口定义如下：
——接口地址，https://xxxx/oauth/token;
——Content-type，application/json;
——调用方式，POST;
——请求参数，见表 2;
——返回值，见表 3。
表 2 登录验证接口请求参数
表 3 登录验证接口返回值
示例 1：成功返回：
{
"access_access_token": "b24d6090-11c9-4dc5-af0e-d695f9647374",
"access_token_type": "bearer",
"expires_in": 10208,
"scope": "file_exchange"
}
示例 2：错误返回(授权失败)：
{
"error": "invalid_request",
"error_description": "Missing grant type"// 报错信息
}
8.3 上报案件数据接口
8.3.1 上报少收行李案件数据接口
8.3.1.1 应用场景
调用者调用“8.2 登录验证”，获取正确 access_token后，可发起少收行李案件数据上报调用，把当前机场或航空公司收集的少收行李案件数据，上报服务平台。
当调用者少收行李案件数据格式、调用方法均正确时，获得调用成功提示;否则，调用者应根据返回结果状态码code，检查其接口调用方式、接口URL地址、传递参数方式是否正确。
8.3.1.2 接口定义
接口数据应符合T/CATAGS 63.3-2023的要求。上报少收行李案件数据接口定义如下：
——接口地址，https://xxxx/data-exchange/public/document/push;
——Content-type，application/json;
——调用方式，POST;
——请求参数，见表 4;
——返回值，见表 5。
表 4 案件数据上报接口请求参数
表 5 接口返回值
示例 1：请求{
"airport": "SHA",//机场"carrier": "MU",//航司
"code": "BTS-SHA-MU-51452", //档案编号
"createTime": "2020-03-05 09:30:22",// 建案时间，yyyy-MM-dd HH:mm:ss
"eventTime": "2020-03-05 10:15:10",// 消息事件时间，yyyy-MM-dd HH:mm:ss "historyEventList": [//历史事件列表，包含本事件
{
"eventType": " CREATE",//事件类型：CREATE-创建;CLOSE-关闭;UPDATE-更新;SUSPEND-挂起;
REINSTATE-恢复;REQUEST-索要;TRANSFER-转运;EXPRESS-快递
"time": "2020-03-05 09:30:22"//时间，yyyy-MM-dd HH:mm:ss
"eventType": " REQUEST ",//事件类型：CREATE-创建;CLOSE-关闭;UPDATE-更新;SUSPEND-挂起; REINSTATE-恢复;REQUEST-索要;TRANSFER-转运;EXPRESS-快递
"time": "2020-03-05 10:15:10"//时间，yyyy-MM-dd HH:mm:ss
"eventType": " CLOSE ",//事件类型：CREATE-创建;CLOSE-关闭;UPDATE-更新;SUSPEND-挂起;
REINSTATE-恢复;REQUEST-索要;TRANSFER-转运;EXPRESS-快递"time": "2020-03-05 16:43:18"//时间，yyyy-MM-dd HH:mm:ss
}],
"msgType": "REQUEST",//消息类型：CREATE-创建;CLOSE-关闭;UPDATE-更新;SUSPEND-挂起;REINSTATE-恢复;REQUEST-索要;TRANSFER-转运;EXPRESS-快递
"passengerFlightList": [//旅客行程列表{
"carrier": "MU",//航司"des": "SHA",//目的地
"flightDt": "2020-03-05", //航班日期，yyyy-MM-dd
"flightNo": "2127",//航班号
"ori": "XIY"//起始地
}],
"passengerList": [//旅客列表
{
"address": "Pudong New District, ShangHai",//地址
"addressCn": "上海市浦东新区", //地址中文
"country": "CN", //常住国家
"firstName": JIE"", //名
"firstNameCn": "杰", //中文名
"initialCode": "LJ", //简称
"lastName": "LIU", //姓
"lastNameCn": "刘", //中文姓
"ticketNo": "7812349305093", //客票票号
"title": "MR LIUJIE" //称谓
"bagList": [//行李列表{
"colorCode": "MC", //颜色代码，WT-白色;PR-花纹图案;MC-2种或多种纯色;GN-绿色;BN-棕色; BE-米色;YW-黄色;RD-红色;PU-紫色;BU-蓝色;BY-灰色;BK-黑色
"describes": "CHW", //描述
"typeCode": "22", //包裹类型代码
}],
} ],
"source": "BTS",//来源代码
"type": "AHL"//档案类型，AHL-少收 }
示例 2：返回{
"code": "000", "data": null,
"msg": "成功!"
}
8.3.2 上报多收行李案件数据接口
8.3.2.1 应用场景
调用者调用“8.2 登录验证”，并获取正确access_token后，可发起多收行李案件数据上报调用，把当前机场或航空公司收集的多收行李案件数据，上报服务平台。
调用者多收行李案件数据格式、调用方法均正确时，获得调用成功提示;否则，调用者应根据返回结果状态码code，检查其接口调用方式、接口URL地址、传递参数方式是否正确。
8.3.2.2 接口定义
接口数据应符合T/CATAGS 63.3-2023的要求。上报多收行李案件数据接口定义如下：
——接口地址，https://xxxx/data-exchange/public/document/push;
——Content-type，application/json;
——调用方式，POST;
——请求参数，见表 4;
——返回值，见表 5。
示例 1：请求
{
"airport": "KMG",//机场
"carrier": "MU",//航司
"code": "BTS-KMG-MU-42429", //档案编号
"createTime": "2020-03-05 15:22:46",// 建案时间，yyyy-MM-dd HH:mm:ss
"eventTime": "2020-03-05 16:20:14",//消息事件时间，yyyy-MM-dd HH:mm:ss
"historyEventList": [//历史事件列表，包含本事件{
"eventType": " CREATE",//事件类型：CREATE-创建;CLOSE-关闭;UPDATE-更新;SUSPEND-挂起;
REINSTATE-恢复;REQUEST-索要;TRANSFER-转运;EXPRESS-快递
"time": "2020-03-05 15:22:46"//时间，yyyy-MM-dd HH:mm:ss
"eventType": "TRANSFER",//事件类型：CREATE-创建;CLOSE-关闭;UPDATE-更新;SUSPEND-挂起;
REINSTATE-恢复;REQUEST-索要;TRANSFER-转运;EXPRESS-快递
"time": "2020-03-05 16:20:14"//时间，yyyy-MM-dd HH:mm:ss
"eventType": " CLOSE",//事件类型：CREATE-创建;CLOSE-关闭;UPDATE-更新;SUSPEND-挂起;
REINSTATE-恢复;REQUEST-索要;TRANSFER-转运;EXPRESS-快递
"time": "2020-03-05 20:24:57"//时间，yyyy-MM-dd HH:mm:ss
}],
"msgType": "TRANSFER",//消息类型：CREATE-创建;CLOSE-关闭;UPDATE-更新;SUSPEND-挂起;REINSTATE-恢复;REQUEST-索要;TRANSFER-转运;EXPRESS-快递
"passengerFlightList": [//旅客行程列表{
"carrier": "MU",//航司"des": "PVG",//目的地
"flightDt": "2020-03-05", //航班日期，yyyy-MM-dd
"flightNo": "5809",//航班号
"ori": "KMG"//起始地
}],
"passengerList": [//旅客列表
{
"bagList": [//行李列表{
"colorCode": "GY", //颜色代码，WT-白色;PR-花纹图案;MC-2种或多种纯色;GN-绿色;BN-棕色;
BE-米色;YW-黄色;RD-红色;PU-紫色;BU-蓝色;BY-灰色;BK-黑色
"describes": CHW"", //描述
"typeCode": "02", //包裹类型代码
}],
}],
"source": "BTS",//来源代码
"type": "OHD"//档案类型，OHD-多收
}
示例 2：返回
{
"code": "000",
"data": null,
"msg": "成功!"
}
8.3.3 上报破损行李案件数据接口
8.3.3.1 应用场景
调用者调用“8.2 登录验证”，获取正确access_token后，可发起破损行李案件数据上报调用，把当前机场或航空公司收集的破损行李案件数据，上报服务平台。
调用者破损行李案件数据格式、调用方法均正确时，获得调用成功提示;否则，调用者应根据返回结果状态码code，检查其接口调用方式、接口URL地址、传递参数方式是否正确。
8.3.3.2 接口定义
接口数据应符合T/CATAGS 63.3-2023的要求。上报破损行李案件数据接口定义如下：
——接口地址，https://xxxx/data-exchange/public/document/push;
——Content-type，application/json;
——调用方式，POST;
——请求参数，见表 4;
——返回值，见表 5。
示例 1：请求
{
"airport": "SZX",//机场
"carrier": "MU",//航司
"code": "BTS-SZX-MU-17123", //档案编号
"createTime": "2020-03-05 17:59:21",// 建案时间，yyyy-MM-dd HH:mm:ss
"eventTime": "2020-03-05 18:20:00",//消息事件时间，yyyy-MM-dd HH:mm:ss
"historyEventList": [//历史事件列表，包含本事件{
"eventType": "CREATE",//事件类型：CREATE-创建;CLOSE-关闭;UPDATE-更新;SUSPEND-挂起;
REINSTATE-恢复;REQUEST-索要;TRANSFER-转运;EXPRESS-快递
"time": "2020-03-05 17:59:21"// 时间，yyyy-MM-dd HH:mm:ss
"eventType": "UPDATE",//事件类型：CREATE-创建;CLOSE-关闭;UPDATE-更新;SUSPEND-挂起;
REINSTATE-恢复;REQUEST-索要;TRANSFER-转运;EXPRESS-快递
"time": "2020-03-05 18:20:00"//时间，yyyy-MM-dd HH:mm:ss
"eventType": " CLOSE",//事件类型：CREATE-创建;CLOSE-关闭;UPDATE-更新;SUSPEND-挂起;
REINSTATE-恢复;REQUEST-索要;TRANSFER-转运;EXPRESS-快递
"time": "2020-03-05 18:30:20"//时间，yyyy-MM-dd HH:mm:ss
}],
"issueReason": "83", //事故原因代码
"msgType": "UPDATE",//消息类型：CREATE-创建;CLOSE-关闭;UPDATE-更新;SUSPEND-挂起;REINSTATE-恢复;REQUEST-索要;TRANSFER-转运;EXPRESS-快递
"passengerFlightList": [//旅客行程列表{
"carrier": "MU",//航司"des": "PEK",//目的地
"flightDt": "2020-03-05", //航班日期，yyyy-MM-dd
"flightNo": "5319",//航班号
"ori": "SZX"//起始地
}],
"passengerList": [//旅客列表
{
"address": "SZX",//地址
"addressCn": "深圳宝安机场", //地址中文
"country": "CN", //常住国家
"firstName": "YI", //名
"firstNameCn": "毅", //中文名
"initialCode": "CY", //简称
"lastName": "CHEN", //姓
"lastNameCn": " 陈", //中文姓
"ticketNo": "7812349305093", //客票票号
"bagList": [//行李列表{
"colorCode": "PU", //颜色代码，WT-白色;PR-花纹图案;MC-2种或多种纯色;GN-绿色;BN-棕色;
BE-米色;YW-黄色;RD-红色;PU-紫色;BU-蓝色;BY-灰色;BK- 黑色
"describes": CHW"", //描述
"typeCode": "02", //包裹类型代码
}],
}],
"source": "BTS",//来源代码
"type": "DPR"//档案类型，DPR-破损 }
示例 2：返回
{
"code": "000",
"data": null,
"msg": "成功!"
}
8.4 获取案件数据接口
8.4.1 获取少收行李案件数据接口
8.4.1.1 获取接口
8.4.1.1.1 应用场景
调用者调用“8.2 登录验证”，获取正确access_token后，可发起少收行李案件数据下发接口调用，获取少收行李案件数据。
调用者输入参数access_token有效、服务平台端识别当前用户凭证，服务平台应向当前调用者下发请求案件数据。调用者处理完成后，需根据返回数据messageId，再次主动调用服务平台，确认该消息已正确接收、完成处理; 否则，再次请求少收行李案件数据时，对没有ACK确认的少收行李案件，服务平台可能会再次下发。
8.4.1.1.2 接口定义
接口数据应符合T/CATAGS 63.3-2023的要求。获取少收行李案件数据接口定义如下：
——接口地址，https://xxxx/data-exchange/public/document/poll
——Content-type，application/json;
——调用方式，GET;
——请求参数，见表 6;
——返回值，见表 5。
表 6 获取服务平台少收行李案件数据接口请求参数
示例：
{
"code": "000", "data":
{
"file":
{
"airport": "SHA",//机场
"carrier": "MU",//航司
"closeTime": "2020-03-05 16:43:18",//关闭时间
"code": "BTS-SHA-MU-51452", //档案编号
"createTime": "2020-03-05 09:30:22",// 建案时间，yyyy-MM-dd HH:mm:ss
"dutyAirport": "XIY", //责任航站
"eventTime": "2020-03-05 10:15:10",//消息事件时间，yyyy-MM-dd HH:mm:ss
"historyEventList": [//历史事件列表，包含本事件{
"eventType": " CREATE",//事件类型： CREATE-创建;CLOSE-关闭;UPDATE-更新;SUSPEND-
挂起;REINSTATE-恢复;REQUEST-索要;TRANSFER-转运;EXPRESS-快递
"time": "2020-03-05 09:30:22"//时间，yyyy-MM-dd HH:mm:ss
"eventType": " REQUEST ",//事件类型：CREATE-创建;CLOSE-关闭;UPDATE-更新;SUSPEND-挂起;REINSTATE-恢复;REQUEST-索要;TRANSFER-转运;EXPRESS-快递
"time": "2020-03-05 10:15:10"//时间，yyyy-MM-dd HH:mm:ss
"eventType": " CLOSE ",//事件类型：CREATE-创建;CLOSE-关闭;UPDATE-更新;SUSPEND-挂
起;REINSTATE-恢复;REQUEST-索要;TRANSFER-转运;EXPRESS-快递"time": "2020-03-05 16:43:18"//时间，yyyy-MM-dd HH:mm:ss
}],
"issueReason": "21", //事故原因代码
"msgType": "REQUEST",//消息类型：CREATE-创建;CLOSE-关闭;UPDATE-更新;SUSPEND-挂起;
REINSTATE-恢复;REQUEST-索要;TRANSFER-转运;EXPRESS-快递
"passengerFlightList": [//旅客行程列表{
"cabinClass": "Y",//舱位等级"carrier": "MU",//航司
"des": "SHA",//目的地
"flightDt": "2020-03-05", //航班日期，yyyy-MM-dd
"flightNo": "2127",//航班号
"ori": "XIY"//起始地
}],
"passengerList": [//旅客列表
{
"address": "Pudong New District, ShangHai",//地址
"addressCn": "上海市浦东新区", //地址中文
"bagList": [//行李列表{
"bagCd": "867800", //行李牌号
"bagFlightList": [//行李航班信息{
"carrier": "MU", //航司"des": "SHA", //目的地
"flightDt": "2020-03-05", //航班日期，yyyy-MM-dd
"flightNo": "2127", //航班号
"ori": "XIY" //始发地
}],
"brand": "YY", //箱包品牌
"colorCode": "MC", //颜色代码，WT-白色;PR-花纹图案;MC-2种或多种纯色;GN-绿色; BN-棕色;BE-米色;YW-黄色;RD-红色;PU-紫色;BU-蓝色;BY-灰色;BK-黑色
"compareList": [//匹配记录列表
{
"compareBagCd": "867800", //比较行李牌号
"compareFileCode": "BTS-SHA-MU-51452", //比较行李所属案件编号
"comparedBagCd": "867800", //被比较行李牌号
"comparedFileCode": "BTS-XIY-MU-38438", //被比较行李所属案件编号
"method": "BAG_CODE", //匹配方式：行李牌号-BAG_CODE;行李描述
-BAG_DESCRIBE;行李照片-BAG_PIC
"result": "INFO/100", //匹配结果：type/score
"score": 100, //匹配分数
"time": "2020-03-05 10:10:00", //匹配时间，yyyy-MM-dd HH:mm:ss
"type": "INFO" //匹配类型：INFO-文本信息;PIC-图片
}],
"describes": "CHW", //描述
"lastSeen": "CDG", //最后出现
"typeCode": "22", //包裹类型代码"weight": "1/12KG" //重量
}],
"country": "CN", //常住国家"firstName": "JIE", //名
"firstNameCn": "杰", //中文名"initialCode": "LJ", //简称
"lastName": "LIU", //姓
"lastNameCn": "刘", //中文姓
"mobilePhone": "15060708244", //手机号
"passport": "18AK45035", //护照号
"telephone": "018393567897", //电话
"ticketNo": "7812349305093", //客票票号
"title": "MR LIUJIE" //称谓
}],
"paymentList": [//赔偿列表
{
"actionTime": "2020-03-05 12:40:15", //记录时间
"amount": "150", //赔偿金额
"currencyCode": "CNY", //货币代码
"payDate": "2020-03-05 12:35:22", //赔偿日期
"type": "A"//赔偿类型：D-运送费用;A-临时生活补偿;F-最终赔偿费用;X-其他费用;I-保险费用
}],
"relFileCode": "BTS-XIY-MU-38438",//关联档案编号
"source": "BTS",//来源代码
"targetBagCd": "867800",//事件目标行李牌号，仅限msgType为REQUEST、TRANSFER、EXPRESS "type": "AHL"//档案类型，AHL-少收
},
"messageId": 0//本条数据传输唯一ID
},
"msg": "成功!" }
8.4.1.2 主动应答/确认
8.4.1.2.1 应用场景
调用方收到正确的少收行李案件数据后，需带上返回结果中的messageId再次调用服务平台主动应答/确认接口，与服务平台端确认已正确接收该条案件信息。若没有进行ACK接口调用，下次获取案件信息仍是这一条。
8.4.1.2.2 接口定义
获取少收行李案件数据主动应答/确认接口定义如下：
——接口地址，https://xxxx//data-exchange/public/document/confirm;
——Content-type，application/json;
——调用方式，POST;
——请求参数，见表 7;
——返回值，见表 5。
表 7 获取少收行李案件数据主动应答/确认接口请求参数
示例：
{
"code": "000",
"data": null,
"msg": "成功!"
}
8.4.2 获取多收行李案件数据接口
8.4.2.1 获取接口
8.4.2.1.1 应用场景
调用者调用“8.2 登录验证”，获取正确access_token后，可发起多收行李案件数据下发接口调用，获取多收行李案件数据。
当调用者输入参数access_token有效、服务平台端能识别当前用户凭证时，服务平台应向当前调用者下发请求的案件数据。调用者处理完成后，需要根据返回数据中的messageId，再次主动调用服务平台，确认该消息已经正确接收、完成处理;否则，当再次请求多收行李案件数据时，对于没有ACK确认的多收行李案件，服务平台可能会再次下发。
8.4.2.1.2 接口定义
接口数据应符合T/CATAGS 63.3-2023的要求。获取多收行李案件数据接口定义如下：
——接口地址，https://xxxx/data-exchange/public/document/poll;
——Content-type，application/json;
——调用方式，GET;
——请求参数，见表 6;
——返回值，见表 5。
示例：
{
"code": "000",
"data":
{
"file":
{
"airport": "KMG",//机场
"carrier": "MU",//航司
"closeTime": "2020-03-05 20:24:57",//关闭时间
"code": "BTS-KMG-MU-42429", //档案编号
"createTime": "2020-03-05 15:22:46",// 建案时间，yyyy-MM-dd HH:mm:ss
"eventTime": "2020-03-05 16:20:14",//消息事件时间，yyyy-MM-dd HH:mm:ss
"historyEventList": [//历史事件列表，包含本事件{
"eventType": " CREATE",//事件类型： CREATE- 创建;CLOSE-关闭;UPDATE- 更新;SUSPEND-
挂起;REINSTATE-恢复;REQUEST-索要;TRANSFER-转运;EXPRESS-快递
"time": "2020-03-05 15:22:46"//时间，yyyy-MM-dd HH:mm:ss
"eventType": "TRANSFER",//事件类型：CREATE-创建;CLOSE-关闭;UPDATE-更新;SUSPEND-挂起;REINSTATE-恢复;REQUEST-索要;TRANSFER-转运;EXPRESS-快递
"time": "2020-03-05 16:20:14"//时间，yyyy-MM-dd HH:mm:ss
"eventType": " CLOSE",//事件类型：CREATE-创建;CLOSE-关闭;UPDATE-更新;SUSPEND-挂
起;REINSTATE-恢复;REQUEST-索要;TRANSFER-转运;EXPRESS-快递"time": "2020-03-05 20:24:57"//时间，yyyy-MM-dd HH:mm:ss
}],
"msgType": "TRANSFER",//消息类型：CREATE-创建;CLOSE-关闭;UPDATE-更新;SUSPEND-挂起; REINSTATE-恢复;REQUEST-索要;TRANSFER-转运;EXPRESS-快递
"passengerFlightList": [//旅客行程列表{
"cabinClass": "Y",//舱位等级"carrier": "MU",//航司
"des": "PVG",//目的地
"flightDt": "2020-03-05", //航班日期，yyyy-MM-dd
"flightNo": "5809",//航班号
"ori": "KMG"//起始地
}],
"passengerList": [//旅客列表
{
"address": "Pudong New District, ShangHai",//地址
"addressCn": 上海市浦东新区"", //地址中文
"bagList": [//行李列表{
"bagCd": "243528", //行李牌号
"bagFlightList": [//行李航班信息{
"carrier": "MU", //航司"des": "PVG", // 目的地
"flightDt": "2020-03-05", //航班日期，yyyy-MM-dd
"flightNo": "5809", //航班号
"ori": "KMG" //始发地
}],
"brand": "YY", //箱包品牌
"colorCode": "GY", //颜色代码，WT-白色;PR-花纹图案;MC-2种或多种纯色;GN-绿 ;BN-棕色;BE-米色;YW-黄色;RD-红色;PU-紫色;BU-蓝色;BY-灰色;BK-黑色"compareList": [//匹配记录列表
{
"compareBagCd": "243528", //比较行李牌号
"compareFileCode": "BTS-KMG-MU-42429", //比较行李所属档案编号
"comparedBagCd": "243528", //被比较行李牌号
"comparedFileCode": "BTS-PVG-MU-35620", //被比较行李所属案件编号"method": "BAG_CODE", //匹配方式：行李牌号-BAG_CODE;行李描述
-BAG_DESCRIBE;行李照片-BAG_PIC
"result": "INFO/100", //匹配结果：type/score
"score": 100, //匹配分数
"time": "2020-03-05 15:35:46", //匹配时间，yyyy-MM-dd HH:mm:ss
"type": "INFO" //匹配类型：INFO-文本信息;PIC-图片
}],
"describes": "CHW", //描述
"typeCode": "02", //包裹类型代码"weight": "1/8KG" //重量
}],
"country": "CN", //常住国家"firstName": "YANG", //名
"firstNameCn": " 阳", //中文名"initialCode": "MY", //简称
"lastName": "WANG", //姓
"lastNameCn": "王", //中文姓
"mobilePhone": 134056782002"", //手机号
"passport": "18AK45022", //护照号
"telephone": "01067826635", //电话
"ticketNo": "7812349305093", //客票票号
"title": "MR WANGYANG" //称谓
}],
"relFileCode": "BTS-PVG-MU-35620", // 关联档案编号
"source": "BTS",//来源代码
"targetBagCd": "243528", //事件目标行李牌号，仅限msgType为REQUEST、TRANSFER、EXPRESS "type": "OHD"//档案类型，OHD-多收
},
"messageId": 1//本条数据传输唯一ID
},
"msg": "成功!" }
8.4.2.2 主动应答/确认
8.4.2.2.1 应用场景
调用方在调用完成服务平台获取多收行李案件数据接口并得到正确的多收行李案件数据后，需带上返回结果中的messageId再次调用服务平台主动应答/确认接口，与服务平台端确认已正确接收到该条案件信息。如果没有进行ACK接口调用，下次获取的案件信息仍然会是这一条。
8.4.2.2.2 接口定义
获取多收行李案件数据主动应答/确认接口定义如下：
——接口地址，https://xxxx//data-exchange/public/document/confirm;
——Content-type，application/json;
——调用方式，POST;
——请求参数，见表 7;
——返回值，见表 5。
示例：
{
"code": "000",
"data": null,
"msg": "成功!"
}
8.4.3 获取破损行李案件数据接口
8.4.3.1 获取接口
8.4.3.1.1 应用场景
调用者调用“8.2 登录验证”，获取正确access_token后，可发起破损行李案件数据下发接口调用，获取破损行李案件数据。
当调用者输入参数中的access_token有效、服务平台端能识别当前用户凭证时，服务平台应向当前调用者下发请求的案件数据。调用者处理完成后，需根据返回数据中的messageId，再次主动调用服务平台，确认该消息已经正确接收、完成处理;否则，当再次请求破损行李案件数据时，对于没有ACK确认的破损行李案件，服务平台可能会再次下发。
8.4.3.1.2 接口定义
接口数据应符合T/CATAGS 63.3-2023的要求。获取破损行李案件数据接口定义如下：
——接口地址，https://xxxx/data-exchange/public/document/poll;
——Content-type，application/json;
——调用方式，GET;
——请求参数，见表 6;
——返回值，见表 5。
示例：
{
"code": "000",
"data":
{
"file":
{
"airport": "SZX",//机场"carrier": "MU",//航司
"closeTime": "2020-03-05 18:30:20",//关闭时间"code": "BTS-SZX-MU-17123", //档案编号
"createTime": "2020-03-05 17:59:21",// 建案时间，yyyy-MM-dd HH:mm:ss "dutyAirport": "SZX", //责任航站
"eventTime": "2020-03-05 18:20:00",//消息事件时间，yyyy-MM-dd HH:mm:ss "historyEventList": [//历史事件列表，包含本事件
{
"eventType": "CREATE",//事件类型：CREATE-创建;CLOSE-关闭;UPDATE-更新;SUSPEND-挂起;REINSTATE-恢复;REQUEST-索要;TRANSFER-转运;EXPRESS-快递
"time": "2020-03-05 17:59:21"//时间，yyyy-MM-dd HH:mm:ss
"eventType": "UPDATE",//事件类型：CREATE- 创建;CLOSE-关闭;UPDATE-更新;SUSPEND-挂起;REINSTATE-恢复;REQUEST-索要;TRANSFER-转运;EXPRESS-快递
"time": "2020-03-05 18:20:00"//时间，yyyy-MM-dd HH:mm:ss
"eventType": " CLOSE",//事件类型：CREATE-创建;CLOSE-关闭;UPDATE-更新;SUSPEND-挂起;REINSTATE-恢复;REQUEST-索要;TRANSFER-转运;EXPRESS-快递
"time": "2020-03-05 18:30:20"//时间，yyyy-MM-dd HH:mm:ss
}],
"issueReason": "83", //事故原因代码
"msgType": "UPDATE",//消息类型：CREATE-创建;CLOSE-关闭;UPDATE-更新;SUSPEND-挂起;
REINSTATE-恢复;REQUEST-索要;TRANSFER-转运;EXPRESS-快递
"passengerFlightList": [//旅客行程列表{
"cabinClass": "Y",//舱位等级"carrier": "MU",//航司
"des": "PEK",//目的地
"flightDt": "2020-03-05", //航班日期，yyyy-MM-dd
"flightNo": "5319",//航班号
"ori": "SZX"//起始地
}],
"passengerList": [//旅客列表
{
"address": "SZX",//地址
"addressCn": "深圳宝安机场", //地址中文
"bagList": [//行李列表{
"bagCd": "867800", //行李牌号
"bagFlightList": [//行李航班信息{
"carrier": "MU", //航司"des": "PEK", //目的地
"flightDt": "2020-03-05", //航班日期，yyyy-MM-dd
"flightNo": "5319", //航班号
"ori": "SZX" //始发地
}],
"brand": "YY", //箱包品牌
"colorCode": "PU", //颜色代码，WT-白色;PR-花纹图案;MC-2种或多种纯色;GN-绿色; BN-棕色;BE-米色;YW-黄色;RD-红色;PU-紫色;BU-蓝色;BY-灰色;BK-黑色
"damageList": [//破损信息
{
"descriptionCode": [ 16],//破损描述代码
"position": "TOP", //破损位置
"type": "MI" //破损类型
}],
"describes": "CHW", //描述
"remark": "3YEAR", //备注
"repairFlag": "N", //维修标识:N/Y "replaceFlag": "N", //置换标识:N/Y
"typeCode": "02", //包裹类型代码
"weight": "1/12KG" //重量
}],
"country": "CN", //常住国家"firstName": "YI", //名
"firstNameCn": "毅", //中文名"initialCode": "CY", //简称
"lastName": "CHEN", //姓
"lastNameCn": " 陈", //中文姓
"mobilePhone": "13530673902", //手机号
"passport": "18AK45033", //护照号
"telephone": "01027366736", //电话
"ticketNo": "7812349305093", //客票票号
"title": "MR CHENYI" //称谓
}],
"paymentList": [//赔偿列表
{
"actionTime": "2020-03-05 18:15:00", //记录时间
"amount": "150", //赔偿金额
"currencyCode": "CNY", //货币代码
"payDate": "2020-03-05 17:59:21", //赔偿日期
"type": "F"//赔偿类型：D-运送费用;A-临时生活补偿;F-最终赔偿费用;X-其他费用;I-保险费用
}],
"source": "BTS",//来源代码
"targetBagCd": "867800", //事件目标行李牌号，仅限msgType为REQUEST、TRANSFER、EXPRESS "type": "DPR"//档案类型，DPR-破损
},
"messageId": 2//本条数据传输唯一ID
},
"msg": "成功!" }
8.4.3.2 主动应答/确认
8.4.3.2.1 应用场景
调用方在调用完成服务平台获取破损行李案件数据接口并得到正确的破损行李案件数据后，需带上返回结果中的messageId再次调用服务平台主动应答/确认接口，与服务平台端确认已正确接收到该条案件信息。如果没有进行ACK接口调用，下次获取的案件信息仍然会是这一条。
8.4.3.2.2 接口定义
获取破损行李案件数据主动应答/确认接口定义如下：
——接口地址，https://xxxx//data-exchange/public/document/confirm;
——Content-type，application/json;
——调用方式，POST;
——请求参数，见表 7;
——返回值，见表 5。
示例：
{
"code": "000",
"data": null,
"msg": "成功!"
}
