{"ok":true,"commandType":"change-serial-number","module":"Stock","mode":"write","summary":"Change a serial number for an item.","payloadSchema":{"itemCode":"required AutoCount item code","oldSerialNumber":"required existing serial number","newSerialNumber":"required replacement serial number","validateOnly":"optional boolean; true runs this command as a no-change preflight and still requires Edit permission","confirm":"required true for an actual save; not required when validateOnly is true"},"examplePayload":{"itemCode":"ITEM-001","oldSerialNumber":"OLD-SN","newSerialNumber":"NEW-SN","confirm":true},"examples":[{"itemCode":"ITEM-001","oldSerialNumber":"OLD-SN","newSerialNumber":"NEW-SN","validateOnly":true}],"payloadEnums":{},"requiredPayloadFields":["itemCode","oldSerialNumber","newSerialNumber"],"conditionalPayloadRules":{},"notes":"Cloud validates and queues this typed command; it does not perform accounting work. Set validateOnly:true for preflight, then use a distinct commandId for the actual save. Reuse an ID only for an identical request. Runtime availability is connector-specific and reported by read-change-code-capabilities. Cloud schema does not prove native runtime support. The connector must preserve the native transaction sequence, linked-document serial lists, and fresh read-back.","nativePayload":{"commandType":"change-serial-number","title":"Change a serial number for an item.","description":"Static cloud payload schema. It does not assert that the installed connector supports this native operation.","supported":true,"schemaOnly":true,"runtimeAvailability":"read-change-code-capabilities","required":["itemCode","oldSerialNumber","newSerialNumber"],"fields":{"itemCode":{"type":"string","required":true,"description":"required AutoCount item code"},"oldSerialNumber":{"type":"string","required":true,"description":"required existing serial number"},"newSerialNumber":{"type":"string","required":true,"description":"required replacement serial number"}},"example":{"itemCode":"ITEM-001","oldSerialNumber":"OLD-SN","newSerialNumber":"NEW-SN"},"notes":["supported indicates that this payload schema is available, not that the installed connector has the native SDK operation.","Cloud schema does not prove native runtime support. The connector must preserve the native transaction sequence, linked-document serial lists, and fresh read-back."]}}