Faktúry

Upraviť faktúru

Faktúru zaradenú na odoslanie cez e-faktúru nie je možné upraviť ani vymazať. Platí to aj počas čakania na odoslanie alebo opakovania odosielania. Backend vráti 422 s chybou v errors.eInvoice. Na opravu už odoslanej faktúry použite dobropis.

Aktualizuje existujúcu faktúru.

Ako funguje update

Update používa rovnaký payload kontrakt a rovnaké defaulty ako create flow.
Musíte poslať buď clientId, alebo objekt client.
items sú povinné vždy.
Ak pole nepošlete, backend nedrží pôvodnú hodnotu z faktúry, ale vyrieši ho rovnako ako pri create flowe z payloadu, klientských predvolieb a nastavenia dokladov firmy.
Pri update položiek môžete poslať pôvodné uuid existujúcich riadkov faktúry. Tieto UUID máte k dispozícii v detaile faktúry. Backend ich používa na udržanie väzieb na skladové výdajky pri synchronizácii alokácií. Pri create flowe uuid nie je súčasťou item request kontraktu; ak ho pošlete, backend ho ignoruje a vygeneruje vlastné UUID.

Chybové stavy

422, ak explicitne pošlete clientId, ktoré neexistuje alebo nepatrí firme.
422, ak explicitne pošlete bankAccountId, ktoré neexistuje alebo nepatrí firme.
422, ak payload neprejde business validáciou, napríklad pri nevalidných položkách faktúry.

PUT

invoices

{invoice}

Upraviť faktúru

curl --request PUT \
  --url https://app.fintoro.sk/api/public/v1/invoices/{invoice} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "clientId": 101,
  "items": [
    {
      "quantity": 2,
      "priceListItemId": 501,
      "name": "Konzultácia",
      "description": "Mesačný balík konzultácií",
      "unitPrice": 100,
      "unitId": 1,
      "vatRate": 20,
      "discountType": "percentage",
      "discountValue": 10,
      "discountName": "Vernostná zľava",
      "warehouseAllocations": [
        {
          "warehouseId": 1,
          "quantity": 2
        }
      ],
      "uuid": "6b1b8c9e-66e6-4fb5-b2db-6d7c7f0f8f19"
    }
  ],
  "number": "20260001",
  "proformaId": 401,
  "orderId": 501,
  "quotationId": 601,
  "client": {
    "name": "Acme s.r.o.",
    "type": "company",
    "subjectId": "12345678",
    "taxId": "2020123456",
    "vatId": "SK2020123456",
    "isVatPayer": true,
    "email": "billing@acme.test",
    "street": "Hlavná 1",
    "city": "Bratislava",
    "zip": "81101",
    "countryId": 703,
    "hasDeliveryAddress": true,
    "deliveryStreet": "Skladová 5",
    "deliveryCity": "Trnava",
    "deliveryZip": "91701",
    "deliveryCountryId": 703
  },
  "businessCaseId": 701,
  "numericalSeriesId": 12,
  "bankAccountId": 201,
  "issueDate": "2026-03-03",
  "dueDateDays": 14,
  "deliveryDate": "2026-03-03",
  "variableSymbol": 20260001,
  "constantSymbol": 308,
  "specificSymbol": 55,
  "discountType": "percentage",
  "discountValue": 10,
  "transferTaxLiability": false,
  "deliveryMethodId": 1,
  "paymentMethodId": 1,
  "currencyId": 1,
  "currencyRate": 1,
  "languageId": 1,
  "qrTypeId": 1,
  "note": "Ďakujeme za objednávku.",
  "textAboveItems": "Dakujeme za spoluprácu."
}
'

import requests

url = "https://app.fintoro.sk/api/public/v1/invoices/{invoice}"

payload = {
    "clientId": 101,
    "items": [
        {
            "quantity": 2,
            "priceListItemId": 501,
            "name": "Konzultácia",
            "description": "Mesačný balík konzultácií",
            "unitPrice": 100,
            "unitId": 1,
            "vatRate": 20,
            "discountType": "percentage",
            "discountValue": 10,
            "discountName": "Vernostná zľava",
            "warehouseAllocations": [
                {
                    "warehouseId": 1,
                    "quantity": 2
                }
            ],
            "uuid": "6b1b8c9e-66e6-4fb5-b2db-6d7c7f0f8f19"
        }
    ],
    "number": "20260001",
    "proformaId": 401,
    "orderId": 501,
    "quotationId": 601,
    "client": {
        "name": "Acme s.r.o.",
        "type": "company",
        "subjectId": "12345678",
        "taxId": "2020123456",
        "vatId": "SK2020123456",
        "isVatPayer": True,
        "email": "billing@acme.test",
        "street": "Hlavná 1",
        "city": "Bratislava",
        "zip": "81101",
        "countryId": 703,
        "hasDeliveryAddress": True,
        "deliveryStreet": "Skladová 5",
        "deliveryCity": "Trnava",
        "deliveryZip": "91701",
        "deliveryCountryId": 703
    },
    "businessCaseId": 701,
    "numericalSeriesId": 12,
    "bankAccountId": 201,
    "issueDate": "2026-03-03",
    "dueDateDays": 14,
    "deliveryDate": "2026-03-03",
    "variableSymbol": 20260001,
    "constantSymbol": 308,
    "specificSymbol": 55,
    "discountType": "percentage",
    "discountValue": 10,
    "transferTaxLiability": False,
    "deliveryMethodId": 1,
    "paymentMethodId": 1,
    "currencyId": 1,
    "currencyRate": 1,
    "languageId": 1,
    "qrTypeId": 1,
    "note": "Ďakujeme za objednávku.",
    "textAboveItems": "Dakujeme za spoluprácu."
}
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({
    clientId: 101,
    items: [
      {
        quantity: 2,
        priceListItemId: 501,
        name: 'Konzultácia',
        description: 'Mesačný balík konzultácií',
        unitPrice: 100,
        unitId: 1,
        vatRate: 20,
        discountType: 'percentage',
        discountValue: 10,
        discountName: 'Vernostná zľava',
        warehouseAllocations: [{warehouseId: 1, quantity: 2}],
        uuid: '6b1b8c9e-66e6-4fb5-b2db-6d7c7f0f8f19'
      }
    ],
    number: '20260001',
    proformaId: 401,
    orderId: 501,
    quotationId: 601,
    client: {
      name: 'Acme s.r.o.',
      type: 'company',
      subjectId: '12345678',
      taxId: '2020123456',
      vatId: 'SK2020123456',
      isVatPayer: true,
      email: 'billing@acme.test',
      street: 'Hlavná 1',
      city: 'Bratislava',
      zip: '81101',
      countryId: 703,
      hasDeliveryAddress: true,
      deliveryStreet: 'Skladová 5',
      deliveryCity: 'Trnava',
      deliveryZip: '91701',
      deliveryCountryId: 703
    },
    businessCaseId: 701,
    numericalSeriesId: 12,
    bankAccountId: 201,
    issueDate: '2026-03-03',
    dueDateDays: 14,
    deliveryDate: '2026-03-03',
    variableSymbol: 20260001,
    constantSymbol: 308,
    specificSymbol: 55,
    discountType: 'percentage',
    discountValue: 10,
    transferTaxLiability: false,
    deliveryMethodId: 1,
    paymentMethodId: 1,
    currencyId: 1,
    currencyRate: 1,
    languageId: 1,
    qrTypeId: 1,
    note: 'Ďakujeme za objednávku.',
    textAboveItems: 'Dakujeme za spoluprácu.'
  })
};

fetch('https://app.fintoro.sk/api/public/v1/invoices/{invoice}', 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/invoices/{invoice}",
  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([
    'clientId' => 101,
    'items' => [
        [
                'quantity' => 2,
                'priceListItemId' => 501,
                'name' => 'Konzultácia',
                'description' => 'Mesačný balík konzultácií',
                'unitPrice' => 100,
                'unitId' => 1,
                'vatRate' => 20,
                'discountType' => 'percentage',
                'discountValue' => 10,
                'discountName' => 'Vernostná zľava',
                'warehouseAllocations' => [
                                [
                                                                'warehouseId' => 1,
                                                                'quantity' => 2
                                ]
                ],
                'uuid' => '6b1b8c9e-66e6-4fb5-b2db-6d7c7f0f8f19'
        ]
    ],
    'number' => '20260001',
    'proformaId' => 401,
    'orderId' => 501,
    'quotationId' => 601,
    'client' => [
        'name' => 'Acme s.r.o.',
        'type' => 'company',
        'subjectId' => '12345678',
        'taxId' => '2020123456',
        'vatId' => 'SK2020123456',
        'isVatPayer' => true,
        'email' => 'billing@acme.test',
        'street' => 'Hlavná 1',
        'city' => 'Bratislava',
        'zip' => '81101',
        'countryId' => 703,
        'hasDeliveryAddress' => true,
        'deliveryStreet' => 'Skladová 5',
        'deliveryCity' => 'Trnava',
        'deliveryZip' => '91701',
        'deliveryCountryId' => 703
    ],
    'businessCaseId' => 701,
    'numericalSeriesId' => 12,
    'bankAccountId' => 201,
    'issueDate' => '2026-03-03',
    'dueDateDays' => 14,
    'deliveryDate' => '2026-03-03',
    'variableSymbol' => 20260001,
    'constantSymbol' => 308,
    'specificSymbol' => 55,
    'discountType' => 'percentage',
    'discountValue' => 10,
    'transferTaxLiability' => false,
    'deliveryMethodId' => 1,
    'paymentMethodId' => 1,
    'currencyId' => 1,
    'currencyRate' => 1,
    'languageId' => 1,
    'qrTypeId' => 1,
    'note' => 'Ďakujeme za objednávku.',
    'textAboveItems' => 'Dakujeme za spoluprácu.'
  ]),
  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/invoices/{invoice}"

	payload := strings.NewReader("{\n  \"clientId\": 101,\n  \"items\": [\n    {\n      \"quantity\": 2,\n      \"priceListItemId\": 501,\n      \"name\": \"Konzultácia\",\n      \"description\": \"Mesačný balík konzultácií\",\n      \"unitPrice\": 100,\n      \"unitId\": 1,\n      \"vatRate\": 20,\n      \"discountType\": \"percentage\",\n      \"discountValue\": 10,\n      \"discountName\": \"Vernostná zľava\",\n      \"warehouseAllocations\": [\n        {\n          \"warehouseId\": 1,\n          \"quantity\": 2\n        }\n      ],\n      \"uuid\": \"6b1b8c9e-66e6-4fb5-b2db-6d7c7f0f8f19\"\n    }\n  ],\n  \"number\": \"20260001\",\n  \"proformaId\": 401,\n  \"orderId\": 501,\n  \"quotationId\": 601,\n  \"client\": {\n    \"name\": \"Acme s.r.o.\",\n    \"type\": \"company\",\n    \"subjectId\": \"12345678\",\n    \"taxId\": \"2020123456\",\n    \"vatId\": \"SK2020123456\",\n    \"isVatPayer\": true,\n    \"email\": \"billing@acme.test\",\n    \"street\": \"Hlavná 1\",\n    \"city\": \"Bratislava\",\n    \"zip\": \"81101\",\n    \"countryId\": 703,\n    \"hasDeliveryAddress\": true,\n    \"deliveryStreet\": \"Skladová 5\",\n    \"deliveryCity\": \"Trnava\",\n    \"deliveryZip\": \"91701\",\n    \"deliveryCountryId\": 703\n  },\n  \"businessCaseId\": 701,\n  \"numericalSeriesId\": 12,\n  \"bankAccountId\": 201,\n  \"issueDate\": \"2026-03-03\",\n  \"dueDateDays\": 14,\n  \"deliveryDate\": \"2026-03-03\",\n  \"variableSymbol\": 20260001,\n  \"constantSymbol\": 308,\n  \"specificSymbol\": 55,\n  \"discountType\": \"percentage\",\n  \"discountValue\": 10,\n  \"transferTaxLiability\": false,\n  \"deliveryMethodId\": 1,\n  \"paymentMethodId\": 1,\n  \"currencyId\": 1,\n  \"currencyRate\": 1,\n  \"languageId\": 1,\n  \"qrTypeId\": 1,\n  \"note\": \"Ďakujeme za objednávku.\",\n  \"textAboveItems\": \"Dakujeme za spoluprácu.\"\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/invoices/{invoice}")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"clientId\": 101,\n  \"items\": [\n    {\n      \"quantity\": 2,\n      \"priceListItemId\": 501,\n      \"name\": \"Konzultácia\",\n      \"description\": \"Mesačný balík konzultácií\",\n      \"unitPrice\": 100,\n      \"unitId\": 1,\n      \"vatRate\": 20,\n      \"discountType\": \"percentage\",\n      \"discountValue\": 10,\n      \"discountName\": \"Vernostná zľava\",\n      \"warehouseAllocations\": [\n        {\n          \"warehouseId\": 1,\n          \"quantity\": 2\n        }\n      ],\n      \"uuid\": \"6b1b8c9e-66e6-4fb5-b2db-6d7c7f0f8f19\"\n    }\n  ],\n  \"number\": \"20260001\",\n  \"proformaId\": 401,\n  \"orderId\": 501,\n  \"quotationId\": 601,\n  \"client\": {\n    \"name\": \"Acme s.r.o.\",\n    \"type\": \"company\",\n    \"subjectId\": \"12345678\",\n    \"taxId\": \"2020123456\",\n    \"vatId\": \"SK2020123456\",\n    \"isVatPayer\": true,\n    \"email\": \"billing@acme.test\",\n    \"street\": \"Hlavná 1\",\n    \"city\": \"Bratislava\",\n    \"zip\": \"81101\",\n    \"countryId\": 703,\n    \"hasDeliveryAddress\": true,\n    \"deliveryStreet\": \"Skladová 5\",\n    \"deliveryCity\": \"Trnava\",\n    \"deliveryZip\": \"91701\",\n    \"deliveryCountryId\": 703\n  },\n  \"businessCaseId\": 701,\n  \"numericalSeriesId\": 12,\n  \"bankAccountId\": 201,\n  \"issueDate\": \"2026-03-03\",\n  \"dueDateDays\": 14,\n  \"deliveryDate\": \"2026-03-03\",\n  \"variableSymbol\": 20260001,\n  \"constantSymbol\": 308,\n  \"specificSymbol\": 55,\n  \"discountType\": \"percentage\",\n  \"discountValue\": 10,\n  \"transferTaxLiability\": false,\n  \"deliveryMethodId\": 1,\n  \"paymentMethodId\": 1,\n  \"currencyId\": 1,\n  \"currencyRate\": 1,\n  \"languageId\": 1,\n  \"qrTypeId\": 1,\n  \"note\": \"Ďakujeme za objednávku.\",\n  \"textAboveItems\": \"Dakujeme za spoluprácu.\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://app.fintoro.sk/api/public/v1/invoices/{invoice}")

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  \"clientId\": 101,\n  \"items\": [\n    {\n      \"quantity\": 2,\n      \"priceListItemId\": 501,\n      \"name\": \"Konzultácia\",\n      \"description\": \"Mesačný balík konzultácií\",\n      \"unitPrice\": 100,\n      \"unitId\": 1,\n      \"vatRate\": 20,\n      \"discountType\": \"percentage\",\n      \"discountValue\": 10,\n      \"discountName\": \"Vernostná zľava\",\n      \"warehouseAllocations\": [\n        {\n          \"warehouseId\": 1,\n          \"quantity\": 2\n        }\n      ],\n      \"uuid\": \"6b1b8c9e-66e6-4fb5-b2db-6d7c7f0f8f19\"\n    }\n  ],\n  \"number\": \"20260001\",\n  \"proformaId\": 401,\n  \"orderId\": 501,\n  \"quotationId\": 601,\n  \"client\": {\n    \"name\": \"Acme s.r.o.\",\n    \"type\": \"company\",\n    \"subjectId\": \"12345678\",\n    \"taxId\": \"2020123456\",\n    \"vatId\": \"SK2020123456\",\n    \"isVatPayer\": true,\n    \"email\": \"billing@acme.test\",\n    \"street\": \"Hlavná 1\",\n    \"city\": \"Bratislava\",\n    \"zip\": \"81101\",\n    \"countryId\": 703,\n    \"hasDeliveryAddress\": true,\n    \"deliveryStreet\": \"Skladová 5\",\n    \"deliveryCity\": \"Trnava\",\n    \"deliveryZip\": \"91701\",\n    \"deliveryCountryId\": 703\n  },\n  \"businessCaseId\": 701,\n  \"numericalSeriesId\": 12,\n  \"bankAccountId\": 201,\n  \"issueDate\": \"2026-03-03\",\n  \"dueDateDays\": 14,\n  \"deliveryDate\": \"2026-03-03\",\n  \"variableSymbol\": 20260001,\n  \"constantSymbol\": 308,\n  \"specificSymbol\": 55,\n  \"discountType\": \"percentage\",\n  \"discountValue\": 10,\n  \"transferTaxLiability\": false,\n  \"deliveryMethodId\": 1,\n  \"paymentMethodId\": 1,\n  \"currencyId\": 1,\n  \"currencyRate\": 1,\n  \"languageId\": 1,\n  \"qrTypeId\": 1,\n  \"note\": \"Ďakujeme za objednávku.\",\n  \"textAboveItems\": \"Dakujeme za spoluprácu.\"\n}"

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

