使用Netsuite REST API创建客户时地址设置报错求助

问题诊断 #

从请求体和错误信息来看，核心问题是地址对象的格式不符合Netsuite REST API的规范，具体问题如下：

• Country字段格式错误：country.id被设为数组["US"]，但Netsuite要求该字段为单个字符串值；同时refName拼写错误，正确名称应为"United States"
• 多余的addressBookAddress_text字段：该字段是系统自动生成的地址文本，无需手动在请求体中传入
• 邮编格式不符合要求：美国地区邮编通常为5位，你传入的"1222"是4位，可能触发格式校验

修正后的请求体 #

{
    "companyName": "New York {{$timestamp}}",
    "email": "newyork@ny.com",
    "subsidiary" : 9,
    "phone" : "021-021-2222",
    "entitystatus" : 13,
    "addressBook": {
        "items" : [
            {
                "addressBookAddress": {
                    "addr1": "123 Street",
                    "addrPhone": "12312312",
                    "addrText" : "addrText",
                    "addressee" : "addressee",
                    "city" : "New York",
                    "country" : {
                        "id" : "US",
                        "refName" : "United States"
                    },
                    "state" : "NY",
                    "zip" : "12222"
                },
                "label" : "label"
            }
        ]
    }
}

验证步骤 #

1. 移除addressBookAddress_text字段，避免系统校验冲突
2. 将country.id从数组改为单个字符串"US"，修正refName为正确的国家名称
3. 调整邮编为符合美国地区的5位格式（适配业务场景要求）
4. 重新用Postman发送请求，验证是否能成功创建带地址的客户

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