발권 – Galileo uAPI 메뉴얼

AirTicketing

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

Overview:

요금계산된 PNR을 AirTicketing 로 현금발권 , 카드발권, 혼합발권을 할 수 있습니다.
국내카드 9번으로 시작하는 카드는 발권시 오류건 수정완료. -> 참조 : https://uapisupport.travelport.co.kr/?page_id=548

기본 Element

AirReservationLocatorCode : GDS PNR이 아닌 AirReservationPNR
AirPricingInfoRef : 기존 Pricing 키값
BookingTravelerRef : 여려명인 경우 탑승객 키값
FormOfPayment : Card, Cash 종류
Commission : air:AirTicketingModifiers 별로 필요시 각각 입력.

PNR 이 열려있으면 발권이 되지 않는다.

The Provider reservation is being modified externally. Please Air Ticket later.

uAPI 가상 발권프린트가 세팅 되지 않으면 다음 오류가 난다.

Error linking ticketing device. INVALID GTID

AirPricingInfoGroup=”1″ 하나인 경우 성인2명 결제방법들이 다른 경우

터미널에서도 한번에 발권이 안되기 때문에 2번 발권한다.

국내승인이 아닌 host 해외승인 항공사

현재 기준 HOST 승인처리 해야 하는 항공사는 AV, CM, HU, PS, TP, VA, WY 입니다.
host 승인 결제는 승인번호 Attribute 를 빼주시고 전송하면 호스트 승인이 됩니다. (ApprovalCode=”22338897″ 빼고 전송)

주의 : 카드가 일시불 일때는 ExtendedPayment=’00’ (X) 이 아니라 반드시 ExtendedPayment=” 공백 으로 해야합
00 처리시 : IATA 정산시 문제 발생

※발권결과 결제 금액이 KRW0 으로 리턴되는 항공사 : CA MU NZ NZ

항공사는 Travel Sky 시스템을 사용하는 항공사 입니다
시스템이 호스트 시스템에서 티켓 데이터 정보를 반환하지 않기 때문 결제 금액이 KRW0 으로 리턴 됩니다.
KRW0 으로 리턴되어도 문제가 없습니다.

PlatingCarrier

Price 할때 낮은 운임으로 자동 Price 하기 때문에 항공사 지정이 필요할 때는 PlatingCarrier 를 Price, Create, Ticketing 에 지정 하는 것을 권장 합니다.

E-Ticket Coupon Status:

Code=”P” Description=”Partially Refunded”
Code=”A” Description=”Airport Controlled”
Code=”S” or “F” Description=”Used”
Code=”N” Description=”Unused”
Code=”U” Description=”Unticketed”
Code=”T” Description=”Ticketed”
Code=”V” Description=”Voided”
Code=”R” Description=”Refunded”
Code=”X” Description=”eXchanged”
Code=”Z” Description=”Unknown/Archived/Carrier Modified”

중요) Sample은 몇 명씩 한번에 발권하는 방식이나, 실무처럼 한프로세스에 한명씩 발권을 한 다음, 확인 절차로 진행 요망

All현금 2명


