API接口目录

政企业务

政企商品API
政企价格API
政企库存API
政企订单API
政企物流API
政企发票API
政企售后API
政企其他API
政企易企购API
政企抽检API
异常码自查工具
suning.govbus.message.get 查询消息
¥免费

通过此接口可根据消息类型查询消息(调用前需申请开启用户配置开关,否则返回消息数据为空)


消息返回实例:


一、 商品池消息(type=10)


        0-新增,1-上架,2-下架, 3-修改,4-删除,6-图片变更


        {“id”: xxxx,”type”:xxx,”cmmdtyCode”: ”xxxx”, “status”: “x”,”categoryId”: “70f7e2-c5a7-4”,”time”: “2017-10-11 12:59:00”}


二、订单消息 (type=11)


        1-实时创建成功, 2-预占成功, 3-确认预占,4-取消预占


        {“id”:xxxx,”type”:xxx,”orderNo”: “xxxx”, “status”: “x”,”time”: “2017-10-11 12:59:00”}


三:物流消息(type=12)


        1.商品出库,2.商品妥投,3.商品拒收,4.商品退货


        {“id”:xxxx,”type”:xxx,“orderNo”:“xxxx” ,” orderItemNo”:”xxx”, ”cmmdtyCode”:”xxx”,“status”: “x”,“time”: “2017-10-11 12:59:00”}


四:目录变更 (type=13)


        0-新增,1-修改,2-删除


        {“id”:xxxx,”type”:xxx,“oldcategoryId”: “xxxx”, “oldcategoryName”: “xxxx”,“categoryId”: “xxxx”,“categoryName”: “xxxx”,“status”: “x”,“time”: “2017-10-11 12:59:00”}


五:服务状态消息(type=14)


        1-待服务,2-服务完成,3-服务取消


        {“id”:xxxx,”type”:xxx,“orderNo”:“xxxx” ,” orderItemNo”:”xxx”, ”cmmdtyCode”:”xxx”,“status”: “x”,“time”: “2017-10-11 12:59:00”}

六:批量预占订单消息(type=15)


        1-批量预占订单


        {'id':100000453715,'type':15,'status':'1','time':'2021-11-09 10:29:18','reason':'数据处理完成','batchId':'batch1636424491344397','allCount':'3','failCount':'0','successCount':'3'}

七:支付状态 (type=16)


        1-已支付,2-订单已失效(系统自动取消),3-订单已取消(用户主动取消)        


        {“id”:xxxx,”type”:xxx,”orderNo”:”XXXX”,”status”:”X”,“time”: “2017-10-11 12:59:00”}


八:账单消息 (type=17)


        1-新增


        {“id”:xxxx,”type”:xxx,”time”:”2018-12-26 10:36:31”,”status”:”x”,”pin”:”xxxx”,”billid”:”xxxx”}


九:厂送商品退换货进度消息 (type=19)


       0-退换货待处理,7-同意退换货,8-不同意退换货,9-顾客寄货,10-同意退款/确认换货,11-拒绝退款/拒绝确认换货,14-换货已发货,15-退款完成/换货已收货,17-取消退换货


        {“id”:xxxx,”type”:xxx,“orderNo”:“xxxx” ,” orderItemNo”:”xxx”, ”cmmdtyCode”:”xxx”, “sheetId” :“xxxx”, “status”: “x”, “reason”: “x”, “time”: “2017-10-11 12:59:00”}


十:发票消息 (type=20)


        2为已开票、3为已邮寄、4为已妥投


        {'id':'XXXXX','orderNo':'100000100199','orderItemNo':'10000010019901','cmmdtyCode':'XXXXXXXXXX','status': '1','invoiceType': '1',' invoiceSign': '1','markId': 'XXXXXXXXX','type': '20'}


十一:订单结算状态(type=21)


        1-新增


        {'id':100000445178,'type':21,'cmmdtyCode':'121347xxx','status':'1','orderNo':'10000153xxxx','orderItemNo':'1000015391xxxx','time':'2020-01-22 14:03:56'}


十二:补开发票校验状态(type=22)


         1为受理通过开票中、2为受理未通过


        {'id':100000445178,'type':22,'status':'1','time':'2020-01-22 14:03:56','reason':'开票成功','invoiceType':'2','markId':'157967302426578'}


十三:包裹物流(type=18) (定制服务消息,普通用户无此类型)


         1为包裹出库、2为包裹妥投


        {'orderNo':'100001417860','status':'1','logisticNumber':'0011314262450201'}


十四:地址变更(type=25)


        1为地址新增、2为地址删除、3为地址修改


        {'id':100000445178,'type':25,'status':'1','time':'2020-01-22 14:03:56','reason':'玄武区地址发生变动','level':'4','oldCode':'01','newCode':'02','oldName':'玄武区','newName':'玄武新区','provCode':'100','cityCode':'025','districtCode':'01'}


十四:线下客服退货通知(type=28)

      

        1已退货、2已退款

     

        {“id”:xxxx,”type”:xxx,“orderNo”:“xxxx” ,” orderItemNo”:”xxx”, ”cmmdtyCode”:”xxx”, “status”: “x” “time”: “2017-10-11 12:59:00”}



