Aukro WebAPI

doChangeItemFields

This method allows for comprehensive offer editing both listed and planned to be listed. In order to add elements to the offer or change them, you need to pass data of selected fields of the fieldsToModify structure. To remove elements you need to pass data of selected fields of the fieldsToRemove structure. A list of fields available in the offer can be loaded by using the doGetItemFields method. When bids appear majority of fields is blocked to changes (e.g. description). In such case you can add an additional description in the fid: 25. This method allows for editing the offer and simulating it – the previewOnly field sets the method's mechanics.

  1. sessionId | String | required
    User's session identifier received using the doLogin(Enc) method.
  2. itemId | Long | required
    Identifier of an offer to be changed. The offer may be ongoing or planned to be listed.
  3. fieldsToModify | FieldsValue[]
    Array of structures containing information on sale form fields that are to be changed or added.
    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.
  4. fieldsToRemove | Integer[]
    Array of field identifiers (fids) that are to be removed.
  5. previewOnly | Integer
    Information on method mechanics (0 - real change of an offer, 1 - simulation of changing an offer; 0 is set by default).
  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[]
    Struktura zawierająca informacje o tagach uzupełniających dane przedmiotu wystawianego dla Strefy Marek. Możliwość tagowania ofert posiadają wyłącznie sprzedawcy ze Strefy Marek. Maksymalnie do oferty można dodać 10 tagów.
    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. changedItem | ChangedItemStruct | required
    Structure containing information about a changed offer.
    1. itemId | Long
      Offer identifier.
    2. itemFields | FieldsValue[]
      Array of structures containing information about values of fields.
      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. itemSurcharge | ItemSurchargeStruct[]
      Array of structures of fees charged for a changed offer.
      1. surchargeDescription | String | required
        Full description of a fee.
      2. surchargeAmount | AmountStruct | required
        Structure of fee amounts for a changed offer.
        1. amountValue | BigDecimal | required
          Fee amount.
        2. amountCurrencySign | String | required
          Mark of a currency in which money is returned.
  • 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_BLOCKED_USER_CANT_INVOKE_METHOD
    User's account is blocked.
  • ERR_BOLD_RATING_TOO_LOW
    Insufficient feedback score to use the 'Boldface' option.
  • ERR_BRAND_ZONE_SERVICE_IS_UNAVAILABLE
    Błąd podczas weryfikacji, czy użytkownik jest dostępny w usłudze Strefy Marek ((podczas tworzenia oferty jako StrefaMarek).
  • 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_CANNOT_CHANGE_ITEM_FULFILLMENT_TIME
    You cannot change time of delivery because of existing bids.
  • ERR_CANT_CHANGE_BANK_ACCOUNTS_AFTER_BID
    You cannot change numbers of bank account because of existing bids.
  • ERR_CANT_CHANGE_CATEGORY_AFTER_BID
    You cannot change numbers of bank account because of existing bids.
  • ERR_CANT_CHANGE_CATEGORY_AFTER_12_HOURS
    You cannot change numbers of bank account because of existing bids.
  • ERR_CANT_CHANGE_EAN_CODE_AFTER_BID
    You cannot change EAN code because of existing bids.
  • ERR_CANT_CHANGE_INVOICE_SETTINGS_AFTER_BID
    You cannot change the 'I issue VAT invoices' because of existing bids.
  • ERR_CANT_CHANGE_ITEM_ATTRIBS_AFTER_BID
    You cannot change attributes because of existing bids.
  • ERR_CANT_CHANGE_ITEM_DESCRIPTION_AFTER_BID
    You cannot change auction description because of existing bids.
  • ERR_CANT_CHANGE_POSTPONING_END_AFTER_BID
    You cannot change auction postponing end because of existing bids or deals.
  • ERR_CANT_CHANGE_ITEM_LOCATION_AFTER_BID
    You cannot change auction description because of existing bids.
  • ERR_CANT_CHANGE_ITEM_POSTCODE_AFTER_BID
    You cannot change postal code of item location because of existing bids.
  • ERR_CANT_CHANGE_ITEM_PROLONG_FOR_SM_LISTED_ITEM
    You cannot change settings of offer auto-relisting for offers listed from the Sales Manager.
  • ERR_CANT_CHANGE_ITEM_PROLONG_ONCE_SELECTED
    You cannot change offer auto-relisting option if it has been enabled in the offer earlier.
  • ERR_CANT_CHANGE_ITEM_QUANTITY_FOR_ITEM_AFTER_BID
    You cannot change number of items because of existing bids.
  • ERR_CANT_CHANGE_ITEM_SELECTED_COUNTRY_AFTER_BID
    You cannot change the country of an item location because of existing bids.
  • ERR_CANT_CHANGE_ITEM_STARTING_TIME_OR_DURATION
    You cannot change the start date of offer or its duration time while editing the offer.
  • ERR_CANT_CHANGE_ITEM_STATE_AFTER_BID
    You cannot change the province of an item location because of existing bids.
  • ERR_CANT_CHANGE_ITEM_TYPE_AFTER_BID
    You cannot change offer type because of existing bids.
  • ERR_CANT_CHANGE_ITEM_TYPE_FOR_SHOP_ITEM
    You cannot change sale format for the shop offer.
  • ERR_CANT_CHANGE_PAYMENT_OPTIONS_AFTER_BID
    You cannot change payment method because of existing bids.
  • ERR_CANT_CHANGE_POSTAGE_OPTIONS_AFTER_BID
    You cannot change delivery method because of existing bids.
  • ERR_CANT_CHANGE_PRODUCTS_CAT_ID_AFTER_BID
    You cannot change relation of the offer with the Product Catalogue because of existing bids.
  • ERR_CANT_CHANGE_QUANTITY_TYPE_AFTER_BID
    You cannot change type of items number because of existing bids.
  • ERR_CANT_CHANGE_RESERVE_PRICE_AFTER_BID
    You cannot change the reserve price because of existing bids.
  • ERR_CANT_CHANGE_SHOW_BANK_ACCOUNT_SETTING_AFTER_BID
    You cannot change the 'Show bank account number in description' option because of existing bids.
  • ERR_CANT_CHANGE_STARTING_PRICE_AFTER_BID
    You cannot change the starting price because of existing bids.
  • ERR_CANT_CHANGE_TRANSPORT_SHIPMENT_DESCRIPTION_AFTER_BID
    You cannot change additional description because of existing bids.
  • ERR_CANT_SET_LIGHT_DESCRIPTION_FOR_ITEM_WITHOUT_BIDS
    You cannot add an additional memo to description of an offer without bids.
  • ERR_CANT_UNSET_BOLD_ONCE_SELECTED
    You cannot disable boldface while editing.
  • ERR_CANT_UNSET_CATPAGE_ONCE_SELECTED
    You cannot disable featuring on the category page while editing.
  • ERR_CANT_UNSET_FEATURE_ONCE_SELECTED
    You cannot disable featuring while editing.
  • ERR_CANT_UNSET_HIGHLIGHT_ONCE_SELECTED
    You cannot disable highlighting while editing.
  • ERR_CANT_UNSET_LISTING_THUMB_ONCE_SELECTED
    You cannot disable thumbnail while editing.
  • ERR_CANT_UNSET_MAINPAGE_ONCE_SELECTED
    You cannot disable featuring on the main page while editing.
  • ERR_CANT_UNSET_MAINPAGE_ONCE_SELECTED
    You cannot disable featuring on the main page while editing.
  • ERR_CANT_UNSET_PHOTOS_MARKED_ONCE_SELECTED
    You cannot disable watermark while editing.
  • ERR_CANT_UNSET_SHOWITEMPAGE_ONCE_SELECTED
    You cannot disable featuring of the offer on the item page while editing the offer.
  • 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_COUPON_NO_COMPANY
    A user without the Company status cannot list the offer in the 'Coupons' category.
  • 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_DEPENDENT_PARAMETERS
    Values of dependent parameters passed incorrectly.
  • 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_FEA_HLI_BOLD_NOT_ENOUGH_MONEY
    Not enough funds to buy the Feature and Highlight package (relates to Ukraine).
  • 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_FUTURE_ITEM_ALREADY_LISTED
    Edited offer planned to be listed has been already listed.
  • ERR_HIGHLIGHT_RATING_TOO_LOW
    'Highlight' option cannot be set due to too low feedback score.
  • 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_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_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_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_CATEGORIES
    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_MISSING_VARIANTS
    You need to provide the quantity of each variant in offers supporting many variants.
  • ERR_MULTI_ITEM_AND_BUYNOW_AND_STARTING
    For multi-item offers you need to select Buy it Now! price or startig price (but not both).
  • ERR_NO_SESSION / ERR_SESSION_EXPIRED
    Invalid session identifier or the session has expired.
  • ERR_NO_PREPAID_PAYMENT
    You need to select an appropriate payment method for selected prepayment options.
  • 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_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_PRODUCTS_CATEGORY_NOT_AVAILABLE
    It is impossible to relate the offer with the Product Catalogue in this category.
  • ERR_RESERVE_LESS_THAN_STARTING_PRICE
    The reserve price cannot be lower than the starting price.
  • 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_SHIPMENT_DESCRIPTION_REQUIRED
    After showing willingness to add extra information on delivery and payment, it is required to provide its content.
  • ERR_SHOPS_SETTINGS_INVALID_TAGS
    Przekazano nieprawidłowe tagi (podczas tworzenia oferty jako StrefaMarek).
  • ERR_SHOPS_SETTINGS_TAGS_COUNT_LIMIT_EXCEEDED
    Przekroczono limit liczby tagów - maksymalnie 10 tagów w ofercie (podczas tworzenia oferty jako StrefaMarek).
  • 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_SHOW_ITEM_PAGE_AND_NO_PHOTO
    No photo for a featured offer on the item page.
  • 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_TRANSPORT_SHIPMENT_DESCRIPTION_TOO_LONG
    Acceptable size of a field with additional information on delivery and payment has been exceeded (max. 500 characters).
  • ERR_UNKNOWN_FEATURE
    Nie możesz dodać tagów do oferty jeśli nie jesteś sprzedającym ze Strefy Marek.
  • 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_WORD_IN_ITEM_NAME_TOO_LONG
    Acceptable length of a single word in the offer title has been exceeded (30 characters).
  • ERR_YOU_CANT_CHANGE_ITEM
    You cannot edit the offer because the queue contains an unexecuted operation of editing this offer.
  • 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 incorrect
  • 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.