# 商品中心模块

API域名以及签名统一签名

全局响应参数:

参数名称	数据类型	参数说明
code	Integer	0:成功其他失败
data	Object	返回数据
message	String	错误信息

# 班牛商品信息查询

（1）接口地址:/product/query

（2）请求方式:POST

（3）请求数据类型:application/json

（4）响应数据类型:application/json

（5）请求参数:

参数名称	数据类型	是否必须	参数说明
productCode	String	false	商品编码
skuCode	String	false	SKU编码

（6）请求示例:

{
  "productCode": "KZH007-32A",
  "skuCode": "6941428606747"
}

（7）响应参数:

参数名称	数据类型	参数说明
code	Integer	0:成功其他失败
data	List	商品信息列表
└ imgUrl	String	商品图片
└ isEnable	Integer	商品状态是否可用(0:否，1:是)
└ productCode	String	商品编码
└ productName	String	商品名称
└ sellingPrice	BigDecimal	销售价/元
└ skuCode	String	SKU编码
└ skuName	String	SKU名称
└ type	String	商品类型
message	String	错误信息

（8）响应示例:

{
  "code": 0,
  "data": [
    {
      "productCode": "KZH007-32A",
      "productName": "Bc Babycare动物乐队拉拉裤",
      "type": null,
      "imgUrl": null,
      "skuCode": "6941428606747",
      "skuName": "正装-L码-32片/包",
      "isEnable": 1,
      "sellingPrice": 10
    }
  ],
  "message": null
}

# 供应商数据全量保存

（1）接口地址:/supplier/saveSupplierData

（2）请求方式:POST

（3）请求数据类型:application/json

（4）响应数据类型:application/json

（5）请求参数:

