接口说明
用于更新订单的主表自定义字段,单次最多发起50个订单
API 方法名:nuonuo.OpeMplatform.orderCustomFieldBatchUpdate 版本:V2.0
请求地址
| 环境 | 请求地址 |
|---|
| 正式环境 | https://sdk.nuonuo.com/open/v1/services |
| 沙箱环境 | https://sandbox.nuonuocs.cn/open/v1/services |
公共请求参数(消息头)
| 参数名 | 类型 | 必填 | 长度 | 说明 | 示例 |
|---|
| Content-type | String | 否 | - | MIME类型【消息头】 | - |
公共请求参数(消息体)
| 参数名 | 类型 | 必填 | 长度 | 说明 | 示例 |
|---|
| senid | String | 否 | - | 唯一标识,由企业自己生成32位随机码【消息体】 | - |
私有请求参数
| 参数名 | 类型 | 必填 | 长度 | 说明 | 示例 |
|---|
| saleTaxNum | String | 否 | 20 | 销方税号 | 150301199811285326 |
| orderCustomFieldDtoList | Array | 否 | 50 | 自定义字段更新列表 | - |
| └ originalOrderNo | String | 否 | 64 | 订单编号,同税号下唯一 | 12345678 |
| └ bField1 | String | 是 | 200 | 自定义字段1,为空时不更新,3个自定义字段不能全部为空 | - |
| └ bField2 | String | 是 | 200 | 自定义字段2,为空时不更新,3个自定义字段不能全部为空 | - |
| └ bField3 | String | 是 | 200 | 自定义字段3,为空时不更新,3个自定义字段不能全部为空 | - |
响应参数
| 参数名 | 类型 | 必填 | 长度 | 说明 | 示例 |
|---|
| status | String | 否 | - | 状态码 | 0000 |
| message | String | 否 | - | 描述信息 | 调用成功 |
| data | Object | 否 | - | 返回数据,可为空 | - |
| └ failNum | Number | 否 | - | 更新失败订单数量 | 1 |
| └ successNum | Number | 否 | - | 更新成功订单数量 | 1 |
| └ totalNum | Number | 否 | - | 调用总数 | 1 |
| └ saleTaxNum | String | 否 | - | 销方税号 | - |
| └ failList | Array | 否 | - | 失败列表 | - |
| └ orderNo | String | 否 | - | 订单编号 | - |
| └ failReason | String | 否 | - | 错误原因 | 自定义字段不能全部为空 |
请求报文示例
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 | 销方税号不能为空 | |