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

4PS业务

4PS接单管理API
4PS任务作业API
4PS仓库管理API
4ps仓库库存
4PS商品管理API
异常码自查工具
suning.fourps.orderreturn.add 订单退货任务创建
￥免费

通过此接口可向交易中心创建订单退货任务。

公共参数
请求参数
名称 类型 是否必须 示例值 描述
outOrderId String Y 333333 外部订单编号。必须与发货订单号相同
oldOrderId String Y 666666 外部原发货订单号。
orderSource String Y 201 订单来源。201 天猫旗舰店，214京东， 203 苏宁， 204 亚马逊中国， 205当当 ，206 ebay,207 VIP，208 一号店，209 国美 210 拍拍，211 聚美，212 乐蜂 202 1688，301 其他(MIMS输其他)
expectStartTime String Y 2014-01-02 12:00:00 预期送达开始时间。格式为 yyyy-MM-dd HH:mm:ss
expectEndTime String Y 2014-01-03 12:00:00 预期送达结束时间。格式为 yyyy-MM-dd HH:mm:ss
remark String N ***** 备注。销退时留言备注填充到此字段
senderZipCode String N 938900 发件方邮编。
senderProvince String Y 四川 发件方省份。（中文）
senderCity String Y 成都 发件方城市。（中文）
senderArea String N 金牛 发件方区县。（中文）揽件为1且订单标识为9时必填
senderTown String N 1 发件方镇。（中文），如果没有镇就给全区
senderAddress String N 1 发件方地址。（中文）揽件为1且订单标识为9时必填
senderName String Y 李四 发件方名称。发件方名称:（采购入库放供应商名称）， （销退填买家名称）， （调拨入库填写仓库名称）
senderMobile String N 139880038** 发件方手机。发件方手机和电话二者必填其一
senderPhone String N 028-28200288 发件方电话。发件方手机和电话二者必填其一
takeFlag String N 1 1需要；空不需要；如果需要揽件 则商品行的运单号必须为空；如果不需要揽件，运单号保持必填
orderFlag String N 9 揽件标识为1时，订单标识必须为9；订单标识为9时，揽件标识必须为1
warehouseCode String Y 11 仓库编码.苏宁仓库编码
orderItemId String Y 5642 销售订单行号。
returnReason String N 1 退货原因。销退场景下，如可能请提供退货的原因，多个退货原因用；号分开
deliverNo String N 111111 运单号。（运单号（如果没有运单号则将发货的对应的原运单号传递），如果不需要揽件且地址不必填时运单号必填；如果需要揽件且地址必填时，运单号非必填。
itemName String Y 苹果 商品名称。
itemCode String N 222222 商家商品编码。商家商品编码和外部商品ID,两者必填一个
outerItemId String N 37901 外部商品ID。商家商品编码和外部商品ID,两者必填一个
itemQuantity String Y 12 商品数量。
响应参数
名称 类型 示例值 描述
result String Y 是否成功。成功:Y
请求示例
  • XML示例
  • JSON示例
复制全部代码 
                                
<sn_request>
	<sn_body>
		<addOrderReturn>
			<outOrderId>333333</outOrderId>
			<oldOrderId>666666</oldOrderId>
			<orderSource>201</orderSource>
			<expectStartTime>2014-01-02 12:00:00</expectStartTime>
			<expectEndTime>2014-01-03 12:00:00</expectEndTime>
			<remark>*****</remark>
			<senderZipCode>938900</senderZipCode>
			<senderProvince>四川</senderProvince>
			<senderCity>成都</senderCity>
			<senderArea>金牛</senderArea>
			<senderTown>**</senderTown>
			<senderAddress>****</senderAddress>
			<senderName>李四</senderName>
			<senderMobile>139880038</senderMobile>
			<senderPhone>028-28200288</senderPhone>
			<takeFlag>1</takeFlag>
			<orderFlag>9</orderFlag>
			<orderProductList>
				<warehouseCode>11</warehouseCode>
				<orderItemId>5642</orderItemId>
				<returnReason>***</returnReason>
				<deliverNo>111111</deliverNo>
				<itemName>苹果</itemName>
				<itemCode>222222</itemCode>
				<outerItemId>37901</outerItemId>
				<itemQuantity>12</itemQuantity>
			</orderProductList>
			<orderProductList>
				<warehouseCode>11</warehouseCode>
				<orderItemId>5642</orderItemId>
				<returnReason>***</returnReason>
				<deliverNo>111111</deliverNo>
				<itemName>苹果</itemName>
				<itemCode>222222</itemCode>
				<outerItemId>37901</outerItemId>
				<itemQuantity>12</itemQuantity>
			</orderProductList>
		</addOrderReturn>
	</sn_body>
