Netsuite自定义表单API异常：字段缺失及POST创建报错排查

GET请求获取自定义字段的正确方式 #

• 明确指定所需字段：默认情况下NetSuite API不会返回所有自定义字段，需在请求URL的fields参数中完整列出需要的字段，包括标准字段和自定义字段的内部ID，示例：?fields=trandate,entity,custbody_your_custom_field
• 批量获取所有字段（慎用）：若需返回全部字段，可使用?fields=*，但生产环境建议只指定必要字段，避免数据冗余
• 核对自定义字段内部ID：进入自定义字段的配置页面，查看页面URL中的id参数，或在自定义字段列表中开启“内部ID”列确认，不要使用显示名称

POST请求创建实例的报错修复 #

• 严格使用内部ID：提交POST请求时，自定义字段必须用内部ID（如custbody_your_custom_field），不能用显示名称
• 检查字段应用范围：进入自定义字段设置的「应用于」标签，确认已勾选当前创建的交易类型（如销售订单、采购订单）
• 配置角色权限：在自定义字段的「权限」标签，给API调用所用的角色分配「创建/编辑」权限；同时在角色设置的「交易表单」标签，确保该角色能访问目标自定义表单
• 校验请求结构：确保自定义字段处于请求体的正确层级，以销售订单为例，正确的JSON结构示例：

  {
    "trandate": "2024-05-20",
    "entity": 100,
    "custbody_your_custom_field": "测试内容"
  }
  

额外排查项 #

• 确认表单设置生效：创建测试记录后，在NetSuite后台查看该记录是否关联了目标自定义表单，验证「Store Form with Record」配置是否生效
• 检查RESTlet/脚本逻辑：若使用自定义RESTlet，确认脚本中没有过滤或遗漏自定义字段的处理逻辑

内容的提问来源于stack exchange，提问作者Darragh.McL