首页 > 开放平台 > 诺账通 > 查询
开放平台/查询/查询科目余额表

查询科目余额表

2026-09-24 更新 阅读 版本 v1.0

接口说明

用户可以通过此接口查询具体账套最长跨度为1年的科目余额表数据。

API 方法名:nuonuo.CloudBookkeeping.querySubBalanceTable 版本:V1.0

请求地址

环境请求地址
正式环境https://sdk.nuonuo.com/openPlatform/services
沙箱环境https://sandbox.nuonuocs.cn/open/v1/services

公共请求参数(消息头)

参数名类型必填长度说明示例
userTaxString是-授权商户的税号(自用型应用非必填,第三方应用必填)【消息头】-

公共请求参数(消息体)

参数名类型必填长度说明示例
methodString否-请求api对应的方法名称【消息体】-

私有请求参数

参数名类型必填长度说明示例
accountIdString否-账套id133737d309b24bc4b8e48f13904252ea
startPeriodNumber否-开始期间202003
endPeriodNumber否-结束期间202003
modelNumber是-格式(1金额式2数量金额式3外币金额式4数量外币式)1
currencyCodeString是-币种-

响应参数

参数名类型必填长度说明示例
subjectIdString否-科目id159698775982477359
subjectCodeString否-科目编码2201
balanceDerString否-科目方向借
subjectNameString否-科目名称应付票据
unitString否-计量单位-
subjectLevelNumber否-科目级次1
initAmtNumber否-期初金额0
initCurrencyNumber否-期初外币0
initQuantityNumber否-期初数量0
initPriceNumber否-期初单价0
debitAmtNumber否-借方金额3
creditAmtNumber否-贷方金额0
debitCurrencyNumber否-借方外币0
creditCurrencyNumber否-贷方外币0
debitQuantityNumber否-借方数量0
creditQuantityNumber否-贷方数量0
debitPriceNumber否-借方单价0
creditPriceNumber否-贷方单价0
balanceAmtNumber否-期末金额3
balanceDebitAmtNumber否-期末借方金额3
balanceCreditAmtNumber否-期末贷方金额0
balanceQuantityNumber否-期末数量0
balanceCurrencyNumber否-期末外币0
balancePriceNumber否-期末单价0
yearDebitAmtTotalNumber否-本年累计借方金额3
yearCreditAmtTotalNumber否-本年累计贷方金额0
yearDebitCyTotalNumber否-本年累计借方外币0
yearCreditCyTotalNumber否-本年累计贷方外币0
yearDebitQtyTotalNumber否-本年累计借方数量0
yearCreditQtyTotalNumber否-本年累计贷方数量0
yearDebitPriceNumber否-本年累计借方单价0
yearCreditPriceNumber否-本年累计贷方单价0

请求报文示例(.NET SDK)

NNOpenSDK sdk = NNOpenSDK.getIntance();
String taxnum = "23***789"; // 授权企业税号
String appKey = "Hn***XL";
String appSecret = "F65***65F";
String method = "nuonuo.CloudBookkeeping.querySubBalanceTable"; // API方法名
String token = "2d484e**************pdui"; // 访问令牌
String content = "{
  \"accountId\": \"133737d309b24bc4b8e48f13904252ea\",
  \"startPeriod\": 202003,
  \"endPeriod\": 202003,
  \"model\": 1,
  \"currencyCode\": \"\"
}";
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": [
    {
      "subjectId": "159698775982477359",
      "subjectCode": "2201",
      "balanceDer": "借",
      "subjectName": "应付票据",
      "unit": "",
      "subjectLevel": 1,
      "initAmt": 0,
      "initQuantity": 0,
      "initPrice": 0,
      "debitAmt": 3,
      "creditAmt": 0,
      "debitQuantity": 0,
      "creditQuantity": 0,
      "debitPrice": 0,
      "creditPrice": 0,
      "balanceAmt": 3,
      "balanceDebitAmt": 3,
      "balanceCreditAmt": 0,
      "balanceQuantity": 0,
      "balanceCurrency": 0,
      "balancePrice": 0,
      "yearDebitAmtTotal": 3,
      "yearCreditAmtTotal": 0,
      "yearDebitQtyTotal": 0,
      "yearCreditQtyTotal": 0,
      "yearDebitPrice": 0,
      "yearCreditPrice": 0
    },
    {
      "subjectName": "负债总计",
      "initDebitAmt": 0,
      "initCreditAmt": 0,
      "debitAmt": 3,
      "creditAmt": 0,
      "balanceDebitAmt": 3,
      "balanceCreditAmt": 0,
      "yearDebitAmtTotal": 3,
      "yearCreditAmtTotal": 0
    },
    {
      "subjectName": "总计",
      "initDebitAmt": 390,
      "initCreditAmt": 0,
      "debitAmt": 12,
      "creditAmt": 12,
      "balanceDebitAmt": 396,
      "balanceCreditAmt": 6,
      "yearDebitAmtTotal": 138,
      "yearCreditAmtTotal": 11152
    }
  ]
}

返回码说明

返回码说明处理建议
JZ0001上传请求参数格式有误,请确认保证参数正确重新请求
JZ0002上传账套编号参数有误,请确认保证参数正确重新请求
JZ0003上传查询期间参数有误,请确认保证参数正确重新请求
JZ0004上传查询期间跨度不可超出一年,请确认保证参数正确重新请求
JZ0005上传币种参数有误,请确认保证参数正确重新请求
标签: 开放平台

申请试用

请留下您的联系方式,我们将在一个工作日内与您联系