{
  "id": 301,
  "uuid": "6b1b8c9e-66e6-4fb5-b2db-6d7c7f0f8f19",
  "type": "invoice",
  "number": "20260001",
  "webDokladUrl": "https://app.fintoro.sk/web-doklad/fa/4f3f8a95-5c4a-4c8b-9e6c-8a0c1a5df3a1",
  "pdfDownloadUrl": "https://app.fintoro.sk/api/public/v1/invoices/123/pdf",
  "company": {
    "name": "Fintoro s.r.o.",
    "subjectId": "12345678",
    "legalForm": "Spoločnosť s ručením obmedzeným",
    "taxId": "2020123456",
    "vatId": "SK2020123456",
    "vatPayerTypeId": 4,
    "country": "Slovensko",
    "city": "Bratislava",
    "street": "Hlavná 1",
    "zip": "81101",
    "registrationCourt": "Mestský súd Bratislava III",
    "registrationNumber": "12345/B",
    "email": "support@fintoro.sk",
    "phone": "+421900000000",
    "web": "https://fintoro.sk"
  },
  "clientId": 101,
  "client": {
    "name": "Acme s.r.o.",
    "type": "company",
    "subjectId": "12345678",
    "taxId": "2020123456",
    "vatId": "SK2020123456",
    "isVatPayer": true,
    "email": "billing@acme.test",
    "street": "Hlavná 1",
    "city": "Bratislava",
    "zip": "81101",
    "countryId": 703,
    "country": {
      "id": 703,
      "name": "Slovensko",
      "code": "SK",
      "eu": true
    },
    "hasDeliveryAddress": true,
    "deliveryStreet": "Skladová 9",
    "deliveryCity": "Košice",
    "deliveryZip": "04001",
    "deliveryCountryId": 703,
    "deliveryCountry": {
      "id": 703,
      "name": "Slovensko",
      "code": "SK",
      "eu": true
    }
  },
  "bankAccount": {
    "id": 201,
    "bankId": 1,
    "bank": {
      "id": 23,
      "name": "Tatra Banka",
      "swift": "TATRSKBX"
    },
    "name": "Hlavný účet",
    "iban": "SK3111000000001234567890",
    "swift": "TATRSKBX",
    "isPrimary": true,
    "autoPaymentMatching": true
  },
  "payments": [
    {
      "id": 801,
      "documentType": "invoice",
      "documentId": 301,
      "paymentMethod": {
        "id": 1,
        "name": "Platba prevodom"
      },
      "currency": {
        "id": 1,
        "symbol": "EUR",
        "name": "Euro",
        "mark": "€"
      },
      "paymentDate": "2026-03-07",
      "amount": 15.5,
      "currencyRate": 1,
      "receiptInvoice": {
        "id": 301,
        "uuid": "6b1b8c9e-66e6-4fb5-b2db-6d7c7f0f8f19",
        "type": "invoice",
        "number": "20260001",
        "clientId": 101,
        "client": {
          "name": "Acme s.r.o.",
          "type": "company",
          "subjectId": "12345678",
          "taxId": "2020123456",
          "vatId": "SK2020123456",
          "isVatPayer": true,
          "email": "billing@acme.test",
          "street": "Hlavná 1",
          "city": "Bratislava",
          "zip": "81101",
          "countryId": 703,
          "country": {
            "id": 703,
            "name": "Slovensko",
            "code": "SK",
            "eu": true
          },
          "hasDeliveryAddress": true,
          "deliveryStreet": "Skladová 9",
          "deliveryCity": "Košice",
          "deliveryZip": "04001",
          "deliveryCountryId": 703,
          "deliveryCountry": {
            "id": 703,
            "name": "Slovensko",
            "code": "SK",
            "eu": true
          }
        },
        "issueDate": "2026-03-03",
        "dueDate": "2026-03-17",
        "deliveryDate": "2026-03-03",
        "currency": {
          "id": 1,
          "symbol": "EUR",
          "name": "Euro",
          "mark": "€"
        },
        "total": 200,
        "totalWithVat": 240,
        "toBePaid": 240,
        "status": "unpaid",
        "hasVat": true
      }
    }
  ],
  "variableSymbol": 20260001,
  "constantSymbol": 308,
  "specificSymbol": 55,
  "issueDate": "2026-03-03",
  "dueDate": "2026-03-17",
  "deliveryDate": "2026-03-03",
  "businessCaseId": 701,
  "discountType": "percentage",
  "discountValue": 10,
  "transferTaxLiability": false,
  "numericalSeriesId": 12,
  "deliveryMethodId": 1,
  "paymentMethodId": 1,
  "currencyId": 1,
  "currencyRate": 1,
  "languageId": 1,
  "qrTypeId": 1,
  "note": "Ďakujeme za objednávku.",
  "textAboveItems": "Dakujeme za spoluprácu.",
  "itemsTotal": 200,
  "itemsTotalWithVat": 240,
  "total": 200,
  "totalWithVat": 240,
  "toBePaid": 240,
  "status": "unpaid",
  "hasVat": true,
  "creditNotesSumTotalWithVat": 0,
  "items": [
    {
      "id": 1,
      "uuid": "6b1b8c9e-66e6-4fb5-b2db-6d7c7f0f8f19",
      "name": "Konzultácia",
      "description": "Mesačný balík konzultácií",
      "unitPrice": 100,
      "unitId": 1,
      "quantity": 2,
      "vatRate": 20,
      "discountName": "Vernostná zľava",
      "discountType": "percentage",
      "discountValue": 10,
      "priceListItemId": 501,
      "total": 200,
      "totalWithVat": 240
    }
  ]
}

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

Autorizace

Authorization

string

header

povinné

Bearer token vytvorený pre konkrétnu firmu v Integrácie → API.

Parametry cesty

invoice

integer

povinné

ID faktúry.

Příklad:

301

Tělo

application/json

Option 1
Option 2

Payload pre aktualizáciu faktúry. Update používa rovnaké polia, rovnaké validačné pravidlá a rovnaké defaulty ako create flow. Musíte poslať buď clientId, alebo objekt client. Omitted polia sa nedoťahujú z aktuálnej faktúry; backend ich vyrieši rovnako ako pri create flowe. Jediný rozdiel oproti create je, že pri položkách môžete navyše posielať pôvodné uuid existujúcich riadkov faktúry; create flow ich ignoruje.

clientId

integer | null

povinné

ID existujúceho klienta. Toto je odporúčaný spôsob tvorby faktúry. Ak zároveň pošlete objekt client, použije sa ako sparse override snapshotu klienta pre tento konkrétny doklad.

Příklad:

101

items

object[]

povinné

Položky faktúry. Toto pole je pri update povinné vždy. Ak pri existujúcej položke pošlete jej pôvodné uuid z detailu faktúry, backend vie zachovať väzby na skladové výdajky a synchronizovať zmenené alokácie na tom istom riadku.

Required array length: 1 - 100 elements

Payload jednej položky faktúry pri update. Pravidlá sú rovnaké ako pri create, ale navyše môžete poslať pôvodné uuid existujúceho riadku faktúry. Toto UUID máte k dispozícii v detaile faktúry. Backend ho používa pri synchronizácii skladových alokácií a výdajok, aby vedel spárovať upravovaný riadok s pôvodným riadkom dokladu. Pri create flowe uuid nie je súčasťou item request kontraktu; ak ho pošlete, backend ho ignoruje.

Option 1
Option 2
Option 3
Option 4

Show child attributes

number

string | null

Manuálne číslo faktúry. Ak ho nepošlete, backend ho vygeneruje z číselného radu. Ak pošlete number, nepošlite zároveň numericalSeriesId.

Required string length: 1 - 20

Příklad:

"20260001"

proformaId

integer | null

Voliteľné ID zálohovej faktúry, z ktorej sa má vytvoriť finálny stav faktúry. Pri update môže byť toto ID buď ešte nepriradené, alebo už naviazané na aktuálne upravovanú faktúru.

Příklad:

401

orderId

integer | null

Voliteľné ID objednávky, z ktorej sa má vytvoriť finálny stav faktúry. Pri update môže byť toto ID buď ešte nepriradené, alebo už naviazané na aktuálne upravovanú faktúru.

Příklad:

501

quotationId

integer | null

Voliteľné ID cenovej ponuky, z ktorej sa má vytvoriť finálny stav faktúry. Pri update môže byť toto ID buď ešte nepriradené, alebo už naviazané na aktuálne upravovanú faktúru.

Příklad:

601

client

object | null

Sparse klientský payload. Ak pošlete clientId, slúži ako override snapshotu pre tento doklad. Ak clientId nepošlete, backend podľa týchto údajov klienta dopáruje alebo vytvorí.

Show child attributes

businessCaseId

integer | null

Voliteľné ID obchodného prípadu. Ak ho pošlete, musí patriť klientovi určenému cez finálny clientId.

Příklad:

701

numericalSeriesId

integer | null

ID číselného radu. Ak ho nepošlete a nepošlete ani number, použije sa primárny číselný rad pre faktúry. Ak pošlete numericalSeriesId, nepošlite zároveň manuálne number.

Příklad:

12

bankAccountId

integer

ID bankového účtu, ktorý sa má použiť na faktúre. Ak ho nepošlete, použije sa primárny bankový účet firmy. Ak firma nemá nastavený žiadny primárny bankový účet, endpoint vráti 422 validačnú chybu s chybou pri bankAccountId.

Příklad:

201

issueDate

string<date>

Dátum vystavenia vo formáte Y-m-d. Musí byť po 2009-01-01 a pred dátumom o jeden rok v budúcnosti. Ak ho nepošlete, použije sa dnešný dátum.

Příklad:

"2026-03-03"

dueDateDays

integer

Počet dní splatnosti. Priorita je payload → klientská predvolená hodnota → nastavenia dokladov firmy.

Požadovaný rozsah: 0 <= x <= 1000

Příklad:

14

deliveryDate

string<date>

Dátum dodania vo formáte Y-m-d. Ak ho pošlete, musí byť menší alebo rovný issueDate. Ak ho nepošlete, použije sa issueDate.

Příklad:

"2026-03-03"

variableSymbol

integer

Variabilný symbol. Povolené sú hodnoty s dĺžkou 1 až 10 číslic. Ak ho nepošlete, backend ho odvodí z finálneho čísla faktúry.

