使用Postman调用NetSuite REST API的SuiteQL查询时提示记录未找到

1. 确认REST Web Services功能已启用 #

登录NetSuite后台，进入 设置 > 公司 > 启用功能，找到Web Services分类，确保REST Web Services选项已勾选。这是REST API正常运行的基础前提。

2. 补全角色的REST相关权限 #

除了客户记录的访问权限，还需给操作角色添加REST和SuiteQL专属权限：

• 进入 设置 > 用户/角色 > 管理角色，找到目标角色
• 在权限 > 设置标签下，添加以下权限并设为「完全访问」：
  • REST Web Services
  • SuiteQL
• 在权限 > 记录标签下，确认**客户（Customer）**权限至少设为「查看」及以上级别

3. 确保SuiteQL表名正确 #

NetSuite SuiteQL对记录的表名采用单数标准名称，客户对应的正确表名就是customer（大小写不敏感），无需额外修改。如果仍报错，检查查询语句是否有语法错误，比如：

错误示例：SELECT * FROM customers（多了后缀s）
正确示例：SELECT id, companyname FROM customer LIMIT 10

4. 验证Postman请求格式正确性 #

确保请求的关键参数无误：

• 请求方法：POST
• 请求URL：https://<你的NetSuite账户ID>.suitetalk.api.netsuite.com/services/rest/query/v1/suiteql
• 请求头必须包含：
  • Authorization: Bearer <你的访问令牌>
  • Content-Type: application/json
  • Prefer: transient（用于返回完整数据结构）
• 请求体格式示例：

{
  "q": "SELECT id, companyname FROM customer LIMIT 10"
}

5. 确认账户SuiteQL访问权限 #

部分NetSuite账户需管理员额外开启SuiteQL的全局访问权限，若以上设置都完成仍报错，联系内部NetSuite管理员确认账户是否被允许使用SuiteQL查询。

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