PO Change Order — Posting
Overview
Posts a change order to the ledger, identified by its unique identifier and a posting date.
Notes
The process first retrieves the purchase order header and the related company configuration settings. It then validates whether the change order is eligible for processing and approval. If the validation is successful, the change order is prepared for posting and assigned to the appropriate open batch. The system then posts the change order using the standard posting process, generates the required output, and returns the posting result. Finally, the transaction is committed and the posting outcome is returned to the caller.
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
POST {base_url}/po-rest-api/jersey/v1/po-change-order/{vuuid}/post
Path Parameters
| Field | Type | Required | Default | Description |
|---|---|---|---|---|
| vuuid | String | True | — | POCOH_V_UUID of the change order to post |
Query Parameters
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
| postDate | String | True | — | Posting date, format YYYY-MM-DD |
Example Request
curl -X POST "{base_url}/po-rest-api/jersey/v1/po-change-order/57583E9AF08A542CE0630B811DACCB66/post?postDate=2026-08-23" \
-H "Authorization: Basic {credentials}"
Example Response (200 OK)
{
"companyCode": "ALT",
"poNumber": "PO000004",
"coNumber": "1",
"releaseNumber": 1,
"batchNumber": 4021,
"batchName": "PO BATCH 08/26",
"message": "Posted successfully"
}
Attributes
| Field | Type | Description |
|---|---|---|
| companyCode | String | Company code of the posted change order |
| poNumber | String | Parent PO number |
| coNumber | String | Change order number |
| releaseNumber | Number | Release number |
| batchNumber | Number | Batch the change order was posted |
| batchName | String | Name of that batch |
| message | String | Message returned by the routine |
Error Codes
| HTTP | Error Code | Reason |
|---|---|---|
| 400 | PO-000268-ERR | vuuid and postDate are both required |
| 400 | PO-000269-ERR | postDate is not a valid date in YYYY-MM-DD format |
| 404 | PO-000260-ERR | No change order found for the supplied vuuid |
| 404 | PO-000221-ERR | No unposted batch found for the company (identifier batch) |
| 500 | (DB-raised, code varies) | rejects the change order as not eligible for posting/auto-approval |
| 500 | (unhandled exception, no error code) | No row exists for the company |
| 500 | (unhandled exception) | Any other unexpected error from the transaction is rolled back |
Basic authentication
OK
"{\n \"companyCode\": \"ZZ\",\n \"poNumber\": \"987893\",\n \"coNumber\": \"4\",\n \"releaseNumber\": 1,\n \"batchNumber\": 226656,\n \"batchName\": \"YASHB 2026-08-19 C\",\n \"message\": \"Posting is completed.\"\n}"