首页 > 开放平台 > 诺税通saas > 订单开票
开放平台/订单开票/批量更新主表自定义字段

批量更新主表自定义字段

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

接口说明

用于更新订单的主表自定义字段,单次最多发起50个订单

API 方法名:nuonuo.OpeMplatform.orderCustomFieldBatchUpdate 版本:V2.0

请求地址

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

公共请求参数(消息头)

参数名类型必填长度说明示例
Content-typeString否-MIME类型【消息头】-

公共请求参数(消息体)

参数名类型必填长度说明示例
senidString否-唯一标识,由企业自己生成32位随机码【消息体】-

私有请求参数

参数名类型必填长度说明示例
saleTaxNumString否20销方税号150301199811285326
orderCustomFieldDtoListArray否50自定义字段更新列表-
   └ originalOrderNoString否64订单编号,同税号下唯一12345678
   └ bField1String是200自定义字段1,为空时不更新,3个自定义字段不能全部为空-
   └ bField2String是200自定义字段2,为空时不更新,3个自定义字段不能全部为空-
   └ bField3String是200自定义字段3,为空时不更新,3个自定义字段不能全部为空-

响应参数

参数名类型必填长度说明示例
statusString否-状态码0000
messageString否-描述信息调用成功
dataObject否-返回数据,可为空-
   └ failNumNumber否-更新失败订单数量1
   └ successNumNumber否-更新成功订单数量1
   └ totalNumNumber否-调用总数1
   └ saleTaxNumString否-销方税号-
   └ failListArray否-失败列表-
      └ orderNoString否-订单编号-
      └ failReasonString否-错误原因自定义字段不能全部为空

请求报文示例

NNOpenSDK sdk = NNOpenSDK.getIntance();
String taxnum = "23***789"; // 授权企业税号
String appKey = "Hn***XL";
String appSecret = "F65***65F";
String method = "nuonuo.OpeMplatform.orderCustomFieldBatchUpdate"; // API方法名
String token = "2d484e**************pdui"; // 访问令牌
String content = "{
  \"orderCustomFieldDtoList\": [
    {
      \"originalOrderNo\": \"12345678\",
      \"bField1\": \"\",
      \"bField3\": \"\",
      \"bField2\": \"\"
    }
  ],
  \"saleTaxNum\": \"150301199811285326\"
}";
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);

返回码说明

返回码说明处理建议
0000调用成功
9999销方税号不能为空
标签: 开放平台
上一篇:查询订单关联发票接口
已经是最后一篇

申请试用

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