23.10.2015
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”.