根据易购会员编码查询会员增票信息
名称 | 类型 | 是否必须 | 示例值 | 描述 |
---|---|---|---|---|
appMethod | String | Y | suning.custom.category.query | 方法名 |
appRequestTime | String | Y | 2012-04-25 20:23:30 | 时间戳,格式为yyyy-MM-dd HH:mm:ss,例如:2012-04-25 20:23:30。API服务端允许客户端请求时间误差为10分钟。 |
format | String | N | XML | 默认xml,可指定格式为xml,json |
appKey | String | Y | b0c332a133c102765f39de********** | 分配给应用的访问令牌 |
versionNo | String | Y | v1.2 | API的版本,目前为v1.2版本 |
signInfo | String | Y | 460d7ff15b073e463125b4********** | appSecret,appMethod ,appRequestTime, appKey, versionNo, 请求报文base64加密后的数据顺序MD5(32位小写),其中appSecret为appKey对应的密钥 |
access_token | String | N | a1c5c62b08df3a3cbf7efd********** | 采用OAuth授权方式为必填参数 |
名称 | 类型 | 是否必须 | 示例值 | 描述 |
---|---|---|---|---|
appId | String | Y | 111111 | 调用方唯一编码 |
snCustNum | String | N | 7017963441 | 登录人易购会员编码 |
名称 | 类型 | 示例值 | 描述 |
---|---|---|---|
respBean | String | ||
custType | String | 1450 | 会员类型 |
contactMobileNum | String | 联系人手机号 | 13112345678 |
registerDetailAddress | String | 单位注册地址 | 单位注册地址 |
registerTelephone | String | 单位注册电话 | 单位注册电话 |
vatInvoiceInfoDTO | String | ||
orgName | String | 增票名称 | 增票名称 |
certType | String | certType | 证件类型 |
certNo | String | certNo | 税务登记证号 |
orgAddr | String | orgAddr | 单位地址 |
orgTel | String | orgTel | 单位电话 |
bankName | String | bankName | 开户银行 |
bankDepositAcnt | String | bankDepositAcnt | 开户银行账号 |
vatQlfctStat | String | vatQlfctStat | 增票资质状态 |
vatQlfctStatUpdRsn | String | vatQlfctStatUpdRsn | 增票资质更新原因 |
vatQlfctStatUpdTm | String | vatQlfctStatUpdTm | 增票资质更新时间 |
taxRegCertId | String | taxRegCertId | 税务登记证图片标识 |
bankAcctPermitId | String | bankAcctPermitId | 开户银行许可证图片标识 |
taxPayerCertId | String | taxPayerCertId | 一般纳税人证书图片标识 |
vatConsignId | String | vatConsignId | 增票授权委托书图片标识 |
vatAddressInfoDTO | String | ||
addrType | String | addrType | 地址类型 |
addrNum | String | addrNum | 地址编号 |
preferFlag | String | preferFlag | 首选标识 |
country | String | country | 国家 |
state | String | state | 发票寄送地址(省) |
city | String | city | 发票寄送地址(市) |
town | String | town | 发票寄送地址(区/县) |
street | String | street | 发票寄送地址(街道/镇) |
additionalOne | String | additionalOne | 发票寄送地址( 路/道/街) |
additionalTwo | String | additionalTwo | 发票寄送地址( 弄/巷/胡同) |
additionalThree | String | additionalThree | 发票寄送地址(号) |
additionalFour | String | additionalFour | 发票寄送地址(小区/大厦/单位/村) |
detailAddress | String | detailAddress | 发票寄送地址(详细地址) |
postCode | String | postCode | 邮政编码 |
teleCntryCode | String | teleCntryCode | 固话国家号 |
teleAreaCode | String | teleAreaCode | 固话区号 |
teleNum | String | teleNum | 固话号码 |
teleExtn | String | teleExtn | 固话分机 |
cntctPointName | String | cntctPointName | 发票收件人姓名 |
mobileNumOne | String | mobileNumOne | 联系人手机 |
mobileNumTwo | String | mobileNumTwo | 联系人手机2 |
<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": "单位注册地址" } } } } }
异常码 | 错误描述 | 解决方案 |
---|---|---|
biz.retailer.getvatinvoiceinfoforma.missing-parameter:* | 参数必填 | 请检查此参数的值,*号表示参数字段名 |
biz.handler.data-get:no-result | 查询没结果 | 请检查查询参数 |
isp.sys.service.unavailable.srcdss | 服务不可用 | 请联系苏宁技术人员 |
异常码 | 错误描述 | 解决方案 |
---|---|---|
sys.check.user-permission:inexistence | 访问令牌不存在 | 更换访问令牌 |
sys.check.user-permission:overdue | 访问令牌已过期 | 请使用刷新令牌刷新 |
sys.check.api-permission:inexistence | Api方法不存在 | 请参考帮助中心 |
sys.check.api-permission:overdue | Api方法已过期 | 请参考帮助中心 |
sys.check.method-permission:authority | 无权操作此api | 确认是否有访问该方法权限 |
sys.auth.vendor-request:errory | 无权操作此供应商 | 请确认供应商编码是否正确 |
sys.controller.api-request:limit | Api请求受控 | 超过请求次数 |
sys.check.app-time:error | 请求参数错误api请求时间误差大 | 参考帮助中心 |
sys.check.request-params:error | 请求报文结构错误 | 参考帮助中心、日期格式等 |
sys.check.starttime-format:error | 请求开始时间错误 | 参考帮助中心、日期格式等 |
biz.handler.data-get:success | 业务数据查询成功 | 无 |
biz.handler.data-get:fail | 业务数据查询失败 | 检查请求条件 |
biz.handler.data-get:no-result | 业务数据结果为空 | 无 |
sys.check.pageno-format:error | pageNo格式错误,只允许1到99999之间的整数 | 检查pageNo输入是否有误 |
sys.check.pagesize-format:error | pageSize格式错误,只允许1到50之间的整数(订单相关是1到100) | 检查pageSize输入是否有误 |
sys.check.page-param:error | pageNo或者pageSize不在要求范围内,pageNo只允许1到99999之间的整数,pageSize只允许1到50之间的整数(订单相关是1到100) | 检查pageNo和pageSize输入是否有误 |
sys.check.miss-time:starttime | 不存在开始时间(节点) | 检查输入 |
sys.check.miss-time:endtime | 不存在结束时间(节点) | 检查输入 |
sys.check.starttime-value:null | 开始时间为空(值) | 检查输入 |
sys.check.endtime-value:null | 结束时间为空(值) | 检查输入 |
sys.check.starttime-format:error | 校验开始时间不合法,格式yyyy-MM-dd HH:mm:ss | 检查时间格式 |
sys.check.endtime-format:error | 校验结束时间不合法,格式yyyy-MM-dd HH:mm:ss | 检查时间格式 |
sys.check.query-time:error | 开始时间是否小于结束时间 | 检查开始和结束时间大小 |
sys.check.query-time:outofrange | 时间查询是否超出指定范围 | 检查时间范围 |
sys.check.app-sign:null | 签名信息为空 | 检查签名信息 |
sys.check.app-sign:error | 签名信息错误 | 检查签名信息 |
sys.check.missing-parameter:apiversion | API版本号未指定 | 检查API版本号 |
sys.check.missing-parameter:appRequestTime | 请求时间丢失 | 检查请求时间 |
sys.check.missing-nestElement:sn_body | 缺少sn_body节点 | 检查sn_body是否存在 |
sys.check.user-permission:inexistence | 用户key不存在 | 检查用户key是否存在 |
biz.handler.batch-handler:no-support | 非查询类API不支持批量操作 | 检查API类型 |
biz.handler.request-message:error | 查询类API输入多个业务节点 | 检查业务节点 |
sys.check.header-param:null | header参数为空 | 请检查header参数 |
sys.controller.api-access:limit | 访问限制 | 无 |
sys.controller.api-frequency:limit | 访问频率限制 | 无 |
sys.error.network:failure | 网络异常 | 无 |
sys.error.network-status:? | 响应失败 ?为状态码 | 无 |
sys.check.snunionid.length.is.not:48 | 混淆会员编码长度不是48位 | 使用转换器转换混淆会员编码规定要求混淆会员编码48位 |