企享云API(适配版本)
  1. 自持登录
企享云API(适配版本)
  • 基本介绍
  • 快速开始
    • 开发必读
    • 对接地址
    • SDK集成
    • 认证鉴权
    • 接口调用
    • 加密说明
  • 前置流程
    • 业务指引
    • 证书申请指引
    • 证书对接前置流程
    • 小号申请指引
  • 公共业务
    • 鉴权
      • 获取access_token
    • 订购
      • 自然人获取企业列表
      • 订购产品
      • 订购取消
      • 订购查询
      • 企业取消授权
    • 自然人
      • 自然人创建接口
      • 自然人修改接口
      • 自然人删除接口
    • 通知预警
      • 客户通知
    • 附录
      • 地区代码
  • 登录业务
    • 简介
    • 登录
      • 托管模式
        • 登录接口
        • 通用账户创建
        • 账号启用
        • 登录电票平台接口
        • 校验电局账号有效性
      • 自持登录
        • 自然人同步登录接口
          POST
        • 自然人异步登录发送验证码接口
          POST
        • 异步登录校验税局缓存是否有效
          POST
        • 异步登录税局【发送短信验证码】
          POST
        • 扫码登录税局(二维码获取)
          POST
        • 扫码登录税局(二维码登录)
          POST
        • 异步登录税局【上传短信验证码登录】
          POST
        • 自然人异步登录税局【上传短信验证码登录】
          POST
        • 上传cookie接口
          POST
      • 校验appkey是否账户自持
        POST
    • 多账号管理
      • 托管模式
        • 托管账号创建
        • 托管账号修改
        • 托管账号删除
        • 托管账号查询
        • 账号产品绑定
        • 账号产品解绑
      • 自持登录
        • 校验异步登录税务数字账户缓存是否有效
        • 异步登录税务数字账户【发送短信验证码】
        • 异步登录税务数字账户【上传短信验证码登录】
  • 发票业务
    • 发票查验
      • 简介
      • 发票查验
      • 税号版数电票查验及版式文件下载
      • 发票查验版式文件下载结果查询
    • 发票认证
      • 简介
      • 发票勾选/代购代缴完税凭证勾选
      • 进项发票勾选结果查询
      • 海关缴款书勾选
      • 海关缴款书勾选结果查询
      • 申请统计接口
      • 发票同步
      • 海关缴款书同步
      • 申请统计
      • 申请统计结果查询
      • 抵扣统计结果获取
      • 多票采集接口
      • 申请确认
      • 申请确认结果查询
    • 发票附录
      • 发票附录
      • 数电票号码规则
  1. 自持登录

自然人同步登录接口

POST
/v2/public/login/ext/syncLoginNature

接口描述#

自然人同步登陆接口
支持2种模式
1:托管模式,直接传入zrrId
2:自持模式,客户需要传入正确的证件号码,个人用户名,密码
目前支持的区域:浙江,天津,湖北
敏感信息支持加密,加密方案参见:加密说明

请求参数

Header 参数
access_token
string 
可选
示例值:
{{access_token}}
req_date
string 
可选
示例值:
{{req_date}}
req_sign
string 
可选
示例值:
{{req_sign}}
Body 参数application/json
dq
string 
地区编码
必需
zjhm
string 
证件号码
可选
只支持身份证号码,当encryptionType=1时该值必须加密
sjyhm
string 
个人用户名
可选
sjmm
string 
个人用户密码
可选
当encryptionType=1时该值必须加密
sjhm
string 
手机号码
可选
zrrId
string 
自然人id
可选
创建自然人时返回的id
encryptionType
integer  | null 
加密类型
可选
1表示加密,默认0不加密
示例
{
    "dq": "3300",
    "zjhm": "134309949848949948",
    "sjyhm": "zzh",
    "sjmm": "123@qwe",
    "sjhm": "15236985632",
    "zrrId": "1718816416966991874"
}

示例代码

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request POST '/v2/public/login/ext/syncLoginNature' \
--header 'access_token: {{access_token}}' \
--header 'req_date: {{req_date}}' \
--header 'req_sign: {{req_sign}}' \
--header 'Content-Type: application/json' \
--data-raw '{
    "dq": "3300",
    "zjhm": "134309949848949948",
    "sjyhm": "zzh",
    "sjmm": "123@qwe",
    "sjhm": "15236985632",
    "zrrId": "1718816416966991874"
}'

