Aukro WebAPI

doFinishItems

This method allows for closing many offers (both ongoing and scheduled for listing) of a logged-in user before scheduled time (with or without cancellation of bids).

  1. sessionHandle | String | required
    User's session identifier received using the doLogin(Enc) method.
  2. finishItemsList | FinishItemsStruct[] | required
    Arrays with structures containing information of offers to be closed (max. 25).
    1. finishItemId | Long | required
      Offer identifier.
    2. finishCancelAllBids | Integer
      Information on whether bids are to be cancelled together with closing the offer (1 - yes, 0 - no; default value is 0; only bids placed in the bidding process are cancelled).
    3. finishCancelReason | String | non-required (required if finishCancelAllBids = 1)
      Reason for cancellation of bids.
  1. finishItemsSucceed | Long[]
    Array of identifiers of successfully ended offers.
  2. finishItemsFailed | FinishFailureStruct[]
    Arrays of structures containing information on offers that fail to end.
    1. finishItemId | Long
      Offer identifier.
    2. finishErrorCode | String | required
      Error code indicating a reason of the failure.
    3. finishErrorMessage | String | required
      Error message describing a reason of the failure.
  • ERR_BLOCKED_USER_CANT_INVOKE_METHOD
    User's account is blocked.
  • ERR_GIVE_CANCEL_BIDS_REASON
    If an offer is to be ended with a bid cancellation, then the reason of cancellation is required.
  • ERR_INPUT_ARRAY_EMPTY
    Array of structures containing information required to end offers is empty.
  • ERR_ITEMS_ARRAY_OVERSIZED
    Array of structures containing information required to end offers exceeds the acceptable limit (max. 25).
  • ERR_NO_DATABASE
    Problems with Allegro database.
  • ERR_NO_SESSION / ERR_SESSION_EXPIRED
    Invalid session identifier or the session has expired.
  • ERR_WEBAPI_KEY_INACTIVE
    The session-generating WebAPI key has been deactivated (the owner did not accept the User Agreement).
  • ERR_WEBAPI_NOT_AVAIL
    Problems with Aukro WebAPI service.
  • ERR_YOU_CANT_CHANGE_ITEM
    You cannot edit the offer because the queue contains an unexecuted operation of editing this offer.