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

alitrip.ticket.product.upload (【门票API2.0】门票收费项目管理接口)

航旅度假新版门票商品(门票收费项目)管理接口:支持门票商品的发布、编辑。如果在ali_product_id下没有发布过门票商品,则系统将判断为新发布商品,否则是编辑已有商品。可以通过辅助查询接口判断是否已在某个ali_product_id下发布过门票商品。 对应新发布商品的情况,有些参数是必填的,请仔细查看各字段说明。对于编辑商品的情况,ali_product_id和out_product_id至少需要填一个,其他参数都是可选,编辑情况支持增量更新(某个参数不传则使用该商品上原有值)。

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
ali_product_id Number 可选 22 新发布门票商品时必填。阿里旅行提供的收费项目编码,与商户收费项目编码进行绑定。注:一个收费项目编码对应了一个淘宝商品
out_product_id String 可选 1111 可选,商户自定义收费项目编码。注:如果商户上传了自定义收费项目编码,则在价格库存同步接口可以使用该自定义编码更新价格库存。
update_out_product_id String 可选 2222 可选,商家想要更新映射关系的时候,用于更新商户自定义收费项目编码。
out_product_name String 可选 商户收费项目名称 商户收费项目名称
inventory_type Number 可选 1 新发布门票商品时必填。门票商品 库存类型。1、日历库存, 2、非日历库存
need_enter_date Number 可选 1 inventory_type=2时选填,指定该收费项目在购买时是否需要买家指定入园日期。1、需要,2-不需要
expire_date String 可选 3 新发布门票商品时必填。门票有效期:指定入园日期后 多少天内有效。当为数字时,表示多少天内有效;当为日期时,表示到某日期有效,日期格式:yyyy-MM-dd。发布时不填则默认设置30天内有效
reserve_limit_type Number 可选 1 新发布门票商品时必填。门票 预定时间限制。1、表示无限制 购买后可立即入园,2、有限制,此时预定时间限制规则必填。
reserve_limit_rule String 可选 1_18_00_3_30 特殊选填,门票 预定时间限制规则。格式:1_18_00_3 或者 1_18_00_3_30,含义:必须提前1天拍下,且在18点00分前支付成功,订单才生效。当为提前0天时(即当日票),最后两个数字才生效,指当日票需要在出票后3小时30分钟后方可入园。
code_sending_info CodeSendingInfo 可选 新发布门票商品时必填。门票商品发码方式
  • └ code_mode
  • Number
  • 可选
  • 1
  • 发码方式。1、电子票自动发码 需设置电子凭证信息,2、电子票手工发码,3、实体票
  • elec_info
  • ItemEleCertInfo
  • 可选
  • 电子凭证信息,code_mode=1时必填。
  • └ expiry_date_type
  • Number
  • 可选
  • 1
  • 必填,电子凭证有效期 过期类型。1:xxxx-xx-xx 到 xxxx-xx-xx; 2:购买成功日 至 xxxx-xx-xx; 3:购买成功 xx 天内有效
  • └ expiry_date_start
  • Date
  • 可选
  • 2016-05-25 00:00:00
  • 特殊必填(expiryDateType为1时必填),电子凭证 有效期 开始时间
  • └ expiry_date_end
  • Date
  • 可选
  • 2016-08-25 00:00:00
  • 特殊必填(expiryDateType为1或2时必填),电子凭证 有效期 结束时间
  • └ expiry_days
  • Number
  • 可选
  • 5
  • 特殊必填(expiryDateType为3时必填),电子凭证 有效期 天数
  • └ package_id
  • Number
  • 可选
  • 20182296
  • 必填,核销门店库id
  • └ auto_refund_rate
  • Number
  • 可选
  • 100
  • 默认值:0
  • 可选,售中自动退款比例,0~100。默认为0,即不支持售中自动退款;当值为1~100时表示售中自动退款的比例
  • └ expired_refund_rate
  • Number
  • 可选
  • 100
  • 默认值:0
  • 可选,过期自动退款比例,0~100。默认为0,即不支持过期自动退款比例;当值为1~100时表示过期自动退款的比例
  • └ shop_tel
  • String
  • 可选
  • 123456
  • 必填,店铺联系方式
  • └ merchant_name
  • String
  • 可选
  • 核销服务提供商
  • 必填,核销服务提供商
  • └ has_email
  • Boolean
  • 可选
  • true
  • 手工发码 是否需要买家邮箱,code_mode=2时选填,不填则默认不需要邮箱信息。
