文档中心 > API类目 > 国际机票-代理商

taobao.alitrip.totoro.auxproduct.push (廉航辅营产品投放)

廉航辅营产品投放接口

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
push_aux_products_rq PushAuxProductsRq 必须 廉航辅营产品推送请求
  • └ cid
  • String
  • 必须
  • ALITEST
  • 接口身份标识用户名(渠道唯一标识)
  • └ channel_id
  • Number
  • 必须
  • 1074
  • 渠道id
  • └ agent_id
  • Number
  • 必须
  • 8888
  • 代理商ID
  • product_items
  • AuxProductItemApiBean []
  • 必须
  • 廉航辅营产品
  • baggage
  • BaggageApiBean
  • 可选
  • 行李说明,当productType=4为必传
  • └ height
  • Number
  • 可选
  • 81
  • 默认值:0
  • 单件行李高度限制,单位厘米
  • └ weight
  • Number
  • 可选
  • 20
  • 行李重量,当allWeight为是的时候行李重量描述所有件数的总重量
  • └ width
  • Number
  • 可选
  • 119
  • 默认值:0
  • 单件行李宽度限制,单位厘米
  • └ pc
  • Number
  • 可选
  • 1
  • 行李总件数,大于等于1的正整数
  • └ length
  • Number
  • 可选
  • 119
  • 默认值:0
  • 单件行李长度限制,单位厘米
  • └ is_all_weight
  • Boolean
  • 可选
  • true
  • 是否所有行李重量
  • └ counter_price
  • Number
  • 可选
  • 12000
  • 柜台价,用于划价显示。 仅允许100的倍数。 币种:人民币。单位:分。
  • └ sale_type
  • Number
  • 必须
  • 1
  • 销售类型 1:一次销售,2:二次销售,3:不限 一次销售是指辅营产品和机票同时购买; 二次销售是指买完机票后,再单独购买辅营
  • service
  • ServiceApiBean
  • 可选
  • 辅营产品服务说明,仅当productType=1或productType=2为必传
  • └ service_time_type
  • Number
  • 可选
  • 2
  • 服务时间 1:不限制时间 2:按具体服务时间
  • └ service_content
  • String
  • 可选
  • 托运行李额按航司规定
  • 服务内容。 最多允许200个字符。 禁止空格等特殊符号。
  • └ room_tip
  • String
  • 可选
  • T1航站楼贵宾厅
  • 服务说明。 最多允许100个字符。 禁止空格等特殊符号。
  • └ room
  • String
  • 可选
  • T1
  • 服务地点。 最多允许100个字符。 禁止空格等特殊符号。
  • └ service_time_end
  • String
  • 可选
  • 0700
  • 服务时间结束 HHmm,serviceTimeType为2时必填
  • └ service_time_start
  • String
  • 可选
  • 2300
  • 服务时间开始 HHmm,serviceTimeType为2时必填
  • └ online_price
  • Number
  • 必须
  • 10000
  • 在线价,是对旅客展示的销售价格。 仅允许100的倍数。 币种:人民币。单位:分。
  • sales_rule
  • SalesRuleApiBean
  • 可选
  • 辅营产品销售规则
  • └ cabin
  • String
  • 可选
  • Y/W
  • 适用舱位(可以多个,支持子舱,用“/”隔开);
  • └ except_cabin_class
  • Number
  • 可选
  • 1
  • 例外舱位等级,单选 0:头等,1:商务,2:经济,3:全部 适用和例外二选一填写
  • └ latest_buy_time
  • Number
  • 必须
  • 4
  • 最晚购买时间,航班起飞前n小时 (计划起飞时间-当前时间)>=n小时
  • └ except_ods
  • String
  • 可选
  • PEKPVG/DMKYVR
  • 例外航线(可以多个,机场码) PEKPVG/DMKYVR ods和exceptOds二选一填写。 适用和例外二选一填写。 最多允许510个字符。
  • └ travel_date_start
  • String
  • 必须
  • 20170801
  • 旅行开始日期(yyyyMMdd)
  • └ travel_date_end
  • String
  • 必须
  • 20180801
  • 旅行结束日期(yyyyMMdd),最大值当前+365且不能小于开始
  • └ earlist_buy_time
  • Number
  • 必须
  • 9000
  • 最早购买时间,航班起飞前n小时 (计划起飞时间-当前时间)<=n小时 如无限制,请填写9000
  • └ cabin_class
  • Number
  • 可选
  • 2
  • 适用舱位等级,单选 0:头等,1:商务,2:经济,3:全部 适用和例外二选一填写
  • └ except_airports
  • String
  • 可选
  • PVG
  • 例外机场,如果为多个机场,按照PEK/NAY 格式返回 airports和exceptAirports二选一填写。 最多允许511个字符。
  • └ sale_date_end
  • String
  • 必须
  • 20180801
  • 销售结束日期(yyyyMMdd),最大值当前+365且不能小于开始
  • └ receipt_type
  • Number
  • 必须
  • 1
  • 发票类型 1:电子,2:纸质,3:不提供
  • └ stock_num
  • Number
  • 可选
  • 100
  • 库存数,当stockType=1或stockType=2时必填
  • └ except_flight_nos
  • String
  • 可选
  • FD1234
  • 例外航班(可以多个,用“/”隔开); 适用和例外二选一填写。 最多允许512个字符。
  • └ ods
  • String
  • 可选
  • PEKPVG/DMKYVR
  • 适用航线(可以多个,机场码) PEKPVG/DMKYVR ods和exceptOds二选一填写。 适用和例外二选一填写。 最多允许510个字符。
  • └ airline_codes
  • String
  • 必须
  • AK
  • 适用航司二字码
  • └ except_cabin
  • String
  • 可选
  • Y
  • 例外舱位(可以多个,支持子舱,用“/”隔开);
  • └ stock_type
  • Number
  • 必须
  • 2
  • 库存类型 1:共享总库存数,2:每日库存数(旅行日期下每天),3:不限制(不使用产品库库存)
  • └ airports
  • String
  • 可选
  • PEK/NAY
  • 适用机场,如果为多个机场,按照PEK/NAY 格式返回 airports和exceptAirports二选一填写。 最多允许511个字符。
  • └ receipt_way
  • Number
  • 必须
  • 1
  • 发票领取规则 1:行程单,2:机场柜台 默认为1.当receiptType=1或receiptType=2时,receiptWay必须指定
  • └ sale_date_start
  • String
  • 必须
  • 20170801
  • 销售开始日期(yyyyMMdd)
  • └ except_airline_codes
  • String
  • 可选
  • FD
  • 例外航司二字码,如果为多个航司,按照 AK/FD格式返回。 最多允许254个字符。
  • └ code_share_forbidden
  • Boolean
  • 必须
  • true
  • 共享航班是否可用 1:不能用于共享航班,2:可用
  • └ flight_nos
  • String
  • 可选
  • FD1234
  • 适用航班(可以多个,用“/”隔开); 适用和例外二选一填写。 最多允许512个字符。
  • └ outbound_terminal
  • String
  • 可选
  • T1/T2/T3
  • 适用出发航站楼(可以多个,用“/”隔开)。 最多允许10个字符。
  • └ stock_rule
  • String
  • 可选
  • 20170910-20171010:10/20171012-20180910:10
  • 库存规则,当stockType=1或stockType=2时必填。
  • refund_rule
  • AuxRefundApiBean
  • 必须
  • 辅营产品退改规则
  • └ can_refund_independent
  • Boolean
  • 必须
  • false
  • 是否可单独退 true可以,false不可以 当canRefund =true时此节点必传
  • └ modify_rule
  • String
  • 必须
  • 不可改签
  • 改规则。 最多允许200个字符。 禁止空格等特殊符号。
  • └ can_modify
  • Boolean
  • 必须
  • false
  • 是否可改 true可以,false不可以 当refundRule=true时此节点必传
  • └ can_modify_independent
  • Boolean
  • 必须
  • false
  • 是否可单独改 true可以,false不可以
  • └ can_refund
  • Boolean
  • 必须
  • false
  • 是否可退 true 可以,false不可以
  • └ refund_rule
  • String
  • 必须
  • 不可退
  • 退规则。 最多允许200个字符。 禁止空格等特殊符号。
  • └ product_name
  • String
  • 必须
  • 25KG
  • 产品名称。 最大允许64个字符,不允许*·#|等特殊符号,也不允许带空格换行等符号
  • └ base_price
  • Number
  • 可选
  • 8000
  • 成本价。仅允许100的倍数。 币种:人民币。单位:分。
  • └ product_type
  • Number
  • 必须
  • 4
  • 产品类型 1:贵宾厅,2:CIP,3:在线选座,4:付费行李,6:值机,7:餐食, 8:值机及选座 当前仅允许投放:4,6,7,8
  • └ outer_id
  • String
  • 必须
  • TGPEKBKK2017M6M70001
  • 外部ID,此辅营报价的唯一标识,后续用于校验生单;只允许数字字母组合,最大允许32个字符。 不允许包含空格、换行、|这类特殊符号
  • seat
  • SeatApiBean
  • 可选
  • 选座说明,当productType=3或8 为必传
  • └ seat_area
  • Number
  • 可选
  • 1
  • 座位列 1:靠过道,2:靠窗,3:并排
  • └ seat_row
  • Number
  • 可选
  • 1
  • 排次 1:前排,2:中排,3:后排

