Function
The Purchase Order (PO) Item Edit function allows you to edit items on a PO.
URL
Root URL}/API/PO/ItemEdit/{API Key} |
Parameters
| Parameter | Description | Required | Comment |
1 | poNum | Purchase order number | Y |
|
2 | uniqueLnNo | Unique PO item identifier | Y |
|
3 | POITTYPE | Purchase order Item type | Y | Can be "INVT PART," "MRO," or "Services." |
4 | part_no | Part number | Y | Used to choose a part. |
5 | revision | Part revision | N | Required if Part_no is used. |
6 | uniq_key | Part identifier key | N | Can be used in place of part number and revision. |
7 | partmfgr | Part manufacturer | N | Can be used to specify a manufacturer for a part. Must be an existing manufacturer for the part. |
8 | mfgr_pt_no | Manufacturer part number | N | Can be used instead of part_no to choose an item. |
9 | uniqmfgrhd | Manufacturer key | Y | Can be used in place of partmfgr and mfgr_pt_no. |
10 | overage | Overage | N | Percentage of parts that can be received over the ordered qty. |
11 | package | Package | N | The item's package size can be "AMMO BELT," "BULK," "CARTON," "EACH," "REAM," "REEL," "TRAY," or "TUBE." |
12 | updatePLT | Update purchase lead time | N |
|
13 | pur_ltime | Purchase lead time | N | Must be numerical, and followed by DY, WK, MO. |
14 | updateMinOrdMult | Update minimum/multi-order values. | N |
|
15 | minorder | Minimum order | N | The minimum amount required per order. |
16 | ordmult | Multiple order | N | The amount that must be ordered over the min order. |
17 | COSTEACH | Cost each | N | The cost of each order. |
18 | ORD_QTY | Order quantity | Y | The amount ordered. |
19 | updateMaterialCost | Update material cost | N |
|
20 | updateTargetPrice | Update target price | N |
|
21 | IS_TAX | Is the PO taxable | N |
|
22 | ISFIRM | Is Firm Planned | N | Selects if the order is firm planned, and prevents MRP from overwriting it. |
23 | FIRSTARTICLE | First article inspection | N | Does the PO require first article inspection |
24 | supplierPartNumber | Supplier part number | N |
|
25 | INSPEXCNOTE | Inspection exception note | N |
|
26 | INSPEXCDOC | Inspection exception code | N |
|
27 | PUR_UOFM | Purchase unit of measurement | N |
|
28 | U_OF_MEAS | Unit of measurement | N | Can be "EACH," "IN," "DOZ," "REEL," "LOT," "BULK," "SQIN," "SQFT," "SQYD," "SQMM," "SQCM," "SQME," "GRAM," "KGRM," "MLTR," "LITR," "CC," "OUNC," "PINT," "QUAR," "GAL," "M," "FT," "CM," "LB," or "YARD." |
29 | NOTE1 | Note specific to a PO line item | N |
|
30 | TAX_PCT | Tax percentage (if the line item is marked taxable) | N |
|
31 | DESCRIPT | Description PO line item | N |
|
32 | PART_CLASS | Part class | N |
|
33 | PART_TYPE | Part type | N |
|
34 | INSPEXCEPTION | Does the item have an inspection exception | N |
|
35 | INSPEXCINIT | Initials of who added inspection exception on the line item | N |
|
36 | INSPEXCDT | Date the inspection exception was added to the line item | N |
|
37 | LCANCEL | Is the line canceled | N |
|
38 | INSPECTIONOTE | Inspection note | N |
|
39 | ITEMNO | item number | N |
|
Example Strings
PO Item Edit
URL
?poNum=PONUMBER&UNIQLNNO=UNIQLNNO&costeach=10&ord_qty=1' |
JSON
{ "poNum":"PONUMber", "UNIQLNNO":"UNIQLNNO", "costeach":"10", "ord_qty":"1" } |
A successful request should result in the following:
{ "$id": "1", "Code":"200", "Message": "PO Items edited successfully.", "SessionId":"null", "IsValidUser":"true", "ResponseObject":"null" } |
Common Error Messages
JSON Error
If there is an error with the setup of the JSON string (such as a misplaced comma or other punctuation), the system will return the following error message:
{ "$id": "1", "Code":"403", "Message":"'PO Items' Object is not initialized properly.", "SessionId":"null", "IsValidUser":"true", "ResponseObject":"null" } |
Parameter Error
If there is an error with an individual parameter, the system will return an error message describing the error:
{ "$id":"1", "Code":"403", "Message":"PO Items add failed.UniqMfgrhd is Invalid.", "SessionId":"null", "IsValidUser":"true", "ResponseObject":"null" } |