Create transactions

post

/fscmRestApi/resources/11.13.18.05/resourceTransactions

Request

Header Parameters
  • 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".
  • 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.
Supported Media Types
Request Body - application/json ()
Root Schema : schema
Type: object
Show Source
  • Resource Transaction Details
    Title: Resource Transaction Details
    The Resource Transaction Details resource manages the details of the resource charges to the work order.
  • Title: Source System Code
    Maximum Length: 30
    Abbreviation that indicates the source system from which data is being imported. Depending on the type of source system, this value could represent an internal Oracle Fusion product code or the actual trading community (TCA) source system reference.
  • Title: Source System Type
    Maximum Length: 30
    Default Value: EXTERNAL
    Value that indicates the type of source system (internal or external) from which data is being imported. A list of accepted values is defined in the lookup type ORA_WIE_SOURCE_SYSTEM_TYPE. The default value is EXTERNAL.
Nested Schema : Resource Transaction Details
Type: array
Title: Resource Transaction Details
The Resource Transaction Details resource manages the details of the resource charges to the work order.
Show Source
Nested Schema : schema
Type: object
Show Source
  • Title: Equipment Identifier
    Maximum Length: 80
    Abbreviation that identifies the equipment resource instance.
  • Title: Labor Identifier
    Maximum Length: 30
    Abbreviation that identifies the labor resource instance.
  • Title: Operation Sequence
    Number that represents the work order operation sequence for which this resource transaction is being performed.
  • Title: Organization Code
    Maximum Length: 30
    Abbreviation that indicates the manufacturing plant to which this resource transaction is performed.
  • Title: Resource Activity Code
    Maximum Length: 30
    Abbreviation that indicates the activity this production resource is performing at this operation. A list of accepted values is defined in the lookup type ORA_WIS_RESOURCE_ACTIVITY.
  • Title: Resource Code
    Maximum Length: 30
    Abbreviation that indicates the resource against which the quantity is transacted. This value is a user-specified key.
  • Title: Resource Sequence
    Sequence number of the resource associated to this work order operation resource transaction.
  • Flexfields for Resource Transactions
    Title: Flexfields for Resource Transactions
    The Flexfields for Resource Transactions resource manages descriptive flexfields that contain details about the resource transaction.
  • Title: Source Header Reference
    Maximum Length: 240
    Value that identifies the user-facing header reference of the source system.
  • Title: Source Header Reference ID
    Value that identifies the internal header reference of the source system.
  • Title: Source Line Reference
    Maximum Length: 240
    Value that identifies the user-facing line reference of the source system.
  • Title: Source Line Reference ID
    Value that identifies the internal line reference of the source system.
  • Title: Source System Code
    Maximum Length: 30
    Abbreviation that indicates the source application from which data is being imported. Depending on the source system type, this value could represent an internal Oracle Fusion product code or the actual trading community (TCA) source system reference. The value of this attribute can be null.
  • Title: Transaction Date
    Date when the resource transaction is performed.
  • Title: Transaction Quantity
    Quantity of the resource being transacted.
  • Title: Transaction Type Code
    Maximum Length: 30
    Value that identifies the type of the resource transaction. Valid values include one of the following values. RESOURCE_CHARGE: charge the resource against the work order. RESOURCE_REVERSE: reverse the charges of the resource against the work order operation. A list of accepted values is defined in the lookup type ORA_WIE_TRANSACTION_TYPES.
  • Title: Unit of Measure
    Maximum Length: 25
    Unit of measure that the transacted quantity uses. The application can transact the resource only in the unit of measure that the work order definition or the resource specifies.
  • Title: Unit of Measure
    Maximum Length: 3
    Abbreviation that identifies the unit of measure that the transacted quantity uses. The application can transact the resource only in the unit of measure that the work order definition or the resource specifies.
  • Title: Work Order
    Maximum Length: 120
    Value that identifies the work order. The resource transactions are always performed in the context of a work order.
