退出
热词搜索： 订单API 接口 查询退款订单 6五四三二一 appkey
API接口目录

物流业务

苏宁开放物流API
异常码自查工具
suning.custom.logisticsorder.get 顾客面单单笔信息查询服务
￥免费

顾客面单单笔信息查询服务

公共参数
请求参数
名称 类型 是否必须 示例值 描述
logisticExpressIdStringN00620000000177206000苏宁物流运单号（苏宁物流作业订单号与苏宁顾客箱码两者必填其一）
logisticOrderIdStringNSNCY0200000008059 苏宁物流订单号（苏宁物流作业订单号与苏宁顾客箱码两者必填其一）
响应参数
名称 类型 示例值 描述
adressString清波街道送货地址
btcItemOrderString10苏宁销售订单行号
btcOrderString2000655009苏宁销售订单号
cashOnDeliveryValueString0代收款金额
cityString杭州市送货市
createDateString2014-08-06面单生成日期，格式：yyyy-MM-dd
createTimeString16:07:10面单生成时间，格式：HH:mm:ss
destCodeStringYZ目的地区域代码
districtString余杭区送货区
expressCodeString00620000000177206000苏宁顾客装箱编码
expressCompanyStringSN2快递公司编码
expressCompanyExcodeString5437899999顺丰快递单号
firstPlantCrossingString测试原发仓道口
lastLogisticStationString苏宁杭州中心仓最后一级站点（最后一公里配送出站站点）
lastPlantCrossingString测试末端DC道口（最后一公里车辆进出物流园区出入口）
logisticExpressIdString62000000000000000001苏宁物流运单号
logisticOrderIdStringSNCY0200000008059苏宁物流订单号
nameString测试顾客姓名
noteString测试提示
obligateFlagString测试预留标识
originCodeStringNJ原寄地区域代码
paymmentModeString在线支付方式
preparedTimeString12:00:00计划发车时间，格式：HH:mm:ss
provinceString浙江省送货省
realDeliDateString2014-07-27交货日期，格式：yyyy-MM-dd
realDeliTimeString18:00:00交货时间，格式：HH:mm:ss
rePrintFlagString测试面单标识（N，表示待打印；A，表示补充）
routeString北京-南京-玄武区快递点物流路由信息
setLocationString测试集货位
shipConditionString配送装运条件
shipTypeFlagString陆空陆运
telNumberString12222222222联系电话
valueAddTaxFlagString测试增值税标识（普通、增值类型发票）
请求示例
  • XML示例
  • JSON示例
复制全部代码 
                                <sn_request>
  <sn_body>
    <getLogisticsOrder>
      <logisticOrderId>SNCY0200000008059</logisticOrderId>
      <logisticExpressId>00620000000177206000</logisticExpressId>
    </getLogisticsOrder>
  </sn_body>
</sn_request>

                                
                                {
  "sn_request": {
    "sn_body": {
      "getLogisticsOrder": {
        "logisticOrderId": "SNCY0200000008059",
        "logisticExpressId": "00620000000177206000"
      }
    }
  }
}
响应示例
  • XML示例
  • JSON示例
