API接口目录

平台业务

商品API
价格API
库存API
销售准备API
交易API
退货退款API(新)
财务API
店铺API
物流API
促销API
分销API
发票API
招商API
换货API
互动营销API
退货退款API
客服API
平台营销API
风控API
会员通API
账房API
财务记账API
异常码自查工具
suning.custom.electronicinvoice.add 商家开票信息回传接口
¥免费

1.商户开票后回传发票数据,苏宁平台接收后支持消费者查看/下载;
2.发票文件内容目前只支持jpg,png,bmp,pdf格式 支持的文件类型:jpg,png,bmp,pdf;
3.发票文件内容回传时,需将文件解析为字节数组,然后base64加密后上传;

公共参数
请求参数
名称 类型 是否必须 示例值 描述
invoiceCodeStringN1111发票代码
invoiceDataStringY13v1123v3bh2h234发票文件内容(图片解析为字节数组后base64加密)
invoiceNoStringY1111发票号码
invoiceTimeStringY2016-08-01 10:10:10开票日期
invoiceTypeStringY1发票类型,1 蓝票 -1 红票
orderIdStringY4511680451销售单号
productCodeStringN1111苏宁商品编码
invoiceFlagStringY02发票标识
invoiceHeadStringY苏宁易购发票抬头
invoiceHeadTypeStringY1发票抬头类型
invoiceAmountStringY开票合计金额开票金额
invoiceNoTaxAmountStringN不含税金额不含税金额
invoiceSecurityCodeStringN59888 37763 38108 76652发票校验码
oldInvoiceCodeStringN1234原发票代码
oldInvoiceNumStringN123原发票号码
logisticsOrderIdStringN纸质发票存在物流单号物流单号
logisticsCompStringN纸质发票存在物流公司物流公司
响应参数
名称 类型 示例值 描述
isSuccessStringY发票上传是否成功
请求示例
  • XML示例
  • JSON示例
复制全部代码
                                
<sn_request>
  <sn_body>
    <addElectronicInvoice>
      <invoiceData>13v1123v3bh2h234</invoiceData>
      <invoiceFlag>02</invoiceFlag>
      <logisticsOrderId>纸质发票存在物流单号</logisticsOrderId>
      <invoiceHeadType>1</invoiceHeadType>
      <invoiceTime>2016-08-01 10:10:10</invoiceTime>
      <oldInvoiceCode>1234</oldInvoiceCode>
      <orderId>4511680451</orderId>
      <invoiceAmount>开票合计金额</invoiceAmount>
      <logisticsComp>纸质发票存在物流公司</logisticsComp>
      <invoiceCode>1111</invoiceCode>
      <productCode>1111</productCode>
      <invoiceHead>苏宁易购</invoiceHead>
      <invoiceNoTaxAmount>不含税金额</invoiceNoTaxAmount>
      <invoiceSecurityCode>59888 37763 38108 76652</invoiceSecurityCode>
      <invoiceType>1</invoiceType>
      <invoiceNo>1111</invoiceNo>
      <oldInvoiceNum>123</oldInvoiceNum>
    </addElectronicInvoice>
  </sn_body>
</sn_request>

			
                                
                                
{
  "sn_request": {
    "sn_body": {
      "addElectronicInvoice": {
        "invoiceData": "13v1123v3bh2h234",
        "invoiceFlag": "02",
        "logisticsOrderId": "纸质发票存在物流单号",
        "invoiceHeadType": "1",
        "invoiceTime": "2016-08-01 10:10:10",
        "oldInvoiceCode": "1234",
        "orderId": "4511680451",
        "invoiceAmount": "开票合计金额",
        "logisticsComp": "纸质发票存在物流公司",
        "invoiceCode": "1111",
        "productCode": "1111",
        "invoiceHead": "苏宁易购",
        "invoiceNoTaxAmount": "不含税金额",
        "invoiceSecurityCode": "59888 37763 38108 76652",
        "invoiceType": "1",
        "invoiceNo": "1111",
        "oldInvoiceNum": "123"
      }
    }
  }
}
			
                                
响应示例
  • XML示例
  • JSON示例
