API接口目录

4PS业务

4PS接单管理API
4PS任务作业API
4PS仓库管理API
4ps仓库库存
4PS商品管理API
异常码自查工具
suning.fourps.expressorder.add 4PS揽件订单下单接口
¥免费

4PS揽件订单下单接口

公共参数
请求参数
名称 类型 是否必须 示例值 描述
expressCompCodeStringYSN2快递公司编码
marketingProductStringY10营销产品
orderSourceStringY201订单来源
packageListStringN
agentAmountStringN1253.33代收货款金额
agentOptionStringN02代收货款方式
carFlagStringY0是否整车直达
dstributeAndInstallStringY0是否送装一体
expressNoStringN6258986525522已有面单号
fullCarTypeStringNT180整车车型
goodsQtyStringY3商品数量
insyredValueStringN15000保价金额
outOrderNumStringN25845632555555外部订单号
packageCommentStringN备注备注
packageHeightStringN64包裹高(cm)
packageLengthStringN22包裹长(cm)
packageNameStringY手机寄托物名称
packageNoStringY1包裹序号
packageVolumeStringN3333333包裹体积
packageWeightStringY3重量(kg)
packageWidthStringN64包裹宽(cm)
packingStringY1是否包装
pickupModeStringY01取件方式
selfFeedingPointStringNL025自送点
serviceModeStringY01送达方式
signReturnStringY1签单返回
specialCarTypeStringN专车直揽(默认为空)
transportTypeStringY01运输方式
receiverAddressDetailStringY仙女路收件人详细地址
receiverCityStringY扬州市收件人市
receiverCompanyStringN苏宁易购收件人公司
receiverDistrictStringY江都区收件人区/县
receiverMobileStringN13802520698收件人手机
receiverNameStringY李四收件人姓名
receiverProvinceStringY江苏省收件人省份
receiverTelStringN025-66996699收件人电话
receiverTownStringN全区收件人街道/乡镇
senderAddressDetailStringY文苑路南京财经大学发件人详细地址
senderCityStringY南京市发件人市
senderCompanyStringN苏宁云商有限公司发件人公司
senderDistrictStringY栖霞区发件人区/县
senderMobileStringN13802356421发件人手机
senderNameStringY张山发件人姓名
senderProvinceStringY江苏省发件人省(中文)
senderTelStringN025-66996699发件人电话
senderTownStringN全区发件人街道/乡镇
uuidStringY2564EDSF1287RFDROPIG4567IUYT2594IJHGUUID
响应参数
名称 类型 示例值 描述
createTimeString2015-11-11 10:42:00订单创建时间
innerOrderIdStringD201702041256订单号
packageListString
errorInfoString错误错误描述
expressNoString625896321运单号
outOrderNumString56325894123外部订单号
packageNoString01包裹序号
routeInfoString北京路由信息
successStringY校验结果
uuidString2564EDSF1287RFDROPIG4567IUYT2594IJHGuuid
请求示例
  • XML示例
  • JSON示例