Požadovaný rozsah: 0 <= x <= 9999999999

Příklad:

20260001

constantSymbol

integer | null

Konštantný symbol. Povolené sú hodnoty s dĺžkou 1 až 4 číslic. Priorita je payload → klientská predvolená hodnota → null.

Požadovaný rozsah: 0 <= x <= 9999

Příklad:

308

specificSymbol

integer | null

Špecifický symbol. Povolené sú hodnoty s dĺžkou 1 až 10 číslic. Priorita je payload → klientská predvolená hodnota → null.

Požadovaný rozsah: 0 <= x <= 9999999999

Příklad:

55

discountType

enum<string> | null

Typ zľavy na úrovni celého dokladu.

Dostupné možnosti:

percentage,

fixed

Příklad:

"percentage"

discountValue

number<float> | null

Hodnota zľavy na úrovni celého dokladu.

Požadovaný rozsah: x >= 0

Příklad:

10

transferTaxLiability

boolean

Príznak prenesenej daňovej povinnosti. Ak ho nepošlete, použije sa false.

Příklad:

false

deliveryMethodId

integer

ID spôsobu dodania z referenčnej tabuľky spôsobov dodania. Priorita je payload → klientská predvolená hodnota → nastavenia dokladov firmy.

Příklad:

1

paymentMethodId

integer

ID spôsobu úhrady z referenčnej tabuľky spôsobov úhrady. Priorita je payload → klientská predvolená hodnota → nastavenia dokladov firmy.

Příklad:

1

currencyId

integer

ID meny z referenčnej tabuľky mien. Priorita je payload → klientská predvolená hodnota → nastavenia dokladov firmy.

Příklad:

1

currencyRate

number<float>

Kurz meny k EUR. Ak ho nepošlete, backend ho vyrieši server-side podľa currencyId a deliveryDate. Ak je finálna mena dokladu EUR, backend vždy uloží a vráti 1.0.

Požadovaný rozsah: 0.00001 <= x <= 10000000

Příklad:

1

languageId

integer

ID jazyka z referenčnej tabuľky jazykov. Priorita je payload → klientská predvolená hodnota → nastavenia dokladov firmy.

Příklad:

1

qrTypeId

integer

ID QR typu z referenčnej tabuľky QR typov. Ak ho nepošlete, použije sa nastavenia dokladov firmy.

Příklad:

1

note

string | null

Poznámka na doklade. Priorita je payload → klientská predvolená hodnota → nastavenia dokladov firmy.

Maximum string length: 3000

Příklad:

"Ďakujeme za objednávku."

textAboveItems

string | null

Text nad položkami. Priorita je payload → klientská predvolená hodnota → nastavenia dokladov firmy.

Maximum string length: 3000

Příklad:

"Dakujeme za spoluprácu."

Odpověď

Faktúra bola aktualizovaná.

Faktúra.

integer

Příklad:

301

uuid

string

Příklad:

"6b1b8c9e-66e6-4fb5-b2db-6d7c7f0f8f19"

type

string

Příklad:

"invoice"

number

string

Příklad:

"20260001"

webDokladUrl

string<uri>

Absolútna URL na verejný web doklad tejto faktúry.

Příklad:

"https://app.fintoro.sk/web-doklad/fa/4f3f8a95-5c4a-4c8b-9e6c-8a0c1a5df3a1"

pdfDownloadUrl

string<uri>

Absolútna URL na Fintoro API endpoint, ktorý stiahne PDF tejto faktúry ako prílohu.

Příklad:

"https://app.fintoro.sk/api/public/v1/invoices/123/pdf"

company

object

Snapshot dodávateľa uložený priamo na tomto doklade.

Show child attributes

clientId

integer | null

Live ID klienta naviazaného na faktúru. Po vymazaní kontaktu je null; snapshot klienta na doklade zostáva zachovaný.

Příklad:

101

client

object

Historický snapshot klienta uložený priamo na tomto doklade.

Show child attributes

bankAccount

object

Bankový účet naviazaný na faktúru ako živá väzba načítaná aj cez soft delete.

Show child attributes

payments

object[]

Úhrady naviazané na túto faktúru v poradí od najnovšej.

Show child attributes

variableSymbol

integer

Příklad:

20260001

constantSymbol

integer | null

Příklad:

308

specificSymbol

integer | null

Příklad:

55

issueDate

string<date>

Příklad:

"2026-03-03"

dueDate

string<date>

Příklad:

"2026-03-17"

deliveryDate

string<date>

Příklad:

"2026-03-03"

businessCaseId

integer | null

Voliteľné ID obchodného prípadu. Ak ho pošlete, musí patriť zvolenému klientovi na doklade.

Příklad:

701

discountType

string | null

Příklad:

"percentage"

discountValue

number<float> | null

Příklad:

10

transferTaxLiability

boolean

Příklad:

false

numericalSeriesId

integer | null

Příklad:

12

deliveryMethodId

integer

ID spôsobu dodania z referenčnej tabuľky spôsobov dodania.

Příklad:

1

paymentMethodId

integer

ID spôsobu úhrady z referenčnej tabuľky spôsobov úhrady.

Příklad:

1

currencyId

integer

ID meny z referenčnej tabuľky mien.

Příklad:

1

currencyRate

number<float>

Příklad:

1

languageId

integer

ID jazyka z referenčnej tabuľky jazykov.

Příklad:

1

qrTypeId

integer

ID QR typu z referenčnej tabuľky QR typov.

Příklad:

1

note

string | null

Příklad:

"Ďakujeme za objednávku."

textAboveItems

string | null

Příklad:

"Dakujeme za spoluprácu."

itemsTotal

number<float>

Příklad:

200

itemsTotalWithVat

number<float>

Příklad:

240

total

number<float>

Příklad:

200

totalWithVat

number<float>

Příklad:

240

toBePaid

number<float>

Příklad:

240

status

string

Příklad:

"unpaid"

hasVat

boolean

Příklad:

true

creditNotesSumTotalWithVat

number<float>

Příklad:

0

items

object[]

Show child attributes

Upraviť faktúru

