{"ok":true,"commandType":"change-item-uom-rate","module":"Stock","mode":"write","summary":"Change an item's UOM conversion rate.","payloadSchema":{"itemCode":"required AutoCount item code","uom":"required unit of measure","newRate":"required positive new UOM rate","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","uom":"BOX","newRate":12,"confirm":true},"examples":[{"itemCode":"ITEM-001","uom":"BOX","newRate":12,"validateOnly":true}],"payloadEnums":{},"requiredPayloadFields":["itemCode","uom","newRate"],"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. The native Int64 return is an optional POS ChangeLog ID; zero is valid and it is not a job ID. New connectors verify rate/dependent structure before automatic selected-item costing, in separate commits; TOOLS_STKCOST_RECAL_OPEN is also required. Native rate maintenance can repair batch balances book-wide, authorized by confirm:true. Historical guards remain; rateSaved with failed costing requires reconciliation, never an automatic rate retry.","nativePayload":{"commandType":"change-item-uom-rate","title":"Change an item's UOM conversion rate.","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","uom","newRate"],"fields":{"itemCode":{"type":"string","required":true,"description":"required AutoCount item code"},"uom":{"type":"string","required":true,"description":"required unit of measure"},"newRate":{"type":"number","required":true,"description":"required positive new UOM rate","minimum":0,"exclusiveMinimum":true}},"example":{"itemCode":"ITEM-001","uom":"BOX","newRate":12},"notes":["supported indicates that this payload schema is available, not that the installed connector has the native SDK operation.","The native Int64 return is an optional POS ChangeLog ID; zero is valid and it is not a job ID. New connectors verify rate/dependent structure before automatic selected-item costing, in separate commits; TOOLS_STKCOST_RECAL_OPEN is also required. Native rate maintenance can repair batch balances book-wide, authorized by confirm:true. Historical guards remain; rateSaved with failed costing requires reconciliation, never an automatic rate retry."]}}