购买卡退款
当供应商取消使用 P-cards 的航班时,退还兑换的旅行积分
当航空供应商更改旅客的计划时,您可以协助退还他们用于购买卡(P-card)预订所赚取的忠诚度积分。您将创建一个文件并将其上传到 Expedia SFTP 服务器。从高层次来看,这意味着您将:
- 向 Expedia 请求 TPID、EAPID 和 SITEID 信息。此信息是报告名称的重要组成部分,以确保退款信息正确映射。请参阅命名约定部分以了解更多详细信息。
- 按照指定的格式和结构创建文件,并按照命名规范命名。
- 将文件上传到 Expedia SFTP 服务器。
通过遵守本文档中定义的部分,您可以确保文件在自动化过程中顺利处理,不会出现错误或遗漏。
获取信息
请求您的 P-card 发行机构提供每日数据文件,其中将包含您发送给 Expedia 的购买卡退款报告所需的报告数据点。通常,P-card 支付处理器(例如,TSYS)将提供此报告。
文件格式
要成功处理退款文件,必须符合以下标准:
- 对于未加密文件,文件格式必须为
.csv;对于加密文件,文件格式必须为.pgp。提交加密文件时,请确保使用 PGP 加密将整个文件作为单个实体加密,而不是单独加密每一行。 - 文件的第一行必须始终包含列标题。
- 必须按照列出的顺序包含下表中的所有 10 列。不应包含任何额外的列。
- 每行的内容必须用管道字符(
|)分隔,而不是逗号。 - 在列标题之后,每一行对应一条交易记录。
- 所有必需的列必须存在并包含有效数据。缺少必填字段的记录将被跳过或标记为供代理审查。
文件结构
承运商将提供 AIR_CONFIRMATION_NUMBER 或 AIR_TICKET_NUMBER,因此请同时包含这两个属性以确保报告退款。
最好将有条件必填字段(AIR_TICKET_NUMBER 和 AIRLINE_CARRIER_CODE)包含在您的报告中,但如果承运人不提供数据,则报告在被 Expedia 提取时不会失败。
| 命令 | 列名 | 说明 | 数据类型 | 示例 | 是否必需? |
|---|---|---|---|---|---|
| 1 | AIR_TICKET_NUMBER | 机票号码。必须是 10 位数字。如果此字段没有值,则需要代理审核以匹配带有 Expedia 的记录。注意:无票航空公司将使用确认号码。 | 字符串 | 9607721439 | 必填(有条件) |
| 2 | AIRLINE_CARRIER_CODE | 2 或 3 个字符的字母数字航空公司 IATA 代码。如果此字段没有值,则需要代理审核以匹配带有 Expedia 的记录。 | 字符串 | DL(达美航空) 加拿大航空 UA(联合航空) | 必填(有条件) |
| 3 | TRANSACTION_AMOUNT | 代表卡内金额的 2 位小数。负数金额表示退款。 注意:退款交易需要此字段,但信用交易不需要此字段。 | 号码 | 104.23(已充电) -104.23(退款) | 必填 |
| 4 | CURRENCY_CODE | 3 个字母的 ISO 货币代码。 | 字符串 | CAD USD | 必填 |
| 5 | POST_DATE | P-card 发布日期采用 mm/dd/yyyy 格式。 | 日期 | 11/07/2024 | 必填 |
| 6 | TRANSACTION_DATE | P-card 交易日期采用 mm/dd/yyyy 格式。 | 日期 | 07/07/2024 | 必填 |
| 7 | TRAVELER_FIRST_NAME | 与机票相关的旅客的名字。最多 50 个字符。不要使用管道字符。 允许的值:拉丁字母(A-Z, a-z), 重音字母(例如 é、ü、ç)、数字、空格。 | 字符串 | 帕尔瓦蒂 玛丽·安 | 可选 |
| 8 | TRAVELER_LAST_NAME | 与机票相关的旅客的姓氏。最多 50 个字符。不要使用管道字符。 允许的值:拉丁字母(A-Z, a-z), 重音字母(例如 é、ü、ç)、数字、空格。 | 字符串 | 史密斯 德拉克鲁斯 | 可选 |
| 9 | SUPPLY_INFO | 有关供应商的附加信息,通常是商家名称。最多 300 个字符。 允许的值:拉丁字母(A-Z, a-z), 数字、空格。不允许使用特殊字符(例如 @、'、-、#、é、ç)。 | 字符串 | 空气罐 0111111111111 加勒比 AI1062222222222 布鲁塞尔人工智能 0823333333333 | 可选 |
| 10 | AIR_CONFIRMATION_NUMBER | 6 位字母数字空中确认号码。当不存在票号时,此字段用作标识符。仅在与无票承运人打交道时才需要它。 允许的值:拉丁字母(A-Z, a-z), 数字。 请勿使用:空格、特殊字符(例如@、#、é、ç) | 字符串 | ABCD12 | 可选(无票处理必需) |
示例文件
文件名: [PARTNERNAME]_ 5002_900188_ 900188_20241108.csv
AIR_TICKET_NUMBER|AIRLINE_CARRIER_CODE|TRANSACTION_AMOUNT|CURRENCY_CODE|POST_DATE|TRANSACTION_DATE|TRAVELER_FIRST_NAME|TRAVELER_LAST_NAME|SUPPLY_INFO|AIR_CONFIRMATION_NUMBER
9607721439|AC|104.23|CAD|11/07/2024|11/01/2024|Sam F.|Doe|AIR CAN 0111111111111|ABCD12
5954412772|WS|-550.9|CAD|02/08/2024|02/04/2024|John|Smith|CARIBBEAN AI1062222222222|WQJGL5
54412723|UA|-265.9|CAD|02/09/2024|02/04/2024||||文件参数
在您上传退款文件之前,您需要遵循一些标准约定,包括设置文件名和加密信息。
命名约定
所有提交退款的文件必须遵循下面概述的命名约定。任何与此格式的偏差都将导致文件被排除在处理之外。
文件名的结构应如下:[PARTNERNAME]_TPID_EAPID_SITEID_YYYYMMDD.csv,其中:
- PARTNERNAME:您的组织的名称。
- TPID:Expedia 分配的旅游产品 ID。
- EAPID:Expedia 分配的 Expedia 附属合作伙伴 ID。
- SITEID:Expedia 分配的站点销售点 ID。
- YYYYMMDD = 文件生成的年、月、日,年份用 4 位数字表示,月份和日期各用 2 位数字表示。
文件名中不要包含特殊字符或空格。文件大小不应超过 5 GB。
加密
为了增强安全性,您可以选择使用 PGP 加密文件。向您的客户经理索取我们的公共 PGP 密钥,然后:
- 保护整个文件,而不仅仅是其内容。
- 添加 .pgp 扩展名(例如,
PARTNERNAME_0_1_1_20250101.pgp)
上传说明
要成功处理文件,必须使用 Expedia SFTP 主机名提交:eps-pcard-transactions-datafeed.transfer.expedia.com。
要建立 SFTP 连接,您需要提供以下详细信息:
- SFTP 用户的首选用户名(字母数字,最多 20 个字符)
- SSH(安全外壳)公钥
- 要添加到允许列表的 IP 子网(仅允许从该允许子网进行 SFTP 连接)
使用任何 SFTP 连接工具,在 SFTP 客户端上打开一个新连接。选择安全文件传输协议并输入您的 Expedia 帐户经理将提供的服务器和用户名。
**注意:**您每天只能上传一次退款文件。
测试
在启动您的模板网站之前,我们建议您测试退款上传流程。 对于初步验证,首先上传包含模拟数据的示例报告文件。我们将验证文件是否已收到并确认数据已成功处理。
然后,在网站启动之前通过生产预订进行验证。您的 Expedia 客户经理将与您协调,根据用户验收测试期间进行的生产测试预订,提交特定日期的报告。