飞猪

Schema体系是开放平台与天猫/淘宝商品团队共同定义的一套新的开放API规范,用以解决天猫/淘宝商品管理平台的频繁变动给开发者带来的开发维护成本。天猫/淘宝商品平台通过开放平台API将商品管理涉及的元素及规则使用更接近开发者的语言通过xml的方式返回,开发者解析xml后,根据xml中的规则及元素生成一个商品信息xml,调用开放平台API上传完成商品管理。

使用Schema接口必须先理解schema体系的结构。一个完整的schemaxml会由若干个field组成,每一个field都是用来描述规则和元素。schema结构针对field定义了以下组成部分。

段名称

说明

id

用于描述唯一主键,以商品的标题为例,id=“title”。

name

用于描述field的显示名,以商品的标题为例,name=“商品标题”。

type

用于描述field的值的数据输入类型,schema结构对于field定义了七种类型,分别为input、multiInput、singleCheck、multiCheck、complex、multiComplex和label。详见3.1说明。

values

用于描述multiInput和multiCheck类型的field的value的集合。

complex-value

用于描述complex类型的field的多数据值的集合。

complex-values

用于描述multiComplex类型的field的多数据值的集合。

value

用于描述field的值,上一层级一般为values或者complex-values。

option

用于描述field的值的可选值,与html中select元素中的option标签类似。(1)displayName,用于描述可选值的展示名。(2)value,用于描述可选值主键。

label-group

用于描述label的聚合,label主要用于描述说明信息。

rule

用于描述field的各类系统或者业务规则。详见3.2说明。

depend-group

用于描述依赖关系的集合。

operator

用于描述集合中多个依赖关系的关系,包括‘and’(与关系)和’or’(或关系)。

depend-express

用于描述依赖关系,上层为depend-group,与Rule中的disableRule是成组出现的。一般可以理解为当满足依赖关系时,disableRule为true才成立depend-express中会包含fieldId、value和symbol。目前支持的symbol见3.3说明。

type用于描述field的值的数据输入类型,schema结构对于field定义了七种类型,分别为input、multiInput、singleCheck、multiCheck、complex、multiComplex和label。

类型

类型说明

input

当前field的值为文本输入

multiInput

当前field的值为多行文本输入型

singleCheck

当前field的值为单选输入型,类似于radio

multiCheck

当前field的值为多选输入型,类似于checkbox

complex

当前field的值为复合结构,表示数据的聚合

multiComplex

当前field的值为复合结构,与complex有差别的在于multiComplex的field是可以有多份数据实例样本

rule用于描述field的各类系统或者业务规则。

rule类型

valueTypeRule

用于描述field值需要满足数据类型,包括了text(文本型)/decimal(小数型)/integer(整数型)/date(日期型)/long(长整数型)/url(超链接)/textarea(多行文本)/html(支持html标记语法的文本)

requiredRule

是否必填,默认为false,true/false

disableRule

是否忽略此field,为true时,将不对rule进行check,同时他的value也将无效。默认为false,值范围包含true/false

maxLengthRule

最大长度

minLengthRule

最小长度

maxValueRule

最大值(数值类型时有效)

minValueRule

最小值(数值类型时有效)

maxInputNumRule

最多可选数(多选时有效)

minInputNumRule

至少要选数(多选时有效)

maxTargetSizeRule

最大目标文件大小

minTargetSizeRule

最小目标文件大小

readOnlyRule

只读,用户无法修改返回值,值范围为true/false

regxRule

正则表达式匹配

tipRule

Field中展示的tip信息,用于一些无法直接用语法描述或者过于复杂的规则,或者提示信息,需要给用户透出。

maxImageSizeRule

最大图片大小,指的是分辨率,如800*800

minImageSizeRule

最小图片大小

devTipRule

一般用于给开发者提示,不需要展示给用户,开发者可以通过此Rule获取特定的信息,如例子中的如何获取售后模板信息

symbol

isnull

fieldId指向的字段的值为空

==

fieldId指向的字段的值等于value

!=

fieldId指向的字段的值不等于value

>

fieldId指向的字段的值大于value

<

fieldId指向的字段的值小于value

>=

fieldId指向的字段的值大于等于value

<=

fieldId指向的字段的值小于等于value

contains

fieldId指向的字段的值中包含有value

notcontains

fieldId指向的字段的值中不包含有value

thisfield’svalueinfieldOptions

fieldId指向的字段的值中在fieldId对应的value列表中

thisfield’svaluenotinfieldOptions

