接口说明
用户可以通过此接口查询具体账套单月的凭证汇总信息。
API 方法名:nuonuo.CloudBookkeeping.queryVoucherList 版本:V1.0
请求地址
| 环境 | 请求地址 |
|---|
| 正式环境 | https://sdk.nuonuo.com/openPlatform/services |
| 沙箱环境 | https://sandbox.nuonuocs.cn/open/v1/services |
公共请求参数(消息头)
| 参数名 | 类型 | 必填 | 长度 | 说明 | 示例 |
|---|
| userTax | String | 是 | - | 授权商户的税号(自用型应用非必填,第三方应用必填)【消息头】 | - |
公共请求参数(消息体)
| 参数名 | 类型 | 必填 | 长度 | 说明 | 示例 |
|---|
| method | String | 否 | - | 请求api对应的方法名称【消息体】 | - |
私有请求参数
| 参数名 | 类型 | 必填 | 长度 | 说明 | 示例 |
|---|
| accountId | String | 否 | - | 账套id | 133737d309b24bc4b8e48f13904252ea |
| accountPeriod | Number | 否 | - | 期间(单月) | 202003 |
响应参数
| 参数名 | 类型 | 必填 | 长度 | 说明 | 示例 |
|---|
| voucherCount | String | 否 | - | 凭证总张数 | 4 |
| voucherAffixCount | String | 否 | - | 凭证附件总张数 | 0 |
| auditedVoucherCount | String | 否 | - | 已审核凭证总张数 | 0 |
请求报文示例(.NET SDK)
NNOpenSDK sdk = NNOpenSDK.getIntance();
String taxnum = "23***789"; // 授权企业税号
String appKey = "Hn***XL";
String appSecret = "F65***65F";
String method = "nuonuo.CloudBookkeeping.queryVoucherList"; // API方法名
String token = "2d484e**************pdui"; // 访问令牌
String content = "{
\"accountId\": \"133737d309b24bc4b8e48f13904252ea\",
\"accountPeriod\": 202003
}";
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": "JZ0000",
"describe": "OK",
"result": {
"voucherCount": "4",
"voucherAffixCount": "0",
"auditedVoucherCount": "0"
}
}
返回码说明
| 返回码 | 说明 | 处理建议 |
|---|
JZ0001 | 上传请求参数格式有误,请确认 | 保证参数正确重新请求 |
JZ0002 | 上传账套编号参数有误,请确认 | 保证参数正确重新请求 |
JZ0003 | 上传查询期间参数有误,请确认 | 保证参数正确重新请求 |