国际共享平台 API 使用说明

1 介绍

为了提高供应商在携程网的政策投放效率，满足其业务需求，由携程机票研发部门开发了一套供应商运价维护API，

从模块维度分为公布运价、私有单程运价、私有往返运价和低价看板4个模块，从功能维度分为新增、修改、删除、查询和调 价5个接口。

1.1 接入流程

生产环境已有手工投放政策权限的帐号可直接使用,无需额外申请。 测试环境需要通知对口业务联系携程供应商支持组申请帐号。

1.2 服务访问

• 支持http或https访问，其中https协议，访问前需要预装CA证书或在调用端的程序中设置信任任何证书，否则无法正常访问。
• 接口URL拼接规则：各环境服务URL+接口名

例：测试环境服务公布运价新增接口URL:https://intlresource-exchdata.fat.ctripqa.com/api/pubFareAdd 其中 https://intlresource-exchdata.fat.ctripqa.com/api/ 为对应环境服务URL, pubFareAdd为对应接口名

1.2.1 服务URL

• 测试环境: https://intlresource-exchdata.fat.ctripqa.com/api/
• 生产环境: https://intlresource-exchdata.ctrip.com/api/

1.2.2 公布运价接口名

1.2.3 私有单程运价接口名

1.2.4 私有往返运价接口名

1.2.5 低价看板查询接口名

1.3 约定

服务的调用方（供应商）和提供方（携程）在服务过程中，需要遵循如下约定：

• 请求、响应报文字符编码为UTF-8

• 请求、响应报文的序列化方式为Json+Gzip

• 调用方负责请求报文压缩和响应报文解压缩，并确保Http Request Header中包含如下信息

• Content-Type=application/json;charset=UTF-8

• Content-Transfer-Encoding=gzip

• Transfer-Encoding=chunked

• Accept-Encoding=gzip

• 提供方负责请求报文解压缩和响应报文压缩，并确保Http Response Header中包含如下信息

• Content-Type=application/json;charset=UTF-8

• Content-Encoding=gzip

• Transfer-Encoding=chunked

1.4 请求处理流程

!avatar

1. 客户端构建请求报文
2. gzip 压缩请求
3. 发送请求
4. 服务端接收请求并 gzip 解压缩请求
5. 处理请求构建响应报文
6. gzip 压缩响应
7. 返回至客户端
8. 客户端接收并解压缩响应

1.5 服务调用示例代码(Java)

示例使用Apache Http Client作为Http访问组件，需要引入相关lib。

1.5.1 Maven项目配置

<dependencies>
    <dependency>
        <groupId>org.apache.httpcomponents</groupId>
        <artifactId>httpclient</artifactId>
        <version>4.5.8</version>
    </dependency>
    <dependency>
        <groupId>org.slf4j</groupId>
        <artifactId>jcl-over-slf4j</artifactId>
    </dependency>
</dependencies>

1.5.2 新增公布运价请求示例报文

{
  "requestHeader": {
    "requestID": "c444550d-cd07-4dbb-b4fd-17f4c705ae8e",
    "loginName": "your login name",
    "password": "your password",
    "language": "zh_CN"
  },
  "records": [
    {
      "seq": 1,
      "tripType": "RT",
      "owner": "CA",
      "interlineApplicable": true,
      "salesDate": "2019-08-13>2025-06-01",
      "commition": "20.50",
      "profit": 20,
      "commissionCalculation": 1,
      "fareType": "Amadeus",
      "invoiceType": 0,
      "forSmallGroup": 2,
      "publicToPrivate": false,
      "forFilePrvOwFare": 2,
      "applicableFareSource": 2,
      "transferApplication": 2,
      "allowOpenJaw": 2,
      "cSApplicableNew": 2,
      "fareID": 1,
      "externalID": "d0a9e4d1-a75c-43fe-813e-b4b2b0c6f296",
      "policyID": "d0a9e4d1-a75c-43fe-813e-b4b2b0c6f296",
      "combinablePolicyID": "d0a9e4d1-a75c-43fe-813e-b4b2b0c6f296",
      "depCity": "BJS",
      "arrCity": "LAX",
      "depCityExcept": "",
      "arrCityExcept": "",
      "seatClass": "Y/S",
      "interlineAirlineCode": "CZ",
      "interlineAirlineCodeExcept": "MH/MU",
      "outboundTravelDate": "2019-08-13>2025-06-01",
      "fCInboundTravelDate": "2019-08-13>2025-06-01",
      "ticketingDeadline": "",
      "transferPoint": "SHA",
      "ticketingRemark": "",
      "workingTime": "",
      "nationality": "",
      "excludeNationality": "",
      "penalties": 0,
      "ticketingCity": "BJS",
      "saleMarket": "CN",
      "brandName": "SmartFare",
      "priceRange": "10-20/20-30",
      "excludeSaleMarket": "MK/HK",
      "fareBasis": "",
      "officeNo": "SHA888"
    },
    {
      "seq": 2,
      "tripType": "RT",
      "owner": "CA",
      "interlineApplicable": true,
      "salesDate": "2019-08-13>2025-06-01",
      "commition": "20.50",
      "profit": 20,
      "commissionCalculation": 1,
      "fareType": "Amadeus",
      "invoiceType": 0,
      "forSmallGroup": 2,
      "publicToPrivate": false,
      "forFilePrvOwFare": 2,
      "applicableFareSource": 2,
      "transferApplication": 2,
      "allowOpenJaw": 2,
      "cSApplicableNew": 2,
      "fareID": 2,
      "externalID": "5c2c235f-09c8-48db-bd45-042464a32fec",
      "policyID": "5c2c235f-09c8-48db-bd45-042464a32fec",
      "combinablePolicyID": "5c2c235f-09c8-48db-bd45-042464a32fec",
      "depCity": "BJS",
      "arrCity": "LAX",
      "depCityExcept": "",
      "arrCityExcept": "",
      "seatClass": "Y/S",
      "interlineAirlineCode": "CZ",
      "interlineAirlineCodeExcept": "MH/MU",
      "outboundTravelDate": "2019-08-13>2025-06-01",
      "fCInboundTravelDate": "2019-08-13>2025-06-01",
      "ticketingDeadline": "",
      "transferPoint": "SHA",
      "ticketingRemark": "",
      "workingTime": "",
      "nationality": "",
      "excludeNationality": "",
      "penalties": 0,
      "ticketingCity": "BJS",
      "saleMarket": "CN",
      "brandName": "SmartFare",
      "priceRange": "10-20/20-30",
      "excludeSaleMarket": "MK/HK",
      "fareBasis": "",
      "officeNo": "SHA888"
    }
  ]
}

1.5.3 接口调用实现