复制全部代码 
                              <sn_responseContent>
  <sn_body>
    <getLogisticsOrder>
      <shipTypeFlag>陆</shipTypeFlag>
      <createTime>16:07:10</createTime>
      <firstPlantCrossing>测试</firstPlantCrossing>
      <logisticExpressId>62000000000000000001</logisticExpressId>
      <btcOrder>2000655009</btcOrder>
      <expressCode>00620000000177206000</expressCode>
      <expressCompany>SN2</expressCompany>
      <city>杭州市</city>
      <setLocation>测试</setLocation>
      <shipCondition>配送</shipCondition>
      <realDeliTime>18:00:00</realDeliTime>
      <realDeliDate>2014-07-27</realDeliDate>
      <paymmentMode>在线</paymmentMode>
      <cashOnDeliveryValue>0</cashOnDeliveryValue>
      <name>测试</name>
      <province>浙江省</province>
      <preparedTime>12:00:00</preparedTime>
      <district>余杭区</district>
      <destCode>YZ</destCode>
      <createDate>2014-08-06</createDate>
      <note>测试</note>
      <btcItemOrder>10</btcItemOrder>
      <rePrintFlag>测试</rePrintFlag>
      <lastLogisticStation>苏宁杭州中心仓</lastLogisticStation>
      <originCode>NJ</originCode>
      <obligateFlag>测试</obligateFlag>
      <logisticOrderId>SNCY0200000008059</logisticOrderId>
      <adress>清波街道</adress>
      <route>北京-南京-玄武区快递点</route>
      <lastPlantCrossing>测试</lastPlantCrossing>
      <expressCompanyExcode>5437899999</expressCompanyExcode>
      <valueAddTaxFlag>测试</valueAddTaxFlag>
      <telNumber>12222222222</telNumber>
    </getLogisticsOrder>
  </sn_body>
</sn_responseContent>

                              
                              {
  "sn_responseContent": {
    "sn_body": {
      "getLogisticsOrder": [
        {
          "shipTypeFlag": "陆",
          "createTime": "16:07:10",
          "firstPlantCrossing": "测试",
          "logisticExpressId": "62000000000000000001",
          "btcOrder": "2000655009",
          "expressCode": "00620000000177206000",
          "expressCompany": "SN2",
          "city": "杭州市",
          "setLocation": "测试",
          "shipCondition": "配送",
          "realDeliTime": "18:00:00",
          "realDeliDate": "2014-07-27",
          "paymmentMode": "在线",
          "cashOnDeliveryValue": "0",
          "name": "测试",
          "province": "浙江省",
          "preparedTime": "12:00:00",
          "district": "余杭区",
          "destCode": "YZ",
          "createDate": "2014-08-06",
          "note": "测试",
          "btcItemOrder": "10",
          "rePrintFlag": "测试",
          "lastLogisticStation": "苏宁杭州中心仓",
          "originCode": "NJ",
          "obligateFlag": "测试",
          "logisticOrderId": "SNCY0200000008059",
          "adress": "清波街道",
          "route": "北京-南京-玄武区快递点",
          "lastPlantCrossing": "测试",
          "expressCompanyExcode": "5437899999",
          "valueAddTaxFlag": "测试",
          "telNumber": "12222222222"
        }
      ]
    }
  }
}
异常示例
  • XML示例
  • JSON示例
复制全部代码 

  
  	API异常码
  	异常码中文描述
  

                           	  
{
  "sn_responseContent": {
    "sn_error": {
      "error_code": "API异常码",
      "error_msg": "异常码中文描述"
    }
  }
}
业务异常码
异常码 错误描述 解决方案
biz.custom.getlogisticsorder.missing-parameter:* 参数必填 请检查此参数的值,*号表示参数字段名
biz.logistics.getlogisticsorder.missing-parameter:* 参数必填 请检查此参数的值,*号表示参数字段名
biz.handler.data-get:no-result 查询没结果 请检查查询参数
isp.sys.service.unavailable.lsp 服务不可用 请联系苏宁技术人员
公共异常码
API工具
API TOOLS 在线测试工具异常码查询工具SDK调用示例SDK下载
FAQ

Q：获取苏宁物流顾客面单打印信息接口如何使用？

A：通过此接口单笔查询苏宁物流顾客面单打印信息：苏宁顾客箱码、苏宁物流订单号、苏宁物流运单号、苏宁销售订单号、苏宁销售订单行号、顾客姓名等。

Q：获取苏宁物流顾客面单打印信息如何使用？

A：通过此接口苏宁物流顾客面单打印信息有：苏宁顾客箱码、苏宁物流订单号、苏宁物流运单号、苏宁销售订单号、苏宁销售订单行号、顾客姓名等。