Void

AirVoidDocument

  • Endpoint : https://apac.universal-api.pp.travelport.com/B2BGateway/connect/uAPI/AirService

Overview

AirVoidDocument 은 당일  Void  서비스로  PNR  티켓번호 일부 또는 모두  Void 할 수 있습니다.
 Van 카드 결제 승인는 별도로 취소 해야 합니다.  

참조

수동Void 방법 : https://help.travelport.co.kr/?page_id=36

AirVoidDocumentReq

AirVoidDocumentRsp

📌 발생 가능한 오류 메시지 및 조건:

  1. DocumentType 또는 DocumentNumber만 전송한 경우 오류 발생
    → 두 값 중 하나만 전송하면 안 됩니다. 둘 다 보내거나 둘 다 생략해야 합니다.
    • 오류 메시지:
      “Document Type must complement Document Number in the request.”
      → “요청에는 Document Number와 함께 Document Type도 반드시 포함되어야 합니다.”
  2. ProviderCode 또는 ProviderLocatorCode만 전송한 경우 오류 발생
    • 오류 메시지:
      “Provider Code must complement Provider Locator Code in the request.”
      → “요청에는 Provider Locator Code와 함께 Provider Code도 반드시 포함되어야 합니다.”
  3. 권한이 없는 사용자가 문서를 취소하려고 시도한 경우
    • 오류 메시지:
      “Agent does not have permission to Void the document.”
      → “해당 문서를 Void할 권한이 없습니다.”
  4. 문서를 찾을 수 없는 경우
    • 오류 메시지:
      “Air Reservation does not exist.”
      → “해당 항공 예약이 존재하지 않습니다.”
  5. 여러 개의 AirReservation이 조회된 경우 오류 발생
    • 오류 메시지:
      “Document numbers grouped in an Air reservation are only allowed to Void.”
      → “Air Reservation에 그룹화된 문서 번호만 Void 처리가 허용됩니다.”
  6. Universal Record는 존재하지만 관련된 Air Reservation이 없는 경우
    • 오류 메시지:
      “Air Reservation does not exist.”
      → “관련 항공 예약이 존재하지 않습니다.”
  7. Universal Record는 있으나 Air Reservation에 해당 e-티켓 번호가 존재하지 않는 경우
    • 오류 메시지:
      “All the Requested E-Tickets not found. Please do a Universal Record Retrieve to sync the E-tickets.”
      → “요청한 모든 E-티켓을 찾을 수 없습니다. Universal Record를 다시 조회하여 동기화해 주세요.”
  8. AirReservationLocatorCode는 있으나 DocumentNumber와 DocumentType이 없고 해당 locator에 유효한 문서가 없을 경우
    • 오류 메시지:
      “No valid document exists for the Air reservation.”
      → “해당 항공 예약에 유효한 문서가 존재하지 않습니다.”

⚠️ 경고 메시지:

  • Universal API에서는 티켓이 성공적으로 Void되었으나, 공급자 측에서 e-티켓 조회 중 오류가 발생한 경우
    • 경고 메시지:
      “Ticket voided successfully, host error during retrieval.”
      → “티켓은 성공적으로 Void되었으나, 공급자 조회 중 오류가 발생했습니다.”

스키마