> ## 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 Purchase Change Order Header > # PO Change Order — Update Header ## Overview Updates a single change order header, identified by its unique identifier. Summary lines are never touched by this endpoint, and only editable header fields are accepted — the change order's key information and system/audit fields are rejected. ## Notes - Attribute values are applied reflectively: every non-null field present in the request payload's `header` object is written to the row, unless it is restricted (see Attributes below), in which case the whole request fails before anything is written. - On success the row is reloaded and returned — there is no separate "read" view for the response. ## UI Navigation Asset Management → Purchase Order → Change Orders → Enter Change Order ## Finders Not applicable — targets a single record by `POCOH_V_UUID`. ## HTTP Method & Endpoint ``` PATCH {base_url}/po-rest-api/jersey/v1/po-change-order/{vuuid} Content-Type: application/json ``` ## Path Parameters | Field | Type | Required | Default | Description | | --- | --- | --- | --- | --- | | vuuid | String | True | — | `POCOH_V_UUID` of the change order header to update | ## Query Parameters None. ## Example Request ``` curl -X PATCH "{base_url}/po-rest-api/jersey/v1/po-change-order/57583E9AF08A542CE0630B811DACCB66" \ -H "Authorization: Basic {credentials}" \ -H "Content-Type: application/json" \ -d '{ "header": { "pocohDesc1": "Revised scope of work", "pocohReqReason": "Client requested additional materials" } }' ``` ## Example Response (200 OK) ``` json { "pocohVUuid": "57583E9AF08A542CE0630B811DACCB66", "pocohCompCode": "ALT", "pocohPoNum": "PO000004", "pocohNum": "1", "pocohDesc1": "Revised scope of work", "pocohReqReason": "Client requested additional materials" } ``` ## Attributes ### Request body — `header` object Any of the following header fields may be supplied **except** those marked as restricted below, which raise `PO-000265-ERR` (identifier = the offending field name) if supplied. Only one restricted field is reported per request — the check stops at the first restricted field it encounters. | Name | Description | Type | Data Length | Example | Editable | | --- | --- | --- | --- | --- | --- | | pocohVUuid | Virtual UUID, unique row identifier | String | 64 | — | Restricted | | pocohCompCode | Company code | String | 8 | ALT | Restricted | | pocohCompName | Company name (lookup) | String | 30 | — | Restricted | | pocohPoNum | Parent Purchase Order number | String | 11 | PO000004 | Restricted | | pocohNum | Change order number | String | 11 | 1 | Restricted | | pocohBchNum | Posting batch number | Number(11) | 11 | — | Restricted | | pocohVenCode | Vendor code | String | 8 | V0001 | True | | pocohVenName | Vendor name (lookup) | String | 50 | — | Restricted | | pocohDeptCode | Department code | String | 6 | ADMIN | True | | pocohDeptName | Department name (lookup) | String | 30 | — | Restricted | | pocohExptdDate | Expected date | Date | — | 2026-09-01 | True | | pocohOrdDate | Order date | Date | — | 2026-08-20 | True | | pocohRecDate | Receipt date | Date | — | 2026-09-05 | True | | pocohTypeCode | Change order type code | String | 1 | S | True | | pocohAdjCode | Adjustment code | String | 1 | A | True | | pocohStatCode | Status code | String | 1 | O | Restricted | | pocohChgCode | Change code | String | 1 | C | True | | pocohTermCode | Payment terms code | String | 6 | NET30 | True | | pocohTermName | Payment terms name (lookup) | String | 30 | — | Restricted | | pocohInvCode | Invoice code | String | 20 | INV001 | True | | pocohInvDate | Invoice date | Date | — | 2026-09-10 | True | | pocohInvDueDate | Invoice due date | Date | — | 2026-10-10 | True | | pocohInvDiscDate | Invoice discount date | Date | — | 2026-09-20 | True | | pocohInvDiscAmt | Invoice discount amount | Number(18,2) | 18,2 | 25.00 | True | | pocohCurrCode | Currency code | String | 3 | USD | True | | pocohCurrName | Currency name (lookup) | String | 30 | — | Restricted | | pocohFobCode | FOB code | String | 2 | FO | True | | pocohBuyCode | Buyer code | String | 30 | BUYER01 | True | | pocohAddCode | Ship-to address code | String | 8 | ADDR01 | True | | pocohShplneCode | Shipping line code | String | 3 | UPS | True | | pocohShpmetCode | Shipping method code | String | 5 | GRND | True | | pocohTxt1Code | Text code 1 | String | 8 | TXT01 | True | | pocohTxt2Code | Text code 2 | String | 8 | TXT02 | True | | pocohShpinstDesc | Shipping instructions | String | 2000 | Deliver to loading dock | True | | pocohDesc1 | Description line 1 | String | 2000 | Revised material order | True | | pocohDesc2 | Description line 2 | String | 2000 | Adds 2 items | True | | pocohAdjPrice | Adjusted price total | Number(18,4) | 18,4 | 1250.0000 | True | | pocohUnadjPrice | Unadjusted price total | Number(18,4) | 18,4 | 1200.0000 | True | | pocohCurrConvNum | Currency conversion rate | Number(16,8) | 16,8 | 1.00000000 | True | | pocohCostedCode | Costed flag | String | 1 | Y | True | | pocohRefNum | Reference number | String | 11 | REF001 | True | | pocohRefDate | Reference date | Date | — | 2026-08-15 | True | | pocohReqCode | Requisition code | String | 30 | RQ000003 | True | | pocohRecCode | Receiving code | String | 30 | REC001 | True | | pocohReprintDate | Reprint date | Date | — | 2026-08-22 | True | | pocohWipAccCode | WIP account code | String | 16 | WIP-01 | True | | pocohWipAccName | WIP account name (lookup) | String | 30 | — | Restricted | | pocohWipDeptCode | WIP department code | String | 6 | WIPD01 | True | | pocohWipDeptName | WIP department name (lookup) | String | 30 | — | Restricted | | pocohShipinstTxt1Code..5Code | Shipping instruction text codes 1-5 | String | 8 each | TXT01 | True | | pocohReleaseNum | Release number | Number(11) | 11 | 1 | Restricted | | pocohBilltoAddCode | Bill-to address code | String | 8 | BILL01 | True | | pocohReqReason | Requisition reason | String | 255 | Scope change | True | | pocohInvTypeCode | Invoice type code | String | 1 | S | True | | pocohImageFilename | Attached image filename | String | 255 | co_scan.pdf | True | | pocohInvSerCode | Invoice series code | String | 4 | 2026 | True | | pocohVendOrderAddCode | Vendor order address code | String | 5 | VOA01 | True | | pocohComplianceFlag | Compliance flag (Y/N) | String | 1 | Y | True | | pocohJobCompCode | Job company code | String | 8 | ALT | True | | pocohJobCompName | Job company name (lookup) | String | 30 | — | Restricted | | pocohJobCode | Job code | String | 10 | JOB001 | True | | pocohJobName | Job name (lookup) | String | 60 | — | Restricted | | pocohContactCode | Contact code | String | 10 | CONT01 | True | | pocohAddCompCode | Ship-to address company code | String | 8 | ALT | True | | pocohAddCompName | Ship-to address company name (lookup) | String | 30 | — | Restricted | | pocohPrintDate | Print date | Date | — | 2026-08-21 | True | | pocohDefaultRecCode | Default receiving code | String | 1 | A | True | | pocohDate | Change order date | Date | — | 2026-08-20 | True | | pocohPoTotal | Total PO amount (calculated) | Number | — | 12500.00 | Restricted | | pocohIuCreateDate | Record creation timestamp | Timestamp | — | — | Restricted | | pocohIuCreateUser | User who created the record | String | 30 | — | Restricted | | pocohIuUpdateDate | Record last update timestamp | Timestamp | — | — | Restricted | | pocohIuUpdateUser | User who last updated the record | String | 30 | — | Restricted | | pocohAcctDescription | Account description (lookup) | String | 500 | — | Restricted | | pocohDiscountPct | Discount percentage | Number(16,3) | 16,3 | 2.500 | True | | pocohAddName | Ship-to address name (lookup) | String | 195 | — | Restricted | ### Response body Flat, updated header object — same shape as the "Editable" column of the table above, plus the restricted/system fields, all populated with their current values. ## Error Codes | HTTP | Error Code | Reason | | --- | --- | --- | | 400 | PO-000263-ERR | `vuuid` and request body are both required | | 400 | PO-000264-ERR | `header` object is required in the request payload | | 404 | PO-000260-ERR | No change order found for the supplied `vuuid` | | 400 | PO-000265-ERR | A key, system-assigned, or non-writeable field was supplied (see table above) | | 500 | (unhandled exception) | Any other unexpected error; the transaction is rolled back | ## OpenAPI ````json PATCH /po-rest-api/jersey/v1/po-change-order/58CEEE8CCAD6650DE0630B811DAC89C2 { "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/jersey/v1/po-change-order/58CEEE8CCAD6650DE0630B811DAC89C2": { "patch": { "tags": [ "Asset Management | Purchase Change Order" ], "summary": "Update Purchase Change Order Header", "description": "# PO Change Order — Update Header\n\n## Overview\n\nUpdates a single change order header, identified by its unique identifier. Summary lines are \nnever touched by this endpoint, and only editable header fields are accepted — the change \norder's key information and system/audit fields are rejected.\n\n## Notes\n\n- Attribute values are applied reflectively: every non-null field present in the request \n payload's `header` object is written to the row, unless it is restricted (see Attributes \n below), in which case the whole request fails before anything is written.\n \n- On success the row is reloaded and returned — there is no separate \"read\" view for the \n response.\n \n\n## UI Navigation\n\nAsset Management → Purchase Order → Change Orders → Enter Change Order\n\n## Finders\n\nNot applicable — targets a single record by `POCOH_V_UUID`.\n\n## HTTP Method & Endpoint\n\n```\nPATCH {base_url}/po-rest-api/jersey/v1/po-change-order/{vuuid}\nContent-Type: application/json\n\n ```\n\n## Path Parameters\n\n| Field | Type | Required | Default | Description |\n| --- | --- | --- | --- | --- |\n| vuuid | String | True | — | `POCOH_V_UUID` of the change order header to update |\n\n## Query Parameters\n\nNone.\n\n## Example Request\n\n```\ncurl -X PATCH \"{base_url}/po-rest-api/jersey/v1/po-change-order/57583E9AF08A542CE0630B811DACCB66\" \\\n -H \"Authorization: Basic {credentials}\" \\\n -H \"Content-Type: application/json\" \\\n -d '{\n \"header\": {\n \"pocohDesc1\": \"Revised scope of work\",\n \"pocohReqReason\": \"Client requested additional materials\"\n }\n }'\n\n ```\n\n## Example Response (200 OK)\n\n``` json\n{\n \"pocohVUuid\": \"57583E9AF08A542CE0630B811DACCB66\",\n \"pocohCompCode\": \"ALT\",\n \"pocohPoNum\": \"PO000004\",\n \"pocohNum\": \"1\",\n \"pocohDesc1\": \"Revised scope of work\",\n \"pocohReqReason\": \"Client requested additional materials\"\n}\n\n ```\n\n## Attributes\n\n### Request body — `header` object\n\nAny of the following header fields may be supplied **except** those marked as restricted \nbelow, which raise `PO-000265-ERR` (identifier = the offending field name) if supplied. Only \none restricted field is reported per request — the check stops at the first restricted field it \nencounters.\n\n| Name | Description | Type | Data Length | Example | Editable |\n| --- | --- | --- | --- | --- | --- |\n| pocohVUuid | Virtual UUID, unique row identifier | String | 64 | — | Restricted |\n| pocohCompCode | Company code | String | 8 | ALT | Restricted |\n| pocohCompName | Company name (lookup) | String | 30 | — | Restricted |\n| pocohPoNum | Parent Purchase Order number | String | 11 | PO000004 | Restricted |\n| pocohNum | Change order number | String | 11 | 1 | Restricted |\n| pocohBchNum | Posting batch number | Number(11) | 11 | — | Restricted |\n| pocohVenCode | Vendor code | String | 8 | V0001 | True |\n| pocohVenName | Vendor name (lookup) | String | 50 | — | Restricted |\n| pocohDeptCode | Department code | String | 6 | ADMIN | True |\n| pocohDeptName | Department name (lookup) | String | 30 | — | Restricted |\n| pocohExptdDate | Expected date | Date | — | 2026-09-01 | True |\n| pocohOrdDate | Order date | Date | — | 2026-08-20 | True |\n| pocohRecDate | Receipt date | Date | — | 2026-09-05 | True |\n| pocohTypeCode | Change order type code | String | 1 | S | True |\n| pocohAdjCode | Adjustment code | String | 1 | A | True |\n| pocohStatCode | Status code | String | 1 | O | Restricted |\n| pocohChgCode | Change code | String | 1 | C | True |\n| pocohTermCode | Payment terms code | String | 6 | NET30 | True |\n| pocohTermName | Payment terms name (lookup) | String | 30 | — | Restricted |\n| pocohInvCode | Invoice code | String | 20 | INV001 | True |\n| pocohInvDate | Invoice date | Date | — | 2026-09-10 | True |\n| pocohInvDueDate | Invoice due date | Date | — | 2026-10-10 | True |\n| pocohInvDiscDate | Invoice discount date | Date | — | 2026-09-20 | True |\n| pocohInvDiscAmt | Invoice discount amount | Number(18,2) | 18,2 | 25.00 | True |\n| pocohCurrCode | Currency code | String | 3 | USD | True |\n| pocohCurrName | Currency name (lookup) | String | 30 | — | Restricted |\n| pocohFobCode | FOB code | String | 2 | FO | True |\n| pocohBuyCode | Buyer code | String | 30 | BUYER01 | True |\n| pocohAddCode | Ship-to address code | String | 8 | ADDR01 | True |\n| pocohShplneCode | Shipping line code | String | 3 | UPS | True |\n| pocohShpmetCode | Shipping method code | String | 5 | GRND | True |\n| pocohTxt1Code | Text code 1 | String | 8 | TXT01 | True |\n| pocohTxt2Code | Text code 2 | String | 8 | TXT02 | True |\n| pocohShpinstDesc | Shipping instructions | String | 2000 | Deliver to loading dock | True |\n| pocohDesc1 | Description line 1 | String | 2000 | Revised material order | True |\n| pocohDesc2 | Description line 2 | String | 2000 | Adds 2 items | True |\n| pocohAdjPrice | Adjusted price total | Number(18,4) | 18,4 | 1250.0000 | True |\n| pocohUnadjPrice | Unadjusted price total | Number(18,4) | 18,4 | 1200.0000 | True |\n| pocohCurrConvNum | Currency conversion rate | Number(16,8) | 16,8 | 1.00000000 | True |\n| pocohCostedCode | Costed flag | String | 1 | Y | True |\n| pocohRefNum | Reference number | String | 11 | REF001 | True |\n| pocohRefDate | Reference date | Date | — | 2026-08-15 | True |\n| pocohReqCode | Requisition code | String | 30 | RQ000003 | True |\n| pocohRecCode | Receiving code | String | 30 | REC001 | True |\n| pocohReprintDate | Reprint date | Date | — | 2026-08-22 | True |\n| pocohWipAccCode | WIP account code | String | 16 | WIP-01 | True |\n| pocohWipAccName | WIP account name (lookup) | String | 30 | — | Restricted |\n| pocohWipDeptCode | WIP department code | String | 6 | WIPD01 | True |\n| pocohWipDeptName | WIP department name (lookup) | String | 30 | — | Restricted |\n| pocohShipinstTxt1Code..5Code | Shipping instruction text codes 1-5 | String | 8 each | TXT01 | True |\n| pocohReleaseNum | Release number | Number(11) | 11 | 1 | Restricted |\n| pocohBilltoAddCode | Bill-to address code | String | 8 | BILL01 | True |\n| pocohReqReason | Requisition reason | String | 255 | Scope change | True |\n| pocohInvTypeCode | Invoice type code | String | 1 | S | True |\n| pocohImageFilename | Attached image filename | String | 255 | co_scan.pdf | True |\n| pocohInvSerCode | Invoice series code | String | 4 | 2026 | True |\n| pocohVendOrderAddCode | Vendor order address code | String | 5 | VOA01 | True |\n| pocohComplianceFlag | Compliance flag (Y/N) | String | 1 | Y | True |\n| pocohJobCompCode | Job company code | String | 8 | ALT | True |\n| pocohJobCompName | Job company name (lookup) | String | 30 | — | Restricted |\n| pocohJobCode | Job code | String | 10 | JOB001 | True |\n| pocohJobName | Job name (lookup) | String | 60 | — | Restricted |\n| pocohContactCode | Contact code | String | 10 | CONT01 | True |\n| pocohAddCompCode | Ship-to address company code | String | 8 | ALT | True |\n| pocohAddCompName | Ship-to address company name (lookup) | String | 30 | — | Restricted |\n| pocohPrintDate | Print date | Date | — | 2026-08-21 | True |\n| pocohDefaultRecCode | Default receiving code | String | 1 | A | True |\n| pocohDate | Change order date | Date | — | 2026-08-20 | True |\n| pocohPoTotal | Total PO amount (calculated) | Number | — | 12500.00 | Restricted |\n| pocohIuCreateDate | Record creation timestamp | Timestamp | — | — | Restricted |\n| pocohIuCreateUser | User who created the record | String | 30 | — | Restricted |\n| pocohIuUpdateDate | Record last update timestamp | Timestamp | — | — | Restricted |\n| pocohIuUpdateUser | User who last updated the record | String | 30 | — | Restricted |\n| pocohAcctDescription | Account description (lookup) | String | 500 | — | Restricted |\n| pocohDiscountPct | Discount percentage | Number(16,3) | 16,3 | 2.500 | True |\n| pocohAddName | Ship-to address name (lookup) | String | 195 | — | Restricted |\n\n### Response body\n\nFlat, updated header object — same shape as the \"Editable\" column of the table above, plus the \nrestricted/system fields, all populated with their current values.\n\n## Error Codes\n\n| HTTP | Error Code | Reason |\n| --- | --- | --- |\n| 400 | PO-000263-ERR | `vuuid` and request body are both required |\n| 400 | PO-000264-ERR | `header` object is required in the request payload |\n| 404 | PO-000260-ERR | No change order found for the supplied `vuuid` |\n| 400 | PO-000265-ERR | A key, system-assigned, or non-writeable field was supplied (see table above) |\n| 500 | (unhandled exception) | Any other unexpected error; the transaction is rolled back |", "requestBody": { "content": { "application/json": { "schema": { "type": "object", "example": { "header": { "pocohDesc1": "Updated via Postman1" } } } } } }, "parameters": [ { "name": "Content-Type", "in": "header", "schema": { "type": "string" }, "example": "application/json" } ], "responses": { "200": { "description": "OK", "headers": { "Content-Type": { "schema": { "type": "string", "example": "application/json" } } }, "content": { "text/plain": { "schema": { "type": "string" }, "example": "{\n \"pocohVUuid\": \"58CEEE8CCAD6650DE0630B811DAC89C2\",\n \"pocohCompCode\": \"ZZ\",\n \"pocohCompName\": \"CMiC-ZZ Test Company Incorp\",\n \"pocohPoNum\": \"FM2\",\n \"pocohNum\": \"2\",\n \"pocohBchNum\": null,\n \"pocohVenCode\": \"ZZ-ACME\",\n \"pocohVenName\": \"ZZ-Acme & Supply\",\n \"pocohDeptCode\": null,\n \"pocohDeptName\": null,\n \"pocohExptdDate\": \"2020-03-10\",\n \"pocohOrdDate\": \"2020-03-03\",\n \"pocohRecDate\": null,\n \"pocohTypeCode\": \"S\",\n \"pocohAdjCode\": null,\n \"pocohStatCode\": \"N\",\n \"pocohChgCode\": \"O\",\n \"pocohTermCode\": \"NET30\",\n \"pocohTermName\": \"Net 30\",\n \"pocohInvCode\": null,\n \"pocohInvDate\": null,\n \"pocohInvDueDate\": null,\n \"pocohInvDiscDate\": null,\n \"pocohInvDiscAmt\": null,\n \"pocohCurrCode\": \"US\",\n \"pocohCurrName\": \"US Dollars\",\n \"pocohFobCode\": null,\n \"pocohBuyCode\": null,\n \"pocohAddCode\": null,\n \"pocohShplneCode\": null,\n \"pocohShpmetCode\": null,\n \"pocohTxt1Code\": null,\n \"pocohTxt2Code\": null,\n \"pocohShpinstDesc\": null,\n \"pocohDesc1\": \"Updated via Postman\",\n \"pocohDesc2\": null,\n \"pocohAdjPrice\": null,\n \"pocohUnadjPrice\": null,\n \"pocohCurrConvNum\": 1,\n \"pocohCostedCode\": null,\n \"pocohRefNum\": null,\n \"pocohRefDate\": null,\n \"pocohReqCode\": null,\n \"pocohRecCode\": null,\n \"pocohReprintDate\": null,\n \"pocohWipAccCode\": null,\n \"pocohWipAccName\": null,\n \"pocohWipDeptCode\": null,\n \"pocohWipDeptName\": null,\n \"pocohShipinstTxt1Code\": null,\n \"pocohShipinstTxt2Code\": null,\n \"pocohShipinstTxt3Code\": null,\n \"pocohShipinstTxt4Code\": null,\n \"pocohShipinstTxt5Code\": null,\n \"pocohReleaseNum\": 1,\n \"pocohBilltoAddCode\": null,\n \"pocohReqReason\": null,\n \"pocohInvTypeCode\": null,\n \"pocohImageFilename\": null,\n \"pocohInvSerCode\": null,\n \"pocohVendOrderAddCode\": null,\n \"pocohComplianceFlag\": \"N\",\n \"pocohJobCompCode\": \"ZZ\",\n \"pocohJobCompName\": \"CMiC-ZZ Test Company Incorp\",\n \"pocohJobCode\": null,\n \"pocohJobName\": null,\n \"pocohContactCode\": null,\n \"pocohAddCompCode\": \"ZZ\",\n \"pocohAddCompName\": \"CMiC-ZZ Test Company Incorp\",\n \"pocohPrintDate\": null,\n \"pocohDefaultRecCode\": \"M\",\n \"pocohDate\": null,\n \"pocohPoTotal\": 118.8,\n \"pocohIuCreateDate\": \"2026-08-11T22:46:40-04:00\",\n \"pocohIuCreateUser\": \"YASHB\",\n \"pocohIuUpdateDate\": \"2026-08-11T23:02:35-04:00\",\n \"pocohIuUpdateUser\": \"YASHB\",\n \"pocohAcctDescription\": null,\n \"pocohDiscountPct\": 0,\n \"pocohAddName\": null,\n \"pocohObjectOraseq\": 2653866208\n}" } } } } } } }, "components": { "securitySchemes": { "cmicBasicAuth": { "type": "http", "scheme": "basic", "description": "Basic authentication" } } } } ````