返回API列表
异常码自查工具
suning.custom.orderselfdist.add 订单发货(商家自配送)

通过此接口可执行无需第三方物流,自己进行配送的订单的发货操作。 
1、订单号、苏宁商品编码可通过接口“suning.custom.order.query”获取。 
2、发货之前需要设置默认发货地址及退货地址,可在商家后台进行操作。 
3、允许将订单按订单行项目发货,但不允许拆分订单行项目发货。
4、发货时间,如果填写该字段值,则苏宁系统中的发货时间以填写的字段值为准,如果不填写,则苏宁系统中的发货时间默认为接口请求成功时间。
5、订单行项目号为苏宁子订单号,可以通过平台业务-交易API-批量获取三个月内订单信息和平台业务-交易API-根据订单修改时间批量查询订单信息接口查询得到。
6、苏宁商品编码及订单行项目号二者必填其一。如果两者都填,则以订单行项目号为准。 
7、采用该接口发货时,需要填写商户自己执行配送的人员的姓名和手机号。

公共参数
请求参数
名称 类型 是否必须 示例值 描述
deliveryPerNameStringY张三送货人姓名
deliveryPerPhoneStringY13899995555送货人手机号
deliveryTimeStringN2012-06-20 00:00:00发货时间
orderCodeStringY88888订单号
orderLineNumbersStringN
orderLineNumberStringN100151521订单行项目号
phoneIdentifyCodesStringN
orderLineNumberStringN1订单行项目号
phoneIdentifyCodeStringN1手机串码
productCodeStringN1苏宁商品编码
productCodesStringN
productCodeStringN108252389苏宁商品编码
响应参数
名称 类型 示例值 描述
orderSelfDistDetailString
orderCodeString3000789529订单号
orderLineNumberString100151521订单行项目号
productCodeString102609881苏宁商品编码
sendresultStringY发货结果
请求示例
  • XML示例
  • JSON示例
复制全部代码


<sn_request>
  <sn_body>
    <orderSelfDist>
      <orderLineNumbers>
        <orderLineNumber>100151521</orderLineNumber>
      </orderLineNumbers>
      <productCodes>
        <productCode>108252389</productCode>
      </productCodes>
      <deliveryPerName>张三</deliveryPerName>
      <deliveryTime>2012-06-20 00:00:00</deliveryTime>
      <orderCode>88888</orderCode>
      <phoneIdentifyCodes>
        <phoneIdentifyCode>1</phoneIdentifyCode>
        <productCode>1</productCode>
        <orderLineNumber>1</orderLineNumber>
      </phoneIdentifyCodes>
      <deliveryPerPhone>13899995555</deliveryPerPhone>
    </orderSelfDist>
  </sn_body>
</sn_request>

			
			
								


{
  "sn_request": {
    "sn_body": {
      "orderSelfDist": {
        "orderLineNumbers": {
          "orderLineNumber": "100151521"
        },
        "deliveryPerName": "张三",
        "productCodes": {
          "productCode": "108252389"
        },
        "deliveryTime": "2012-06-20 00:00:00",
        "orderCode": "88888",
        "phoneIdentifyCodes": [
          {
            "phoneIdentifyCode": "1",
            "productCode": "1",
            "orderLineNumber": "1"
          }
        ],
        "deliveryPerPhone": "13899995555"
      }
    }
  }
}
			
			
                                
响应示例
  • XML示例
  • JSON示例
复制全部代码


<sn_responseContent>
  <sn_body>
    <orderSelfDist>
      <orderSelfDistDetail>
        <sendresult>Y</sendresult>
        <productCode>102609881</productCode>
        <orderCode>3000789529</orderCode>
        <orderLineNumber>100151521</orderLineNumber>
      </orderSelfDistDetail>
    </orderSelfDist>
  </sn_body>
</sn_responseContent>

			
			
                                


{
  "sn_responseContent": {
    "sn_body": {
      "orderSelfDist": {
        "orderSelfDistDetail": [
          {
            "sendresult": "Y",
            "orderCode": "3000789529",
            "productCode": "102609881",
            "orderLineNumber": "100151521"
          }
        ]
      }
    }
  }
}
			
			
                                
