Add Method (PO)
- Last UpdatedNov 06, 2025
- 3 minute read
The Add() method adds a new purchase order record to the PO table.
The purchase order is uniquely identified by the purchase order ID in the purchase order record.
'Declaration
Public Shared Sub Add( _
ByVal sessionId As Integer, _
ByVal poId As String, _
ByVal vendId As String, _
ByVal sellerId As Nullable(Of Integer), _
ByVal shipTo As Nullable(Of Integer), _
ByVal dateIssuedLocal As Date, _
ByVal stateCode As Nullable(Of PurchaseOrderState), _
ByVal notes As String, _
ByVal spare1 As String, _
ByVal spare2 As String, _
ByVal spare3 As String, _
ByVal spare4 As String, _
ByVal lastEditComment As String, _
ByRef lastEditAt As Date _
)
'Usage
Dim sessionId As Integer
Dim poId As String
Dim vendId As String
Dim sellerId As Nullable(Of Integer)
Dim shipTo As Nullable(Of Integer)
Dim dateIssuedLocal As Date
Dim stateCode As Nullable(Of PurchaseOrderState)
Dim notes As String
Dim spare1 As String
Dim spare2 As String
Dim spare3 As String
Dim spare4 As String
Dim lastEditComment As String
Dim lastEditAt As Date
PO.Add(sessionId, poId, vendId, sellerId, shipTo, dateIssuedLocal, stateCode, notes, spare1, spare2, spare3, spare4, lastEditComment, lastEditAt)
public static void Add(
int sessionId,
string poId,
string vendId,
Nullable<int> sellerId,
Nullable<int> shipTo,
DateTime dateIssuedLocal,
Nullable<PurchaseOrderState> stateCode,
string notes,
string spare1,
string spare2,
string spare3,
string spare4,
string lastEditComment,
out DateTime lastEditAt
)
Parameters
- sessionId
- Required. Holds the session ID and thus the user who is making this method call.
- poId
- Required. Holds the ID of the purchase order.
- vendId
- Optional. Holds the vendor ID, from the Cust table.
- sellerId
- Optional. Holds the ID of the seller, in the Cust_Contact table, from whom the order was purchased.
- shipTo
- Optional. Holds the ID of the entity at which purchased goods are to be received.
- dateIssuedLocal
- Required. Holds the date that the purchase order was issued in the local time of the entity specified by the shipTo parameter, if supplied. If a ship-to entity is not specified, the default time zone will be used to determine the local time.
- stateCode
Optional. Holds a PurchaseOrderState enumeration value that indicates the state of the purchase order:
0=Open (the default)
1=Partially Complete
2=Complete
3=Closed
- notes
- Optional. Holds notes about the purchase order.
- spare1
- Optional. Holds the contents of the user-defined spare1 field.
- spare2
- Optional. Holds the contents of the user-defined spare2 field.
- spare3
- Optional. Holds the contents of the user-defined spare3 field.
- spare4
- Optional. Holds the contents of the user-defined spare4 field.
- lastEditComment
- Optional. Holds comments that describe why this record is being added.
- lastEditAt
- Output. Holds the returned date/time when this record was added. The lastEditAt parameter is used by other methods that modify or delete this type of record for optimistic concurrency control.
Observe the following input parameter rules:
- Required non-DB* parameters: Must pass a value. Cannot be empty or null.
- Optional non-DB* parameters: Either enter a value or pass a null. If passing a null and a default value has been defined, the default value will be used for the parameter.
- Required DB* parameters: Must pass a value. To enter an empty value for the parameter, pass DB*.null (e.g., DBInt.null).
- Optional DB* parameters: To enter no value for the parameter, pass DB*.null (e.g., DBInt.null). To use the default value for the parameter if one has been defined for the object being added, pass a null.