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

零售云业务

采购API
订单API
库存API
价格API
商品API
报表API
消息服务API
基础数据API
物流API
零售商认证API
发票API
快修回收API
云仓API
异常码自查工具
suning.retailer.submitvarinvoice.create 提交增票认证接口
￥免费

提交增票认证接口

公共参数
请求参数
名称 类型 是否必须 示例值 描述
appIdStringY111111调用方唯一编码
snCustNumStringN111111易购会员编码
submitFlagStringNsubmitFlag提交标志 0：首次1：再次
vatInvoiceInfoDTOStringN
orgNameStringNorgName增票名称
certTypeStringNcertType证件类型
certNoStringNcertNo税务登记证号
orgAddrStringNorgAddr单位地址
orgTelStringNorgTel单位电话
bankNameStringNbankName开户银行
bankDepositAcntStringNbankDepositAcnt开户银行账号
vatQlfctStatStringNvatQlfctStat增票资质状态
vatQlfctStatUpdRsnStringNvatQlfctStatUpdRsn增票资质更新原因
vatQlfctStatUpdTmStringNvatQlfctStatUpdTm增票资质更新时间
taxRegCertIdStringNtaxRegCertId税务登记证图片标识
bankAcctPermitIdStringNbankAcctPermitId开户银行许可证图片标识
taxPayerCertIdStringNtaxPayerCertId一般纳税人证书图片标识
vatConsignIdStringNvatConsignId增票授权委托书图片标识
vatAddressInfoDTOStringN
addrTypeStringNaddrType地址类型
addrNumStringNaddrNum地址编号
preferFlagStringNpreferFlag首选标识
countryStringNcountry国家
stateStringNstate发票寄送地址(省)
cityStringNcity发票寄送地址(市)
townStringNtown发票寄送地址(区/县)
streetStringNstreet发票寄送地址(街道/镇)
additionalOneStringNadditionalOne发票寄送地址( 路/道/街)
additionalTwoStringNadditionalTwo发票寄送地址( 弄/巷/胡同)
additionalThreeStringNadditionalThree发票寄送地址(号)
additionalFourStringNadditionalFour发票寄送地址(小区/大厦/单位/村)
detailAddressStringNdetailAddress发票寄送地址(详细地址)
postCodeStringNpostCode邮政编码
teleCntryCodeStringNteleCntryCode固话国家号
teleAreaCodeStringNteleAreaCode固话区号
teleNumStringNteleNum固话号码
teleExtnStringNteleExtn固话分机
cntctPointNameStringNcntctPointName发票收件人姓名
mobileNumOneStringNmobileNumOne联系人手机
mobileNumTwoStringNmobileNumTwo联系人手机2
createTimeStringNcreateTime创建时间
updateTimeStringNupdateTime更新时间
响应参数
名称 类型 示例值 描述
resultFlagStringYY:成功 N:失败
请求示例
  • XML示例
  • JSON示例
复制全部代码 
                                
<sn_request>
  <sn_body>
    <createSubmitvarinvoice>
      <vatInvoiceInfoDTO>
        <vatQlfctStatUpdTm>vatQlfctStatUpdTm</vatQlfctStatUpdTm>
        <certType>certType</certType>
        <orgName>orgName</orgName>
        <bankAcctPermitId>bankAcctPermitId</bankAcctPermitId>
        <bankName>bankName</bankName>
        <vatQlfctStat>vatQlfctStat</vatQlfctStat>
        <taxPayerCertId>taxPayerCertId</taxPayerCertId>
        <vatConsignId>vatConsignId</vatConsignId>
        <certNo>certNo</certNo>
        <orgAddr>orgAddr</orgAddr>
        <bankDepositAcnt>bankDepositAcnt</bankDepositAcnt>
        <orgTel>orgTel</orgTel>
        <taxRegCertId>taxRegCertId</taxRegCertId>
        <vatQlfctStatUpdRsn>vatQlfctStatUpdRsn</vatQlfctStatUpdRsn>
      </vatInvoiceInfoDTO>
      <vatAddressInfoDTO>
        <additionalThree>additionalThree</additionalThree>
        <country>country</country>
        <additionalFour>additionalFour</additionalFour>
        <addrNum>addrNum</addrNum>
        <town>town</town>
        <city>city</city>
        <mobileNumTwo>mobileNumTwo</mobileNumTwo>
        <additionalTwo>additionalTwo</additionalTwo>
        <teleCntryCode>teleCntryCode</teleCntryCode>
        <updateTime>updateTime</updateTime>
        <teleExtn>teleExtn</teleExtn>
        <mobileNumOne>mobileNumOne</mobileNumOne>
        <additionalOne>additionalOne</additionalOne>
        <teleNum>teleNum</teleNum>
        <preferFlag>preferFlag</preferFlag>
        <createTime>createTime</createTime>
        <street>street</street>
        <cntctPointName>cntctPointName</cntctPointName>
        <detailAddress>detailAddress</detailAddress>
        <postCode>postCode</postCode>
        <state>state</state>
        <teleAreaCode>teleAreaCode</teleAreaCode>
        <addrType>addrType</addrType>
      </vatAddressInfoDTO>
      <appId>111111</appId>
      <snCustNum>111111</snCustNum>
      <submitFlag>submitFlag</submitFlag>
    </createSubmitvarinvoice>
  </sn_body>
</sn_request>

			
                                
                                
{
  "sn_request": {
    "sn_body": {
      "createSubmitvarinvoice": {
        "vatInvoiceInfoDTO": {
          "vatQlfctStatUpdTm": "vatQlfctStatUpdTm",
          "certType": "certType",
          "orgName": "orgName",
          "bankAcctPermitId": "bankAcctPermitId",
          "bankName": "bankName",
          "vatQlfctStat": "vatQlfctStat",
          "taxPayerCertId": "taxPayerCertId",
          "vatConsignId": "vatConsignId",
          "certNo": "certNo",
          "orgAddr": "orgAddr",
          "bankDepositAcnt": "bankDepositAcnt",
          "orgTel": "orgTel",
          "taxRegCertId": "taxRegCertId",
          "vatQlfctStatUpdRsn": "vatQlfctStatUpdRsn"
        },
        "vatAddressInfoDTO": {
          "additionalThree": "additionalThree",
          "country": "country",
          "additionalFour": "additionalFour",
          "addrNum": "addrNum",
          "town": "town",
          "city": "city",
          "mobileNumTwo": "mobileNumTwo",
          "additionalTwo": "additionalTwo",
          "teleCntryCode": "teleCntryCode",
          "updateTime": "updateTime",
          "teleExtn": "teleExtn",
          "mobileNumOne": "mobileNumOne",
          "additionalOne": "additionalOne",
          "teleNum": "teleNum",
          "preferFlag": "preferFlag",
          "createTime": "createTime",
          "street": "street",
          "cntctPointName": "cntctPointName",
          "detailAddress": "detailAddress",
          "postCode": "postCode",
          "state": "state",
          "teleAreaCode": "teleAreaCode",
          "addrType": "addrType"
        },
        "appId": "111111",
        "snCustNum": "111111",
        "submitFlag": "submitFlag"
      }
    }
  }
}
响应示例
  • XML示例
  • JSON示例
复制全部代码 
                              
<sn_responseContent>
  <sn_body>
    <createSubmitvarinvoice>
      <resultFlag>Y</resultFlag>
    </createSubmitvarinvoice>
  </sn_body>
</sn_responseContent>

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

  
  	API异常码
  	异常码中文描述
  

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