企享云API(适配版本)
  1. 自然人
企享云API(适配版本)
  • 基本介绍
  • 快速开始
    • 开发必读
    • 对接地址
    • SDK集成
    • 认证鉴权
    • 接口调用
    • 加密说明
  • 前置流程
    • 业务指引
    • 证书申请指引
    • 证书对接前置流程
    • 小号申请指引
  • 公共业务
    • 鉴权
      • 获取access_token
    • 订购
      • 自然人获取企业列表
      • 订购产品
      • 订购取消
      • 订购查询
      • 企业取消授权
    • 自然人
      • 自然人创建接口
        POST
      • 自然人修改接口
        POST
      • 自然人删除接口
        POST
    • 通知预警
      • 客户通知
    • 附录
      • 地区代码
  • 登录业务
    • 简介
    • 登录
      • 托管模式
        • 创建用户
        • 登录接口
        • 通用账户创建
        • 账号启用
        • 登录电票平台接口
        • 校验电局账号有效性
      • 自持登录
        • 自然人同步登录接口
        • 自然人异步登录发送验证码接口
        • 异步登录校验税局缓存是否有效
        • 异步登录税局【发送短信验证码】
        • 扫码登录税局(二维码获取)
        • 扫码登录税局(二维码登录)
        • 异步登录税局【上传短信验证码登录】
        • 自然人异步登录税局【上传短信验证码登录】
        • 上传cookie接口
      • 校验appkey是否账户自持
    • 多账号管理
      • 托管模式
        • 托管账号创建
        • 托管账号修改
        • 托管账号删除
        • 托管账号查询
        • 账号产品绑定
        • 账号产品解绑
      • 自持登录
        • 校验异步登录税务数字账户缓存是否有效
        • 异步登录税务数字账户【发送短信验证码】
        • 异步登录税务数字账户【上传短信验证码登录】
  • 发票业务
    • 海关进出口
      • 获取退税报关单
      • 进出口报关单获取
      • 出口报关单打印
      • 获取通关无纸化出口放行通知书PDF文件
      • 获取电子委托协议PDF文件
      • 获取购销合同PDF文件
      • 获取装箱单PDF
    • 发票附录
      • 发票附录
      • 数电票号码规则
  1. 自然人

自然人创建接口

POST
/v2/public/zrr/createZrrInfo
自然人创建
加密工具示例
      JSONObject param= new JSONObject();
       param.put("zrrxm","自然人1");
       param.put("zjhm",RSAClientUtil.encrypt("909000"));
       JSONObject loginInfo=new  JSONObject();
       param.put("loginInfo",loginInfo);
       loginInfo.put("sjyhm","sjyhm001");
       loginInfo.put("sjmm",RSAClientUtil.encrypt("sjmm"));
       loginInfo.put("sjhm","sjhm")
公钥:
MIGfMA0GCSqGSIb3DQEBAQUAA4GNADCBiQKBgQC+vuYMGtTU+42wwbaFX+PkCuSeoREKe5V4EJMi553Gc03ficUdpLHIFdEjAMHAxepwm3RAGLwyxYFK/S93k8GYMuV35L2Nj/cVeHS8scsdqXzqLUKaI4wj438OI6HDh7rWsw1M5EgMsoZvQqja53+SgD3mgIy3XyILbmA5jUp2IwIDAQAB
加密方法样例
public static String encrypt(String data) throws Exception {
	byte[] bytes = Base64.decode(publicKey);//publicKey 公钥
	X509EncodedKeySpec spec = new X509EncodedKeySpec(bytes);
	KeyFactory factory = KeyFactory.getInstance("RSA");
	PublicKey publicKey = factory.generatePublic(spec);
	Cipher cipher = Cipher.getInstance("RSA");
	cipher.init(Cipher.ENCRYPT_MODE, publicKey);
	int inputLen = data.getBytes().length;
	ByteArrayOutputStream out = new ByteArrayOutputStream();
	int offset = 0;
	byte[] cache;
	int i = 0;
	while (inputLen - offset > 0) {
	  if (inputLen - offset > 117) {
		  cache = cipher.doFinal(data.getBytes(), offset, 117);
	  } else {
		  cache = cipher.doFinal(data.getBytes(), offset, inputLen - offset);
	  }
	  out.write(cache, 0, cache.length);
	  i++;
	  offset = i * 117;
	}
	byte[] encryptedData = out.toByteArray();
	out.close();
	return Base64.encode(encryptedData);
}

请求参数

Header 参数
Content-Type
string 
必需
示例值:
application/json
access_token
string 
必需
通过调用access_token接口返回的access_token值
示例值:
{{access_token}}
req_date
string 
必需
当前时间转为的毫秒数
示例值:
{{req_date}}
req_sign
string 
签名算法得到的签名
必需
示例值:
{{req_sign}}
Body 参数application/json
zrrxm
string 
自然人姓名
必需
zjhm
string 
身份证号
必需
需要RSA加密
loginInfo
object 
必需
sjyhm
string 
税局用户名
必需
sjmm
string 
密码
必需
sjhm
string 
手机号
必需
需要RSA加密
示例
{
    "zrrxm": "string",
    "zjhm": "string",
    "loginInfo": {
        "sjyhm": "string",
        "sjmm": "string",
        "sjhm": "string"
    }
}

示例代码

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/zrr/createZrrInfo' \
--header 'access_token: {{access_token}}' \
--header 'req_date: {{req_date}}' \
--header 'req_sign: {{req_sign}}' \
--header 'Content-Type: application/json' \
--data-raw '{
    "zrrxm": "string",
    "zjhm": "string",
    "loginInfo": {
        "sjyhm": "string",
        "sjmm": "string",
        "sjhm": "string"
    }
}'

返回响应

🟢200成功
application/json
Body
reqId
string 
请求ID
必需
由服务器端生成的唯一标识,对应每次请求。排
code
string 
错误码
必需
错误码
success
boolean 
是否成功标记
必需
接口是否成功(是否发生业务异常)
message
string 
错误信息
必需
data
object  | null 
可选
zrrId
integer 
自然人ID
可选
示例
{
    "code": "SUCCESS",
    "data": {
        "zrrId": 494808291104832
    },
    "success": true,
    "message": "",
    "reqId": "223eb47cc82e4ccc8909b81fbcddb850"
}
上一页
企业取消授权
下一页
自然人修改接口
Built with