响应参数

名称 类型 示例值 描述
tracer_id String 1235 操作日志id,商家可通过该id在后台查看本次操作的具体结果
message String Success 备注
is_success Boolean True 是否操作成功

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
AlitripTotoroAuxproductPushRequest req = new AlitripTotoroAuxproductPushRequest();
PushAuxProductsRq obj1 = new PushAuxProductsRq();
obj1.setCid("ALITEST");
obj1.setChannelId(1074L);
obj1.setAgentId(8888L);
List<AuxProductItemApiBean> list3 = new ArrayList<AuxProductItemApiBean>();
AuxProductItemApiBean obj4 = new AuxProductItemApiBean();
list3.add(obj4);
BaggageApiBean obj6 = new BaggageApiBean();
obj6.setHeight(81L);
obj6.setWeight(20L);
obj6.setWidth(119L);
obj6.setPc(1L);
obj6.setLength(119L);
obj6.setIsAllWeight(true);
list5.setBaggage(obj6);
obj4.setCounterPrice(12000L);
obj4.setSaleType(1L);
ServiceApiBean obj8 = new ServiceApiBean();
obj8.setServiceTimeType(2L);
obj8.setServiceContent("托运行李额按航司规定");
obj8.setRoomTip("T1航站楼贵宾厅");
obj8.setRoom("T1");
obj8.setServiceTimeEnd("0700");
obj8.setServiceTimeStart("2300");
list7.setService(obj8);
obj4.setOnlinePrice(10000L);
SalesRuleApiBean obj10 = new SalesRuleApiBean();
obj10.setCabin("Y/W");
obj10.setExceptCabinClass(1L);
obj10.setLatestBuyTime(4L);
obj10.setExceptOds("PEKPVG/DMKYVR");
obj10.setTravelDateStart("20170801");
obj10.setTravelDateEnd("20180801");
obj10.setEarlistBuyTime(9000L);
obj10.setCabinClass(2L);
obj10.setExceptAirports("PVG");
obj10.setSaleDateEnd("20180801");
obj10.setReceiptType(1L);
obj10.setStockNum(100L);
obj10.setExceptFlightNos("FD1234");
obj10.setOds("PEKPVG/DMKYVR");
obj10.setAirlineCodes("AK");
obj10.setExceptCabin("Y");
obj10.setStockType(2L);
obj10.setAirports("PEK/NAY");
obj10.setReceiptWay(1L);
obj10.setSaleDateStart("20170801");
obj10.setExceptAirlineCodes("FD");
obj10.setCodeShareForbidden(true);
obj10.setFlightNos("FD1234");
obj10.setOutboundTerminal("T1/T2/T3");
obj10.setStockRule("20170910-20171010:10/20171012-20180910:10");
list9.setSalesRule(obj10);
AuxRefundApiBean obj12 = new AuxRefundApiBean();
obj12.setCanRefundIndependent(false);
obj12.setModifyRule("不可改签");
obj12.setCanModify(false);
obj12.setCanModifyIndependent(false);
obj12.setCanRefund(false);
obj12.setRefundRule("不可退");
list11.setRefundRule(obj12);
obj4.setProductName("25KG");
obj4.setBasePrice(8000L);
obj4.setProductType(4L);
obj4.setOuterId("TGPEKBKK2017M6M70001");
SeatApiBean obj14 = new SeatApiBean();
obj14.setSeatArea(1L);
obj14.setSeatRow(1L);
list13.setSeat(obj14);
obj1.setProductItems(list3);
req.setPushAuxProductsRq(obj1);
AlitripTotoroAuxproductPushResponse rsp = client.execute(req, sessionKey);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<alitrip_totoro_auxproduct_push_response>
    <tracer_id>1235</tracer_id>
    <message>Success</message>
    <is_success>True</is_success>
</alitrip_totoro_auxproduct_push_response>

异常示例

  • XML示例
  • JSON示例
<error_response>
    <code>50</code>
    <msg>Remote service error</msg>
    <sub_code>isv.invalid-parameter</sub_code>
    <sub_msg>非法参数</sub_msg>
</error_response>

错误码解释

错误码 错误描述 解决方案

API工具

如何获得此API

FAQ

返回
顶部