fieldId指向的字段的值中不在fieldId对应的value列表中

multiComple

TipRule一般用于无法直接描述的复杂规则,isv需要将该规则在页面上透出给用户。以价格为例。

DevTipRule一般用于给开发者提示,不需要展示给用户,开发者可以通过此Rule获取特定的信息,如例子中的如何获取售后模板信息。以售后模板为例。

在区间rule里面,都有一个exProperty属性,表示开闭区。当exProperty=include时,为闭区间,大小比较时,包含rule的value指定的值;当exProperty=notinclude时,为开区间,大小比较时,不包含rule的value指定的值。

例如:

maxValueRule中value=2且exProperty=include时,表示返回值必须小于等于2;

maxValueRule中value=2且exProperty=notinclude时,表示返回值必须小于2。

maxTargetSizeRule和minTargetSizeRule有个unit属性,表示规则的单位。这两个rule的单位主要有kb、mk、gb等,表示文件大小的单位。maxLengthRule和minLengthRule也有unit属性,表示长度计量单位,有byte和character两种单位。

例如:“a汉字”这个字符串,当单位为byte时,长度是5,当单位是character时,长度是3。

由于业务的变化速度非常快,开发者实现一个变更检测的功能,对于天猫商家来说,每天定期拉取商家对应类目下规则,比较xml差异,根据差异进行业务处理的调整。

开发者需要针对每一个商家实现一个动态映射的能力,将本地数据与线上返回的xml结构的元素进行一一映射,改变以前的写死参数的方式,这是接入schema体系最重要的事情。

增量更新的字段有限,按需提交filed的value(s)即可,新版中不需要update_fields字段。

涉及接口:

说明:天猫商品需要挂靠产品,所以产品发布仅支持天猫店铺;淘宝和特价版商品无需挂靠产品,不需要产品发布,直接按照“步骤三”发布商品即可。

类目:女装/女士精品>>POLO衫(类目id:201241307)为例说明产品发布步骤;

涉及API:tmall.product.match.schema.get;

入参:category_id=201241307;

出参:规则xml;

如果没有返回产品匹配规则,说明该类目不需要发布产品,直接到"步骤三:发布商品"。

涉及API:tmall.product.schema.match;

入参:category_id=201241307;propvalues=xml_data(示例XML如下);

100004972157813

出参:产品id;product_id=1459669507;

调用tmall.product.schema.get查询产品状态【】;

产品状态(true)如果返回true则可以直接发布商品(直接到"步骤三:发布商品"。);

产品状态(false)如果返回false则需要等待。

注意:如果上一步(产品匹配)没有匹配到产品,需要自己添加。

涉及API:tmall.product.add.schema.get;

入参:category_id=201241307;brand_id=10000497;

出参:规则xml。

涉及API:tmall.product.schema.add;

入参:category_id=201241307;brand_id=10000497;xml_data;

出参:产品idproduct_id;

注意:部分产品发布后需要审核通过后才可使用,所以需要等待产品状态可用后再发布商品。

备注:

1)如果获取产品规则tmall.product.add.schema.get获取为空时,说明该类目为无关键属性类目,直接去发布商品即可。

2)产品schema接口继续使用老的schemaSDK协议;

新老schema协议差异

1)

字段

老协议

新协议

是否变动

ComplexField

MultiComplexField

2)所有field的default-complex-values/default-values/default-complex-value/default-value都已取消,统一用field的值取代。

当第二步的产品可用后,即可发布商品

1)商品规则获取调用alibaba.item.publish.schema.get获取类目和属性规则

2)商品级联属性信息获取调用alibaba.item.publish.props.get,当alibaba.item.publish.schema.get接口返回的某些属性的值特别多时,会提示使用此接口。根据入参获取商品级联属性信息(基本很少用到),比如alibaba.item.publish.schema.get返回如下结果是:

3)商品发布alibaba.item.publish.submit进行商品上新(注意涉及图片上传时请使用taobao.picture.upload接口)。

①当发布天猫商品时,偶尔会遇到报[isv.item-service-error:ITEM_PROPERTIES_ERROR–“xxx”属性出错:类目属性在标准属性中不存在]这一类错误时,一般是由于行业小二对类目属性进行了调整,(需要去第二步编辑产品)需要调用。②tmall.product.update.schema.get接口获取产品更新规则,检查是否有必填元素的value为空,重新生成产品更新信息xml调用tmall.product.schema.update接口完成补充即可。

alibaba.item.publish.schema.get

alibaba.item.publish.props.get