Nested Schema : Flexfields for Resource Transactions
Type: array
Title: Flexfields for Resource Transactions
The Flexfields for Resource Transactions resource manages descriptive flexfields that contain details about the resource transaction.
Show Source
Nested Schema : resourceTransactions-ResourceTransactionDetail-ResourceTransactionDFF-item-post-request
Type: object
Show Source
  • Title: Context Segment
    Maximum Length: 80
    Descriptive flexfield context name for resource transactions.
  • Title: Context Segment
  • This is a transient attribute. The value of this attribute will always be null. Ignore this attribute.
  • Value that uniquely identifies the resource transaction detail that a descriptive flexfield references. This attribute should not be included in the request payload. The value of this attribute in the response payload includes the primary key of the resource transaction detail.
Back to Top

Response

Supported Media Types

Default Response

The following table describes the default response for this task.
Headers
  • 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".
  • 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.
Body ()
Root Schema : resourceTransactions-item-response
Type: object
Show Source
  • Read Only: true
    Contains one of the following values: true or false. If true, then an error occurred while processing the resource transactions. If false, then an error did not occur while processing the resource transactions. This attribute does not have a default value.
  • Links
  • Resource Transaction Details
    Title: Resource Transaction Details
    The Resource Transaction Details resource manages the details of the resource charges to the work order.
  • Title: Source System Code
    Maximum Length: 30
    Abbreviation that indicates the source system from which data is being imported. Depending on the type of source system, this value could represent an internal Oracle Fusion product code or the actual trading community (TCA) source system reference.
  • Title: Source System Type
    Maximum Length: 30
    Default Value: EXTERNAL
    Value that indicates the type of source system (internal or external) from which data is being imported. A list of accepted values is defined in the lookup type ORA_WIE_SOURCE_SYSTEM_TYPE. The default value is EXTERNAL.
Nested Schema : Resource Transaction Details
Type: array
Title: Resource Transaction Details
The Resource Transaction Details resource manages the details of the resource charges to the work order.
Show Source
Nested Schema : resourceTransactions-ResourceTransactionDetail-item-response
Type: object
Show Source
  • Title: Equipment Identifier
    Maximum Length: 80
    Abbreviation that identifies the equipment resource instance.
  • Read Only: true
    Maximum Length: 255
    Name of the error message, if any, when processing the resource transaction. Each text string in the ErrorMessages attribute corresponds to one error message name in the ErrorMessageNames attribute. A comma ( , ) separates each message name.
  • Read Only: true
    Maximum Length: 2000
    Text of the error message, if any, when processing the resource transaction. Each text string in the ErrorMessages attribute corresponds to one error message name in the ErrorMessageNames attribute. A double dollar sign ($$) separates each message.
  • Title: Labor Identifier
    Maximum Length: 30
    Abbreviation that identifies the labor resource instance.
  • Links
  • Title: Operation Sequence
    Number that represents the work order operation sequence for which this resource transaction is being performed.
  • Title: Organization Code
    Maximum Length: 30
    Abbreviation that indicates the manufacturing plant to which this resource transaction is performed.
  • Title: Resource Activity Code
    Maximum Length: 30
    Abbreviation that indicates the activity this production resource is performing at this operation. A list of accepted values is defined in the lookup type ORA_WIS_RESOURCE_ACTIVITY.
  • Title: Resource Code
    Maximum Length: 30
    Abbreviation that indicates the resource against which the quantity is transacted. This value is a user-specified key.
  • Title: Resource Sequence
    Sequence number of the resource associated to this work order operation resource transaction.
  • Flexfields for Resource Transactions
    Title: Flexfields for Resource Transactions
    The Flexfields for Resource Transactions resource manages descriptive flexfields that contain details about the resource transaction.
  • Title: Source Header Reference
    Maximum Length: 240
    Value that identifies the user-facing header reference of the source system.
  • Title: Source Header Reference ID
    Value that identifies the internal header reference of the source system.
  • Title: Source Line Reference
    Maximum Length: 240
    Value that identifies the user-facing line reference of the source system.
  • Title: Source Line Reference ID
    Value that identifies the internal line reference of the source system.
  • Title: Source System Code
    Maximum Length: 30
    Abbreviation that indicates the source application from which data is being imported. Depending on the source system type, this value could represent an internal Oracle Fusion product code or the actual trading community (TCA) source system reference. The value of this attribute can be null.
  • Title: Transaction Date
    Date when the resource transaction is performed.
  • Title: Transaction Quantity
    Quantity of the resource being transacted.
  • Title: Transaction Type Code
    Maximum Length: 30
    Value that identifies the type of the resource transaction. Valid values include one of the following values. RESOURCE_CHARGE: charge the resource against the work order. RESOURCE_REVERSE: reverse the charges of the resource against the work order operation. A list of accepted values is defined in the lookup type ORA_WIE_TRANSACTION_TYPES.
  • Title: Unit of Measure
    Maximum Length: 25
    Unit of measure that the transacted quantity uses. The application can transact the resource only in the unit of measure that the work order definition or the resource specifies.
  • Title: Unit of Measure
    Maximum Length: 3
    Abbreviation that identifies the unit of measure that the transacted quantity uses. The application can transact the resource only in the unit of measure that the work order definition or the resource specifies.
  • Read Only: true
    Value that identifies the transaction. If the transaction is successful, this attribute contains the transaction number. If the transaction is not successful, this attribute contains 0 (zero), the ErrorsExistFlag attribute contains true, and the ErrorMessages and ErrorMessageNames attributes contain the error details. This attribute is included in the response payload.
  • Title: Work Order
    Maximum Length: 120
    Value that identifies the work order. The resource transactions are always performed in the context of a work order.
