1. REST API for Oracle Fusion Cloud SCM
  2. Tasks
  3. Inventory Management
  4. Physical Inventory Tags

Update one tag

patch

/fscmRestApi/resources/11.13.18.05/physicalInventoryTags/{TagId}

Request

Path Parameters
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
  • Title: Counted By
    Value that uniquely identifies the person who performed the physical count.
  • Maximum Length: 255
    Name of the user who performed the physical inventory count.
  • Flexfields for Tracking Attributes
    Title: Flexfields for Tracking Attributes
    The Flexfields for Tracking Attributes resource manages details of the descriptive flexfields that reference the physical inventory tags.
  • Value that uniquely identifies the inventory item number in physical inventory.
  • Maximum Length: 255
    Name of the item. This item is unique compared to other items according to item attributes.
  • Maximum Length: 255
    Physical area, such as a row, aisle, bin, or shelf, in the subinventory that stores material.
  • Title: Locator
    Value that uniquely identifies the locator.
  • Title: Lot Expiration Date
    Date when the availability of the lot for transaction and planning purposes expires.
  • Title: Lot
    Maximum Length: 80
    Number that identifies the lot. Inventory uses the lot to create items that share the similar production costs and specifications.
  • Value that uniquely identifies the owning party that is financially responsible for consigned inventory.
  • Maximum Length: 255
    Owning party that is financially responsible for consigned inventory.
  • Maximum Length: 255
    Value that identifies the party site where the owning party resides.
  • Maximum Length: 255
    Type of owner of the financial liability of consigned inventory. Contains one of the following values. Supplier site: owning party is supplier site Inventory organization: owning party is inventory organization. The default value is Inventory organization.
  • Maximum Length: 30
    Default Value: 2
    Abbreviation that identifies the type of owner of the financial liability of consigned inventory. Contains one of the following values. 1: owning party is supplier site 2: owning party is inventory organization. The default value is 2.
  • Flexfields for Physical Inventory Tags
    Title: Flexfields for Physical Inventory Tags
    The Flexfields for Physical Inventory Tags resource manages descriptive flexfields that store details about physical inventory tags.
  • Maximum Length: 255
    Business unit that manages and owns the purchasing document.
  • Maximum Length: 18
    Version of the item that inventory is counting.
  • Title: Serial Number
    Maximum Length: 80
    Number that uniquely identifies a single quantity of the item inventory is counting.
  • Maximum Length: 10
    Physical or logical area in the inventory organization where you store material.
  • Title: Count Quantity
    Quantity of the stock keeping unit on the tag for the item.
  • Title: Secondary Quantity
    Quantity in the secondary unit of measure of the item.
  • Maximum Length: 255
    Secondary unit of measure of the item.
  • Title: Secondary UOM
    Maximum Length: 3
    Abbreviation that identifies the secondary unit of measure of the item.
  • Maximum Length: 255
    Unit of measure of the quantity for the stock keeping unit counted on the tag.
  • Title: Count UOM
    Maximum Length: 3
    Abbreviation that identifies the unit of measure of the quantity for the stock keeping unit counted on the tag.
  • Maximum Length: 255
    Value that indicates if the tag is not valid. Contains one of the following values. Void: tag is void. Active: tag is active. The default value is Active.
  • Title: Void
    Maximum Length: 30
    Default Value: 2
    Value that indicates if the tag is not valid. Contains one of the following values. 1: tag is void. 2: tag is active. The default value is 2.
Nested Schema : Flexfields for Tracking Attributes
Type: array
Title: Flexfields for Tracking Attributes
The Flexfields for Tracking Attributes resource manages details of the descriptive flexfields that reference the physical inventory tags.
Show Source
Nested Schema : Flexfields for Physical Inventory Tags
Type: array
Title: Flexfields for Physical Inventory Tags
The Flexfields for Physical Inventory Tags resource manages descriptive flexfields that store details about physical inventory tags.
Show Source
Nested Schema : schema
Type: object
Show Source
  • Title: Context Segment
    Maximum Length: 40
    Descriptive flexfield context name for tracking attributes.
  • Title: Context Segment
    Descriptive flexfield context display value for tracking attributes.
  • Title: Country of Origin
    Maximum Length: 2
    Abbreviation that identifies the country of origin. This attribute is associated with a feature that requires opt in.
  • Title: Country of Origin
    Name of the country of origin. This attribute is associated with a feature that requires opt in.
  • Title: Project
    Value that uniquely identifies the project. This attribute is associated with a feature that requires opt in.
  • Title: Project
    Number that identifies the project. This attribute is associated with a feature that requires opt in.
  • Title: Task
    Value that uniquely identifies the task. This attribute is associated with a feature that requires opt in.
  • Title: Task
    Number that identifies the task. This attribute is associated with a feature that requires opt in.
Nested Schema : schema
Type: object
Show Source
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 : physicalInventoryTags-item-response
Type: object
Show Source
  • Title: Adjustment
    Read Only: true
    Value that uniquely identifies the physical inventory adjustment.
  • Title: Counted By
    Value that uniquely identifies the person who performed the physical count.
  • Maximum Length: 255
    Name of the user who performed the physical inventory count.
  • Flexfields for Tracking Attributes
    Title: Flexfields for Tracking Attributes
    The Flexfields for Tracking Attributes resource manages details of the descriptive flexfields that reference the physical inventory tags.
  • Value that uniquely identifies the inventory item number in physical inventory.
  • Maximum Length: 255
    Name of the item. This item is unique compared to other items according to item attributes.
  • Links
  • Maximum Length: 255
    Physical area, such as a row, aisle, bin, or shelf, in the subinventory that stores material.
  • Title: Locator
    Value that uniquely identifies the locator.
  • Title: Lot Expiration Date
    Date when the availability of the lot for transaction and planning purposes expires.
  • Title: Lot
    Maximum Length: 80
    Number that identifies the lot. Inventory uses the lot to create items that share the similar production costs and specifications.
  • Maximum Length: 255
    Abbreviation that identifies the inventory organization.
  • Value that uniquely identifies the inventory organization.
  • Value that uniquely identifies the owning party that is financially responsible for consigned inventory.
  • Maximum Length: 255
    Owning party that is financially responsible for consigned inventory.
  • Maximum Length: 255
    Value that identifies the party site where the owning party resides.
  • Maximum Length: 255
    Type of owner of the financial liability of consigned inventory. Contains one of the following values. Supplier site: owning party is supplier site Inventory organization: owning party is inventory organization. The default value is Inventory organization.
  • Maximum Length: 30
    Default Value: 2
    Abbreviation that identifies the type of owner of the financial liability of consigned inventory. Contains one of the following values. 1: owning party is supplier site 2: owning party is inventory organization. The default value is 2.
  • Title: Physical Inventory
    Value that uniquely identifies the physical inventory.
  • Maximum Length: 255
    Name of the physical inventory.
  • Flexfields for Physical Inventory Tags
    Title: Flexfields for Physical Inventory Tags
    The Flexfields for Physical Inventory Tags resource manages descriptive flexfields that store details about physical inventory tags.
  • Maximum Length: 255
    Business unit that manages and owns the purchasing document.
  • Maximum Length: 18
    Version of the item that inventory is counting.
  • Title: Serial Number
    Maximum Length: 80
    Number that uniquely identifies a single quantity of the item inventory is counting.
  • Maximum Length: 10
    Physical or logical area in the inventory organization where you store material.
  • Value that uniquely identifies the physical inventory tag.
  • Title: Tag
    Maximum Length: 40
    Number that inventory assigns to the physical inventory tag. It represents the contents of a unique item location in inventory.
  • Title: Count Quantity
    Quantity of the stock keeping unit on the tag for the item.
  • Title: Secondary Quantity
    Quantity in the secondary unit of measure of the item.
  • Maximum Length: 255
    Secondary unit of measure of the item.
  • Title: Secondary UOM
    Maximum Length: 3
    Abbreviation that identifies the secondary unit of measure of the item.
  • Maximum Length: 255
    Type of physical inventory tags generated after the generate tags action. A list of accepted values is defined in the lookup type INV_TAG_TYPE. There is no default value for this attribute.
  • Title: Tag Type
    Maximum Length: 30
    Abbreviation that identifies the type of physical inventory tag that the create tag action creates.
  • Maximum Length: 255
    Unit of measure of the quantity for the stock keeping unit counted on the tag.
  • Title: Count UOM
    Maximum Length: 3
    Abbreviation that identifies the unit of measure of the quantity for the stock keeping unit counted on the tag.
  • Maximum Length: 255
    Value that indicates if the tag is not valid. Contains one of the following values. Void: tag is void. Active: tag is active. The default value is Active.
  • Title: Void
    Maximum Length: 30
    Default Value: 2
    Value that indicates if the tag is not valid. Contains one of the following values. 1: tag is void. 2: tag is active. The default value is 2.