curl --request PUT \
  --url https://app.fintoro.sk/api/public/v1/invoices/{invoice} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "clientId": 101,
  "items": [
    {
      "quantity": 2,
      "priceListItemId": 501,
      "name": "Konzultácia",
      "description": "Mesačný balík konzultácií",
      "unitPrice": 100,
      "unitId": 1,
      "vatRate": 20,
      "discountType": "percentage",
      "discountValue": 10,
      "discountName": "Vernostná zľava",
      "warehouseAllocations": [
        {
          "warehouseId": 1,
          "quantity": 2
        }
      ],
      "uuid": "6b1b8c9e-66e6-4fb5-b2db-6d7c7f0f8f19"
    }
  ],
  "number": "20260001",
  "proformaId": 401,
  "orderId": 501,
  "quotationId": 601,
  "client": {
    "name": "Acme s.r.o.",
    "type": "company",
    "subjectId": "12345678",
    "taxId": "2020123456",
    "vatId": "SK2020123456",
    "isVatPayer": true,
    "email": "billing@acme.test",
    "street": "Hlavná 1",
    "city": "Bratislava",
    "zip": "81101",
    "countryId": 703,
    "hasDeliveryAddress": true,
    "deliveryStreet": "Skladová 5",
    "deliveryCity": "Trnava",
    "deliveryZip": "91701",
    "deliveryCountryId": 703
  },
  "businessCaseId": 701,
  "numericalSeriesId": 12,
  "bankAccountId": 201,
  "issueDate": "2026-03-03",
  "dueDateDays": 14,
  "deliveryDate": "2026-03-03",
  "variableSymbol": 20260001,
  "constantSymbol": 308,
  "specificSymbol": 55,
  "discountType": "percentage",
  "discountValue": 10,
  "transferTaxLiability": false,
  "deliveryMethodId": 1,
  "paymentMethodId": 1,
  "currencyId": 1,
  "currencyRate": 1,
  "languageId": 1,
  "qrTypeId": 1,
  "note": "Ďakujeme za objednávku.",
  "textAboveItems": "Dakujeme za spoluprácu."
}
'

import requests

url = "https://app.fintoro.sk/api/public/v1/invoices/{invoice}"

payload = {
    "clientId": 101,
    "items": [
        {
            "quantity": 2,
            "priceListItemId": 501,
            "name": "Konzultácia",
            "description": "Mesačný balík konzultácií",
            "unitPrice": 100,
            "unitId": 1,
            "vatRate": 20,
            "discountType": "percentage",
            "discountValue": 10,
            "discountName": "Vernostná zľava",
            "warehouseAllocations": [
                {
                    "warehouseId": 1,
                    "quantity": 2
                }
            ],
            "uuid": "6b1b8c9e-66e6-4fb5-b2db-6d7c7f0f8f19"
        }
    ],
    "number": "20260001",
    "proformaId": 401,
    "orderId": 501,
    "quotationId": 601,
    "client": {
        "name": "Acme s.r.o.",
        "type": "company",
        "subjectId": "12345678",
        "taxId": "2020123456",
        "vatId": "SK2020123456",
        "isVatPayer": True,
        "email": "billing@acme.test",
        "street": "Hlavná 1",
        "city": "Bratislava",
        "zip": "81101",
        "countryId": 703,
        "hasDeliveryAddress": True,
        "deliveryStreet": "Skladová 5",
        "deliveryCity": "Trnava",
        "deliveryZip": "91701",
        "deliveryCountryId": 703
    },
    "businessCaseId": 701,
    "numericalSeriesId": 12,
    "bankAccountId": 201,
    "issueDate": "2026-03-03",
    "dueDateDays": 14,
    "deliveryDate": "2026-03-03",
    "variableSymbol": 20260001,
    "constantSymbol": 308,
    "specificSymbol": 55,
    "discountType": "percentage",
    "discountValue": 10,
    "transferTaxLiability": False,
    "deliveryMethodId": 1,
    "paymentMethodId": 1,
    "currencyId": 1,
    "currencyRate": 1,
    "languageId": 1,
    "qrTypeId": 1,
    "note": "Ďakujeme za objednávku.",
    "textAboveItems": "Dakujeme za spoluprácu."
}
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({
    clientId: 101,
    items: [
      {
        quantity: 2,
        priceListItemId: 501,
        name: 'Konzultácia',
        description: 'Mesačný balík konzultácií',
        unitPrice: 100,
        unitId: 1,
        vatRate: 20,
        discountType: 'percentage',
        discountValue: 10,
        discountName: 'Vernostná zľava',
        warehouseAllocations: [{warehouseId: 1, quantity: 2}],
        uuid: '6b1b8c9e-66e6-4fb5-b2db-6d7c7f0f8f19'
      }
    ],
    number: '20260001',
    proformaId: 401,
    orderId: 501,
    quotationId: 601,
    client: {
      name: 'Acme s.r.o.',
      type: 'company',
      subjectId: '12345678',
      taxId: '2020123456',
      vatId: 'SK2020123456',
      isVatPayer: true,
      email: 'billing@acme.test',
      street: 'Hlavná 1',
      city: 'Bratislava',
      zip: '81101',
      countryId: 703,
      hasDeliveryAddress: true,
      deliveryStreet: 'Skladová 5',
      deliveryCity: 'Trnava',
      deliveryZip: '91701',
      deliveryCountryId: 703
    },
    businessCaseId: 701,
    numericalSeriesId: 12,
    bankAccountId: 201,
    issueDate: '2026-03-03',
    dueDateDays: 14,
    deliveryDate: '2026-03-03',
    variableSymbol: 20260001,
    constantSymbol: 308,
    specificSymbol: 55,
    discountType: 'percentage',
    discountValue: 10,
    transferTaxLiability: false,
    deliveryMethodId: 1,
    paymentMethodId: 1,
    currencyId: 1,
    currencyRate: 1,
    languageId: 1,
    qrTypeId: 1,
    note: 'Ďakujeme za objednávku.',
    textAboveItems: 'Dakujeme za spoluprácu.'
  })
};

