Get a contract request
get
/fscmRestApi/resources/11.13.18.05/contractRequests/{RequestNumber}
Request
Path Parameters
-
RequestNumber(required): string
The alternate unique identifier of the contract request.
Query Parameters
-
dependency: string
This parameter specifies dependencies which are fields that are set before and rolled back after generating the response. Generally they are used to preview the effects of an attribute change. The fields specified in this parameter are always set in the resource instance in question. When a child resource collection is requested and the parameter is set, the fields will be set in the parent resource instance before generating the resource collection payload. The value of this query parameter is a set of dependency fields. Example: dependency=ProductId=2
Format: <attr1>=<val1>,<attr2>=<value2> -
expand: string
When this parameter is provided, the specified children are included in the resource payload (instead of just a link). The value of this query parameter is "all" or "". More than one child can be specified using comma as a separator. Example: ?expand=Employees,Localizations. Nested children can also be provided following the format "Child.NestedChild" (Example: ?expand=Employees.Managers). If a nested child is provided (Example: Employees.Managers), the missing children will be processed implicitly. For example, "?expand=Employees.Managers" is the same as "?expand=Employees,Employees.Managers" (which will expand Employees and Managers).
-
fields: string
This parameter filters the resource fields. Only the specified fields are returned, which means that if no fields are specified, no fields are returned (useful to get only the links). If an indirect child resource is provided (Example: Employees.Managers), the missing children will be processed implicitly. For example, "?fields=Employees.Managers:Empname" is the same as "?fields=;Employees:;Employees.Managers:Empname" (which will only return the "Empname" field for Managers). the value of this query parameter is a list of resource fields. The attribute can be a direct (Example: Employees) or indirect (Example: Employees.Managers) child. It cannot be combined with expand query parameter. If both are provided, only fields will be considered.
Format: ?fields=Attribute1,Attribute2
Format for fields in child resource: ?fields=Accessor1:Attribute1,Attribute2 -
links: string
This parameter can be used to show only certain links while accessing a singular resource or a resource collection. The parameter value format is a comma-separated list of : <link_relation>
Example:
self,canonical -
onlyData: boolean
The resource item payload will be filtered in order to contain only data (no links section, for example).
Header Parameters
-
Metadata-Context: string
If the REST API supports runtime customizations, the shape of the service may change during runtime. The REST client may isolate itself from these changes or choose to interact with the latest version of the API by specifying this header. For example: Metadata-Context:sandbox="TrackEmployeeFeature".
-
REST-Framework-Version: string
The protocol version between a REST client and service. If the client does not specify this header in the request the server will pick a default version for the API.
There's no request body for this operation.
Back to TopResponse
Supported Media Types
- application/json
Default Response
The following table describes the default response for this task.
Headers
-
Metadata-Context:
If the REST API supports runtime customizations, the shape of the service may change during runtime. The REST client may isolate itself from these changes or choose to interact with the latest version of the API by specifying this header. For example: Metadata-Context:sandbox="TrackEmployeeFeature".
-
REST-Framework-Version:
The protocol version between a REST client and service. If the client does not specify this header in the request the server will pick a default version for the API.
Root Schema : contractRequests-item-response
Type:
Show Source
object
-
AllPartyName: string
Title:
Party Name
Read Only:true
Maximum Length:360
The name of the primary party of the contract request. -
AssignedPersonName: string
Title:
Assignee
Read Only:true
Maximum Length:450
The name of the assignee of the contract request. -
AssigneeFlag: boolean
Read Only:
true
Indicates if the current user has assignee role. -
AssigneeId: number
Title:
Assignee
The unique identifier of the contract request assignee. -
AssigneeName: string
Title:
Assignee
Maximum Length:80
Name of the assignee of contract request. -
AssigneeTypeCode: string
Title:
Assignee Type
Maximum Length:30
The code of the assignee type associated with a contract request. -
AttachmentEntityName: string
Read Only:
true
Maximum Length:255
Default Value:OKC_CONTRACT_REQUESTS
The attachment entity name for the contract. -
Attachments: array
Attachments
Title:
Attachments
The attachments resource is used to view, create, and update attachments. -
ChrId: number
The unique identifier of the contract created through contract request.
-
ContactDetails: string
Title:
Contact Details
Maximum Length:1995
The external party contact details of contract request. -
ContractAutoNumberFlag: boolean
Flag to check if auto numbering enabled for contract type
-
ContractBUId: integer
(int64)
Title:
Business Unit
The unique identifier of the business unit of contract for the contract request. -
ContractBUName: string
Title:
Business Unit
Maximum Length:80
The name of the business unit of contract created through the contract request. -
ContractEndDate: string
(date)
Title:
End Date
The end date of the contract created through contract request. -
ContractLeId: number
Title:
Legal Entity
The unique identifier of the legal entity of contract for the contract request. -
ContractLeName: string
Title:
Legal Entity
Maximum Length:80
The name of the legal entity of contract created through the contract request. -
ContractNumber: string
Title:
Contract Number
Maximum Length:120
The contract number created through the contract request. -
ContractStartDate: string
(date)
Title:
Start Date
The start date of the contract created through contract request. -
ContractTypeId: number
Title:
Contract Type
The unique identifier of the contract type for contract request. -
ContractTypeName: string
Title:
Contract Type
Maximum Length:80
The name of the contract type of contract request. -
CorpCurrencyCode: string
Title:
Corporate Currency Code
Maximum Length:15
The currency code for the contract. This attribute is used by CRM Extensibility framework. A list of valid values are defined in the lookup RatedCurrenciesVO. -
CreateContractFlag: boolean
Read Only:
true
Indicates if the current user can create contract through the contract request. -
CreatedBy: string
Title:
Created By
Read Only:true
Maximum Length:64
The user who created the record. -
CreationDate: string
(date-time)
Title:
Creation Date
Read Only:true
The date when the record was created. -
CurcyConvRateType: string
Title:
Currency Conversion Rate Type
Maximum Length:30
The currency conversion rate for the contract. -
CurrencyCode: string
Title:
Currency
Maximum Length:15
The currency code for the contract. -
Description: string
Title:
Description
Maximum Length:1995
The description of the contract request. -
DueDate: string
(date)
Title:
Due Date
The due date of contract request. -
Id: integer
The unique identifier of the contract request.
-
Intent: string
Maximum Length:
80
The intent of contract created through the contract request. -
LastUpdateDate: string
(date-time)
Title:
Last Update Date
Read Only:true
The date on which the record was last updated. -
LastUpdatedBy: string
Title:
Last Updated By
Read Only:true
Maximum Length:64
The user who last updated the record. -
LastUpdateLogin: string
Read Only:
true
Maximum Length:32
The login of the user who last updated the record. -
LatestContractId: integer
Read Only:
true
The unique identifier of the current version of the contract created through the contract request. -
links: array
Links
Title:
Links
The link relations associated with the resource instance. -
ListAssigneeName: string
Title:
Assignee
Read Only:true
Maximum Length:255
The name of the contract request assignee. -
ObjectVersionNumber: integer
(int32)
The object version number of the contract request.
-
OutcomeMajorVersion: number
The resultant major version of the contract amended through contract request.
-
OwnerId: number
Title:
Owner
The unique identifier of the contract request owner. -
OwnerName: string
Title:
Owner
Maximum Length:80
Name of the owner of contract request. -
OwnerPersonName: string
Title:
Owner
Read Only:true
Maximum Length:240
The name of the owner of the contract request. -
PartyContactId: integer
(int64)
Title:
Contact Name
The unique identifier of the external contact of contract created through the contract request. -
PartyContactName: string
Title:
Contact Name
Maximum Length:80
The name of the external contact of contract created through the contract request. -
PartyDetails: string
Title:
Party Details
Maximum Length:1995
The external party details of contract request. -
PrimaryLedgerId: integer
(int64)
The unique identifier of the primary ledger.
-
PrimaryPartyId: number
Title:
Party Name
The unique identifier of the primary party of contract created through contract request. -
PrimaryPartyName: string
Title:
Party Name
Maximum Length:80
The name of the primary party of contract created through the contract request. -
PrimaryPartySupplierId: integer
Read Only:
true
The supplier identifier of the primary party of the contract request. -
ProvideInformationFlag: boolean
Read Only:
true
Indicates if the current user can request information for contract request. -
RequestedByPersonId: integer
(int64)
Title:
Requester
The unique identifier of the person who requested contract request. -
RequestedByPersonName: string
Title:
Requester
Read Only:true
Maximum Length:240
The name of the requester of the contract request. -
RequestedTypeName: string
Title:
Type
Read Only:true
Maximum Length:150
The name of the contract request type being requested for. -
RequesterFlag: boolean
Read Only:
true
Indicates if the current user has requester role. -
RequestMajorVersion: number
The source major version of the contract amended through contract request.
-
RequestNumber: string
Title:
Name
Maximum Length:120
The alternate unique identifier of the contract request. -
RequestStatus: string
Title:
Status
Maximum Length:30
Default Value:ORA_OKC_DRAFT
The code indicating the status of the contract request. -
RequestStatusName: string
Title:
Status
Read Only:true
Maximum Length:80
Name of the status of contract request. -
RequestTypeId: integer
(int64)
Title:
Type
The unique identifier of the contract request type. -
RequestTypeName: string
Title:
Type
Maximum Length:150
The name of the type of contract request. -
smartActions: array
Smart Actions
Title:
Smart Actions
The smart actions resource stores the endpoint and security details for every user action. -
SubmitForApprovalFlag: boolean
Read Only:
true
Indicates if the current user can submit contract request for approval. -
SubmitForReviewFlag: boolean
Read Only:
true
Indicates if the current user can submit contract request for review. -
TaskId: string
Maximum Length:
64
The unique identifier of the contract request approval human workflow task.
Nested Schema : Attachments
Type:
array
Title:
Attachments
The attachments resource is used to view, create, and update attachments.
Show Source
Nested Schema : Links
Type:
array
Title:
Links
The link relations associated with the resource instance.
Show Source
Nested Schema : Smart Actions
Type:
array
Title:
Smart Actions
The smart actions resource stores the endpoint and security details for every user action.
Show Source
Nested Schema : contractRequests-Attachments-item-response
Type:
Show Source
object
-
AsyncTrackerId: string
Title:
Asynchronous Upload Tracker Id
Attribute provided for the exclusive use by the Attachment UI components to assist in uploading files. -
AttachedDocumentId: integer
(int64)
Title:
Attached Document Id
The unique identifier of the attached document. -
CategoryName: string
Title:
Category
Maximum Length:30
The category of the attachment. - ContentRepositoryFileShared: boolean
-
CreatedBy: string
Title:
Created By
Read Only:true
Maximum Length:255
The user who created the record. -
CreatedByUserName: string
Title:
Created By User Name
Read Only:true
The user name who created the record. -
CreationDate: string
(date-time)
Title:
Creation Date
Read Only:true
The date when the record was created. -
DatatypeCode: string
Title:
Type
Maximum Length:30
Default Value:FILE
A value that indicates the data type. -
Description: string
Title:
Description
Maximum Length:255
The description of the attachment. -
DmDocumentId: string
Maximum Length:
255
The document ID from which the attachment is created. -
DmFolderPath: string
Title:
Dm Folder Path
Maximum Length:1000
The folder path from which the attachment is created. -
DmVersionNumber: string
Maximum Length:
255
The document version number from which the attachment is created. -
DownloadInfo: string
Title:
DownloadInfo
JSON object represented as a string containing information used to programmatically retrieve a file attachment. -
ErrorStatusCode: string
Title:
Error Status Code
The error code, if any, for the attachment. -
ErrorStatusMessage: string
Title:
Error Status Message
The error message, if any, for the attachment. -
ExpirationDate: string
(date-time)
Title:
Expiration Date
The expiration date of the contents in the attachment. -
FileContents: string
(byte)
Title:
File Contents
The contents of the attachment. -
FileName: string
Title:
File Name
Maximum Length:2048
The file name of the attachment. -
FileUrl: string
Title:
File Url
The URI of the file. -
FileWebImage: string
(byte)
Title:
File Web Image
Read Only:true
The base64 encoded image of the file displayed in .png format if the source is a convertible image. -
LastUpdateDate: string
(date-time)
Title:
Last Update Date
Read Only:true
The date when the record was last updated. -
LastUpdatedBy: string
Title:
Last Updated By
Read Only:true
Maximum Length:255
The user who last updated the record. -
LastUpdatedByUserName: string
Title:
Last Updated By User
Read Only:true
The user name who last updated the record. -
links: array
Links
Title:
Links
The link relations associated with the resource instance. -
PostProcessingAction: string
Title:
PostProcessingAction
The name of the action that can be performed after an attachment is uploaded. -
Title: string
Title:
Title
The title of the attachment. -
UploadedFileContentType: string
Title:
Uploaded File Content Type
The content type of the attachment. -
UploadedFileLength: integer
Title:
File Size
The size of the attachment file. -
UploadedFileName: string
Title:
Uploaded File Name
The name to assign to a new attachment file. -
UploadedText: string
Title:
Uploaded Text
The text content for a new text attachment. -
Uri: string
Title:
Uri
Maximum Length:4000
The URI of a Topology Manager type attachment. -
Url: string
Title:
Url
Maximum Length:4000
The URL of a web page type attachment. -
UserName: string
Title:
User Name
Read Only:true
Maximum Length:255
The login credentials of the user who created the attachment.
Nested Schema : Links
Type:
array
Title:
Links
The link relations associated with the resource instance.
Show Source
Nested Schema : link
Type:
Show Source
object
-
href: string
Title:
hyperlink reference
The URI to the related resource. -
kind: string
Title:
kind
Allowed Values:[ "collection", "item", "describe", "other" ]
The kind of the related resource. -
name: string
Title:
name
The name of the link to the related resource. -
properties: object
properties
-
rel: string
Title:
relation
Allowed Values:[ "self", "lov", "parent", "canonical", "child", "enclosure", "action", "custom" ]
The name of the relation to the resource instance. Example: self.
Nested Schema : properties
Type:
Show Source
object
-
changeIndicator: string
Change indicator or the ETag value of the resource instance.
Nested Schema : contractRequests-smartActions-item-response
Type:
Show Source
object
-
ActionIntent: string
(byte)
Title:
Action Intent
JSON object that describes what an action does and what context data can be passed to the action. -
ConfirmationMessage: string
Title:
Confirmation Message
Maximum Length:4000
A message to seek confirmation for the action being performed. -
ContentType: string
Title:
Content Type
Maximum Length:50
The content type to use when invoking the REST endpoint. -
DisplayLabel: string
Title:
Action Name
Maximum Length:256
Consumer-friendly action name. -
Entity: string
Title:
Parent Entity
Maximum Length:150
REST Resources the action belongs to. -
Href: string
Title:
REST Endpoint
Maximum Length:1024
The REST endpoint to perform the action. -
IncludedInApplication: string
Title:
Included in Application
Maximum Length:512
List of applications that this action can be used in. -
links: array
Links
Title:
Links
The link relations associated with the resource instance. -
MassActionFlag: boolean
Title:
Mass Action
Maximum Length:1
Boolean type indicating if this action can be mass processed. -
Method: string
Title:
HTTP Method
Maximum Length:15
HTTP method to use with HREF. -
ObjectFunctionName: string
Title:
Object Function
Maximum Length:64
The object function associated with the smart action. -
PageType: string
Title:
Page Type
Maximum Length:256
The list of pages that this action can be used in. -
SmartSuggestFlag: boolean
Title:
Smart Suggest
Maximum Length:1
Indicates if smart suggest is enabled for the action. -
SystemActionFlag: boolean
Title:
System Action
Maximum Length:1
Boolean type indicating if the action is seeded or custom. -
UpdateOfAttributes: string
Title:
Attributes to Update
Maximum Length:512
Attributes to be updated when the Actions UI is launched. -
UserActionId: integer
(int64)
Title:
User Action ID
Uniquely identifies the action. For internal use. -
UserActionName: string
Title:
Action Name
Maximum Length:256
Uniquely identifies the action with a name. For internal use. - UserActionNavigation: array User Action Navigations
-
UserActionRank: integer
(int64)
Title:
Priority
Number to indicate priority of the action. -
UserActionRequestPayload: array
User Action Request Payloads
Title:
User Action Request Payloads
The user action request payload resource stores the payload metadata of user action requests. -
UserActionURLBinding: array
User Action URL Bindings
Title:
User Action URL Bindings
The user action URL binding resource stores the user action URL binding metadata.
Nested Schema : Links
Type:
array
Title:
Links
The link relations associated with the resource instance.
Show Source
Nested Schema : User Action Request Payloads
Type:
array
Title:
User Action Request Payloads
The user action request payload resource stores the payload metadata of user action requests.
Show Source
Nested Schema : User Action URL Bindings
Type:
array
Title:
User Action URL Bindings
The user action URL binding resource stores the user action URL binding metadata.
Show Source
Nested Schema : contractRequests-smartActions-UserActionRequestPayload-item-response
Type:
Show Source
object
-
Binding: string
Title:
Payload Value Binding Type
Maximum Length:64
Indicates the binding type of the value. -
links: array
Links
Title:
Links
The link relations associated with the resource instance. -
MandatoryFlag: boolean
Title:
Mandatory
Maximum Length:1
Boolean value indicating if the payload is mandatory. -
RequestPayloadId: integer
(int64)
Uniquely identifies the payload for smart actions. For internal use.
-
RequestPayloadName: string
Title:
Request Payload Attribute Name
Maximum Length:256
The key in the Key Value pair that forms the payload. -
SmartSuggestPath: string
Title:
Smart Suggest Path
Maximum Length:2048
The path used for smart suggest. -
SystemActionFlag: boolean
Title:
System Action
Maximum Length:1
Default Value:false
Boolean value. -
Value: string
Title:
Request Payload Attribute Value
Maximum Length:1000
The value in the Key Value pair that forms the payload. -
ValueStruct: string
Title:
Payload Value Structure
Maximum Length:20
If the value in the Key Value pair isn't a single value, this would be set.
Nested Schema : Links
Type:
array
Title:
Links
The link relations associated with the resource instance.
Show Source
Nested Schema : contractRequests-smartActions-UserActionURLBinding-item-response
Type:
Show Source
object
-
Binding: string
Title:
URL Binding Type
Maximum Length:64
This is a hint for processing the Url Binding runtime. -
links: array
Links
Title:
Links
The link relations associated with the resource instance. -
SystemActionFlag: boolean
Title:
System Action
Maximum Length:1
Default Value:false
Boolean indicator. -
URLBindingId: integer
(int64)
Uniquely identifies the URL Bind for smart actions. For internal use.
-
URLBindingName: string
Title:
URL Binding Parameter Name
Maximum Length:256
For action REST endpoints that require runtime binding, this is the key in the key value pair. -
Value: string
Title:
URL Binding Parameter Value
Maximum Length:1000
For action REST endpoints that require runtime binding, this is the value in the key value pair.
Nested Schema : Links
Type:
array
Title:
Links
The link relations associated with the resource instance.
Show Source
Links
- AssigneeTypeLookupVOVA1
-
The following properties are defined on the LOV link relation:
- Source Attribute: AssigneeTypeCode; Target Attribute: LookupCode
- Display Attribute: Meaning
- AssigneeVOVA1
-
Parameters:
- finder:
ObjectCodeFinder%3BbindObjectCode%3D{AssigneeTypeCode}
The following properties are defined on the LOV link relation:- Source Attribute: AssigneeName; Target Attribute: Name
- Display Attribute: Name
- finder:
- Attachments
-
Parameters:
- RequestNumber:
$request.path.RequestNumber
The attachments resource is used to view, create, and update attachments. - RequestNumber:
- ContractRequestConTypeVOVA1
-
Parameters:
- finder:
RequestTypeConTypeFinder%3BbindRequestTypeId%3D{RequestTypeId}
The following properties are defined on the LOV link relation:- Source Attribute: ContractTypeName; Target Attribute: Name
- Display Attribute: Name
- finder:
- ContractRequestConTypeVOVA2
-
Parameters:
- finder:
RequestTypeConTypeFinder%3BbindRequestTypeId%3D{RequestTypeId}
The following properties are defined on the LOV link relation:- Source Attribute: ContractTypeId; Target Attribute: ContractTypeId
- Display Attribute: Name
- finder:
- ContractRequestLegalEntityVOVA
-
Parameters:
- finder:
LedgerBasedFinder%3BbindPrimaryLedgerId%3D{PrimaryLedgerId}
The following properties are defined on the LOV link relation:- Source Attribute: ContractLeName; Target Attribute: LegalEntityIdentifier
- Display Attribute: LegalEntityIdentifier, LegalEntityName
- finder:
- ContractRequestPartyVOVA1
-
Parameters:
- finder:
IntentBasedFinder%3BbindPartyIntent%3D{Intent}
The following properties are defined on the LOV link relation:- Source Attribute: PrimaryPartyName; Target Attribute: PartyName
- Display Attribute: PartyName, PartyNumber
- finder:
- ContractRequestPartyVOVA3
-
Parameters:
- finder:
IntentBasedFinder%3BbindPartyIntent%3D{Intent}
The following properties are defined on the LOV link relation:- Source Attribute: PrimaryPartyId; Target Attribute: PartyId
- Display Attribute: PartyName
- finder:
- ContractRequestTypeVOVA
-
The following properties are defined on the LOV link relation:
- Source Attribute: RequestTypeName; Target Attribute: Name
- Display Attribute: Name
- ContractRequestTypeVOVA2
-
Parameters:
- finder:
RequestTypeEffectiveDated
The following properties are defined on the LOV link relation:- Source Attribute: RequestTypeId; Target Attribute: Id
- Display Attribute: Name
- finder:
- CurrencyPVOVA
-
The following properties are defined on the LOV link relation:
- Source Attribute: CurrencyCode; Target Attribute: CurrencyCode
- Display Attribute: Name
- FinFunBusinessUnitVOVA1
-
The following properties are defined on the LOV link relation:
- Source Attribute: ContractBUName; Target Attribute: BusinessUnitName
- Display Attribute: BusinessUnitName
- LookupPVOVA
-
Parameters:
- finder:
LookupTypeActiveEnabledOrBindCodeFinder%3BBindLookupType%3DORA_OKC_REQUEST_STATUS
The following properties are defined on the LOV link relation:- Source Attribute: RequestStatus; Target Attribute: LookupCode
- Display Attribute: Meaning
- finder:
- PcontactVOVA1
-
Parameters:
- finder:
PartyStatusFinder%3BPartyIdVar%3D{PrimaryPartyId}%2CStatusVar%3DA
The following properties are defined on the LOV link relation:- Source Attribute: PartyContactName; Target Attribute: ContactName
- Display Attribute: ContactName, Department, EmailAddress, JobTitle
- finder:
- PcontactVOVA2
-
Parameters:
- finder:
PartyStatusFinder%3BPartyIdVar%3D{PrimaryPartyId}%2CStatusVar%3DA
The following properties are defined on the LOV link relation:- Source Attribute: PartyContactId; Target Attribute: ContactId
- Display Attribute: ContactName
- finder:
- PersonLovPVOVA
-
The following properties are defined on the LOV link relation:
- Source Attribute: OwnerName; Target Attribute: DisplayName
- Display Attribute: DisplayName
- PersonLovPVOVA2
-
The following properties are defined on the LOV link relation:
- Source Attribute: OwnerId; Target Attribute: PersonId
- Display Attribute: DisplayName
- smartActions
-
Parameters:
- RequestNumber:
$request.path.RequestNumber
The smart actions resource stores the endpoint and security details for every user action. - RequestNumber: