Update one lot information
patch
/fscmRestApi/resources/11.13.18.05/receivingReceiptTransactionRequests/{InterfaceTransactionId}/child/lotSerialItemLots/{lotSerialItemLotsUniqID}
Request
Path Parameters
-
InterfaceTransactionId(required): integer(int64)
The value of this parameter could be a hash of the key that is used to uniquely identify the resource item. The client should not generate the hash key value. Instead, the client should query on the collection resource with a filter to navigate to a specific resource item. For example: products?q=InventoryItemId=
-
lotSerialItemLotsUniqID(required): string
This is the hash key of the attributes which make up the composite key--- LotNumber and TransactionInterfaceId ---for the Lots for Lot and Serial Items resource and used to uniquely identify an instance of Lots for Lot and Serial Items. The client should not generate the hash key value. Instead, the client should query on the Lots for Lot and Serial Items collection resource with a filter on the primary key values in order to navigate to a specific instance of Lots for Lot and Serial Items.
For example: lotSerialItemLots?q=LotNumber=<value1>;TransactionInterfaceId=<value2>
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.
Supported Media Types
- application/json
Root Schema : schema
Type:
Show Source
object-
ExpirationActionCode: string
Maximum Length:
32Abbreviation that identifies the expiration action. -
ExpirationActionDate: string
(date)
Date when the warehouse performed the expiration action.
-
GradeCode: string
Maximum Length:
150Abbreviation that identifies the grade. -
HoldDate: string
(date)
Date when the warehouse applied a hold on the lot corresponding to the receipt transaction request. This attribute is applicable when the warehouse places the item under lot and serial control.
-
lotAttributesDFF: array
lotAttributesDFF
-
LotExpirationDate: string
(date)
Date when the item of this lot corresponding to the receipt transaction request expires. This attribute is applicable when the warehouse places the item under lot and serial control.
-
LotNumber: string
Maximum Length:
80Number that identifies the lot for the item corresponding to the receipt transaction request. This attribute is applicable when the warehouse places the item under lot and serial control. -
lotNumbersDFF: array
lotNumbersDFF
-
lotSerialItemSerials: array
Lots and Serials That Control Items
Title:
Lots and Serials That Control ItemsThe Serials for Lot and Serial Items resource manages the serial number information associated with a specific lot for a transaction line whose item is both lot and serial controlled. -
MaturityDate: string
(date)
Date when the lot matures for the receipt transaction request. This attribute is applicable when the warehouse places the item under lot and serial control.
-
OriginationDate: string
(date-time)
Date when this lot originated for the receipt transaction request. This attribute is applicable when the warehouse places the item under lot and serial control.
-
OriginationType: string
Maximum Length:
30Type of origination for the lot corresponding to the receipt transaction request. This attribute is applicable when the warehouse places the item under lot and serial control. -
ParentLotNumber: string
Maximum Length:
80Number that identifies the parent lot of the lot corresponding to the receipt transaction request. This attribute is applicable when the warehouse places the item under lot and serial control. -
PrimaryQuantity: number
Transaction quantity for this lot in the primary unit of measure that the item uses. This attribute is applicable when the warehouse places the item under lot and serial control.
-
ReasonId: integer
(int64)
Value that uniquely identifies the reason for the receiving transaction for the lot. This attribute is applicable when the warehouse places the item under lot and serial control.
-
ReasonName: string
Maximum Length:
30Name of the reason for the receiving transaction for the lot. This attribute is applicable when the warehouse places the item under lot and serial control. -
RetestDate: string
(date)
Date when the lot is retested. This attribute is based on the lot origination date and the retest interval.
-
SecondaryTransactionQuantity: number
Transaction quantity for this lot in the secondary unit of measure that the item uses. This attribute is applicable when the warehouse places the item under lot and serial control.
-
StatusId: integer
(int64)
Value that uniquely identifies the material status.
-
TransactionQuantity: number
Transaction quantity of the lot corresponding to the receipt transaction request. This attribute is applicable when the warehouse places the item under lot and serial control.
-
VendorLotNumber: string
Maximum Length:
150Number that identifies the supplier lot for the lot corresponding to the receipt transaction request. This attribute is applicable when the warehouse places the item under lot and serial control.
Nested Schema : Lots and Serials That Control Items
Type:
arrayTitle:
Lots and Serials That Control ItemsThe Serials for Lot and Serial Items resource manages the serial number information associated with a specific lot for a transaction line whose item is both lot and serial controlled.
Show Source
Nested Schema : receivingReceiptTransactionRequests-lotSerialItemLots-lotAttributesDFF-item-patch-request
Type:
Show Source
object-
__FLEX_Context: string
Title:
Context ValueMaximum Length:30Context Value -
__FLEX_Context_DisplayValue: string
Title:
Context ValueContext Value -
LotNumber: string
Maximum Length:
80 -
TransactionInterfaceId: integer
(int64)
Nested Schema : receivingReceiptTransactionRequests-lotSerialItemLots-lotNumbersDFF-item-patch-request
Type:
Show Source
object-
__FLEX_Context: string
Title:
Context ValueMaximum Length:30Context Value -
__FLEX_Context_DisplayValue: string
Title:
Context ValueContext Value -
LotNumber: string
Maximum Length:
80 -
TransactionInterfaceId: integer
(int64)
Nested Schema : receivingReceiptTransactionRequests-lotSerialItemLots-lotSerialItemSerials-item-patch-request
Type:
Show Source
object-
FromSerialNumber: string
Maximum Length:
80Starting serial number in a range of serial numbers of the receipt transaction request. This attribute is applicable when the warehouse places the item under lot and serial control. -
serialAttributesDFF: array
serialAttributesDFF
-
serialNumbersDFF: array
serialNumbersDFF
-
ToSerialNumber: string
Maximum Length:
80Ending serial number in a range of serial numbers of the receipt transaction request. This attribute is applicable when the warehouse places the item under lot and serial control. -
VendorSerialNumber: string
Maximum Length:
80Supplier serial number for the serial range of the receipt transaction request. This attribute is applicable when the warehouse places the item under lot and serial control.
Nested Schema : receivingReceiptTransactionRequests-lotSerialItemLots-lotSerialItemSerials-serialAttributesDFF-item-patch-request
Type:
Show Source
object-
__FLEX_Context: string
Title:
Context ValueMaximum Length:30Context Value -
__FLEX_Context_DisplayValue: string
Title:
Context ValueContext Value -
FromSerialNumber: string
Maximum Length:
80 -
TransactionInterfaceId: integer
(int64)
Nested Schema : receivingReceiptTransactionRequests-lotSerialItemLots-lotSerialItemSerials-serialNumbersDFF-item-patch-request
Type:
Show Source
object-
__FLEX_Context: string
Title:
Context ValueMaximum Length:30Context Value -
__FLEX_Context_DisplayValue: string
Title:
Context ValueContext Value -
FromSerialNumber: string
Maximum Length:
80 -
TransactionInterfaceId: integer
(int64)
Response
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 : receivingReceiptTransactionRequests-lotSerialItemLots-item-response
Type:
Show Source
object-
ExpirationActionCode: string
Maximum Length:
32Abbreviation that identifies the expiration action. -
ExpirationActionDate: string
(date)
Date when the warehouse performed the expiration action.
-
GradeCode: string
Maximum Length:
150Abbreviation that identifies the grade. -
HoldDate: string
(date)
Date when the warehouse applied a hold on the lot corresponding to the receipt transaction request. This attribute is applicable when the warehouse places the item under lot and serial control.
-
links: array
Links
Title:
LinksThe link relations associated with the resource instance. -
lotAttributesDFF: array
lotAttributesDFF
-
LotExpirationDate: string
(date)
Date when the item of this lot corresponding to the receipt transaction request expires. This attribute is applicable when the warehouse places the item under lot and serial control.
-
LotNumber: string
Maximum Length:
80Number that identifies the lot for the item corresponding to the receipt transaction request. This attribute is applicable when the warehouse places the item under lot and serial control. -
lotNumbersDFF: array
lotNumbersDFF
-
lotSerialItemSerials: array
Lots and Serials That Control Items
Title:
Lots and Serials That Control ItemsThe Serials for Lot and Serial Items resource manages the serial number information associated with a specific lot for a transaction line whose item is both lot and serial controlled. -
MaturityDate: string
(date)
Date when the lot matures for the receipt transaction request. This attribute is applicable when the warehouse places the item under lot and serial control.
-
OriginationDate: string
(date-time)
Date when this lot originated for the receipt transaction request. This attribute is applicable when the warehouse places the item under lot and serial control.
-
OriginationType: string
Maximum Length:
30Type of origination for the lot corresponding to the receipt transaction request. This attribute is applicable when the warehouse places the item under lot and serial control. -
ParentLotNumber: string
Maximum Length:
80Number that identifies the parent lot of the lot corresponding to the receipt transaction request. This attribute is applicable when the warehouse places the item under lot and serial control. -
PrimaryQuantity: number
Transaction quantity for this lot in the primary unit of measure that the item uses. This attribute is applicable when the warehouse places the item under lot and serial control.
-
ProductTransactionId: integer
(int64)
Value that uniquely identifies the receipt line request.
-
ReasonId: integer
(int64)
Value that uniquely identifies the reason for the receiving transaction for the lot. This attribute is applicable when the warehouse places the item under lot and serial control.
-
ReasonName: string
Maximum Length:
30Name of the reason for the receiving transaction for the lot. This attribute is applicable when the warehouse places the item under lot and serial control. -
RetestDate: string
(date)
Date when the lot is retested. This attribute is based on the lot origination date and the retest interval.
-
SecondaryTransactionQuantity: number
Transaction quantity for this lot in the secondary unit of measure that the item uses. This attribute is applicable when the warehouse places the item under lot and serial control.
-
StatusId: integer
(int64)
Value that uniquely identifies the material status.
-
TransactionInterfaceId: integer
(int64)
Value that uniquely identifies the lot for lot serial items for the receipt line request.
-
TransactionQuantity: number
Transaction quantity of the lot corresponding to the receipt transaction request. This attribute is applicable when the warehouse places the item under lot and serial control.
-
VendorLotNumber: string
Maximum Length:
150Number that identifies the supplier lot for the lot corresponding to the receipt transaction request. This attribute is applicable when the warehouse places the item under lot and serial control.
Nested Schema : Links
Type:
arrayTitle:
LinksThe link relations associated with the resource instance.
Show Source
Nested Schema : Lots and Serials That Control Items
Type:
arrayTitle:
Lots and Serials That Control ItemsThe Serials for Lot and Serial Items resource manages the serial number information associated with a specific lot for a transaction line whose item is both lot and serial controlled.
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 : receivingReceiptTransactionRequests-lotSerialItemLots-lotAttributesDFF-item-response
Type:
Show Source
object-
__FLEX_Context: string
Title:
Context ValueMaximum Length:30Context Value -
__FLEX_Context_DisplayValue: string
Title:
Context ValueContext Value -
links: array
Links
Title:
LinksThe link relations associated with the resource instance. -
LotNumber: string
Maximum Length:
80 -
TransactionInterfaceId: integer
(int64)
Nested Schema : Links
Type:
arrayTitle:
LinksThe link relations associated with the resource instance.
Show Source
Nested Schema : receivingReceiptTransactionRequests-lotSerialItemLots-lotNumbersDFF-item-response
Type:
Show Source
object-
__FLEX_Context: string
Title:
Context ValueMaximum Length:30Context Value -
__FLEX_Context_DisplayValue: string
Title:
Context ValueContext Value -
links: array
Links
Title:
LinksThe link relations associated with the resource instance. -
LotNumber: string
Maximum Length:
80 -
TransactionInterfaceId: integer
(int64)
Nested Schema : Links
Type:
arrayTitle:
LinksThe link relations associated with the resource instance.
Show Source
Nested Schema : receivingReceiptTransactionRequests-lotSerialItemLots-lotSerialItemSerials-item-response
Type:
Show Source
object-
FromSerialNumber: string
Maximum Length:
80Starting serial number in a range of serial numbers of the receipt transaction request. This attribute is applicable when the warehouse places the item under lot and serial control. -
links: array
Links
Title:
LinksThe link relations associated with the resource instance. -
ProductTransactionId: integer
(int64)
Value that uniquely identifies the receipt line request.
-
serialAttributesDFF: array
serialAttributesDFF
-
serialNumbersDFF: array
serialNumbersDFF
-
ToSerialNumber: string
Maximum Length:
80Ending serial number in a range of serial numbers of the receipt transaction request. This attribute is applicable when the warehouse places the item under lot and serial control. -
TransactionInterfaceId: integer
(int64)
Value that uniquely identifies the serial for lot serial items for the receipt line request.
-
VendorSerialNumber: string
Maximum Length:
80Supplier serial number for the serial range of the receipt transaction request. This attribute is applicable when the warehouse places the item under lot and serial control.
Nested Schema : Links
Type:
arrayTitle:
LinksThe link relations associated with the resource instance.
Show Source
Nested Schema : receivingReceiptTransactionRequests-lotSerialItemLots-lotSerialItemSerials-serialAttributesDFF-item-response
Type:
Show Source
object-
__FLEX_Context: string
Title:
Context ValueMaximum Length:30Context Value -
__FLEX_Context_DisplayValue: string
Title:
Context ValueContext Value -
FromSerialNumber: string
Maximum Length:
80 -
links: array
Links
Title:
LinksThe link relations associated with the resource instance. -
TransactionInterfaceId: integer
(int64)
Nested Schema : Links
Type:
arrayTitle:
LinksThe link relations associated with the resource instance.
Show Source
Nested Schema : receivingReceiptTransactionRequests-lotSerialItemLots-lotSerialItemSerials-serialNumbersDFF-item-response
Type:
Show Source
object-
__FLEX_Context: string
Title:
Context ValueMaximum Length:30Context Value -
__FLEX_Context_DisplayValue: string
Title:
Context ValueContext Value -
FromSerialNumber: string
Maximum Length:
80 -
links: array
Links
Title:
LinksThe link relations associated with the resource instance. -
TransactionInterfaceId: integer
(int64)
Nested Schema : Links
Type:
arrayTitle:
LinksThe link relations associated with the resource instance.
Show Source
Links
- lotAttributesDFF
-
Parameters:
- InterfaceTransactionId:
$request.path.InterfaceTransactionId - lotSerialItemLotsUniqID:
$request.path.lotSerialItemLotsUniqID
- InterfaceTransactionId:
- lotNumbersDFF
-
Parameters:
- InterfaceTransactionId:
$request.path.InterfaceTransactionId - lotSerialItemLotsUniqID:
$request.path.lotSerialItemLotsUniqID
- InterfaceTransactionId:
- lotSerialItemSerials
-
Parameters:
- InterfaceTransactionId:
$request.path.InterfaceTransactionId - lotSerialItemLotsUniqID:
$request.path.lotSerialItemLotsUniqID
The Serials for Lot and Serial Items resource manages the serial number information associated with a specific lot for a transaction line whose item is both lot and serial controlled. - InterfaceTransactionId:
Examples
This example describes how to update one lot information.
Example cURL Command
Use the following cURL command to submit a request on the REST resource.
curl -X PATCH -u "username:password" -H "Content-Type: application/vnd.oracle.adf.resourceitem+json" -d 'request payload' "https://servername/fscmRestApi/resources/version/receivingReceiptTransactionRequests/InterfaceTransactionId/child/lotSerialItemLots/CompositePrimaryKey"
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 updates.
{
"LotNumber": "KK0927L9",
"TransactionQuantity": 9
}
Example Response Body
The following example includes the contents of the response body in JSON format:
{
"LotNumber": "KK0927L9",
"LotExpirationDate": null,
"ParentLotNumber": null,
"VendorLotNumber": null,
"TransactionQuantity": 9,
"PrimaryQuantity": null,
"SecondaryTransactionQuantity": null,
"OriginationDate": null,
"OriginationType": null,
"HoldDate": null,
"ReasonId": null,
"ReasonName": null,
"MaturityDate": null,
"links": [
{
"rel": "self",
"href": "https://servername/fscmRestApi/resources/version/receivingReceiptTransactionRequests/300100169542894/child/lotSerialItemLots/0002000000084B4B303932374C390000000EACED00057708000110F08400ACEF",
"name": "lotSerialItemLots",
"kind": "item",
"properties": {
"changeIndicator": "ACED0005737200136A6176612E7574696C2E41727261794C6973747881D21D99C7619D03000149000473697A65787000000001770400000001737200116A6176612E6C616E672E496E746567657212E2A0A4F781873802000149000576616C7565787200106A6176612E6C616E672E4E756D62657286AC951D0B94E08B02000078700000000478"
}
},
{
"rel": "canonical",
"href": "https://servername/fscmRestApi/resources/version/receivingReceiptTransactionRequests/300100169542894/child/lotSerialItemLots/0002000000084B4B303932374C390000000EACED00057708000110F08400ACEF",
"name": "lotSerialItemLots",
"kind": "item"
},
{
"rel": "parent",
"href": "https://servername/fscmRestApi/resources/version/receivingReceiptTransactionRequests/300100169542894",
"name": "receivingReceiptTransactionRequests",
"kind": "item"
},
{
"rel": "child",
"href": "https://servername/fscmRestApi/resources/version/receivingReceiptTransactionRequests/300100169542894/child/lotSerialItemLots/0002000000084B4B303932374C390000000EACED00057708000110F08400ACEF/child/lotSerialItemSerials",
"name": "lotSerialItemSerials",
"kind": "collection"
},
{
"rel": "child",
"href": "https://servername/fscmRestApi/resources/version/receivingReceiptTransactionRequests/300100169542894/child/lotSerialItemLots/0002000000084B4B303932374C390000000EACED00057708000110F08400ACEF/child/lotNumbersDFF",
"name": "lotNumbersDFF",
"kind": "collection"
},
{
"rel": "child",
"href": "https://servername/fscmRestApi/resources/version/receivingReceiptTransactionRequests/300100169542894/child/lotSerialItemLots/0002000000084B4B303932374C390000000EACED00057708000110F08400ACEF/child/lotAttributesDFF",
"name": "lotAttributesDFF",
"kind": "collection"
}
]
}