Skip to main content
POST
/
price-list-items
Create price list item
curl --request POST \
  --url https://app.fintoro.sk/api/public/v1/price-list-items \
  --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.

Headers

​
Idempotency-Key
string

Optional request identifier for safe retries. Use a unique value for each create request you want to retry safely.

Example:

"invoice-create-2026-03-03-001"

Body

application/json

Payload for creating a price list or warehouse item. The required business fields are always name, unitPrice, unitId, and vatRate. When you send useWarehouse: true, warehouseCode becomes required.

​
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 created.

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