BidderUpdate

A service that adds or updates a bidder.

WEBSERVICE  : http://webservices.vortexauction.com/functions.cfc?wsdl
METHOD      : BidderUpdate
ARGUMENT    : AUCTIONEER_ID       [Numeric] Required | Your auctioneer ID
              ACCESS_KEY          [String]  Required | Your web service access key
              BIDDER_ID           [Numeric] Optional | A bidder ID to update
              EXTERNAL_BIDDER_ID  [String]  Required | An external bidder ID to add or update
              ACTIVE              [Numeric] Required | Indicates whether this bidder can access the system (0 or 1)
              BIDDING_ALLOWED     [Numeric] Required | Indicates whether this bidder can bid on auction items (0 or 1)
              AUTOAPPROVAL        [Numeric] Optional | Indicates whether this bidder is auto-approved
              COMPANY             [String]  Optional | The bidder's employer
              FIRST_NAME          [String]  Required | The bidder's first name
              LAST_NAME           [String]  Required | The bidder's last name
              EMAIL               [String]  Required | The bidder's e-mail address
              CITY                [String]  Optional | The city where the bidder resides
              USERNAME            [String]  Optional | The bidder's username
              PASSWORD            [String]  Optional | The bidder's password
              PUBLICDISPLAYNAME   [String]  Optional | The unique Bidder identifier

NOTE        : 1. If you specify a BIDDER_ID, then this auction will be updated regardless of its previous EXTERNAL_BIDDER_ID.
              2. If you do not specify an BIDDER_ID, then the auction with the specified EXTERNAL_BIDDER_ID will be added or updated.
              3. The password can be supplied directly or as an MD5 encrypted string, unencrypted passwords will be encryped in MD5 automaticaly.

RETURNS     : BidderUpdateResponse
ON FAILURE  : <?xml version="1.0" encoding="utf-8"?>
              <BidderUpdateResponse>
                  <Error>
                      <Code>[Error code]</Code>
                      <Message>[Error message]</Message>
                  </Error>
              </BidderUpdateResponse>
ON SUCCESS  : <?xml version="1.0" encoding="utf-8"?>
              <BidderUpdateResponse>
                  <Bidder>
                      <Bidder_ID>[ID of the added or updated bidder]</Bidder_ID>
                  </Bidder>
              </BidderUpdateResponse>

ERROR CODES : 00 = An unexpected error occured.
              01 = Missing or invalid arguments.
              02 = Invalid auctioneer ID and/or access key.
              07 = Specified username is already used by another bidder.

EXAMPLES    :
              COLDFUSION :
              <cfinvoke webservice="http://webservices.vortexauction.com/functions.cfc?wsdl" method="BidderUpdate" returnvariable="result">
                  <cfinvokeargument name="Auctioneer_ID" value="0" />
                  <cfinvokeargument name="Access_Key" value="..." />
                  <cfinvokeargument name="Bidder_ID" value="0" />
                  <cfinvokeargument name="External_Bidder_ID" value="..." />
                  <cfinvokeargument name="Active" value="0" />
                  <cfinvokeargument name="Bidding_Allowed" value="..." />
                  <cfinvokeargument name="AutoApproval" value="0" />
                  <cfinvokeargument name="Company" value="..." />
                  <cfinvokeargument name="First_Name" value="..." />
                  <cfinvokeargument name="Last_Name" value="..." />
                  <cfinvokeargument name="Email" value="..." />
                  <cfinvokeargument name="City" value="..." />
                  <cfinvokeargument name="Username" value="..." />
                  <cfinvokeargument name="Password" value="..." />
              </cfinvoke>
              <cfdump var=#result# />
              
              PHP :
              class BidderUpdate {
                  function BidderUpdate($Auctioneer_ID, $Access_Key, $Bidder_ID, $External_Bidder_ID, $Active, $Bidding_Allowed, $AutoApproval, $Company, $First_Name, $Last_Name, $Email, $City, $Username, $Password) 
                  {
                      $this->Auctioneer_ID = $Auctioneer_ID;
                      $this->Access_Key = $Access_Key;
                      $this->Bidder_ID = $Bidder_ID;
                      $this->External_Bidder_ID = $External_Bidder_ID;
                      $this->Active = $Active;
                      $this->Bidding_Allowed = $Bidding_Allowed;
                      $this->AutoApproval = $AutoApproval;
                      $this->Company = $Company;
                      $this->First_Name = $First_Name;
                      $this->Last_Name = $Last_Name;
                      $this->Email = $Email;
                      $this->City = $City;
                      $this->Username = $Username;
                      $this->Password = $Password;
                  }
              }
              $soapClient = new SoapClient("http://webservices.vortexauction.com/functions.cfc?wsdl");
              $params = new BidderUpdate(0, "...", 0, "...", 0, 0, 0, "...", "...", "...", "...", "...", "...", "...");     
              $result = $soapClient->BidderUpdate($params);
              var_dump($result);