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 NameRead Only:trueMaximum Length:360The name of the primary party of the contract request. -
ApprovedDate: string
(date-time)
Title:
Approved DateThe date when the contract request was approved. -
AssignedPersonName: string
Title:
AssigneeRead Only:trueMaximum Length:450The name of the assignee of the contract request. -
AssigneeFlag: boolean
Read Only:
trueIndicates if the current user has assignee role. -
AssigneeId: number
Title:
AssigneeThe unique identifier of the contract request assignee. -
AssigneeName: string
Title:
AssigneeMaximum Length:80Name of the assignee of contract request. -
AssigneeTypeCode: string
Title:
Assignee TypeMaximum Length:30The code of the assignee type associated with a contract request. -
AttachmentEntityName: string
Read Only:
trueMaximum Length:255Default Value:OKC_CONTRACT_REQUESTSThe attachment entity name for the contract. -
Attachments: array
Attachments
Title:
AttachmentsThe attachments resource is used to view, create, and update attachments. -
CancelAllowedFlag: boolean
Read Only:
trueIndicates whether the contract request can be canceled by the logged in user. -
CancelledByPersonId: integer
(int64)
The unique identifier of the person who canceled the contract request.
-
CancelledByPersonName: string
Title:
Canceled ByMaximum Length:80The name of the person who canceled the contract request. -
CancelledDate: string
(date-time)
Title:
Canceled DateThe date when the contract request was canceled. -
ChrId: number
The unique identifier of the contract created through contract request.
-
ContactDetails: string
Title:
Contact DetailsMaximum Length:1995The external party contact details of contract request. -
ContractAutoNumberFlag: boolean
Flag to check if auto numbering enabled for contract type
-
ContractBUId: integer
(int64)
Title:
Business UnitThe unique identifier of the business unit of contract for the contract request. -
ContractBUName: string
Title:
Business UnitMaximum Length:80The name of the business unit of contract created through the contract request. -
ContractEndDate: string
(date)
Title:
End DateThe end date of the contract created through contract request. -
ContractLeId: number
Title:
Legal EntityThe unique identifier of the legal entity of contract for the contract request. -
ContractLeName: string
Title:
Legal EntityMaximum Length:80The name of the legal entity of contract created through the contract request. -
ContractNumber: string
Title:
Contract NumberMaximum Length:120The contract number created through the contract request. -
ContractStartDate: string
(date)
Title:
Start DateThe start date of the contract created through contract request. -
ContractTypeId: number
Title:
Contract TypeThe unique identifier of the contract type for contract request. -
ContractTypeName: string
Title:
Contract TypeMaximum Length:80The name of the contract type of contract request. -
CorpCurrencyCode: string
Title:
Corporate Currency CodeMaximum Length:15The 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:
trueIndicates if the current user can create contract through the contract request. -
CreatedBy: string
Title:
Created ByRead Only:trueMaximum Length:64The user who created the record. -
CreationDate: string
(date-time)
Title:
Creation DateRead Only:trueThe date when the record was created. -
CurcyConvRateType: string
Title:
Currency Conversion Rate TypeMaximum Length:30The currency conversion rate for the contract. -
CurrencyCode: string
Title:
CurrencyMaximum Length:15The currency code for the contract. -
Description: string
Title:
DescriptionMaximum Length:1995The description of the contract request. -
DueDate: string
(date)
Title:
Due DateThe due date of contract request. -
Id: integer
The unique identifier of the contract request.
-
Intent: string
Maximum Length:
80The intent of contract created through the contract request. -
LastUpdateDate: string
(date-time)
Title:
Last Update DateRead Only:trueThe date on which the record was last updated. -
LastUpdatedBy: string
Title:
Last Updated ByRead Only:trueMaximum Length:64The user who last updated the record. -
LastUpdateLogin: string
Read Only:
trueMaximum Length:32The login of the user who last updated the record. -
LatestContractId: integer
Read Only:
trueThe unique identifier of the current version of the contract created through the contract request. -
links: array
Links
Title:
LinksThe link relations associated with the resource instance. -
ListAssigneeName: string
Title:
AssigneeRead Only:trueMaximum Length:255The 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:
OwnerThe unique identifier of the contract request owner. -
OwnerName: string
Title:
OwnerMaximum Length:80Name of the owner of contract request. -
OwnerPersonName: string
Title:
OwnerRead Only:trueMaximum Length:240The name of the owner of the contract request. -
PartyContactId: integer
(int64)
Title:
Contact NameThe unique identifier of the external contact of contract created through the contract request. -
PartyContactName: string
Title:
Contact NameMaximum Length:80The name of the external contact of contract created through the contract request. -
PartyDetails: string
Title:
Party DetailsMaximum Length:1995The external party details of contract request. -
PrimaryLedgerId: integer
(int64)
The unique identifier of the primary ledger.
-
PrimaryPartyId: number
Title:
Party NameThe unique identifier of the primary party of contract created through contract request. -
PrimaryPartyName: string
Title:
Party NameMaximum Length:80The name of the primary party of contract created through the contract request. -
PrimaryPartySupplierId: integer
Read Only:
trueThe supplier identifier of the primary party of the contract request. -
ProvideInformationFlag: boolean
Read Only:
trueIndicates if the current user can request information for contract request. -
RequestedByPersonId: integer
(int64)
Title:
RequesterThe unique identifier of the person who requested contract request. -
RequestedByPersonName: string
Title:
RequesterRead Only:trueMaximum Length:240The name of the requester of the contract request. -
RequestedTypeName: string
Title:
TypeRead Only:trueMaximum Length:150The name of the contract request type being requested for. -
RequesterFlag: boolean
Read Only:
trueIndicates if the current user has requester role. -
RequestMajorVersion: number
The source major version of the contract amended through contract request.
-
RequestNumber: string
Title:
NameMaximum Length:120The alternate unique identifier of the contract request. -
RequestStatus: string
Title:
StatusMaximum Length:30Default Value:ORA_OKC_DRAFTThe code indicating the status of the contract request. -
RequestStatusName: string
Title:
StatusRead Only:trueMaximum Length:80Name of the status of contract request. -
RequestTypeId: integer
(int64)
Title:
TypeThe unique identifier of the contract request type. -
RequestTypeName: string
Title:
TypeMaximum Length:150The name of the type of contract request. -
ShowCancelledRequestToAssignee: string
Maximum Length:
1Indicates whether the canceled contract request can be viewed by the assignee. -
smartActions: array
Smart Actions
Title:
Smart ActionsThe smart actions resource stores the endpoint and security details for every user action. -
SubmitForApprovalFlag: boolean
Read Only:
trueIndicates if the current user can submit contract request for approval. -
SubmitForReviewFlag: boolean
Read Only:
trueIndicates if the current user can submit contract request for review. -
SubmittedDate: string
(date-time)
Title:
Submitted DateThe date when the contract request was submitted. -
TaskId: string
Maximum Length:
64The unique identifier of the contract request approval human workflow task.
Nested Schema : Attachments
Type:
arrayTitle:
AttachmentsThe attachments resource is used to view, create, and update attachments.
Show Source
Nested Schema : Links
Type:
arrayTitle:
LinksThe link relations associated with the resource instance.
Show Source
Nested Schema : Smart Actions
Type:
arrayTitle:
Smart ActionsThe 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 IdAttribute provided for the exclusive use by the Attachment UI components to assist in uploading files. -
AttachedDocumentId: integer
(int64)
Title:
Attached Document IdThe unique identifier of the attached document. -
CategoryName: string
Title:
CategoryMaximum Length:30The category of the attachment. - ContentRepositoryFileShared: boolean
-
CreatedBy: string
Title:
Created ByRead Only:trueMaximum Length:255The user who created the record. -
CreatedByUserName: string
Title:
Created By User NameRead Only:trueThe user name who created the record. -
CreationDate: string
(date-time)
Title:
Creation DateRead Only:trueThe date when the record was created. -
DatatypeCode: string
Title:
TypeMaximum Length:30Default Value:FILEA value that indicates the data type. -
Description: string
Title:
DescriptionMaximum Length:255The description of the attachment. -
DmDocumentId: string
Maximum Length:
255The document ID from which the attachment is created. -
DmFolderPath: string
Title:
Dm Folder PathMaximum Length:1000The folder path from which the attachment is created. -
DmVersionNumber: string
Maximum Length:
255The document version number from which the attachment is created. -
DownloadInfo: string
Title:
DownloadInfoJSON object represented as a string containing information used to programmatically retrieve a file attachment. -
ErrorStatusCode: string
Title:
Error Status CodeThe error code, if any, for the attachment. -
ErrorStatusMessage: string
Title:
Error Status MessageThe error message, if any, for the attachment. -
ExpirationDate: string
(date-time)
Title:
Expiration DateThe expiration date of the contents in the attachment. -
FileContents: string
(byte)
Title:
File ContentsThe contents of the attachment. -
FileName: string
Title:
File NameMaximum Length:2048The file name of the attachment. -
FileUrl: string
Title:
File UrlThe URI of the file. -
FileWebImage: string
(byte)
Title:
File Web ImageRead Only:trueThe base64 encoded image of the file displayed in .png format if the source is a convertible image. -
LastUpdateDate: string
(date-time)
Title:
Last Update DateRead Only:trueThe date when the record was last updated. -
LastUpdatedBy: string
Title:
Last Updated ByRead Only:trueMaximum Length:255The user who last updated the record. -
LastUpdatedByUserName: string
Title:
Last Updated By UserRead Only:trueThe user name who last updated the record. -
links: array
Links
Title:
LinksThe link relations associated with the resource instance. -
PostProcessingAction: string
Title:
PostProcessingActionThe name of the action that can be performed after an attachment is uploaded. -
Title: string
Title:
TitleThe title of the attachment. -
UploadedFileContentType: string
Title:
Uploaded File Content TypeThe content type of the attachment. -
UploadedFileLength: integer
Title:
File SizeThe size of the attachment file. -
UploadedFileName: string
Title:
Uploaded File NameThe name to assign to a new attachment file. -
UploadedText: string
Title:
Uploaded TextThe text content for a new text attachment. -
Uri: string
Title:
UriMaximum Length:4000The URI of a Topology Manager type attachment. -
Url: string
Title:
UrlMaximum Length:4000The URL of a web page type attachment. -
UserName: string
Title:
User NameRead Only:trueMaximum Length:255The login credentials of the user who created the attachment.
Nested Schema : Links
Type:
arrayTitle:
LinksThe link relations associated with the resource instance.
Show Source
Nested Schema : link
Type:
Show Source
object-
href: string
Title:
hyperlink referenceThe URI to the related resource. -
kind: string
Title:
kindAllowed Values:[ "collection", "item", "describe", "other" ]The kind of the related resource. -
name: string
Title:
nameThe name of the link to the related resource. -
properties: object
properties
-
rel: string
Title:
relationAllowed 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 IntentJSON object that describes what an action does and what context data can be passed to the action. -
ConfirmationMessage: string
Title:
Confirmation MessageMaximum Length:4000A message to seek confirmation for the action being performed. -
ContentType: string
Title:
Content TypeMaximum Length:50The content type to use when invoking the REST endpoint. -
DisplayLabel: string
Title:
Action NameMaximum Length:256Consumer-friendly action name. -
Entity: string
Title:
Parent EntityMaximum Length:150REST Resources the action belongs to. -
Href: string
Title:
REST EndpointMaximum Length:1024The REST endpoint to perform the action. -
IncludedInApplication: string
Title:
Included in ApplicationMaximum Length:512List of applications that this action can be used in. -
links: array
Links
Title:
LinksThe link relations associated with the resource instance. -
MassActionFlag: boolean
Title:
Mass ActionMaximum Length:1Boolean type indicating if this action can be mass processed. -
Method: string
Title:
HTTP MethodMaximum Length:15HTTP method to use with HREF. -
ObjectFunctionName: string
Title:
Object FunctionMaximum Length:64The object function associated with the smart action. -
PageType: string
Title:
Page TypeMaximum Length:256The list of pages that this action can be used in. -
SmartSuggestFlag: boolean
Title:
Smart SuggestMaximum Length:1Indicates if smart suggest is enabled for the action. -
SystemActionFlag: boolean
Title:
System ActionMaximum Length:1Boolean type indicating if the action is seeded or custom. -
UpdateOfAttributes: string
Title:
Attributes to UpdateMaximum Length:512Attributes to be updated when the Actions UI is launched. -
UserActionId: integer
(int64)
Title:
User Action IDUniquely identifies the action. For internal use. -
UserActionName: string
Title:
Action NameMaximum Length:256Uniquely identifies the action with a name. For internal use. - UserActionNavigation: array User Action Navigations
-
UserActionRank: integer
(int64)
Title:
PriorityNumber to indicate priority of the action. -
UserActionRequestPayload: array
User Action Request Payloads
Title:
User Action Request PayloadsThe user action request payload resource stores the payload metadata of user action requests. -
UserActionURLBinding: array
User Action URL Bindings
Title:
User Action URL BindingsThe user action URL binding resource stores the user action URL binding metadata.
Nested Schema : Links
Type:
arrayTitle:
LinksThe link relations associated with the resource instance.
Show Source
Nested Schema : User Action Request Payloads
Type:
arrayTitle:
User Action Request PayloadsThe user action request payload resource stores the payload metadata of user action requests.
Show Source
Nested Schema : User Action URL Bindings
Type:
arrayTitle:
User Action URL BindingsThe 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 TypeMaximum Length:64Indicates the binding type of the value. -
links: array
Links
Title:
LinksThe link relations associated with the resource instance. -
MandatoryFlag: boolean
Title:
MandatoryMaximum Length:1Boolean 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 NameMaximum Length:256The key in the Key Value pair that forms the payload. -
SmartSuggestPath: string
Title:
Smart Suggest PathMaximum Length:2048The path used for smart suggest. -
SystemActionFlag: boolean
Title:
System ActionMaximum Length:1Default Value:falseBoolean value. -
Value: string
Title:
Request Payload Attribute ValueMaximum Length:1000The value in the Key Value pair that forms the payload. -
ValueStruct: string
Title:
Payload Value StructureMaximum Length:20If the value in the Key Value pair isn't a single value, this would be set.
Nested Schema : Links
Type:
arrayTitle:
LinksThe 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 TypeMaximum Length:64This is a hint for processing the Url Binding runtime. -
links: array
Links
Title:
LinksThe link relations associated with the resource instance. -
SystemActionFlag: boolean
Title:
System ActionMaximum Length:1Default Value:falseBoolean indicator. -
URLBindingId: integer
(int64)
Uniquely identifies the URL Bind for smart actions. For internal use.
-
URLBindingName: string
Title:
URL Binding Parameter NameMaximum Length:256For action REST endpoints that require runtime binding, this is the key in the key value pair. -
Value: string
Title:
URL Binding Parameter ValueMaximum Length:1000For action REST endpoints that require runtime binding, this is the value in the key value pair.
Nested Schema : Links
Type:
arrayTitle:
LinksThe 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: