文档中心 > API类目 > 阿里健康-消费医疗-商品门店服务

alibaba.alihealth.medical.item.sync (商品同步)

服务商将商品同步给阿里健康

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
param0 SyncItemTopRequest 必须 同步商品请求
  • └ isv_item_id
  • String
  • 必须
  • JX_ITEM_001
  • isv商品ID,对应原接口的groupId,要求同一个appkey下唯一
  • └ item_name
  • String
  • 必须
  • 中青年体检A套餐
  • 商品名称,不超过50个字符
  • └ backend_category_id
  • String
  • 必须
  • 20210204000005
  • 后台类目ID,eg: 儿童体检: 20210204000004, 中青年体检: 20210204000005, 老年体检: 20210204000006, 证件体检(含入职): 20210204000007, 核酸检测(到店服务): 20210204000008, 专科服务(不包含核酸检测): 20210204000009, 上门检测: 202102040000010, 上门护理: 202102040000011, 上门体检 202102040000012
  • └ description
  • String
  • 必须
  • 商品描述
  • 商品描述文本描述
  • └ reservation_api_version
  • Number
  • 必须
  • 0
  • 预约接口版本
  • item_skus
  • ItemSkuTopModel []
  • 必须
  • []
  • 对应原体检套餐package_list字段,商品的SKU信息
  • └ isv_item_sku_id
  • String
  • 必须
  • JX_ITEM_SKU_001
  • 商品SKU ID,同一个账号下唯一
  • └ item_sku_name
  • String
  • 必须
  • 中青年体检-男
  • 商品SKU名称,不超过50个字符
  • └ settlement_price
  • BigDecimal
  • 必须
  • 19.9
  • 阿里健康与商户/服务商之间的结算价,单位 元
  • └ sales_price
  • BigDecimal
  • 必须
  • 21.5
  • 实际销售给客户的售价, 单位 元
  • └ market_price
  • BigDecimal
  • 必须
  • 22
  • 市场价,原价/划线价, 单位 元
  • └ description
  • String
  • 必须
  • 中青年体检基础套餐
  • 商品SKU描述信息,最多500字
  • └ suitable_gender
  • String
  • 必须
  • MALE
  • MALE 男, FEMALE 女, GENERAL 通用
  • └ suitable_marital_status
  • String
  • 必须
  • GENERAL
  • MARRIED 已婚,UNMARRIED 未婚,GENERAL 通用
  • └ type_labels
  • String []
  • 可选
  • 父母体检
  • 类型标签,T+1生效,体检业务:入职体检,父母体检,女性体检,中青年体检,肿瘤筛查,肠胃套餐,健康证,儿童体检,婚前孕前,高端体检,核酸检测,妇科检查,特价体检,证件体检,专科检查,健康优选,减重服务,驾驶证,入学体检,职业体检 护理/检测业务:上门换药,陪诊/陪护,小儿护理,日常护理,置管护理,上门核酸,上门体检,传染病检测,慢病检测,肿瘤早筛,甲状腺检测,专项检测,卵巢检测,打针/采血,核酸团检,中医养生,过敏原检测,小儿检测,基因检测,皮肤检测,过敏检测,肠胃检查,甲状腺检查 心理健康业务:心理测评,心理咨询,在线咨询,情感分析,情感顾问,测评,心理医生,咨询,心理辅导,情感咨询,心理电话咨询,心理门店咨询,恋爱情感,焦虑缓解,职业规划,家庭教育,一对一服务,猜你喜欢,推荐,专家课程,线上陪伴营,专家预约,团体治疗,亲子关系,抑郁焦虑 口腔齿科业务:洗牙,儿童口腔,美白,拔牙,烤瓷牙; 多个请用逗号分隔,不建议跨行业/业务使用上述标签;个人到店核酸检测请选择'核酸检测', 上门核酸检测请选择'上门核酸', 上门核酸团检请选择'核酸团检'
  • └ major_item_labels
  • String []
  • 可选
  • 胃镜检查
  • 重点项目标签,T+1生效,多个请用逗号分隔,不建议跨行业/业务使用下述标签 体检业务:妇科检查,肠胃疾病,肿瘤筛查,肝胆检查,胸肺部检查,心脑血管检查,甲状腺检查,乳腺检查,前列腺检查,颈椎腰椎,宫颈癌筛查; 体检加项包套餐:基础检查,血液检查,尿液检查,粪便检查,肝功能检查,血脂检查,肾功能检查,糖尿病检查,肝炎检查,甲状腺功能检查,心血管疾病检查,胃部检查,风湿、类风湿疾病检查,微量元素检查 ,性病检查,癌筛查检查,妇科检查,心电图检查,超声检查(B超),放射科检查(DR摄片/CT),核磁共振检查(MRI),窥镜检查(肠胃镜等),慢病检查,备孕检查,中医检查 心理健康业务:1V1专业沟通,专业量表,全面报告,专业心理评估,60分钟深入咨询,个性化定制方案,系统稳定咨询 口腔齿科业务:预防牙周病,清洁牙齿,清除色素,效果更佳,牙齿防蛀,重点保护,促进钙化,全口防蛀,一次搞定,全面检查,赠送X光片,进口树脂,美观耐用,纳米树脂,及时止龋,为换牙护航,微创拔牙,解除隐患,预防感染,进口材料,SPA式体验,不酸不痛,牙齿美白,数字化定制,仿若真牙,认证医生,专业服务;
  • └ main_image
  • String
  • 可选
  • http://123123.jpg
  • 主图,展示在详情页顶部,尺寸4:3,大小不超过200kb
  • └ thumbnail
  • String
  • 可选
  • http://123123.jpg
  • 缩略图,展示在套餐列表上,尺寸1:1,大小不超过200kb。与marketing_thumbnail_generation_option必传一个,优先取marketing_thumbnail_generation_option
  • └ keep_appointment_site
  • String
  • 必须
  • ONSITE
  • 履约发生地点 ONSITE 到店,TO_DOOR 上门,ONLINE 在线
  • └ report_generation_max_millis_business_commitment
  • Number
  • 可选
  • 1000000
  • 最长多久出报告 单位毫秒
  • └ hidden_when_search_or_recommend
  • Boolean
  • 可选
  • false
  • 屏蔽搜索推荐,一般用在定向的投放的商品或者仅作为加项使用的商品,为true表示搜索推荐主链路不直接透出
  • └ isv_item_sku_ids_to_keep_appointment_with
  • String []
  • 可选
  • []
  • 加项商品SKU ID列表
  • └ recommend_isv_item_sku_ids_to_keep_appointment_with
  • String []
  • 可选
  • []
  • 置顶推荐的加项商品SKU ID列表
  • └ sales_price_when_sell_along
  • BigDecimal
  • 可选
  • 22.22
  • 作为搭售商品的时候的价格
  • single_item_or_packages
  • SingleItemPackageTopModel []
  • 可选
  • []
  • 商品SKU包含的单项或项目包列表
  • └ name
  • String
  • 可选
  • 肝功能5项
  • 单项/项目包名称,必填
  • └ description
  • String
  • 可选
  • 肝功能
  • 描述,必填
  • └ contains_standard_item_codes
  • String []
  • 可选
  • []
  • 包含的标准项目编码列表
  • └ isv_single_item_or_package_id
  • String
  • 可选
  • SI_001
  • 服务商项目/项目包ID,必填,同一个账号下唯一
  • └ is_single_item
  • String
  • 可选
  • true
  • 是否是单项,true 单项,false项目包
  • additional_services
  • AdditionalServiceTopModel []
  • 可选
  • 附加服务
  • 附加服务
  • └ name
  • String
  • 可选
  • 免费专家解读报告
  • 附加服务名称,必填,选择:免费早餐、营养早餐、免费报告解读、绿色通道、专人导检、1V1导检、专家会诊、专车接送、赠礼、VIP通道、单项退改、电子存档、周末可约、周六可约、极速开票、免费停车、报告邮寄、可支持加项、检前提醒、接待服务
  • └ name_abbreviate
  • String
  • 可选
  • 报告解读
  • 名称缩写,标签名,必填,选择:免费早餐、营养早餐、免费报告解读、绿色通道、专人导检、1V1导检、专家会诊、专车接送、赠礼、VIP通道、单项退改、电子存档、周末可约、周六可约、极速开票、免费停车、报告邮寄、可支持加项、检前提醒、接待服务
  • └ description
  • String
  • 可选
  • 描述
  • 描述,必填
  • └ detail_image
  • String
  • 可选
  • http://xxxx/xx
  • 详情信息图,展示在详情页下方,尺寸790*Xpx,大小不超过500kb
  • marketing_thumbnail_generation_option
  • MarketingThumbnailGenerationOptionTopModel
  • 可选
  • 营销缩略图合成选项
  • └ logo
  • String
  • 可选
  • http://xxxx/xx
  • 废弃
  • └ title
  • String
  • 可选
  • 父母体检
  • 图片文案标题,必填,字数不超过8个字
  • └ single_item_count
  • Number
  • 可选
  • 41
  • 包含的单项数量,可选
  • └ major_items
  • String []
  • 可选
  • ["胸部CT", "心肺筛查"]
  • 重点项目,可选,不超过3个,每个字数不超过7个字
  • └ suitable_age_desc
  • String
  • 可选
  • 30-50岁
  • 适用年龄段描述,可选
  • └ figure_image
  • String
  • 可选
  • http://xxxx/xx
  • 人物图,可选,尺寸460*500px,透明底,大小不超过100kb
  • └ announcement
  • String
  • 可选
  • 套餐的通知/申明/公告
  • 套餐的通知/申明/公告
  • └ applicable_crowd_desc
  • String
  • 可选
  • 适用人群描述信息
  • 适用人群描述信息(建议50中文字符)
  • └ recommend_reason
  • String
  • 可选
  • 推荐理由原因
  • 推荐理由原因(建议50中文字符)
  • └ additional_service_desc
  • String
  • 可选
  • 附加服务描述信息
  • 附加服务描述信息(建议50中文字符), 为additionalService的综合性描述
  • └ special_attention_note
  • String
  • 可选
  • 特殊注意事项, sku维度的
  • 特殊注意事项, sku维度的, 如体检sku的女已婚sku注意有性生活史的信息描述
  • service_processes
  • ServiceProcessTopModel []
  • 可选
  • 服务流程
  • 服务流程
  • └ code
  • String
  • 可选
  • code
  • PURCHASE("选购"),RESERVATION("预约"),KEEPING_APPOINTMENT("到店履约"),INVOICE("开票"),REPORT_OBTAIN("报告获取")
  • └ content
  • String
  • 可选
  • content
  • 内容描述
  • └ only_as_sku_item
  • Boolean
  • 可选
  • false
  • 废弃,换用sale_independently
  • └ inventory_independence
  • Boolean
  • 可选
  • false
  • 是否库存无关:0库存有关,1库存无关
  • └ sale_independently
  • Boolean
  • 可选
  • true
  • 是否可独立售卖,默认为true可独立售卖
  • └ channel_sales_price
  • BigDecimal
  • 可选
  • 21.5
  • 渠道售卖价
  • └ channel_settlement_price
  • BigDecimal
  • 可选
  • 19.9
  • 渠道结算价
  • └ inventory_api_version
  • Number
  • 可选
  • 0
  • 库存接口版本:0走examination.stock,1走medical.inventory
  • └ update_tmall_item
  • Boolean
  • 可选
  • false
  • 当前操作是更新天猫商品
  • └ isv_store_ids
  • String []
  • 可选
  • ["11223"]
  • 商家门店ID list(门店必须已同步到天猫)-新增天猫商品必填,暂不支持修改

