Acumatica API更新客户多联系人异常求助：仅更新首个且值被覆盖

你遇到的这个情况不是Acumatica API的Bug，而是子集合更新时的格式规范问题。默认情况下，PutEntity端点处理嵌套子集合时，若未明确指定操作类型，会出现仅首个子项被错误覆盖的问题，具体原因和解决方法如下：

问题原因 #

1. 缺少操作类型标识：Acumatica API需要明确知道每个子项的操作类型（更新、新增、删除），未指定时会默认对整个子集合执行替换逻辑，而非逐个更新。
2. JSON格式语法错误：你的请求体中第一个联系人对象的ContactID字段后多了一个多余的逗号，可能导致API解析时出现异常，影响后续子项的处理。

修正后的请求示例 #

在每个联系人子项中添加__op: "update"标识，同时修正JSON语法错误：

{
  "id": "01a0c017-df7f-ea11-8175-b9d61cb73193",
  "Contacts": [
    {
      "__op": "update",
      "note": {
        "value": "Note for 100743"
      },
      "ContactID": {
        "value": 100743
      }
    },
    {
      "__op": "update",
      "note": {
        "value": "Note for 100745"
      },
      "ContactID": {
        "value": 100745
      }
    }
  ]
}

额外注意事项 #

• 如果子项是新增的，需要将__op设为"insert"；删除则设为"delete"。
• 确保每个子项的唯一标识符（如ContactID）准确无误，API依赖这些字段定位要更新的子记录。
• 若批量更新的子项数量较多，也可以考虑使用Patch端点替代PutEntity，Patch对部分字段更新的支持更灵活。

内容的提问来源于stack exchange，提问作者Al Orbis