Nested Schema : Flexfields for Tracking Attributes
Type: array
Title: Flexfields for Tracking Attributes
The Flexfields for Tracking Attributes resource manages details of the descriptive flexfields that reference the physical inventory tags.
Show Source
Nested Schema : Flexfields for Physical Inventory Tags
Type: array
Title: Flexfields for Physical Inventory Tags
The Flexfields for Physical Inventory Tags resource manages descriptive flexfields that store details about physical inventory tags.
Show Source
Nested Schema : physicalInventoryTags-inventoryAttributesDFF-item-response
Type: object
Show Source
Nested Schema : physicalInventoryTags-physicalInventoryTagDFFs-item-response
Type: object
Show Source
Links
inventoryAttributesDFF
Parameters:
  • TagId: $request.path.TagId
The Flexfields for Tracking Attributes resource manages details of the descriptive flexfields that reference the physical inventory tags.
physicalInventoryTagDFFs
Parameters:
  • TagId: $request.path.TagId
The Flexfields for Physical Inventory Tags resource manages descriptive flexfields that store details about physical inventory tags.
Back to Top

Examples

This example describes how to update one tag.

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/physicalInventoryTags/TagId"

Example 1 cURL Command

Use the following cURL command to submit a request on the REST resource to record a blank tag.

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

Example 1 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 with plain item, owning party, and inventory organization. 

{      
    "ItemNumber": "INV-100",
    "TagQuantity": 192,
	"TagUnitOfMeasure": "Card",
    "Subinventory": "KKCONSUB",
    "CountedByEmployeeName": "Oliver, Sam"
}

Example 1 Response Body

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

{
    "TagId": 101667024,
    "PhysicalInventoryId": 300100132023331,
    "PhysicalInventoryName": "NDSPI-1",
    "OrganizationId": 207,
    "OrganizationCode": "M1",
    "TagVoidCode": "2",
    "TagVoid": "Active",
    "TagTypeCode": "2",
    "TagType": "Blank",
    "TagNumber": "BNKT2",
    "AdjustmentId": 300100132034774,
    "InventoryItemId": 663913,
    "ItemNumber": "INV-100",
    "TagQuantity": 192,
    "TagUOMCode": "CRD",
    "TagUnitOfMeasure": "Card",
    "TagSecondaryQuantity": null,
    "TagSecondaryUOMCode": null,
    "TagSecondaryUnitOfMeasure": null,
    "Subinventory": "KKCONSUB",
    "LocatorId": null,
    "Locator": null,
    "LotNumber": null,
    "LotExpirationDate": null,
    "Revision": null,
    "SerialNumber": null,
    "CountedByEmployeeId": 300100036644754,
    "CountedByEmployeeName": "Oliver, Sam",
    "OwningTypeCode": "2",
    "OwningType": null,
    "OwningEntityId": 207,
    "OwningPartySite": null,
    "OwningParty": null,
    "ProcurementBU": null,
    "links": [
        {
            "rel": "self",
            "href": "https://servername/fscmRestApi/resources/version/physicalInventoryTags/101667024",
            "name": "physicalInventoryTags",
            "kind": "item",
            "properties": {
                "changeIndicator": "ACED0005737200136A6176612E7574696C2E41727261794C6973747881D21D99C7619D03000149000473697A65787000000001770400000001737200116A6176612E6C616E672E496E746567657212E2A0A4F781873802000149000576616C7565787200106A6176612E6C616E672E4E756D62657286AC951D0B94E08B02000078700000000278"
            }
        },
        {
            "rel": "canonical",
            "href": "https://servername/fscmRestApi/resources/version/physicalInventoryTags/101667024",
            "name": "physicalInventoryTags",
            "kind": "item"
        },
        {
            "rel": "child",
            "href": "https://servername/fscmRestApi/resources/version/physicalInventoryTags/101667024/child/physicalInventoryTagDFFs",
            "name": "physicalInventoryTagDFFs",
            "kind": "collection"
        }
    ]
}

Example 2 cURL Command

Use the following cURL command to submit a request on the REST resource to record a blank tag.

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

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 updates with plain item, owning party, and supplier site. 

