同步批量引入待处理单据销售单

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

接口说明

批量引入销售库单到待处理单据中

API 方法名：nuonuo.CloudBookkeeping.saleOutBatchAddSync　版本：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	否	-	账套id	2721ff270f7e41a8bac567a064762964
untreatedBillList	Array	否	-	单据列表	-
└ billType	Number	否	-	单据类型， 1：销售退货单 2:销售出库单	1
└ customerName	String	否	-	客户名称, 客户名称不允许超过128个字符	天津包子铺
└ fromTradeNo	String	是	-	销售单号, 长度不允许超过50个字符	XSCK202210100001
└ shopName	String	是	-	店铺名称, 长度不允许超过128个字符	天津总店
└ details	Array	否	-	单据明细	-
└ costAmt	String	否	-	成本金额, 精度：小数点前位数不超过15位，小数点后位数不超过8位	1
└ costPrice	String	否	-	成本单价, 精度：小数点前位数不超过15位，小数点后位数不超过8位	1
└ billPrice	String	否	-	单价, 精度：小数点前位数不超过15位，小数点后位数不超过8位	2
└ billAmt	String	否	-	单据金额（含税）, 精度：小数点前位数不超过15位，小数点后位数不超过8位	2.2
└ stockName	String	否	-	商品名称, 长度不允许超过150个字符	肉包
└ stockCode	String	否	-	商品编码, 长度不允许超过50个字符	001
└ model	String	是	-	规格型号, 长度不允许超过90个字符	-
└ unit	String	是	-	单位名称, 长度不允许超过50个字符	个
└ mainUnit	String	是	-	主单位名称, 长度不允许超过50个字符	个
└ billQty	String	否	-	数量, 精度：小数点前位数不超过15位，小数点后位数不超过8位	1
└ billMainQty	String	是	-	数量(主单位), 精度：小数点前位数不超过15位，小数点后位数不超过8位	1
└ conversionRate	String	是	-	转化率, 精度：小数点前位数不超过15位，小数点后位数不超过8位	1
└ remark	String	是	-	备注, 长度不允许超过200个字符	-
└ warehouseName	String	否	-	仓库名称,长度不允许超过128个字符	天津仓
└ billCode	String	否	-	单据编码,不允许超过50个字符	CKXS202201010001
└ billDate	String	否	-	单据日期（YYYY-MM-DD）	2022-01-01
└ 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.saleOutBatchAddSync"; // API方法名
String token = "2d484e**************pdui"; // 访问令牌
String content = "{
  \"accountId\": \"2721ff270f7e41a8bac567a064762964\",
  \"untreatedBillList\": [
    {
      \"fromTradeNo\": \"XSCK202210100001\",
      \"billType\": 1,
      \"shopName\": \"天津总店\",
      \"details\": [
        {
          \"mainUnit\": \"个\",
          \"costAmt\": \"1\",
          \"costPrice\": \"1\",
          \"remark\": \"\",
          \"conversionRate\": \"1\",
          \"warehouseName\": \"天津仓\",
          \"stockCode\": \"001\",
          \"billAmt\": \"2.2\",
          \"unit\": \"个\",
          \"stockName\": \"肉包\",
          \"billPrice\": \"2\",
          \"model\": \"\",
          \"billQty\": \"1\",
          \"billMainQty\": \"1\"
        }
      ],
      \"billCode\": \"CKXS202201010001\",
      \"billDate\": \"2022-01-01\",
      \"remark\": \"\",
      \"customerName\": \"天津包子铺\"
    }
  ]
}";
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);

返回码说明

返回码	说明	处理建议
`200`	成功

标签：开放平台

上一篇：同步批量引入待处理单据采购单

下一篇：同步批量引入待处理单据其他出入库单

同步批量引入待处理单据销售单

接口说明

请求地址

公共请求参数（消息头）

公共请求参数（消息体）

私有请求参数

响应参数

请求报文示例

返回码说明

申请试用