AuctionUpdate


A service that adds or updates an auction.

WEBSERVICE : http://webservices.vortexauction.com/functions.cfc?wsdl METHOD : AuctionUpdate ARGUMENT : AUCTIONEER_ID [Numeric] Required | Your auctioneer ID ACCESS_KEY [String] Required | Your web service access key AUCTION_ID [Numeric] Optional | An auction ID to update EXTERNAL_AUCTION_ID [String] Required | An external auction ID to add or update AUCTION_DATE [String] Required | The local date & time, in the auction's time zone, at which the auction will begin NAME [String] Required | The name of the auction DESCRIPTION [String] Optional | A description of the auction SUMMARY [String] Optional | A summary of the auction AUCTION_TERMS [String] Optional | The auction's terms and conditions BUYER_FEES [String] Optional | The buyer's fees OFFSITE_TERMS [String] Optional | The offsite items terms and conditions ACCESS_TYPE [Numeric] Required | The type of access allowed on this auction 1 = Open auction, all my bidders can access this auction. 2 = Private auction, all my bidders can access this auction but only registered bidders can bid. 3 = Closed auction, only registered bidders can access or bid on this auction. AUCTION_TYPE [Numeric] Required | The type of the auction 1 = Catalog only auction, no bidding system. 2 = Webcast auction, live (floor) and online bidding system. 3 = Timed auction, automated online bidding system only. ACTIVE [Numeric] Required | Indicates whether this auction is active 0 = This auction is inactive (not published) and cannot be seen or accessed online. 1 = This auction is active (published) and can be seen and accessed online. ASSISTED [Numeric] Required | Indicates whether a technician should be available during this auction 0 = This auction does not require any assistance from our technical support team. 1 = This auction should be assisted by our technical support team. DEMO [Numeric] Required | Indicates whether this auction is a demo auction 0 = This auction is a regular auction; no restrictions will be applied. 1 = This auction is a demo auction; restrictions to the number of items and bids will be applied. PREBID_DISPLAY [Numeric] Required | Incidates what pre-bid information should be showns on the items 0 = No information displayed 1 = Show the number of pre-bids 2 = Show the highest pre-bid amount CITY [String] Optional | The city where the bidder resides TIME_ZONE [String] Optional | The time zone where in which the auction takes place BidRegistrationAllowed [Numeric] Optional | Indicates whether this auction accepts online max bids 0 = This auction will not accept max bids. 1 = This auction will accept max bids. BidRegistrationStartDate [String] Optional | The local date & time, in the auction's time zone, at which the auction will begin accepting max bids
NOTE : 1. If you specify an AUCTION_ID, then the auction will be updated regardless of its previous EXTERNAL_AUCTION_ID. 2. If you do not specify an AUCTION_ID, then the auction with the specified EXTERNAL_AUCTION_ID will be added or updated if it exists. 3. You can identify a time zone by name (ex.: Montreal, New York or New_York) or by value (ex.: -05:00, -5:00, -0500, -500 or -5). 4. If you add a new auction without specifying a time zone, then the auctioneer's default time zone will be used. 5. If you accept max bids without specifying a max bid date, then the auction date will be used.
RETURNS : AuctionUpdateResponse ON FAILURE : <?xml version="1.0" encoding="utf-8"?> <AuctionUpdateResponse> <Error> <Code>[Error code]</Code> <Message>[Error message]</Message> </Error> </AuctionUpdateResponse> ON SUCCESS : <?xml version="1.0" encoding="utf-8"?> <AuctionUpdateResponse> <Auction> <Auction_ID>[ID of the added or updated auction]</Auction_ID> </Auction> </AuctionUpdateResponse>
ERROR CODES : 00 = An unexpected error occured. 01 = Missing or invalid arguments. 02 = Invalid auctioneer ID and/or access key.
EXAMPLES : COLDFUSION : <cfinvoke webservice="http://webservices.vortexauction.com/functions.cfc?wsdl" method="AuctionUpdate" returnvariable="result"> <cfinvokeargument name="Auctioneer_ID" value="0" /> <cfinvokeargument name="Access_Key" value="..." /> <cfinvokeargument name="Auction_ID" value="0" /> <cfinvokeargument name="External_Auction_ID" value="..." /> <cfinvokeargument name="Auction_Date" value="..." /> <cfinvokeargument name="Name" value="..." /> <cfinvokeargument name="Description" value="..." /> <cfinvokeargument name="Summary" value="..." /> <cfinvokeargument name="Auction_Terms" value="..." /> <cfinvokeargument name="Buyer_Fees" value="..." /> <cfinvokeargument name="Offsite_Terms" value="..." /> <cfinvokeargument name="Access_Type" value="0" /> <cfinvokeargument name="Auction_Type" value="0" /> <cfinvokeargument name="Active" value="0" /> <cfinvokeargument name="Assisted" value="0" /> <cfinvokeargument name="Demo" value="0" /> <cfinvokeargument name="PreBid_Display" value="0" /> <cfinvokeargument name="City" value="..." /> <cfinvokeargument name="Time_Zone" value="..." /> <cfinvokeargument name="BidRegistrationAllowed" value="0" /> </cfinvoke> <cfdump var=#result# /> PHP : class AuctionUpdate { function AuctionUpdate($Auctioneer_ID, $Access_Key, $Auction_ID, $External_Auction_ID, $Auction_Date, $Name, $Description, $Auction_Terms, $Buyer_Fees, $Offsite_Terms, $Access_Type, $Auction_Type, $Active, $Assisted, $Demo, $PreBid_Display, $City, $Time_Zone) { $this->Auctioneer_ID = $Auctioneer_ID; $this->Access_Key = $Access_Key; $this->Auction_ID = $Auction_ID; $this->External_Auction_ID = $External_Auction_ID; $this->Auction_Date = $Auction_Date; $this->Name = $Name; $this->Description = $Description; $this->Summary = $Summary; $this->Auction_Terms = $Auction_Terms; $this->Buyer_Fees = $Buyer_Fees; $this->Offsite_Terms = $Offsite_Terms; $this->Access_Type = $Access_Type; $this->Auction_Type = $Auction_Type; $this->Active = $Active; $this->Assisted = $Assisted; $this->Demo = $Demo; $this->PreBid_Display = $PreBid_Display; $this->City = $City; $this->Time_Zone = $Time_Zone; $this->BidRegistrationAllowed = $BidRegistrationAllowed; } } $soapClient = new SoapClient("http://webservices.vortexauction.com/functions.cfc?wsdl"); $params = new AuctionUpdate(0, "...", 0, "...", "...", "...", "...", "...", "...", "...", 0, 2, 1, 0, 0, 2, "...", "..."); $result = $soapClient->AuctionUpdate($params); var_dump($result);
TEST FORM: