OrderOS API

REST API s verejnou dokumentáciou — fakturáciu napojíte na e-shop, interný systém alebo automatizáciu bez čakania na obchodníka.

API referencia openapi.yaml

Zdroje REST · JSON · Bearer

POST/api/invoices

GET/api/invoices/{id}/pdf

POST/api/invoices/{id}/mark-paid

GET/api/clients

GET/api/orders

POST/api/webhooks

Rozsah

Čo cez API viete robiť

/invoices

Faktúry

Vystavovanie, čítanie, označovanie úhrad, PDF.

/clients

Klienti

Správa odberateľov vrátane fakturačných údajov.

/products

Produkty

Cenník a položky dokladov.

/orders

Objednávky

Celý objednávkový tok, z ktorého faktúra vzniká.

/webhooks

Webhooky

Notifikácie o udalostiach do vášho systému.

Dokumentácia

Dokumentácia bez prihlásenia

Kompletná referencia aj špecifikácia sú verejné:

API referenciaEndpointy, parametre, príklady požiadaviek a odpovedí. OpenAPI špecifikáciaStrojovo čitateľný popis celého API (vygenerujete si z neho klienta v ľubovoľnom jazyku).

Prístup

Autentifikácia

API tokeny si vytvoríte priamo v nastaveniach OrderOS — každý token má vlastné meno, takže v histórii dokladu vidíte, ktorá integrácia ho vytvorila. Autentifikácia je štandardný Bearer token.

Nastavenia · API tokeny

E-shop Shoptetpoužitý pred 4 min••••3f9a

Make – objednávkypoužitý včera••••b21c

Interný CRMpoužitý 12. 09. 2026••••7e04

Authorization: Bearer ••••••••3f9a

Príklad

Príklad: vystavenie faktúry

Faktúru vystavíte jedným POST požiadavkom s položkami; OrderOS dopočíta DPH, pridelí číslo z vášho číselného radu a vráti kompletný doklad — PDF stiahnete z /api/invoices/{id}/pdf. Podrobné príklady nájdete v referencii.

Požiadavka

curl -X POST https://app.orderos.sk/api/invoices \
  -H "Authorization: Bearer $ORDEROS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "client_id": 8421,
    "items": [
      { "name": "Kytica – svadobná", "quantity": 2,
        "unit_price": 600.00, "tax_rate": 23 }
    ]
  }'

const res = await fetch("https://app.orderos.sk/api/invoices", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.ORDEROS_TOKEN}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    client_id: 8421,
    items: [
      { name: "Kytica – svadobná", quantity: 2,
        unit_price: 600.0, tax_rate: 23 },
    ],
  }),
});
const { data: invoice } = await res.json();

import os, requests

invoice = requests.post(
    "https://app.orderos.sk/api/invoices",
    headers={"Authorization": f"Bearer {os.environ['ORDEROS_TOKEN']}"},
    json={
        "client_id": 8421,
        "items": [
            {"name": "Kytica – svadobná", "quantity": 2,
             "unit_price": 600.00, "tax_rate": 23}
        ],
    },
).json()["data"]

Odpoveď 201 Created

{
  "data": {
    "id": 31402,
    "invoice_number": "2026031",
    "status": "issued",
    "client_id": 8421,
    "subtotal": 1200.00,
    "tax_total": 276.00,
    "grand_total": 1476.00,
    "currency": "EUR",
    "due_date": "2026-10-07",
    "variable_symbol": "2026031"
  }
}

Začnite integrovať

Zaregistrujte firmu, vytvorte si API token a prvý request pošlete do pár minút.

Registrovať sa zadarmo