Function
The PO Add function is used to add a new PO. An item must be added to the PO tables, but scheduling does not need to be added at this point.
URL
{Root URL}/api/PO/Add/{API KEY} |
Parameters
| Parameter | Description | Required | Comment |
1 | supName | Supplier name | Y | Required, but if a UniqSupNo is provided, then this field is not required. |
2 | UniqSupNo | Unique supplier number | Y | Required, but if a supName is provided, then this field is not required. |
3 | confirmName | Confirm name | N | User Input, No validation |
4 | poDate | Purchase order date. | N | If not entered manually, it will default to today’s date. |
5 | FreightIncluded | Freight included | N | Can be "1" or "0," but the default is "0." |
6 | buyer | Name of the buyer | N | Has to be entered in the following format: LastName, FirstName. Must be a buyer in the system. |
7 | remitToLink | The link to the remit to address | N | If entered it must be a valid link. |
8 | confirmToLink | The link to the confirm to address | N |
|
9 | receiveToLink | The link to the receiving address | N | If entered it must be a valid link |
10 | deliveryTime | The delivery time for the receiving address | N | Must be in a 24-hour format, e.g., "13:00" |
11 | Terms | Payment terms for the supplier | N | Can be "NET 10," "NET 15," "NET 30," "NET 30/2% 10," "NET 45," "COD," or "NONE." |
12 | FOB | Freight on board | N |
|
13 | shipVia | The method of shipping | N |
|
14 | shipCharge | Supplier shipping charge | N |
|
15 | shippingAmount | Shipping amount | N | The default is "0," and is entered manually. |
16 | isShippingTaxable | Choose whether or not the shipping is taxable | N | Can be "0" or "1," and the default is "0" |
17 | shippingTaxPct | The amount of the shipping tax | N | The default is "0.00." If a value is entered here, then the isShippingTaxable must be set as "1." |
18 | billToLink | This links the record to the supplier's billing address | N | If entered, it has to be a valid link. |
19 | POItemsList | Purchase order item list | Y | You need to provide at least one PO item, and you can also add a PoitschdList. |
20 | POITTYPE | Purchase order item type | Y | Can be "INVT PART," "MRO," or "Services." |
21 | part_no | Part number | Y | Used to choose a part. |
22 | UNIQ_KEY | Part identifier key | N | Can be used instead of part number and revision. |
23 | Rev | Part revision | N | Required if Part_no is used. |
24 | UniqMfgrhd | Manufacturer key | N | Can be used in place of partmfgr and mfgr_pt_no. |
25 | PARTMFGR | Part manufacturer | N | Can be used to specify a manufacturer for a part. Must be an existing manufacturer for the part |
26 | MFGR_PT_NO | Manufacturer part number | N | Can be used instead of part_no to choose an item. |
27 | ORD_QTY | Order quantity | Y | The amount ordered. |
28 | PoitschdList | Schedule details for Items being added to the PO | N |
|
29 | SCHD_QTY | Scheduled quantity | N | Must be equal to or less than the order quantity. |
30 | SCHD_DATE | Schedule date | N | Will default to the current date, or enter in the date in the following format: MM-DD-YYYY. |
31 | PoNum | Purchase order number | N | By default PO numbers are autonumbered but can be set to manual numbering. |
32 | PoTax | Purchase order tax | N |
|
33 | PoTotal | Purchase order total | N |
|
34 | PoStatus | Purchase order status | N | If not provided, then the status will be saved as "New." |
35 | AppvName | User ID of the user who approved the PO | N |
|
36 | FinalName | User ID of the user who approved the final approval (if two approvals are required) | N |
|
37 | PoNote | Purchase order note | N |
|
38 | PoFooter | Purchase order footer | N |
|
39 | ConfName | Supplier contact who confirmed the PO | N |
|
Example PO Add String
URL
{Root URL}/api/PO/Add/{API Key} |
JSON
{ "supName":supName", "PoItemsList": [{ "POITTYPE":"POITTYPE", "UNIQ_KEY":"UNIQ_KEY", "part_no":"part_no", "Rev":"Rev", "UniqMfgrhd":"UniqMfgrhd", "PARTMFGR":"PARTMFGR", "MFGR_PT_NO":"MFGR_PT_NO", "ORD_QTY":"ORD_QTY", "PoitschdList": [{ "SCHD_QTY":"SCHD_QTY", "SCHD_DATE":"SCHD_DATE" }] }] } |