响应参数

名称 类型 示例值 描述
result_status String SUCCESS SUCCESS:成功; FAIL:失败; UNKNOWN:未知; ACCEPT 待审核
result_code String SUCCESS 返回结果码
result_msg String 成功 结果描述

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
AlibabaAlihealthMedicalItemSyncRequest req = new AlibabaAlihealthMedicalItemSyncRequest();
AlibabaAlihealthMedicalItemSyncRequest.SyncItemTopRequest obj1 = new AlibabaAlihealthMedicalItemSyncRequest.SyncItemTopRequest();
obj1.setIsvItemId("JX_ITEM_001");
obj1.setItemName("中青年体检A套餐");
obj1.setBackendCategoryId("20210204000005");
obj1.setDescription("商品描述");
obj1.setReservationApiVersion(0L);
List<AlibabaAlihealthMedicalItemSyncRequest.ItemSkuTopModel> list3 = new ArrayList<AlibabaAlihealthMedicalItemSyncRequest.ItemSkuTopModel>();
AlibabaAlihealthMedicalItemSyncRequest.ItemSkuTopModel obj4 = new AlibabaAlihealthMedicalItemSyncRequest.ItemSkuTopModel();
list3.add(obj4);
obj4.setIsvItemSkuId("JX_ITEM_SKU_001");
obj4.setItemSkuName("中青年体检-男");
obj4.setSettlementPrice("19.9");
obj4.setSalesPrice("21.5");
obj4.setMarketPrice("22");
obj4.setDescription("中青年体检基础套餐");
obj4.setSuitableGender("MALE");
obj4.setSuitableMaritalStatus("GENERAL");
obj4.setTypeLabels("父母体检");
obj4.setMajorItemLabels("胃镜检查");
obj4.setMainImage("http://123123.jpg");
obj4.setThumbnail("http://123123.jpg");
obj4.setKeepAppointmentSite("ONSITE");
obj4.setReportGenerationMaxMillisBusinessCommitment(1000000L);
obj4.setHiddenWhenSearchOrRecommend(false);
obj4.setIsvItemSkuIdsToKeepAppointmentWith("");
obj4.setRecommendIsvItemSkuIdsToKeepAppointmentWith("");
obj4.setSalesPriceWhenSellAlong("22.22");
List<AlibabaAlihealthMedicalItemSyncRequest.SingleItemPackageTopModel> list7 = new ArrayList<AlibabaAlihealthMedicalItemSyncRequest.SingleItemPackageTopModel>();
AlibabaAlihealthMedicalItemSyncRequest.SingleItemPackageTopModel obj8 = new AlibabaAlihealthMedicalItemSyncRequest.SingleItemPackageTopModel();
list7.add(obj8);
obj8.setName("肝功能5项");
obj8.setDescription("肝功能");
obj8.setContainsStandardItemCodes("");
obj8.setIsvSingleItemOrPackageId("SI_001");
obj8.setIsSingleItem("true");
list5.setSingleItemOrPackages(list7);
List<AlibabaAlihealthMedicalItemSyncRequest.AdditionalServiceTopModel> list11 = new ArrayList<AlibabaAlihealthMedicalItemSyncRequest.AdditionalServiceTopModel>();
AlibabaAlihealthMedicalItemSyncRequest.AdditionalServiceTopModel obj12 = new AlibabaAlihealthMedicalItemSyncRequest.AdditionalServiceTopModel();
list11.add(obj12);
obj12.setName("免费专家解读报告");
obj12.setNameAbbreviate("报告解读");
obj12.setDescription("描述");
list9.setAdditionalServices(list11);
obj4.setDetailImage("http://xxxx/xx");
AlibabaAlihealthMedicalItemSyncRequest.MarketingThumbnailGenerationOptionTopModel obj14 = new AlibabaAlihealthMedicalItemSyncRequest.MarketingThumbnailGenerationOptionTopModel();
obj14.setLogo("http://xxxx/xx");
obj14.setTitle("父母体检");
obj14.setSingleItemCount(41L);
obj14.setMajorItems(""胸部CT", "心肺筛查"");
obj14.setSuitableAgeDesc("30-50岁");
obj14.setFigureImage("http://xxxx/xx");
list13.setMarketingThumbnailGenerationOption(obj14);
obj4.setAnnouncement("套餐的通知/申明/公告");
obj4.setApplicableCrowdDesc("适用人群描述信息");
obj4.setRecommendReason("推荐理由原因");
obj4.setAdditionalServiceDesc("附加服务描述信息");
obj4.setSpecialAttentionNote("特殊注意事项, sku维度的");
List<AlibabaAlihealthMedicalItemSyncRequest.ServiceProcessTopModel> list17 = new ArrayList<AlibabaAlihealthMedicalItemSyncRequest.ServiceProcessTopModel>();
AlibabaAlihealthMedicalItemSyncRequest.ServiceProcessTopModel obj18 = new AlibabaAlihealthMedicalItemSyncRequest.ServiceProcessTopModel();
list17.add(obj18);
obj18.setCode("code");
obj18.setContent("content");
list15.setServiceProcesses(list17);
obj4.setOnlyAsSkuItem(false);
obj4.setInventoryIndependence(false);
obj4.setSaleIndependently(true);
obj4.setChannelSalesPrice("21.5");
obj4.setChannelSettlementPrice("19.9");
obj1.setItemSkus(list3);
obj1.setInventoryApiVersion(0L);
obj1.setUpdateTmallItem(false);
obj1.setIsvStoreIds(""11223"");
req.setParam0(obj1);
AlibabaAlihealthMedicalItemSyncResponse rsp = client.execute(req);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<alibaba_alihealth_medical_item_sync_response>
    <result_status>SUCCESS</result_status>
    <result_code>SUCCESS</result_code>
    <result_msg>成功</result_msg>
</alibaba_alihealth_medical_item_sync_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

返回
顶部