SavePurchaseOrder Method

Save a new PurchaseOrder object. If a PurchaseOrder with the specified OrderGroup identifier is already present in the Database an update operation is performed.

Namespace:  Microsoft.CommerceServer.Orders.WebService
Assembly:  Microsoft.CommerceServer.Orders.DataManagement (in Microsoft.CommerceServer.Orders.DataManagement.dll)

Syntax

'Declaration
<WebMethodAttribute> _
Public Overridable Function SavePurchaseOrder ( _
    purchaseOrderXml As XmlElement, _
    applicationId As String _
) As Guid
'Usage
Dim instance As OrdersWebService
Dim purchaseOrderXml As XmlElement
Dim applicationId As String
Dim returnValue As Guid

returnValue = instance.SavePurchaseOrder(purchaseOrderXml, _
    applicationId)
[WebMethodAttribute]
public virtual Guid SavePurchaseOrder(
    XmlElement purchaseOrderXml,
    string applicationId
)
[WebMethodAttribute]
public:
virtual Guid SavePurchaseOrder(
    XmlElement^ purchaseOrderXml, 
    String^ applicationId
)
public function SavePurchaseOrder(
    purchaseOrderXml : XmlElement, 
    applicationId : String
) : Guid

Parameters

  • applicationId
    Type: System..::.String
    Identifier for the caller application as defined in the StatusManager table in transactionconfig database.

Return Value

Type: System..::.Guid
The order group identifier for the purchase order being saved.

Remarks

Updates an existing PurchaseOrder or saves a new PurchaseOrder. Xml which conforms to the orders XSD is de-serialized into a Purchase Order and the PurchaseOrder will be saved. Method performs the concurrency check for the existing purchase orders.

The XML which conforms to the orders XSD is de-serialized into a Purchase Order and the purchase order is saved. This method performs the concurrency check for the existing purchase orders.

Some order system APIs support distributed transactions. If a cookie with a valid transaction is found the order system enlists as part of that transaction. If a valid transaction is not found the order system initiates a new transaction.

Permissions

See Also

Reference

OrdersWebService Class

OrdersWebService Members

Microsoft.CommerceServer.Orders.WebService Namespace