alibaba.item.publish.submit

TIPS:开发者如果涉及需要获取某一类目下的商品上新的所有规则,可以同时调用tmall.product.add.schema.get接口获取产品发布涉及的规则,然后入参需要注意spu_id传入0调用alibaba.item.publish.schema.get获取商品发布的通用规则(非全部规则)

涉及接口

更新分类

1)全量更新(除局部更新外的均需要走全量更新);

2)局部更新(局部更新API)。

涉及API:alibaba.item.edit.schema.get;

说明:全量和增量编辑的规则都使用接口alibaba.item.edit.schema.get获取;

增量编辑规则获取还需入参fields,比如传入fields=title,接口alibaba.item.edit.schema.get只获取title的编辑规则。

涉及API:alibaba.item.edit.submit;

涉及API:alibaba.item.edit.fastupdate;

说明:

catId,bizIdentity,id,price,quantity,title,wirelessDesc,desc,barcode,outerId,video,images,recommendReason,imageVideo,sellPromise,taobaoFoodPrdLicense,taobaoFoodDesignCode,taobaoFoodFactoryName,taobaoFoodFactorySite,taobaoFoodFactoryContact,taobaoFoodPrdLicense,taobaoFoodDesignCode,taobaoFoodFactoryName,taobaoFoodFactorySite,taobaoFoodFactoryContact,taobaoFoodMix,taobaoFoodPlanStorage,taobaoFoodPeriod,taobaoFoodAdditive,taobaoFoodSupplier,taobaoFoodProduceDate,taobaoFoodStockDate,sku,descRepublicOfSell,shopcat;

i)sku信息支持修改已有sku的图片、价格、数量、商家编码、条形码,但不能新增(删除)sku;

ii)新增sku要用全量接口。

title(标题)

subtitle(子标题,即卖点)

show_title(展示标题)

short_title(无线短标题)

description(商品描述)

wireless_desc(旺铺无线详情描述)

vertical_image(竖图)

white_bg_image(白底图)

large_screen_image(电子大屏图)

shop_category(店铺类目)

item_image(主图)

item_wireless_images(无线主图)

image_video_type(主图视频比例类型)

main_video(主图视频)

three_to_four_item_images(3:4商品图片)

备注:关于主图视频,目前商品已经支持3:4主图视频,并且支持3:4商品主图图片更新,建议三个字段为一个组件来使用;

1)如果image_video_type选择1:1或者16:9类型,那么main_video需要传值1:1或者16:9类型的视频,此时three_to_four_item_images这个字段,不管你传值与否,都不会生效。

2)如果image_video_type选择3:4类型,那么main_video需要传值3:4类型视频,且需要同时传three_to_four_item_images这个字段。

title(宝贝标题)

catProp(类目属性)支持修改枚举类型字段,不支持修改input类型的字段;

sku(宝贝销售规格)支持修改已有sku的价格、库存、商家编码等信息,但不能新增sku;新增sku要用全量接口alibaba.item.edit.submit,并且先设置销售属性;

price(特价)需与marketPrice同时修改;

marketPrice(划线价)需与price同时修改;

quantity(总数量)

outerId(商家编码)

images(宝贝图片)

clearImage(非牛皮癣图)

imageVideo(主图视频)

verticalImage(宝贝长图)

desc(商品描述)

subStock(库存计数)

tbDeliveryTime(发货时效)

tbExtractWay(运费)

invoice(提供发票)

warranty(保修服务)

sellPromise(退换货承诺)

sevenDaySupport、sevenDayOptional(七天退货)

TIPS:建议开发者将增量接口支持的每个元素独立封装,这样性能上更优越,报错也会更少。

