代理企业登录API

API说明：本接口用户登录电子税局（仅支持部分场景，是否需要调用可事先联系市场或运维人员）
调用方式：HTTP协议
API编码：ECXML.DZSJ.PROXY.LOGIN
调用方法：POST(XML文件流)

请求报文规范

<REQUEST_PROXY_LOGIN class="REQUEST_PROXY_LOGIN">
    <STEP_NAME>方法名称</STEP_NAME>
    <NSRSBH>纳税人识别号</NSRSBH>
    <USERNAME>用户名</USERNAME>
    <PASSWORD>密码</PASSWORD>
    <SELECT_NSRSBH>要选择的企业税号</SELECT_NSRSBH>
    <SMSCODE>短信验证码</SMSCODE>
    <DQBM>地区编码</DQBM>
</REQUEST_PROXY_LOGIN>

字段说明

【地区编码清单】说明:

方法名称与接口后续流程对应关系表

参数使用说明：
1、 第一次登录时，“step_name”为“agency_login”，用户密码必传，获取返回参数，根据返回参数判断是否需要再次调用登录接口进行后续交互流程；
2、 接口返回参数“step_code”为 0 时，即登录成功。无需再次调用本接口，可进行其他业务逻辑；
3、 接口返回参数“step_code”为 1 时，即告知登录需要二次验证，目前只有短信验证方式；短信验证，需调用登录接口发送验证码。再次调用本接口，调用参数中“step_name”为“agency_send_sms”；
4、 接口返回参数“step_code”为 3 时，即告知登录需要校验短信验证，且验证码已发送，需提交验证码。再次调用本接口，调用参数中“step_name”为“agency_sms_login”，“smsCode”为用户收到的短信验证码。
5、 接口返回参数“step_code”为 5 时，需选择要登录的企业，返回参数中的 select_nsrsbh 为可选择企业的税号，company_name为可选择企业的名称；再次调用本接口，调用参数中“step_name”为“agency_login_select_company”，select_nsrsbh 为上一步要选择的企业税号

参数说明:

返回报文规范

<RESPONSE_PROXY_LOGIN class="RESPONSE_PROXY_LOGIN">
    <QYXXS class="QYXX;" size="1">
        <QYXX>
            <SELECT_NSRSBH>可选择企业的税号</SELECT_NSRSBH>
            <COMPANY_NAME>可选择企业的名称</COMPANY_NAME>
        </QYXX>
    </QYXXS>
    <STEP_CODE>接口后续流程</STEP_CODE>
</RESPONSE_PROXY_LOGIN>

字段说明

示例报文

请求报文示例

<?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</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 class="REQUEST_PROXY_LOGIN">
                <STEP_NAME>agency_login</STEP_NAME>
                <NSRSBH>913101010000000090</NSRSBH>
                <USERNAME>12345678</USERNAME>
                <PASSWORD>12345678</PASSWORD>
            </REQUEST_PROXY_LOGIN>
        </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 class="RESPONSE_PROXY_LOGIN">
                <STEP_CODE>0</STEP_CODE>
                <QYXXS class="QYXX;" size="0"/>
            </RESPONSE_PROXY_LOGIN>
        </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</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>