退出
热词搜索：
API接口目录

云钻商城定制业务

云钻商城定制API
异常码自查工具
suning.cmall.pointgive.add 云钻发放
￥免费

云钻发放

公共参数
请求参数
名称 类型 是否必须 示例值 描述
custNumStringY6143457056会员编号
deviceIdStringNaafadfadf设备会话ID
ecoTypeStringY140000000010业态类型
invokerCodeStringYpptv调用方编码
orderStringN
accountTypeStringY8012账户类型
addAmtStringN11增加云钻量
branchStringY5006分公司
cmdtyBrandStringNadad商品品牌
cmdtyCatalogStringNaad商品品类
cmdtyCodeStringNadadd商品编码
cmdtyGroupStringNadaa商品组
cmdtyNameStringNaada商品名称
orderAmtStringN10订单金额
orderItemIdStringYA101602061818477844订单行号
orderTypeStringYDXHDT订单类型/单据类型编码
orderTypeDescStringNaaa订单类型描述/单据类型描述
storeStringY8371门店
supplierCodeStringN如果积分发放主体类型为209000000020时，此字段必填积分发放主体编码
supplierTypeStringY209000000020积分发放主体类型
orderIdStringNaaaaaa合并订单号
sceneCodeStringY场景编码PE1120
sceneTypeStringYPE1110场景类型编码
transIdStringYd7bb1090e11c4ab398b38ab75efa6e02交易ID
transTimestampStringY2016-05-06 18:18:47:691交易时间
响应参数
名称 类型 示例值 描述
errCodeString1错误码
errorDescStringaa错误描述
orderString
accountTypeString112账户类型
addAmtString1212订单发放量
errCodeString12错误码
errorDescString1212错误描述
isSuccStringY成功,N失败是否成功
orderItemIdString12121订单行号
orderIdString121212合并订单号
statusStringCOMPLETE代表服务成功； FAIL代表失败。服务状态
请求示例
  • XML示例
  • JSON示例
复制全部代码 
                                <sn_request>
  <sn_body>
    <addPointgive>
      <invokerCode>pptv</invokerCode>
      <custNum>6143457056</custNum>
      <order>
        <store>8371</store>
        <cmdtyName>aada</cmdtyName>
        <orderItemId>A101602061818477844</orderItemId>
        <orderType>DXHDT</orderType>
        <addAmt>11</addAmt>
        <cmdtyCode>adadd</cmdtyCode>
        <supplierCode>如果积分发放主体类型为209000000020时，此字段必填</supplierCode>
        <supplierType>209000000020</supplierType>
        <cmdtyBrand>adad</cmdtyBrand>
        <cmdtyCatalog>aad</cmdtyCatalog>
        <accountType>8012</accountType>
        <branch>5006</branch>
        <cmdtyGroup>adaa</cmdtyGroup>
        <orderAmt>10</orderAmt>
        <orderTypeDesc>aaa</orderTypeDesc>
      </order>
      <transId>d7bb1090e11c4ab398b38ab75efa6e02</transId>
      <sceneType>PE1110</sceneType>
      <ecoType>140000000010</ecoType>
      <transTimestamp>2016-05-06 18:18:47:691</transTimestamp>
      <sceneCode>场景编码</sceneCode>
      <orderId>aaaaaa</orderId>
      <deviceId>aafadfadf</deviceId>
    </addPointgive>
  </sn_body>
</sn_request>

                                
                                {
  "sn_request": {
    "sn_body": {
      "addPointgive": {
        "invokerCode": "pptv",
        "custNum": "6143457056",
        "order": {
          "supplierType": "209000000020",
          "cmdtyBrand": "adad",
          "store": "8371",
          "orderType": "DXHDT",
          "orderItemId": "A101602061818477844",
          "cmdtyName": "aada",
          "cmdtyCatalog": "aad",
          "cmdtyCode": "adadd",
          "addAmt": "11",
          "accountType": "8012",
          "branch": "5006",
          "supplierCode": "如果积分发放主体类型为209000000020时，此字段必填",
          "cmdtyGroup": "adaa",
          "orderAmt": "10",
          "orderTypeDesc": "aaa"
        },
        "transId": "d7bb1090e11c4ab398b38ab75efa6e02",
        "sceneType": "PE1110",
        "ecoType": "140000000010",
        "transTimestamp": "2016-05-06 18:18:47:691",
        "deviceId": "aafadfadf",
        "orderId": "aaaaaa",
        "sceneCode": "场景编码"
      }
    }
  }
}
响应示例
  • XML示例
  • JSON示例
复制全部代码 
                              <sn_responseContent>
  <sn_body>
    <addPointgive>
      <order>
        <orderItemId>12121</orderItemId>
        <errorDesc>1212</errorDesc>
        <addAmt>1212</addAmt>
        <errCode>12</errCode>
        <accountType>112</accountType>
        <isSucc>Y成功,N失败</isSucc>
      </order>
      <status>COMPLETE代表服务成功； FAIL代表失败。</status>
      <errorDesc>aa</errorDesc>
      <errCode>1</errCode>
      <orderId>121212</orderId>
    </addPointgive>
  </sn_body>
</sn_responseContent>

                              
                              {
  "sn_responseContent": {
    "sn_body": {
      "addPointgive": {
        "order": {
          "errorDesc": "1212",
          "orderItemId": "12121",
          "addAmt": "1212",
          "accountType": "112",
          "errCode": "12",
          "isSucc": "Y成功,N失败"
        },
        "errorDesc": "aa",
        "status": "COMPLETE代表服务成功； FAIL代表失败。",
        "errCode": "1",
        "orderId": "121212"
      }
    }
  }
}
异常示例
  • XML示例
  • JSON示例
复制全部代码 

  
  	API异常码
  	异常码中文描述
  

                           	  
{
  "sn_responseContent": {
    "sn_error": {
      "error_code": "API异常码",
      "error_msg": "异常码中文描述"
    }
  }
}
业务异常码
异常码 错误描述 解决方案
biz.cmall.addpointgive.missing-parameter:* 参数必填 请检查此参数的值,*号表示参数字段名
biz.cmall.addpointgive.length-overlong:* 参数的值超过规定长度 请检查此参数的值,*号表示参数字段名
biz.cmall.addpointgive.format-error:* 参数格式错误 请检查此参数的值,*号表示参数字段名
biz.cmall.addpointgive.enumeration-error:* 参数的可选值错误 请检查此参数的值,*号表示参数字段名
isp.sys.service.unavailable.cmall 服务不可用 请联系苏宁技术人员
公共异常码
API工具
API TOOLS 在线测试工具异常码查询工具SDK调用示例SDK下载
FAQ