API接口目录

零售云业务

采购API
订单API
库存API
价格API
商品API
报表API
消息服务API
基础数据API
物流API
零售商认证API
发票API
快修回收API
云仓API
异常码自查工具
suning.retailer.vatinvoiceinfoforma.get 根据易购会员编码查询会员增票信息
¥免费

根据易购会员编码查询会员增票信息

公共参数
请求参数
名称 类型 是否必须 示例值 描述
appIdStringY111111调用方唯一编码
snCustNumStringN7017963441登录人易购会员编码
响应参数
名称 类型 示例值 描述
respBeanString
custTypeString1450会员类型
contactMobileNumString联系人手机号13112345678
registerDetailAddressString单位注册地址单位注册地址
registerTelephoneString单位注册电话单位注册电话
vatInvoiceInfoDTOString
orgNameString增票名称增票名称
certTypeStringcertType证件类型
certNoStringcertNo税务登记证号
orgAddrStringorgAddr单位地址
orgTelStringorgTel单位电话
bankNameStringbankName开户银行
bankDepositAcntStringbankDepositAcnt开户银行账号
vatQlfctStatStringvatQlfctStat增票资质状态
vatQlfctStatUpdRsnStringvatQlfctStatUpdRsn增票资质更新原因
vatQlfctStatUpdTmStringvatQlfctStatUpdTm增票资质更新时间
taxRegCertIdStringtaxRegCertId税务登记证图片标识
bankAcctPermitIdStringbankAcctPermitId开户银行许可证图片标识
taxPayerCertIdStringtaxPayerCertId一般纳税人证书图片标识
vatConsignIdStringvatConsignId增票授权委托书图片标识
vatAddressInfoDTOString
addrTypeStringaddrType地址类型
addrNumStringaddrNum地址编号
preferFlagStringpreferFlag首选标识
countryStringcountry国家
stateStringstate发票寄送地址(省)
cityStringcity发票寄送地址(市)
townStringtown发票寄送地址(区/县)
streetStringstreet发票寄送地址(街道/镇)
additionalOneStringadditionalOne发票寄送地址( 路/道/街)
additionalTwoStringadditionalTwo发票寄送地址( 弄/巷/胡同)
additionalThreeStringadditionalThree发票寄送地址(号)
additionalFourStringadditionalFour发票寄送地址(小区/大厦/单位/村)
detailAddressStringdetailAddress发票寄送地址(详细地址)
postCodeStringpostCode邮政编码
teleCntryCodeStringteleCntryCode固话国家号
teleAreaCodeStringteleAreaCode固话区号
teleNumStringteleNum固话号码
teleExtnStringteleExtn固话分机
cntctPointNameStringcntctPointName发票收件人姓名
mobileNumOneStringmobileNumOne联系人手机
mobileNumTwoStringmobileNumTwo联系人手机2
请求示例
  • XML示例
  • JSON示例
复制全部代码
                                
<sn_request>
  <sn_body>
    <getVatinvoiceinfoforma>
      <appId>111111</appId>
      <snCustNum>7017963441</snCustNum>
    </getVatinvoiceinfoforma>
  </sn_body>
</sn_request>

			
                                
                                
{
  "sn_request": {
    "sn_body": {
      "getVatinvoiceinfoforma": {
        "appId": "111111",
        "snCustNum": "7017963441"
      }
    }
  }
}
			
                                
响应示例
  • XML示例
  • JSON示例
复制全部代码
                              
<sn_responseContent>
  <sn_body>
    <getVatinvoiceinfoforma>
      <respBean>
        <contactMobileNum>联系人手机号</contactMobileNum>
        <vatInvoiceInfoDTO>
          <vatQlfctStatUpdTm>vatQlfctStatUpdTm</vatQlfctStatUpdTm>
          <certType>certType</certType>
          <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>
          <teleExtn>teleExtn</teleExtn>
          <mobileNumOne>mobileNumOne</mobileNumOne>
          <additionalOne>additionalOne</additionalOne>
          <teleNum>teleNum</teleNum>
          <preferFlag>preferFlag</preferFlag>
          <street>street</street>
          <cntctPointName>cntctPointName</cntctPointName>
          <detailAddress>detailAddress</detailAddress>
          <postCode>postCode</postCode>
          <state>state</state>
          <teleAreaCode>teleAreaCode</teleAreaCode>
          <addrType>addrType</addrType>
        </vatAddressInfoDTO>
        <custType>1450</custType>
        <registerTelephone>单位注册电话</registerTelephone>
        <registerDetailAddress>单位注册地址</registerDetailAddress>
      </respBean>
    </getVatinvoiceinfoforma>
  </sn_body>
</sn_responseContent>

			
                              
                              
{
  "sn_responseContent": {
    "sn_body": {
      "getVatinvoiceinfoforma": {
        "respBean": {
          "contactMobileNum": "联系人手机号",
          "vatInvoiceInfoDTO": {
            "vatQlfctStatUpdTm": "vatQlfctStatUpdTm",
            "certType": "certType",
            "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",
            "teleExtn": "teleExtn",
            "mobileNumOne": "mobileNumOne",
            "additionalOne": "additionalOne",
            "teleNum": "teleNum",
            "preferFlag": "preferFlag",
            "street": "street",
            "cntctPointName": "cntctPointName",
            "detailAddress": "detailAddress",
            "postCode": "postCode",
            "state": "state",
            "teleAreaCode": "teleAreaCode",
            "addrType": "addrType"
          },
          "custType": "1450",
          "registerTelephone": "单位注册电话",
          "registerDetailAddress": "单位注册地址"
        }
      }
    }
  }
}
			
                              
异常示例
  • XML示例
  • JSON示例
复制全部代码

  
  	API异常码
  	异常码中文描述
  

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