fetch('https://app.fintoro.sk/api/public/v1/invoices/{invoice}', 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/invoices/{invoice}",
  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([
    'clientId' => 101,
    'items' => [
        [
                'quantity' => 2,
                'priceListItemId' => 501,
                'name' => 'Konzultácia',
                'description' => 'Mesačný balík konzultácií',
                'unitPrice' => 100,
                'unitId' => 1,
                'vatRate' => 20,
                'discountType' => 'percentage',
                'discountValue' => 10,
                'discountName' => 'Vernostná zľava',
                'warehouseAllocations' => [
                                [
                                                                'warehouseId' => 1,
                                                                'quantity' => 2
                                ]
                ],
                'uuid' => '6b1b8c9e-66e6-4fb5-b2db-6d7c7f0f8f19'
        ]
    ],
    'number' => '20260001',
    'proformaId' => 401,
    'orderId' => 501,
    'quotationId' => 601,
    'client' => [
        'name' => 'Acme s.r.o.',
        'type' => 'company',
        'subjectId' => '12345678',
        'taxId' => '2020123456',
        'vatId' => 'SK2020123456',
        'isVatPayer' => true,
        'email' => 'billing@acme.test',
        'street' => 'Hlavná 1',
        'city' => 'Bratislava',
        'zip' => '81101',
        'countryId' => 703,
        'hasDeliveryAddress' => true,
        'deliveryStreet' => 'Skladová 5',
        'deliveryCity' => 'Trnava',
        'deliveryZip' => '91701',
        'deliveryCountryId' => 703
    ],
    'businessCaseId' => 701,
    'numericalSeriesId' => 12,
    'bankAccountId' => 201,
    'issueDate' => '2026-03-03',
    'dueDateDays' => 14,
    'deliveryDate' => '2026-03-03',
    'variableSymbol' => 20260001,
    'constantSymbol' => 308,
    'specificSymbol' => 55,
    'discountType' => 'percentage',
    'discountValue' => 10,
    'transferTaxLiability' => false,
    'deliveryMethodId' => 1,
    'paymentMethodId' => 1,
    'currencyId' => 1,
    'currencyRate' => 1,
    'languageId' => 1,
    'qrTypeId' => 1,
    'note' => 'Ďakujeme za objednávku.',
    'textAboveItems' => 'Dakujeme za spoluprácu.'
  ]),
  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/invoices/{invoice}"

	payload := strings.NewReader("{\n  \"clientId\": 101,\n  \"items\": [\n    {\n      \"quantity\": 2,\n      \"priceListItemId\": 501,\n      \"name\": \"Konzultácia\",\n      \"description\": \"Mesačný balík konzultácií\",\n      \"unitPrice\": 100,\n      \"unitId\": 1,\n      \"vatRate\": 20,\n      \"discountType\": \"percentage\",\n      \"discountValue\": 10,\n      \"discountName\": \"Vernostná zľava\",\n      \"warehouseAllocations\": [\n        {\n          \"warehouseId\": 1,\n          \"quantity\": 2\n        }\n      ],\n      \"uuid\": \"6b1b8c9e-66e6-4fb5-b2db-6d7c7f0f8f19\"\n    }\n  ],\n  \"number\": \"20260001\",\n  \"proformaId\": 401,\n  \"orderId\": 501,\n  \"quotationId\": 601,\n  \"client\": {\n    \"name\": \"Acme s.r.o.\",\n    \"type\": \"company\",\n    \"subjectId\": \"12345678\",\n    \"taxId\": \"2020123456\",\n    \"vatId\": \"SK2020123456\",\n    \"isVatPayer\": true,\n    \"email\": \"billing@acme.test\",\n    \"street\": \"Hlavná 1\",\n    \"city\": \"Bratislava\",\n    \"zip\": \"81101\",\n    \"countryId\": 703,\n    \"hasDeliveryAddress\": true,\n    \"deliveryStreet\": \"Skladová 5\",\n    \"deliveryCity\": \"Trnava\",\n    \"deliveryZip\": \"91701\",\n    \"deliveryCountryId\": 703\n  },\n  \"businessCaseId\": 701,\n  \"numericalSeriesId\": 12,\n  \"bankAccountId\": 201,\n  \"issueDate\": \"2026-03-03\",\n  \"dueDateDays\": 14,\n  \"deliveryDate\": \"2026-03-03\",\n  \"variableSymbol\": 20260001,\n  \"constantSymbol\": 308,\n  \"specificSymbol\": 55,\n  \"discountType\": \"percentage\",\n  \"discountValue\": 10,\n  \"transferTaxLiability\": false,\n  \"deliveryMethodId\": 1,\n  \"paymentMethodId\": 1,\n  \"currencyId\": 1,\n  \"currencyRate\": 1,\n  \"languageId\": 1,\n  \"qrTypeId\": 1,\n  \"note\": \"Ďakujeme za objednávku.\",\n  \"textAboveItems\": \"Dakujeme za spoluprácu.\"\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/invoices/{invoice}")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"clientId\": 101,\n  \"items\": [\n    {\n      \"quantity\": 2,\n      \"priceListItemId\": 501,\n      \"name\": \"Konzultácia\",\n      \"description\": \"Mesačný balík konzultácií\",\n      \"unitPrice\": 100,\n      \"unitId\": 1,\n      \"vatRate\": 20,\n      \"discountType\": \"percentage\",\n      \"discountValue\": 10,\n      \"discountName\": \"Vernostná zľava\",\n      \"warehouseAllocations\": [\n        {\n          \"warehouseId\": 1,\n          \"quantity\": 2\n        }\n      ],\n      \"uuid\": \"6b1b8c9e-66e6-4fb5-b2db-6d7c7f0f8f19\"\n    }\n  ],\n  \"number\": \"20260001\",\n  \"proformaId\": 401,\n  \"orderId\": 501,\n  \"quotationId\": 601,\n  \"client\": {\n    \"name\": \"Acme s.r.o.\",\n    \"type\": \"company\",\n    \"subjectId\": \"12345678\",\n    \"taxId\": \"2020123456\",\n    \"vatId\": \"SK2020123456\",\n    \"isVatPayer\": true,\n    \"email\": \"billing@acme.test\",\n    \"street\": \"Hlavná 1\",\n    \"city\": \"Bratislava\",\n    \"zip\": \"81101\",\n    \"countryId\": 703,\n    \"hasDeliveryAddress\": true,\n    \"deliveryStreet\": \"Skladová 5\",\n    \"deliveryCity\": \"Trnava\",\n    \"deliveryZip\": \"91701\",\n    \"deliveryCountryId\": 703\n  },\n  \"businessCaseId\": 701,\n  \"numericalSeriesId\": 12,\n  \"bankAccountId\": 201,\n  \"issueDate\": \"2026-03-03\",\n  \"dueDateDays\": 14,\n  \"deliveryDate\": \"2026-03-03\",\n  \"variableSymbol\": 20260001,\n  \"constantSymbol\": 308,\n  \"specificSymbol\": 55,\n  \"discountType\": \"percentage\",\n  \"discountValue\": 10,\n  \"transferTaxLiability\": false,\n  \"deliveryMethodId\": 1,\n  \"paymentMethodId\": 1,\n  \"currencyId\": 1,\n  \"currencyRate\": 1,\n  \"languageId\": 1,\n  \"qrTypeId\": 1,\n  \"note\": \"Ďakujeme za objednávku.\",\n  \"textAboveItems\": \"Dakujeme za spoluprácu.\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://app.fintoro.sk/api/public/v1/invoices/{invoice}")

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  \"clientId\": 101,\n  \"items\": [\n    {\n      \"quantity\": 2,\n      \"priceListItemId\": 501,\n      \"name\": \"Konzultácia\",\n      \"description\": \"Mesačný balík konzultácií\",\n      \"unitPrice\": 100,\n      \"unitId\": 1,\n      \"vatRate\": 20,\n      \"discountType\": \"percentage\",\n      \"discountValue\": 10,\n      \"discountName\": \"Vernostná zľava\",\n      \"warehouseAllocations\": [\n        {\n          \"warehouseId\": 1,\n          \"quantity\": 2\n        }\n      ],\n      \"uuid\": \"6b1b8c9e-66e6-4fb5-b2db-6d7c7f0f8f19\"\n    }\n  ],\n  \"number\": \"20260001\",\n  \"proformaId\": 401,\n  \"orderId\": 501,\n  \"quotationId\": 601,\n  \"client\": {\n    \"name\": \"Acme s.r.o.\",\n    \"type\": \"company\",\n    \"subjectId\": \"12345678\",\n    \"taxId\": \"2020123456\",\n    \"vatId\": \"SK2020123456\",\n    \"isVatPayer\": true,\n    \"email\": \"billing@acme.test\",\n    \"street\": \"Hlavná 1\",\n    \"city\": \"Bratislava\",\n    \"zip\": \"81101\",\n    \"countryId\": 703,\n    \"hasDeliveryAddress\": true,\n    \"deliveryStreet\": \"Skladová 5\",\n    \"deliveryCity\": \"Trnava\",\n    \"deliveryZip\": \"91701\",\n    \"deliveryCountryId\": 703\n  },\n  \"businessCaseId\": 701,\n  \"numericalSeriesId\": 12,\n  \"bankAccountId\": 201,\n  \"issueDate\": \"2026-03-03\",\n  \"dueDateDays\": 14,\n  \"deliveryDate\": \"2026-03-03\",\n  \"variableSymbol\": 20260001,\n  \"constantSymbol\": 308,\n  \"specificSymbol\": 55,\n  \"discountType\": \"percentage\",\n  \"discountValue\": 10,\n  \"transferTaxLiability\": false,\n  \"deliveryMethodId\": 1,\n  \"paymentMethodId\": 1,\n  \"currencyId\": 1,\n  \"currencyRate\": 1,\n  \"languageId\": 1,\n  \"qrTypeId\": 1,\n  \"note\": \"Ďakujeme za objednávku.\",\n  \"textAboveItems\": \"Dakujeme za spoluprácu.\"\n}"

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

