Přejít na hlavní obsah
GET
/
orders
Zoznam objednávok
curl --request GET \
  --url https://app.fintoro.sk/api/public/v1/orders \
  --header 'Authorization: Bearer <token>'
{
  "data": [
    {
      "id": 501,
      "uuid": "6b1b8c9e-66e6-4fb5-b2db-6d7c7f0f8f19",
      "type": "order",
      "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",
      "currency": {
        "id": 1,
        "symbol": "EUR",
        "name": "Euro",
        "mark": "€"
      },
      "total": 200,
      "totalWithVat": 240,
      "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 prefixu čísla dokladu. Backend používa prefix match, nie fulltext ani contains.

clientId
integer

Filter podľa klienta.

issueDateFrom
string<date>

Dátum vystavenia od.

issueDateTo
string<date>

Dátum vystavenia do.

totalFrom
number<float>

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

totalTo
number<float>

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

withoutInvoice
boolean

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

withoutProforma
boolean

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

sortBy
enum<string>
výchozí:issueDate

Pole pre triedenie.

Dostupné možnosti:
number,
issueDate,
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 objednávok v preview tvare.

data
object[]

Zoznam náhľadový objektov objednávok pre aktuálnu stránku.

paginator
object

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