<soapenv:Envelope xmlns:com="http://www.travelport.com/schema/common_v49_0" xmlns:air="http://www.travelport.com/schema/air_v49_0" xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/">
	<soapenv:Body>
	<air:AirTicketingReq BulkTicket="false" ReturnInfoOnFail="true" RetrieveProviderReservationDetails="false" TargetBranch="P*******" AuthorizedBy="user" TraceId="202006041109">
		<com:BillingPointOfSaleInfo OriginApplication="UAPI"/>
		<air:AirReservationLocatorCode>6K1OVM</air:AirReservationLocatorCode>
		<air:AirPricingInfoRef Key="X4moUIBAAA/BBKR7uJAAAA==">
		  <com:BookingTravelerRef Key="torp1JkJ0BKAzYUVxAAAAA=="> </com:BookingTravelerRef>
		</air:AirPricingInfoRef>
		<air:AirPricingInfoRef Key="X4moUIBAAA/BLLR7uJAAAA==">
		   <com:BookingTravelerRef Key="torp1JkJ0BKApYUVxAAAAA=="> </com:BookingTravelerRef>
		</air:AirPricingInfoRef>
		<air:AirTicketingModifiers PlatingCarrier="KE">
		   <air:AirPricingInfoRef Key="X4moUIBAAA/BBKR7uJAAAA=="/>
                   <com:Commission  Level="Fare" Type="PercentBase" Percentage="0.0" />
		   <com:FormOfPayment  Type='Cash'>
		      <com:ProviderReservationInfoRef ProviderReservationLevel="true"/>
		   </com:FormOfPayment>
	    </air:AirTicketingModifiers>
		<air:AirTicketingModifiers>
		<air:AirPricingInfoRef Key="X4moUIBAAA/BLLR7uJAAAA=="/>
                <com:Commission Level="Fare" Type="PercentBase" Percentage="0.0" />
                   <com:FormOfPayment  Type='Cash'>
			  <com:ProviderReservationInfoRef ProviderReservationLevel="true"/>
		  </com:FormOfPayment>
		</air:AirTicketingModifiers>
	</air:AirTicketingReq>
	</soapenv:Body>
</soapenv:Envelope>

<soapenv:Envelope xmlns:com="http://www.travelport.com/schema/common_v49_0" xmlns:air="http://www.travelport.com/schema/air_v49_0" xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/">

<soapenv:Body>

<air:AirTicketingReq BulkTicket="false" ReturnInfoOnFail="true" RetrieveProviderReservationDetails="false" TargetBranch="P*******" AuthorizedBy="user" TraceId="202006041109">

<com:BillingPointOfSaleInfo OriginApplication="UAPI"/>

<air:AirReservationLocatorCode>6K1OVM</air:AirReservationLocatorCode>

<air:AirPricingInfoRef Key="X4moUIBAAA/BBKR7uJAAAA==">

<com:BookingTravelerRef Key="torp1JkJ0BKAzYUVxAAAAA=="> </com:BookingTravelerRef>

</air:AirPricingInfoRef>

<air:AirPricingInfoRef Key="X4moUIBAAA/BLLR7uJAAAA==">

<com:BookingTravelerRef Key="torp1JkJ0BKApYUVxAAAAA=="> </com:BookingTravelerRef>

</air:AirPricingInfoRef>

<air:AirTicketingModifiers PlatingCarrier="KE">

<air:AirPricingInfoRef Key="X4moUIBAAA/BBKR7uJAAAA=="/>

<com:Commission Level="Fare" Type="PercentBase" Percentage="0.0" />

<com:FormOfPayment Type='Cash'>

<com:ProviderReservationInfoRef ProviderReservationLevel="true"/>

</com:FormOfPayment>

</air:AirTicketingModifiers>

<air:AirTicketingModifiers>

<air:AirPricingInfoRef Key="X4moUIBAAA/BLLR7uJAAAA=="/>

<com:Commission Level="Fare" Type="PercentBase" Percentage="0.0" />

<com:FormOfPayment Type='Cash'>

<com:ProviderReservationInfoRef ProviderReservationLevel="true"/>

</com:FormOfPayment>

</air:AirTicketingModifiers>

</air:AirTicketingReq>

</soapenv:Body>

</soapenv:Envelope>

ALL카드 2명


