@celigo/api-specs 0.2.210 → 0.2.211

package/dist/import.yml

@@ -4286,13 +4286,13 @@ components:
                       jsonPath:
                         type: string
                         description: |
-                          JSONPath into the source record that selects the
-                          data feeding this subrecord.  Semantics depend
+                          JSONPath from the source record root that selects
+                          the data feeding this subrecord.  Semantics depend
                           on placement:
                           * Line-level (on `lists[].fields[].`
-                            `subRecordMapping`) — often `$` to reuse
-                            the enclosing sublist line's row, or a path
-                            into a nested array on that row.
+                            `subRecordMapping`) — the array of lines the
+                            sublist iterates (`lineItems`); `$` only when
+                            each record is itself one line.
                           * Body-level (on `fields[].subRecordMapping`)
                             — a path into the source record root.
                           Defaults to `$`.
@@ -4484,9 +4484,10 @@ components:
                           type: boolean
                           description: |-
                             When true, this field is a key for matching the record's existing sublist lines: a
-                            mapped line updates the one existing line whose key fields hold the same values. `lists`
-                            says which records match lines, the keys used when no field sets `isKey`, and what a
-                            line that matches no line, or several, does.
+                            mapped line updates the one existing line whose key fields hold the same values —
+                            every key field must match, so several keys narrow the match. `lists` says which
+                            records match lines, the keys used when no field sets `isKey`, and what a line that
+                            matches no line, or several, does.
                         immutable:
                           type: boolean
                           description: When true, this field is only set on record creation, not on updates.
@@ -4565,13 +4566,19 @@ components:
                             jsonPath:
                               type: string
                               description: |
-                                JSONPath (relative to the current sublist
-                                line) to the rows that populate the
-                                subrecord.  Typically `$` when the
-                                subrecord data is carried on the same
-                                line item (iteration over the sublist
-                                has already selected the line).
-                                Defaults to `$`.
+                                Path from the source record root to the
+                                array of lines whose elements feed this
+                                subrecord — the same array the sublist
+                                iterates (`lineItems`, `items`); the n-th
+                                element populates the n-th sublist line.
+                                `$` only when each source record is itself
+                                one line. Defaults to `$`.
+                              x-celigo-ai-guidance:
+                                - |-
+                                  `$` on a record whose lines sit under a field renders no subrecord for any
+                                  line, and NetSuite rejects the first numbered line with `Please configure the
+                                  inventory detail in line N of the item list`; name the line array
+                                  (`lineItems`), never the current-line context.
                             mapping:
                               type: object
                               description: |
@@ -4682,6 +4689,11 @@ components:
                 with `MULTIPLE_LINES_WITH_SAME_KEYS` ("Multiple lines found with keys item=<value> ..."). A
                 line that matches none is added as a new line, which an item fulfillment's `item` sublist
                 refuses with `SSS_INVALID_SUBLIST_OPERATION`: its lines are its order's.
+
+                On a fulfillment created from an order, a kit's lot-, serial- or bin-managed components are
+                lines of their own under the kit's line, each with its own `line` and `orderline` (the
+                component's own order line) and `kitmemberof` holding the kit line's id; the inventory detail
+                belongs on those component lines, and a kit line refuses it.
               x-celigo-ai-guidance:
                 - |-
                   To make an update replace a sublist's lines, also map the body field
@@ -4696,6 +4708,24 @@ components:
                   field, or, on a fulfillment, the order line's id mapped to `orderline`. Keying on the item fails
                   with `MULTIPLE_LINES_WITH_SAME_KEYS` when an order holds the same item on two lines, and records
                   that already hold repeated lines fail the same way once a key is set.
+                - |-
+                  A key field is read from the existing lines, never written, so a read-only field keys as well
+                  as a writable one. The mapper's "Items : Line ID" is `line` (the fulfillment's own line number,
+                  equal to the order line only on a fresh full transform) and "Items : Line Number" is `linenum`;
+                  `orderline` and `kitmemberof` are not in its picker — type `item[*].orderline` /
+                  `item[*].kitmemberof` as the destination.
+                - |-
+                  Kit components on a fulfillment: the item is the only default key that reaches a component
+                  line, so a component two kit lines share fails with `MULTIPLE_LINES_WITH_SAME_KEYS`. Keying the
+                  component rows on the KIT's order line (`line` or `orderline`) selects the kit line instead and
+                  the save fails with `You cannot create an inventory detail for this item`. When the source
+                  carries the kit's order line on its component rows, keep the item as a key and add
+                  `item[*].kitmemberof` mapped from that line id as a second key, keep the kit rows in the list
+                  (their empty `kitmemberof` matches the kit line) with `item[*].celigo_ignore_current_line_invdetail_subrecord`
+                  true so no inventory detail is written on them, and build the inventory detail from each
+                  component row's own picks; component rows alone leave every kit line unfulfilled (`You must
+                  enter at least one line item for this transaction`). When the source can supply each
+                  component line's own order line id, key every row on `orderline` instead.
           x-celigo-agent:
             - mapping
         lookups:

package/dist/tool.yml

@@ -16495,13 +16495,13 @@ components:
                       jsonPath:
                         type: string
                         description: |
-                          JSONPath into the source record that selects the
-                          data feeding this subrecord.  Semantics depend
+                          JSONPath from the source record root that selects
+                          the data feeding this subrecord.  Semantics depend
                           on placement:
                           * Line-level (on `lists[].fields[].`
-                            `subRecordMapping`) — often `$` to reuse
-                            the enclosing sublist line's row, or a path
-                            into a nested array on that row.
+                            `subRecordMapping`) — the array of lines the
+                            sublist iterates (`lineItems`); `$` only when
+                            each record is itself one line.
                           * Body-level (on `fields[].subRecordMapping`)
                             — a path into the source record root.
                           Defaults to `$`.
@@ -16693,9 +16693,10 @@ components:
                           type: boolean
                           description: |-
                             When true, this field is a key for matching the record's existing sublist lines: a
-                            mapped line updates the one existing line whose key fields hold the same values. `lists`
-                            says which records match lines, the keys used when no field sets `isKey`, and what a
-                            line that matches no line, or several, does.
+                            mapped line updates the one existing line whose key fields hold the same values —
+                            every key field must match, so several keys narrow the match. `lists` says which
+                            records match lines, the keys used when no field sets `isKey`, and what a line that
+                            matches no line, or several, does.
                         immutable:
                           type: boolean
                           description: When true, this field is only set on record creation, not on updates.
@@ -16774,13 +16775,19 @@ components:
                             jsonPath:
                               type: string
                               description: |
-                                JSONPath (relative to the current sublist
-                                line) to the rows that populate the
-                                subrecord.  Typically `$` when the
-                                subrecord data is carried on the same
-                                line item (iteration over the sublist
-                                has already selected the line).
-                                Defaults to `$`.
+                                Path from the source record root to the
+                                array of lines whose elements feed this
+                                subrecord — the same array the sublist
+                                iterates (`lineItems`, `items`); the n-th
+                                element populates the n-th sublist line.
+                                `$` only when each source record is itself
+                                one line. Defaults to `$`.
+                              x-celigo-ai-guidance:
+                                - |-
+                                  `$` on a record whose lines sit under a field renders no subrecord for any
+                                  line, and NetSuite rejects the first numbered line with `Please configure the
+                                  inventory detail in line N of the item list`; name the line array
+                                  (`lineItems`), never the current-line context.
                             mapping:
                               type: object
                               description: |
@@ -16891,6 +16898,11 @@ components:
                 with `MULTIPLE_LINES_WITH_SAME_KEYS` ("Multiple lines found with keys item=<value> ..."). A
                 line that matches none is added as a new line, which an item fulfillment's `item` sublist
                 refuses with `SSS_INVALID_SUBLIST_OPERATION`: its lines are its order's.
+
+                On a fulfillment created from an order, a kit's lot-, serial- or bin-managed components are
+                lines of their own under the kit's line, each with its own `line` and `orderline` (the
+                component's own order line) and `kitmemberof` holding the kit line's id; the inventory detail
+                belongs on those component lines, and a kit line refuses it.
               x-celigo-ai-guidance:
                 - |-
                   To make an update replace a sublist's lines, also map the body field
@@ -16905,6 +16917,24 @@ components:
                   field, or, on a fulfillment, the order line's id mapped to `orderline`. Keying on the item fails
                   with `MULTIPLE_LINES_WITH_SAME_KEYS` when an order holds the same item on two lines, and records
                   that already hold repeated lines fail the same way once a key is set.
+                - |-
+                  A key field is read from the existing lines, never written, so a read-only field keys as well
+                  as a writable one. The mapper's "Items : Line ID" is `line` (the fulfillment's own line number,
+                  equal to the order line only on a fresh full transform) and "Items : Line Number" is `linenum`;
+                  `orderline` and `kitmemberof` are not in its picker — type `item[*].orderline` /
+                  `item[*].kitmemberof` as the destination.
+                - |-
+                  Kit components on a fulfillment: the item is the only default key that reaches a component
+                  line, so a component two kit lines share fails with `MULTIPLE_LINES_WITH_SAME_KEYS`. Keying the
+                  component rows on the KIT's order line (`line` or `orderline`) selects the kit line instead and
+                  the save fails with `You cannot create an inventory detail for this item`. When the source
+                  carries the kit's order line on its component rows, keep the item as a key and add
+                  `item[*].kitmemberof` mapped from that line id as a second key, keep the kit rows in the list
+                  (their empty `kitmemberof` matches the kit line) with `item[*].celigo_ignore_current_line_invdetail_subrecord`
+                  true so no inventory detail is written on them, and build the inventory detail from each
+                  component row's own picks; component rows alone leave every kit line unfulfilled (`You must
+                  enter at least one line item for this transaction`). When the source can supply each
+                  component line's own order line id, key every row on `orderline` instead.
           x-celigo-agent:
             - mapping
         lookups:

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@celigo/api-specs",
-  "version": "0.2.210",
+  "version": "0.2.211",
   "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": "869fd452",
-		"generatedAt": "2026-10-29"
+		"iasCommit": "055366b0",
+		"generatedAt": "2026-10-30"
 	},
 	"roots": {
 		"aiagent": 128,