文档中心 > API类目 > 门票-商品管理API

alitrip.ticket.product.query (【门票API2.0】门票商品查询接口)

门票商品查询接口:返回商家上传的门票商品信息

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
out_product_id String 可选 4231 商户自定义收费项目编码。与ali_product_id,item_id 三者至少填写一个
ali_product_id Number 可选 1432 阿里标准收费项目id。与out_product_id,item_id 三者至少填写一个
item_id Number 可选 112455 商品ID。与out_product_id,ali_product_id三者至少填写一个

响应参数

名称 类型 示例值 描述
first_result TopTicketItemFullinfoResult 门票商品详情
  • └ ali_scenic_id
  • Number
  • 24498
  • 阿里旅行提供的景点编码
  • └ ali_scenic_ids
  • String
  • 24498,1224,4322
  • 联票的场景,则该收费项目可能关联多个景点,以英文逗号分隔
  • └ out_scenic_id
  • String
  • 1233
  • 商户系统中景点编码
  • └ ali_product_id
  • Number
  • 1234
  • 阿里旅行提供的收费项目编码
  • └ ali_product_name
  • String
  • 西湖船票
  • 阿里旅行收费项目名称
  • └ out_product_id
  • String
  • 3231
  • 商户自定义收费项目编码
  • └ out_product_name
  • String
  • 西湖船票1
  • 商户收费项目名称
  • └ inventory_type
  • Number
  • 1
  • 门票商品 库存类型。1、每日库存, 2、区间总库存
  • └ need_enter_date
  • Number
  • 1
  • 是否需要买家指定入园日期。1、需要,2-不需要
  • └ expire_date
  • String
  • 3
  • 门票有效期:指定入园日期后 多少天内有效。当为数字时,表示多少天内有效;当为日期时,表示到某日期有效,日期格式:yyyy-MM-dd
  • └ reserve_limit_type
  • Number
  • 1
  • 门票 预定时间限制。1、表示无限制 购买后可立即入园,2、有限制,此时预定时间限制规则必填。
  • └ reserve_limit_rule
  • String
  • 1_18_00_3
  • 门票 预定时间限制规则。格式:1_18_00_3,含义:必须提前1天拍下,且在18点00分前支付成功,订单才生效。当为提前0天时(即当日票),最后一个数字才有用,指当日票需要在预定3小时后入园。
  • code_sending_info
  • CodeSendingInfo
  • 门票商品发码方式
  • └ code_mode
  • Number
  • 1
  • 发码方式。1、电子票自动发码 需设置电子凭证信息,2、电子票手工发码,3、实体票
  • elec_info
  • ItemEleCertInfo
  • 电子凭证信息
  • └ expiry_date_type
  • Number
  • 1
  • 有效期 过期类型
  • └ expiry_date_start
  • Date
  • 2016-11-11
  • 电子凭证 有效期 开始时间
  • └ expiry_date_end
  • Date
  • 2016-12-11
  • 电子凭证 有效期 结束时间
  • └ expiry_days
  • Number
  • 4
  • 电子凭证 有效期 天数
  • └ package_id
  • Number
  • 21313
  • 核销门店库id
  • └ auto_refund_rate
  • Number
  • 50
  • 售中自动退款比例,0~100
  • └ expired_refund_rate
  • Number
  • 50
  • 过期自动退款比例,0~100
  • └ shop_tel
  • String
  • 13453576
  • 门票商品电子凭证信息必填,店铺联系方式
  • └ merchant_name
  • String
  • 核销服务提供商
  • 核销服务提供商
  • └ has_email
  • Boolean
  • true
  • 是否需要买家邮箱
  • └ item_id
  • Number
  • 123121
  • 商品ID
  • └ title
  • String
  • 商品标题
  • 商品标题
  • └ pic_urls
  • String []
  • ["http://xxx.com", "http://xxx.com"]
  • 商品主图
  • └ desc
  • String
  • 商品详情描述
  • 商品详情描述
  • └ wap_desc
  • String
  • 手机描述
  • 手机描述
  • └ item_status
  • Number
  • 1
  • 商品状态 0-下架,1-上架
  • ticket_types
  • TicketSimpleSkuParam []
  • 门票商品下 各个票种的sku信息
  • └ ticket_type
  • String
  • 成人票
  • 门票 票种类型
  • price_rules
  • PriceRule []
  • 该票种下使用的价格规则
  • └ out_rule_id
  • String
  • 1234
  • 商户票种规则id
  • └ out_sku_id
  • String
  • 2222
  • sku的商家编码(用于区分在 不同票种下使用同一outRuleId的情况)
  • date_inventorys
  • DateInventory []
  • 每日价格库存
  • └ date
  • Date
  • 2016-11-11
  • 日期
  • └ price
  • Number
  • 1234
  • 价格,精确到分
  • └ stock
  • Number
  • 12
  • 库存
  • └ out_sku_date_id
  • String
  • 3333
  • 日期级别自定义商家编码,为该sku下每一天都设置一个自定义商家编码。如果outSkuDateId为空,则该天的商家自定义编码将以outSkuId为准
  • └ ticket_season
  • String
  • 上午场
  • 门票场次(场次门票专用)
  • └ ticket_area
  • String
  • 贵宾席
  • 门票区域(场次门票专用)

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
AlitripTicketProductQueryRequest req = new AlitripTicketProductQueryRequest();
req.setOutProductId("4231");
req.setAliProductId(1432L);
req.setItemId(112455L);
AlitripTicketProductQueryResponse rsp = client.execute(req, sessionKey);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<alitrip_ticket_product_query_response>
    <first_result>
        <ali_scenic_id>24498</ali_scenic_id>
        <ali_scenic_ids>24498,1224,4322</ali_scenic_ids>
        <out_scenic_id>1233</out_scenic_id>
        <ali_product_id>1234</ali_product_id>
        <ali_product_name>西湖船票</ali_product_name>
        <out_product_id>3231</out_product_id>
        <out_product_name>西湖船票1</out_product_name>
        <inventory_type>1</inventory_type>
        <need_enter_date>1</need_enter_date>
        <expire_date>3</expire_date>
        <reserve_limit_type>1</reserve_limit_type>
        <reserve_limit_rule>1_18_00_3</reserve_limit_rule>
        <code_sending_info>
            <code_mode>1</code_mode>
            <elec_info>
                <expiry_date_type>1</expiry_date_type>
                <expiry_date_start>2016-11-11</expiry_date_start>
                <expiry_date_end>2016-12-11</expiry_date_end>
                <expiry_days>4</expiry_days>
                <package_id>21313</package_id>
                <auto_refund_rate>50</auto_refund_rate>
                <expired_refund_rate>50</expired_refund_rate>
                <shop_tel>13453576</shop_tel>
                <merchant_name>核销服务提供商</merchant_name>
            </elec_info>
            <has_email>true</has_email>
        </code_sending_info>
        <item_id>123121</item_id>
        <title>商品标题</title>
        <pic_urls>
            <string>[&quot;http://xxx.com&quot;</string>
            <string>&quot;http://xxx.com&quot;]</string>
        </pic_urls>
        <desc>商品详情描述</desc>
        <wap_desc>手机描述</wap_desc>
        <item_status>1</item_status>
        <ticket_types>
            <ticket_simple_sku_param>
                <ticket_type>成人票</ticket_type>
                <price_rules>
                    <price_rule>
                        <out_rule_id>1234</out_rule_id>
                        <out_sku_id>2222</out_sku_id>
                        <date_inventorys>
                            <date_inventory>
                                <date>2016-11-11</date>
                                <price>1234</price>
                                <stock>12</stock>
                                <out_sku_date_id>3333</out_sku_date_id>
                            </date_inventory>
                        </date_inventorys>
                    </price_rule>
                </price_rules>
                <ticket_season>上午场</ticket_season>
                <ticket_area>贵宾席</ticket_area>
            </ticket_simple_sku_param>
        </ticket_types>
    </first_result>
</alitrip_ticket_product_query_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>

错误码解释

错误码 错误描述 解决方案
isv.invalid-parameter:ERROR
isv.invalid-parameter:NOTNULL
isv.biz-error:ITEM_NOT_FOUNT

API工具

如何获得此API

拥有此API的权限组 可获得/可申请此API权限组的应用类型
门票-商品管理 飞猪-系统商  

FAQ

返回
顶部