title String 可选 商品标题 可选,商品标题
pic_urls String [] 可选 商品主图
  • 最大列表长度:5
  • 可选,商品主图,最多支持5张。图片链接支持外链图片(即商家系统中图片链接,必须外网可访问,且格式为png、jpg或jpeg,大小在500k以内),或者用户淘宝空间内的图片链接。对于外链图片,将自动下载并上传用户淘宝图片空间,上传失败的外链图片将自动忽略不计。
    desc String 可选 商品详情描述 可选,商品详情描述,不超过50000个字符。详情描述支持纯文本描述,也支持html格式的详情描述。html格式的详情描述中 图片链接支持外链图片(必须外网可访问, 且格式为png、jpg或jpeg,大小在500k以内)和淘宝图片空间链接。

    响应参数

    名称 类型 示例值 描述
    first_result TicketItemResult 门票商品发布、编辑结果
    • └ modifyed_time
    • Date
    • 2016-10-10 00:00:00
    • 修改时间
    • └ item_id
    • Number
    • 12335
    • 商品id
    • └ ali_scenic_id
    • Number
    • 123
    • 标准景点id
    • └ out_scenic_id
    • String
    • 111
    • 商户景点id
    • └ ali_product_id
    • Number
    • 123
    • 标准收费项目id
    • └ out_product_id
    • String
    • 2222
    • 商户收费项目id
    • └ extend
    • String
    • 预留
    • 预留,扩展字段

    请求示例

    • JAVA
    • .NET
    • PHP
    • CURL
    • Python
    • C/C++
    • NodeJS
    TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
    AlitripTicketProductUploadRequest req = new AlitripTicketProductUploadRequest();
    req.setAliProductId(22L);
    req.setOutProductId("1111");
    req.setUpdateOutProductId("2222");
    req.setOutProductName("商户收费项目名称");
    req.setInventoryType(1L);
    req.setNeedEnterDate(1L);
    req.setExpireDate("3");
    req.setReserveLimitType(1L);
    req.setReserveLimitRule("1_18_00_3_30");
    CodeSendingInfo obj1 = new CodeSendingInfo();
    obj1.setCodeMode(1L);
    ItemEleCertInfo obj2 = new ItemEleCertInfo();
    obj2.setExpiryDateType(1L);
    obj2.setExpiryDateStart(StringUtils.parseDateTime("2016-05-25 00:00:00"));
    obj2.setExpiryDateEnd(StringUtils.parseDateTime("2016-08-25 00:00:00"));
    obj2.setExpiryDays(5L);
    obj2.setPackageId(20182296L);
    obj2.setAutoRefundRate(100L);
    obj2.setExpiredRefundRate(100L);
    obj2.setShopTel("123456");
    obj2.setMerchantName("核销服务提供商");
    obj1.setElecInfo(obj2);
    obj1.setHasEmail(true);
    req.setCodeSendingInfo(obj1);
    req.setTitle("商品标题");
    req.setPicUrls("商品主图");
    req.setDesc("商品详情描述");
    AlitripTicketProductUploadResponse rsp = client.execute(req, sessionKey);
    System.out.println(rsp.getBody());

    响应示例

    • XML示例
    • JSON示例
    <alitrip_ticket_product_upload_response>
        <first_result>
            <modifyed_time>2016-10-10 00:00:00</modifyed_time>
            <item_id>12335</item_id>
            <ali_scenic_id>123</ali_scenic_id>
            <out_scenic_id>111</out_scenic_id>
            <ali_product_id>123</ali_product_id>
            <out_product_id>2222</out_product_id>
            <extend>预留</extend>
        </first_result>
    </alitrip_ticket_product_upload_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.biz-error:UNSUPPORT_UPDATE_ALI_PRODUCT_ID 不支持更新标准景点ID 不支持更新标准景点ID
    isv.biz-eror:INVENTORY_NOT_BETWEEN_DATE_RANGE 库存日期不在sku的起始日期范围之内 请修改库存日期
    isv.invalid-parameter:PARAM_ERROR 参数异常,一般是收费项目无效 请根据提示修改修改
    isv.invalid-parameter:NOTNULL 必填字段为空,一般为收费项目,库存,图文详情等 请根据提示完善为空字段
    isv.biz-error:SCENIC_NOT_FOUND 景点不存在 不要在此景点下发布商品,如果找不到对应的景点,请联系运营处理
    isv.IPM_OPERATION_SUCCESS 部分操作成功,部分失败 一般重试可以解决
    isv.invalid-parameter:FORMAT_ERROR 格式错误 根据提示修改格式
    isv.PARAM_EXCEPTION::PIC_URL_ERROR 图片链接异常 https://sell.fliggy.com/icenter/errorcode/ErrorCodeSolution.htm?code=PARAM_EXCEPTION::PIC_URL_ERROR&owner=1
    isv.IC_CATEGORY_NOT_GRANT_FOR_B 未授权发布此类目的商品 未授权发布此类目的商品
    isv.invalid-parameter:ERROR 参数错误 根据错误提示修改
    isv.TRAVEL_TITLE_LENGTH_OVERRANGE 长度超过限制 根据错误提示修改
    isv.IC_PERMISSION_FOR_CESHI_AUCTIONS_ITEM_TITLE_LIMIT_RULE 测试账号发布商品不符合规范 根据错误提示修改
    isv.IC_SAVE_INVENTORY_TO_IP_FAILED 保存商品库存失败 请根据错误提示修改
    isv.old_sq_not_match 数据已经发生变化 请根据错误提示修改
    isv.invalid-parameter:WORD_OVERRANGE 字段长度超过限制 根据错误提示修改
    isv.invalid-parameter:charge_item 收费项目问题 请根据错误提示修改
    isv.invalid-parameter:NOTNULL:ticket_inventory 库存不能为0 请根据错误提示修改
    isv.invalid-parameter:PARAM_ERROR:charge_item 收费项目为空 请根据错误提示修改
    isv.remote-service-error 远程服务失败 请根据错误提示修改
    isp.SYS_EXCEPTION 系统异常 系统异常
    isv.CALINPRI_EMPTY 日历为空 请检查商品下是否有可售卖的日期
    isv.IC_CHECKSTEP_SKU_PROP_NOT_FOUND_IN_ITEM 属性不存在 请根据错误提示修改
    isv.IP_TRADE_INVENTORY_MODIFY_ERROR 库存中心保存库存失败 根据错误提示修改

    API工具

    如何获得此API

    FAQ

    返回
    顶部