参数名称	数据类型	是否必须	参数说明
saveSupplier	Object	false	供应商基础数据
└ admissionType	String	false	准入属性
└ brand	String	false	自有品牌
└ buildDate	String	false	成立日期
└ businessScope	String	false	经营范围，多个逗号分割
└ companyEnglishName	String	false	英文名称
└ companyName	String	true	公司名称
└ companyNum	String	true	公司编码
└ companyTypeCode	String	false	公司类型
└ companyTypeName	String	false	公司类型含义
└ coveringArea	BigDecimal	false	仓储面积/平方米
└ domesticForeignRelation	String	true	境内外关系 domestic:境内 foreign:境外
└ employeeNumbers	Integer	false	员工数量
└ isListing	Integer	false	是否上市 1:是 0:否
└ legalRepName	String	false	法人姓名
└ licenceEndDate	String	false	营业期限长期二十年三十年
└ operationQuality	String	false	经营性质含义
└ operationQualityCode	String	true	经营性质
└ propertyRightsCode	String	false	厂房产权性质
└ propertyRightsName	String	false	厂房产权性质含义
└ proposedProducts	String	false	拟合作产品
└ registeredAddress	String	false	注册地址
└ registeredCapital	BigDecimal	false	注册资本(万)
└ sourceType	String	true	来源 SRM
└ stageDescription	String	false	生命周期描述
└ status	String	false	状态 recommend:推荐 potential:潜在 qualified:合格 demote:降级 eliminate:淘汰
└ supplierCode	String	true	供应商编码
└ supplierName	String	true	供应商名称
└ supplierSuperCompany	String	false	一级供应商
└ supplierSuperType	String	false	供应商级别
└ totalPlantArea	BigDecimal	false	仓房总面积/平方米
└ unifiedSocialCode	String	false	统一社会信用代码
saveSupplierAbilityList	List	false	供应商供应能力表
└ adaptiveItem	String	false	适配产品
└ attachExpiryDate	String	false	附件到期日期
└ attachUrls	String	false	附件url 多个逗号分割
└ effectiveDateEnd	String	false	有效期结束
└ effectiveDateStart	String	false	有效期开始
└ enableSupply	Integer	false	是否可供 1:可供 0:不可供
└ isApprove	Integer	false	是否需要特殊审批 1:需要 0:不需要
└ itemCategoryCode	String	true	品类代码
└ itemCategoryName	String	true	品类名称
└ itemCode	String	false	物料编码
└ itemName	String	false	物料名称
└ rebateCondition	String	false	返利条件
└ rebateRate	BigDecimal	false	返利比例
└ rebateStandard	String	false	返利标准
└ serveCity	String	false	服务城市
└ serveCountry	String	false	服务国家
└ serveRegion	String	false	服务地区
└ strategicProcurement	String	false	战略采购
└ supplierCode	String	true	供应商编码
saveSupplierAddressList	List	false	供应商地址信息表
└ addressDetail	String	true	详细地址
└ addressTypeCode	String	false	地址类别
└ addressTypeName	String	false	地址类别含义
└ city	String	false	市
└ cityId	String	false	市id
└ country	String	false	国家含义
└ countryId	String	false	国家id
└ postCode	String	false	邮政编码
└ province	String	false	省
└ provinceId	String	false	省id
└ region	String	false	区
└ regionId	String	false	区id
└ supplierCode	String	true	供应商编码
saveSupplierBankAccountList	List	false	供应商银行账户表
└ bankAccountName	String	true	账户名称
└ bankAccountNum	String	true	银行账户
└ bankBranchName	String	true	开户行名称
└ bankCode	String	true	银行编码
└ bankFirm	String	true	联行行号
└ bankName	String	true	银行名称
└ countryName	String	true	国家/地区
└ enabledFlag	Integer	true	状态 1:启用 0:禁用
└ masterFlag	Integer	true	是否主账户 1:是 0:不是
└ supplierCode	String	true	供应商编码
saveSupplierCategoryRelList	List	false	供应商关联分类表
└ categoryCode	String	true	分类编码
└ categoryDescription	String	true	分类描述
└ enabledFlag	Integer	true	状态 1:启用 0:禁用
└ supplierCode	String	true	供应商编码
saveSupplierContactList	List	false	供应商联系人表
└ contactName	String	true	联系人姓名
└ contactType	String	false	联系人类型
└ department	String	false	部门
└ email	String	false	联系人邮箱
└ enabledFlag	Integer	false	是否启用 1:是 0:否
└ idNum	String	false	证件号码
└ idType	String	false	证件类型
└ isDefault	Integer	false	是否默认联系人 1:是 0:否
└ mobilePhone	String	false	联系人电话
└ position	String	false	职位
└ supplierCode	String	true	供应商编码
saveSupplierCustomerList	List	false	供应商客户表
└ customerName	String	true	客户名
└ mainOemBrand	String	false	主要代工品牌
└ supplierCode	String	true	供应商编码
└ tradingVolumePerYear	String	false	交易量/年
└ turnoverPerYear	BigDecimal	false	交易额/年万元
saveSupplierEquipmentList	List	false	供应商设备表
└ capacityPerDay	String	false	产能/天
└ equipmentName	String	true	设备名称
└ equipmentPype	String	true	设备类型
└ manufacturer	String	false	生产厂家
└ quantity	Integer	false	数量
└ specificationType	String	false	型号规格
└ supplierCode	String	true	供应商编码
saveSupplierExtend	Object	false	供应商扩展预留
└ businessNumbers	Integer	false	营销/业务人员数量
└ developNumbers	Integer	false	研发人员数量
└ ext1 ~ ext15	String	false	预留字段1~15
└ orgAttachUrl	String	false	组织架构附件url
└ plannerNumbers	Integer	false	计划人员数量
└ productionNumbers	Integer	false	生产人员数量
└ purchaseNumbers	Integer	false	采购人员数量
└ qualityControlNumbers	Integer	false	品控人员数量
└ supplierCode	String	true	供应商编码
└ warehousemanNumbers	Integer	false	仓储人员数量
saveSupplierFinancialConditionList	List	false	供应商财务状况表
└ conditionYear	String	true	年份如:2022
└ currencyCode	String	false	币种
└ currencyName	String	false	币种含义
└ currentAssets	BigDecimal	false	流动资产(万)
└ currentLiabilities	BigDecimal	false	流动负债(万)
└ netProfit	BigDecimal	false	净利润(万)
└ revenue	BigDecimal	false	营业收入(万)
└ supplierCode	String	true	供应商编码
└ totalAssets	BigDecimal	false	企业总资产(万)
└ totalEquipmentAssets	BigDecimal	false	设备资产总额(万)
└ totalFixedAssets	BigDecimal	false	固定资产总额(万)
└ totalLiabilities	BigDecimal	false	企业总负债(万)
saveSupplierProductServiceList	List	false	供应商产品服务表
└ annualOutput	String	false	年产量
└ productCycle	String	false	生产周期
└ productModel	String	true	产品名称
└ productProcessTime	String	false	生产工序及耗时
└ supplierCode	String	true	供应商编码
saveSupplierQualificationList	List	false	供应商资质表
└ attachUrls	String	false	附件url 多个逗号分割
└ authenticationCode	String	true	认证编号
└ authenticationDate	String	false	认证时间
└ authenticationDesc	String	false	认证描述
└ authenticationType	String	false	认证类型
└ certificationAuthority	String	false	认证机构
└ expirationDate	String	false	证件到期日
└ supplierCode	String	true	供应商编码
saveSupplierSettle	Object	false	供应商结算信息表
└ afterSalesTerms	String	false	售后条款
└ depositPrepaymentRatio	BigDecimal	false	定金预付比例
└ payAfterDeliveryRatio	BigDecimal	false	到货后付款比例
└ paymentBilling	String	false	付款及开票
└ paymentOfTheBalanceDepositRatio	BigDecimal	false	尾款质押金付款比例
└ paymentType	String	false	付款类型
└ paymentTypeName	String	false	付款类型含义
└ prepaymentRatioBeforeShipment	BigDecimal	false	发货前预付比例
└ settlementCurrencyType	Integer	false	供应商结算币种
└ supplierBusinessCategory	String	false	供应商业务类别
└ supplierCode	String	true	供应商编码
└ supplierSettlementDate	String	false	供应商结款日
└ unifiedSocialCreditCode	String	false	原统一社会信用代码

