开放业务&解决方案
商品中心2.0接入
更新时间：2020/03/11
访问次数：3817
TOP网关接口开发(前言)
调用接口首先需要注册成为开发者，具体可以参考接入指南,在该页面中可以了解接口的原理，下载SDK包和如何调用等内容。对接入流程的了解请打开http://hema.open.taobao.com/doc#?docType=1&docId=107425
阿里这边主要分如下3个运行环境，商家接入的时候需要有个对应，一般对接先从日常环境开始。
1）日常环境（沙箱环境）：用来做日常的开发连调测试。
2）预发环境：该环境是准线上环境，和线上环境是同一套环境。只是用的是测试的商家和测试的门店信息，用来模拟线上的环境。
3）线上环境（生产环境）：真正运行业务的环境。
对接商品之前先了解一些商家类目，商家类目的接口用有4个
类目是人为对商品的分类，这里说的商家类目指的是商户自己建立的商品后台类目。类目的作用是可以帮助商家根据类目来管理商品，比如数据报表，促销活动等。
商家类目使用的接口有4个，分别是增删改查
商家类目新增接口： alibaba.wdk.sku.category.add
商家类目修改接口： alibaba.wdk.sku.category.update
商家类目删除接口： alibaba.wdk.sku.category.delete
商家类目查询接口： alibaba.wdk.sku.category.query
类目新增之后除了用接口可以查询，还可以在ReX中台protal页面中查看。
类目的使用相对简单，需要注意的是
-
如果商品中想使用类目，必须要先新建类目。如果不想使用商家类目，请联系ReX运营同学关闭商家类目功能。
-
新增类目的时候需要先新增父类目，然后新增该父类目的子类目。删除类目需要先删除类目下的子类目，然后删除该类目。如果类目下存在商品，会删除失败。
-
如果类目设置为禁用，则该类目不能新建商品，但是该类目下已经存在的商品不受影响。
-
因为缓存的原因，类目的新增和修改不是立即生效，需要第二天生效（如果修改类目名称等不影响类目id的操作，是不影响商品操作的；如果是新增类目，着急使用，可以联系技术同学处理）。
-
当前对类目层数有5层限制，对类目数量没有限制。
本次重点： 商品接入接口简化升级，升级后的商品接口为2.0版
2.0版对接商品用到的接口主要有3个
商品新增接口：alibaba.wdk.sku.add
商品更新接口：alibaba.wdk.sku.update
商品查询接口：alibaba.wdk.sku.query
下面分别描述这3个接口的具体使用，遇到疑惑请先看后面的常见问题描述。
1、商品新增接口：alibaba.wdk.sku.add
该接口用来新建主档商品门店商品，支持一品多码商品新建。如果没有新建主档商品，直接新建门店商品，系统会自动识别优先新建主档商品。该接口涉及字段较多，商家对接的时候可以根据业务选择需要的字段对接，有关对接字段的问题可以咨询ReX开放技术支持。
根据开发语言不通，根据需要下载最新的sdk包可。目前支持的语言有java、.net、php、python、metadata等。
页面顶部附件top.test.zip是给出的一份java版本的日常环境测试样例，新增更新和查询方法，方便开发者快速接入，代码仅供参考。
2、商品更新接口：alibaba.wdk.sku.update
该接口字段基本和新增接口一致，除了必要的skuCode和ouCode为必填字段之外，其他字段均为选填。调用的时候，请填写需要更新的字段即可，如果字段为空，认为是不修改该字段。
如果修改的门店信息ouCode字段为空，认为是修改所有门店（即主档商品信息）
3、商品查询接口：alibaba.wdk.sku.query
该接口返回商品的相关信息，测试的时候可以新建或者更新商品之后再查询获取商品信息。
注意点
1）商家ERP系统商品类目和ReX平台商品类目对应：商品新增中ReX平台类目字段是必填的。需要把商品的类目信息对应到ReX平台类目，该工作量相对较大较繁琐。盒马类目信息可以通过下面的接口获取。
ReX平台类目查询接口：//open.taobao.com/api.htm?docId=30649&docType=2
2）可能会用到的图片上传接口：//open.taobao.com/api.htm?docId=32686&docType=2
对接过程中遇到的疑惑问题
-
接口怎么区分接入商家？商家在调用接口的时候，接口能从接口session中获取到商家信息，不用填写商家信息。
-
什么是主档商品门店商品？主档和机构商品只是商品管理过程中为了方便管理而抽象的商品公共属性。主档商品是商品的所有公共属性，机构商品是地区范围内的商品公共属性。ReX平台商品系统中，主档商品概念正在弱化，商户可以不感知主档或者机构商品。
-
怎么新增主档商品？ 新增门店商品的时候，如果主档商品不存在，默认会先新增主档商品。如果主档商品已经存在，则保持主档商品不变，新建门店商品。
-
怎么修改主档商品？修改接口的时候，如果ouCodez字段不填写门店信息，接口认为修改的是主档商品，并且会把主档商品的修改同步到各个门店。
-
什么查询主档商品？目前没有专门查询主档商品的接口，只能根据门店来查询商品信息。
-
如果有多个门店，是不是每个门店都要创建商品？ 是的，需要给每个门店上做创建操作。
-
怎么支持一品多码？商品新增和修改接口中”barcodes“字段可以填写多个条码信息，条码之间用英文半角逗号分割。
-
怎么修改门店价格信息？ 调用修改接口的时候，添加必要的商品skuCode，门店ouCode，和字段salePrice。
-
怎么获取ReX平台类目信息？ 通过接口 alibaba.wdk.item.category.query //open.taobao.com/api.htm?docId=30649&docType=2 可以查询ReX平台整个类目树信息。
-
商品中品牌怎么管理？ 商品中品牌的信息只是一个附属的字段，目前没有对品牌字段丛约束和管理。
商品主档属性字段
|
字段名称
|
字段含义
|
|
skuName
|
商品名称
|
|
shortTitle
|
商品简称
|
|
detailPicUrls
|
图片信息
|
|
mainPicUrls
|
主图URL
|
|
txtDesc
|
文描
|
|
aliasName
|
商品别名
|
|
producerPlace
|
商品产地
|
|
hmCategoryCode |
ReX平台商品类目
|
|
forestCateId
|
forest类目
|
|
length
|
长度(深) length
|
|
width
|
宽度（宽）
|
|
height
|
高度（高）
|
|
producerName
|
生产商
|
|
producerAddress
|
生产商地址
|
|
productCode
|
产品标准号
|
|
factoryNo
|
厂方货号
|
|
weightFlag
|
是否称重
|
|
weight
|
单品重量
|
|
component
|
成份
|
|
netContent
|
净含量
|
|
importFlag
|
是否进口
|
|
storage
|
存储条件
|
|
eatWay
|
食用方法
|
|
brandName
|
品牌名称
|
|
inputTaxRate
|
商品进项税率
|
|
inputInvoiceContent
|
商品进项税率描述
|
|
accountingCategory
|
财务核算分类
|
|
taxRate
|
商品销项税率
|
|
invoiceContent
|
商品销项税率描述
|
|
shelfLife
|
保质天数
|