返回响应

🟢200成功
application/json
Body
reqId
string 
请求id
必需
success
boolean 
必需
code
string 
返回code
必需
data
object 
业务数据
必需
tpass
object 
税局tpass
必需
message
string 
错误信息描述
必需
示例
{
    "reqId": "76bf6b8d897f4ef5ae6a63b15cb27795",
    "success": true,
    "code": "2000",
    "data": {
        "tpass": {
            "cookie": "DZSWJ_TGC=cb78d53c9e044a619b60b6df2d6288d5; SSO_LOGIN_TGC=b22192f4eba04d94ae6e56fa12197409; expire=1800; session_expire=18000001698395985157; token=eyJhbGciOiJIUzUxMiJ9.eyJsb2dpbl91c2VyX2tleSI6ImJiMzk1MTJjMmNhNzQyNjJiNjNmM2QyMGFkMTk4OGMxIn0.LnZGCWIeAsozJhnHuiW4Cq2MiVUCF9Q35C_2YWS4rW9_QAfkKNtyz-Mgt-fqUBNK8qP3Q0DELcV6LNyiAvX63Q",
            "localStorage": {
                "naturepublicKey": "04D5289D0C7E12490D4754063936D54952CE44753659B2C4AD095789571AFB7AD8F95294454D61A2B4787E5E424E17A42D2014F1F0A54BE315DBF554C9A91587E9",
                "clientId": "d598efbeddc7558c98fc32197114a36b",
                "code": "4664A6BB21AD46BC8D569ED11CC4F1F5",
                "areaPrefix": "3100",
                "new_key16": "Mp5APGKjHTUurf^2",
                "natureuuid": "5c51c8199f504eaba625885c8a5a7581",
                "userinfo": "JTdCJTIyY2xpZW50X2lkJTIyJTNBJTIwJTIyMDA0ZWNiN2RhNDk0NTA5YmExYzE4NDRlMjQ4YTUwYzQlMjIlMkMlMjAlMjJjbGllbnRfdHlwZSUyMiUzQSUyMCUyMjAyJTIyJTJDJTIwJTIydXNlcl90eXBlJTIyJTNBJTIwJTIyMSUyMiUyQyUyMCUyMnVzZXJfbmFtZSUyMiUzQSUyMCUyMiUyMiUyQyUyMCUyMmZ1bGxfbmFtZSUyMiUzQSUyMCUyMiU1Q3U2NzY4JTVDdTUxYjAlMjIlMkMlMjAlMjJ0cnVzdGVkX2xldmVsJTIyJTNBJTIwJTIyJTVDdTU2ZGIlNUN1N2VhNyUyMiUyQyUyMCUyMm5ld0V0YXhGbGFnJTIyJTNBJTIwJTIyMCUyMiUyQyUyMCUyMm92ZXJzZWFzJTIyJTNBJTIwJTIyMCUyMiUyQyUyMCUyMnJlZ2lzdHJhdGlvblR5cGVPZkxldnlTdWJqZWN0JTIyJTNBJTIwJTIyJTIyJTJDJTIwJTIyZnVuY3Rpb25NZW51ZSUyMiUzQSUyMCUyMiUyMiUyQyUyMCUyMmFncmVlbWVudE51bWJlciUyMiUzQSUyMCUyMiUyMiUyQyUyMCUyMmV4cGlyZXNfaW4lMjIlM0ElMjAzNjAwJTJDJTIwJTIybG9naW5fbGV2ZWwlMjIlM0ElMjAlMjIlNUN1NGU4YyU1Q3U3ZWE3JTIyJTJDJTIwJTIybGFzdF90cnVzdGVkX2RhdGElMjIlM0ElMjAlMjIyMDIzLTEwLTI3JTIwMTYlM0EzOSUzQTQzJTIyJTJDJTIwJTIybGFzdF90cnVzdGVkX2RhdGUlMjIlM0ElMjAlMjIyMDIzLTEwLTI3JTIwMTYlM0EzOSUzQTQzJTIyJTJDJTIwJTIydXNlcl9pZCUyMiUzQSUyMCUyMjExMDAwZDllODEyY2RmOGQ0M2VhOWM0NWI4MjM0MzI0YWIxZCUyMiUyQyUyMCUyMmVudGVycHJpc2VfaWQlMjIlM0ElMjAlMjIlMjIlMkMlMjAlMjJhZ2VuY3lfZW50ZXJwcmlzZV9pZCUyMiUzQSUyMCUyMiUyMiUyQyUyMCUyMnRheF9hdXRob3JpdHlfY29kZSUyMiUzQSUyMCUyMiUyMiUyQyUyMCUyMnRheF9hdXRob3JpdHlfbGV2ZWwlMjIlM0ElMjAlMjIlMjIlMkMlMjAlMjJ0YXhfYXV0aG9yaXR5X25hbWUlMjIlM0ElMjAlMjIlMjIlMkMlMjAlMjJ0YXhwYXllcl9pZCUyMiUzQSUyMCUyMiUyMiUyQyUyMCUyMmNvbXBhbnlfbmFtZSUyMiUzQSUyMCUyMiUyMiUyQyUyMCUyMmxhc3RfZmFjZV92ZXJpZnlfZGF0ZSUyMiUzQSUyMCUyMiUyMiUyQyUyMCUyMmlkX2NhcmQlMjIlM0ElMjAlMjIxNDI3MzExOTk1MTAwMjU0MzIlMjIlMkMlMjAlMjJjYXJkX3R5cGUlMjIlM0ElMjAlMjIyMDElMjIlMkMlMjAlMjJyZWdfbnVtYmVyJTIyJTNBJTIwJTIyJTIyJTJDJTIwJTIydHJ1c3RfY29kZSUyMiUzQSUyMCUyMiUyMiUyQyUyMCUyMnBob25lJTIyJTNBJTIwJTIyMTM0NjY5NjM2MjYlMjIlMkMlMjAlMjJtb2JpbGUlMjIlM0ElMjAlMjIxMzQ2Njk2MzYyNiUyMiUyQyUyMCUyMnRheF9maWxlX25vJTIyJTNBJTIwJTIyJTIyJTJDJTIwJTIycG9zaXRpb24lMjIlM0ElMjAlMjIlMjIlMkMlMjAlMjJsb2dpbl90eXBlJTIyJTNBJTIwJTIyMiUyMiUyQyUyMCUyMnJlbGF0ZWRUeXBlJTIyJTNBJTIwJTIyJTIyJTJDJTIwJTIyY3JlZGl0Q29kZSUyMiUzQSUyMCUyMiUyMiUyQyUyMCUyMnNwcm9sZV9saXN0JTIyJTNBJTIwJTIyJTIyJTJDJTIwJTIydGF4ZXJfY29kZSUyMiUzQSUyMCUyMiUyMiUyQyUyMCUyMnRheGVyX25hbWUlMjIlM0ElMjAlMjIlNUN1Njc2OCU1Q3U1MWIwJTIyJTJDJTIwJTIydGF4X2lkJTIyJTNBJTIwJTIyMTEwMDBkOWU4MTJjZGY4ZDQzZWE5YzQ1YjgyMzQzMjRhYjFkJTIyJTJDJTIwJTIydGF4ZXJfc3RhdHVzX2NvZGUlMjIlM0ElMjAlMjIlMjIlMkMlMjAlMjJ0YXhlcl9zdGF0dXNfbmFtZSUyMiUzQSUyMCUyMiUyMiUyQyUyMCUyMmFnZW5jeUNyZWRpdENvZGUlMjIlM0ElMjAlMjIlMjIlMkMlMjAlMjJhZ2VuY3lOYW1lJTIyJTNBJTIwJTIyJTIyJTJDJTIwJTIyYWdlbmN5UmVnX251bWJlciUyMiUzQSUyMCUyMiUyMiUyQyUyMCUyMmFyZWFQcmVmaXglMjIlM0ElMjAlMjIzMTAwJTIyJTJDJTIwJTIyYXJlYVByZU5hbWUlMjIlM0ElMjAlMjIlNUN1NGUwYSU1Q3U2ZDc3JTVDdTVlMDIlMjIlMkMlMjAlMjJlbnRlcnByaXNlX3R5cGUlMjIlM0ElMjAlMjIlMjIlMkMlMjAlMjJpbml0aWFsX2VudGVycHJpc2VfdHlwZSUyMiUzQSUyMCUyMiUyMiUyQyUyMCUyMmNyb3NzSW5zcGVjdGlvbk51bWJlciUyMiUzQSUyMCUyMiUyMiUyQyUyMCUyMnByb2plY3ROYW1lJTIyJTNBJTIwJTIyJTIyJTJDJTIwJTIyY3Jvc3NSZWdpb25hbFByb3BlcnR5VGF4U3ViamVjdFJlZ2lzdHJhdGlvbk1hcmslMjIlM0ElMjAlMjIlMjIlMkMlMjAlMjJnZW5kZXIlMjIlM0ElMjAlMjIxJTIyJTJDJTIwJTIybmF0aW9uYWxpdHklMjIlM0ElMjAlMjIxNTYlMjIlMkMlMjAlMjJzdGFydERhdGUlMjIlM0ElMjAlMjIlMjIlMkMlMjAlMjJlbmREYXRlJTIyJTNBJTIwJTIyJTIyJTJDJTIwJTIyYmlydGhkYXRlJTIyJTNBJTIwJTIyJTIyJTJDJTIwJTIyYWRkcmVzcyUyMiUzQSUyMCUyMiUyMiUyQyUyMCUyMmVtYWlsJTIyJTNBJTIwJTIyJTIyJTJDJTIwJTIyZW50ZXJwcmlzZVN0YXR1cyUyMiUzQSUyMCUyMiUyMiUyQyUyMCUyMmFnZW5jeVRheHBheWVyX2lkJTIyJTNBJTIwJTIyJTIyJTJDJTIwJTIyYWdlbmN5VGF4cGF5ZXJTdGF0dXNDb2RlJTIyJTNBJTIwJTIyJTIyJTJDJTIwJTIydGF4cGF5ZXJTdGF0dXNDb2RlJTIyJTNBJTIwJTIyJTIyJTJDJTIwJTIycmVnaXN0ZXJfdGltZSUyMiUzQSUyMCUyMjIwMjMtMTAtMTElMjAyMCUzQTA0JTNBMzElMjIlMkMlMjAlMjJhZ2VuY3lUeXBlJTIyJTNBJTIwJTIyJTIyJTJDJTIwJTIyaXNIYXZlUHN3JTIyJTNBJTIwJTIyMSUyMiUyQyUyMCUyMmNvbXBldGVudF90YXhfYnVyZWF1X2NvZGUlMjIlM0ElMjAlMjIlMjIlMkMlMjAlMjJjb21wZXRlbnRfdGF4X2J1cmVhdV9uYW1lJTIyJTNBJTIwJTIyJTIyJTJDJTIwJTIybWFpbklkZW50aXR5JTIyJTNBJTIwJTIyMSUyMiUyQyUyMCUyMm91dGdvaW5nQnVzaW5lc3NDZXJ0aWZpY2F0ZVVVSUQlMjIlM0ElMjAlMjIlMjIlMkMlMjAlMjJ0YXhfYXV0aG9yaXR5X2FiYnJldmlhdGlvbiUyMiUzQSUyMCUyMiUyMiUyQyUyMCUyMmNvbXBldGVudF90YXhfYnVyZWF1X2FiYnJldmlhdGlvbiUyMiUzQSUyMCUyMiUyMiUyQyUyMCUyMmxhbmclMjIlM0ElMjAlMjIlMjIlMkMlMjAlMjJyYXJlbHklMjIlM0ElMjAlMjIwJTIyJTJDJTIwJTIyYXJlYU5hbWUlMjIlM0ElMjAlMjIlNUN1NGUwYSU1Q3U2ZDc3JTIyJTdE",
                "timestamp": "20231027163930",
                "token": "eyJhbGciOiJIUzUxMiJ9.eyJsb2dpbl91c2VyX2tleSI6ImJiMzk1MTJjMmNhNzQyNjJiNjNmM2QyMGFkMTk4OGMxIn0.LnZGCWIeAsozJhnHuiW4Cq2MiVUCF9Q35C_2YWS4rW9_QAfkKNtyz-Mgt-fqUBNK8qP3Q0DELcV6LNyiAvX63Q"
            }
        }
    },
    "message": "登录成功"
}
上一页
校验电局账号有效性
下一页
自然人异步登录发送验证码接口
Built with