异常示例
  • XML示例
  • JSON示例
复制全部代码

  
  	API异常码
  	异常码中文描述
  

                           	  
{
  "sn_responseContent": {
    "sn_error": {
      "error_code": "API异常码",
      "error_msg": "异常码中文描述"
    }
  }
} 								  
                           		
业务异常码
异常码 错误描述 解决方案
biz.custom.addorderselfdist.missing-parameter:* 参数必填 请检查此参数的值,*号表示参数字段名
isp.sys.service.unavailable.moms 服务不可用 请联系苏宁技术人员
biz.custom.addorderselfdist.invalid-biz:100 订单发货订单的状态非买家已付款 请检查输入的订单状态
biz.custom.addorderselfdist.invalid-biz:101 交易已关闭,不能发货 请输入正确的订单信息
biz.custom.addorderselfdist.invalid-biz:102 送货人姓名不能为空且长度不大于10 请重新输入送货人姓名
biz.custom.addorderselfdist.invalid-biz:103 手机号不合法 请输入合法的送货人手机
biz.custom.addorderselfdist.invalid-biz:104 订单发货订单号不存在 传入正确的订单号
biz.custom.addorderselfdist.invalid-biz:105 订单发货订单长度过长 传入正确的订单号
biz.custom.addorderselfdist.invalid-biz:106 订单发货商品编码不存在 传入正确的订单号
biz.custom.addorderselfdist.invalid-biz:107 默认发货地址不存在 请在商家后台添加默认发货地址
biz.custom.addorderselfdist.invalid-biz:108 默认退货地址不存在 请在商家后台添加默认退货地址
biz.custom.addorderselfdist.invalid-biz:109 商品编码重复 请检查商品编码
biz.custom.addorderselfdist.invalid-biz:110 发货时间格式有误 1.时间格式应为:yyyy-MM-dd HH:mm:ss 2.订单发货时间必须介于订单支付完成时间与系统当前时间之间
biz.custom.addorderselfdist.invalid-biz:111 1.订单行项目号不存在 2.苏宁商品编码及订单行项目号都为空 检查订单行项目号
biz.custom.addorderselfdist.invalid-biz:112 供应商发货的订单无法完成发货操作 请输入正确的订单信息
biz.custom.addorderselfdist.invalid-biz:113 退款中订单不能发货 退款中订单不能发货
biz.custom.addorderselfdist.invalid-biz:114 商品编码不合法 输入正确的商品编码
biz.custom.addorderselfdist.invalid-biz:115 服务行随主品行发货而发货,无需商家操作发货 服务行需随主品行发货而发货
biz.custom.addorderselfdist.invalid-biz:116 填写的送货人不符合规范,请重新填写 填写的送货人不符合规范,请重新填写
biz.custom.addorderselfdist.invalid-biz:117 填写的送货人包含敏感信息,请重新填写 填写的送货人包含敏感信息,请重新填写
biz.custom.addorderselfdist.invalid-biz:118 填写的联系手机号不符合规范,请重新填写 填写的联系手机号不符合规范,请重新填写
biz.custom.addorderselfdist.invalid-biz:119 该类型订单暂不支持API发货 该类型订单请在商户后台操作发货
biz.custom.addorderselfdist.invalid-biz:120 仓配一体订单暂不支持此接口发货 请输入正确的订单信息
biz.custom.addorderselfdist.invalid-biz:121 虚拟卡订单暂不支持此接口发货 请输入正确的订单信息
biz.custom.addorderselfdist.invalid-biz:122 海外购订单暂不支持此接口发货 请输入正确的订单信息
biz.custom.addorderselfdist.invalid-biz:123 租赁押金行订单不支持此接口发货 请输入正确的订单信息
公共异常码
API工具
FAQ

Q:发货的规则是什么?

A:可对订单进行整单发货,也可对订单进行部分发货。

Q:什么是部分发货?

A:部分发货指的是,一个订单如果存在多个行项目,则可对其中的某个行项目进行发货。不支持对行项目中的商品进行部分发货。 举例,一个订单存在A1和A2两个行项目,可以对A1或者A2进行单独发货,不可对A1中的商品进行部分发货。