接口说明
已开通诺税通saas资质:商家平台调用该接口,可以获取到企业当前的税款所属期信息。获取到的属期信息与当地勾选认证平台中的属期信息一致。(获取到的属期信息可能有延迟,有可能企业已做完申报了,但是认证平台属期尚未切换。 此时,需要企业登录客户端进行重启)
API 方法名:nuonuo.OpeMplatform.obtainCurTaxPeriodThir 版本:V2.0
请求地址
| 环境 | 请求地址 |
|---|
| 正式环境 | https://sdk.nuonuo.com/open/v1/services |
| 沙箱环境 | https://sandbox.nuonuocs.cn/open/v1/services |
公共请求参数(消息头)
| 参数名 | 类型 | 必填 | 长度 | 说明 | 示例 |
|---|
| Content-type | String | 否 | - | MIME类型【消息头】 | - |
公共请求参数(消息体)
| 参数名 | 类型 | 必填 | 长度 | 说明 | 示例 |
|---|
| senid | String | 否 | - | 唯一标识,由企业自己生成32位随机码【消息体】 | - |
私有请求参数
| 参数名 | 类型 | 必填 | 长度 | 说明 | 示例 |
|---|
| taxNum | String | 是 | - | 不需要传参 | 税号 |
响应参数
| 参数名 | 类型 | 必填 | 长度 | 说明 | 示例 |
|---|
| code | String | 否 | - | | E0000 |
| describe | String | 否 | - | | 调用成功 |
| result | Object | 否 | - | | - |
| └ ssq | String | 否 | - | 企业当前税款所属期 | 202209 |
| └ dpType | Number | 否 | - | 是否使用全电平台 0-否 1-是 | 0 |
| └ gxrqq | String | 否 | - | 当前属期可勾选发票开票日期起 | 20170101 |
| └ companyType | Number | 否 | - | 退税企业类型 0生产企业 1外贸企业 2外综服企业 3其他 4- | 4 |
| └ ncpProcessType | Number | 否 | - | 是否农产品深加工企业 0-否 1-是 | 0 |
| └ utime | String | 否 | - | 更新时间 | 2022-09-20 20:17:09 |
| └ syncFlag | Number | 否 | - | | 1 |
| └ oilType | Number | 否 | - | 成品油企业类型 0-非成品油企业 1-成品油经销企业 2-成品油生产企业 | 0 |
| └ containerType | Number | 否 | - | | 2 |
| └ gxrqz | String | 否 | - | 当前属期可勾选发票开票日期止 | 20220930 |
| └ syncDataStatus | String | 否 | - | | - |
| └ jzssq | String | 否 | - | 当前属期可进行勾选认证操作的截至日期 | 20221025 |
| success | String | 否 | - | | true |
请求报文示例
NNOpenSDK sdk = NNOpenSDK.getIntance();
String taxnum = "23***789"; // 授权企业税号
String appKey = "Hn***XL";
String appSecret = "F65***65F";
String method = "nuonuo.OpeMplatform.obtainCurTaxPeriodThir"; // API方法名
String token = "2d484e**************pdui"; // 访问令牌
String content = "{
\"taxNum\": \"税号\"
}";
String url = "https://sdk.nuonuo.com/open/v1/services"; // SDK请求地址
String senid = UUID.randomUUID().toString().replace("-", ""); // 唯一标识,32位随机码,无需修改,保持默认即可
String result = sdk.sendPostSyncRequest(url, senid, appKey, appSecret, token, taxnum, method, content);
System.out.println(result);
响应报文示例
{ "code" : "E0000", "describe" : "调用成功", "result" : { "ssq" : "202209", "dpType" : 0, "gxrqq" : "20170101", "companyType" : 4, "utime" : "2022-09-20 20:17:09", "syncFlag" : 1, "oilType" : 0, "containerType" : 2, "gxrqz" : "20220930", "syncDataStatus" : null, "jzssq" : "20221025" }, "success" : true }
返回码说明