taobao.lifeservice.item.modify (生服商品修改)

目前提供体检预约服务商修改商品

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
item_modify_request OpenItemModifyRequest 必须 修改请求
  • └ sales_period_end
  • String
  • 可选
  • 2021-01-20 19:56:47
  • 售卖开始时间
  • └ ticket_display_mode
  • String
  • 可选
  • NO_DISPLAY_CODE
  • 核销方式,也即凭证使用展示方式:付款码USER_PAY_CODE,券码TICKET_CODE,无码核销NO_DISPLAY_CODE
  • service_package_dto
  • ServicePackageDto
  • 可选
  • 详情结构
  • └ price
  • Number
  • 必须
  • 100
  • 价格等于商品原价,目前无地方消费
  • package_content_list
  • PackageContentDTO []
  • 可选
  • 详情描述内容组
  • content_group_list
  • ContentGroupDto []
  • 可选
  • 内容组
  • └ unit
  • String
  • 可选
  • 单位
  • └ price
  • Number
  • 可选
  • 20000
  • 价值。单位分
  • └ content
  • String
  • 可选
  • 咽拭子
  • 内容
  • └ num
  • String
  • 可选
  • 1
  • 数量
  • └ title
  • String
  • 可选
  • 修改内容组标题1
  • 内容组标题
  • └ has_service_unit
  • Boolean
  • 可选
  • false
  • 目前top接口只支持false
  • └ explanation
  • String
  • 可选
  • 修改补充说明xx信息
  • 补充说明
  • └ service_package_name
  • String
  • 可选
  • 修改,一般和标题名一样,可改
  • 一般和标题名一样,可改
  • └ service_category_id
  • String
  • 可选
  • 1020191219001000000
  • 需要分配
  • service_flow_list
  • ServiceFlowDTO []
  • 可选
  • 服务流程
  • └ explanation
  • String
  • 可选
  • 补充说明
  • 补充说明
  • └ unit
  • String
  • 可选
  • 单位
  • └ num
  • String
  • 可选
  • 2
  • 数量
  • └ service_content
  • String
  • 可选
  • 服务内容描述xxx
  • 服务内容
  • └ step
  • String
  • 可选
  • 1
  • 流程步骤
  • graphic_text_list
  • GraphicTextDTO []
  • 可选
  • 图文详情
  • └ type
  • String
  • 可选
  • IMAGE
  • 类型:IMAGE-图片;TEXT-文字描述
  • └ django_id
  • String
  • 可选
  • LpbRZPO0QZeh9pneiUhgNwAAACMAAQED
  • 专用字段,口碑侧的图片ID, 只会在 type=IMAGE 时存在
  • └ content
  • String
  • 可选
  • /imgextra/i4/2088102146931393/O1CN011MA2520D367McKI_!!2088102146931393-0-koubei.jpg或者文本内容
  • 描述:IMAGE-图片地址;TEXT-文本内容
  • └ industry
  • String
  • 可选
  • SERV_INDUSTRY
  • 行业信息
  • └ origin_price
  • Number
  • 可选
  • 100
  • 商品原价,单位分,1元=100分
  • └ title
  • String
  • 可选
  • 快速入职体检赠早餐
  • 商品名称,请勿超过40汉字,80个字符
  • └ inventory
  • Number
  • 可选
  • 999910
  • 库存总量
  • available_times
  • AvailableTimeDTO []
  • 可选
  • 部分时间可用,如果全时段24小时都可用availableTimes就传null
  • └ to_time
  • String
  • 可选
  • 12:00
  • 部分时间可用,如果全时段24小时都可用availableTimes就传null
  • └ from_time
  • String
  • 可选
  • 19:00
  • 几点到几点,前后不能超过24小时
  • └ week_day
  • String []
  • 可选
  • ["1","2","3","4","5"]
  • ["1","2","3","4","5"]这里表示周一到周五
  • └ cover
  • String
  • 可选
  • 0yaPA96AQPqJDIju28pvAgAAACMAAQEC
  • //商品头图,必填,4:3,图片大小范围20KB~5000KB,格式:bmp,png,jpeg,gif,建议尺寸:2000x1500
  • forbidden_dates
  • DateRangeDTO []
  • 可选
  • //不可用日期,如果具体某日不可用,from和to一样就好,如果全日期可用就传null
  • └ to_date
  • String
  • 可选
  • 2018-06-30
  • 结束时间
  • └ from_date
  • String
  • 可选
  • 2018-05-30
  • 开始时间
  • └ tb_item_id
  • String
  • 必须
  • 淘系商品id
  • 修改的商品id
  • └ validity_period_from
  • String
  • 可选
  • 2021-01-12 00:00:00
  • 有效期开始
  • └ display_channels
  • String
  • 可选
  • ALL
  • 商品展示渠道,正常展示用ALL,定投用ORIENTATION
  • └ price
  • Number
  • 可选
  • 100
  • 商品售价,单位分,1元=100分
  • └ shop_ids
  • String []
  • 可选
  • ["2015100300077000000001860010","2015100100077000000001855137"]
  • 门店列表
  • └ request_id
  • String
  • 可选
  • 修改请求requestId
  • 请求id
  • └ verify_frequency
  • String
  • 可选
  • single
  • 商品可核销频度(single/multi) 可创建不可修改,目前本接口只支持single
  • └ validity_period_to
  • String
  • 可选
  • 2021-04-12 23:59:59
  • 有效期截止
  • └ verify_enable_times
  • Number
  • 可选
  • 1
  • 本接口目前,结合single,只支持传1
  • buyer_notes
  • BuyTipsDTO []
  • 可选
  • 更多购买须知
  • └ title
  • String
  • 可选
  • 须知标题1
  • 更多购买须知标题
  • └ details
  • String []
  • 可选
  • ["desc1","desc2"]
  • 购买须知描述组
  • └ test_item
  • Boolean
  • 可选
  • false
  • 发布到线上售卖的商品,需要传true
  • buy_limit_dto_list
  • ItemBuyLimitDTO []
  • 可选
  • 购买限制
  • └ limit_num
  • Number
  • 可选
  • 1
  • 限购数量
  • └ limit_type
  • String
  • 可选
  • BUY_LIMIT_PER_ORDER_MAX
  • 限购规则类型
  • └ picture_details
  • String []
  • 可选
  • ["0yaPA96AQPqJDIju28pvAgAAACMAAQEC"]
  • //商品图片列表,可选,跟cover一样4:3比例,最多5张
  • └ valid_period
  • Number
  • 可选
  • 90
  • 相对有效期时长(单位 天)
  • buy_tips_template
  • BuyTipsTemplateDto
  • 可选
  • 购买须知属性
  • └ free_wifi
  • Boolean
  • 可选
  • true
  • 是否免费wifi
  • └ limit_user_num
  • Boolean
  • 可选
  • true
  • 是否使用数量限制
  • └ reserve_note
  • String
  • 可选
  • ONLINE
  • 预约方式,电话预约MOBILE,在线预约ONLINE
  • └ invoice_types
  • String []
  • 可选
  • ["ELECTRONIC_INVOICE","PAPER_INVOICE"]
  • 支持的发票类型,"ELECTRONIC_INVOICE",//电子发票; "PAPER_INVOICE"//纸质发票
  • └ park_fee_per_hour
  • Number
  • 可选
  • 5
  • 每小时停车费,单位分
  • └ need_reserve
  • Boolean
  • 可选
  • true
  • 是否需要预约
  • └ supply_invoice
  • Boolean
  • 可选
  • true
  • 是否提供发票
  • └ free_park_hours
  • Number
  • 可选
  • 3
  • 免费停车3小时,最大值24
  • └ reserve_type
  • String
  • 可选
  • MOBILE
  • 预约方式,电话预约MOBILE,在线预约ONLINE
  • └ user_num_limited
  • Number
  • 可选
  • 10
  • 每张限用10人,区间1-100
  • └ free_park
  • Boolean
  • 可选
  • true
  • 是否免费停车
  • └ park_fee_upper_bound_per_day
  • Number
  • 可选
  • 50
  • 24小时停车费上限值
  • └ sales_period_start
  • String
  • 可选
  • 2021-01-12 00:00:00
  • 售卖开始时间
  • └ taobao_cover
  • String
  • 可选
  • 0yaPA96AQPqJDIju28pvAgAAACMAAQEC
  • 商品1:1首图,用于频道栏目、店铺等商品入口展示
  • └ validity_period_type
  • String
  • 可选
  • RELATIVE
  • 有效期类型FIXED和RELATIVE两种
  • └ merchant_pid
  • String
  • 必须
  • xxx
  • 商户id
  • └ operator_type
  • String
  • 可选
  • ISV
  • 身份类型
  • └ category_id
  • String
  • 可选
  • 商品类目id
  • 2020062900464093
  • └ forbid_reverse
  • Boolean
  • 可选
  • false
  • 是否禁止反圈,设置禁止反圈时,必须为定向投放;默认是允许反圈的

