商品同步(创建/更新) - iPaaS三方执行动作

特殊说明：该接口需保证幂等，执行异常时，上游会进行重试，可使用 itemNo 作为幂等键

请求参数

Body 参数application/json

rootKdtId

integer <int64>

有赞店铺总部Id

必需

appId

string

必需

应用厂商标识appId

globalProps

object (Map«Object»)

全局变量

必需

key

object (key)

可选

extendMap

object (Map«Object»)

必需

上下文扩展信息，透传信息key

key

object (key)

可选

outStoreId

string

可选

当前处理的三方店铺编码

kdtId

integer

必需

itemId

integer <int64>

必需

有赞商品id（总部商品id）

itemNo

string

可选

商品编码，有赞三方公用
连锁L情况不为空

itemBarCode

string

可选

三方商品条码 (如69开头的国标码)

title

string

商品名称

必需

desc

string

商品描述

可选

summary

string

商品分享时的描述

可选

createdTime

string <date-time>

商品创建时间

必需

itemType

enum<integer>

必需

商品类型： 0—普通商品 3—UMP降价拍 5—外卖商品 10—分销商品 20—会员卡商品 21—礼品卡商品 22—团购券
25—批发商品 30—收银台商品 31—知识付费商品 35—酒店商品 40—美业商品 60—虚拟商品 61—电子卡券

枚举值:

joinLevelDiscount

boolean

必需

是否参加会员折扣，true—支持，false—不支持，默认为true

status

integer

必需

状态
默认为下架状态
1：销售中，0：下架

images

array[object (ImageInfo) {3}]

商品图片

可选

imageMode

enum<string>

必需

图片配置模式(固定为url)

枚举值:

URLBASE64

yzImageId

integer <int64>

有赞对应的图片id

必需

yzImageUrl

string

三赞对应的URL

必需

publishChannelTypeList

array[integer]

可选

商品售卖的渠道（连锁店铺特有属性）

枚举值:

price

integer <int64>

无规格商品价格

可选

firstSkuPropImgInfo

object (FirstSkuPropImg)

可选

首组规格以及对应的图片

propName

string

规格名

可选

propValueImg

object (Map«ImageInfo»)

可选

key:规格值
value:图片

itemSkuList

array[object (ItemSku) {6}]

商品sku信息

可选

skuId

integer <int64>

有赞skuId

必需

skuNo

string

可选

商品规格编码，该属性如存在则内外部属性值应该保持一致

outSkuId

string

可选

三方skuId 更新时有值

skuBarCode

string

sku条码

可选

price

integer <int64>

sku价格（分）

必需

skuPropInfoList

array[object (SkuPropInfo) {2}]

必需

规格属性值
比如，这个商品有两个规格属性颜色、型号，颜色有红色、黑色，型号有L、XL
那么sku需要满足两个规格属性值的笛卡尔积（既是红L、红XL、黑L、黑XL）
注意：
1、如果所传sku不满足，规格值的笛卡尔积，接口会报错
2、如果已经设置了两个属性项，则sku不能使用其他属性项

deliverySettingInfo

object (DeliverySetting)

物流设置

可选

express

boolean

可选

是否支持快递发货，true-支持，false-不支持，不设置默认为不支持

cityDelivery

boolean

可选

是否支持同城配送，true-支持，false-不支持，不设置默认为不支持

selfPick

boolean

可选

是否支持到店自提，true-支持，false-不支持，不设置默认为不支持

tagIds

array[integer]

可选

商品分组列表即商品标签Id列表

postage

integer <int64>

运费，单位：分

必需

event

enum<string>

商品事件

必需

枚举值:

CREATEUPDATE

outItemId

string

三方商品id

可选

示例

{
    "rootKdtId": 0,
    "appId": "string",
    "globalProps": {
        "key": {}
    },
    "extendMap": {
        "key": {}
    },
    "outStoreId": "string",
    "kdtId": 0,
    "itemId": 0,
    "itemNo": "string",
    "itemBarCode": "string",
    "title": "string",
    "desc": "string",
    "summary": "string",
    "createdTime": "2019-08-24T14:15:22Z",
    "itemType": 0,
    "joinLevelDiscount": true,
    "status": 0,
    "images": [
        {
            "imageMode": "URL",
            "yzImageId": 0,
            "yzImageUrl": "string"
        }
    ],
    "publishChannelTypeList": [
        0
    ],
    "price": 0,
    "firstSkuPropImgInfo": {
        "propName": "string",
        "propValueImg": {
            "key": {
                "imageMode": "URL",
                "yzImageId": 0,
                "yzImageUrl": "string"
            }
        }
    },
    "itemSkuList": [
        {
            "skuId": 0,
            "skuNo": "string",
            "outSkuId": "string",
            "skuBarCode": "string",
            "price": 0,
            "skuPropInfoList": [
                {
                    "propValueName": "string",
                    "propName": "string"
                }
            ]
        }
    ],
    "deliverySettingInfo": {
        "express": true,
        "cityDelivery": true,
        "selfPick": true
    },
    "tagIds": [
        0
    ],
    "postage": 0,
    "event": "CREATE",
    "outItemId": "string"
}

返回响应

🟢200成功

application/json

Body

success

boolean

可选

标识本次调用是否返回

code

integer

可选

本次调用返回code，一般为错误代码

message

string

可选

本次调用返回的消息，一般为错误消息

requestId

string

请求Id

可选

errorData

object (Map«Object»)

调用失败返回的数据

可选

key

object (key)

可选

data

object (ItemSyncExtResponse)

调用返回的数据

可选

outItemId

string

三方商品id

必需

itemNo

string

必需

商品编码，有赞三方公用

itemSkuList

array[object (ItemSku) {4}]

sku 信息

可选

示例

{
  "success": false,
  "code": 0,
  "message": "",
  "requestId": "",
  "errorData": {
    "": {}
  },
  "data": {
    "outItemId": "",
    "itemNo": "",
    "itemSkuList": [
      {
        "skuId": 0,
        "skuNo": "",
        "outSkuId": "",
        "skuBarCode": ""
      }
    ]
  }
}