eoTransferOwnership

Action Parameter eoTransferOwnership
Purpose To facilitate the transfer of ownership of a transaction
Description This interface facilitates the process of transferring ownership in a single step. It always follows the flow of: eoSellerInitiateTransfer, eoBuyerAcceptTransfer, and eoSellerConfirmTransfer. Please refer to the descriptions of each of these sub-steps for further details.
In the response returned, the transaction SID element is the new SID for the transaction in the buying organization.
Type Coarse
Preconditions Calling user has a valid user session established with eCore. Each transaction being transferred must contain at least one Electronic Original® document. Both the 'seller's' and 'buyer's' credentials are known. This interface should be used only when it is pre-known that the 'buyer' will accept the transfer request.

Parameters

Required Parameter Value Description
required instructionsXML XML instructions file describing the transactions and documents to be transferred and the retention policies to be applied to any retained documents.

The XML file must conform to the transfer.xsd schema (sample)
watermarkXML XML instructions file describing the watermark to be applied to the retained documents.

The XML file must conform to the transformation-instruction-set.xsd schema (sample).

To control the watermark to be applied based on retention policy, include definitions for each of the following in your watermarkProperties:
- watermarkInstructions-eStore-transferOwnership
- watermarkInstructions-electronicOriginal-transferOwnership
- watermarkInstructions-eCopy-transferOwnership

Response

We recommend using the most recent version of FireFox while testing API calls via your web browser. Microsoft Edge and Google Chrome require 3rd party XML extensions to display the XML response natively in your browser.