复制全部代码
                              
<sn_responseContent>
  <sn_body>
    <addElectronicInvoice>
      <isSuccess>Y</isSuccess>
    </addElectronicInvoice>
  </sn_body>
</sn_responseContent>

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

  
  	API异常码
  	异常码中文描述
  

                           	  
{
  "sn_responseContent": {
    "sn_error": {
      "error_code": "API异常码",
      "error_msg": "异常码中文描述"
    }
  }
}
                           		
业务异常码
异常码 错误描述 解决方案
biz.custom.addelectronicinvoice.length-overlong:* 参数的值超过规定长度 请检查此参数的值,*号表示参数字段名
biz.custom.addelectronicinvoice.format-error:* 参数格式错误 请检查此参数的值,*号表示参数字段名
isp.sys.service.unavailable.moms 服务不可用 请联系苏宁技术人员
biz.custom.addelectronicinvoice.missing-parameter:* 缺少必填参数,*表示字段名 请输入正确参数。
biz.custom.addelectronicinvoice.invalid-biz:100 订单号不能为空 传入正确的订单号
biz.custom.addelectronicinvoice.invalid-biz:101 发票代码不能为空 传入正确的发票代码
biz.custom.addelectronicinvoice.invalid-biz:102 发票号码不能为空 传入正确的发票号码
biz.custom.addelectronicinvoice.invalid-biz:103 电子发票类型不合法 传入正确的电子发票类型
biz.custom.addelectronicinvoice.invalid-biz:104 开票日期不能为空 传入正确的开票日期
biz.custom.addelectronicinvoice.invalid-biz:105 发票文件内容不能为 传入正确的发票文件
biz.custom.addelectronicinvoice.invalid-biz:106 订单信息不存在 传入正确的订单号
biz.custom.addelectronicinvoice.invalid-biz:107 文件大小不可超出1M 传入正确的发票文件
biz.custom.addelectronicinvoice.invalid-biz:108 仅支持类型为jpg,png,bmp,pdf的文件 传入正确的发票文件
biz.custom.addelectronicinvoice.invalid-biz:109 该订单未产生退货,不可上传红票 退货订单产生后再上传红票
biz.custom.addelectronicinvoice.invalid-biz:110 非已付款订单不能上传发票 订单已付款后再上传发票
biz.custom.addelectronicinvoice.invalid-biz:111 非电子发票不能上传发票 上传电子发票
biz.custom.addelectronicinvoice.invalid-biz:112 电子发票标识不合法 传入正确的电子发票标识
biz.custom.addelectronicinvoice.invalid-biz:113 发票抬头不能为空 传入正确的发票抬头
biz.custom.addelectronicinvoice.invalid-biz:114 发票类型不能为空 传入正确的发票类型
biz.custom.addelectronicinvoice.invalid-biz:115 发票类型不合法 传入正确的发票类型
biz.custom.addelectronicinvoice.invalid-biz:116 开票金额不能为空 传入正确的开票金额
biz.custom.addelectronicinvoice.invalid-biz:117 开票金额不合法 传入正确的开票金额
biz.custom.addelectronicinvoice.invalid-biz:118 开票不含税金额不合法 传入正确的开票不含税金额
biz.custom.addelectronicinvoice.invalid-biz:119 发票校验码不合法 传入正确的发票校验码
biz.custom.addelectronicinvoice.invalid-biz:120 原发票代码不能为空 传入正确的原发票代码
biz.custom.addelectronicinvoice.invalid-biz:121 原发票号码不能为空 传入正确的原发票号码
biz.custom.addelectronicinvoice.invalid-biz:122 物流单号不合法 传入正确的物流单号
biz.custom.addelectronicinvoice.invalid-biz:123 物流公司不合法 传入正确的物流公司
biz.custom.addelectronicinvoice.invalid-biz:124 开票日期格式错误,正确格式为:yyyy-MM-dd 传入正确开票日期
公共异常码
API工具
FAQ