1 通用说明 #

1.1 使用的IATA版本号 #

18.2

1.2 注意事项 #

1、对接厦航ndc接口进行测试时，请预定远期的、避开节假日的航班，并且当天出票要在当天退票
2、使用外卡支付时，需要提前开通IP白名单才可访问3ds认证地址

1.3 NDC消息对可销售的产品列表 #

国内机票、国际机票(AirShoppingRQ/RS)
优惠券(ServiceListRQ/RS)
餐食(ServiceListRQ/RS)
选座(SeatAvailabilityRQ/RS)
行李(ServiceListRQ/RS)

1.4 请求消息通用部分说明 #

1.4.1 请求头部设置 #

厦航要求在使用除了AirShoppingRQ/AirShoppingRS、OfferPriceRQ/OfferPriceRS、ServiceListRQ/ServiceListRS、SeatAvailabilityRQ/SeatAvailabilityRS之外的消息对请求接口的时候，在头部设置登录用户ID。
登录用户ID放HttpHeader头部，key为user_id。该字段表示您系统中登录用户的唯一ID或者能表示登录用户唯一性的ID或者是登录用户ID hash过后的值 (能表示登录用户唯一性即可，该字段除了调用airShopping接口之外都是必传的。为了测试和排查问题方便，测试环境user_id可以传固定值，生产环境请传登录用户唯一ID)
当然，如果旅客在您平台上非登录购票，user_id可以填写为订单联系人的手机号或者邮箱

1.4.2 NDC请求消息通用参数说明 #

NDC的请求消息都会包含AugmentationPoint、MessageDoc、Party、PayloadAttributes、 PointOfSale、 Request 等6个属性。请求消息的Request 属性随着请求不同而不同，但其他5个属性结构一致，如下：

当发起请求时，5个通用属性的说明如下：
1、AugmentationPoint：不填
2、MessageDoc：
a)Name：填XIAMEN AIRLINES NDC GATEWAY
b)RefVersionNumber：填20180200.00
3、Party:
a)Participant：非必填
b)Recipient：非必填
c)Sender：填写消息发送方的信息，飞猪填写TravelAgency属性，内容如下：
AgencyID：QUNAR
其他属性可不填
4、PayloadAttributes:
a)EchoTokenText：请求的唯一GUID，返回的消息会带上此GUID.非必填
b)VersionNumber：填182.00
c)其他属性：不填
5、PointOfSale：必填，填写国家或者城市销售站点信息，比如：

<PointOfSale>
        <City>
            <IATALocationCode>XMN</IATALocationCode>
        </City>
</PointOfSale>
或者
<PointOfSale>
        <Country>
            <CountryCode>CN</CountryCode>
        </Country>
</PointOfSale>

6、各个请求消息的Request信息随具体消息而变，参见后面说明及附带的xsd文件。

1.4.2.1 调用方的Party信息填写 #

如果调用方的角色为代理（比如OTA），需要填写的Party信息如下，其中AgencyID由厦航给定

<Party>
    <Sender>
        <TravelAgency>
            <AgencyID>WOYAOQUNAER</AgencyID>
        </TravelAgency>
    </Sender>
</Party>

如果调用方的角色为聚合器aggregator，需要填写的Party信息如下,其中AggregatorID和AgencyID由厦航给定

<Party>
    <Participant>
        <Aggregator>
            <AggregatorID>CDP-LINK</AggregatorID>
            <Name>TravelNDC</Name>
        </Aggregator>
    </Participant>
    <Sender>
        <TravelAgency>
            <AgencyID>AgencyID</AgencyID>
            <IATANumber>00000000</IATANumber>
            <Name>fliggy</Name>
        </TravelAgency>
    </Sender>
</Party>

如果调用方的角色为TMC,需要填写的Party信息如下,其中AgencyID由厦航给定

<Party>
    <Sender>
        <TravelAgency>
            <!--TMC唯一标识-->
            <AgencyID>TMC-NAME</AgencyID>
            <!--代理类型，TMC为TravelManagementCompany-->
            <TypeCode>TravelManagementCompany</TypeCode>
        </TravelAgency>
    </Sender>
</Party>

1.4.3 响应消息通用部分说明 #

NDC的响应消息都会包含AugmentationPoint、MessageDoc、PayloadAttributes、Response（或Error）。如下：

1、AugmentationPoint、MessageDoc、PayloadAttributes参数的返回值与请求的时候一致；
2、如果请求成功，只会返回Response，Response带详细的结果数据；如果请求异常，则返回Error的TypeCode不为200，Response无数据。
3、Error的说明：
a)TypeCode：
1)返回200：请求成功
2)返回300：客户端请求错误（请求参数或格式等错误）
3)返回400：业务异常
4)返回500：服务器内部异常
b)Code：不同的TypeCode下更详细的Code分类(见"错误码说明"章节)
c)DescText：错误信息的描述。如果是400业务异常，则是友好的错误信息(见"错误码说明"章节)。
d)其他：无返回数据
4、各个响应消息的Response信息随具体消息而变，参见后面说明及附带的xsd文件。