처리 과정을 평가하기 위해 예외 메시지의 문자 일치를 사용하지 마십시오.

  1. 예외의 속성(처리, 범주, 메시지)을 평가합니다.
  2. 요청 오류 때문에 예외가 발생하지 않았는지를 평가합니다.
    • 모든 항목과 값이 제대로 제출되도록 예제 요청의 형식이 올바른지 검토합니다.
    • 디버그 워크시트는 귀하의 요청을 올바른 형식의 요청과 비교하는 데 도움이 됩니다. XML Sandbox를 사용해 정확히 동일한 요청을 제출하고, XML 요청 문자열을 복사하고, 각 항목을 자신의 것과 나란히 비교합니다.
  3. 사용자의 이전 작업 뿐 아니라 반환된 처리 및 범주를 기반으로 작업 과정을 확인합니다.
    • 사용자가 다른 속성을 선택해야 합니까?
    • 사용자가 입력 데이터를 수정해야 합니까?
    • handling=AGENT_ATTENTION이 반환되면 에이전트가 연락하여 예약 요청을 처리할 것임을 사용자에게 알립니다.

공급업체 오류 메시지는 공지 없이 변경되며 해당 시스템에서 게시되지 않으므로 전체 메시지 목록을 알 수 없습니다.

  • 자체 오류 데이터베이스를 구축할 수 있도록 발생한 오류 메시지를 기록하고 수집합니다.
  • 자체 시스템의 메시지 요소, 범주 및 처리를 수집함으로써 공급업체 리소스에서 반환되는 새 메시지를 포함하여 발생하는 모든 오류를 원활하게 처리할 수 있습니다.

일반적인 응답 요소

요소 유형 설명
customerSessionId (string) 통계, 사용자 동작 및 트래픽을 컴파일하기 위해 사용자 세션 활동을 추적하도록 이 값이 반환됩니다. 모든 요청에 이 값을 포함하여 개별 사용자 세션에 기록합니다.
EanWsError(Ean Ws 오류) (Ean Ws 오류 개체) 루트 예외 노드

EanWsError(Ean Ws 오류)

요소 유형 설명
itineraryId (long) ID는 EAN 일정과 연결됩니다. 이 값은 예약 시 고객 서비스 에이전트와 연락하는 모든 경우에 필요합니다.  일정 ID는 예약 요청에만 반환됩니다. 예약 요청의 데이터 검증 오류는 itineraryID를 반환하지 않습니다.  일정이 반환되면 참조 번호로서 클라이언트에게 항상 반환합니다.  그렇게 하지 않으면 오류 내용이 충분하지 않아 참조 itineraryId(일정 ID)를 생성할 수 없습니다.
  • -1이 반환되면 일정 기록이 생성되지 않은 것이며 요청이 기록되지 않습니다.
  • 반환된 일정 ID는 예약과 관련하여 고객 센터와 연락하는 모든 경우에 사용해야 합니다.
  • 시스템에 상황을 기록할 수 있는 경우, 실패한 예약 요청에서 일정이 반환됩니다.
  • 신용카드 검증 오류와 같은 일부 경우에는 실패한 예약을 수정하기 위한 모든 후속 요청에 일정 ID를 포함할 수 있으며, 이렇게 하면 성공한 일정이 실패한 일정을 덮어씁니다.  그러면 동일한 고객에 대해 실패한 일정의 문자열이 방지됩니다.  예약 요청에서 itineraryId(일정 ID)를 전송할 때 실수가 성공적인 예약을 덮어쓰지 않도록 주의하십시오.
  • handling=AGENT_ATTENTION이 반환되면 에이전트가 후속 조치를 취할 수 있도록 오류가 표시됩니다. 그렇지 않은 경우 handling= UNKNOWN 또는 UNRECOVERABLE은 다시 제출해야 하는 새로운 예약 요청을 나타냅니다.
  • 반환된 범주는 동일한 예약을 다시 시도할 수 있는지(견적 키 실패) 또는 새 속성을 선택해야 하는지(예: 매진)를 나타냅니다.
  • 동일한 요청이 다시 제출되는 경우 사용자가 다시 선택할 수 있도록 객실 데이터를 새로 고치고 변경된 요금을 표시합니다. 그런 다음 다시 제출된 예약에 새로운 객실 데이터를 전송합니다.
exceptionConditionId(예외 조건 ID) (정수) 내부 참조용
프레젠테이션 메시지 (string) 반환된 프레젠테이션 오류 메시지
verboseMessage (string) 좀 더 상세한 특정 오류 메시지
handling (오류 처리 개체) 예외의 심각도 및 처리 방법을 나타내는 값
category (오류 범주 개체) 예외의 특성 또는 발생 이유를 나타내는 값
ErrorAttributes(오류 특성)
(오류 특성 개체) 추가 오류 데이터. 이 요소는 일반적으로 안전한 코드 신용카드 처리 또는 여러 위치 오류 수정을 위해 데이터를 반환합니다.
ServerInfo(서버 정보) (서버 정보 개체)

(minRev 7 이상)

특성:

  • serverTime = 현재 읽을 수 있는 형식이 지정된 시간
  • timestamp = 현재 시간(초)
    • 서명 인증을 사용할 때 인증 오류가 수신되면 sig 매개 변수를 생성할 수 있도록 이 값을 사용하여 다시 요청을 전송합니다. 시간대의 차이 때문에 일부 제휴사는 sig 값을 생성할 때 시간이 정확히 일치하지 않습니다. sig 값을 생성하고 이 방법으로 인증할 때 이 값을 사용하여 서버에 대해 시간을 동기화합니다.
  • instance = 내부 서버 인스턴스