package com.ctrip.flight.intl.trade.openapi.example; import org.apache.commons.logging.Log; import org.apache.commons.logging.LogFactory; import org.apache.http.Header; import org.apache.http.HttpEntity; import org.apache.http.HttpStatus; import org.apache.http.ParseException; import org.apache.http.client.config.RequestConfig; import org.apache.http.client.entity.GzipCompressingEntity; import org.apache.http.client.methods.CloseableHttpResponse; import org.apache.http.client.methods.HttpPost; import org.apache.http.conn.ssl.NoopHostnameVerifier; import org.apache.http.conn.ssl.SSLConnectionSocketFactory; import org.apache.http.entity.StringEntity; import org.apache.http.impl.client.CloseableHttpClient; import org.apache.http.impl.client.HttpClientBuilder; import org.apache.http.impl.client.HttpClients; import org.apache.http.message.BasicHeader; import org.apache.http.ssl.SSLContextBuilder; import org.apache.http.util.EntityUtils; import javax.net.ssl.SSLContext; import java.io.IOException; import java.security.KeyManagementException; import java.security.KeyStoreException; import java.security.NoSuchAlgorithmException; import java.util.ArrayList; import java.util.List; public class OpenAPIExample {

private final Log log = LogFactory.getLog(getClass());

// Connection establishment timeout time 3 seconds unit milliseconds private static final int CONNECT_TIMEOUT = 3000;

// Socket timeout 25 seconds unit milliseconds private static final int SOCKET_TIMEOUT = 25000;

/*

- * CloseableHttpClient Thread safe
- * reference httpComponents-client-ga/tutorial 1.2.1. HttpClient thread safety
- * HttpClient implementations are expected to be thread safe. It is recommended that the same instance
- * of this class is reused for multiple request executions.
- */

private CloseableHttpClient httpClient; private CloseableHttpClient getHttpClient() throws KeyStoreException, NoSuchAlgorithmException,

KeyManagementException { if (null != httpClient) {

return httpClient;

} RequestConfig reqConfig = RequestConfig.custom()

.setConnectTimeout(CONNECT_TIMEOUT)

.setSocketTimeout(SOCKET_TIMEOUT) /*

- * ContentCompressionEnabled set true , http Request add header Accept-Encoding:gzip,deflate 
- */

.setContentCompressionEnabled(true).build(); SSLContext sslCtx = SSLContextBuilder.create().loadTrustMaterial(null, (x, s) -> {

return true; }).build(); SSLConnectionSocketFactory factory = new SSLConnectionSocketFactory(sslCtx, NoopHostnameVerifier.INSTANCE); List<Header> defaultHeaderList = new ArrayList<>(); // default request header defaultHeaderList.add(new BasicHeader("Content-Type", "application/json;charset=UTF-8"));

HttpClientBuilder builder = HttpClients.custom()

.setDefaultRequestConfig(reqConfig)

.setDefaultHeaders(defaultHeaderList)

.setSSLSocketFactory(factory); synchronized (OpenAPIExample.class) {

if (httpClient == null) {

httpClient = builder.build(); }

} return httpClient;

} public void publicFareAdd() throws Exception {

CloseableHttpClient httpClient = getHttpClient(); HttpPost httpPost = new HttpPost("Interface Url"); StringEntity requestEntity = new StringEntity("jsonData","UTF-8"); /*

- * using GzipCompressingEntity
- */

httpPost.setEntity(new GzipCompressingEntity(requestEntity)); try (CloseableHttpResponse response = httpClient.execute(httpPost)) {

HttpEntity responseEntity = response.getEntity(); int statusCode = response.getStatusLine().getStatusCode(); if (statusCode == HttpStatus.SC_OK) {

log.info("request success response content:" + EntityUtils.toString(responseEntity)); } else {

log.info("request fail response content:" + EntityUtils.toString(responseEntity)); }

} catch (ParseException | IOException e) {

log.error("request execute occur exception", e); } finally {

releaseClient(); }

} private void releaseClient() {

try {

httpClient.close(); } catch (Exception ignore) { }

} }

其它接口调用与示例类似，差异在于接口URL、请求报文，以及对响应报文的处理。

2 运价接口说明

公布运价、私有单程运价和私有往返运价3个模块各接口(新增/修改/删除/查询/调价)的处理逻辑和限制是一致，因此下文在介绍 时没有区分模块。部分接口的请求/响应报文模块间会有差异，下文会分别介绍。

低价看板查询可直接接生产环境，数据更准确

2.1 限制

• 同一账号每天新增运价数量上限为50W（可以找业务申请放大每天新增数据数量）

• 每次请求间隔不低于20秒，高于这个频率，携程OPS可能会认为是恶意攻击，封锁IP，导致API无法正常使用

• 新增/修改/删除/调价接口

• 请求报文中的Seq字段必填，起始值从1开始，不能重复

• 请求中运价数量上限为5W，超出上限时，接口调用会失败，给予错误提示

• 查询接口返回运价数量上限为1W,超出时将截取1W条返回

• 低价看板查询为单条可并发请求，每分钟限制210条

2.2 请求报文结构

分为请求头(RequestHeader)和请求体(RequestBody)两部分，请求头各接口相同，请求体各接口不同，具体见各接口说明。

2.2.1 报文格式

{
  "requestHeader": {
    "requestID": "b833fae2-8a52-4c35-9fb0-18f0c8c8e604",
    "loginName": "your login name",
    "password": "your password",
    "language": "zh_CN"
  },
  "requestBody": " ..."
}

2.2.2 请求头(RequestHeader)字段说明

2.3 响应报文结构

分为响应状态（ResponseStatus）、响应头(ResponseHeader)和响应体(ResponseBody)三部分，响应状态、响应头各接口相 同，响应体新增/修改/删除/调价是相同的具体见章节2.4，查询接口公布和私有有差异，具体见接口说明。

2.3.1 报文格式

{
  "ResponseStatus": {
    "Timestamp": "2019-08-28T18:01:38.617+08:00",
    "Ack": "Success",
    "Errors": []
  },
  "responseHeader": {
    "requestID": "b833fae2-8a52-4c35-9fb0-18f0c8c8e604",
    "transactionID": "52e7e967-c41a-4471-ac19-0276103fabb8",
    "replyStatus": "SUCCESS",
    "message": "Success"
  },
  "responseBody": " ..."
}

2.3.2 响应状态(ResponseStatus)字段说明

2.3.3 响应头(ResponseHeader)字段说明

2.3.4 新增/修改/删除/调价批量操作响应(BatchOperationResponse)

2.3.4.1 批量操作响应示例报文

{
  "ResponseStatus": " ",
  "responseHeader": " ",
  "totalCount": 4,
  "successCount": 1,
  "warnSuccessCount": 0,
  "failCount": 3,
  "successList": [
    {
      "externalID": "315010c9-b20d-46f0-a296-ab50ff6aa534",
      "fareID": 892777945,
      "seq": 1
    }
  ],
  "warnList": [],
  "failList": [
    {
      "messageRefNum": 1,
      "seq": 2
    },
    {
      "messageRefNum": 1,
      "seq": 3
    },
    {
      "messageRefNum": 2,
      "seq": 4
    }
  ],
  "messageList": [
    {
      "content": "OutboundReBookingFee:          ",
      "refNum": 1
    },
    {
      "content": "            58e798db-58df-442c-8e5a-a31e0513991b",
      "refNum": 2
    }
  ]
}

2.3.4.2 批量操作响应(BatchOperationResponse)字段说明

2.3.4.3 批量操作结果(ResultInfo)字段说明

2.3.4.4 消息对象(Message)字段说明

2.4 新增

2.4.1 公布运价

2.4.1.1 请求示例报文

