已更新更新时间：2024-11-25 15:23:04文档更新记录 >配置项检测工具收藏订阅更新我的文档设置接入检测（即可查看检测结果）若有未通过的接入检测项，接口将无法调通去登录返回文档完成 接入准备 后，商家和服务商可根据本文指引快速集成 小程序商品。说明：●小程序商品 仅支持自研商家/服务商通过 自研应用 或 第三方应用 代调用（传入 app_auth_token）方式，调用 api 接入。●小程序商品 支持沙箱调试。接入步骤类目查询接口商家可通过 alipay.open.app.item.allcategory.query（获取普通商品类目接口）查询可以使用的商品类目信息，后续创建以及修改商品的时候都需要使用类目信息。注意●类目信息决定了商品入库时需要填写的字段信息，以及后续商品交易相关数据，请正确填写。商品类目预测预咨询接口商家需要提前将商品名称信息通过 ，同步到支付宝体系（支付宝会储存链接并进行采集算法计算），此采集工作平均为 2 分钟左右。商品类目预测咨询接口商家需要获取类目的预测结果时，可使用之前同步过的链接作为请求参数，通过alipay.open.app.item.category.consult（商品类目预测咨询接口） 获取算法预测类目结果。预测返回结果有以下几种：●推荐的类目可用。●推荐类目不在该商品类型内，建议您创建付费充值/兑换类（虚拟）或售卖类（实物）商品。●推荐的类目，商家不拥有该类目资质（未开通、审核中、审核驳回），资质未开通，可 查看类目申请信息。说明：●如果您上传的商品为电商类型的商品，则请求参数 item_type 为：售卖类（实物）: 1。●响应参数中，如果算法预测出类目结果（如黄金），该小程序无该类目的提报权限，则返回类目不可用原因。 例如：无权限；无行业白名单邀约；资质未开通；资质已开通；资质审核中；资质审核驳回；未查询到类目。请前往 商家平台/服务商平台 开通对应的类目资质。获取普通商品模板信息接口商家可通过 获取不同类目下需要添加的个性化属性信息，接口里面的类目 id 编码是从 alipay.open.app.item.allcategory.query（获取普通商品类目接口）中获取到的。注意●不同类目以及不同商品类型，对应的个性化属性及其校验规则是不一样的，需要动态实时查询。创建商品接口商家可通过 alipay.open.app.item.create（小程序商品创建接口） 向支付宝提报小程序内的商品详情页。创建成功后支付宝会返回支付宝平台侧商品id作为该商品的支付宝全局唯一商品编码供后续使用。 注意●需保证商品的商家侧商品id在该小程序下的唯一性。●商品 spu 下的 sku 信息为非必填，如果商品下没有 sku 信息，则 spu 的库存以及售卖状态需要单独设置，如果有 sku，则 spu 库存以及售卖状态是通过商品下的 sku 的库存以及售卖状态计算得出来的，具体计算规则：○可售卖：只要有一个 sku 的售卖状态是可售卖，则 spu 的售卖状态为可售卖。○已下架：当所有商品的售卖状态是已下架，则 spu 的售卖状态为已下架。○库存：spu 库存为所有 sku 库存之和。商品创建多规格商品创建查询商品接口商家可通过 alipay.open.app.item.query（小程序商品详情查询接口）使用上传商家侧商品id，或是返回的支付宝平台侧商品id查询已经创建的商品信息。注意●商品查询需要传入创建时返回的支付宝平台侧商品id，或者商家侧商品id，两者不可同时为空。●商品创建完成后通过审核，所以首次提交的商品在审核结果未出前，需要设置 need_edit_spu=1 才能查询到。批量查询商品接口商家可通过 alipay.open.app.item.list.query（小程序商品分页查询接口），通过上传商家侧id列表，或是返回的平台侧商品id列表查询已经创建的商品信息。注意●商品查询需要传入创建时返回的平台侧商品id列表，或者商户自己的唯一商家侧id列表，两者不可同时为空，不可以混传。●该接口只能查询生效中的商品详情，不能根据不同的 id 返回不同版本的数据。更新商品接口商家可使用 alipay.open.app.item.modify（小程序商品更新接口），通过上传商家侧商品id，或是返回的支付宝平台侧商品id查询已经创建的商品信息。注意●商品首先需要同步到支付宝侧后才能支持修改，如果商品已经有一个版本是在审核中了，这时候商品是不支持修改的。●如果只修改了商品的商品售卖状态、库存、价格（商品售价、商品原价），则不用进入审核流程。免审更新商品接口正常情况下，修改商品详情页的基础字段等信息都需要进行审核。商家可通过 alipay.open.app.item.direct.modify（商品免审更新接口）使用上传商家侧商品id，或是返回的支付宝平台侧商品id修改商品以及子 sku 的售卖状态、库存信息、价格。注意●商品首先需要同步到支付宝侧后才能支持状态修改，审核中的商品不支持修改。●可以通过该接口对 spu 以及下面的 sku 售卖状态同时进行修改。删除商品接口商家可使用 alipay.open.app.item.delete（小程序商品移除接口），通过上传商家侧商品id列表，或是返回的支付宝平台侧商品id删除不需要的商品信息。注意●商品首先需要同步到支付宝侧后才能支持删除。●商品删除会将生效中的版本删除并从场景侧下线，并且删除是不可逆的，谨慎操作。商品状态变更消息通知商家/服务商可以监听 alipay.open.app.item.status.notify（商品状态变更消息同步接口），感知商品状态信息的变更。商品审核通过或驳回，以及后续商品售罄或冻结（违规/质量异常）均会通过本消息进行通知。注意1商品状态变更通知会在商品状态变更时发出，包括审核、售罄、冻结等操作生效之后发出。2变更推广计划通知仅包含简单的推广计划变更通知信息，更多商品信息需通过 alipay.open.app.item.query（小程序商品详情查询接口）获取。消息示例营销图片优化上传接口商家可以调用 alipay.marketing.image.enhance.upload（营销图片优化上传接口），指定上传场景对商品图进行规范校验、智能优化后再上传，将图片信息转存到支付宝侧进行使用，比如商品主子图等。
