Developer Hub
此為系統自動產生的翻譯

採購卡退款

當供應商取消使用 P-cards

當旅客的行程因航空公司供應商而變更時,您可以協助將其用於購買預訂卡 (P-card)) 所累積的忠誠度點數退還。您將建立一個檔案,並將其上傳至 Expedia 的 SFTP 伺服器。從宏觀層面來看,這意味著您將:

  1. 請向 Expedia 索取 TPID、EAPID 及 SITEID 資訊。此資訊是報告名稱中不可或缺的一部分,用以確保退款資訊能正確對應。
    >> 詳情請參閱「命名規範」一節
  2. 請依照指定的格式與結構建立檔案,並根據命名規範為其命名。
  3. 將檔案上傳至 Expedia 的 SFTP 伺服器。

只要遵循本文件中定義的各節內容,即可確保檔案在自動化處理過程中能順利完成,不會出現錯誤或遺漏。

獲取資訊

請要求您的「P-card」發卡機構提供一份每日資料檔案,其中須包含您提交給 Expedia 的採購卡退款報告所需的所有報告數據點。通常,P-card 的支付處理商 (例如 TSYS) 會提供這份報告。

檔案格式

要成功處理退款申請,該檔案必須符合以下標準:

  • 檔案格式必須為未加密檔案的.csv,或加密檔案的.pgp。提交加密檔案時,請確保使用 PGP 加密將整個檔案作為單一整體進行加密,而非逐行分別加密。
  • 檔案的第一行必須始終包含欄位標題。
  • 下表中的所有 10 個欄位都必須包含在內,且須按照所列順序排列。不應新增任何欄位。
  • 每一行的內容必須以縱桿 (|) 分隔,而非逗號。
  • 在欄位標題之後,每一行都對應於一筆交易記錄。
  • 所有必填欄位都必須存在,且必須包含有效資料。缺少必填欄位的記錄將會被跳過,或標記供客服人員審核。

檔案結構

承運商將提供「AIR_CONFIRMATION_NUMBER」或「AIR_TICKET_NUMBER」其中一項,因此請同時包含這兩項屬性,以確保退款能被正確回報。

最好將條件性必填欄位 (AIR_TICKET_NUMBERAIRLINE_CARRIER_CODE) 納入您的報表中,但若承運商未提供相關資料,該報表在由 Expedia 匯入時也不會導致匯入失敗。

訂單欄位名稱說明資料類型範例是否必要
1AIR_TICKET_NUMBER機票號碼。必須為 10 位數字。若此欄位未填入任何值,則需由客服專員進行審核,以將記錄與 Expedia 進行比對。註:採用無紙化機票的航空公司將改以確認編號代替。字串9607721439必選 (有條件)
2AIRLINE_CARRIER_CODE由 2 或 3 個字母數字組成的航空公司代碼 IATA 代碼中搜尋。若此欄位為空,則需由客服專員進行審核,以將記錄與 Expedia 進行比對。字串DL (Delta)
AC (加拿大航空)
UA (聯合航空)
必選 (有條件)
3TRANSACTION_AMOUNT2 位小數,表示從該卡扣款的金額。負數表示退款。
注意:此欄位在退款交易中為必填欄位,但在記帳交易中則非必填。
數字104.23 (已計費)
-104.23 (退款)
必填
4CURRENCY_CODE3 個字母的 ISO 貨幣代碼。字串CAD
USD
必填
5POST_DATEP-card 發文日期請以 mm/dd/yyyy 格式填寫。日期11/07/2024必填
6TRANSACTION_DATEP-card 交易日期,格式為 mm/dd/yyyy。日期07/07/2024必填
7TRAVELER_FIRST_NAME與該機票相關聯的旅客名字。最多 50 個字元。請勿使用管號。
允許的值:拉丁字母 (A-Z, a-z),、帶重音的字母(例如 é、ü、ç)、數字、空格。
字串帕爾瓦蒂
瑪麗·安
選擇性
8TRAVELER_LAST_NAME與該機票相關的旅客姓氏。最多 50 個字元。請勿使用管號。
允許的值:拉丁字母 (A-Z, a-z),、帶重音的字母(例如 é、ü、ç)、數字、空格。
字串Smith
德拉克魯茲
選擇性
9SUPPLY_INFO有關供應商的其他資訊,通常為商家名稱。最多 300 個字元。
允許的值:拉丁字母(A-Z, a-z), 數字、空格。不允許使用特殊字元 (例如 @、'、-、#、é、ç)。
字串氣罐 0111111111111
加勒比人工智慧 1062222222222
布魯塞爾 AI 0823333333333
選擇性
10AIR_CONFIRMATION_NUMBER6 位數的英數字組合航班確認號。當沒有票號時,此欄位將用作識別碼。僅在與無實體機票的航空公司打交道時才需要此項。
允許的值:拉丁字母(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 客戶經理將與您協調,根據使用者驗收測試期間所進行的生產測試預訂,針對特定日期提交一份報告。

這個頁面對您有幫助嗎?
我們能如何改善內容?
感謝您協助我們進行改善!