Receive Purchase Order Line Items

PUT /api/.../purchaseorders/{id}/polineitems?action=receive

Receive one or more purchase order line items.

Request Information

Parameters
Name Type Required Description
id Integer Yes The unique id assigned to the purchase order.
action String Yes. Value should be 'receive' action identifier
Request Body

A JSON array of purchase order line item identifiers represented as numbers.

Property Type Nullable Description
POLineItemID Integer No PO line item identifier.
Example
application/json, text/json 
[19, 38,56,58]

Response Information

Returns a result object with how many records are succeeded (RecordsAffected), a success or failure message (Message) and list of JSON objects (Details)

Property Type Description
ID Integer PO line item identifier.
Succeeded Boolean Indicates if the item is received successfully.
ErrorMessage String Description of error
ErrorCode Integer Error code
AdditionalInfo String PO line item's line number
Example
application/json, text/json 
{
  "RecordsAffected": 2,
  "Message": "Line 33: There are 1 request(s) for 'The interruption of everything' 
Line 31: There are 1 request(s) for 'Sons of Texas' 
",
  "Details": [
    {
      "Id": 46,
      "Succeeded": true,
      "ErrorMessage": null,
      "ErrorCode": 0,
      "AdditionalInfo": "33"
    },
    {
      "Id": 44,
      "Succeeded": true,
      "ErrorMessage": null,
      "ErrorCode": 0,
      "AdditionalInfo": "31"
    }
  ]
}

HTTP Response Codes

Code Description
200 OK. Success
400 FAILURE.
  • Bad request
  • Invalid purchase order ID
  • Invalid poline item ID
404 FAILURE.
  • Purchase order not found
  • Purchase order line item not found

Required Permissions

Permission IDs found here.

    CR_AccessAcquisitions_Allow (),
    CR_PurchaseOrders_Access (based on owner ID),
    CR_PurchaseOrders_ReleaseReceiveCancelClosePO (based on owner ID)