Update price list item

PUT

price-list-items

{priceListItem}

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
}
'

import requests

url = "https://app.fintoro.sk/api/public/v1/price-list-items/{priceListItem}"

payload = {
    "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
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.put(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'PUT',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    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
  })
};

fetch('https://app.fintoro.sk/api/public/v1/price-list-items/{priceListItem}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://app.fintoro.sk/api/public/v1/price-list-items/{priceListItem}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "PUT",
  CURLOPT_POSTFIELDS => json_encode([
    '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
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://app.fintoro.sk/api/public/v1/price-list-items/{priceListItem}"

	payload := strings.NewReader("{\n  \"name\": \"Service package\",\n  \"unitPrice\": 129.9,\n  \"unitId\": 1,\n  \"vatRate\": 20,\n  \"description\": \"Monthly service and support\",\n  \"ean\": \"8586012345678\",\n  \"useWarehouse\": true,\n  \"warehouseCode\": \"SKU-PUBLIC-001\",\n  \"enableNegativeStock\": false,\n  \"maxStock\": 250,\n  \"purchasePrice\": 89.5,\n  \"purchaseVatRate\": 20\n}")

	req, _ := http.NewRequest("PUT", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.put("https://app.fintoro.sk/api/public/v1/price-list-items/{priceListItem}")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"name\": \"Service package\",\n  \"unitPrice\": 129.9,\n  \"unitId\": 1,\n  \"vatRate\": 20,\n  \"description\": \"Monthly service and support\",\n  \"ean\": \"8586012345678\",\n  \"useWarehouse\": true,\n  \"warehouseCode\": \"SKU-PUBLIC-001\",\n  \"enableNegativeStock\": false,\n  \"maxStock\": 250,\n  \"purchasePrice\": 89.5,\n  \"purchaseVatRate\": 20\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://app.fintoro.sk/api/public/v1/price-list-items/{priceListItem}")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Put.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"name\": \"Service package\",\n  \"unitPrice\": 129.9,\n  \"unitId\": 1,\n  \"vatRate\": 20,\n  \"description\": \"Monthly service and support\",\n  \"ean\": \"8586012345678\",\n  \"useWarehouse\": true,\n  \"warehouseCode\": \"SKU-PUBLIC-001\",\n  \"enableNegativeStock\": false,\n  \"maxStock\": 250,\n  \"purchasePrice\": 89.5,\n  \"purchaseVatRate\": 20\n}"

response = http.request(request)
puts response.read_body

{
  "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
}

{
  "message": "This action is unauthorized."
}

{
  "message": "No query results for model."
}

{
  "message": "The given data was invalid.",
  "errors": {}
}

{
  "message": "Too Many Attempts."
}

{
  "message": "Server Error"
}

{
  "message": "Service Unavailable"
}

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 <= 100

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 <= 100

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.

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.

Show child attributes

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.

Show child attributes

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

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
}
'

import requests

url = "https://app.fintoro.sk/api/public/v1/price-list-items/{priceListItem}"

payload = {
    "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
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.put(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'PUT',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    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
  })
};

fetch('https://app.fintoro.sk/api/public/v1/price-list-items/{priceListItem}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://app.fintoro.sk/api/public/v1/price-list-items/{priceListItem}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "PUT",
  CURLOPT_POSTFIELDS => json_encode([
    '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
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://app.fintoro.sk/api/public/v1/price-list-items/{priceListItem}"

	payload := strings.NewReader("{\n  \"name\": \"Service package\",\n  \"unitPrice\": 129.9,\n  \"unitId\": 1,\n  \"vatRate\": 20,\n  \"description\": \"Monthly service and support\",\n  \"ean\": \"8586012345678\",\n  \"useWarehouse\": true,\n  \"warehouseCode\": \"SKU-PUBLIC-001\",\n  \"enableNegativeStock\": false,\n  \"maxStock\": 250,\n  \"purchasePrice\": 89.5,\n  \"purchaseVatRate\": 20\n}")

	req, _ := http.NewRequest("PUT", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.put("https://app.fintoro.sk/api/public/v1/price-list-items/{priceListItem}")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"name\": \"Service package\",\n  \"unitPrice\": 129.9,\n  \"unitId\": 1,\n  \"vatRate\": 20,\n  \"description\": \"Monthly service and support\",\n  \"ean\": \"8586012345678\",\n  \"useWarehouse\": true,\n  \"warehouseCode\": \"SKU-PUBLIC-001\",\n  \"enableNegativeStock\": false,\n  \"maxStock\": 250,\n  \"purchasePrice\": 89.5,\n  \"purchaseVatRate\": 20\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://app.fintoro.sk/api/public/v1/price-list-items/{priceListItem}")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Put.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"name\": \"Service package\",\n  \"unitPrice\": 129.9,\n  \"unitId\": 1,\n  \"vatRate\": 20,\n  \"description\": \"Monthly service and support\",\n  \"ean\": \"8586012345678\",\n  \"useWarehouse\": true,\n  \"warehouseCode\": \"SKU-PUBLIC-001\",\n  \"enableNegativeStock\": false,\n  \"maxStock\": 250,\n  \"purchasePrice\": 89.5,\n  \"purchaseVatRate\": 20\n}"

response = http.request(request)
puts response.read_body

{
  "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
}

{
  "message": "This action is unauthorized."
}

{
  "message": "No query results for model."
}

{
  "message": "The given data was invalid.",
  "errors": {}
}

{
  "message": "Too Many Attempts."
}

{
  "message": "Server Error"
}

{
  "message": "Service Unavailable"
}

Overview

Endpoints

Update price list item

Authorizations

Path Parameters

Body

Response