{
  "id": 301,
  "uuid": "6b1b8c9e-66e6-4fb5-b2db-6d7c7f0f8f19",
  "type": "invoice",
  "number": "20260001",
  "webDokladUrl": "https://app.fintoro.sk/web-doklad/fa/4f3f8a95-5c4a-4c8b-9e6c-8a0c1a5df3a1",
  "pdfDownloadUrl": "https://app.fintoro.sk/api/public/v1/invoices/123/pdf",
  "company": {
    "name": "Fintoro s.r.o.",
    "subjectId": "12345678",
    "legalForm": "Spoločnosť s ručením obmedzeným",
    "taxId": "2020123456",
    "vatId": "SK2020123456",
    "vatPayerTypeId": 4,
    "country": "Slovensko",
    "city": "Bratislava",
    "street": "Hlavná 1",
    "zip": "81101",
    "registrationCourt": "Mestský súd Bratislava III",
    "registrationNumber": "12345/B",
    "email": "support@fintoro.sk",
    "phone": "+421900000000",
    "web": "https://fintoro.sk"
  },
  "clientId": 101,
  "client": {
    "name": "Acme s.r.o.",
    "type": "company",
    "subjectId": "12345678",
    "taxId": "2020123456",
    "vatId": "SK2020123456",
    "isVatPayer": true,
    "email": "billing@acme.test",
    "street": "Hlavná 1",
    "city": "Bratislava",
    "zip": "81101",
    "countryId": 703,
    "country": {
      "id": 703,
      "name": "Slovensko",
      "code": "SK",
      "eu": true
    },
    "hasDeliveryAddress": true,
    "deliveryStreet": "Skladová 9",
    "deliveryCity": "Košice",
    "deliveryZip": "04001",
    "deliveryCountryId": 703,
    "deliveryCountry": {
      "id": 703,
      "name": "Slovensko",
      "code": "SK",
      "eu": true
    }
  },
  "bankAccount": {
    "id": 201,
    "bankId": 1,
    "bank": {
      "id": 23,
      "name": "Tatra Banka",
      "swift": "TATRSKBX"
    },
    "name": "Hlavný účet",
    "iban": "SK3111000000001234567890",
    "swift": "TATRSKBX",
    "isPrimary": true,
    "autoPaymentMatching": true
  },
  "payments": [
    {
      "id": 801,
      "documentType": "invoice",
      "documentId": 301,
      "paymentMethod": {
        "id": 1,
        "name": "Platba prevodom"
      },
      "currency": {
        "id": 1,
        "symbol": "EUR",
        "name": "Euro",
        "mark": "€"
      },
      "paymentDate": "2026-03-07",
      "amount": 15.5,
      "currencyRate": 1,
      "receiptInvoice": {
        "id": 301,
        "uuid": "6b1b8c9e-66e6-4fb5-b2db-6d7c7f0f8f19",
        "type": "invoice",
        "number": "20260001",
        "clientId": 101,
        "client": {
          "name": "Acme s.r.o.",
          "type": "company",
          "subjectId": "12345678",
          "taxId": "2020123456",
          "vatId": "SK2020123456",
          "isVatPayer": true,
          "email": "billing@acme.test",
          "street": "Hlavná 1",
          "city": "Bratislava",
          "zip": "81101",
          "countryId": 703,
          "country": {
            "id": 703,
            "name": "Slovensko",
            "code": "SK",
            "eu": true
          },
          "hasDeliveryAddress": true,
          "deliveryStreet": "Skladová 9",
          "deliveryCity": "Košice",
          "deliveryZip": "04001",
          "deliveryCountryId": 703,
          "deliveryCountry": {
            "id": 703,
            "name": "Slovensko",
            "code": "SK",
            "eu": true
          }
        },
        "issueDate": "2026-03-03",
        "dueDate": "2026-03-17",
        "deliveryDate": "2026-03-03",
        "currency": {
          "id": 1,
          "symbol": "EUR",
          "name": "Euro",
          "mark": "€"
        },
        "total": 200,
        "totalWithVat": 240,
        "toBePaid": 240,
        "status": "unpaid",
        "hasVat": true
      }
    }
  ],
  "variableSymbol": 20260001,
  "constantSymbol": 308,
  "specificSymbol": 55,
  "issueDate": "2026-03-03",
  "dueDate": "2026-03-17",
  "deliveryDate": "2026-03-03",
  "businessCaseId": 701,
  "discountType": "percentage",
  "discountValue": 10,
  "transferTaxLiability": false,
  "numericalSeriesId": 12,
  "deliveryMethodId": 1,
  "paymentMethodId": 1,
  "currencyId": 1,
  "currencyRate": 1,
  "languageId": 1,
  "qrTypeId": 1,
  "note": "Ďakujeme za objednávku.",
  "textAboveItems": "Dakujeme za spoluprácu.",
  "itemsTotal": 200,
  "itemsTotalWithVat": 240,
  "total": 200,
  "totalWithVat": 240,
  "toBePaid": 240,
  "status": "unpaid",
  "hasVat": true,
  "creditNotesSumTotalWithVat": 0,
  "items": [
    {
      "id": 1,
      "uuid": "6b1b8c9e-66e6-4fb5-b2db-6d7c7f0f8f19",
      "name": "Konzultácia",
      "description": "Mesačný balík konzultácií",
      "unitPrice": 100,
      "unitId": 1,
      "quantity": 2,
      "vatRate": 20,
      "discountName": "Vernostná zľava",
      "discountType": "percentage",
      "discountValue": 10,
      "priceListItemId": 501,
      "total": 200,
      "totalWithVat": 240
    }
  ]
}

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

Prehľad

Endpointy

Upraviť faktúru

Ako funguje update

Chybové stavy

Autorizace

Parametry cesty

Tělo

Odpověď