Release notes for version 1.1

Creating a new item

POST /1.1/items/
  • mainCategoryId, sectionCategoryId and subCategoryId fields are removed. Instead of subCategoryId, api now expects categoryId. categoryId (like subCategoryId) is the 3rd (and last) level of Huuto’s category hierarchy.

  • condition options: none condition was removed.

  • Valid deliveryMethods are now pickup (nouto) and shipment (toimitus). Removed “itella”, “matkahuolto”, “fetch”, “huutopaketti”, “other”.

  • termsOfDelivery field was renamed to deliveryTerms.

  • Valid paymentMethods are now “wire-transfer” (tilisiirto) and “cash” (käteinen). Removed “credit-transfer”, “cash-on-delivery” and payson options.

  • paymentTerms field was added for payment terms description. String, max. 1000 chars.

  • location field can not be posted anymore. Instead postalCode is by default mandatory, and location will be automatically set by the backend using given postalCode. However, if isLocationAbroad is set to 1, location will be automatically set to “Ulkomaat”. (More about this below.)

  • postalCode is now by default mandatory. However, if isLocationAbroad is set to 1, postal code will be set to null.

  • isLocationAbroad field was added. Int (0 or 1). Is used to tell if item is located outside of Finland or not. Optional, default 0 (no). Note: If set to 1, postalCode is not required.

  • Removed “hybrid” for saleMethod options. Valid options are now “auction” and “buy-now”.

  • taxPercentage field was renamed to vat.

  • minimumPrice (aka. reserve price / hintavaraus) field was removed.

  • originalId (int) field was added. It can be used to easily republish an old, closed item created by the seller. Title, description, sell method, price, images and other relevant data will get copied from the previous into a newly created item, which will have a “draft” status by default. To publish it, its status must be updated to “preview” and after that, to “published”.

Updating an item

PUT /1.0/items/{itemid}

All above changes (except originalId, of course) are valid for item updating via put method, too.

Item resource

GET /1.1/items/{itemid}
  • “termsOfDelivery” field was renamed to “deliveryTerms”.

  • “paymentTerms” field was added.

  • “taxPercentage” field was renamed to “vat”.

  • “subCategory” object was renamed to “category”