Nested Schema : Flexfields for Resource Transactions
Type: array
Title: Flexfields for Resource Transactions
The Flexfields for Resource Transactions resource manages descriptive flexfields that contain details about the resource transaction.
Show Source
Nested Schema : resourceTransactions-ResourceTransactionDetail-ResourceTransactionDFF-item-response
Type: object
Show Source
  • Title: Context Segment
    Maximum Length: 80
    Descriptive flexfield context name for resource transactions.
  • Title: Context Segment
  • This is a transient attribute. The value of this attribute will always be null. Ignore this attribute.
  • Value that uniquely identifies the resource transaction detail that a descriptive flexfield references. This attribute should not be included in the request payload. The value of this attribute in the response payload includes the primary key of the resource transaction detail.
  • Links
Back to Top

Examples

This example describes how to perform one resource transaction on a work order operation.

Example cURL Command

Use the following cURL command to submit a request on the REST resource:

curl -u username:password -X POST -H "Content-Type:application/vnd.oracle.adf.resourceitem+json" -d 'request payload' "https://servername//fscmRestApi/resources/version/resourceTransactions"

Example Request Body

The following example includes the contents of the request body in JSON format. You replace the request payload in the cURL command with the contents of the Example Request Body. The request payload specifies attribute values that the command will use in the record that it creates.

{
  "SourceSystemCode":"FUSION_MOBILE",
  "SourceSystemType":"EXTERNAL",
  "ResourceTransactionDetail":[{
    "ResourceCode":"MIXER1",
    "TransactionUnitOfMeasure":"HRS",
    "OperationSequenceNumber":"10",
    "OrganizationCode":"M1",
    "TransactionTypeCode":"RESOURCE_CHARGE",
    "TransactionDate" : "2016-06-07T11:12:30-07:00",
    "TransactionQuantity":"2",
    "WorkOrderNumber":"M11120",
    "ResourceSequenceNumber":"10"
  } ]
}

Example Response Body

The following example includes the contents of the response body in JSON format:

