Přejít na hlavní obsah
GET
/
quotations
Zoznam cenových ponúk
curl --request GET \
  --url https://app.fintoro.sk/api/public/v1/quotations \
  --header 'Authorization: Bearer <token>'
{
  "data": [
    {
      "id": 601,
      "uuid": "6b1b8c9e-66e6-4fb5-b2db-6d7c7f0f8f19",
      "type": "quotation",
      "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",
      "validityDate": "2026-04-02",
      "currency": {
        "id": 1,
        "symbol": "EUR",
        "name": "Euro",
        "mark": "€"
      },
      "total": 200,
      "totalWithVat": 240,
      "status": "waiting",
      "hasVat": true
    }
  ],
  "paginator": {
    "currentPage": 2,
    "perPage": 10,
    "totalPages": 5,
    "totalResults": 42,
    "currentFrom": 11,
    "currentTo": 20,
    "firstPageUrl": "https://app.fintoro.sk/api/public/v1/invoices?page=1",
    "lastPageUrl": "https://app.fintoro.sk/api/public/v1/invoices?page=5",
    "nextPageUrl": "https://app.fintoro.sk/api/public/v1/invoices?page=3",
    "previousPageUrl": "https://app.fintoro.sk/api/public/v1/invoices?page=1",
    "links": [
      {
        "url": "https://app.fintoro.sk/api/public/v1/invoices?page=2",
        "label": "2",
        "active": false
      }
    ]
  }
}

Autorizace

Authorization
string
header
povinné

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

Parametry dotazu

number
string

Filter podľa čísla dokladu. Backend používa contains match, nie prefix match.

clientId
integer

Filter podľa klienta.

issueDateFrom
string<date>

Dátum vystavenia od.

issueDateTo
string<date>

Dátum vystavenia do.

validityDateFrom
string<date>

Dátum platnosti od.

validityDateTo
string<date>

Dátum platnosti do.

status
enum<string>

Filter podľa stavu cenovej ponuky.

Dostupné možnosti:
waiting,
accepted,
rejected
totalFrom
number<float>

Minimálna celková suma s DPH po zľavách.

totalTo
number<float>

Maximálna celková suma s DPH po zľavách.

withoutInvoice
boolean

Ak je true, vrátia sa len cenové ponuky, ktoré ešte nemajú naviazanú finálnu faktúru.

withoutProforma
boolean

Ak je true, vrátia sa len cenové ponuky, ktoré ešte nemajú naviazanú zálohovú faktúru.

withoutOrder
boolean

Ak je true, vrátia sa len cenové ponuky, ktoré ešte nemajú naviazanú objednávku.

sortBy
enum<string>
výchozí:issueDate

Pole pre triedenie.

Dostupné možnosti:
number,
issueDate,
validityDate,
total,
totalWithVat
sortDirection
enum<string>
výchozí:desc

Smer triedenia.

Dostupné možnosti:
asc,
desc
perPage
integer
výchozí:10

Počet výsledkov na stránku.

Požadovaný rozsah: 1 <= x <= 500
page
integer
výchozí:1

Číslo stránky.

Požadovaný rozsah: x >= 1

Odpověď

Paginovaný zoznam cenových ponúk v preview tvare.

data
object[]

Zoznam náhľadový objektov cenových ponúk pre aktuálnu stránku.

paginator
object

Informácie o stránkovaní aktuálneho výsledku.