{
  "requestHeader": {
    "requestID": "19f38700-d1fa-49d5-ade8-fdad9c05f1f1",
    "loginName": "your login name",
    "password": "your password"
  },
  "records": [
    {
      "seq": 1,
      "tripType": "RT",
      "owner": "CA",
      "interlineApplicable": true,
      "salesDate": "2019-08-13>2025-06-01",
      "commition": "20.50",
      "profit": 20,
      "commissionCalculation": 1,
      "fareType": "Amadeus",
      "invoiceType": 0,
      "forSmallGroup": 2,
      "publicToPrivate": false,
      "forFilePrvOwFare": 2,
      "applicableFareSource": 2,
      "transferApplication": 2,
      "allowOpenJaw": 2,
      "cSApplicableNew": 2,
      "fareID": null,
      "externalID": "742c125f-11f7-4b1c-b4d9-a8abd49dbd27",
      "policyID": "742c125f-11f7-4b1c-b4d9-a8abd49dbd27",
      "combinablePolicyID": "742c125f-11f7-4b1c-b4d9-a8abd49dbd27",
      "depCity": "BJS",
      "arrCity": "LAX",
      "depCityExcept": "",
      "arrCityExcept": "",
      "seatClass": "Y/S",
      "interlineAirlineCode": "CZ",
      "interlineAirlineCodeExcept": "MH/MU",
      "outboundTravelDate": "2019-08-13>2025-06-01",
      "fCInboundTravelDate": "2019-08-13>2025-06-01",
      "ticketingDeadline": "",
      "transferPoint": "SHA",
      "ticketingRemark": "",
      "workingTime": "",
      "nationality": "",
      "excludeNationality": "",
      "penalties": 0,
      "ticketingCity": "BJS",
      "isPenaltiesAdvantage": 0,
      "shareAirlineCode": "LH",
      "shareAirlineCodeExcept": "",
      "routingExcept": "SEL-TYO/CN-TYO",
      "saleMarket": "CN",
      "brandName": "SmartFare",
      "priceRange": "10-20/20-30",
      "excludeSaleMarket": "MK/HK",
      "fareBasis": "",
      "officeNo": "SHA888"
    },
    {
      "seq": 2,
      "tripType": "RT",
      "owner": "CA",
      "interlineApplicable": true,
      "salesDate": "2019-08-13>2025-06-01",
      "commition": "20.50",
      "profit": 20,
      "commissionCalculation": 1,
      "fareType": "Amadeus",
      "invoiceType": 0,
      "forSmallGroup": 2,
      "publicToPrivate": false,
      "forFilePrvOwFare": 2,
      "applicableFareSource": 2,
      "transferApplication": 2,
      "allowOpenJaw": 2,
      "cSApplicableNew": 2,
      "fareID": null,
      "externalID": "66bca9bb-1d23-4f54-893e-b739d55b9ec7",
      "policyID": "66bca9bb-1d23-4f54-893e-b739d55b9ec7",
      "combinablePolicyID": "66bca9bb-1d23-4f54-893e-b739d55b9ec7",
      "depCity": "BJS",
      "arrCity": "LAX",
      "depCityExcept": "",
      "arrCityExcept": "",
      "seatClass": "Y/S",
      "interlineAirlineCode": "CZ",
      "interlineAirlineCodeExcept": "MH/MU",
      "outboundTravelDate": "2019-08-13>2025-06-01",
      "fCInboundTravelDate": "2019-08-13>2025-06-01",
      "ticketingDeadline": "",
      "transferPoint": "SHA",
      "ticketingRemark": "",
      "workingTime": "",
      "nationality": "",
      "excludeNationality": "",
      "penalties": 0,
      "ticketingCity": "BJS",
      "shareAirlineCode": "LH",
      "shareAirlineCodeExcept": "",
      "routingExcept": "SEL-TYO/CN-TYO",
      "saleMarket": "CN",
      "brandName": "SmartFare",
      "priceRange": "10-20/20-30",
      "excludeSaleMarket": "MK/HK",
      "fareBasis": "",
      "officeNo": "SHA888"
    }
  ]
}

2.4.1.2 新增请求(PubFareAddRequest)字段说明

2.4.1.3 公布运价记录(PubFareRecord)字段说明

2.4.2 私有单程运价

2.4.2.1 请求示例报文

{
  "requestHeader": {
    "requestID": "705f42a1-84bd-4408-8c0f-55f2eabf56ab",
    "loginName": "your login name",
    "password": "your password"
  },
  "records": [
    {
      "seq": 1,
      "productType": 1,
      "owner": "CA",
      "airport": false,
      "departCity": "SHA",
      "arriveCity": "VII",
      "routing": "SHA-CA-VII",
      "routingClass": "Y",
      "allowStopoverOutbound": false,
      "outboundDayTime": "1234567",
      "outboundDayTimeIndicator": 0,
      "fCOutboundTravelDate": "2015-07-10>2020-10-31",
      "fCOutboundTravelDateIndicator": 1,
      "salesDate": "2015-07-10>2020-12-31",
      "eligibility": 0,
      "minPax": 1,
      "maxPax": 9,
      "fareType": "BSP",
      "ticketType": 1,
      "salesPrice": 2000,
      "currency": "CNY",
      "commition": "12.12",
      "profit": -21,
      "ticketingDeadline": "20-365,7,3/0-19,0,0",
      "needPnr": false,
      "invoiceType": 1,
      "outboundChangeable": true,
      "refundable": false,
      "noshowReValidation": false,
      "noshowRefund": true,
      "saleType": 0,
      "outboundBaggage": "20  ",
      "fareID": null,
      "externalID": "066cb028-ca84-4a91-800c-41eeef65fc26",
      "policyID": "",
      "fareBasis": "",
      "forbiddenFlight": "",
      "flight": "",
      "outboundTravelDateExcept": "",
      "chdDiscountRate": "",
      "infantRate": "",
      "nationality": "",
      "excludeNationality": "",
      "age": "",
      "outboundReBookingFee": "200",
      "outboundReBookingCurrency": "CNY",
      "cancellationFee": "",
      "cancellationCurrency": "",
      "revNoshowCondition": "",
      "revNoshowOutFee": "",
      "revNoshowOutCurrency": "",
      "refNoshowCondition": "0H",
      "refNoshowFee": "151",
      "refNoshowCurrency": "CNY",
      "yourOfficeNO": "",
      "ticketingRemark": "",
      "workingTime": "",
      "infOutboundBaggage": "",
      "notificationID": 0,
      "saleMarket": "DE/TW",
      "excludeSaleMarket": "",
      "brandName": "",
      "officeNo": "SHA888"
    },
    {
      "seq": 2,
      "productType": 1,
      "owner": "CA",
      "airport": false,
      "departCity": "SHA",
      "arriveCity": "VII",
      "routing": "SHA-CA-VII",
      "routingClass": "Y",
      "allowStopoverOutbound": false,
      "outboundDayTime": "1234567",
      "outboundDayTimeIndicator": 0,
      "fCOutboundTravelDate": "2015-07-10>2020-10-31",
      "fCOutboundTravelDateIndicator": 1,
      "salesDate": "2015-07-10>2020-12-31",
      "eligibility": 0,
      "minPax": 1,
      "maxPax": 9,
      "fareType": "BSP",
      "ticketType": 1,
      "salesPrice": 2000,
      "currency": "CNY",
      "commition": "12.12",
      "profit": -21,
      "ticketingDeadline": "20-365,7,3/0-19,0,0",
      "needPnr": false,
      "invoiceType": 1,
      "outboundChangeable": true,
      "refundable": false,
      "noshowReValidation": false,
      "noshowRefund": true,
      "saleType": 0,
      "outboundBaggage": "20  ",
      "fareID": null,
      "externalID": "266986e6-fb0b-40d8-bdd2-b267c2cea032",
      "policyID": "",
      "fareBasis": "",
      "forbiddenFlight": "",
      "flight": "",
      "outboundTravelDateExcept": "",
      "chdDiscountRate": "",
      "infantRate": "",
      "nationality": "",
      "excludeNationality": "",
      "age": "",
      "outboundReBookingFee": "200",
      "outboundReBookingCurrency": "CNY",
      "cancellationFee": "",
      "cancellationCurrency": "",
      "revNoshowCondition": "",
      "revNoshowOutFee": "",
      "revNoshowOutCurrency": "",
      "refNoshowCondition": "0H",
      "refNoshowFee": "151",
      "refNoshowCurrency": "CNY",
      "yourOfficeNO": "",
      "ticketingRemark": "",
      "workingTime": "",
      "infOutboundBaggage": "",
      "notificationID": 0,
      "saleMarket": "",
      "excludeSaleMarket": "DE/TW",
      "brandName": "",
      "officeNo": "SHA888"
    }
  ]
}

