切换代理登录企业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>
Copyright © Shanghai Aisino Co.,Ltd 版权所有 侵权必究该文件修订时间: 2026-05-19 14:40:56

results matching ""

    No results matching ""