This method will start an order with the spedified buyer type and customer. If the buyer type says a customer is required then the cutomer ID parameter will be required. If the buyer type says a member is required then the member ID parameter will be required.
Parameters
appKey
string
A key identifying the application making the call
userKey
string
A key identifying the user making the call
corpOrgID
int
The corp organization ID
buyerTypeID
int
The buyer type ID
customerID
long
optional
The customer ID
memberID
long
optional
The member ID
Return Values
An order data structure with the following fields
OrderID
long
The order ID
OrderNumber
string
The order number
TransactionID
long
The transaction ID
OpenDateTime
datetime
The date/time the transaction was started
CloseDateTime
datetime
The date/time the transaction was finalized
ExpirationDateTime
datetime
The date/time the transaction is set to expire
Expired
bool
An indicator that the transaction has expired
InProcess
bool
An indicator that the transaction is in process
BuyerTypeID
int
The buyer type ID for the order
CustomerID
long
The customer ID for the order
ContactCustomerID
long
The contact customer ID for the order
Subtotal
decimal
The current order total excluding fees
OrderTotal
decimal
The current order total including fees
ItemCount
int
The current number of items in the order
ItemSummary
list
This value will be null since the order was just started
PaymentTotal
decimal
The current payment total applied on the orderd
RemainingBalance
decimal
The current payment total remaining on the orderd
CashPaymentID
int
The Payment Method ID of Cash payments if allowed (-1 if not)
TransferURL
string
Checkout URL
Errors
ApplicationKeyMissing
1000
Required parameter appkey is missing or invalid
UserCredentialsMissing
1001
Required user credentials are missing or invalid
SecurityInsufficient
1002
User security does not permit access to the requested function
RequiredParameter
1028
Required parameter is missing
DefaultWebServiceGroupRequired
1010
Default web service group must be set up
RequiredBuyerTypeInfoMissing
1030
Required buyer type is invalid
MemberNotValid
1025
Membership currently not valid
MemberRenewalRequired
1024
Membership renewal required
MemberExpired
1023
Membership expired
CustomerNotFound
1021
Customer not found
Example Request
https://prod1.agileticketing.net/sales.svc/json/OrderStart?appkey={APPKEY}&userkey={USERKEY}&corporgid={CORPORGID}&buyertypeid={BUYERTYPEID}&customerid={CUSTOMERID}&memberid={MEMBERID}
Example JSON Response
{
"OrderID":9223372036854775807,
"OrderNumber":"String content",
"TransactionID":9223372036854775807,
"OpenDateTime":"\/Date(928167600000-0500)\/",
"CloseDateTime":"\/Date(928167600000-0500)\/",
"ExpirationDateTime":"\/Date(928167600000-0500)\/",
"Expired":true,
"InProcess":true,
"BuyerTypeID":2147483647,
"CustomerID":9223372036854775807,
"ContactCustomerID":9223372036854775807,
"Subtotal":12678967.543233,
"OrderTotal":12678967.543233,
"ItemCount":2147483647,
"ItemSummary":null,
"PaymentTotal":12678967.543233,
"RemainingBalance":12678967.543233,
"CashPaymentID":2147483647,
"TransferURL":"String content"
}
Example XML Response
<Order xmlns="http://www.agiletix.com/api"> <OrderID>9223372036854775807</OrderID> <OrderNumber>String content</OrderNumber> <TransactionID>9223372036854775807</TransactionID> <OpenDateTime>1999-05-31T11:20:00</OpenDateTime> <CloseDateTime>1999-05-31T11:20:00</CloseDateTime> <ExpirationDateTime>1999-05-31T11:20:00</ExpirationDateTime> <Expired>true</Expired> <InProcess>true</InProcess> <BuyerTypeID>2147483647</BuyerTypeID> <CustomerID>9223372036854775807</CustomerID> <ContactCustomerID>9223372036854775807</ContactCustomerID> <Subtotal>12678967.543233</Subtotal> <OrderTotal>12678967.543233</OrderTotal> <ItemCount>2147483647</ItemCount> <ItemSummary i:nil="true"/> <PaymentTotal>12678967.543233</PaymentTotal> <RemainingBalance>12678967.543233</RemainingBalance> <CashPaymentID>2147483647</CashPaymentID> <TransferURL>String content</TransferURL> </Order>
Comments