2.4.2.2 新增请求(PrvOwFareAddRequest)字段说明

2.4.2.3 私有单程运价记录(PrvOwFareRecord)字段说明

2.4.3 私有往返运价

2.4.3.1 请求示例报文

{
  "requestHeader": {
    "requestID": "9fa212d5-654d-4f67-8baa-c76e5e50f2c4",
    "loginName": "your login name",
    "password": "your password"
  },
  "records": [
    {
      "seq": 1,
      "productType": 1,
      "owner": "CA",
      "airport": false,
      "departCity": "SHA",
      "arriveCity": "VII",
      "routing": "SHA-CA-VII",
      "routingClass": "Y",
      "allowStopoverOutbound": false,
      "outboundDayTime": "1234567",
      "outboundDayTimeIndicator": 0,
      "fCOutboundTravelDate": "2015-07-10>2020-10-31",
      "fCOutboundTravelDateIndicator": 1,
      "salesDate": "2015-07-10>2020-12-31",
      "eligibility": 0,
      "minPax": 1,
      "maxPax": 9,
      "fareType": "BSP",
      "ticketType": 1,
      "salesPrice": 2000,
      "currency": "CNY",
      "commition": "12.12",
      "profit": -21,
      "ticketingDeadline": "20-365,7,3/0-19,0,0",
      "needPnr": false,
      "invoiceType": 1,
      "outboundChangeable": true,
      "refundable": false,
      "noshowReValidation": false,
      "noshowRefund": false,
      "saleType": 0,
      "outboundBaggage": "20  ",
      "fareID": null,
      "externalID": "bd29d0ef-4f81-4b5f-83e0-c343923889e8",
      "policyID": "",
      "fareBasis": "",
      "forbiddenFlight": "",
      "flight": "",
      "outboundTravelDateExcept": "",
      "chdDiscountRate": "",
      "infantRate": "",
      "nationality": "",
      "excludeNationality": "",
      "age": "",
      "outboundReBookingFee": "200",
      "outboundReBookingCurrency": "CNY",
      "cancellationFee": "",
      "cancellationCurrency": "",
      "revNoshowCondition": "",
      "revNoshowOutFee": "",
      "revNoshowOutCurrency": "",
      "refNoshowCondition": "0H",
      "refNoshowFee": "",
      "yourOfficeNO": "",
      "ticketingRemark": "",
      "workingTime": "",
      "infOutboundBaggage": "",
      "notificationID": 0,
      "allowCombination": false,
      "allowOpenJaw": false,
      "allowStopoverInbound": false,
      "minStay": "1D",
      "maxStay": "12M",
      "partlyUsedRefundable": false,
      "fCInboundTravelDate": "2015-07-10>2020-10-31",
      "fCInboundTravelDateIndicator": 0,
      "inboundDayTime": "1234567",
      "inboundDayTimeIndicator": 0,
      "inboundBaggage": "20  ",
      "inboundChangeable": false,
      "CommissionCalculation": 2,
      "other": false,
      "saleMarket": "DE/TW",
      "excludeSaleMarket": "",
      "brandName": "",
      "officeNo": "SHA888"
    },
    {
      "seq": 2,
      "productType": 1,
      "owner": "CA",
      "airport": false,
      "departCity": "SHA",
      "arriveCity": "VII",
      "routing": "SHA-CA-VII",
      "routingClass": "Y",
      "allowStopoverOutbound": false,
      "outboundDayTime": "1234567",
      "outboundDayTimeIndicator": 0,
      "fCOutboundTravelDate": "2015-07-10>2020-10-31",
      "fCOutboundTravelDateIndicator": 1,
      "salesDate": "2015-07-10>2020-12-31",
      "eligibility": 0,
      "minPax": 1,
      "maxPax": 9,
      "fareType": "BSP",
      "ticketType": 1,
      "salesPrice": 2000,
      "currency": "CNY",
      "commition": "12.12",
      "profit": -21,
      "ticketingDeadline": "20-365,7,3/0-19,0,0",
      "needPnr": false,
      "invoiceType": 1,
      "outboundChangeable": true,
      "refundable": false,
      "noshowReValidation": false,
      "noshowRefund": false,
      "saleType": 0,
      "outboundBaggage": "20  ",
      "fareID": 2,
      "externalID": "31f9baf4-78c0-4df2-b335-f8f427f7b951",
      "policyID": "",
      "fareBasis": "",
      "forbiddenFlight": "",
      "flight": "",
      "outboundTravelDateExcept": "",
      "chdDiscountRate": "",
      "infantRate": "",
      "nationality": "",
      "excludeNationality": "",
      "age": "",
      "outboundReBookingFee": "200",
      "outboundReBookingCurrency": "CNY",
      "cancellationFee": "",
      "cancellationCurrency": "",
      "revNoshowCondition": "",
      "revNoshowOutFee": "",
      "revNoshowOutCurrency": "",
      "refNoshowCondition": "0H",
      "refNoshowFee": "",
      "yourOfficeNO": "",
      "ticketingRemark": "",
      "workingTime": "",
      "infOutboundBaggage": "",
      "notificationID": 0,
      "allowCombination": false,
      "allowOpenJaw": false,
      "allowStopoverInbound": false,
      "minStay": "1D",
      "maxStay": "12M",
      "partlyUsedRefundable": false,
      "fCInboundTravelDate": "2015-07-10>2020-10-31",
      "fCInboundTravelDateIndicator": 0,
      "inboundDayTime": "1234567",
      "inboundDayTimeIndicator": 0,
      "inboundBaggage": "20  ",
      "inboundChangeable": false,
      "CommissionCalculation": 1,
      "other": false,
      "saleMarket": "",
      "excludeSaleMarket": "DE/TW",
      "brandName": "",
      "officeNo": "SHA888"
    }
  ]
}

2.4.3.2 新增请求(PrvRtFareAddRequest)字段说明

2.4.3.3 私有往返运价记录(PrvRtFareRecord)字段说明

私有往返运价包含2.4.2.3私有单程运价记录(PrvOwFareRecord)字段说明所有字段，下面表格仅描述在私有单程运价记录基础 上增加的字段：

2.4.4 响应结构

详见 2.3.4 新增/修改/删除/调价批量操作响应(BatchOperationResponse)

2.5 删除

公布运价、私有单程运价，私有往返运价处理逻辑相同：

• 删除接口按指定条件删除匹配运价记录，支持fareIDList/externalIDList/deleteFareConditionList/deleteAllType作为条件，

其中fareIDList/externalIDList/deleteFareConditionList为单选，同时指定多个条件时接口将调用失败，并给予错误提示， deleteAllType支持与另外3个条件的其中1个进行组合

• 当条件字段是fareIDList或externalIDList时，list长度上限为5W，超出将调用失败，给予错误提示
• 当条件字段是deleteFareConditionList时，owner与policyID为and关系，list长度上限为5，超出将调用失败，给予错误提示
• deleteAllType为true时表示删除手工录入，Excel导入以及API创建的数据，默认为false仅删除API创建的数据
• fareIDList/externalIDList/deleteFareConditionList三种条件至少指定一个

删除上限为1W条,超出限制时接口将调用失败，并给予错误提示

2.5.1 fareIDList作为删除条件报文示例

{
  "requestHeader": {
    "requestID": "19f38700-d1fa-49d5-ade8-fdad9c05f1f1",
    "loginName": "your login name",
    "password": "your password"
  },
  "fareIDList": [
    {
      "seq": 1,
      "fareID": 1588745
    },
    {
      "seq": 2,
      "fareID": 1590118
    }
  ],
  "externalIDList": [],
  "deleteFareConditionList": [],
  "deleteAllType": false
}

2.5.2 externalIDList作为删除条件报文示例

{
  "requestHeader": {
    "requestID": "8fe64a02-d8ec-4801-a3ce-1de7f2ec6589",
    "loginName": "your login name",
    "password": "your password"
  },
  "fareIDList": [],
  "externalIDList": [
    {
      "seq": 1,
      "externalID": "742c125f-11f7-4b1c-b4d9-a8abd49dbd27"
    },
    {
      "seq": 2,
      "externalID": "66bca9bb-1d23-4f54-893e-b739d55b9ec7"
    }
  ],
  "deleteFareConditionList": [],
  "deleteAllType": false
}

2.5.3 deleteFareConditionList作为删除条件报文示例

{
  "requestHeader": {
    "requestID": "6def0fdb-6403-4512-a3d1-951e2b26d33f",
    "loginName": "your login name",
    "password": "your password"
  },
  "fareIDList": [],
  "externalIDList": [],
  "deleteFareConditionList": [
    {
      "seq": 1,
      "owner": "CZ",
      "policyID": "f059f1b1-3f3c-40d6-bd1e-b49c8be2e1ba"
    },
    {
      "seq": 2,
      "owner": "CA",
      "policyID": "150e6381-25ce-4fa3-a7e9-42c1ee2e670a"
    }
  ],
  "deleteAllType": false
}

2.5.4 删除请求(DeleteRequest)字段说明

2.5.5 原始运价ID(FareID)字段说明

2.5.6 外部编号(ExternalID)字段说明

2.5.7 删除运价条件(DeleteFareCondition)字段说明

2.5.8 响应结构

详见 2.3.4 新增/修改/删除/调价批量操作响应(BatchOperationResponse)

2.6 修改

• fareID和externalID字段至少其中一个有值，否则将被忽略，给予错误提示
• fareID和externalID同时有值，优先用fareID，并更新externalID
• fareID和externalID验证合法性，有效的保留在更新列表中，无效的将被忽略，给予错误提示
• 当某个字段为null值时，默认是不对其进行处理（即不更新此值），对需要更新的字段，需要赋予合法有效的值，在验证通过后 才予以更新，否则会有不合法提示，对于要赋予空值(“”)的字段，string类型需要赋值为“NONE“,int类型需要赋值为214748364 7 如（depCityExcept=“NONE”，表明depCityExcept将被更新为““;penalties=2147483647,表明penalties将被更新为null）

修改接口的请求和响应与新增相同,详见 2.4 新增

2.7 查询

• fareIDList/externalIDList/queryCondition作为条件，其中fareIDList/externalIDList/queryCondition为单选，

同时指定多个条件时,按优先级高的条件将生效，低优先级的条件将被忽略，条件优先级 fareIDList > externalIDList > queryCondition

• fareIDList精确匹配
• externalIDList精确匹配
• queryCondition内字段为组合条件，多个字段为and关系
• queryCondition字段匹配性：(SeatClass、RoutingClass、DepCity、ArrCity为模糊匹配，其它条件为等值完全匹配)
• 当字段无值或为空时，将不作为条件字段
• IsActivated，如果没有传值，默认为true

2.7.1 fareIDList作为查询条件报文示例

{
  "requestHeader": {
    "requestID": "fe97c07c-74bb-4530-8707-587c4ae11080",
    "loginName": "your login name",
    "password": "your password"
  },
  "fareIDList": [
    1588745,
    1590118
  ],
  "externalIDList": [],
  "queryCondition": {},
  "encryptedFareIDList": []
}

2.7.2 externalIDList作为查询条件报文示例

{
  "requestHeader": {
    "requestID": "19d535c0-2bf2-4a5f-a4a8-f3a3d35cea66",
    "loginName": "your login name",
    "password": "your password"
  },
  "fareIDList": [],
  "externalIDList": [
    "742c125f-11f7-4b1c-b4d9-a8abd49dbd27",
    "66bca9bb-1d23-4f54-893e-b739d55b9ec7"
  ],
  "queryCondition": {},
  "encryptedFareIDList": []
}

2.7.3 公布运价queryCondition作为查询条件报文示例

{
  "requestHeader": {
    "requestID": "05e0e480-1cf2-4bf3-92b8-502a162d5136",
    "loginName": "your login name",
    "password": "your password"
  },
  "fareIDList": [],
  "externalIDList": [],
  "queryCondition": {
    "policyID": "742c125f-11f7-4b1c-b4d9-a8abd49dbd27",
    "tripType": "OW",
    "publicToPrivate": true,
    "fareStatus": 1,
    "owner": "CA",
    "depCity": "SHA",
    "arrCity": "LAX",
    "seatClass": "Y",
    "createUser": "your user name",
    "activated": true,
    "isPenaltiesAdvantage": 0
  }
}

2.7.4 私有运价queryCondition作为查询条件报文示例

{
  "requestHeader": {
    "requestID": "0ebf7573-6f97-4fbb-b1c7-25f7335ac436",
    "loginName": "your login name",
    "password": "your password"
  },
  "fareIDList": [],
  "externalIDList": [],
  "queryCondition": {
    "policyID": "742c125f-11f7-4b1c-b4d9-a8abd49dbd27",
    "depCity": "BJS",
    "arrCity": "LAX",
    "fareStatus": 1,
    "owner": "CZ",
    "routingClass": "Y",
    "productType": 1,
    "nfFareId": "123456",
    "createUser": "your user name",
    "activated": true
  }
}

2.7.5 未指定任何查询条件报文示例

{
  "requestHeader": {
    "requestID": "f9bde484-fcd4-4549-b708-32bdf42eded6",
    "loginName": "your login name",
    "password": "your password"
  },
  "fareIDList": [],
  "externalIDList": [],
  "queryCondition": {}
}

2.7.6 查询请求(QueryRequest)字段说明

2.7.7 公布运价查询条件(PubFareQueryCondition)字段说明

2.7.8 私有运价查询条件(PrvFareQueryCondition)字段说明

私有单程、往返运价查询条件相同

2.7.9 公布运价查询响应示例报文

{
  "ResponseStatus": {
    "Timestamp": 1567415921367,
    "Ack": "Success",
    "Errors": [],
    "Extension": []
  },
  "responseHeader": {
    "requestID": "da84b2dc-adf6-4c0f-a87f-7227380f3466",
    "transactionID": "daad6b19-41d1-4e86-8c85-e64bc976332f",
    "replyStatus": "SUCCESS",
    "message": "   1   "
  },
  "records": [
    {
      "fareID": 892777945,
      "externalID": "315010c9-b20d-46f0-a296-ab50ff6aa534",
      "tripType": "RT",
      "owner": "CA",
      "depCity": "BJS",
      "arrCity": "LAX",
      "commition": "20.50",
      "profit": 20,
      "transferApplication": 2,
      "transferPoint": "SHA",
      "interlineApplicable": true,
      "allowOpenJaw": 2,
      "publicToPrivate": false,
      "policyID": "315010c9-b20d-46f0-a296-ab50ff6aa526",
      "combinablePolicyID": "315010c9-b20d-46f0-a296-ab50ff6aa526",
      "penalties": 0,
      "activated": true,
      "createUser": "your user name@API",
      "createTime": "2019-09-02 10:49:04",
      "updateUser": "your user name@API",
      "updateLastTime": "2019-09-02 10:49:04",
      "ticketingRemark": "^       ;  24    ;"
    }
  ]
}

2.7.10 私有运价查询响应示例报文

{
  "ResponseStatus": {
    "Timestamp": 1567416547857,
    "Ack": "Success",
    "Errors": [],
    "Extension": []
  },
  "responseHeader": {
    "requestID": "01d7c1a3-02f9-40cb-b79c-f904e9f3a8e9",
    "transactionID": "d6a33053-ed14-4ba6-a98d-a23f485cfd56",
    "replyStatus": "SUCCESS",
    "message": "   1   "
  },
  "records": [
    {
      "fareID": 1475973164,
      "owner": "CA",
      "depCity": "SHA",
      "arrCity": "LAX",
      "routingClass": "Y",
      "fCOutboundTravelDate": "2015-07-10>2020-10-31",
      "salesPrice": 2000,
      "currency": "CNY",
      "commition": "12.12",
      "profit": -21,
      "externalID": "8012fc57-b7f7-4c80-80b6-ee6239ae4601",
      "activated": true,
      "createUser": "your user name@API",
      "createTime": "2019-09-02 17:27:59",
      "updateUser": "your user name@API",
      "updateLastTime": "2019-09-02 17:27:59",
      "ticketingRemark": "^       ;  24    ;"
    }
  ]
}

2.7.11 查询响应结构(QueryResponse)字段说明

2.7.12 公布运价查询记录结构(PubFareQueryRecord)字段说明

2.7.13 私有运价查询记录结构(PrvFareQueryRecord)字段说明

2.8 调价

公布运价、私有单程运价，私有往返运价处理逻辑相同：

• fareID和externalID字段至少其中一个有值，否则将被忽略，给予错误提示
• commition不为空且能够为正确转换为decimal数字类型时，profit不为空，调整运价的Commition 与 Profit,每条运价有不同的返点跟留钱，否则将忽略这条记录，

给予错误提示

• 调价逻辑为在原有返点，留钱的基础上进行相加或者相减，即原为a值，传递b值（正负都可）。调价后为：a = a+b

2.8.1 请求示例报文

{
  "requestHeader": {
    "requestID": "f923a50d-c247-422e-8572-eaf15ad1fb16",
    "loginName": "your login name",
    "password": "your password"
  },
  "records": [
    {
      "seq": 1,
      "fareID": 892777949,
      "externalID": "2b173bcd-be1f-45c8-8064-1bccaebfafe4",
      "commition": "1.5",
      "profit": 10
    },
    {
      "seq": 2,
      "fareID": 892777948,
      "externalID": "98ec26ad-b7bd-4bc8-9d9d-6508dee75a5e",
      "commition": "2.5",
      "profit": 20
    }
  ]
}

2.8.2 调价请求(ChangePriceRequest)字段说明

2.8.3 调价记录(ChangePriceRecord)字段说明

2.8.4 响应结构

详见 2.3.4 新增/修改/删除/调价批量操作响应(BatchOperationResponse)

2.9 低价看板查询

限制：

• 每分钟请求次数上限为210次,超出将给予错误提示2.0

2.9.1 请求示例报文

{
  "requestHeader": {
    "requestID": "c444550d-cd07-4dbb-b4fd-17f4c705ae8e",
    "loginName": "your user name",
    "password": "your password",
    "language": "zh_CN"
  },
  "queryCondition": {
    "tripType": "OW",
    "validatingCarrier": "WE",
    "seatGrade": "W",
    "segments": [
      {
        "segmentNo": 1,
        "departCity": "BKK",
        "arriveCity": "HKT",
        "departDate": "2023-01-13"
      }
    ],
    "travelerCount": 1,
    "childTravelerCount": 0,
    "channel": "FlightIntlOnline",
    "subChannel": 0,
    "scMarket": null,
    "specialParam": null,
    "agencyID": 3399,
    "babyTravelerCount": 0
  }
}

2.9.2 低价请求(LowPriceRequest)字段说明

2.9.3 低价查询条件(LowPriceQueryCondition)字段说明

2.9.4 用户行程段(Segment)字段说明

2.9.5 低价响应示例报文