<soapenv:Envelope xmlns:com="http://www.travelport.com/schema/common_v49_0" xmlns:air="http://www.travelport.com/schema/air_v49_0" xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/">
<soapenv:Body>
<air:AirTicketingReq BulkTicket="false" ReturnInfoOnFail="true" RetrieveProviderReservationDetails="false" TargetBranch="P*******" AuthorizedBy="user" TraceId="202006041109">
	<com:BillingPointOfSaleInfo OriginApplication="UAPI"/>
	<air:AirReservationLocatorCode>6K1OVM</air:AirReservationLocatorCode>
	<air:AirPricingInfoRef Key="X4moUIBAAA/BBKR7uJAAAA==">
		<com:BookingTravelerRef Key="torp1JkJ0BKAzYUVxAAAAA=="> </com:BookingTravelerRef>
	</air:AirPricingInfoRef>
		<air:AirPricingInfoRef Key="X4moUIBAAA/BLLR7uJAAAA==">
	<com:BookingTravelerRef Key="torp1JkJ0BKApYUVxAAAAA=="> </com:BookingTravelerRef>
	</air:AirPricingInfoRef>
	<air:AirTicketingModifiers PlatingCarrier="KE">
		<air:AirPricingInfoRef Key="X4moUIBAAA/BBKR7uJAAAA=="/>
                <com:Commission Level="Fare" Type="PercentBase" Percentage="0.0" />
		<com:FormOfPayment Type="Credit">
		<com:CreditCard Type="CA" ExtendedPayment="" ApprovalCode="22338897" ExpDate="2020-10" Number="5XXXXXXXXXXXXXXX"/>
		<com:ProviderReservationInfoRef ProviderReservationLevel="true"/>
		</com:FormOfPayment>
	</air:AirTicketingModifiers>
	<air:AirTicketingModifiers PlatingCarrier="KE">
		<air:AirPricingInfoRef Key="X4moUIBAAA/BLLR7uJAAAA=="/>
               <com:Commission Level="Fare" Type="PercentBase" Percentage="0.0" />
		<com:FormOfPayment Type="Credit">
		<com:CreditCard Type="CA" ExtendedPayment="" ApprovalCode="22338897" ExpDate="2020-10" Number="5XXXXXXXXXXXXXXX"/>
		<com:ProviderReservationInfoRef ProviderReservationLevel="true"/>
		</com:FormOfPayment>
	</air:AirTicketingModifiers>
</air:AirTicketingReq>
</soapenv:Body>
</soapenv:Envelope>

<soapenv:Envelope xmlns:com="http://www.travelport.com/schema/common_v49_0" xmlns:air="http://www.travelport.com/schema/air_v49_0" xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/">

<soapenv:Body>

<air:AirTicketingReq BulkTicket="false" ReturnInfoOnFail="true" RetrieveProviderReservationDetails="false" TargetBranch="P*******" AuthorizedBy="user" TraceId="202006041109">

<com:BillingPointOfSaleInfo OriginApplication="UAPI"/>

<air:AirReservationLocatorCode>6K1OVM</air:AirReservationLocatorCode>

<air:AirPricingInfoRef Key="X4moUIBAAA/BBKR7uJAAAA==">

<com:BookingTravelerRef Key="torp1JkJ0BKAzYUVxAAAAA=="> </com:BookingTravelerRef>

</air:AirPricingInfoRef>

<air:AirPricingInfoRef Key="X4moUIBAAA/BLLR7uJAAAA==">

<com:BookingTravelerRef Key="torp1JkJ0BKApYUVxAAAAA=="> </com:BookingTravelerRef>

</air:AirPricingInfoRef>

<air:AirTicketingModifiers PlatingCarrier="KE">

<air:AirPricingInfoRef Key="X4moUIBAAA/BBKR7uJAAAA=="/>

<com:Commission Level="Fare" Type="PercentBase" Percentage="0.0" />

<com:FormOfPayment Type="Credit">

<com:CreditCard Type="CA" ExtendedPayment="" ApprovalCode="22338897" ExpDate="2020-10" Number="5XXXXXXXXXXXXXXX"/>

<com:ProviderReservationInfoRef ProviderReservationLevel="true"/>

</com:FormOfPayment>

</air:AirTicketingModifiers>

<air:AirTicketingModifiers PlatingCarrier="KE">

<air:AirPricingInfoRef Key="X4moUIBAAA/BLLR7uJAAAA=="/>

<com:Commission Level="Fare" Type="PercentBase" Percentage="0.0" />

<com:FormOfPayment Type="Credit">

<com:CreditCard Type="CA" ExtendedPayment="" ApprovalCode="22338897" ExpDate="2020-10" Number="5XXXXXXXXXXXXXXX"/>

