1. 账户服务
开票管理
  • 概述
    • 公共请求参数说明
    • 响应状态码
  • 账户服务
    • 获取access_token
      POST
    • 企业账户登录
      POST
  • 开票服务
    • 获取风险预警级别接口
      POST
    • 获取二维码
      POST
    • 二次认证状态查询接口
      POST
    • 直接发票开具接口（金四）
      POST
    • 货物运输直接发票开具接口（金四）
      POST
    • 申请查询蓝票订单结果（金四）
      POST
    • 获取蓝票订单申请的处理结果（金四）
      POST
    • 发票列表查询（蓝\红票）（金三+金四）
      POST
    • 单张发票查询（蓝\红票）（金四）
      POST
    • 发票下载（金四）
      POST
    • 红字确认单开具接口（金三+金四）
      POST
    • 红字确认单处理（金四）
      POST
    • 红字确认单详情查询（金四）
      POST
    • 红字确认单列表查询（金四）
      POST
    • 红字确认单下载
      POST
    • 发票冲红状态查询（蓝票对应红票状态查询 蓝\红票）（金四）
      POST
    • 发票用票信息状态查询（金四）
      POST
    • 查询发票明细接口（金三+金四）
      POST
  1. 账户服务

企业账户登录

POST
https://skynjweb.com:7443/hx/api/fp/h5.js.electronicTaxBureau.authentication
信息
通过此接口，实现企业使用账号登录电子税务局，因不同地区税局设置不同，可能需要用户选择责任人和填写手机验证码。只有调用登录成功后，才能进行后续业务接口的调用。

业务数据说明#

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

step_codestep_name接口后续流程
0登录成功
1send_sms获取验证码
2select_zrrlx选择责任人
3sms_login短信登录
5query_auto_login_res查询短信精灵自动登录结果
6短信精灵登录失败
参数使用说明：
1.
第一次登录时，“step_name”为“login”，用户密码必传，获取返回参数，根据返回参数判断是否需要再次调用登录接口进行后续交互流程；
2.
接口返回参数“step_code”为 0 时，即登录成功。无需再次调用本接口，可进行其他业务逻辑；
3.
接口返回参数“step_code”为 1 时，即告知登录需要进行二次验证，可选择短信验证或者扫码验证；若选择短信验证，需调用登录接口发送验证码。再次调用本接口，调用参数中“step_name”为“send_sms”；若选择二维码验证，需调用登录接口获取二维码。再次调用本接口，调用参数中“step_name”为“create_qrcode”；其中“app_flags”在获取二维码时如果不填或者填“2”为获取对应地区税局的二维码，填“1”为获取个税 APP 的二维码。
4.
接口返回参数“step_code”为 2 时，即告知登录需要选择责任人，返回参数“data”中为选择责任人列表，用户可选择任意一个责任人。再次调用本接口，调用参数中“step_name”为“select_zrrlx”，“zrrlx”字段为用户选择责任人编号；
5.
接口返回参数“step_code”为 3 时，即告知登录需要校验短信验证，且验证码已发送，需提交验证码。再次调用本接口，调用参数中“step_name”为“sms_login”，“smsCode”为用户收到的短信验证码。
6.
接口返回参数“step_code”为 4 时，需要获取二维码的验证结果。再次调用本接口，调用参数中“step_name”为“verify_qrcode”，“qrcode_id”为获取二维码时返回的“qrcode_id”，“app_flags”与获取二维码时的值保持一致。该接口推荐 4~5 秒请求一次获取结果。
7.
接口返回参数“step_code”为 5 时，触发短信精灵自动登录，需每 2s 轮询调用登录接口查询短信精灵自动登录结果，调用参数中“step_name”为“query_auto_login_res”。

责任人身份类型对照表#

身份类型责任人
法定代表人01
财务负责人02
办税员03
管理员05
领票员07
社保经办人08
开票员09
销售人员10
接口返回参数“data”中“01”等字段表示的为当前账号可选择的“身份类型”，编码以“,”间隔，调用方获取并解析后展示给用户，供用户选择后继续调用登录接口。

地区编码表#

