23.10.2015

Release notes for version 1.1
=============================

* https://api.huuto.net/1.1/


Creating a new item
-------------------

.. http: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
----------------

.. http:put:: /1.0/items/{itemid}

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


Item resource
-------------

.. http: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"