<com:ProviderReservationInfoRef ProviderReservationLevel="true"/>

</com:FormOfPayment>

</air:AirTicketingModifiers>

</air:AirTicketingReq>

</soapenv:Body>

</soapenv:Envelope>

카드발권 형식 2


<soapenv:Envelope xmlns:com="http://www.travelport.com/schema/common_v49_0" xmlns:air="http://www.travelport.com/schema/air_v49_0" xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/">
<soapenv:Body>
<air:AirTicketingReq BulkTicket="false" ReturnInfoOnFail="true" RetrieveProviderReservationDetails="false" TargetBranch="P*******" AuthorizedBy="user" TraceId="202006041109">
	<com:BillingPointOfSaleInfo OriginApplication="UAPI"/>
	<air:AirReservationLocatorCode>6K1OVM</air:AirReservationLocatorCode>
	<air:AirPricingInfoRef Key="X4moUIBAAA/BBKR7uJAAAA==">
		<com:BookingTravelerRef Key="torp1JkJ0BKAzYUVxAAAAA=="> </com:BookingTravelerRef>
	</air:AirPricingInfoRef>
	
	<air:AirTicketingModifiers>
		<air:AirPricingInfoRef Key="X4moUIBAAA/BBKR7uJAAAA=="/>
        <com:Commission Level="Fare" Type="PercentBase" Percentage="0.0" />
		<com:FormOfPayment Key="101 Type="Credit">
		<com:CreditCard Key="101" Type="AX" ExtendedPayment="" ExpDate="2029-12" Number="370000000000028"/><!-- test Card -->
		<com:ProviderReservationInfoRef ProviderReservationLevel="true"/>
		</com:FormOfPayment>
		<CreditCardAuth PaymentRef="Payment0" Amount="KRW1049200" AuthCode="22338897" AuthResultCode="Approved" FormOfPaymentRef="101"/>
	</air:AirTicketingModifiers>
	
</air:AirTicketingReq>
</soapenv:Body>
</soapenv:Envelope>

<soapenv:Envelope xmlns:com="http://www.travelport.com/schema/common_v49_0" xmlns:air="http://www.travelport.com/schema/air_v49_0" xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/">

<soapenv:Body>

<air:AirTicketingReq BulkTicket="false" ReturnInfoOnFail="true" RetrieveProviderReservationDetails="false" TargetBranch="P*******" AuthorizedBy="user" TraceId="202006041109">

<com:BillingPointOfSaleInfo OriginApplication="UAPI"/>

<air:AirReservationLocatorCode>6K1OVM</air:AirReservationLocatorCode>

<air:AirPricingInfoRef Key="X4moUIBAAA/BBKR7uJAAAA==">

<com:BookingTravelerRef Key="torp1JkJ0BKAzYUVxAAAAA=="> </com:BookingTravelerRef>

</air:AirPricingInfoRef>

<air:AirTicketingModifiers>

<air:AirPricingInfoRef Key="X4moUIBAAA/BBKR7uJAAAA=="/>

<com:Commission Level="Fare" Type="PercentBase" Percentage="0.0" />

<com:FormOfPayment Key="101 Type="Credit">

<com:CreditCard Key="101" Type="AX" ExtendedPayment="" ExpDate="2029-12" Number="370000000000028"/>

<com:ProviderReservationInfoRef ProviderReservationLevel="true"/>

</com:FormOfPayment>

</air:AirTicketingModifiers>

</air:AirTicketingReq>

</soapenv:Body>

</soapenv:Envelope>

(카드+현금) 혼합발권 1명


<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" 
xmlns:air="http://www.travelport.com/schema/air_v50_0" 
xmlns:com="http://www.travelport.com/schema/common_v50_0">
  <soapenv:Body>
 <air:AirTicketingReq  BulkTicket="false" ReturnInfoOnFail="true" TargetBranch="P*******" AuthorizedBy="Travelport" TraceId="TraceId">
<com:BillingPointOfSaleInfo OriginApplication="UAPI"/>
 
