購買卡退款
當供應商取消使用 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), 重音字母(例如 é、ü、ç)、數字、空格。 | 字串 | Smith 德拉克魯斯 | 選擇性 |
| 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 客戶經理將與您協調,根據使用者驗收測試期間進行的生產測試預訂,提交特定日期的報告。