复制全部代码
                                <sn_request>
  <sn_body>
    <addExpressorder>
      <senderTown>全区</senderTown>
      <receiverDistrict>江都区</receiverDistrict>
      <senderCompany>苏宁云商有限公司</senderCompany>
      <senderProvince>江苏省</senderProvince>
      <orderSource>201</orderSource>
      <receiverAddressDetail>仙女路</receiverAddressDetail>
      <receiverTel>025-66996699</receiverTel>
      <receiverMobile>13802520698</receiverMobile>
      <receiverProvince>江苏省</receiverProvince>
      <packageList>
        <selfFeedingPoint>L025</selfFeedingPoint>
        <serviceMode>01</serviceMode>
        <packageNo>1</packageNo>
        <packageName>手机</packageName>
        <signReturn>1</signReturn>
        <pickupMode>01</pickupMode>
        <agentAmount>1253.33</agentAmount>
        <carFlag>0</carFlag>
        <specialCarType>空</specialCarType>
        <insyredValue>15000</insyredValue>
        <packageWeight>3</packageWeight>
        <fullCarType>T180</fullCarType>
        <packageLength>22</packageLength>
        <outOrderNum>25845632555555</outOrderNum>
        <goodsQty>3</goodsQty>
        <expressNo>6258986525522</expressNo>
        <packageHeight>64</packageHeight>
        <packing>1</packing>
        <packageVolume>3333333</packageVolume>
        <packageWidth>64</packageWidth>
        <transportType>01</transportType>
        <dstributeAndInstall>0</dstributeAndInstall>
        <packageComment>备注</packageComment>
        <agentOption>02</agentOption>
      </packageList>
      <senderTel>025-66996699</senderTel>
      <expressCompCode>SN2</expressCompCode>
      <receiverCompany>苏宁易购</receiverCompany>
      <receiverCity>扬州市</receiverCity>
      <senderName>张山</senderName>
      <marketingProduct>10</marketingProduct>
      <receiverTown>全区</receiverTown>
      <senderDistrict>栖霞区</senderDistrict>
      <senderCity>南京市</senderCity>
      <senderAddressDetail>文苑路南京财经大学</senderAddressDetail>
      <receiverName>李四</receiverName>
      <uuid>2564EDSF1287RFDROPIG4567IUYT2594IJHG</uuid>
      <senderMobile>13802356421</senderMobile>
    </addExpressorder>
  </sn_body>
</sn_request>

                                
                                {
  "sn_request": {
    "sn_body": {
      "addExpressorder": {
        "senderTown": "全区",
        "receiverDistrict": "江都区",
        "senderCompany": "苏宁云商有限公司",
        "senderProvince": "江苏省",
        "orderSource": "201",
        "receiverAddressDetail": "仙女路",
        "receiverTel": "025-66996699",
        "receiverMobile": "13802520698",
        "receiverProvince": "江苏省",
        "packageList": [
          {
            "selfFeedingPoint": "L025",
            "serviceMode": "01",
            "packageNo": "1",
            "packageName": "手机",
            "signReturn": "1",
            "pickupMode": "01",
            "agentAmount": "1253.33",
            "carFlag": "0",
            "specialCarType": "空",
            "insyredValue": "15000",
            "packageWeight": "3",
            "fullCarType": "T180",
            "packageLength": "22",
            "outOrderNum": "25845632555555",
            "goodsQty": "3",
            "packageHeight": "64",
            "expressNo": "6258986525522",
            "packing": "1",
            "packageVolume": "3333333",
            "packageWidth": "64",
            "packageComment": "备注",
            "dstributeAndInstall": "0",
            "transportType": "01",
            "agentOption": "02"
          }
        ],
        "senderTel": "025-66996699",
        "receiverCompany": "苏宁易购",
        "expressCompCode": "SN2",
        "receiverCity": "扬州市",
        "marketingProduct": "10",
        "senderName": "张山",
        "receiverTown": "全区",
        "senderDistrict": "栖霞区",
        "senderCity": "南京市",
        "senderAddressDetail": "文苑路南京财经大学",
        "receiverName": "李四",
        "senderMobile": "13802356421",
        "uuid": "2564EDSF1287RFDROPIG4567IUYT2594IJHG"
      }
    }
  }
}
                                
响应示例
  • XML示例
  • JSON示例
复制全部代码
                              <sn_responseContent>
  <sn_body>
    <addExpressorder>
      <createTime>2015-11-11 10:42:00</createTime>
      <innerOrderId>D201702041256</innerOrderId>
      <packageList>
        <routeInfo>北京</routeInfo>
        <packageNo>01</packageNo>
        <errorInfo>错误</errorInfo>
        <outOrderNum>56325894123</outOrderNum>
        <expressNo>625896321</expressNo>
        <success>Y</success>
      </packageList>
      <uuid>2564EDSF1287RFDROPIG4567IUYT2594IJHG</uuid>
    </addExpressorder>
  </sn_body>
