Skip to main content
PUT
/
price-list-items
/
{priceListItem}
Update price list item
curl --request PUT \
  --url https://app.fintoro.sk/api/public/v1/price-list-items/{priceListItem} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "Service package",
  "unitPrice": 129.9,
  "unitId": 1,
  "vatRate": 20,
  "description": "Monthly service and support",
  "ean": "8586012345678",
  "useWarehouse": true,
  "warehouseCode": "SKU-PUBLIC-001",
  "enableNegativeStock": false,
  "maxStock": 250,
  "purchasePrice": 89.5,
  "purchaseVatRate": 20
}
'
{
  "id": 701,
  "name": "Service package",
  "description": "Monthly service and support",
  "unitId": 1,
  "unit": {
    "id": 1,
    "name": "pcs"
  },
  "unitPrice": 129.9,
  "vatRate": 20,
  "unitPriceWithVat": 155.88,
  "stock": 12,
  "stocks": [
    {
      "warehouseId": 15,
      "warehouseName": "Main warehouse",
      "warehouseCode": "MAIN-WH",
      "stockQuantity": 7
    }
  ],
  "ean": "8586012345678",
  "useWarehouse": true,
  "warehouseCode": "SKU-PUBLIC-001",
  "enableNegativeStock": false,
  "maxStock": 250,
  "purchasePrice": 89.5,
  "purchaseVatRate": 20,
  "purchasePriceWithVat": 107.4
}

Authorizations

​
Authorization
string
header
required

Bearer token created for a specific company in Integrations → API.

Path Parameters

​
priceListItem
integer
required

Price list item ID.

Example:

701

Body

application/json

Payload for updating a price list or warehouse item. The Fintoro API uses a full PUT contract, so the required fields are the same as for create and omitted fields do not mean "keep the current persisted value".

​
name
string
required

Item name.

Maximum string length: 255
Example:

"Service package"

​
unitPrice
number<float>
required

Selling unit price excluding VAT.

Required range: -10000000000000 <= x <= 10000000000000
Example:

129.9

​
unitId
integer
required

Unit ID from the unit reference table.

Example:

1

​
vatRate
number<float>
required

Selling VAT rate of the item.

Required range: 0 <= x <= 23
Example:

20

​
description
string | null

Optional detailed item description.

Maximum string length: 1000
Example:

"Monthly service and support"

​
ean
string | null

Optional EAN of the item. When provided, it must be unique within the token scope.

Maximum string length: 255
Example:

"8586012345678"

​
useWarehouse
boolean
default:false

When true, the item is treated as a warehouse-tracked item.

Example:

true

​
warehouseCode
string | null

Optional warehouse card code. When you send useWarehouse: true, this field is required and must be unique within the token scope.

Maximum string length: 255
Example:

"SKU-PUBLIC-001"

​
enableNegativeStock
boolean
default:false

Indicates whether negative stock is allowed.

Example:

false

​
maxStock
number<float> | null

Optional recommended maximum stock level.

Required range: 0 <= x <= 10000000000000
Example:

250

​
purchasePrice
number<float> | null

Optional purchase price excluding VAT.

Required range: -10000000000000 <= x <= 10000000000000
Example:

89.5

​
purchaseVatRate
number<float> | null

Optional purchase VAT rate.

Required range: 0 <= x <= 23
Example:

20

Response

Price list item updated.

Price list or warehouse item. The object returns business fields that can be reused when creating documents, plus warehouse-specific settings when stock tracking is enabled for the item.

​
id
integer

Internal item ID in Fintoro.

Example:

701

​
name
string

Item name.

Example:

"Service package"

​
description
string | null

Detailed item description when it is stored on the item.

Example:

"Monthly service and support"

​
unitId
integer

Unit ID from the unit reference table.

Example:

1

​
unit
object

Item unit as a nested lookup object.

​
unitPrice
number<float>

Selling unit price excluding VAT.

Example:

129.9

​
vatRate
number<float>

VAT rate used for the selling price of the item.

Example:

20

​
unitPriceWithVat
number<float>

Selling unit price including VAT, calculated by the backend.

Example:

155.88

​
stock
number<float>

Current total stock quantity across all warehouses.

Example:

12

​
stocks
object[]

Current stock breakdown for the item by warehouse.

​
ean
string | null

Item EAN when it is tracked.

Maximum string length: 255
Example:

"8586012345678"

​
useWarehouse
boolean

Indicates whether warehouse tracking is enabled for the item.

Example:

true

​
warehouseCode
string | null

Internal warehouse card code. When warehouse tracking is enabled, it should be unique within the token scope.

Maximum string length: 255
Example:

"SKU-PUBLIC-001"

​
enableNegativeStock
boolean

Indicates whether the item allows negative stock.

Example:

false

​
maxStock
number<float> | null

Recommended maximum stock level when it is configured on the item.

Example:

250

​
purchasePrice
number<float> | null

Purchase price excluding VAT when it is stored on the item.

Example:

89.5

​
purchaseVatRate
number<float> | null

Purchase VAT rate when it is stored on the item.

Example:

20

​
purchasePriceWithVat
number<float> | null

Purchase price including VAT calculated by the backend when purchase price and VAT rate are available.

Example:

107.4