THE END
1.社区对象ID 2021004183633920 时间 2024-11-14 17:31 记录ID 2024111400102000000088229614 问题类型 资金风险-...https://open.alipay.com/portal/forum/post/189501014
2.已失效《关联商家(4)品质差的商品(参考《商家违规行为管理总则》第4.7条); (5)商家在信息发布中含有不实信息内容,欺骗和误导消费者的行为(参考【商家一虚假宣传】细则) 2、经平台认定有有刻意规避平台规则管理的恶意行为有哪些? 包括但不限于以下情形: (1)商品信息刻意规避:商家通过对商品信息进行刻意遮挡、刻意使用错别字/特殊...https://school.jinritemai.com/doudian/web/article/aJGceuzytyfK
3.速卖通商品API接口的使用指南与示例要获取速卖通商品详情,可以使用速卖通商品API接口的GET请求方法。以下是调用速卖通商品API接口的示例代码: import requestsimport json# 设置API密钥和其他参数app_key = 'your_app_key'app_secret = 'your_app_secret'product_id = 'your_product_id' # 替换为实际的商品IDurl = f'https://api.aliexpress.com...https://developer.aliyun.com/article/1395475
4.淘宝开放平台商品上下架、删除 场景介绍 商家可以调用商品上下架API来根据商品库存变化或其他情况来上下架商品,同时也可以通过调用API来删除老的商品或无效的商品。 相关API API名称 API 说明 商品上架 alibaba.item.operate.upshelf 根据商品ID和库存数上架一定数量商品 https://open.taobao.com/solutiondetail?id=107
1.POS机出现无效商户号是什么意思?POS机商户号,也称为商户编码,是专门为商户提供的一种独特的识别号码,它通常由支付机构或银行为商户分配,用于在POS机上进行交易时识别商户身份,每个商户号都是唯一的,就像商户的身份zheng证号一样。 二、无效商户号的原因 1、商户号已注销:如果商户号已经被注销,那么再次使用它进行交易时,POS机就会显示“无效商户号...https://www.xipos.cn/m/54102.html
2.应对优惠码输入后未生效的常见问题确认购物车中的所有商品都符合优惠码的使用条件。有时,特价商品或已经打折的商品不再享有额外优惠。 调整购物车内容 如果某些商品不符合条件,将其从购物车移除可能会让优惠码生效。或者,你可以增加符合条件的商品来满足优惠码的要求。 当面对“优惠码输入后未能生效的常见问题”时,以上步骤通常可以帮助你快速找到原因并...https://www.tkvps.com/gwvps/gwvps-4375.html
3.Allegro帮助中心Allegro问题大全Temu半托管Temu全托管速卖通半托管速卖通全托管lazada全托管Shopee全托管TikTok全托管亚马逊全托管TikTok美国站SheinTikTokJumia开店Shopee开店Fruugo开店eprice开店OnBuy开店nocnoc开店Lazada开店美客多开店OZON开店Newegg开店eMAG开店PerFee开店Allegro开店Fnac开店 Wayfair开店ManoMano开店Etsy开店日本乐天开店Fordeal开店沃尔玛开店Gmarket...https://www.cifnews.com/help/114
4.假货也用一物一码防伪时,我们怎么办?当假货也开始使用一物一码系统时,作为消费者或品牌方该如何应对呢?有些假冒伪劣商品,会采用复制正品商品的标签来进行包装,或者是自建一套假冒的防伪溯源系统,当扫码时提示消费者为官方正品。 下面潜利就来分享一下,当面对这两种常见的假货一物一码应用时,企业和消费者如何通过多层面措施加强防护与识别。 http://www.qianlizs.com/yiwuyimafangwei-2/
5.劳斯莱斯汽车:WHISPERS用户使用协议请注意,如果您的账户项下尚有任何您应支付但尚未支付的款项或者有任何您已支付但尚未履行完毕的交易(包括通过专享礼宾服务进行的商品或服务交易),您将暂时无法注销您的Rolls-Royce ID (劳斯莱斯 ID),直至该等款项被全部结清或交易已全部履行完毕。 4.WHISPERS服务一般性规定...https://www.rolls-roycemotorcars.com.cn/zh-CN/ownership/whispers-agreement.html
6.浙江高院:“搬家软件”未经授权爬取淘宝商品数据,构成不正当竞争淘宝(中国)软件有限公司、浙江淘宝网络有限公司(以下合称淘宝公司)作为淘宝平台的经营者主张,绍兴衡尚科技有限公司、上海鲸赢网络科技有限公司、胡*斌共同运营的“搬家大师”“上货专家”软件,未经淘宝公司许可,绕开淘宝平台规则及技术措施,非法抓取淘宝平台的商品数据,并以付费方式向其用户提供服务,将淘宝平台的数据搬运...https://county.beijingip.cn/my/websiteArticle/detailArticle.do?id=401fe2c28cd87548018d77fe5b5e0234
7.隐私政策当您准备对您所需购买的商品进行下单结算时,EASYPAY平台系统会生成您购买该商品的订单。为了完成下单结算页面的服务,您需要提交收货人名称、收货地址以及手机号码。同时该订单中会载明订单号、您所购买的商品或服务信息、下单时间、您应支付的货款金额及支付方式。我们将使用您的订单信息来(包括与为您提供上述服务的第三...https://gzeasypay.com/page/privacy-policy-cn
8.淘宝开店考试试题及答案7篇(全文)C、敌敌畏 D、饲料级硫酸铜、下列哪一项不是淘宝卖家必须做到的?A A、宝贝页面的描述,应该与商品的实际情况相符 B、遵守淘宝规则,遵守对买家的服务承诺 C、每天都要重新发布商品 D、出售的商品,在合理期间内不存在影向正常使用的质量问题 32、一般违规行为多少分为一个处罚节点?C A、10 分 B、16 分 C、12...https://www.99xueshu.com/w/filexe3jvsro.html
9.uniapp黑马优购项目学习记录——持续更新?9.3.5 实现商品的全选/反选功能? ?9.3.7 动态计算购物车徽标的数值 9.3.8 渲染购物车为空时的页面结构 9.4 分支的合并与提交 1. 起步 1.1 uni-app 简介 uni-app 是一个使用 Vue.js 开发所有前端应用的框架。开发者编写一套代码,可发布到 iOS、Android、H5...https://blog.51cto.com/u_15476057/5223385
10....ProductIdentifiers当写完IAP业务过程后,点击测试却发现没有返回成功的商品Id,反而返回了无效的商品:response.invalidProductIdentifiers 这种情况下考虑以下因素: 创建的App ID是否启用了IAP功能。 商品信息是否配置到iTurn Connect,并到达“Ready to Submit”状态。 在iTurn Connect中创建Test User,并收取邮件激活。之后登录到测试用手机...https://blog.csdn.net/kepoon/article/details/45072717
11.抖音设置跨品类sku低价引流治理公告2、同一商品链接或商品ID商品款式差异较大 示例:款式差异较大商品搭配售卖,或商品标题主图展示商品与sku低价商品差异较大,例如外穿拖鞋与家居拖鞋、酒店一次性拖鞋,作为不同sku放置在同一商品内。 3、同一商品链接或商品ID存在虚假无效sku商品 示例:将已损坏商品、无效商品作为sku与正常商品一起售卖,例如破损玻璃杯、...https://m.maijia.com/article/528671
12.天猫新版无线宝贝描述详情操作视频图文教程(天猫无线端如何发布...默认读取第一张主图,标题读取顺序为搜索短标题和无线短标题,以上信息都为空时商家可自行编辑,最多10个汉字,也可为空。 3.4.2覆盖商品: 覆盖商品页面展示的是该同店推荐模板所已经覆盖的商品。在对应的模板下,可以按商家授权的一级类目或商品ID或商品名称搜索已经添加到该推荐模板下的商品。 https://www.kaitao.cn/article/7870.htm
13.淘口令解析如何获取商品ID吾爱破解跪求论坛大佬能提供一个有效的解析淘口令的方法,获取商品id就行,但是不想通过第三方(如大淘客、订单侠...https://www.52pojie.cn/thread-1432204-1-1.html
14.跟京东规则相关的客服测试题答案:拒绝告知消费者购买人的任何信息,并且让消费者登录购买 ID 的旺旺来咨询。 6、小丽是一家天猫店铺的客服,消费者咨询小丽购买的商品是否可以开发票,小丽发现店铺里本月的发票已经用完了,次月十日才能领取到新发票,小丽应该如何告知消费者? 答案:如实告知消费者,发票已经使用完,下月十号领取到发票会开好免费快递...https://www.mmker.cn/article/6087.html
15.国际贸易法视域下的人工智能规制三、人工智能给世界贸易组织规制带来的挑战(一) 加剧世界贸易组织“商品-服务”二分法困境 WTO遵循传统的商品-服务二分法对贸易进行分类,其中《关税与贸易总协定》(General Agreement on Tariffs and Trade, GATT)规制货物贸易,GATS规制跨境交付、境外消费、商业存在、自然人流动这四种模式下的服务贸易。此种区分很重要,...https://qks.shufe.edu.cn/mv_html/j00003/202302/5c3fc2b2-df6a-4e0e-954b-23da189e6289_WEB.htm
16.封装业务流程(PBP)HAP在定位具体商品的库存记录时,需要使用传递进来的商品ID,获取单条数据节点中的条件值选择输入参数即可。其他节点不再赘述。 1.5配置输出参数? 前面我们已经梳理好,无需输出参数,点击输出参数节点后、删除空白参数并保存节点。1.6修改流程名称并发布? 修改流程名称,便于日常管理和方便外部流程调用时识别, 发布流程后,...https://help.mingdao.com/workflow/pbp/