예: <ServerInfo serverTime="19:11:13.082-0500" timestamp="1311725473" instance="48" />

errorHandling(오류 처리)

요소 설명
UNKNOWN 예약을 성공적으로 수행할 수 없으며 실패 이유를 알 수 없습니다.
RECOVERABLE 일반적으로 검증을 통과하지 못하는 정확하지 않은 속성과 같은 사용자 오류를 나타냅니다. 복구하려면 메시지에서 나타내는 대로 사용자가 입력란의 항목 오류를 수정하면 됩니다. 새로 고친 값으로 예약을 다시 제출하여 복구 가능한 오류가 될 수 있습니다.
UNRECOVERABLE 발생한 오류는 사용자나 고객 서비스 에이전트가 수정할 수 없습니다. 예약하려면 사용자는 돌아가서 검색을 다시 시작하거나 새로 고쳐야 합니다. 이 오류는 유효하지 않은 요청 문제, 사용할 수 없는 데이터 또는 공급업체 문제 때문에 발생합니다.
AGENT_ATTENTION

일정을 기록하지 못했지만, 오류의 특성 또는 예약 시도 때문에 다음에 유의해야 합니다.

  • 에이전트는 예약을 수동으로 완료해야 합니다.
  • 거짓으로 표시된 예약을 확인합니다.
  • 오류가 발생했다고 사용자에게 답변하고 예약 요청 과정을 따라 할 의사가 있는지 물어봅니다. 많은 경우 사용자는 웹 사이트로 돌아가 온라인으로 예약을 다시 시도할 수 있습니다.

errorCategory(오류 범주)

요소 설명
UNKNOWN 알 수 없는 처리 실패
EXCEPTION 확인할 수 없는 오류
CREDITCARD 신용카드 처리 오류
DATA_VALIDATION 사용자 항목 오류
AUTHENTICATION 무단 액세스, 액세스 권한을 인증할 수 없음
UNABLE_TO_PROCESS_REQUEST 요청을 처리할 수 없음
INVALID_PROPERTY_ID 유효하지 않은 호텔 ID 또는 비활성화된 호텔 ID
RESULT_NULL 결과 없음
PROCESS_FAIL 처리 실패
SOLD_OUT 매진
RESTRICTED_CHECKIN 제한된 체크인 규칙을 충족하지 않는 숙박 일수
ONEROOM  
SUPPLIER_COMMUNICATION 공급업체 통신 실패, 공급업체 연결 문제
DATA_PARSE_RESULT 데이터 구문 분석 문제
CORPORATE_RATE 요금에 대한 회사 ID가 필요함
RES_NOT_FOUND 예약을 찾을 수 없음
RES_CANCELLED 예약 취소됨
HRN_QUOTE_KEY_FAILURE 요금 키 실패, 검색을 새로 고쳐 새로운 요금 키 얻기
HRN_QUOTE_KEY_INVALID 유효하지 않은 요금 키, 검색을 새로 고쳐 새로운 요금 키 얻기
SYS_OFFLINE 공급업체 시스템 오프라인 또는 다운
SUPPLIER_INITITIALIZATION 공급업체에 연결할 수 없음
SUPPLIER_ROUTER_EXCEPTION 공급업체에 연결할 수 없음
EJB_CREATE_EXCEPTION 예약 예외
FINDER_EXCEPTION 공급업체 예외
BML_FAIL 공급업체 예외
PRICE_MISMATCH 요금 변경, 검색을 새로 고치거나 새 객실 또는 속성을 선택하여 새 요금 얻기
CSV_FAIL 잘못된 신용카드 보안 값
PAYER_AUTH_REQUIRED 신용카드에는 예약 요청 및 테스트 예약 절차에서 설명한 것처럼 보안 코드 VBV/3DS 신용카드 절차가 필요합니다.
PAYER_AUTH_FAILED 보안 코드 잘못됨 또는 보안 코드 처리 실패
ITINERARY_ALREADY_BOOKED 시스템에서 기존 일정이 이미 발견됨

ErrorAttributes(오류 특성)

요소 type
항목 (항목 개체)
항목
(오류 특성 지도 개체)
value (string)

errorAttributesMap(오류 특성 지도)

요소 설명
CC_TRANSACTIONSTATUS  
TRANSACTIONSTATUSMSG  
PA_TRANSACTIONSTATUS VBV / 3DS 세부내역
XID VBV / 3DS 세부내역
ACS_URL  
VBV / 3DS 세부내역
PA_REQ VBV / 3DS 세부내역
AUTH_CODE VBV / 3DS 세부내역
PAS_TRANSACTION_ID VBV / 3DS 세부내역
SUPPLIER_ERROR_CODE  

XML 예제 예외

<ns2:HotelRoomAvailabilityResponse size="0">
  <EanWsError>
    <itineraryId>-1</itineraryId>
    <handling>RECOVERABLE</handling>
    <category>DATA_VALIDATION</category>
    <exceptionConditionId>-1</exceptionConditionId>
    <presentationMessage>TravelNow.com cannot service this request.</presentationMessage>
    <verboseMessage>Data in this request could not be validated: Specified arrival date is prior to today's date.</verboseMessage>
    <ServerInfo serverTime="19:11:13.082-0500" timestamp="1311725473" instance="48" />
  </EanWsError>
  <customerSessionId>0ABAA825-0BE2-8912-CF12-59D0D9032F8</customerSessionId>
</ns2:HotelRoomAvailabilityResponse>