@celigo/api-specs 0.2.194 → 0.2.195

package/dist/import.yml

@@ -4145,6 +4145,10 @@ components:
             - |-
               Validated via the dedicated `PUT /v1/netsuiteDA/previewImportMappingFields`
               endpoint (NOT `/v1/processors/mapperProcessor`).
+            - |-
+              The preview resolves the mapping without writing to NetSuite: the multiselect row
+              NetSuite rejected at save time (see `fields[].dataType`) rendered exactly like the
+              row it accepted, so a passed preview does not prove the save.
           properties:
             fields:
               type: array
@@ -4180,9 +4184,21 @@ components:
                     type: string
                     description: |
                       Data type hint for the field value (e.g., "string", "number", "date", "boolean").
+                      Omit it on a multiselect reference row (`internalId: true`), which takes an array
+                      of numeric internal ids.
+                    x-celigo-ai-guidance:
+                      - |-
+                        On a multiselect reference row, `dataType: "stringarray"` with an array of string
+                        ids was written as ONE comma-joined text selection and NetSuite rejected the save
+                        with `Invalid <field> reference key <id1>,<id2>,…`, leaving the field empty; the
+                        same row with no `dataType` and an array of numeric ids saved every id as a
+                        selection.
                   internalId:
                     type: boolean
-                    description: When true, the value is a NetSuite internal ID reference.
+                    description: |-
+                      When true, the value is a NetSuite internal ID reference — the mapper's
+                      "(InternalId)" destination row, stored on the base field id in `generate` rather
+                      than as a `<field>.internalid` suffix.
                   immutable:
                     type: boolean
                     description: When true, this field is only set on record creation, not on updates.

package/dist/tool.yml

@@ -16154,6 +16154,10 @@ components:
             - |-
               Validated via the dedicated `PUT /v1/netsuiteDA/previewImportMappingFields`
               endpoint (NOT `/v1/processors/mapperProcessor`).
+            - |-
+              The preview resolves the mapping without writing to NetSuite: the multiselect row
+              NetSuite rejected at save time (see `fields[].dataType`) rendered exactly like the
+              row it accepted, so a passed preview does not prove the save.
           properties:
             fields:
               type: array
@@ -16189,9 +16193,21 @@ components:
                     type: string
                     description: |
                       Data type hint for the field value (e.g., "string", "number", "date", "boolean").
+                      Omit it on a multiselect reference row (`internalId: true`), which takes an array
+                      of numeric internal ids.
+                    x-celigo-ai-guidance:
+                      - |-
+                        On a multiselect reference row, `dataType: "stringarray"` with an array of string
+                        ids was written as ONE comma-joined text selection and NetSuite rejected the save
+                        with `Invalid <field> reference key <id1>,<id2>,…`, leaving the field empty; the
+                        same row with no `dataType` and an array of numeric ids saved every id as a
+                        selection.
                   internalId:
                     type: boolean
-                    description: When true, the value is a NetSuite internal ID reference.
+                    description: |-
+                      When true, the value is a NetSuite internal ID reference — the mapper's
+                      "(InternalId)" destination row, stored on the base field id in `generate` rather
+                      than as a `<field>.internalid` suffix.
                   immutable:
                     type: boolean
                     description: When true, this field is only set on record creation, not on updates.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@celigo/api-specs",
-  "version": "0.2.194",
+  "version": "0.2.195",
   "private": false,
   "description": "Public OpenAPI bundles (dist/) and the celigo-cli lint schema pack (schemas.json).",
   "keywords": [

package/schemas.json

@@ -1,8 +1,8 @@
 {
 	"provenance": {
 		"repo": "celigo/integrator-api-specs",
-		"iasCommit": "15622d32",
-		"generatedAt": "2026-10-26"
+		"iasCommit": "3dd79e2a",
+		"generatedAt": "2026-10-27"
 	},
 	"roots": {
 		"aiagent": 128,