</sn_request>		
	
                                
                                
{
  "sn_request": {
    "sn_body": {
      "addOrderReturn": {
        "outOrderId": "333333", 
        "oldOrderId": "666666", 
        "orderSource": "201", 
        "expectStartTime": "2014-01-02 12:00:00", 
        "expectEndTime": "2014-01-03 12:00:00", 
        "remark": "*****", 
        "senderZipCode": "938900", 
        "senderProvince": "四川", 
        "senderCity": "成都", 
        "senderArea": "金牛", 
        "senderTown": "**", 
        "senderAddress": "****", 
        "senderName": "李四", 
        "senderMobile": "139880038", 
        "senderPhone": "028-28200288", 
		"takeFlag": "1", 
        "orderFlag": "9", 
        "orderProductList": [
          {
			"warehouseCode":"11",
            "orderItemId": "5642", 
            "returnReason": "***", 
            "deliverNo": "111111", 
            "itemName": "苹果", 
            "itemCode": "222222", 
            "outerItemId": "37901", 
            "itemQuantity": "12"
          }, 
          {
			"warehouseCode":"11",
            "orderItemId": "5642", 
            "returnReason": "***", 
            "deliverNo": "111111", 
            "itemName": "苹果", 
            "itemCode": "222222", 
            "outerItemId": "37901", 
            "itemQuantity": "12"
          }
        ]
      }
    }
  }
}
响应示例
  • XML示例
  • JSON示例
复制全部代码 
                              
<sn_responseContent>
	<sn_body>
		<addOrderReturn>
			<result>Y</result>
		</addOrderReturn>
	</sn_body>
	<sn_head/>
</sn_responseContent>
			
                              
                              
{
  "sn_responseContent": {
    "sn_body": {
      "addOrderReturn": { "result": "Y" }
    },
	"sn_head":{
	}
  }
}
异常示例
  • XML示例
  • JSON示例
复制全部代码 

  
  	API异常码
  	异常码中文描述
  

                           	  
{
  "sn_responseContent": {
    "sn_error": {
      "error_code": "API异常码",
      "error_msg": "异常码中文描述"
    }
  }
}
业务异常码
异常码 错误描述 解决方案
biz.fourps.addorderreturn.missing-parameter:* 请求字段为空。*表示对应请求参数名 请输入正确参数。
biz.fourps.addorderreturn.expectstarttime:format-error 预期送达开始时间格式错误。yyyy-MM-dd HH:mm:ss 请输入正确参数。
biz.fourps.addorderreturn.expectendtime:format-error 预期送达结束时间格式错误。yyyy-MM-dd HH:mm:ss 请输入正确参数。
biz.fourps.addorderreturn.*:value-invalid 预期送达开始时间要大于当前时间或结束时间要大于当前时间。*表示对应请求参数名（小写） 请输入正确参数。
biz.fourps.addorderreturn.invalid-biz:100 发件方手机和电话二者必填其一 请输入正确参数。
biz.fourps.addorderreturn.invalid-biz:101 商家商品编码和外部商品ID,两者必填一个 请输入正确参数。
biz.fourps.addorderreturn.invalid-biz:102 外部原发货订单号必须与发货订单号相同 请输入正确参数。
biz.fourps.addorderreturn.invalid-biz:103 外部订单编号重复 请输入正确参数。
biz.fourps.addorderreturn.invalid-biz:104 预期送达开始时间要小于等于送达结束时间 请输入正确参数。
biz.fourps.addorderreturn.itemquantity:format-error 商品数量格式错误。正整数 请输入正确参数。
biz.fourps.addorderreturn.*:value-null-invalid 请求参数非法，值为空或长度超长。*号用请求参数字段名小写替换 请输入正确参数。
biz.fourps.addorderreturn.invalid-biz:105 发货订单必须为成功的订单才可以退货 请输入正确参数。
biz.fourps.addorderreturn.invalid-biz:106 揽件时订单标识与揽件标识关系不匹配 请输入正确参数。
biz.fourps.addorderreturn.invalid-biz:107 揽件标识值无效 请输入正确参数。
isp.sys.service.unavailable.fpsos 服务不可用（系统异常） 请联系苏宁技术人员。
公共异常码
API工具
API TOOLS 在线测试工具异常码查询工具SDK调用示例SDK下载
FAQ

Q：订单退货任务创建接口如何使用？

A：通过此接口可向交易中心创建订单退货任务。