{
  "ResponseStatus": {
    "Timestamp": "2022-12-26T18:03:46.085+08:00",
    "Ack": "Success",
    "Errors": [],
    "Build": null,
    "Version": null,
    "Extension": []
  },
  "responseHeader": {
    "requestID": "c444550d-cd07-4dbb-b4fd-17f4c705ae8e",
    "transactionID": "a5f24ff6-6cb8-463a-9ff3-b730770f1ae1",
    "replyStatus": "SUCCESS",
    "message": "   10   "
  },
  "responseBody": {
    "flights": [
      {
        "flightId": "13",
        "departCity": "BKK",
        "arriveCity": "HKT",
        "departAirport": "BKK",
        "arriveAirport": "HKT",
        "flightNo": "WE201",
        "takeOffDateTime": "2023-01-13 07:45:00",
        "arriveDateTime": "2023-01-13 09:10:00"
      },
      {
        "flightId": "14",
        "departCity": "BKK",
        "arriveCity": "HKT",
        "departAirport": "BKK",
        "arriveAirport": "HKT",
        "flightNo": "WE217",
        "takeOffDateTime": "2023-01-13 17:35:00",
        "arriveDateTime": "2023-01-13 19:05:00"
      },
      {
        "flightId": "4",
        "departCity": "BKK",
        "arriveCity": "HKT",
        "departAirport": "BKK",
        "arriveAirport": "HKT",
        "flightNo": "WE289",
        "takeOffDateTime": "2023-01-13 07:40:00",
        "arriveDateTime": "2023-01-13 09:10:00"
      },
      {
        "flightId": "15",
        "departCity": "BKK",
        "arriveCity": "HKT",
        "departAirport": "BKK",
        "arriveAirport": "HKT",
        "flightNo": "WE215",
        "takeOffDateTime": "2023-01-13 14:00:00",
        "arriveDateTime": "2023-01-13 15:25:00"
      },
      {
        "flightId": "7",
        "departCity": "BKK",
        "arriveCity": "HKT",
        "departAirport": "BKK",
        "arriveAirport": "HKT",
        "flightNo": "WE283",
        "takeOffDateTime": "2023-01-13 15:05:00",
        "arriveDateTime": "2023-01-13 16:35:00"
      },
      {
        "flightId": "19",
        "departCity": "BKK",
        "arriveCity": "HKT",
        "departAirport": "BKK",
        "arriveAirport": "HKT",
        "flightNo": "WE207",
        "takeOffDateTime": "2023-01-13 11:30:00",
        "arriveDateTime": "2023-01-13 13:00:00"
      },
      {
        "flightId": "8",
        "departCity": "BKK",
        "arriveCity": "HKT",
        "departAirport": "BKK",
        "arriveAirport": "HKT",
        "flightNo": "WE211",
        "takeOffDateTime": "2023-01-13 19:10:00",
        "arriveDateTime": "2023-01-13 20:35:00"
      },
      {
        "flightId": "9",
        "departCity": "BKK",
        "arriveCity": "HKT",
        "departAirport": "BKK",
        "arriveAirport": "HKT",
        "flightNo": "WE209",
        "takeOffDateTime": "2023-01-13 13:00:00",
        "arriveDateTime": "2023-01-13 14:30:00"
      },
      {
        "flightId": "20",
        "departCity": "BKK",
        "arriveCity": "HKT",
        "departAirport": "BKK",
        "arriveAirport": "HKT",
        "flightNo": "WE221",
        "takeOffDateTime": "2023-01-13 18:15:00",
        "arriveDateTime": "2023-01-13 19:45:00"
      },
      {
        "flightId": "10",
        "departCity": "BKK",
        "arriveCity": "HKT",
        "departAirport": "BKK",
        "arriveAirport": "HKT",
        "flightNo": "WE203",
        "takeOffDateTime": "2023-01-13 08:10:00",
        "arriveDateTime": "2023-01-13 09:35:00"
      }
    ],
    "lowPrices": [
      {
        "flightRefs": [
          {
            "segmentNo": 1,
            "sequenceNo": 1,
            "seatClass": "U",
            "flightId": "4",
            "flightNo": "WE289"
          }
        ],
        "prices": [
          {
            "gds": "GDS-WS",
            "productType": null,
            "productTypeName": "   ",
            "adtPolicyInfos": null,
            "chdPolicyInfos": null,
            "seatClass": "U",
            "travelerEligibility": "ADT",
            "baggage": "BKK-HKT:   :  30   ",
            "passengerRestriction": "",
            "invoiceType": "      ",
            "quantifyFlagRemark": "LOW_PRICE:N       |STANDARD_PRICE      |BAGGAGE:30    30     ",
            "quantifyFlag": "LOW_PRICE:N,STANDARD_PRICE,BAGGAGE:30",
            "sortIndicator": 869.0,
            "scPrice": null,
            "showState": 1,
            "isOwn": null,
            "infPolicyInfos": null,
            "adtTax": 50.0,
            "chdTax": 0.0,
            "infTax": 0.0,
            "adtPublishPrice": 869.0,
            "chdPublishPrice": 0.0,
            "infPublishPrice": 0.0,
            "currency": "CNY",
            "adtFareBasis": "NO",
            "chdFareBasis": "",
            "infFareBasis": "",
            "csdDataId": ""
          },
          {
            "gds": "GDS-WS",
            "productType": null,
            "productTypeName": "    ",
            "adtPolicyInfos": null,
            "chdPolicyInfos": null,
            "seatClass": "U",
            "travelerEligibility": "ADT",
            "baggage": "BKK-HKT:   :  30   ",
            "passengerRestriction": "",
            "invoiceType": "  ",
            "quantifyFlagRemark": "INVOICE     ",
            "quantifyFlag": "INVOICE",
            "sortIndicator": 908.0,
            "scPrice": null,
            "showState": 1,
            "isOwn": null
          }
        ]
      },
      {
        "flightRefs": [
          {
            "segmentNo": 1,
            "sequenceNo": 1,
            "seatClass": "U",
            "flightId": "13",
            "flightNo": "WE201"
          }
        ],
        "prices": [
          {
            "gds": "GDS-WS",
            "productType": null,
            "productTypeName": "   ",
            "adtPolicyInfos": null,
            "chdPolicyInfos": null,
            "seatClass": "U",
            "travelerEligibility": "ADT",
            "baggage": "BKK-HKT:   :  30   ",
            "passengerRestriction": "",
            "invoiceType": "      ",
            "quantifyFlagRemark": "LOW_PRICE:N       |STANDARD_PRICE      |BAGGAGE:30    30     ",
            "quantifyFlag": "LOW_PRICE:N,STANDARD_PRICE,BAGGAGE:30",
            "sortIndicator": 869.0,
            "scPrice": null,
            "showState": 1,
            "isOwn": null
          },
          {
            "gds": "GDS-WS",
            "productType": null,
            "productTypeName": "    ",
            "adtPolicyInfos": null,
            "chdPolicyInfos": null,
            "seatClass": "U",
            "travelerEligibility": "ADT",
            "baggage": "BKK-HKT:   :  30   ",
            "passengerRestriction": "",
            "invoiceType": "  ",
            "quantifyFlagRemark": "INVOICE     ",
            "quantifyFlag": "INVOICE",
            "sortIndicator": 908.0,
            "scPrice": null,
            "showState": 1,
            "isOwn": null
          }
        ]
      },
      {
        "flightRefs": [
          {
            "segmentNo": 1,
            "sequenceNo": 1,
            "seatClass": "U",
            "flightId": "10",
            "flightNo": "WE203"
          }
        ],
        "prices": [
          {
            "gds": "GDS-WS",
            "productType": null,
            "productTypeName": "   ",
            "adtPolicyInfos": null,
            "chdPolicyInfos": null,
            "seatClass": "U",
            "travelerEligibility": "ADT",
            "baggage": "BKK-HKT:   :  30   ",
            "passengerRestriction": "",
            "invoiceType": "      ",
            "quantifyFlagRemark": "LOW_PRICE:N       |STANDARD_PRICE      |BAGGAGE:30    30     ",
            "quantifyFlag": "LOW_PRICE:N,STANDARD_PRICE,BAGGAGE:30",
            "sortIndicator": 869.0,
            "scPrice": null,
            "showState": 1,
            "isOwn": null
          },
          {
            "gds": "GDS-WS",
            "productType": null,
            "productTypeName": "    ",
            "adtPolicyInfos": null,
            "chdPolicyInfos": null,
            "seatClass": "U",
            "travelerEligibility": "ADT",
            "baggage": "BKK-HKT:   :  30   ",
            "passengerRestriction": "",
            "invoiceType": "  ",
            "quantifyFlagRemark": "INVOICE     ",
            "quantifyFlag": "INVOICE",
            "sortIndicator": 908.0,
            "scPrice": null,
            "showState": 1,
            "isOwn": null
          }
        ]
      },
      {
        "flightRefs": [
          {
            "segmentNo": 1,
            "sequenceNo": 1,
            "seatClass": "U",
            "flightId": "19",
            "flightNo": "WE207"
          }
        ],
        "prices": [
          {
            "gds": "GDS-WS",
            "productType": null,
            "productTypeName": "   ",
            "adtPolicyInfos": null,
            "chdPolicyInfos": null,
            "seatClass": "U",
            "travelerEligibility": "ADT",
            "baggage": "BKK-HKT:   :  30   ",
            "passengerRestriction": "",
            "invoiceType": "      ",
            "quantifyFlagRemark": "LOW_PRICE:N       |STANDARD_PRICE      |BAGGAGE:30    30     ",
            "quantifyFlag": "LOW_PRICE:N,STANDARD_PRICE,BAGGAGE:30"
          }
        ]
      }
    ]
  }
}

2.9.6 低价查询响应结构(LowPriceResponse)字段说明

2.9.7 响应结果主体信息(LowPriceResponseBody)字段说明

2.9.8 航班基础信息(FlightDataType)字段说明

2.9.9 航组价格信息(LowPriceDataType)字段说明

2.9.10 航班引用信息(FlightRefDataType)字段说明

2.9.11 价格信息(PriceDataType)字段说明

2.9.12 政策信息(Policy)字段说明

2.9.13 品牌信息(BrandName)字段说明

2.10 运价池公布运价查询

2.10.1 请求示例报文