（6）请求示例:

{
  "saveSupplier": {
    "admissionType": "",
    "brand": "",
    "buildDate": "",
    "businessScope": "",
    "companyEnglishName": "",
    "companyName": "",
    "companyNum": "",
    "companyTypeCode": "",
    "companyTypeName": "",
    "coveringArea": 0,
    "domesticForeignRelation": "",
    "employeeNumbers": 0,
    "isListing": 0,
    "legalRepName": "",
    "licenceEndDate": "",
    "operationQuality": "",
    "operationQualityCode": "",
    "propertyRightsCode": "",
    "propertyRightsName": "",
    "proposedProducts": "",
    "registeredAddress": "",
    "registeredCapital": 0,
    "sourceType": "",
    "stageDescription": "",
    "status": "",
    "supplierCode": "",
    "supplierName": "",
    "supplierSuperCompany": "",
    "supplierSuperType": "",
    "totalPlantArea": 0,
    "unifiedSocialCode": ""
  },
  "saveSupplierAbilityList": [
    {
      "adaptiveItem": "",
      "attachExpiryDate": "",
      "attachUrls": "",
      "effectiveDateEnd": "",
      "effectiveDateStart": "",
      "enableSupply": 0,
      "isApprove": 0,
      "itemCategoryCode": "",
      "itemCategoryName": "",
      "itemCode": "",
      "itemName": "",
      "rebateCondition": "",
      "rebateRate": 0,
      "rebateStandard": "",
      "serveCity": "",
      "serveCountry": "",
      "serveRegion": "",
      "strategicProcurement": "",
      "supplierCode": ""
    }
  ],
  "saveSupplierAddressList": [
    {
      "addressDetail": "",
      "addressTypeCode": "",
      "addressTypeName": "",
      "city": "",
      "cityId": "",
      "country": "",
      "countryId": "",
      "postCode": "",
      "province": "",
      "provinceId": "",
      "region": "",
      "regionId": "",
      "supplierCode": ""
    }
  ],
  "saveSupplierBankAccountList": [
    {
      "bankAccountName": "",
      "bankAccountNum": "",
      "bankBranchName": "",
      "bankCode": "",
      "bankFirm": "",
      "bankName": "",
      "countryName": "",
      "enabledFlag": 0,
      "masterFlag": 0,
      "supplierCode": ""
    }
  ],
  "saveSupplierCategoryRelList": [
    {
      "categoryCode": "",
      "categoryDescription": "",
      "enabledFlag": 0,
      "supplierCode": ""
    }
  ],
  "saveSupplierContactList": [
    {
      "contactName": "",
      "contactType": "",
      "department": "",
      "email": "",
      "enabledFlag": 0,
      "idNum": "",
      "idType": "",
      "isDefault": 0,
      "mobilePhone": "",
      "position": "",
      "supplierCode": ""
    }
  ],
  "saveSupplierCustomerList": [
    {
      "customerName": "",
      "mainOemBrand": "",
      "supplierCode": "",
      "tradingVolumePerYear": "",
      "turnoverPerYear": 0
    }
  ],
  "saveSupplierEquipmentList": [
    {
      "capacityPerDay": "",
      "equipmentName": "",
      "equipmentPype": "",
      "manufacturer": "",
      "quantity": 0,
      "specificationType": "",
      "supplierCode": ""
    }
  ],
  "saveSupplierExtend": {
    "businessNumbers": 0,
    "developNumbers": 0,
    "ext1": "",
    "ext10": "",
    "ext11": "",
    "ext12": "",
    "ext13": "",
    "ext14": "",
    "ext15": "",
    "ext2": "",
    "ext3": "",
    "ext4": "",
    "ext5": "",
    "ext6": "",
    "ext7": "",
    "ext8": "",
    "ext9": "",
    "orgAttachUrl": "",
    "plannerNumbers": 0,
    "productionNumbers": 0,
    "purchaseNumbers": 0,
    "qualityControlNumbers": 0,
    "supplierCode": "",
    "warehousemanNumbers": 0
  },
  "saveSupplierFinancialConditionList": [
    {
      "conditionYear": "",
      "currencyCode": "",
      "currencyName": "",
      "currentAssets": 0,
      "currentLiabilities": 0,
      "netProfit": 0,
      "revenue": 0,
      "supplierCode": "",
      "totalAssets": 0,
      "totalEquipmentAssets": 0,
      "totalFixedAssets": 0,
      "totalLiabilities": 0
    }
  ],
  "saveSupplierProductServiceList": [
    {
      "annualOutput": "",
      "productCycle": "",
      "productModel": "",
      "productProcessTime": "",
      "supplierCode": ""
    }
  ],
  "saveSupplierQualificationList": [
    {
      "attachUrls": "",
      "authenticationCode": "",
      "authenticationDate": "",
      "authenticationDesc": "",
      "authenticationType": "",
      "certificationAuthority": "",
      "expirationDate": "",
      "supplierCode": ""
    }
  ],
  "saveSupplierSettle": {
    "afterSalesTerms": "",
    "depositPrepaymentRatio": 0,
    "payAfterDeliveryRatio": 0,
    "paymentBilling": "",
    "paymentOfTheBalanceDepositRatio": 0,
    "paymentType": "",
    "paymentTypeName": "",
    "prepaymentRatioBeforeShipment": 0,
    "settlementCurrencyType": 0,
    "supplierBusinessCategory": "",
    "supplierCode": "",
    "supplierSettlementDate": "",
    "unifiedSocialCreditCode": ""
  }
}

（7）响应参数:

参数名称	数据类型	参数说明
code	Integer	0:成功其他失败
data	String	返回数据
message	String	错误信息

（8）响应示例:

{
  "code": 0,
  "data": "",
  "message": ""
}

SDK调用示例:

BcClient defaultClient = new DefaultClient("https://openapi-test.babycare.com/api/gateway", appKey, appSecret);
SupplierDataRequest supplierDataRequest = new SupplierDataRequest();
QueryResponse<NullResponse> execute = defaultClient.execute(supplierDataRequest);
System.out.println("=====" + execute.getData());

← 商品中台模块店铺主数据模块 →