接口说明
批量引入采购单到待处理单据中
API 方法名:nuonuo.CloudBookkeeping.purchaseBatchAddSync 版本:V2.0
请求地址
| 环境 | 请求地址 |
|---|
| 正式环境 | https://sdk.nuonuo.com/open/v1/services |
| 沙箱环境 | https://sandbox.nuonuocs.cn/open/v1/services |
公共请求参数(消息头)
| 参数名 | 类型 | 必填 | 长度 | 说明 | 示例 |
|---|
| Content-type | String | 否 | - | MIME类型【消息头】 | - |
公共请求参数(消息体)
| 参数名 | 类型 | 必填 | 长度 | 说明 | 示例 |
|---|
| senid | String | 否 | - | 唯一标识,由企业自己生成32位随机码【消息体】 | - |
私有请求参数
| 参数名 | 类型 | 必填 | 长度 | 说明 | 示例 |
|---|
| accountId | String | 否 | - | | 3ed8640cd7614ddfa215cfc3b019cca6 |
| untreatedBillList | Array | 否 | - | 单据列表 | - |
| └ billType | Number | 否 | - | 单据类型, 1:采购入库单 2: 采购退货单 | 1 |
| └ supplierName | String | 否 | - | 供应商名称, 供应商名称不允许超过128个字符 | 天津农贸有限责任公司 |
| └ details | Array | 否 | - | 单据明细 | - |
| └ stockName | String | 否 | - | 商品名称, 长度不允许超过150个字符 | 苹果 |
| └ stockCode | String | 否 | - | 商品编码, 长度不允许超过50个字符 | 12312 |
| └ billQty | Number | 否 | - | 数量, 精度:小数点前位数不超过15位,小数点后位数不超过8位 | 1 |
| └ warehouseName | String | 否 | - | 仓库名称,长度不允许超过128个字符 | 杭州仓库 |
| └ conversionRate | Number | 是 | - | 转化率, 精度:小数点前位数不超过15位,小数点后位数不超过8位 | 1 |
| └ billPrice | Number | 是 | - | 单价, 精度:小数点前位数不超过15位,小数点后位数不超过8位 | 10 |
| └ remark | String | 是 | - | 备注, 长度不允许超过200个字符 | 单据明细备注 |
| └ billAmt | Number | 否 | - | 单据金额(含税), 精度:小数点前位数不超过15位,小数点后位数不超过8位 | 11 |
| └ mainUnit | String | 是 | - | 主单位名称, 长度不允许超过50个字符 | kg |
| └ unit | String | 是 | - | 单位名称, 长度不允许超过50个字符 | kg |
| └ model | String | 是 | - | 规格型号, 长度不允许超过90个字符 | 1kg/个 |
| └ billMainQty | Number | 是 | - | 数量(主单位), 精度:小数点前位数不超过15位,小数点后位数不超过8位 | 1 |
| └ taxRate | Number | 是 | - | 采购税率, 精度:小数点前位数不超过15位,小数点后位数不超过8位 | 10 |
| └ taxAmt | Number | 是 | - | 采购税额, 精度:小数点前位数不超过15位,小数点后位数不超过8位 | 1 |
| └ billCode | String | 否 | - | 单据编码,不允许超过50个字符 | CGRK202112120001 |
| └ billDate | String | 否 | - | 单据日期(YYYY-MM-DD) | 2021-12-12 |
| └ remark | String | 是 | - | 备注,长度不允许超过200个字符 | 单据备注 |
响应参数
| 参数名 | 类型 | 必填 | 长度 | 说明 | 示例 |
|---|
| status | String | 否 | - | | - |
| message | String | 否 | - | | - |
| eid | String | 否 | - | | - |
| data | Object | 否 | - | | - |
| └ status | String | 否 | - | 处理状态:success成功;warning有成功有失败,有失败原因描述;fail失败,有失败原因描述 | success |
| └ successList | Array | 否 | - | 批量新增成功的待处理单据编号 | - |
| └ failList | Array | 否 | - | 批量新增失败待处理单据信息 | - |
| └ untreatedBillCode | String | 否 | - | 待处理单据编号 | - |
| └ failReason | String | 否 | - | 失败错误描述 | - |
| └ failSize | Number | 否 | - | 失败的总行数 | 0 |
| └ successSize | Number | 否 | - | 成功的数据 | 1 |
请求报文示例
NNOpenSDK sdk = NNOpenSDK.getIntance();
String taxnum = "23***789"; // 授权企业税号
String appKey = "Hn***XL";
String appSecret = "F65***65F";
String method = "nuonuo.CloudBookkeeping.purchaseBatchAddSync"; // API方法名
String token = "2d484e**************pdui"; // 访问令牌
String content = "{
\"accountId\": \"3ed8640cd7614ddfa215cfc3b019cca6\",
\"untreatedBillList\": [
{
\"supplierName\": \"天津农贸有限责任公司\",
\"billType\": 1,
\"details\": [
{
\"mainUnit\": \"kg\",
\"remark\": \"单据明细备注\",
\"warehouseName\": \"杭州仓库\",
\"conversionRate\": 1,
\"stockCode\": \"12312\",
\"taxRate\": 10,
\"billAmt\": 11,
\"unit\": \"kg\",
\"stockName\": \"苹果\",
\"billPrice\": 10,
\"model\": \"1kg/个\",
\"billQty\": 1,
\"billMainQty\": 1,
\"taxAmt\": 1
}
],
\"billCode\": \"CGRK202112120001\",
\"billDate\": \"2021-12-12\",
\"remark\": \"单据备注\"
}
]
}";
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);
返回码说明