{ 
            "ItemNumber": "ABC01-100",
            "Subinventory": "SLC_DEST",
            "Locator":"SD1.1.1",
            "TagQuantity": 12,
            "TagUnitOfMeasure": "Each",
         "OwningPartySite": "FRESNO",
            "OwningParty": "Advanced Network Devices",
            "ProcurementBU": "Vision Corporation", 
            "CountedByEmployeeName": "Smith, Jonathan"          
}

Example 2 Response Body

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

{
    "TagId": 100000032,
    "PhysicalInventoryId": 300100132023331,
    "PhysicalInventoryName": "NDSPI-1",
    "OrganizationId": 207,
    "OrganizationCode": "M1",
    "TagVoidCode": "2",
    "TagVoid": "Active",
    "TagTypeCode": "2",
    "TagType": "Blank",
    "TagNumber": "BNKT1",
    "AdjustmentId": 300100132030428,
    "InventoryItemId": 663767,
    "ItemNumber": "ABC01-100",
    "TagQuantity": 12,
    "TagUOMCode": "Ea",
    "TagUnitOfMeasure": "Each",
    "TagSecondaryQuantity": null,
    "TagSecondaryUOMCode": null,
    "TagSecondaryUnitOfMeasure": null,
    "Subinventory": "SLC_DEST",
    "LocatorId": 300100002756507,
    "Locator": "SD1.1.1",
    "LotNumber": null,
    "LotExpirationDate": null,
    "Revision": null,
    "SerialNumber": null,
    "CountedByEmployeeId": 57,
    "CountedByEmployeeName": "Smith, Jonathan",
    "OwningTypeCode": "1",
    "OwningType": null,
    "OwningEntityId": 1969,
    "OwningPartySite": "FRESNO",
    "OwningParty": "Advanced Network Devices",
    "ProcurementBU": "Vision Corporation",
    "links": [
        {
            "rel": "self",
            "href": "https://servername/fscmRestApi/resources/version/physicalInventoryTags/100000032",
            "name": "physicalInventoryTags",
            "kind": "item",
            "properties": {
                "changeIndicator": "ACED0005737200136A6176612E7574696C2E41727261794C6973747881D21D99C7619D03000149000473697A65787000000001770400000001737200116A6176612E6C616E672E496E746567657212E2A0A4F781873802000149000576616C7565787200106A6176612E6C616E672E4E756D62657286AC951D0B94E08B02000078700000000278"
            }
        },
        {
            "rel": "canonical",
            "href": "https://servername/fscmRestApi/resources/version/physicalInventoryTags/100000032",
            "name": "physicalInventoryTags",
            "kind": "item"
        },
        {
            "rel": "child",
            "href": "https://servername/fscmRestApi/resources/version/physicalInventoryTags/100000032/child/physicalInventoryTagDFFs",
            "name": "physicalInventoryTagDFFs",
            "kind": "collection"
        }
    ]
}

Example 3 cURL Command

Use the following cURL command to submit a request on the REST resource to record a blank tag.

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

Example 3 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 with serial item. 

{  
    "ItemNumber": "CYC03-102",
    "Subinventory": "SLC_DEST",
    "Locator":"SD1.1.1",
    "TagQuantity": 1,
    "TagUnitOfMeasure": "Each",
    "SerialNumber": 100,
    "CountedByEmployeeName": "Tipped, John"          
}

Example 3 Response Body

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