响应参数

名称 类型 示例值 描述
result Result 结果对象 接口返回model
  • └ trace_id
  • String
  • xxxxxx
  • 链路traceId
  • data
  • ItemMngRespone
  • 返回结果
  • └ tb_item_id
  • String
  • 本地生活商品id
  • └ retry
  • Boolean
  • false
  • 操作,重试是否能成功,业务异常,重试是不能成功的,网络异常,系统异常重试能幂等成功
  • └ success
  • Boolean
  • false
  • 是否成功
  • error
  • TribeError
  • demo
  • 错误信息描述信息
  • └ view
  • String
  • └ code
  • String
  • SYSTEM_ERROR
  • 错误码
  • └ message
  • String
  • 系统异常
  • 错误信息

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
LifeserviceItemModifyRequest req = new LifeserviceItemModifyRequest();
LifeserviceItemModifyRequest.OpenItemModifyRequest obj1 = new LifeserviceItemModifyRequest.OpenItemModifyRequest();
obj1.setSalesPeriodEnd("2021-01-20 19:56:47");
obj1.setTicketDisplayMode("NO_DISPLAY_CODE");
LifeserviceItemModifyRequest.ServicePackageDto obj2 = new LifeserviceItemModifyRequest.ServicePackageDto();
obj2.setPrice(100L);
List<LifeserviceItemModifyRequest.PackageContentDTO> list4 = new ArrayList<LifeserviceItemModifyRequest.PackageContentDTO>();
LifeserviceItemModifyRequest.PackageContentDTO obj5 = new LifeserviceItemModifyRequest.PackageContentDTO();
list4.add(obj5);
List<LifeserviceItemModifyRequest.ContentGroupDto> list8 = new ArrayList<LifeserviceItemModifyRequest.ContentGroupDto>();
LifeserviceItemModifyRequest.ContentGroupDto obj9 = new LifeserviceItemModifyRequest.ContentGroupDto();
list8.add(obj9);
obj9.setUnit("份");
obj9.setPrice(20000L);
obj9.setContent("咽拭子");
obj9.setNum("1");
list6.setContentGroupList(list8);
obj5.setTitle("修改内容组标题1");
obj2.setPackageContentList(list4);
obj2.setHasServiceUnit(false);
obj2.setExplanation("修改补充说明xx信息");
obj2.setServicePackageName("修改,一般和标题名一样,可改");
obj2.setServiceCategoryId("1020191219001000000");
List<LifeserviceItemModifyRequest.ServiceFlowDTO> list11 = new ArrayList<LifeserviceItemModifyRequest.ServiceFlowDTO>();
LifeserviceItemModifyRequest.ServiceFlowDTO obj12 = new LifeserviceItemModifyRequest.ServiceFlowDTO();
list11.add(obj12);
obj12.setExplanation("补充说明");
obj12.setUnit("份");
obj12.setNum("2");
obj12.setServiceContent("服务内容描述xxx");
obj12.setStep("1");
obj2.setServiceFlowList(list11);
List<LifeserviceItemModifyRequest.GraphicTextDTO> list14 = new ArrayList<LifeserviceItemModifyRequest.GraphicTextDTO>();
LifeserviceItemModifyRequest.GraphicTextDTO obj15 = new LifeserviceItemModifyRequest.GraphicTextDTO();
list14.add(obj15);
obj15.setType("IMAGE");
obj15.setDjangoId("LpbRZPO0QZeh9pneiUhgNwAAACMAAQED");
obj15.setContent("/imgextra/i4/2088102146931393/O1CN011MA2520D367McKI_!!2088102146931393-0-koubei.jpg或者文本内容");
obj2.setGraphicTextList(list14);
obj1.setServicePackageDto(obj2);
obj1.setIndustry("SERV_INDUSTRY");
obj1.setOriginPrice(100L);
obj1.setTitle("快速入职体检赠早餐");
obj1.setInventory(999910L);
List<LifeserviceItemModifyRequest.AvailableTimeDTO> list17 = new ArrayList<LifeserviceItemModifyRequest.AvailableTimeDTO>();
LifeserviceItemModifyRequest.AvailableTimeDTO obj18 = new LifeserviceItemModifyRequest.AvailableTimeDTO();
list17.add(obj18);
obj18.setToTime("12:00");
obj18.setFromTime("19:00");
obj18.setWeekDay(""1","2","3","4","5"");
obj1.setAvailableTimes(list17);
obj1.setCover("0yaPA96AQPqJDIju28pvAgAAACMAAQEC");
List<LifeserviceItemModifyRequest.DateRangeDTO> list20 = new ArrayList<LifeserviceItemModifyRequest.DateRangeDTO>();
LifeserviceItemModifyRequest.DateRangeDTO obj21 = new LifeserviceItemModifyRequest.DateRangeDTO();
list20.add(obj21);
obj21.setToDate("2018-06-30");
obj21.setFromDate("2018-05-30");
obj1.setForbiddenDates(list20);
obj1.setTbItemId("淘系商品id");
obj1.setValidityPeriodFrom("2021-01-12 00:00:00");
obj1.setDisplayChannels("ALL");
obj1.setPrice(100L);
obj1.setShopIds(""2015100300077000000001860010","2015100100077000000001855137"");
obj1.setRequestId("修改请求requestId");
obj1.setVerifyFrequency("single");
obj1.setValidityPeriodTo("2021-04-12 23:59:59");
obj1.setVerifyEnableTimes(1L);
List<LifeserviceItemModifyRequest.BuyTipsDTO> list23 = new ArrayList<LifeserviceItemModifyRequest.BuyTipsDTO>();
LifeserviceItemModifyRequest.BuyTipsDTO obj24 = new LifeserviceItemModifyRequest.BuyTipsDTO();
list23.add(obj24);
obj24.setTitle("须知标题1");
obj24.setDetails(""desc1","desc2"");
obj1.setBuyerNotes(list23);
obj1.setTestItem(false);
List<LifeserviceItemModifyRequest.ItemBuyLimitDTO> list26 = new ArrayList<LifeserviceItemModifyRequest.ItemBuyLimitDTO>();
LifeserviceItemModifyRequest.ItemBuyLimitDTO obj27 = new LifeserviceItemModifyRequest.ItemBuyLimitDTO();
list26.add(obj27);
obj27.setLimitNum(1L);
obj27.setLimitType("BUY_LIMIT_PER_ORDER_MAX");
obj1.setBuyLimitDtoList(list26);
obj1.setPictureDetails(""0yaPA96AQPqJDIju28pvAgAAACMAAQEC"");
obj1.setValidPeriod(90L);
LifeserviceItemModifyRequest.BuyTipsTemplateDto obj28 = new LifeserviceItemModifyRequest.BuyTipsTemplateDto();
obj28.setFreeWifi(true);
obj28.setLimitUserNum(true);
obj28.setReserveNote("ONLINE");
obj28.setInvoiceTypes(""ELECTRONIC_INVOICE","PAPER_INVOICE"");
obj28.setParkFeePerHour(5L);
obj28.setNeedReserve(true);
obj28.setSupplyInvoice(true);
obj28.setFreeParkHours(3L);
obj28.setReserveType("MOBILE");
obj28.setUserNumLimited(10L);
obj28.setFreePark(true);
obj28.setParkFeeUpperBoundPerDay(50L);
obj1.setBuyTipsTemplate(obj28);
obj1.setSalesPeriodStart("2021-01-12 00:00:00");
obj1.setTaobaoCover("0yaPA96AQPqJDIju28pvAgAAACMAAQEC");
obj1.setValidityPeriodType("RELATIVE");
obj1.setMerchantPid("xxx");
obj1.setOperatorType("ISV");
obj1.setCategoryId("商品类目id");
obj1.setForbidReverse(false);
req.setItemModifyRequest(obj1);
LifeserviceItemModifyResponse rsp = client.execute(req);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<lifeservice_item_modify_response>
    <result>
        <trace_id>xxxxxx</trace_id>
        <data>
            <tb_item_id></tb_item_id>
            <retry>false</retry>
        </data>
        <success>false</success>
        <error>
            <view></view>
            <code>SYSTEM_ERROR</code>
            <message>系统异常</message>
        </error>
    </result>
</lifeservice_item_modify_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

返回
顶部