採購卡退款
當供應商取消使用 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 (Delta) AC (加拿大航空) 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 加勒比人工智慧 1062222222222 布魯塞爾 AI 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 指派的旅遊產品識別碼。
- EAPID:由 Expedia 指派的 Expedia 合作夥伴識別碼。
- SITEID:由 Expedia 指派給該網站的銷售點識別碼。
- YYYYMMDD = 檔案的建立年、月、日,其中年以 4 位數字表示,月和日則各以 2 位數字表示。
檔案名稱中請勿包含特殊字元或空格。檔案大小不應超過 5 GB。
加密
為了提高安全性,您可以選擇使用 PGP 對檔案進行加密。請向您的客戶經理索取我們的公開 PGP 金鑰,並:
- 請對整個檔案進行加密,而不僅是其內容。
- 請加上 .pgp 副檔名 (例如:
PARTNERNAME_0_1_1_20250101.pgp)
上傳說明
要成功處理該檔案,必須透過 Expedia SFTP 主機名稱提交:eps-pcard-transactions-datafeed.transfer.expedia.com。
為了建立 SFTP 連線,我們設定了 UAT 和生產環境的 SFTP 帳戶。您需要為這兩筆帳戶提供以下詳細資料:
- SSH (安全外殼) 公鑰
- 將此 IP 子網加入允許清單 (SFTP 連線僅限來自此允許的子網)
若您願意,也可以為 UAT 和生產環境帳戶使用相同的金鑰和 IP 子網。
請使用任何 SFTP 連線工具,在您的 SFTP 客戶端中建立新的連線。請選擇「安全檔案傳輸協定」,並輸入您的 Expedia 客戶經理所提供的伺服器名稱及使用者名稱。
SFTP 帳戶的使用者名稱將遵循以下格式:
- 製作:
<partner_name>-refunds - UAT:
<partner_name>-refunds-uat
注意: 您每天僅能上傳一次退款檔案。
測試
在推出您的範本網站之前,我們建議您先測試退款上傳流程。
進行初步驗證時,請先將包含模擬資料的範例報告檔案上傳至 UAT 帳戶。我們將確認已收到該檔案,並確認資料已成功處理。
接著,在網站上線前,請透過實際預訂進行驗證。您的 Expedia 客戶經理將與您協調,根據使用者驗收測試期間所進行的生產測試預訂,針對特定日期提交一份報告。