接口说明
用户可以通过此接口查询具体账套最长跨度为1年的科目余额表数据。
API 方法名:nuonuo.CloudBookkeeping.querySubBalanceTable 版本:V1.0
请求地址
| 环境 | 请求地址 |
|---|
| 正式环境 | https://sdk.nuonuo.com/openPlatform/services |
| 沙箱环境 | https://sandbox.nuonuocs.cn/open/v1/services |
公共请求参数(消息头)
| 参数名 | 类型 | 必填 | 长度 | 说明 | 示例 |
|---|
| userTax | String | 是 | - | 授权商户的税号(自用型应用非必填,第三方应用必填)【消息头】 | - |
公共请求参数(消息体)
| 参数名 | 类型 | 必填 | 长度 | 说明 | 示例 |
|---|
| method | String | 否 | - | 请求api对应的方法名称【消息体】 | - |
私有请求参数
| 参数名 | 类型 | 必填 | 长度 | 说明 | 示例 |
|---|
| accountId | String | 否 | - | 账套id | 133737d309b24bc4b8e48f13904252ea |
| startPeriod | Number | 否 | - | 开始期间 | 202003 |
| endPeriod | Number | 否 | - | 结束期间 | 202003 |
| model | Number | 是 | - | 格式(1金额式2数量金额式3外币金额式4数量外币式) | 1 |
| currencyCode | String | 是 | - | 币种 | - |
响应参数
| 参数名 | 类型 | 必填 | 长度 | 说明 | 示例 |
|---|
| subjectId | String | 否 | - | 科目id | 159698775982477359 |
| subjectCode | String | 否 | - | 科目编码 | 2201 |
| balanceDer | String | 否 | - | 科目方向 | 借 |
| subjectName | String | 否 | - | 科目名称 | 应付票据 |
| unit | String | 否 | - | 计量单位 | - |
| subjectLevel | Number | 否 | - | 科目级次 | 1 |
| initAmt | Number | 否 | - | 期初金额 | 0 |
| initCurrency | Number | 否 | - | 期初外币 | 0 |
| initQuantity | Number | 否 | - | 期初数量 | 0 |
| initPrice | Number | 否 | - | 期初单价 | 0 |
| debitAmt | Number | 否 | - | 借方金额 | 3 |
| creditAmt | Number | 否 | - | 贷方金额 | 0 |
| debitCurrency | Number | 否 | - | 借方外币 | 0 |
| creditCurrency | Number | 否 | - | 贷方外币 | 0 |
| debitQuantity | Number | 否 | - | 借方数量 | 0 |
| creditQuantity | Number | 否 | - | 贷方数量 | 0 |
| debitPrice | Number | 否 | - | 借方单价 | 0 |
| creditPrice | Number | 否 | - | 贷方单价 | 0 |
| balanceAmt | Number | 否 | - | 期末金额 | 3 |
| balanceDebitAmt | Number | 否 | - | 期末借方金额 | 3 |
| balanceCreditAmt | Number | 否 | - | 期末贷方金额 | 0 |
| balanceQuantity | Number | 否 | - | 期末数量 | 0 |
| balanceCurrency | Number | 否 | - | 期末外币 | 0 |
| balancePrice | Number | 否 | - | 期末单价 | 0 |
| yearDebitAmtTotal | Number | 否 | - | 本年累计借方金额 | 3 |
| yearCreditAmtTotal | Number | 否 | - | 本年累计贷方金额 | 0 |
| yearDebitCyTotal | Number | 否 | - | 本年累计借方外币 | 0 |
| yearCreditCyTotal | Number | 否 | - | 本年累计贷方外币 | 0 |
| yearDebitQtyTotal | Number | 否 | - | 本年累计借方数量 | 0 |
| yearCreditQtyTotal | Number | 否 | - | 本年累计贷方数量 | 0 |
| yearDebitPrice | Number | 否 | - | 本年累计借方单价 | 0 |
| yearCreditPrice | Number | 否 | - | 本年累计贷方单价 | 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 | 上传币种参数有误,请确认 | 保证参数正确重新请求 |