{
  "TagId" : 100000033,
  "PhysicalInventoryId" : 300100111106918,
  "PhysicalInventoryName" : "PIOWN_TEST",
  "OrganizationId" : 207,
  "OrganizationCode" : "M1",
  "TagVoidCode" : "2",
  "TagVoid" : "Active",
  "TagTypeCode" : "2",
  "TagType" : "Blank",
  "TagNumber" : "BNKT6",
  "AdjustmentId" : 300100111119917,
  "InventoryItemId" : 663852,
  "ItemNumber" : "CYC03-102",
  "TagQuantity" : 1,
  "TagUOMCode" : "Ea",
  "TagUnitOfMeasure" : "Each",
  "TagSecondaryQuantity" : null,
  "TagSecondaryUOMCode" : null,
  "TagSecondaryUnitOfMeasure" : null,
  "Subinventory" : "SLC_DEST",
  "LocatorId" : 300100002756507,
  "Locator" : "SD1.1.1",
  "LotNumber" : null,
  "LotExpirationDate" : null,
  "Revision" : null,
  "SerialNumber" : "100",
  "CountedByEmployeeId" : 383,
  "CountedByEmployeeName" : "Tipped, John",
  "OwningTypeCode" : "2",
  "OwningType" : null,
  "OwningEntityId" : 207,
  "OwningPartySite" : null,
  "OwningParty" : null,
  "ProcurementBU" : null,
  "links" : [ {
    "rel" : "self",
    "href" : "https://servername/fscmRestApi/resources/version/physicalInventoryTags/100000033",
    "name" : "physicalInventoryTags",
    "kind" : "item",
    "properties" : {
      "changeIndicator" : "ACED0005737200136A6176612E7574696C2E41727261794C6973747881D21D99C7619D03000149000473697A65787000000001770400000001737200116A6176612E6C616E672E496E746567657212E2A0A4F781873802000149000576616C7565787200106A6176612E6C616E672E4E756D62657286AC951D0B94E08B02000078700000000278"
    }
  }, {
    "rel" : "canonical",
    "href" : "https://servername/fscmRestApi/resources/version/physicalInventoryTags/100000033",
    "name" : "physicalInventoryTags",
    "kind" : "item"
  }, {
    "rel" : "child",
    "href" : "https://servername/fscmRestApi/resources/version/physicalInventoryTags/100000033/child/physicalInventoryTagDFFs",
    "name" : "physicalInventoryTagDFFs",
    "kind" : "collection"
  } ]
}

Example 4 cURL Command

Use the following cURL command to submit a request on the REST resource to update a physical inventory tag.

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

Example 4 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. 

{
	"TagUnitOfMeasure" : "Card",
	"TagQuantity" : 293,
   "CountedByEmployeeName : "Oliver, Sam"
	"TagVoidCode": "1"
}

Example 4 Response Body

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

{
  "TagId" : 300100111427920,
  "PhysicalInventoryId" : 300100125039475,
  "PhysicalInventoryName" : "--CYCSUB01",
  "OrganizationId" : 207,
  "OrganizationCode" : "M1",
  "TagVoidCode" : "1",
  "TagVoid" : "Void",
  "TagTypeCode" : "3",
  "TagType" : "Dynamic",
  "TagNumber" : "DYNT25",
  "AdjustmentId" : 300100111427921,
  "InventoryItemId" : 300100002904814,
  "ItemNumber" : "MMS101",
  "TagQuantity" : 293,
  "TagUOMCode" : "CRD",
  "TagUnitOfMeasure" : "Card",
  "TagSecondaryQuantity" : null,
  "TagSecondaryUOMCode" : null,
  "TagSecondaryUnitOfMeasure" : null,
  "Subinventory" : "CYCSUB01",
  "LocatorId" : 3138,
  "Locator" : "CYC1.1.3",
  "LotNumber" : "2000",
  "LotExpirationDate" : null,
  "Revision" : null,
  "SerialNumber" : null,
  "CountedByEmployeeId" : 300100036644754,
  "CountedByEmployeeName" : "Oliver, Sam",
  "OwningTypeCode" : "2",
  "OwningType" : "Inventory organization",
  "OwningEntityId" : 207,
  "OwningPartySite" : null,
  "OwningParty" : null,
  "ProcurementBU" : null,
  "links" : [ {
    "rel" : "self",
    "href" : "https://servername/fscmRestApi/resources/version/physicalInventoryTags/300100111427920",
    "name" : "physicalInventoryTags",
    "kind" : "item",
    "properties" : {
      "changeIndicator" : "ACED0005737200136A6176612E7574696C2E41727261794C6973747881D21D99C7619D03000149000473697A65787000000001770400000001737200116A6176612E6C616E672E496E746567657212E2A0A4F781873802000149000576616C7565787200106A6176612E6C616E672E4E756D62657286AC951D0B94E08B02000078700000000278"
    }
  }, {
    "rel" : "canonical",
    "href" : "https://servername/fscmRestApi/resources/version/physicalInventoryTags/300100111427920",
    "name" : "physicalInventoryTags",
    "kind" : "item"
  }, {
    "rel" : "child",
    "href" : "https://servername/fscmRestApi/resources/version/physicalInventoryTags/300100111427920/child/physicalInventoryTagDFFs",
    "name" : "physicalInventoryTagDFFs",
    "kind" : "collection"
  } ]
}
Back to Top