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

自营业务

退厂API
厂送API
厂送退换货API
品牌串码API
采购订单API
供应商收发货API
售后服务API
供应商财务API
主数据API
自营合同API
自营商品API
自营财务API
采购计划API
收发货API
订单API
易道报表API
不良品API
自营促销API
异常码自查工具
suning.selfmarket.rejected.get 单笔获取退货信息
￥免费

通过此接口可单笔获取退货信息

公共参数
请求参数
名称 类型 是否必须 示例值 描述
applyTimeStringN2015-12-12 12:00:00退货申请时间
omsOrderItemNoStringY00040761338301销售订单行号
supplierCodeStringY10001373商家编码
workOrderNumStringNK000213278/90210105262211退货请求号
响应参数
名称 类型 示例值 描述
omsOrderItemNoString00040761338301销售订单号
statusString10订单状态。10：待发货
priceString1销售价。最后交易价
referencePriceString1供应商维护的销售价
cscPriceString1直降、大聚惠的购物车结算价格
orderCodeString101030001订单号
supplierCmmdtyCodeString123456789商家商品编码
saleqtyString1销售数量
returnListString
custMobPhoneString18762222222买家联系方式
customerNameString张三买家姓名
dealStatusStringWAIT_SELLER_AGREE退货状态。WAIT_SELLER_AGREE：退货待处理；WAIT_BUYER_RETURN_GOODS：待买家退货；WAIT_SELLER_CONFIRM_GOODS：待厂家收货；SELLER_REFUSED：已拒绝退款；SELLER_CONFIRMED：退款处理中；SUCCESS：退款成功；CLOSED：退款关闭。
modifyTimeString2015-12-12 12:00:00退货状态操作时间。格式：YYYY-MM-DD HH:MM:SS
refundFeeString100退货金额
returnDescString发货太慢退货说明
returnReasonString发货太慢退货原因
workOrderNumStringK000213278退货请求号
statusPassTimeString2015-12-12 12:00:00 退货状态的超时时间，退货状态为退货待处理或待厂家收货时，需要厂家关注此时间
returnBackTypeString上门取件/顾客寄货退货方式，代表厂家同意退货时选择的顾客退回货物的方式
retAddressString省名称市名称区名称详细地址退货地址；代表厂家同意退货时选择的退货地址
backinDateString2015-12-12 12:00:00厂家同意退货时选择的退货方式为上门取件，则会填写对应的上门时间
getBackPersonString李四厂家操作同意退货时，选择退货方式为上门取件，则会填写对应的上门取件人姓名
getBackPersonTelString18762333333厂家同意退货时，若选择的退货方式为上门取件，则会填写相应的上门取件人联系方式
mobilePhoneString18762333333厂家同意退货时，若选择的退货方式为顾客寄货，则选择的退货地址中包含了相应的退货联系方式（手机号）
telphoneString000-0000-00000000厂家同意退货时，若选择的退货方式为顾客寄货，则选择的退货地址中包含了相应的退货联系方式（固定电话）
companyNameString苏宁快递顾客将货物寄回时，填写的退货物流公司名称
expressNoString120000010101顾客将货物寄回时，填写的退货物流单号
ducuctAmountString10.00退款时扣除的优惠金额，若顾客下单时返的券/云钻已用，退款时会在金额中扣除此部分金额；
retMoneySuccessTimeString2017-12-12 12:00:00退款成功时间
returnMoneyDetailString
payNameString易付宝退款方式名称
payAmountString100.00退款方式对应的退款金额
returnqtyString1退货数量
refundAttriString01天猫退款属性，01:仅退款 02:退货退款
applyTimeString2020-11-18 12:00:00退货申请时间(废弃)
returnTypeString2退货类型 2 货未发 3货已发未收 4货已收
returnApplyTimeString2020-11-18 12:00:00退货申请时间
refundTypeString0101退款助手02其他03批量退款04售后助手05售后策略06页面退款07api退款08app退款09小额免审退（货未发平台规则）
retOrderItemIdString10000000001OMS逆向行号
promotionNodeString
shareProcessStateString未生成/无逆向优惠单/已分摊逆向优惠单分摊处理状态
voucherIdString123456789优惠单号
allocatedAmountString12.11分摊金额
请求示例
  • XML示例
  • JSON示例
复制全部代码 
                                
<sn_request>
  <sn_body>
    <getRejected>
      <workOrderNum>K000213278/90210105262211</workOrderNum>
      <omsOrderItemNo>00040761338301</omsOrderItemNo>
      <supplierCode>10001373</supplierCode>
      <applyTime>2015-12-12 12:00:00</applyTime>
    </getRejected>
  </sn_body>
</sn_request>

			
                                
                                
{
  "sn_request": {
    "sn_body": {
      "getRejected": {
        "workOrderNum": "K000213278/90210105262211",
        "omsOrderItemNo": "00040761338301",
        "supplierCode": "10001373",
        "applyTime": "2015-12-12 12:00:00"
      }
    }
  }
}
响应示例
  • XML示例
  • JSON示例
复制全部代码 
                              
<sn_responseContent>
  <sn_body>
    <getRejected>
      <supplierCmmdtyCode>123456789</supplierCmmdtyCode>
      <referencePrice>1</referencePrice>
      <price>1</price>
      <omsOrderItemNo>00040761338301</omsOrderItemNo>
      <orderCode>101030001</orderCode>
      <saleqty>1</saleqty>
      <cscPrice>1</cscPrice>
      <returnList>
        <refundFee>100</refundFee>
        <returnqty>1</returnqty>
        <statusPassTime>2015-12-12 12:00:00</statusPassTime>
        <expressNo>120000010101</expressNo>
        <companyName>苏宁快递</companyName>
        <returnMoneyDetail>
          <payAmount>100.00</payAmount>
          <payName>易付宝</payName>
        </returnMoneyDetail>
        <returnBackType>上门取件/顾客寄货</returnBackType>
        <returnDesc>发货太慢</returnDesc>
        <refundType>01</refundType>
        <modifyTime>2015-12-12 12:00:00</modifyTime>
        <returnReason>发货太慢</returnReason>
        <promotionNode>
          <allocatedAmount>12.11</allocatedAmount>
          <voucherId>123456789</voucherId>
          <shareProcessState>未生成/无逆向优惠单/已分摊</shareProcessState>
        </promotionNode>
        <custMobPhone>18762222222</custMobPhone>
        <refundAttri>01</refundAttri>
        <applyTime>2020-11-18 12:00:00</applyTime>
        <retAddress>省名称市名称区名称详细地址</retAddress>
        <retOrderItemId>10000000001</retOrderItemId>
        <dealStatus>WAIT_SELLER_AGREE</dealStatus>
        <customerName>张三</customerName>
        <getBackPersonTel>18762333333</getBackPersonTel>
        <returnApplyTime>2020-11-18 12:00:00</returnApplyTime>
        <backinDate>2015-12-12 12:00:00</backinDate>
        <workOrderNum>K000213278</workOrderNum>
        <getBackPerson>李四</getBackPerson>
        <ducuctAmount>10.00</ducuctAmount>
        <mobilePhone>18762333333</mobilePhone>
        <telphone>000-0000-00000000</telphone>
        <retMoneySuccessTime>2017-12-12 12:00:00</retMoneySuccessTime>
        <returnType>2</returnType>
      </returnList>
      <status>10</status>
    </getRejected>
  </sn_body>
</sn_responseContent>

			
                              
                              
{
  "sn_responseContent": {
    "sn_body": {
      "getRejected": {
        "supplierCmmdtyCode": "123456789",
        "referencePrice": "1",
        "price": "1",
        "omsOrderItemNo": "00040761338301",
        "orderCode": "101030001",
        "saleqty": "1",
        "cscPrice": "1",
        "returnList": [
          {
            "refundFee": "100",
            "returnqty": "1",
            "statusPassTime": "2015-12-12 12:00:00",
            "expressNo": "120000010101",
            "companyName": "苏宁快递",
            "returnMoneyDetail": [
              {
                "payAmount": "100.00",
                "payName": "易付宝"
              }
            ],
            "returnBackType": "上门取件/顾客寄货",
            "returnDesc": "发货太慢",
            "refundType": "01",
            "modifyTime": "2015-12-12 12:00:00",
            "returnReason": "发货太慢",
            "promotionNode": [
              {
                "allocatedAmount": "12.11",
                "voucherId": "123456789",
                "shareProcessState": "未生成/无逆向优惠单/已分摊"
              }
            ],
            "custMobPhone": "18762222222",
            "refundAttri": "01",
            "applyTime": "2020-11-18 12:00:00",
            "retAddress": "省名称市名称区名称详细地址",
            "retOrderItemId": "10000000001",
            "dealStatus": "WAIT_SELLER_AGREE",
            "customerName": "张三",
            "getBackPersonTel": "18762333333",
            "returnApplyTime": "2020-11-18 12:00:00",
            "backinDate": "2015-12-12 12:00:00",
            "workOrderNum": "K000213278",
            "getBackPerson": "李四",
            "ducuctAmount": "10.00",
            "mobilePhone": "18762333333",
            "telphone": "000-0000-00000000",
            "retMoneySuccessTime": "2017-12-12 12:00:00",
            "returnType": "2"
          }
        ],
        "status": "10"
      }
    }
  }
}
异常示例
  • XML示例
  • JSON示例
复制全部代码 

  
  	API异常码
  	异常码中文描述
  

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

Q：单笔获取退货信息接口如何使用

A：通过此接口可单笔获取退货信息