Function
The Purchase Order (PO) Item Get API is used to get information about the items on existing POs.
URL
{Root URL}/PO/ItemGet/{API Key} |
Parameters
| Parameter | Description | Required | Comment | |
| 1 | poNum | Purchase order number | N | |
| 2 | supplierName | Supplier name | N | Can be used to sort POs by supplier. |
| 3 | uniqsupno | Supplier identification number | N | Can be used in place of the supplier name. |
| 4 | partNo | Part number | N | Can be used to sort POs by part. |
| 5 | revision | Part revision | N | Used alongside partNo. |
| 6 | uniqKey | Part unique identifier | N | Can be used in place of part number and revision. |
| 7 | uniqlnno | N | ||
| 8 | poStatus | Purchase order status | N | Can be open, canceled, or closed. |
| 9 | mfgrPtNo | Manufacturer part number | N | Can be used to sort POs by manufacturer part number. |
| 10 | partmfgr | Part manufacturer | N | Can be used to sort POs by Manufacturer. |
| 11 | withBalance | POs with balance | N | Can be "true" or "false." |
| 12 | received | PO received | N | Can be "true" or "false." |
| 13 | scheduledPriorTo |
Example Strings
PO Item Get
URL
?PoNum=PONUMBER |
JSON
{ "PoNum":"PONUMBER" } |
A successful request should return the following:
{ "$id": "1", "Code": "200", "Message": "PO Items details:", "SessionId": "null", "IsValidUser": "true", "-ResponseObject: "[" -{ "$id: "2", "UNIQLNNO": "_1ZM0LAXRD", "PONUM": "000000000001749", "UNIQ_KEY": "_4750SWEOD", "ITEMNO": "001", "COSTEACH": "0.88", "ORD_QTY": "100", "RECV_QTY": "0", "REJ_QTY": "0", "ACPT_QTY": "0", "NOTE1": "", "IS_TAX": "false", "TAX_PCT": "0", "IS_CONTR": "false", "OVERAGE": "5", "POITTYPE": "Invt Part", "L_PRINT": "false", "NO_PKG": "0", "DESCRIPT": "", "PARTMFGR": "GENR", "MFGR_PT_NO": "", "PACKAGE": "BULK", "PART_CLASS:" "", "PART_TYPE": "", "U_OF_MEAS": "EACH", "PUR_UOFM": "EACH", "S_ORD_QTY": "100", "ISFIRM": "false", "UNIQMFGRHD": "_4750SXAYM", "FIRSTARTICLE": "false", "INSPEXCEPT": "false", "INSPEXCEPTION": "", "INSPEXCINIT": "", "INSPEXCDT": "null", "INSPEXCNOTE": "", "INSPEXCDOC": "", "LCANCEL": "false", "UNIQMFSP": "", "INSPECTIONOTE": "", "lRemvRcv": "false", "POSTATUS": "OPEN", "PODATE": "2014-10-31T13:49:00", "Part_No": "416-110989", "Revision": "b", "Part_Sourc": "BUY", "Supname": "Romp", "Status": "APPROVED", "SUP_TYPE": "INDEPENDENT REP", "Supid": "0000000005" } ] } |
Common Error
Not Enough Information
If there is not enough data provided or the parameters provided are invalid to retrieve the PO information, the system will return the following error message:
{ "$id": "1", "Code": "403", "Message": "PO Items details failed:Not enough information to return the data, please provide valid parameters.", "SessionId": "null", "IsValidUser": "true", "ResponseObject": "null" } |