切换代理登录企业API
API说明:通过此接口,实现切换代理登录成功企业功能,必须在登录完成之后才能使用本接口(仅支持部分场景,是否需要调用可事先联系市场或运维人员)
调用方式:HTTP协议
API编码:ECXML.DZSJ.PROXY.LOGIN.CHANGE
调用方法:POST(XML文件流)
请求报文规范
<REQUEST_PROXY_LOGIN_CHANGE class="REQUEST_PROXY_LOGIN_CHANGE">
<STEP_NAME>方法名称</STEP_NAME>
<NSRSBH>纳税人识别号</NSRSBH>
<DQBM>地区编码</DQBM>
<USERNAME>用户名</USERNAME>
<PAGE_NO>页码</PAGE_NO>
<PAGE_SIZE>每页数量</PAGE_SIZE>
<SELECT_NSRSBH>税号筛选</SELECT_NSRSBH>
<SEARCH_NSRMC>纳税人名称筛选</SEARCH_NSRMC>
<UID>UID</UID>
<FID>身份ID</FID>
<REG_NUMBER>注册码</REG_NUMBER>
<UNIQUE_IDENTITY>唯一身份ID</IDENTITY>
<RELATE_TYPE>责任人类型</RELATE_TYPE>
</REQUEST_PROXY_LOGIN_CHANGE>
字段说明
| 数据项 | 名称 | 类型 | 长度 | 必须 | 说明 |
|---|---|---|---|---|---|
| STEP_NAME | 方法名称 | varchar | 20 | 是 | 第一步 get_company 第二步 get_zrrlx 第三步 change_user |
| NSRSBH | 纳税人识别号 | varchar | 20 | 是 | 当前登录税号 |
| DQBM | 地区编码 | varchar | 4 | 是 | 详见地区编码清单 |
| USERNAME | 用户名 | varchar | 100 | 是 | |
| PAGE_NO | 页码 | varchar | 20 | 否 | |
| PAGE_SIZE | 每页数量 | varchar | 20 | 否 | |
| SELECT_NSRSBH | 税号筛选 | varchar | 20 | 否 | |
| SELECT_NSRMC | 纳税人名称筛选 | varchar | 100 | 否 | |
| UID | UID | varchar | 50 | 否 | 取自第一步get_company返回内容中的UID |
| FID | 身份ID | varchar | 50 | 否 | 取自第一步get_company返回内容中的FID |
| REG_NUMBER | 注册码 | varchar | 50 | 否 | 取自第一步get_company返回内容中的REG_NUMBER |
| UNIQUE_IDENTITY | 目标税号 | varchar | 20 | 否 | 取自第一步get_zrrlx返回内容中的UNIQUE_IDENTITY |
| RELATE_TYPE | 责任人类型 | varchar | 2 | 否 | 取自第二步get_zrrlx返回内容中的RELATION_STATUS |
【地区编码清单】说明:
| 地区 | 编码 |
|---|---|
| 北京 | 1100 |
| 天津 | 1200 |
| 河北 | 1300 |
| 山西 | 1400 |
| 内蒙古 | 1500 |
| 辽宁 | 2100 |
| 大连 | 2102 |
| 吉林 | 2200 |
| 黑龙江 | 2300 |
| 上海 | 3100 |
| 江苏 | 3200 |
| 浙江 | 3300 |
| 宁波 | 3302 |
| 安徽 | 3400 |
| 福建 | 3500 |
| 厦门 | 3502 |
| 江西 | 3600 |
| 山东 | 3700 |
| 青岛 | 3702 |
| 河南 | 4100 |
| 湖北 | 4200 |
| 湖南 | 4300 |
| 广东 | 4400 |
| 深圳 | 4403 |
| 广西 | 4500 |
| 海南 | 4600 |
| 重庆 | 5000 |
| 四川 | 5100 |
| 贵州 | 5200 |
| 云南 | 5300 |
| 西藏 | 5400 |
| 陕西 | 6100 |
| 甘肃 | 6200 |
| 青海 | 6300 |
| 宁夏 | 6400 |
| 新疆 | 6500 |
方法名称与接口后续流程对应关系表
参数使用说明:
1、 “step_name”为“get_company”,纳税人识别号、页码、每页数量、地区编码、用户名必传,获取返回参数,根据返回参数判断是否有可以切换的企业;
2、 在“get_company”接口返回由其他企业时,可以调用“step_name”为“get_zrrlx”,纳税人识别号、地区编码、用户名、uid、目标税号、注册码必传,获取返回参数,根据返回参数判断可以切换的责任人类型
3、 在“get_zrrlx”接口返回责任人类型后,可以调用“step_name”为“change_user”,纳税人识别号、地区编码、用户名、目标税号、责任人类型必传,当“step_code“为0时即为登录成功
方法名称与接口后续流程对应关系:
| 请求参数step_name | 接口后续流程 |
|---|---|
| get_company | 获取公司名称 |
| get_zrrlx | 获取责任人类型 |
| change_user | 选择责任人 |
返回报文规范
<RESPONSE_PROXY_LOGIN_CHANGE class="RESPONSE_PROXY_LOGIN_CHANGE">
<STEP_CODE>接口后续流程</STEP_CODE>
<TOTAL>总数</TOTAL>
<COMPANYS class="COMPANY;" size="1">
<COMPANY>
<FID>身份ID</FID>
<UID>UUID</UID>
<REG_NUMBER>注册码</REG_NUMBER>
<UNIQUE_IDENTITY>企业税号</UNIQUE_IDENTITY>
<ENTERPRISE_NAME>企业名称</ENTERPRISE_NAME>
</COMPANY>
</COMPANYS>
<ZRRLXS class="ZRRLX;" size="1">
<ZRRLX>
<UNIQUE_IDENTITY>企业税号</UNIQUE_IDENTITY>
<RELATION_STATUS>责任人类型</RELATION_STATUS>
<ENTERPRISE_NAME>企业名称</ENTERPRISE_NAME>
</ZRRLX>
</ZRRLXS>
</RESPONSE_PROXY_LOGIN_CHANGE>
字段说明
| 数据项 | 名称 | 类型 | 长度 | 必须 | 说明 |
|---|---|---|---|---|---|
| STEP_CODE | 接口后续流程 | varchar | 20 | 否 | |
| TOTAL | 总数 | varchar | 5 | 否 | |
| FID | 身份ID | varchar | 50 | 否 | |
| UUID | UID | varchar | 50 | 否 | |
| REG_NUMBER | 注册码 | varchar | 50 | 否 | |
| UNIQUE_IDENTITY | 企业税号 | varchar | 20 | 否 | |
| ENTERPRISE_NAME | 企业名称 | varchar | 100 | 否 | |
| RELATION_STATUS | 责任人类型 | varchar | 2 | 否 |
示例报文
请求报文示例
<?xml version="1.0" encoding="utf-8"?>
<interface
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://www.chinatax.gov.cn/tirip/dataspec/interfaces.xsd"
version="DZFP1.0">
<globalInfo>
<terminalCode>0</terminalCode>
<appId>ZZS_PT_DZFP</appId>
<version>1.0</version>
<interfaceCode>ECXML.DZSJ.PROXY.LOGIN.CHANGE</interfaceCode>
<requestCode>P1000001</requestCode>
<requestTime>2016-11-28 10:19:16</requestTime>
<responseCode>121</responseCode>
<dataExchangeId>P1000001ECXML.FPKJ.BC.E_INV20161128eXl4EymmJ</dataExchangeId>
<userName>P1000001</userName>
<passWord></passWord>
<taxpayerId>913101010000000090</taxpayerId>
<authorizationCode>NH873FG4KW</authorizationCode>
</globalInfo>
<returnStateInfo>
<returnCode>0000</returnCode>
<returnMessage>0000</returnMessage>
</returnStateInfo>
<Data>
<dataDescription>
<zipCode>0</zipCode>
<encryptCode>1</encryptCode>
<codeType>3DES</codeType>
</dataDescription>
<content>
<REQUEST_PROXY_LOGIN_CHANGE class="REQUEST_PROXY_LOGIN_CHANGE">
<STEP_NAME>agency_login</STEP_NAME>
<NSRSBH>913101010000000090</NSRSBH>
<USERNAME>12345678</USERNAME>
<DQBM>3100</DQBM>
<PAGE_NO>1</PAGE_NO>
<PAGE_SIZE>10</PAGE_SIZE>
</REQUEST_PROXY_LOGIN_CHANGE>
</content>
</Data>
</interface>
返回报文示例(成功)
<?xml version="1.0" encoding="UTF-8"?>
<interface
xmlns:schemaLocation="http://www.chinatax.gov.cn/tirip/dataspec/interfaces.xsd"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" version="WLFP1.0">
<globalInfo>
<terminalCode>0</terminalCode>
<appId>ZZS_PT_DZFP</appId>
<version>1</version>
<interfaceCode>ECXML.DZSJ.PROXY.LOGIN</interfaceCode>
<requestCode>121</requestCode>
<requestTime>2018-11-21 10:19:16</requestTime>
<responseCode />
<dataExchangeId>P1000001ECXML.FPKJ.BC.E_INV20161128eXl4EymmJ</dataExchangeId>
<userName>P1000001</userName>
<passWord/>
<taxpayerId>913101010000000090</taxpayerId>
<authorizationCode>NH873FG4KW</authorizationCode>
</globalInfo>
<returnStateInfo>
<returnCode>0000</returnCode>
<returnMessage>5p+l6K+i5Y2V5byg5byA56Wo6ZmQ6aKd5L+h5oGv5oiQ5Yqf77yB</returnMessage>
</returnStateInfo>
<Data>
<dataDescription>
<zipCode>0</zipCode>
<encryptCode>1</encryptCode>
<codeType>3DES</codeType>
</dataDescription>
<content>
<RESPONSE_PROXY_LOGIN_CHANGE class="RESPONSE_PROXY_LOGIN_CHANGE">
<STEP_CODE>0</STEP_CODE>
</RESPONSE_PROXY_LOGIN_CHANGE>
</content>
</Data>
</interface>
返回报文示例(失败)
<?xml version="1.0" encoding="UTF-8"?>
<interface
xmlns:schemaLocation="http://www.chinatax.gov.cn/tirip/dataspec/interfaces.xsd"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" version="WLFP1.0">
<globalInfo>
<terminalCode>0</terminalCode>
<appId>ZZS_PT_DZFP</appId>
<version>2.0</version>
<interfaceCode>ECXML.DZSJ.PROXY.LOGIN.CHANGE</interfaceCode>
<requestCode>P1000001</requestCode>
<requestTime>2019-04-18 10:30:42</requestTime>
<responseCode>121</responseCode>
<dataExchangeId>P100000120160801000000001</dataExchangeId>
<userName>P1000001</userName>
<passWord/>
<taxpayerId>913101010000000090</taxpayerId>
<authorizationCode>NH873FG4KW</authorizationCode>
</globalInfo>
<returnStateInfo>
<returnCode>9999(或者是其它错误码)</returnCode>
<returnMessage>Base64(错误信息)</returnMessage>
</returnStateInfo>
<Data>
<dataDescription>
<zipCode>0</zipCode>
<encryptCode>1</encryptCode>
<codeType>3DES</codeType>
</dataDescription>
<content/>
</Data>
</interface>