API接口目录

政企业务

政企商品API
政企价格API
政企库存API
政企订单API
政企物流API
政企发票API
政企售后API
政企其他API
政企易企购API
政企抽检API
异常码自查工具
suning.govbus.getspecialgoods.query 获取特殊商品池
¥免费

根据会员编号和商品定制目录:获取该定制目录下所有礼品卡等特定商品商品的编码(只考虑单品池),支持分页获取

特殊商品包括:电子储值卡、实体储值卡、电子提货卡、实体提货卡

该接口无法获取普通商品和套餐商品。

公共参数
请求参数
名称 类型 是否必须 示例值 描述
categoryIdStringY6670f7e2-c5a7-4122-a980-e213a6631f4f目录Id
pageNumStringN2当前页码 表示取第几页
pgSizeStringN100每页条数,最大值100,默认值100
响应参数
名称 类型 示例值 描述
resultInfoString
skuIdString121345089商品编码
generalSkuString121345088通码,具有相同通码的sku表示一组类似的商品数组
cmmdtyTypeString3商品类型 3:实体储值卡 4:电子储值卡5:实体提货卡 6:电子提货卡 7:普通服务商品
totalPageString2总页数
pageNumString2当前页数
productSumString200总个数
请求示例
  • XML示例
  • JSON示例
复制全部代码
                                <sn_request>
  <sn_body>
    <queryGetspecialgoods>
      <pgSize>100</pgSize>
      <pageNum>2</pageNum>
      <categoryId>6670f7e2-c5a7-4122-a980-e213a6631f4f</categoryId>
    </queryGetspecialgoods>
  </sn_body>
</sn_request>

                                
                                {
  "sn_request": {
    "sn_body": {
      "queryGetspecialgoods": {
        "pgSize": "100",
        "pageNum": "2",
        "categoryId": "6670f7e2-c5a7-4122-a980-e213a6631f4f"
      }
    }
  }
}
                                
响应示例
  • XML示例
  • JSON示例
复制全部代码
                              <sn_responseContent>
  <sn_body>
    <queryGetspecialgoods>
      <productSum>200</productSum>
      <totalPage>2</totalPage>
      <pageNum>2</pageNum>
      <resultInfo>
        <generalSku>121345088</generalSku>
        <cmmdtyType>3</cmmdtyType>
        <skuId>121345089</skuId>
      </resultInfo>
    </queryGetspecialgoods>
  </sn_body>
</sn_responseContent>

                              
                              {
  "sn_responseContent": {
    "sn_body": {
      "queryGetspecialgoods": {
        "productSum": "200",
        "totalPage": "2",
        "pageNum": "2",
        "resultInfo": [
          {
            "generalSku": "121345088",
            "cmmdtyType": "3",
            "skuId": "121345089"
          }
        ]
      }
    }
  }
}
                              
异常示例
  • XML示例
  • JSON示例
复制全部代码

  
  	API异常码
  	异常码中文描述
  

                           	  
{
  "sn_responseContent": {
    "sn_error": {
      "error_code": "API异常码",
      "error_msg": "异常码中文描述"
    }
  }
}
                           		
业务异常码
异常码 错误描述 解决方案
biz.govbus.querygetspecialgoods.missing-parameter:* 参数必填 请检查此参数的值,*号表示参数字段名
biz.handler.data-get:no-result 查询没结果 请检查查询参数
isp.sys.service.unavailable.gcapi 服务不可用 请联系苏宁技术人员
biz.govbus.querygetspecialgoods.invalid-biz:100 输入报文格式错误 检查输入报文
biz.govbus.querygetspecialgoods.invalid-biz:101 入参校验失败 检查输入参数
biz.govbus.querygetspecialgoods.invalid-biz:102 会员编号错误 检查输入参数
biz.govbus.querygetspecialgoods.invalid-biz:103 该目录下未配置商品 查看该目录下是否配置
biz.govbus.querygetspecialgoods.invalid-biz:100 接口调用异常 请联系苏宁技术人员
公共异常码
API工具
FAQ