公共参数
请求参数
名称 类型 是否必须 示例值 描述
typeStringY10消息类型:10-商品池 上架、下架、添加、删除、修改 、主图变更 11-订单 实时创建、预占成功、确认预占、取消预占、异常订单取消 12-物流 商品出库、商品妥投、商品拒收、商品退货 13-目录 添加、修改、删除 14-服务状态 待服务、服务完成、服务取消 16-支付状态 已支付、订单已取消、订单已失效 17-对账 新建账单 19-售后进度
响应参数
名称 类型 示例值 描述
resultInfoString
cmmdtyCodeString121347582商品编码
idString100消息id
orderItemNoString2022505004订单行号
orderNoString100000100199订单号
statusString1消息状态
typeString10消息类型:10-商品池 上架、下架、添加、删除、修改 、主图变更 11-订单 实时创建、预占成功、确认预占、取消预占、异常订单取消 12-物流 商品出库、商品妥投、商品拒收、商品退货 13-目录 添加、修改、删除 14-服务状态 待服务、服务完成、服务取消 16-支付状态 已支付、订单已取消、订单已失效 17-对账 新建账单 19-售后进度
pinStringceshi0807@07.com账号名称
billidString201812260030007378账单编号
logisticNumberString0050134594600101物流单号
timeString2017-10-11 12:59:00时间
sheetIdString20190520174300193303售后服务单号
invoiceTypeString1发票类型,1为增票,3位普票,4为电子发票
invoiceSignString1发票标识,1为蓝票,-1位红票
markIdString1234453245申请单号
reasonString扣款失败支付失败原因
oldcategoryIdStringxxxx修改前商品三级类目id
oldcategoryNameStringxxxx修改前商品三级类目名称
categoryIdStringxxxx商品三级类目id
categoryNameStringxxxx商品三级类目名称
oldCodeString01变更前地址编码(地址删除和地址修改)
oldNameString新街口街道变更前地址名称(地址删除和地址修改)
newCodeString01变更后地址编码(地址新增和地址修改)
newNameString新街口新街道变更后地址名称(地址新增和地址修改)
provCodeString200省编码
cityCodeString025市编码
districtCodeString01区编码
levelString4地址层级
请求示例
  • XML示例
  • JSON示例
复制全部代码
                                

<sn_request>
  <sn_body>
    <getMessage>
      <type>10</type>
    </getMessage>
  </sn_body>
</sn_request>

			
			
                                
                                

{
  "sn_request": {
    "sn_body": {
      "getMessage": {
        "type": "10"
      }
    }
  }
}
			
			
                                
响应示例
  • XML示例
  • JSON示例
复制全部代码
                              

<sn_responseContent>
  <sn_body>
    <getMessage>
      <resultInfo>
        <logisticNumber>0050134594600101</logisticNumber>
        <reason>扣款失败</reason>
        <districtCode>01</districtCode>
        <markId>1234453245</markId>
        <cityCode>025</cityCode>
        <cmmdtyCode>121347582</cmmdtyCode>
        <type>10</type>
        <categoryName>xxxx</categoryName>
        <invoiceSign>1</invoiceSign>
        <pin>ceshi0807@07.com</pin>
        <billid>201812260030007378</billid>
        <oldcategoryName>xxxx</oldcategoryName>
        <oldName>新街口街道</oldName>
        <invoiceType>1</invoiceType>
        <id>100</id>
        <newCode>01</newCode>
        <orderNo>100000100199</orderNo>
        <provCode>200</provCode>
        <level>4</level>
        <newName>新街口新街道</newName>
        <oldCode>01</oldCode>
        <orderItemNo>2022505004</orderItemNo>
        <sheetId>20190520174300193303</sheetId>
        <time>2017-10-11 12:59:00</time>
        <categoryId>xxxx</categoryId>
        <oldcategoryId>xxxx</oldcategoryId>
        <status>1</status>
      </resultInfo>
    </getMessage>
  </sn_body>
</sn_responseContent>

			
			
                              
                              

{
  "sn_responseContent": {
    "sn_body": {
      "getMessage": {
        "resultInfo": [
          {
            "logisticNumber": "0050134594600101",
            "reason": "扣款失败",
            "districtCode": "01",
            "markId": "1234453245",
            "cityCode": "025",
            "cmmdtyCode": "121347582",
            "type": "10",
            "categoryName": "xxxx",
            "invoiceSign": "1",
            "pin": "ceshi0807@07.com",
            "billid": "201812260030007378",
            "oldcategoryName": "xxxx",
            "oldName": "新街口街道",
            "invoiceType": "1",
            "id": "100",
            "newCode": "01",
            "orderNo": "100000100199",
            "provCode": "200",
            "level": "4",
            "newName": "新街口新街道",
            "oldCode": "01",
            "orderItemNo": "2022505004",
            "sheetId": "20190520174300193303",
            "time": "2017-10-11 12:59:00",
            "categoryId": "xxxx",
            "oldcategoryId": "xxxx",
            "status": "1"
          }
        ]
      }
    }
  }
}
			
			
                              
异常示例
  • XML示例
  • JSON示例
复制全部代码

  
  	API异常码
  	异常码中文描述
  

                           	  
{
  "sn_responseContent": {
    "sn_error": {
      "error_code": "API异常码",
      "error_msg": "异常码中文描述"
    }
  }
}
                           		
业务异常码
异常码 错误描述 解决方案
biz.handler.data-get:no-result 查询没结果 请检查查询参数
biz.govbus.getmessage.missing-parameter:* 缺少必填参数,*表示字段名 请输入正确参数。
isp.sys.service.unavailable.gcapi 服务不可用(系统异常) 请联系苏宁技术人员。
biz.govbus.getmessage.invalid-biz:100 输入报文格式错误 检查输入报文
biz.govbus.getmessage.invalid-biz:101 入参校验失败 检查输入参数
biz.govbus.getmessage.invalid-biz:102 会员编号错误 检查输入参数
公共异常码
API工具
FAQ