# Price lists

Price lists are used for setting up different prices for products for
different customer groups.

## List of price lists

 - [GET /api/pricelists](https://api.docs.shoptet.com/shoptet-api/openapi/price-lists/getlistofpricelists.md): Listing of all price lists set up in e-shop. Does not contain the
paging, always lists all price lists.

## Pricelist insertion

 - [POST /api/pricelists](https://api.docs.shoptet.com/shoptet-api/openapi/price-lists/createpricelist.md)

## Pricelist detail

 - [GET /api/pricelists/{id}](https://api.docs.shoptet.com/shoptet-api/openapi/price-lists/getpricelistdetail.md): Price list detail with product prices (variants) and info on discounts and limitations of purchase (minimum and maximum price)

## Update pricelist

 - [PATCH /api/pricelists/{id}](https://api.docs.shoptet.com/shoptet-api/openapi/price-lists/updatepricelist.md): This endpoint allows updating price fields and other attributes from a
pricelist of a product (variant).

You can request multiple updates at once; the maximum is 300 updates per
request.

The request must contain a product variant code  and at least one
of the ,
 , ,  or  objects.

Send only fields you want to change, the others will stay untouched. Be
aware of the difference between


- not providing a field: the field will not be changed


- providing e. g.  will remove the price


In case the request will be properly formatted, but an error occurs for
one of the records, the correct records

will be updated, the response will be  and there will be records
in the  array for each failed

record. If all records are incorrect, the response code will be  instead.


If you set  or  field, current data for product
(or variant) will be recalculated. (even through untouched by your
request)

Object  directly sets price of product, without recalculating.

Object  sets price of product, respecting it is price
 VAT and thus recalculating if needed.

Object  sets price of product, respecting it is price
 VAT and thus recalculating if needed.


Note, that you can change  only for default price list! For
others price lists, value stays .


For non-vat payer e-shops,  and  fields are
forbidden to use and fields ,  and


all works the same.

In order to change the currency of the prices, you will need to have the Currencies module (Cizí měny) activated on the customer's e-shop.
Note that if you change the currency code of the price list, all prices will not be recalculated to the new currency; only the currency code will be changed.

## Pricelist delete

 - [DELETE /api/pricelists/{id}](https://api.docs.shoptet.com/shoptet-api/openapi/price-lists/deletepricelist.md): Deletion of pricelist can fail with error  in case of running
import.

## List of all price list details

 - [GET /api/pricelists/{id}/snapshot](https://api.docs.shoptet.com/shoptet-api/openapi/price-lists/getlistofallpricelistdetails.md): Using this endpoint, you can get list of all price list details with information on each price 
(like in Price list Detail endpoint) asynchronously. See how 
Asynchronous requests work on our developer’s portal.


Response will be in jsonlines format with each product taking one line of output file.
One price list in response has the same format as price list detail response.


Result file is compressed using GZIP.