如何为NetSuite销售订单API Restlet添加Purchase Order#自定义字段

步骤1：在NetSuite后台创建对应自定义字段 #

• 操作路径：自定义 > 事务处理 > 事务处理字段 > 新建
• 核心配置项：
  • 字段标签填写Purchase Order#，字段ID建议设置为custbody_po_number（系统会自动补全body级字段前缀custbody，代表是订单头级字段）
  • 字段类型选择自由文本，如有格式校验需求可按需更换为其他类型
  • 在「应用到」标签页勾选「销售订单」，确保字段关联到销售订单类型
  • 在「权限」标签页给你调用API使用的角色开放编辑权限，避免API传值时出现权限报错

步骤2：修改请求JSON新增自定义字段传参 #

NetSuite API传输自定义字段的规则是直接将字段ID作为键写入对应层级即可，如果你创建的是订单头级字段，修改后的请求示例如下：

{
    "entity":"1117",
    "recordtype":"salesorder",
    "custbody_po_number": "需要传入的采购订单号实际值",
    "item":[{"item":"311","amount":"1234"},{"item":"311","amount":"1234"}]
}

如果你创建的是订单行级别的自定义字段，把字段ID写入item数组对应行的对象中即可

步骤3：验证传值有效性 #

调用接口创建销售订单成功后，进入NetSuite对应销售订单详情页的自定义字段区域，确认Purchase Order#字段是否正常展示你传入的数值。如果没有正常展示，优先排查两个问题：字段ID是否写错（注意不要把custbody前缀错写为其他类型前缀）、API调用角色是否有该字段的编辑权限。

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