</sn_responseContent>

                              
                              {
  "sn_responseContent": {
    "sn_body": {
      "addExpressorder": {
        "createTime": "2015-11-11 10:42:00",
        "innerOrderId": "D201702041256",
        "packageList": [
          {
            "routeInfo": "北京",
            "errorInfo": "错误",
            "packageNo": "01",
            "outOrderNum": "56325894123",
            "expressNo": "625896321",
            "success": "Y"
          }
        ],
        "uuid": "2564EDSF1287RFDROPIG4567IUYT2594IJHG"
      }
    }
  }
}
                              
异常示例
  • XML示例
  • JSON示例
复制全部代码

  
  	API异常码
  	异常码中文描述
  

                           	  
{
  "sn_responseContent": {
    "sn_error": {
      "error_code": "API异常码",
      "error_msg": "异常码中文描述"
    }
  }
}
                           		
业务异常码
异常码 错误描述 解决方案
biz.fourps.addexpressorder.missing-parameter:* 参数必填 请检查此参数的值,*号表示参数字段名
biz.fourps.addexpressorder.format-error:* 参数格式错误 请检查此参数的值,*号表示参数字段名
biz.fourps.addexpressorder.length-overlong:* 参数的值超过规定长度 请检查此参数的值,*号表示参数字段名
biz.fourps.addexpressorder.enumeration-error:* 参数的可选值错误 请检查此参数的值,*号表示参数字段名
isp.sys.service.unavailable.fpscs 服务不可用 请联系苏宁技术人员
biz.fourps.addexpressorder.invalid-biz:100 请求uuid重复 请重新输入uuid
biz.fourps.addexpressorder.invalid-biz:102 发件人省市区校验不通过 请输入正确的省市区
biz.fourps.addexpressorder.invalid-biz:106 收件人省、市、区校验不通过 请输入正确的省市区
biz.fourps.addexpressorder.invalid-biz:110 发件人手机、电话二者必填其一 请输入发件人手机或电话
biz.fourps.addexpressorder.invalid-biz:111 收件人手机、电话二者必填其一 请输入收件人手机或电话
biz.fourps.addexpressorder.invalid-biz:112 当“是否代收付款”为1时,“代收货款方式”必填 请选择代收货款方式
biz.fourps.addexpressorder.invalid-biz:113 当“提货方式”为02时,“是否外接外送”必为0 请重新选择“是否外接外送方式”
biz.fourps.addexpressorder.invalid-biz:114 当“是否外接外送”为2时,“整车车型”必填 请填写整车车型
biz.fourps.addexpressorder.invalid-biz:115 当“提货方式”为02时,自送点必填 请填写自送点
biz.fourps.addexpressorder.invalid-biz:116 自送点无效 请填写正确的自送点
biz.fourps.addexpressorder.invalid-biz:117 包裹长宽高和体积只能填写一个 请重新填写
biz.fourps.addexpressorder.invalid-biz:118 当填写长宽高中任意一个时,另外两个必填 请重新填写长宽高
biz.fourps.addexpressorder.invalid-biz:119 单个包裹保价金额必须小于20000 请重新填写
biz.fourps.addexpressorder.invalid-biz:120 代收货款金额小于20000 请重新填写
biz.fourps.addexpressorder.invalid-biz:123 包裹序号必须在01-99之间 请重新填写
biz.fourps.addexpressorder.invalid-biz:124 包裹序号不能重复 请重新填写包裹序号
biz.fourps.addexpressorder.invalid-biz:125 行项目中“面单号”不能重复 请重新填写面单号或请求电子面单号
biz.fourps.addexpressorder.invalid-biz:126 您所订购的营销产品不支持您所选增值服务 请重新填写
biz.fourps.addexpressorder.invalid-biz:127 您未订购*增值服务 请重写填写
biz.fourps.addexpressorder.invalid-biz:129 专车直揽,自送点和整车车型必须为空 请重新填写
biz.fourps.addexpressorder.invalid-biz:130 整车直揽,整车车型必须有值且自送点必为空 请重新填写
公共异常码
API工具
FAQ