{
  "SourceSystemType" : "EXTERNAL",
  "SourceSystemCode" : "FUSION_MOBILE",
  "ErrorsExistFlag" : "false",
  "ResourceTransactionDetail" : [ {
    "WoResourceTransactionId" : 300100075348790,
    "SourceSystemCode" : null,
    "OrganizationCode" : "M1",
    "WorkOrderNumber" : "M11120",
    "OperationSequenceNumber" : 10,
    "ResourceSequenceNumber" : 10,
    "ResourceCode" : "MIXER1",
    "ResourceActivityCode" : null,
    "TransactionTypeCode" : "RESOURCE_CHARGE",
    "TransactionQuantity" : 2,
    "TransactionUnitOfMeasure" : "HRS",
    "TransactionDate" : "2016-06-07T11:12:30-07:00",
    "SourceLineReference" : null,
    "SourceHeaderReference" : null,
    "SourceLineReferenceId" : null,
    "SourceHeaderReferenceId" : null,
    "ErrorMessages" : "",
    "ErrorMessageNames" : "",
    ...
  } ]
}

Example 2 Request Body

The following example includes the contents of the request body in JSON format. You replace the request payload in the cURL command with the contents of the Example Request Body. The request payload specifies attribute values that the command will use in the record that it creates.

{
	"SourceSystemCode":"FUSION_MOBILE",
	"SourceSystemType":"EXTERNAL",
	"ResourceTransactionDetail":[
	{
		"ResourceCode":"MFG_RES_EQUIP_01",
		"EquipmentIdentifier" : "Lathe_MC_01",
		"TransactionQuantity":"1.5",
		"TransactionUnitOfMeasure":"HRS",
		"TransactionTypeCode":"RESOURCE_CHARGE",
		"TransactionDate" : "2021-02-25T20:02:51.799+00:00",
		"OrganizationCode":"M1",
		"WorkOrderNumber":"M1022",
		"OperationSequenceNumber":"10",
		"ResourceSequenceNumber":"10"
	},
	{
		"ResourceCode":"MFG_RES_LAB_01",
		"LaborIdentifier" : "QC_TECH_02",
		"TransactionQuantity":"4",
		"TransactionUnitOfMeasure":"HRS",
		"TransactionTypeCode":"RESOURCE_CHARGE",
		"TransactionDate" : "2021-02-25T20:02:51.799+00:00",
		"OrganizationCode":"M1",
		"WorkOrderNumber":"M1022",
		"OperationSequenceNumber":"10",
		"ResourceSequenceNumber":"20"
	}
	]
}

Example 2 Response Body

The following example includes the contents of the response body in JSON format:

{
	"SourceSystemType" : "EXTERNAL",
	"SourceSystemCode" : "FUSION_MOBILE",
	"ErrorsExistFlag" : "false",
	"ResourceTransactionDetail" : [ {
		"WoResourceTransactionId" : 300100546055107,
		"SourceSystemCode" : null,
		"OrganizationCode" : "M1",
		"WorkOrderNumber" : "M1022",
		"OperationSequenceNumber" : 10,
		"ResourceSequenceNumber" : 10,
		"ResourceCode":"MFG_RES_EQUIP_01",
		"ResourceActivityCode" : null,
		"TransactionTypeCode" : "RESOURCE_CHARGE",
		"TransactionQuantity":"1.5",
		"TransactionUOMCode" : null,
		"TransactionUnitOfMeasure":"HRS",
		"TransactionDate" : "2021-02-25T20:02:51.799+00:00",
		"SourceLineReference" : null,
		"SourceHeaderReference" : null,
		"SourceLineReferenceId" : null,
		"SourceHeaderReferenceId" : null,
		"EquipmentIdentifier" : "Lathe_MC_01",
		"LaborIdentifier" : null,
		"ErrorMessages" : "",
		"ErrorMessageNames" : "",
		"links" : [ {
			"rel" : "self",
			"href" : "https://servername/fscmRestApi/resources/version/resourceTransactions/300100546055107/child/ResourceTransactionDetail/300100546055108",
			"name" : "ResourceTransactionDetail",
			...
		}
		]
	}
	]
}
Back to Top