{"ok":true,"commandType":"change-purchase-agent","module":"Purchase","mode":"write","summary":"Change a purchase agent code.","payloadSchema":{"oldAgent":"required old value for oldAgent","newAgent":"required new value for newAgent","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":{"oldAgent":"OLD-AGENT","newAgent":"NEW-AGENT","confirm":true},"examples":[{"oldAgent":"OLD-AGENT","newAgent":"NEW-AGENT","validateOnly":true}],"payloadEnums":{},"requiredPayloadFields":["oldAgent","newAgent"],"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.","nativePayload":{"commandType":"change-purchase-agent","title":"Change a purchase agent code.","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":["oldAgent","newAgent"],"fields":{"oldAgent":{"type":"string","required":true,"description":"required old value for oldAgent"},"newAgent":{"type":"string","required":true,"description":"required new value for newAgent"}},"example":{"oldAgent":"OLD-AGENT","newAgent":"NEW-AGENT"},"notes":["supported indicates that this payload schema is available, not that the installed connector has the native SDK operation."]}}