Aukro WebAPI

doNewAuctionExt

This method allows for listing a new offer. In order to verify the new offer you need to assign it a local identifier (localId) and then check the offer using the doVerifyItem method (localId value is always unique within a given user account). To test whether sale form fields are filled out correctly and/or check costs of listing the offer but without actually doing it, you need to use the doCheckNewAuctionExt method. To list an offer including more than one variant, transfer the fid of a parameter that supports variants in variants. Besides, transfer via quantities the mask (mask field) that reflects variant and quantity listed within the variant (quantity field). The sum of all variants will match the quantity listed within the offer. However, remember that transferring proper parameter and providing available quantity does not mean that you do not have to include this information in fields. If the quantity provided in quantities and fid 5 does not match, the system will take the value provided in the array.

  1. sessionHandle | String | required
    User's session identifier received using the doLogin(Enc) method.
  2. fields | FieldsValue[] | required
    Array of structures containing information on sale form fields (their list can be loaded by using the doGetSellFormFieldsExt(Limit) method. When an identifier of a particular field is passed in the fid field, you need to send its value in an appropriate for its type fvalue field and pass empty string of characters [string] - sending 0 (numeric types) or logical value 'false' [boolean] in other fvalue fields. Pass only required or desirable fieds.
    1. fid | Integer
      Field identifier.
    2. fvalueString | String
      Value of field for a text type.
    3. fvalueInt | Integer
      Value of field for integers.
    4. fvalueFloat | BigDecimal
      Value of field for floating-point numbers.
    5. fvalueImage | Byte[]
      Value of field for graphic files.
    6. fvalueDatetime | BigDecimal
      Value of field for dates and time (Unix time).
    7. fvalueDate | String
      Value of field for dates (dd-mm-yyyy).
    8. fvalueRangeInt | RangeIntValueStruct
      Value of field for integers of range type.
      1. fvalueRangeIntMin | Integer
        Initial value of the parameter value scope.
      2. fvalueRangeIntMax | Integer
        Final value of the parameter value scope.
    9. fvalueRangeFloat | RangeFloatValueStruct
      Value of field for integers of range type.
      1. fvalueRangeFloatMin | BigDecimal
        Initial value of the parameter value scope.
      2. fvalueRangeFloatMax | BigDecimal
        Final value of the parameter value scope.
    10. fvalueRangeDate | RangeDateValueStruct
      Value of field for dates of range type.
      1. fvalueRangeDateMin | String
        Initial value of the parameter value scope.
      2. fvalueRangeDateMax | String
        Final value of the parameter value scope.
  3. itemTemplateId | Integer
    Offer template identifier (when correct identifier is provided, filling out the fields structure is not required; in such case passing single values in the fields structure will overwrite values from the template but without changing the template; if itemTemplateOption is set to 1 it is possible to create new template on a basis of already existing one and fields passed in the fields structure).
  4. localId | Integer
    Value of a local identifier that can be additionally assigned to an offer (scope: 1-9999999999999). Local identifiers are valid until transferring related offers to archive.
  5. itemTemplateCreate | ItemTemplateCreateStruct
    Structure containing information on an offer saved as a template.
    1. itemTemplateOption | Integer
      Information on whether the offer should be saved as a template (1 - yes, 0 - no; default value is 0).
    2. itemTemplateName | String | required
      Offer template name (max. 50 characters; if the name is not provided and itemTemplateOption is set to 1, value passed in fid=1 [Item name] will be placed as the template name).
  6. variants | VariantStruct[]
    This structure includes information on item variants available within the listed offer.
    1. fid | Integer
      ID of a parameter field where variants can be defined.
    2. quantities | VariantQuantityStruct[]
      Array of structures containing information on item variant quantity.
      1. mask | Integer
        Mask corresponding to the selected variant. Their values are available in data returned by doGetSellFormFieldsExt in sellFormOptsValues field.
      2. quantity | Integer
        Quantity of selected item variant.
  7. tags | TagNameStruct[]
    ?
    1. tagName | String | required
      Nazwa taga przypisywanego do wystawianej oferty. Tagi są przypisane do sprzedającego oraz są widoczne w polu "Podkategorie" na liście ofert sprzedającego. Nowe tagi zostają automatycznie dodawane do listy tagów.
  1. itemId | Long
    Listed offer identifier.
  2. itemInfo | String | required
    Information on costs related to listing an offer.
  3. itemIsAllegroStandard | Integer
    Information whether an offer is marked as Standard Allegro [PL]/Aukro Plus [CZ]/Super Offer [UA/KZ] (1 - yes, 0 - no).
  • ERR_ALCOHOL_NO_COMPANY
    In order to list offers in Wine category you must have the Company account.
  • ERR_ALCOHOL_NOT_ACTIVE
    In order to list offers in Wine category you must have active Alcohol status.
  • ERR_AUCTION_TYPE_NOT_EXISTS
    You cannot list multi-item auction or restrictions not allowing for listing multi-item auctions are imposed on the given category.
  • ERR_BAD_PICTURE_FORMAT
    Incorrect photo format (allowed formats: GIF, JPG, PNG).
  • ERR_BLOCK_SELL_SELL
    User with blocked possibility of sale on his account cannot list new offers.
  • ERR_BLOCK_SELL_COMPANY_INFO
    User with blocked Company sign cannot list new offers.
  • ERR_BLOCKED_USER_CANT_INVOKE_METHOD
    User's account is blocked.
  • ERR_BUY_NOW_LESS_THAN_RESERVE_PRICE
    The Buy it Now! price cannot be lower than the reserve price.
  • ERR_BUY_NOW_LESS_THAN_STARTING_PRICE
    The Buy it Now! price cannot be lower than the starting price.
  • ERR_CANT_SET_LIGHT_DESCRIPTION_FOR_ITEM_WITHOUT_BIDS
    It is impossible to add additional memo to offer description while listing.
  • ERR_CATEGORY_NOT_FOUND
    No category identifier, identifier is incorrect or it is not the lowest-level category.
  • ERR_CATEGORY_PAGE_AND_NO_PHOTO
    In order to use option of featuring the offer on a selected category site, you need to add at least one photo.
  • ERR_CATEGORY_PAGE_NOT_ENOUGH_MONEY
    It is impossible to feature the offer on the category page due to insufficient funds on an account required to make a payment in advance (relating to the Czech Republic).
  • ERR_CATEGORY_PAGE_RATING_TOO_LOW
    It is impossible to feature the offer on a category site due to too low user score (at least 5 points).
  • ERR_CONVERSION_ERROR
    Errors while converting photos.
  • ERR_DEBT_NO_EXTRAS
    Balance account is too low to list an offer (relating to Ukraine and Bulgaria).
  • ERR_DEPARTMENT_PAGE_RATING_TOO_LOW
    It is impossible to feature offer on a department site due to too low user score (at least 5 points).
  • ERR_DESC_TOO_LONG_INFO
    The maximum acceptable size of offer description (250 kB) has been exceeded.
  • ERR_DESCRIPTION_NOT_FOUND
    No offer description.
  • ERR_EAN_CODE_NOT_AVAILABLE
    It is impossible to provide EAN code in this category.
  • ERR_EXPLICIT_CONTENT_WARN
    It is impossible to use certain options in case of selling an item in this category.
  • ERR_FEATURED_NOT_ACTIVATED
    'Feature' option cannot be set due to no full account activation (relates to Russia).
  • ERR_FEATURED_RATING_TOO_LOW
    'Feature' option cannot be set due to too low user score (relates to Russia).
  • ERR_FULFILLMENT_TIME_NOT_AVAILABLE_FOR_CATEGORY
    The Delivery time option is unavailable for the selected category.
  • ERR_IF_YOU_WANNA_SELL
    User without full account activation cannot list auctions.
  • ERR_INCORRECT_ITEM_TEMPLATE_ID
    Incorrect (not existing in a context of a logged-in user) identifier of an offer template.
  • ERR_INCORRECT_ITEM_TEMPLATE_NAME
    Incorrect (too long, with forbidden characters) name of an offer template.
  • ERR_INPUT_COUNTRY_ERROR
    No/incorrect country code.
  • ERR_INVALID_BUY_NOW_PRICE
    Incorrect value of Buy it Now! price (min. 1 CZK).
  • ERR_INVALID_DURATION_TIME
    Incorrect value of a field setting the offer's duration time.
  • ERR_INVALID_EAN_CODE
    Incorrect EAN code.
  • ERR_INVALID_FIRST_BANK_ACCOUNT_FORMAT
    Incorrect format of the first bank account number (acceptable format: 26 numbers written together or separated by space or hyphens).
  • ERR_INVALID_PARAM_AUCTION_TYPE
    Incorrect value of a field describing the sale format.
  • ERR_INVALID_PARAM_SELL_BY_SET
    Incorrect value of a field setting the number of items/sets/pairs.
  • ERR_INVALID_PARAM_SHOP_PROLONG
    Incorrect value of a field setting automatic offer relisting in a shop.
  • ERR_INVALID_POSTCODE_FORMAT
    Invalid postal code format (acceptable format: 5 numbers in form of xx-xxx).
  • ERR_INVALID_PRODUCTS_CATALOGUE
    Invalid product identifier.
  • ERR_INVALID_QUANTITY
    Incorrect value of a field describing the number of items (acceptable range: 1-999).
  • ERR_INVALID_RESERVE_PRICE
    Incorrect value of a reserve price.
  • ERR_INVALID_SECOND_BANK_ACCOUNT_FORMAT
    Incorrect format of the second bank account number (acceptable format: 26 numbers written together or separated by space or hyphens).
  • ERR_INVALID_STARTING_PRICE
    Incorrect value of a starting price (min. 1 CZK).
  • ERR_INVALID_STATE
    Incorrect value of a field describing the province.
  • ERR_INVALID_VALUE_IN_ATTRIB_FIELD
    Incorrect transfer of structure parameters (e.g. non-existing sale form field has been passed).
  • ERR_INVALID_VALUE_IN_LOCAL_ID
    Incorrect value of a local identifier (acceptable range: 1-9999999999999).
  • ERR_ITEM_NAME_NOT_FOUND
    No offer title.
  • ERR_ITEM_NAME_TOO_LONG
    Acceptable length of offer title has been exceeded (50 characters assuming that some symbols are counted as more than 1 character: < and > - 4 characters, & - 5 characters, " - 6 characters).
  • ERR_ITEM_TEMPLATES_LIMIT_EXCEEDED
    Maximum number (10) of saved offer templates has been exceeded. In order to save new one you need to delete one of the already existing.
  • ERR_JUNIOR_CANT_BID_LIST_IN_THIS_CATEGORY
    User of a Junior account cannot list an offer in the selected category (restrictions concern the following categories: Real estate, Cars, Motorcycles, Other vehicles and boats, Tobacco, Weapon, Air rifles, Erotica).
  • ERR_JUNIOR_LIMIT_EXCEEDED
    Limit of 50 PLN for listing offers imposed on Junior account users has been exceeded.
  • ERR_LIST_THUMB_AND_NO_PHOTO
    In order to use the thumbnail option, you need to upload at least one photo.
  • ERR_LOCATION_NOT_FOUND
    No item location (city).
  • ERR_LOCATION_TOO_LONG
    Acceptable length of a city name has been exceeded (40 characters).
  • ERR_MAIN_AND_CATEGORY_PAGE_NOT_ENOUGH_MONEY
    It is impossible to feature an offer on the main page or the category page due to insufficient funds on an account required to make a payment in advance (relates to the Czech Republic).
  • ERR_MAIN_PAGE_INCORRECT_CATEGORY
    The 'Featuring on the main page' option cannot be set for the selected category.
  • ERR_MAIN_PAGE_NOT_ENOUGH_MONEY
    It is impossible to feature an offer on the main page due to insufficient funds on an account required to make a payment in advance (relates to the Czech Republic).
  • ERR_MAIN_PAGE_RATING_TOO_LOW
    It is impossible to feature an offer on a main page due to too low user score (at least 10 points)..
  • ERR_MULTI_ITEM_AND_BUYNOW_AND_STARTING
    For multi-item offers you need to select Buy it Now! price or starting price (but not both).
  • ERR_NO_DATABASE
    Problems with Allegro database.
  • ERR_NO_ON_DELIVERY_PAYMENT
    You need to select an appropriate payment method for selected COD options.
  • ERR_NO_PREPAID_PAYMENT
    You need to select an appropriate payment method for selected prepayment options.
  • ERR_NO_SESSION / ERR_SESSION_EXPIRED
    Invalid session identifier or the session has expired.
  • ERR_NO_STARTING_AND_BUY_NOW_PRICE
    Please provide missing price types (starting price and/or Buy it Now!).
  • ERR_NOT_ALLOWED_CHARS_IN_ITEM_NAME_OFFLINER
    Incorrect characters in auction's title. All the characters must be present in the alphabet used in a country of a logged-in user.
  • ERR_NOT_ENOUGH_MONEY_TO_SELL
    Account balance is too low to list an offer with paid 'Featuring' options (the Czech Republic and Russia)..
  • ERR_OBLIGATORY_ATTRIB_NOT_SET
    Required parameter for this category is missing.
  • ERR_OTHER_PHOTO_ERROR
    An error occurred during the photo upload. Please refer to the error message for more details.
  • ERR_PAY_FORM_NOT_SELECTED
    Payment method is missing.
  • ERR_PAYS_SHIPPING_NOT_SELECTED
    No value in a field describing who pays transportation costs.
  • ERR_PHARMACY_NO_COMPANY
    In order to list offers in the OTC drugs category you must have the Company account.
  • ERR_PHARMACY_NOT_ACTIVE
    In order to list offers in the OTC drugs category you must have active Pharmacy status.
  • ERR_PHARMACY_NOT_ALLOWED_AUCTION_TYPE
    In the OTC drugs category only Buy it Now! offers can be listed.
  • ERR_PHARMACY_REQUIREMENTS_NOT_MET
    In order to list offers in the OTC drugs category you must take part in the Aukro+ programme and listed items cannot be in other condition than new (the Czech Republic).
  • ERR_PHOTO_TOO_LARGE
    Maximum image resolution (26 Mpix) has been exceeded.
  • ERR_POSTAGE_OPTIONS_ERROR
    Please provide at least one delivery method.
  • ERR_POSTAGE_OPTIONS_VALUES_INCORRECT
    Incorrect delivery costs (you need to provide the cost in all three fields: first item, next item, number of items in parcel – or only for one item).
  • ERR_POSTAGE_VALUES_SELLER_PAYMENT
    It is impossible to provide price for delivery higher than 0 when the seller pays for it.
  • ERR_POSTAL_CODE_EMPTY_ERROR
    Postal code is missing.
  • ERR_PRODUCT_CATALOGUE_FOTO_NOT_ENABLED
    To attach a photo taken from the Product Catalogue to the offer, it must be related to the product.
  • ERR_RESERVE_LESS_THAN_STARTING_PRICE
    The reserve price cannot be lower than the starting price.
  • ERR_RESERVED_PRICE_NOT_ALLOWED
    Reserve price in forbidden for offer of that type.
  • ERR_RESERVED_PRICE_RATING_TOO_LOW
    It is impossible to set the reserve price due to too low user score (relates to Russia and Ukraine).
  • ERR_SELECT_PHOTO
    No photo data.
  • ERR_SELL_NOT_ALLOWED
    User cannot list offers in this country.
  • ERR_SHIPMENT_DESCRIPTION_REQUIRED
    After showing willingness to add extra information on delivery and payment, it is required to provide its content.
  • ERR_SHOP_BUY_NOW_PRICE_ERROR
    Offer listed in Allegro Shop must have the Buy it Now! price.
  • ERR_SHOP_CANT_LIST_IN_THIS_COUNTRY
    User has no active Allegro Shop or cannot list shop offers in this country.
  • ERR_SHOP_CATEGORY_NOT_FOUND
    Incorrect value of a shop category identifier (information on shop categories of a logged-in user can be loaded by using the doGetShopCatsData method).
  • ERR_SHOP_NOT_ALLOWED_CATS
    You cannot list in Allegro Shop offers from the selected categories (refers only to following categories: Real Estate, Cars, Motorcycles, Other vehicles and boats, Holidays).
  • ERR_SHOP_NOT_ALLOWED_OPTIONS
    For offers listed in Allegro Shop it is impossible to set featuring offers on a main page, category page or featuring offers on a list of categories.
  • ERR_SHOP_PRIVATE_AUCTION_ERROR
    Private offer cannot be listed in Allegro Shop (relates to Ukraine).
  • ERR_SHOP_STARTING_PRICE_ERROR
    Offer listed in Allegro Shop cannot have a starting price.
  • ERR_SOME_ITEMS_AND_RESERVE_PRICE
    Reserve price is forbidden for multi-item offers.
  • ERR_TICKETS_AND_AUCTION
    Tickets for artistic, entertainment or sport event must have the Buy it Now! price.
  • ERR_TOO_DISTANT_FUTURE
    Incorrect (too distant future) date of offer's start (max. 30 days ahead).
  • ERR_TOO_MANY_FUTURE_AT_THIS_TIME
    The general limit of offers scheduled for listing (1000) in a selected 5-minute pool has been exceeded.
  • ERR_TOO_MANY_ITEMS
    The number of offers listed by a user without full account activation has been exceeded (relating to Russia).
  • ERR_TRANSPORT_SHIPMENT_DESCRIPTION_TOO_LONG
    Acceptable size of a field with additional information on delivery and payment has been exceeded (max. 500 characters).
  • ERR_VARIANTS_CORRELATION_FAILED_ATTRIBUTE_NOT_FOUND
    Provided mask (variant) does not match the transferred parameter.
  • ERR_VARIANTS_CORRELATION_FAILED_INCORRECT_VARIANT_VALUES
    Incorrect mask (variant) or quantity provided for the transferred parameter.
  • 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_WORD_IN_ITEM_NAME_TOO_LONG
    Acceptable length of a single word in the offer title has been exceeded (30 characters).
  • ERR_YOU_HAVE_TO_ACTIVE_CODE
    User without active sale code cannot list offers.
  • ERR_AFTER_SALES_SERVICE_CONDITIONS_OWNED_BY_SELLER
    Provided offer condition is not assigned to logged on user
  • ERR_REFERENCED_VALUE_NOT_EXISTS
    Provided condition ID (uuid) does not exist
  • ERR_STANDARDIZED_DESCRIPTION_INCORRECT
    Provided offer description in FID 341 id empty or given item description is marked as compatible with new item description editor but its content has not valid strucutre.
  • ERR_PHOTO_COUNT_TOO_HIGH
    You send too many images, e.g. when you want to list an offer with 16 images using a standard account.