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

4PS业务

4PS接单管理API
4PS任务作业API
4PS仓库管理API
4ps仓库库存
4PS商品管理API
异常码自查工具
suning.fourps.result.add 揽件和签收状态反馈接口
￥免费

揽件和签收状态反馈接口

公共参数
请求参数
名称 类型 是否必须 示例值 描述
expressKeyStringYtiantian快递公司
failReasonStringN商品已损坏失败原因
freightStringN30.04运费
pickupManStringN张三揽收业务员
pickupManContactStringN18651660535揽收业务员联系方式
pickupNetworkStringN111玄武区快递点揽收网点
pickupNetworkContactStringN18651660531揽收网点联系方式
pickupStateStringN0揽收状态
pickupTimeStringN2017-03-27 11:34:17揽收时间
pushTypeStringY1推送类型
returnOrderIdStringYD201609272106001855物流订单号
signupStateStringN0签收状态
signupTimeStringN2017-03-27 11:34:17签收时间
waybillNoStringN105452777012运单号
weightStringN20.05重量
响应参数
名称 类型 示例值 描述
messageString接收成功中文描述
returncodeString1成功及失败代号
请求示例
  • XML示例
  • JSON示例
复制全部代码 
                                
<sn_request>
  <sn_body>
    <addResult>
      <weight>20.05</weight>
      <pickupManContact>18651660535</pickupManContact>
      <waybillNo>105452777012</waybillNo>
      <pickupTime>2017-03-27  11:34:17</pickupTime>
      <pushType>1</pushType>
      <signupTime>2017-03-27  11:34:17</signupTime>
      <pickupState>0</pickupState>
      <pickupMan>张三</pickupMan>
      <returnOrderId>D201609272106001855</returnOrderId>
      <pickupNetworkContact>18651660531</pickupNetworkContact>
      <freight>30.04</freight>
      <failReason>商品已损坏</failReason>
      <expressKey>tiantian</expressKey>
      <pickupNetwork>111玄武区快递点</pickupNetwork>
      <signupState>0</signupState>
    </addResult>
  </sn_body>
</sn_request>

			
                                
                                
{
  "sn_request": {
    "sn_body": {
      "addResult": {
        "weight": "20.05",
        "pickupManContact": "18651660535",
        "waybillNo": "105452777012",
        "pickupTime": "2017-03-27  11:34:17",
        "pushType": "1",
        "signupTime": "2017-03-27  11:34:17",
        "pickupState": "0",
        "pickupMan": "张三",
        "returnOrderId": "D201609272106001855",
        "pickupNetworkContact": "18651660531",
        "freight": "30.04",
        "failReason": "商品已损坏",
        "expressKey": "tiantian",
        "signupState": "0",
        "pickupNetwork": "111玄武区快递点"
      }
    }
  }
}
响应示例
  • XML示例
  • JSON示例
复制全部代码 
                              
<sn_responseContent>
  <sn_body>
    <addResult>
      <message>接收成功</message>
      <returncode>1</returncode>
    </addResult>
  </sn_body>
</sn_responseContent>

			
                              
                              
{
  "sn_responseContent": {
    "sn_body": {
      "addResult": {
        "message": "接收成功",
        "returncode": "1"
      }
    }
  }
}
异常示例
  • XML示例
  • JSON示例
复制全部代码 

  
  	API异常码
  	异常码中文描述
  

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