<air:AirReservationLocatorCode>0TLF43</air:AirReservationLocatorCode>
<air:AirPricingInfoRef Key="TDCKxE8Q2BKAa9s+EAAAAA==">
	<com:BookingTravelerRef Key="TDCKxE8Q2BKAjpq+EAAAAA==">
		<com:PaymentRef Key="1"/>
		<com:PaymentRef Key="2"/>
	</com:BookingTravelerRef>
</air:AirPricingInfoRef>
 
<air:AirTicketingModifiers>
       <air:AirPricingInfoRef Key="TDCKxE8Q2BKAa9s+EAAAAA==">
	<com:Commission  Level="Fare" Type="PercentBase" Percentage="0.0" />
	  <com:FormOfPayment  Key="3" Type="Credit">
	    <com:CreditCard  Key="3" ExpDate="2020-11" Type="AX"  Number="***********0028" ExtendedPayment="03" />
	         <com:ProviderReservationInfoRef ProviderReservationLevel="true"/>
	     </com:FormOfPayment>
	    <com:FormOfPayment  Key="4" Type="Cash"/>
     <com:CreditCardAuth  FormOfPaymentRef="3" AuthResultCode="Approved" AuthCode="12345678" Amount="KRW1000000" PaymentRef="1"/>
	    	     
<com:Payment Key="1" Type="Itinerary" FormOfPaymentRef="3" Amount="KRW1000000" />
<com:Payment Key="2" Type="Itinerary" FormOfPaymentRef="4" Amount="KRW49200" />
	     
</air:AirTicketingModifiers>
 
      </air:AirTicketingReq>
   </soapenv:Body>
</soapenv:Envelope>

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"

xmlns:air="http://www.travelport.com/schema/air_v50_0"

xmlns:com="http://www.travelport.com/schema/common_v50_0">

<soapenv:Body>

<air:AirTicketingReq BulkTicket="false" ReturnInfoOnFail="true" TargetBranch="P*******" AuthorizedBy="Travelport" TraceId="TraceId">

<com:BillingPointOfSaleInfo OriginApplication="UAPI"/>

<air:AirReservationLocatorCode>0TLF43</air:AirReservationLocatorCode>

<air:AirPricingInfoRef Key="TDCKxE8Q2BKAa9s+EAAAAA==">

<com:BookingTravelerRef Key="TDCKxE8Q2BKAjpq+EAAAAA==">

<com:PaymentRef Key="1"/>

<com:PaymentRef Key="2"/>

</com:BookingTravelerRef>

</air:AirPricingInfoRef>

<air:AirTicketingModifiers>

<air:AirPricingInfoRef Key="TDCKxE8Q2BKAa9s+EAAAAA==">

<com:Commission Level="Fare" Type="PercentBase" Percentage="0.0" />

<com:FormOfPayment Key="3" Type="Credit">

<com:CreditCard Key="3" ExpDate="2020-11" Type="AX" Number="***********0028" ExtendedPayment="03" />

<com:ProviderReservationInfoRef ProviderReservationLevel="true"/>

</com:FormOfPayment>

<com:FormOfPayment Key="4" Type="Cash"/>

<com:CreditCardAuth FormOfPaymentRef="3" AuthResultCode="Approved" AuthCode="12345678" Amount="KRW1000000" PaymentRef="1"/>

<com:Payment Key="1" Type="Itinerary" FormOfPaymentRef="3" Amount="KRW1000000" />

<com:Payment Key="2" Type="Itinerary" FormOfPaymentRef="4" Amount="KRW49200" />

</air:AirTicketingModifiers>

</air:AirTicketingReq>

</soapenv:Body>

</soapenv:Envelope>

테스트가능 카드+ 승인번호 : CreditCard Type=”AX” ApprovalCode=”123456789″ ExtendedPayment=”” Number=”370000000000028″ ExpDate=”2026-11″

한국에선 Van사를 통해 결제 후 승인번호를 받아 위와 같이 승인 번호를 넣고 발권 하는게 일반적입니다.
항공사가 PG 가입시 PG 승인번호도 가능 합니다.