企业登录API
API说明：本接口用户登录电子税局（仅支持部分场景，是否需要调用可事先联系市场或运维人员）
调用方式：HTTP协议
API编码：ECXML.DZSJ.LOGIN
调用方法：POST(XML文件流)
请求报文规范
<REQUEST_LOGIN class="REQUEST_LOGIN">
<STEP_NAME>方法名称</STEP_NAME>
<NSRSBH>纳税人识别号</NSRSBH>
<USERNAME>用户名</USERNAME>
<PASSWORD>密码</PASSWORD>
<ZRRLX>责任人</ZRRLX>
<SMSCODE>短信验证码</SMSCODE>
<DQBM>地区编码</DQBM>
<AUTO_SMS_LOGIN_FLAG>短信精灵登录开关</AUTO_SMS_LOGIN_FLAG>
</REQUEST_LOGIN>
字段说明
| 数据项 | 名称 | 类型 | 长度 | 必须 | 说明 |
|---|---|---|---|---|---|
| STEP_NAME | 方法名称 | varchar | 20 | 是 | 详见“方法名称与接口后续流程对应关系表”，及参数使用说明。 |
| NSRSBH | 纳税人识别号 | varchar | 20 | 是 | 9-20位大写字母或数字 |
| USERNAME | 用户名 | varchar | 200 | 是 | |
| PASSWORD | 密码 | varchar | 50 | 是 | |
| ZRRLX | 责任人 | varchar | 2 | 否 | 详见“责任人身份类型对照表”， 及参数使用说明。 |
| SMSCODE | 短信验证码 | varchar | 20 | 否 | |
| DQBM | 地区编码 | varchar | 4 | 否 | 详见地区编码清单 |
| AUTO_SMS_LOGIN_FLAG | 短信精灵登录开关 | varchar | 1 | 否 | 0：不启用 1：启用 此功能默认为不启用。 1：启用时，传入的用户名必需为手机号； 2：zrrlx可以选择传入或者不传入（传入时，如果账户拥有此责任人，短信精灵登录时会自动使用，若无此责任人，会自动按照省份和责任人优先顺序自动筛选；不传入责任人，后台会自动筛选） 3： 短信精灵登录启用后，用户可轮询调用查询短信精灵登录结果的步骤，获取短信精灵登录成功或失败的结果: |
【地区编码清单】说明:
| 地区 | 编码 |
|---|---|
| 北京 | 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”为“login”，用户密码必传，获取返回参数，根据返回参数判断是否需要再次调 用登录接口进行后续交互流程；
2、 接口返回参数“step_code”为 0 时，即登录成功。无需再次调用本接口，可进行其他业务逻辑；
3、 接口返回参数“step_code”为 1 时，即告知登录需要校验短信验证，需调用登录接口发送验证码。再次调用本 接口，调用参数中“step_name”为“send_sms”；
4、 接口返回参数“step_code”为 2 时，即告知登录需要选择责任人，返回参数“data”中“personList”字段为 选择责任人列表，解析后用户可选择任意一个责任人。再次调用本接口，调用参数中“step_name”为 “select_zrrlx”，“zrrlx”字段为用户选择责任人编号；
5、 接口返回参数“step_code”为 3 时，即告知登录需要校验短信验证，且验证码已发送，需提交验证码。再次调 用本接口，调用参数中“step_name”为“sms_login”，“smsCode”为用户收到的短信验证码。
参数说明:
| 返回参数step_code | 请求参数step_name | 接口后续流程 |
|---|---|---|
| 0 | 登录成功 | |
| 1 | send_sms | 获取验证码 |
| 2 | select_zrrlx | 选择责任人 |
| 3 | sms_login | 短信登录 |
| 5 | query_auto_login_res | 查询短信精灵自动登录结果 |
| 6 | 短信精灵登录失败 |
责任人身份类型对照表
参数使用说明：
接口返回参数“data”中“01”等字段表示的为当前账号可选择的“身份类型”，编码以“,”间隔，调用方获取 并解析后展示给用户，供用户选择后继续调用登录接口。
参数说明:
| 身份类型 | 责任人 |
|---|---|
| 法定代表人 | 01 |
| 财务负责人 | 02 |
| 办税员 | 03 |
| 管理员 | 05 |
| 领票员 | 07 |
| 社保经办人 | 08 |
| 开票员 | 09 |
| 销售人员 | 10 |
返回报文规范
<RESPONSE_LOGIN class="RESPONSE_LOGIN">
<DATA>["数据"]</DATA>
<STEP_CODE>接口后续流程</STEP_CODE>
</RESPONSE_LOGIN>
字段说明
| 数据项 | 名称 | 类型 | 长度 | 必须 | 说明 |
|---|---|---|---|---|---|
| DATA | 数据 | varchar | 20 | 否 | 详见“责任人身份对照表”及参数使用说明 |
| STEP_CODE | 接口后续流程 | varchar | 20 | 是 |
示例报文
请求报文示例
<?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.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_LOGIN class="REQUEST_LOGIN">
<STEP_NAME>login</STEP_NAME>
<NSRSBH>913101010000000090</NSRSBH>
<USERNAME>12345678</USERNAME>
<PASSWORD>12345678</PASSWORD>
</REQUEST_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.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_LOGIN class="RESPONSE_LOGIN">
<DATA></DATA>
<STEP_CODE>0</STEP_CODE>
</RESPONSE_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.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>