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"

}]

}]

}