API接口目录

自营业务

退厂API
厂送API
厂送退换货API
品牌串码API
采购订单API
供应商收发货API
售后服务API
供应商财务API
主数据API
自营合同API
自营商品API
自营财务API
采购计划API
收发货API
订单API
易道报表API
不良品API
自营促销API
异常码自查工具
suning.selfmarket.deliveryvoucher.add  API上传发货凭证并代确认收货
¥免费

 10门店渠道,订单类型为厂送销售订单,订单状态为已发货,通过API上传发货凭证成功后代确认收货

公共参数
请求参数
名称 类型 是否必须 示例值 描述
omsOrderItemNoStringY00037960049101OMS订单行号(子订单号)
supplierCodeStringY10047280商家编码
imgListStringN
imgStringY从图片流读取的字节数组,先base64加密然后去除空格回车后作为字段发货凭证必填,每次最多上传10张,图片每张最大2M,支持的图片格式:jpg、jpeg、png、gif
响应参数
名称 类型 示例值 描述
returnFlagStringY响应结果:Y代表成功,N代表失败
请求示例
  • XML示例
  • JSON示例
复制全部代码
                                
<sn_request>
  <sn_body>
    <addDeliveryvoucher>
      <omsOrderItemNo>00037960049101</omsOrderItemNo>
      <supplierCode>10047280</supplierCode>
      <imgList>
        <img>从图片流读取的字节数组,先base64加密然后去除空格回车后作为字段</img>
      </imgList>
    </addDeliveryvoucher>
  </sn_body>
</sn_request>

			
                                
                                
{
  "sn_request": {
    "sn_body": {
      "addDeliveryvoucher": {
        "omsOrderItemNo": "00037960049101",
        "supplierCode": "10047280",
        "imgList": [
          {
            "img": "从图片流读取的字节数组,先base64加密然后去除空格回车后作为字段"
          }
        ]
      }
    }
  }
}
			
                                
响应示例
  • XML示例
  • JSON示例
复制全部代码
                              
<sn_responseContent>
  <sn_body>
    <addDeliveryvoucher>
      <returnFlag>Y</returnFlag>
    </addDeliveryvoucher>
  </sn_body>
</sn_responseContent>

			
                              
                              
{
  "sn_responseContent": {
    "sn_body": {
      "addDeliveryvoucher": {
        "returnFlag": "Y"
      }
    }
  }
}
			
                              
异常示例
  • XML示例
  • JSON示例
复制全部代码

  
  	API异常码
  	异常码中文描述
  

                           	  
{
  "sn_responseContent": {
    "sn_error": {
      "error_code": "API异常码",
      "error_msg": "异常码中文描述"
    }
  }
}
                           		
业务异常码
异常码 错误描述 解决方案
biz.selfmarket.adddeliveryvoucher.missing-parameter:* 参数必填 请检查此参数的值,*号表示参数字段名
isp.sys.service.unavailable.somp 服务不可用 请联系苏宁技术人员
biz.selfmarket.adddeliveryvoucher.invalid-biz:100 入参不合法 请检查入参
biz.selfmarket.adddeliveryvoucher.invalid-biz:101 未查询到该订单行信息 请检查入参
biz.selfmarket.adddeliveryvoucher.invalid-biz:102 图片上传失败 请稍后重试
biz.selfmarket.adddeliveryvoucher.invalid-biz:103 保存图片地址失败 请稍后重试
biz.selfmarket.adddeliveryvoucher.invalid-biz:104 订单信息不符合 请检查入参或订单状态是否符合
biz.selfmarket.adddeliveryvoucher.invalid-biz:105 上传发货凭证异常 请稍后重试
公共异常码
API工具
FAQ