Update Purchase Change Order Header

Published on Oct 7, 2026

Patch

/po-rest-api/jersey/v1/po-change-order/58CEEE8CCAD6650DE0630B811DAC89C2

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.

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)

{
  "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

Security

HTTP

Type basic

Basic authentication

Header parameters

Content-Type

string

Exampleapplication/json

Body parameters

object

Example{ "header": { "pocohDesc1": "Updated via Postman1" } }

Responses

200

Headers

Content-Type

string

Exampleapplication/json

"{\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}"

string

Update Purchase Change Order Header

PO Change Order — Update Header

Overview

Notes

UI Navigation

Finders

HTTP Method & Endpoint

Path Parameters

Query Parameters

Example Request

Example Response (200 OK)

Attributes

Request body — `header` object

Response body

Error Codes

Contact Us

Update Purchase Change Order Header

PO Change Order — Update Header

Overview

Notes

UI Navigation

Finders

HTTP Method & Endpoint

Path Parameters

Query Parameters

Example Request

Example Response (200 OK)

Attributes

Request body — header object

Response body

Error Codes

Request body — `header` object