如何通过REST API或Restlets获取NetSuite自定义标签下的Entry Forms

架构老林

2026-6-25

NetSuite CRM类型Entry Form的API操作方案

Entry Form（包括CRM类型）对应的NetSuite标准record_type是customform，这是你需要的核心参数。
REST API调用方式
使用services/record/v1/customform端点，通过查询参数筛选CRM类型表单。可基于formtype字段过滤（CRM相关模块对应特定formtype数值，可在NetSuite UI查看目标表单的该字段值确认），示例请求：
```
GET /services/record/v1/customform?filter=formtype,anyof,1,2,3
```
若需更精准匹配CRM业务对象（如客户、商机），可结合recordtype字段筛选，比如只获取客户对应的Entry Form：
```
GET /services/record/v1/customform?filter=recordtype,is,customer
```

SuiteScript RestLet实现（N/record模块）
通过搜索API筛选CRM类型表单，示例代码：

/**
 * @NApiVersion 2.x
 * @NScriptType Restlet
 * @NModuleScope SameAccount
 */
define(['N/search'], function(search) {
    function fetchCRMCustomForms() {
        // 创建Custom Form搜索，筛选CRM相关类型
        var formSearch = search.create({
            type: search.Type.CUSTOM_FORM,
            filters: [
                ['recordtype', 'anyof', 'customer', 'opportunity', 'lead'] // 替换为目标CRM记录类型
            ],
            columns: ['name', 'formtype', 'recordtype']
        });
        
        var formList = [];
        formSearch.run().each(function(result) {
            formList.push({
                表单名称: result.getValue('name'),
                表单类型: result.getText('formtype'),
                关联记录类型: result.getValue('recordtype')
            });
            return true;
        });
        return formList;
    }

    return {
        get: fetchCRMCustomForms
    };
});

补充：如果不确定formtype或recordtype的具体值，可在NetSuite的记录浏览器（Setup > Integration > Record Browser）中查看customform记录的字段详情，或直接在UI中打开目标Entry Form，通过查看字段值获取对应参数。