{
  "requestHeader": {
    "requestID": "c444550d-cd07-4dbb-b4fd-17f4c705ae8e",
    "loginName": "your login name",
    "password": "your password",
    "language": "zh_CN"
  },
  "conditions": [
    {
      "tripType": "RT",
      "validatingCarrier": "OZ",
      "departCity": "HKG",
      "arriveCity": "SFO",
      "outboundDate": "2023-03-20",
      "inboundDate": "2023-03-21",
      "brandName": "",
      "channel": "Mobile",
      "FareType": "Amadeus"
    }
  ]
}

2.10.2 请求(MegaFareSearchRequest)字段说明

2.10.3 查询条件(MegaFareSearchCondition)字段说明

2.10.4 响应示例报文

{
  "ResponseStatus": {
    "Timestamp": "2023-02-22T14:23:48.327+08:00",
    "Ack": "Success",
    "Errors": [],
    "Build": null,
    "Version": null,
    "Extension": []
  },
  "responseHeader": null,
  "records": [
    {
      "tripType": "RT",
      "validatingCarrier": "OZ",
      "fareType": "Amadeus",
      "departCity": "HKG",
      "arriveCity": "SFO",
      "outboundDate": "2023-03-20",
      "inboundDate": "2023-03-21",
      "channel": "Mobile",
      "brandName": "",
      "hasFare": false
    }
  ]
}

2.10.5 查询响应结果(MegaFareSearchResponse)字段说明

2.10.6 响应结果节点信息(MegaFareData)字段说明

3 CSD航线策略接口说明

提供CSD票台(非kwp)航线策略模块(新增/修改/删除/查询)接口。

3.1 限制

• 新增/修改/删除 每次请求间隔不低于20秒，高于这个频率，携程OPS可能会认为是恶意攻击，封锁IP，导致API无法正常使用
• 查询功能目前为分页查询，单页最大2000，每10s限制5次查询
• 新增接口支持批量，单次新增不超过500条
• 删除接口支持批量，单次删除不超过2000条

3.2 接口

3.2.1查询接口

3.2.1.1 查询请求示例报文

{
  "requestHeader": {
    "requestID": "19f38700-d1fa-49d5-ade8-fdad9c05f1f1",
    "loginName": "your login name",
    "password": "your password"
  },
  "queryCondition": {
    "tripType": "RT",
    "originType": 1,
    "origin": "SHA",
    "destinationType": 1,
    "destination": "LON"
  },
  "pageNo": 1,
  "sizePerPage": 50
}

3.2.1.2 查询请求(CsdAllocationStrategyQueryRequest)字段说明

3.2.1.3 Csd航线策略查询条件(CsdAllocationStrategyQueryCondition)字段说明

3.2.1.4 查询返回示例报文

{
  "ResponseStatus": {
    "Timestamp": "2025-11-11T14:07:25.174+08:00",
    "Ack": "Success",
    "Errors": [],
    "Build": null,
    "Version": null,
    "Extension": []
  },
  "responseHeader": {
    "requestID": "e8ba396f-bd27-40a7-86a6-b06aa014224",
    "transactionID": "af084672-f0b0-4238-b49d-12a7e5a23f33",
    "replyStatus": "SUCCESS",
    "message": "SUCCESS"
  },
  "csdAllocationStrategyList": [
    {
      "allocationID": 10001,
      "agentID": 1000,
      "tripType": "RT",
      "originType": 1,
      "origin": "BKK",
      "destinationType": 1,
      "destination": "KUL",
      "travelStartDate": "2025-11-10",
      "travelEndDate": "2025-12-10"
    },
    {
      "allocationID": 10002,
      "agentID": 1000,
      "tripType": "",
      "originType": 1,
      "origin": "BKK",
      "destinationType": 1,
      "destination": "KUL",
      "travelStartDate": null,
      "travelEndDate": null
    }
  ],
  "total": 4
}

3.2.1.5 查询返回(CsdAllocationStrategyQueryResponse)字段说明

3.2.1.6 Csd航线策略(CsdAllocationStrategy)字段说明

3.2.2 新增接口

3.2.2.1 新增请求示例报文

{
  "requestHeader": {
    "requestID": "19f38700-d1fa-49d5-ade8-fdad9c05f1f1",
    "loginName": "your login name",
    "password": "your password"
  },
  "csdAllocationStrategyList": [
    {
      "tripType": "OW",
      "originType": 1,
      "origin": "BKK",
      "destinationType": 1,
      "destination": "KUL",
      "travelStartDate": null,
      "travelEndDate": null
    },
    {
      "tripType": "RT",
      "originType": 1,
      "origin": "BKK",
      "destinationType": 1,
      "destination": "KUL",
      "travelStartDate": "2025-11-10",
      "travelEndDate": "2025-12-11"
    }
  ]
}

3.2.2.2 新增请求(CsdAllocationStrategyAddRequest)字段说明

3.2.2.3 新增返回示例报文

{
  "ResponseStatus": {
    "Timestamp": "2025-11-11T14:22:58.171+08:00",
    "Ack": "Success",
    "Errors": [],
    "Build": null,
    "Version": null,
    "Extension": []
  },
  "responseHeader": {
    "requestID": "e8ba396f-bd27-40a7-86a6-b06aa014224",
    "transactionID": "7c50ee5b-37b3-450c-b1df-ebce7b9e5e5c",
    "replyStatus": "SUCCESS",
    "message": "SUCCESS"
  }
}

3.2.2.4 新增返回(CsdAllocationStrategyAddResponse)字段说明

3.2.3 更新接口

3.2.3.1 更新请求示例报文

{
  "requestHeader": {
    "requestID": "19f38700-d1fa-49d5-ade8-fdad9c05f1f1",
    "loginName": "your login name",
    "password": "your password"
  },
  "csdAllocationStrategy": {
    "tripType": "OW",
    "originType": 1,
    "origin": "BKK",
    "destinationType": 1,
    "destination": "KUL",
    "travelStartDate": null,
    "travelEndDate": null
  }
}

3.2.3.2 更新请求(CsdAllocationStrategyUpdateRequest)字段说明

3.2.3.3 更新返回示例报文

{
  "ResponseStatus": {
    "Timestamp": "2025-11-11T14:22:58.171+08:00",
    "Ack": "Success",
    "Errors": [],
    "Build": null,
    "Version": null,
    "Extension": []
  },
  "responseHeader": {
    "requestID": "e8ba396f-bd27-40a7-86a6-b06aa014224",
    "transactionID": "7c50ee5b-37b3-450c-b1df-ebce7b9e5e5c",
    "replyStatus": "SUCCESS",
    "message": "SUCCESS"
  }
}

3.2.3.4 更新返回(CsdAllocationStrategyUpdateResponse)字段说明

3.2.4 删除接口

3.2.4.1 删除请求示例报文

{
  "requestHeader": {
    "requestID": "19f38700-d1fa-49d5-ade8-fdad9c05f1f1",
    "loginName": "your login name",
    "password": "your password"
  },
  "allocationIDList": [
    100000001,
    100000002,
    100000003
  ]
}

3.2.4.2 删除请求(CsdAllocationStrategyDeleteRequest)字段说明

3.2.4.3 删除返回示例报文

{
  "ResponseStatus": {
    "Timestamp": "2025-11-11T14:22:58.171+08:00",
    "Ack": "Success",
    "Errors": [],
    "Build": null,
    "Version": null,
    "Extension": []
  },
  "responseHeader": {
    "requestID": "e8ba396f-bd27-40a7-86a6-b06aa014224",
    "transactionID": "7c50ee5b-37b3-450c-b1df-ebce7b9e5e5c",
    "replyStatus": "SUCCESS",
    "message": "SUCCESS"
  }
}

3.2.4.4 删除返回(CsdAllocationStrategyDeleteResponse)字段说明