# Update Committed Purchase orders

Infrequently there are use cases where a previously committed purchase order would be allowed to have new Lines added or other adjustments to the document.

The following properties of a committed purchase order are prohibited from being updated
- Commdoc
- Committed Status 
- Committed Date Time 
- Vendor
- Store
- Arrival Log

The following requirements in place for a purchase order to be edited using this method.
- User making the request has the appropriate permissions to edit Purchase Orders after Commit.
- Only purchase orders that have been committed but do not have any kind of purchasing activity against them will be allowed to be edited.

Endpoint: PATCH /purchaseOrders/updateCommitted
Version: v3.0: 3.26.2.3
Security: Auth API User Token

## Request fields (application/json-patch+json):

  - `commdocID` (string, required)

  - `reference` (string,null)

  - `description` (string,null)

  - `instructions` (string,null)

  - `notes` (string,null)

  - `backOrdered` (boolean,null)

  - `canceled` (boolean,null)

  - `invoicedEDI` (boolean,null)

  - `startShip` (string,null)

  - `cancelShip` (string,null)

  - `lines` (array,null)
    When populated this will alter the lines of the purchase order.

To add additional items to a purchase order you would add an object to the array with a shape like
json
{
	"ItemID": "12345678-1234-1234-1234-12345678123",
	"Quantity": 15,
	"VendorPrice": 1.50
}

The result set back will include the generated CommdocLineId that can be used in subsequent update requests for this Purchase Order line.


To alter existing items of a purchase order you would add an object to the array with a shape like
json
{
	"CommDocLineId": "87654321-1234-1234-1234-12345678123",
	"Quantity": 15,
	"VendorPrice": 1.50
}

  - `lines.commdocLineID` (string)
    Should be populated when editing an already existing CommdocLineID.

  - `lines.itemID` (string)
    ONLY to be used when adding a new line. 

Any alterations to existing lines should be handled via the CommdocLineID property as that is an explicit match.

When Items are added using this method it will be appended to the end of the existing lines of the existing commdoc.

  - `lines.vendorPrice` (number,null)

  - `lines.quantity` (number,null)

## Response 422 fields (application/json):

  - `errorText` (string,null)

  - `field` (string,null)

## Response 500 fields (application/json):

  - `message` (string,null)

  - `errors` (array,null)

  - `errors.extensions` (string,null)


## Response 200 fields

## Response 204 fields

## Response 403 fields

## Response 429 fields