1. 进项通道登录
用票管理
  • 概述
    • 公共请求参数说明
  • 进项通道登录
    • 获取access_token
      POST
    • 企业账号登录
      POST
    • 虚拟手机号登录
      POST
  • 进项业务接口
    • 发票票种编码
    • 发票状态查询
      POST
    • 【单条】发票明细查询
      POST
    • 全量全电发票下载
      POST
    • 全量全电发票二维码版式文件下载
      POST
    • 【快速】获取进销项发票详情
      POST
    • 【列表】进销项发票概要信息查询
      POST
    • 发票查验结果查询
      POST
    • 实时未认证发票查询
      POST
    • 实时已认证发票查询
      POST
    • 发票勾选
      POST
    • 企业实时申请统计
      POST
    • 企业实时确认签名
      POST
    • 实时不抵扣发票查询
      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/51ys.jx.taxdigital.tpass.login
信息
通过此接口,实现企业使用账号登录电子税务局,因不同地区税局设置不同,可能需要用户选择责任人和填写手机验证码。只有调用登录成功后,才能进行后续业务接口的调用。

业务数据说明#

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

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”;
4.
接口返回参数“step_code”为 2 时,即告知登录需要选择责任人,返回参数“data”中“personList”字段为选择责任人列表,解析后用户可选择任意一个责任人。再次调用本接口,调用参数中“step_name”为“select_zrrlx”,“zrrlx”字段为用户选择责任人编号;
5.
接口返回参数“step_code”为 3 时,即告知登录需要校验短信验证,且验证码已发送,需提交验证码。再次调用本接口,调用参数中“step_name”为“sms_login”,“smsCode”为用户收到的短信验证码。

责任人身份类型对照表#

身份类型责任人
法定代表人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

请求参数

Header 参数

Body 参数application/json

示例
{
    "step_name": "string",
    "nsrsbh": "string",
    "username": "string",
    "password": "string",
    "zrrlx": "st",
    "smsCode": "string",
    "dqbm": "stri"
}

请求示例代码

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/51ys.jx.taxdigital.tpass.login' \
--header 'nsrsbh: {{socialCreditCode}}' \
--header 'access_token: 89f84ac13cf31e42fc751086b82073572b8f51b914bb3421f205e34679b5f1cc' \
--header 'fplx: jxfp' \
--header 'Content-Type: application/json' \
--data '{
    "step_name": "string",
    "nsrsbh": "string",
    "username": "string",
    "password": "string",
    "zrrlx": "st",
    "smsCode": "string",
    "dqbm": "stri"
}'

返回响应

🟢200成功
application/json
Bodyapplication/json

示例
{
    "data": {},
    "step_code": 0
}
修改于 2026-05-26 02:06:21
上一页
获取access_token
下一页
虚拟手机号登录
Built with