地区编码
北京1100
天津1200
河北1300
山西1400
内蒙古1500
大连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
非虚拟号调用示例：
第一步
请求：
{"password":"123456","nsrsbh":"91441302345678911","step_name":"login","smsCode":"","dqbm":"3200","zrrlx":"09","auto_sms_login_flag":"0","username":"159XXXXXXXX"}
返回：
{"msg":"成功","access_token":"XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX","zipCode":"0","code":1000,"signature":"9C9D6A8B998A42FE3151EAAE2C2FA4130B573C0AE2F915804C0C9980537647C2","datagram":"{"step_code":"1","phone":"1******XXXX"}","signtype":"HMacSHA256","encryptCode":"2","interfaceCode":"h5.js.electronicTaxBureau.authentication"}
第二步
请求：
{"password":"123456","nsrsbh":"91441302345678911","step_name":"send_sms","smsCode":"","dqbm":"3200","zrrlx":"09","auto_sms_login_flag":"0","app_flags":"","username":"159XXXXXXXX"}
返回：
{"msg":"成功","access_token":"XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX","zipCode":"0","code":1000,"signature":"14C0842C82E94BB9DCAB7188C0C7154832BE1EF27063FF92115E34485E1EBA4F","datagram":"{"step_code":"3"}","signtype":"HMacSHA256","encryptCode":"2","interfaceCode":"h5.js.electronicTaxBureau.authentication"}
第三步
请求：
{"password":"123456","nsrsbh":"91441302345678911","step_name":"sms_login","smsCode":"822554","dqbm":"3200","zrrlx":"09","auto_sms_login_flag":"0","app_flags":"","username":"159XXXXXXXX"}
返回：
{"msg":"成功","access_token":"XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX","zipCode":"0","code":1000,"signature":"2D530034B7FA020D08EE8095ECD44EBB9629CDB72651DF2B6A4163102290CB69","datagram":"{"data":["03","09"],"step_code":"2"}","signtype":"HMacSHA256","encryptCode":"2","interfaceCode":"h5.js.electronicTaxBureau.authentication"}
第四步：
请求：
{"password":"123456","nsrsbh":"91441302345678911","step_name":"select_zrrlx","smsCode":"822554","dqbm":"3200","zrrlx":"09","auto_sms_login_flag":"0","app_flags":"","username":"159XXXXXXXX"}
返回：
{"msg":"成功","access_token":"XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX","zipCode":"0","code":1000,"signature":"26E63F547377172D41F4E067FC21440F7AFFD8D685A3079946899C54C4DCFF91","datagram":"{"step_code":"0"}","signtype":"HMacSHA256","encryptCode":"2","interfaceCode":"h5.js.electronicTaxBureau.authentication"}

请求参数

Header 参数

Body 参数application/json

示例
{
    "step_name": "string",
    "nsrsbh": "string",
    "username": "string",
    "password": "string",
    "zrrlx": "st",
    "smsCode": "string",
    "dqbm": "stri",
    "auto_sms_login_flag": "s",
    "get_jump_url": "string",
    "jump_url_type": "s",
    "app_flags": "s",
    "qrcode_id": "string",
    "dyfs": "s",
    "dxbz": "s",
    "sms_code_id": "string",
    "reloginflag": "string"
}

请求示例代码

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location 'https://skynjweb.com:7443/hx/api/fp/h5.js.electronicTaxBureau.authentication' \
--header 'nsrsbh: {{socialCreditCode}}' \
--header 'access_token: fa924d996ee50f2db31590c635d651eb2b31b3a2241e3128c72a34e5596810b4' \
--header 'fplx: xxfp' \
--header 'Content-Type: application/json' \
--data '{
    "step_name": "string",
    "nsrsbh": "string",
    "username": "string",
    "password": "string",
    "zrrlx": "st",
    "smsCode": "string",
    "dqbm": "stri",
    "auto_sms_login_flag": "s",
    "get_jump_url": "string",
    "jump_url_type": "s",
    "app_flags": "s",
    "qrcode_id": "string",
    "dyfs": "s",
    "dxbz": "s",
    "sms_code_id": "string",
    "reloginflag": "string"
}'

返回响应

🟢200成功
application/json
Bodyapplication/json

示例
{
    "data": [
        "数据"
    ],
    "step_code": "接口后续流程",
    "sms_waittime": "轮询等待时间",
    "jump_url": "跳转税局的 URL",
    "login_code": "可信登录授权码",
    "qrcode_id": "二维码 ID",
    "qrcode": "二维码",
    "expires_in": "有效时间",
    "qrcode_status": "二维码状态",
    "sms_code_id": "短信 ID"
}
修改于 2026-01-28 06:35:16
上一页
获取access_token
下一页
获取风险预警级别接口
Built with