> ## Documentation Index > Fetch the complete documentation index at: https://developers.cmicglobal.com/llms.txt > Use this file to discover all available pages before exploring further. # Update Vendor Item Record > ## Overview This endpoint updates selected fields of a vendor item identified by its UUID. Only the fields provided in the request payload are updated; all other attributes remain unchanged. ## Notes - Authentication and authorization are required. - Partial updates are supported. - Only specific fields are allowed to be updated. - Providing unsupported or read-only attributes will result in a **400 Bad Request** error. ## UI Navigation **Asset Management → Purchase Orders → Setup -> Local Tables -> Items by Vendor** ## Finders Not applicable. This is a **PATCH (update)** endpoint and does not support finders. ## Path Parameters | Parameter | Description | Type | Required | | --- | --- | --- | --- | | vuuid | Unique Identifier (UUID) | String | True | ## Query Standards Not applicable. This endpoint does not support `finder`, `limit`, `offset`, or `orderBy`. --- ## Finders with Example Not applicable. Finders are not supported for PATCH operations. --- ## Attributes The following attributes may be returned in the response Only attributes marked as **Updatable = True** can be updated via this endpoint | CMiC UI Fieldname | Object | Name | Description | Type | Data Length | Example | Updatable | | --- | --- | --- | --- | --- | --- | --- | --- | | VenitmCompCode | vendorItem | VenitmCompCode | Company | String | 8 | ALT | False | | VenitmInvItemFlag | vendorItem | VenitmInvItemFlag | Item Flag Y-Inventory Item, N-Non Stock Item | String | 1 | Y | True | | VenitmVenCode | vendorItem | VenitmVenCode | Vendor | String | 8 | 1-URBAN | True | | VenitmItemClassCode | vendorItem | VenitmItemClassCode | Class from DA.CICLASS | String | 4 | PNT | True | | VenitmItmCode | vendorItem | VenitmItmCode | Item Code | String | 16 | 2X4 WOOD PLANK | True | | VenitmItmName | vendorItem | VenitmItmName | Item Name | String | 60 | 2x4 Wood Planks - Rough Finish | False | | VenitmItmtypCode | vendorItem | VenitmItmtypCode | Item Type: Can be a specific inventory item type, '\*' for all inventory item types, or 'NA' for non-stock items | String | 2 | ST | True | | VenitmCode | vendorItem | VenitmCode | Vendor Defined Code | String | 16 | BRICKS | True | | VenitmLastBuyDate | vendorItem | VenitmLastBuyDate | Last Order Date Updated with PO_DATE when posting PO | String | N/A | 2020-04-24 00:00:00 | True | | VenitmLastBuyQty | vendorItem | VenitmLastBuyQty | Last Quantity Updated when posting PO | Number | 16/8 | 5.0 | True | | VenitmWmCode | vendorItem | VenitmWmCode | WM | String | 2 | GL | True | | VenitmLstPriceAmt | vendorItem | VenitmLstPriceAmt | Lst Price Updated when posting PO | Number | 18/4 | 10.0 | True | | VenitmMinOrdQty | vendorItem | VenitmMinOrdQty | Minimum Quantity | Number | 16/8 | 1000.0 | True | | VenitmDesc | vendorItem | VenitmDesc | Miscellaneous Notes | String | 2000 | Vendor Item List | True | | VenitmStatCode | vendorItem | VenitmStatCode | Stat Code | String | 1 | I | True | | VenitmAvgPriceAmt | vendorItem | VenitmAvgPriceAmt | Avg Price Amt | Number | 18/4 | 10.0000 | True | | VenitmAvgDeliveryDays | vendorItem | VenitmAvgDeliveryDays | Avg Delivery Days | Number | 8/0 | 9 | True | | VenitmDeptCode | vendorItem | VenitmDeptCode | Department | String | 6 | 00 | True | | VenitmItemDesc | vendorItem | VenitmItemDesc | Vendor Item Description | String | 4000 | Testing new item | True | | VenitmIuCreateDate | vendorItem | VenitmIuCreateDate | Record Creation Date | Date | N/A | System Generated | False | | VenitmIuCreateUser | vendorItem | VenitmIuCreateUser | Record Creator User | String | 30 | System User | False | | VenitmIuUpdateDate | vendorItem | VenitmIuUpdateDate | Record Last Update Date | Date | N/A | System Generated | False | | VenitmIuUpdateUser | vendorItem | VenitmIuUpdateUser | Record Last Updated By | String | 30 | System User | False | | VenitmVUuid | vendorItem | VenitmVUuid | Unique UUID for Vendor Item record | String | 64 | Generated | False | ## OpenAPI ````json PATCH /po-rest-api/rest/1/vendorItem/{vuuid} { "openapi": "3.0.0", "info": { "title": "API Catalog", "description": "", "version": "1.0.0" }, "servers": [ { "url": "https://mobtest.cmiccloudr12.com/cmictestrti", "description": "CMIC API Server" } ], "security": [ { "cmicBasicAuth": [] } ], "tags": [ { "name": "Highlights" }, { "name": "Asset Management | Equipment" }, { "name": "Asset Management | Fixed Assets" }, { "name": "Asset Management | Purchase Order" }, { "name": "Asset Management | Inventory" }, { "name": "Asset Management | Requisition" }, { "name": "Asset Management | Purchase Change Order" }, { "name": "Bim Model" }, { "name": "Bim Model Revision" }, { "name": "Bim Tag Model" }, { "name": "Bim Tags" }, { "name": "Bim FileUpload Jersey" }, { "name": "Core System | Business Partners" }, { "name": "Core System | Business Partner Addresses" }, { "name": "Core System | Bank" }, { "name": "Core System | Currency" }, { "name": "Core System | Exchange Rates" }, { "name": "Core System | Global Table Text Codes" }, { "name": "Core System | Global Table Regions" }, { "name": "Core System | Terms" }, { "name": "Core System | System Contact" }, { "name": "Core System | Weight Measures" }, { "name": "Core System | Field User Defined Classifiers" }, { "name": "Core System | User Defined Classifiers by Object" }, { "name": "Core System | User Extension Definitions by Object" }, { "name": "Core System | User Extention Field Data Value" }, { "name": "Core System | User Extension Values by Object" }, { "name": "Core System | User System Role" }, { "name": "Core System | User Project Role" }, { "name": "Core System | Documents by Object" }, { "name": "Core System | Audit Status Log by Object" }, { "name": "Core System | Licensed Users" }, { "name": "Core System | Company Access" }, { "name": "Core System | Copy User Settings" }, { "name": "Core System | User Maintenance" }, { "name": "Core System | User Roles" }, { "name": "Core System | Security Groups" }, { "name": "Core System | Job/Project Security" }, { "name": "Core System | Weight Measure with Conversions Code" }, { "name": "Core System | Weight Measure Conversions Code" }, { "name": "Core System | User-defined-fields" }, { "name": "Core System | User-extension" }, { "name": "ECM and Workflow | Image Manager" }, { "name": "Financials | General Ledger" }, { "name": "Financials | Accounts Payable" }, { "name": "Financials | Accounts Receivable" }, { "name": "Preventative Maintenance | Issue Work Orders" }, { "name": "Preventative Maintenance | Issue Work Items" }, { "name": "Preventative Maintenance | Issue Work Budgets" }, { "name": "Preventative Maintenance | Issue Priorities" }, { "name": "Preventative Maintenance | Issue Status" }, { "name": "Preventative Maintenance | Issue Types" }, { "name": "Preventative Maintenance | Accumulative Equipment" }, { "name": "Preventative Maintenance | Work Orders" }, { "name": "Preventative Maintenance | Work Items" }, { "name": "Preventative Maintenance | Work Budgets" }, { "name": "Preventative Maintenance | Priorities" }, { "name": "Preventative Maintenance | Tasks" }, { "name": "HCM | UKG Pay Deductions" }, { "name": "HCM | UKG Pay Earnings" }, { "name": "HCM | UKG Pay Headers" }, { "name": "HCM | UKG Pay Taxes" }, { "name": "HCM | Payroll Geographical States" }, { "name": "HCM | Payroll Trades" }, { "name": "HCM | Payroll Union" }, { "name": "HCM | Payroll Pay Runs" }, { "name": "HCM | Payroll Pay Groups" }, { "name": "HCM | Payroll Tax" }, { "name": "HCM | Payroll Worker Compensation" }, { "name": "HCM | Payroll Work Locations" }, { "name": "HCM | Payroll Trade Pay Rates" }, { "name": "HCM | Payroll Union Pay Rates" }, { "name": "HCM | Payroll Job Pay Rates" }, { "name": "HCM | Payroll Master Benefits" }, { "name": "HCM | Payroll Master Deductions" }, { "name": "HCM | Payroll Ben/Ded/Leave Base Codes" }, { "name": "HCM | Payroll Ben/Ded Plans" }, { "name": "HCM | Payroll Ben/Ded Plan Options" }, { "name": "HCM | Payroll Company Benefits" }, { "name": "HCM | Payroll Company Deductions" }, { "name": "HCM | Payroll Vertex Geographic Locations" }, { "name": "HCM | Payroll Checks" }, { "name": "HCM | Payroll Timesheets" }, { "name": "HCM | Employee" }, { "name": "HCM | Employee (Minimum payload)" }, { "name": "HCM | Employee History" }, { "name": "HCM | Tax Exemptions" }, { "name": "HCM | Employee Tax Overrides" }, { "name": "HCM | Employee Pay Splits" }, { "name": "HCM | Employee Benefits" }, { "name": "HCM | Employee Clock In and Out" }, { "name": "HCM | Employee Deductions" }, { "name": "HCM | Employee Leaves" }, { "name": "HCM | Employee Leave History" }, { "name": "HCM | Employee Hour Types" }, { "name": "HCM | Employee Pay History" }, { "name": "HCM | Employee Work Statuses" }, { "name": "HCM | Employee Security Group" }, { "name": "HCM | Crewtime Crew" }, { "name": "HCM | Crewtime Employee Timesheet" }, { "name": "HCM | Crewtime Equipment Timesheet" }, { "name": "HCM | Crew Maintenance Activity Assignment" }, { "name": "HCM | Crew Maintenance Member Assignment" }, { "name": "HCM | Crew Maintenance Member Trade and Union Assignment" }, { "name": "HCM | Crew Maintenance Equipment Assignment" }, { "name": "HCM | Crew Maintenance Equipment Detail Assignment" }, { "name": "HCM | HR Requisitions" }, { "name": "HCM | HR Relations" }, { "name": "HCM | HR Employee Skills" }, { "name": "HCM | HR Incident" }, { "name": "HCM | HR Employee Relatives / Dependents" }, { "name": "HCM | HR Employee Positions" }, { "name": "HCM | HR Applicants" }, { "name": "HCM | HR Applications" }, { "name": "HCM | Vertex Location City" }, { "name": "HCM | HR Application History" }, { "name": "HCM | HR Dependent Benefits" }, { "name": "HCM | HR Dependent Deductions" }, { "name": "HCM | HR Employee Elected Plans" }, { "name": "HCM | HR Employee Training Certifications" }, { "name": "HCM | HR Trainings" }, { "name": "HCM | E-Timesheets" }, { "name": "HCM | System Contacts" }, { "name": "HCM | System User Payroll Security Group" }, { "name": "HCM | Payroll Timesheet Posting" }, { "name": "HCM | CrewTimesheet Posting" }, { "name": "HCM | HR Positions Master" }, { "name": "HCM | Payroll Pay Periods" }, { "name": "HCM | Payroll Rate Codes" }, { "name": "HCM | Payroll Overhead Codes and Rates" }, { "name": "HCM | Payroll Assigned Overhead to Jobs" }, { "name": "Materials Management | Material Sale Orders" }, { "name": "Materials Management | Material Sale Orders Details" }, { "name": "Materials Management | Truck Rate Detail" }, { "name": "Opportunity Management | Competitors" }, { "name": "Opportunity Management | Opportunities" }, { "name": "Opportunity Management | Revenue Details" }, { "name": "Opportunity Management | Opportunity History" }, { "name": "Opportunity Management | Organization" }, { "name": "Project Controls | Job Billing" }, { "name": "Project Controls | Job Cost" }, { "name": "Project Controls | PCI Details" }, { "name": "Project Controls | Unposted PCI Details" }, { "name": "Project Controls | PCI Headers" }, { "name": "Project Controls | Owner Change Orders" }, { "name": "Project Controls | CM Statuses" }, { "name": "Project Controls | CM Types" }, { "name": "Project Controls | CM Vendor Details" }, { "name": "Project Controls | Post PCI" }, { "name": "Project Management | Uploading Documents" }, { "name": "Project Management | Downloading Documents" }, { "name": "Project Management | Foreign Bid Item Imports" }, { "name": "Project Management | Communications" }, { "name": "Project Management | Daily Journals" }, { "name": "Project Management | Communications Types" }, { "name": "Project Management | Daily Journal Daily Work Plans" }, { "name": "Project Management | Daily Journal Field Forces" }, { "name": "Project Management | Daily Journal Labour" }, { "name": "Project Management | Daily Journal Materials" }, { "name": "Project Management | Daily Journal Owner Equipment" }, { "name": "Project Management | Daily Journal Quality Control" }, { "name": "Project Management | Daily Journal Tasks" }, { "name": "Project Management | Daily Journal Trade Equipment" }, { "name": "Project Management | Daily Journal Transactions" }, { "name": "Project Management | Daily Journal User Defined Data" }, { "name": "Project Management | Daily Journal Visitors" }, { "name": "Project Management | Daily Journal Bill Details" }, { "name": "Project Management | Field Work Directives" }, { "name": "Project Management | Contract Types" }, { "name": "Project Management | Company Contacts" }, { "name": "Project Management | Distribution BCC" }, { "name": "Project Management | Distribution CC" }, { "name": "Project Management | Field Work Directive Statuses" }, { "name": "Project Management | Issues" }, { "name": "Project Management | Key Players" }, { "name": "Project Management | Meetings" }, { "name": "Project Management | Meeting Attendees" }, { "name": "Project Management | Meeting Item Statuses" }, { "name": "Project Management | Meeting Tracks" }, { "name": "Project Management | Notes" }, { "name": "Project Management | Projects" }, { "name": "Project Management | Project Items" }, { "name": "Project Management | Project Item Phase Segment Sums" }, { "name": "Project Management | Project Partners" }, { "name": "Project Management | Notices" }, { "name": "Project Management | Notice Statuses" }, { "name": "Project Management | Owner JS Query" }, { "name": "Project Management | PCI Real Locations" }, { "name": "Project Management | Project Contacts" }, { "name": "Project Management | RFIs (Requests for Information)" }, { "name": "Project Management | RFI Statuses" }, { "name": "Project Management | Submittal Packages" }, { "name": "Project Management | Submittal Package Details" }, { "name": "Project Management | Submittal Package Status" }, { "name": "Project Management | Submittals" }, { "name": "Project Management | Submittal Status" }, { "name": "Project Management | Transmittals" }, { "name": "Project Management | Subcontract Headers" }, { "name": "Project Management | Subcontract Schedules" }, { "name": "Project Management | Subcontract Sechedule Phase Segment Sums" }, { "name": "Project Management | User Roles" }, { "name": "Project Management | Punchlists" }, { "name": "Project Management | Punchlist Details" }, { "name": "Project Management | Punchlist Statuses" }, { "name": "Project Management | Meeting Items" }, { "name": "Project Management | Self Perform Vendor" }, { "name": "Project Management | Submittal Types" }, { "name": "Project Management | Assign contact and partner to project" }, { "name": "Project Management | Subcontract Prequal" }, { "name": "Project Management | Bid Item Package" } ], "paths": { "/po-rest-api/rest/1/vendorItem/{vuuid}": { "patch": { "tags": [ "Asset Management | Purchase Order" ], "summary": "Update Vendor Item Record", "description": "## Overview\n\nThis endpoint updates selected fields of a vendor item identified by its UUID.\n\nOnly the fields provided in the request payload are updated; all other attributes remain unchanged.\n\n## Notes\n\n- Authentication and authorization are required.\n \n- Partial updates are supported.\n \n- Only specific fields are allowed to be updated.\n \n- Providing unsupported or read-only attributes will result in a **400 Bad Request** error.\n \n\n## UI Navigation\n\n**Asset Management → Purchase Orders → Setup -> Local Tables -> Items by Vendor**\n\n## Finders\n\nNot applicable.\n\nThis is a **PATCH (update)** endpoint and does not support finders.\n\n## Path Parameters\n\n| Parameter | Description | Type | Required |\n| --- | --- | --- | --- |\n| vuuid | Unique Identifier (UUID) | String | True |\n\n## Query Standards\n\nNot applicable.\n\nThis endpoint does not support `finder`, `limit`, `offset`, or `orderBy`.\n\n---\n\n## Finders with Example\n\nNot applicable.\n\nFinders are not supported for PATCH operations.\n\n---\n\n## Attributes\n\nThe following attributes may be returned in the response\n\nOnly attributes marked as **Updatable = True** can be updated via this endpoint\n\n| CMiC UI Fieldname | Object | Name | Description | Type | Data Length | Example | Updatable |\n| --- | --- | --- | --- | --- | --- | --- | --- |\n| VenitmCompCode | vendorItem | VenitmCompCode | Company | String | 8 | ALT | False |\n| VenitmInvItemFlag | vendorItem | VenitmInvItemFlag | Item Flag Y-Inventory Item, N-Non Stock Item | String | 1 | Y | True |\n| VenitmVenCode | vendorItem | VenitmVenCode | Vendor | String | 8 | 1-URBAN | True |\n| VenitmItemClassCode | vendorItem | VenitmItemClassCode | Class from DA.CICLASS | String | 4 | PNT | True |\n| VenitmItmCode | vendorItem | VenitmItmCode | Item Code | String | 16 | 2X4 WOOD PLANK | True |\n| VenitmItmName | vendorItem | VenitmItmName | Item Name | String | 60 | 2x4 Wood Planks - Rough Finish | False |\n| VenitmItmtypCode | vendorItem | VenitmItmtypCode | Item Type: Can be a specific inventory item type, '\\*' for all inventory item types, or 'NA' for non-stock items | String | 2 | ST | True |\n| VenitmCode | vendorItem | VenitmCode | Vendor Defined Code | String | 16 | BRICKS | True |\n| VenitmLastBuyDate | vendorItem | VenitmLastBuyDate | Last Order Date Updated with PO_DATE when posting PO | String | N/A | 2020-04-24 00:00:00 | True |\n| VenitmLastBuyQty | vendorItem | VenitmLastBuyQty | Last Quantity Updated when posting PO | Number | 16/8 | 5.0 | True |\n| VenitmWmCode | vendorItem | VenitmWmCode | WM | String | 2 | GL | True |\n| VenitmLstPriceAmt | vendorItem | VenitmLstPriceAmt | Lst Price Updated when posting PO | Number | 18/4 | 10.0 | True |\n| VenitmMinOrdQty | vendorItem | VenitmMinOrdQty | Minimum Quantity | Number | 16/8 | 1000.0 | True |\n| VenitmDesc | vendorItem | VenitmDesc | Miscellaneous Notes | String | 2000 | Vendor Item List | True |\n| VenitmStatCode | vendorItem | VenitmStatCode | Stat Code | String | 1 | I | True |\n| VenitmAvgPriceAmt | vendorItem | VenitmAvgPriceAmt | Avg Price Amt | Number | 18/4 | 10.0000 | True |\n| VenitmAvgDeliveryDays | vendorItem | VenitmAvgDeliveryDays | Avg Delivery Days | Number | 8/0 | 9 | True |\n| VenitmDeptCode | vendorItem | VenitmDeptCode | Department | String | 6 | 00 | True |\n| VenitmItemDesc | vendorItem | VenitmItemDesc | Vendor Item Description | String | 4000 | Testing new item | True |\n| VenitmIuCreateDate | vendorItem | VenitmIuCreateDate | Record Creation Date | Date | N/A | System Generated | False |\n| VenitmIuCreateUser | vendorItem | VenitmIuCreateUser | Record Creator User | String | 30 | System User | False |\n| VenitmIuUpdateDate | vendorItem | VenitmIuUpdateDate | Record Last Update Date | Date | N/A | System Generated | False |\n| VenitmIuUpdateUser | vendorItem | VenitmIuUpdateUser | Record Last Updated By | String | 30 | System User | False |\n| VenitmVUuid | vendorItem | VenitmVUuid | Unique UUID for Vendor Item record | String | 64 | Generated | False |", "requestBody": { "content": { "application/json": { "schema": { "type": "object", "example": { "VenitmDesc": "Testing new API" } } } } }, "parameters": [ { "name": "vuuid", "in": "path", "schema": { "type": "string" }, "required": true } ], "responses": { "200": { "description": "OK", "headers": { "Content-Type": { "schema": { "type": "string", "example": "application/vnd.oracle.adf.resourceitem+json" } } }, "content": { "text/plain": { "schema": { "type": "string" }, "example": "{\n \"VenitmCompCode\": \"ZZ\",\n \"VenitmInvItemFlag\": \"Y\",\n \"VenitmVenCode\": \"ABSCONT\",\n \"VenitmItemClassCode\": \"PNT\",\n \"VenitmItmCode\": \"5033015\",\n \"VenitmItmName\": \"SR Ultra Prime White Paint Load abcdefghijklmnopqrstuvwxyz 0\",\n \"VenitmItmtypCode\": \"2\",\n \"VenitmCode\": null,\n \"VenitmLastBuyDate\": \"2018-06-19T15:01:57-04:00\",\n \"VenitmLastBuyQty\": 5,\n \"VenitmWmCode\": \"GL\",\n \"VenitmLstPriceAmt\": 0,\n \"VenitmMinOrdQty\": null,\n \"VenitmDesc\": \"Testing new API\",\n \"VenitmStatCode\": null,\n \"VenitmAvgPriceAmt\": null,\n \"VenitmAvgDeliveryDays\": null,\n \"VenitmDeptCode\": null,\n \"VenitmIuCreateDate\": \"2010-02-23T14:44:34-05:00\",\n \"VenitmIuUpdateDate\": \"2026-06-09T13:47:32-04:00\",\n \"VenitmVUuid\": \"508FD9C766225106E0630B811DACDB45\",\n \"VenitmItemDesc\": null,\n \"links\": [\n {\n \"rel\": \"self\",\n \"href\": \"http://127.0.0.1:7101/po-rest-api/rest/1/vendorItem/508FD9C766225106E0630B811DACDB45\",\n \"name\": \"vendorItem\",\n \"kind\": \"item\"\n },\n {\n \"rel\": \"canonical\",\n \"href\": \"http://127.0.0.1:7101/po-rest-api/rest/1/vendorItem/508FD9C766225106E0630B811DACDB45\",\n \"name\": \"vendorItem\",\n \"kind\": \"item\"\n }\n ]\n}" } } } } } } }, "components": { "securitySchemes": { "cmicBasicAuth": { "type": "http", "scheme": "basic", "description": "Basic authentication" } } } } ````