接口说明
凭证录入接口
API 方法名:nuonuo.cloudTally.autoMakeAccountingVouchers 版本:V1.0
请求地址
| 环境 | 请求地址 |
|---|
| 正式环境 | https://sdk.nuonuo.com/openPlatform/services |
| 沙箱环境 | https://sandbox.nuonuocs.cn/open/v1/services |
公共请求参数(消息头)
| 参数名 | 类型 | 必填 | 长度 | 说明 | 示例 |
|---|
| userTax | String | 是 | - | 授权商户的税号(自用型应用非必填,第三方应用必填)【消息头】 | - |
公共请求参数(消息体)
| 参数名 | 类型 | 必填 | 长度 | 说明 | 示例 |
|---|
| method | String | 否 | - | 请求api对应的方法名称【消息体】 | - |
私有请求参数
| 参数名 | 类型 | 必填 | 长度 | 说明 | 示例 |
|---|
| accId | String | 否 | 255 | 账套id | ddb575af400841e38827fa62fc55d02c |
| creator | String | 否 | 20 | 制单人 | 张三 |
| date | String | 否 | 10 | 凭证日期 | 2025-01-31 |
| code | Number | 否 | 5 | 凭证号 | 12 |
| voucherType | String | 否 | 20 | 凭证类型 | 记 |
| affix | String | 否 | 5 | 附件数 | 0 |
| attachmentUrls | Array | 是 | - | 已经获取附件URL地址字符串列表 | [https://inv.jss.com.cn/fp/t7Q.pdf] |
| attachmentIds | Array | 是 | - | 通过开发平台上传附件ID字符串列表 | [778764689868976128.778764689868976129] |
| voucherLineList | Array | 否 | - | 凭证分录信息 | 详见下方说明 |
| └ summary | String | 否 | 255 | 摘要 | 结账款项凭证 |
| └ subjectId | String | 是 | 20 | 科目id(科目名称和编码至少填一个) | 778764689868976128 |
| └ subjectCode | String | 是 | 20 | 科目编码(科目id和编码至少填一个) | 1002 |
| └ debitAmt | String | 是 | 12 | 借方金额 | 0 |
| └ creditAmt | String | 是 | 12 | 贷方金额(借贷方金额只能填一个,另一方为0) | 1.00 |
| └ currency | String | 是 | 12 | 外币金额 | 0 |
| └ rate | String | 是 | 12 | 汇率 | 0 |
| └ price | String | 是 | 12 | 单价 | 0 |
| └ amount | String | 是 | 15 | 数量 | 0 |
| └ unit | String | 是 | 20 | 单位 | kg |
| └ number | Number | 否 | 4 | 分录序号 | 1 |
| └ auxiliaryList | Array | 是 | - | 辅助信息列表 | 详见下方说明 |
| └ auxiliaryTypeId | String | 否 | 20 | 辅助类别id | 778764689868976128 |
| └ auxiliaryId | String | 是 | 20 | 辅助id | 778764689868976128 |
| └ auxiliaryName | String | 是 | 200 | 辅助名称 | 苹果 |
| └ auxiliaryCode | String | 是 | 6 | 辅助编码 | 0001 |
| └ model | String | 是 | 20 | 规格 | 箱 |
响应参数
| 参数名 | 类型 | 必填 | 长度 | 说明 | 示例 |
|---|
| data | String | 否 | - | 凭证id | 7eec319b17974b7cb5a143317233908b |
请求报文示例
Map headers = getHeaders();
PublicData pdData = getPublicData();
PrivateData
响应报文示例
{
"result": {
"data": "7eec319b17974b7cb5a143317233908b"
},
"code": "JZ0000",
"describe": "OK"
}
返回码说明
| 返回码 | 说明 | 处理建议 |
|---|
JZ0000 | 录入成功 | |
JZ0001 | 制单人不能为空 | 调整制单人参数后重试 |