Přejít na obsah
FakturanetAPI v1.0.0
OpenAPI API klíče

Výdaje

Detail výdaje

GET/expenses/{id}

Vrátí záznam včetně položek.

Oprávnění klíče: expenses:read

Parametry

idintegerpovinnécesta

ID záznamu.

  • Minimum: 1
If-None-Matchstringhlavička

ETag z předchozího čtení. Když se záznam nezměnil, API vrátí 304 bez těla.

Odpovědi

200Záznam.

Hlavičky

X-Request-Id
ID požadavku pro podporu. Vlastní hodnotu z 8–64 písmen, číslic a . _ - API vrátí beze změny, jinak vytvoří novou.
RateLimit
Zbývající požadavky a sekundy do obnovení, např. "default";r=118;t=42.
RateLimit-Policy
Pravidlo limitu: "default";q=120;w=60.
ETag
Verze vrácené podoby záznamu. Pošlete ji v If-Match při změně, nebo v If-None-Match při dalším čtení.

application/json

dataExpensepovinné
401Chybí nebo neplatí API klíč.

Hlavičky

X-Request-Id
ID požadavku pro podporu. Vlastní hodnotu z 8–64 písmen, číslic a . _ - API vrátí beze změny, jinak vytvoří novou.
WWW-Authenticate
Bearer realm="Fakturanet API"

application/problem+json

Schéma: Problem

JSON · 401
{
  "type": "https://api.fakturanet.cz/#problem-unauthorized",
  "title": "Unauthorized",
  "status": 401,
  "detail": "Send an API key as \"Authorization: Bearer <key>\" or in the X-Api-Key header.",
  "request_id": "9f2c41d0a7b3e815"
}

Přehled typů chyb

403Chybí oprávnění, role nebo funkce tarifu.

Hlavičky

X-Request-Id
ID požadavku pro podporu. Vlastní hodnotu z 8–64 písmen, číslic a . _ - API vrátí beze změny, jinak vytvoří novou.

application/problem+json

Schéma: Problem

JSON · 403
{
  "type": "https://api.fakturanet.cz/#problem-insufficient-scope",
  "title": "Insufficient scope",
  "status": 403,
  "detail": "This API key does not have the invoices:write scope.",
  "request_id": "9f2c41d0a7b3e815"
}

Přehled typů chyb

404Záznam nenalezen.

Hlavičky

X-Request-Id
ID požadavku pro podporu. Vlastní hodnotu z 8–64 písmen, číslic a . _ - API vrátí beze změny, jinak vytvoří novou.

application/problem+json

Schéma: Problem

JSON · 404
{
  "type": "https://api.fakturanet.cz/#problem-not-found",
  "title": "Not found",
  "status": 404,
  "detail": "The requested record does not exist.",
  "request_id": "9f2c41d0a7b3e815"
}

Přehled typů chyb

429Překročen limit požadavků.

Hlavičky

X-Request-Id
ID požadavku pro podporu. Vlastní hodnotu z 8–64 písmen, číslic a . _ - API vrátí beze změny, jinak vytvoří novou.
Retry-After
Sekundy do dalšího pokusu.

application/problem+json

Schéma: Problem

JSON · 429
{
  "type": "https://api.fakturanet.cz/#problem-rate-limited",
  "title": "Too many requests",
  "status": 429,
  "detail": "The limit is 120 requests per 60 seconds per key. Retry in 42 s.",
  "request_id": "9f2c41d0a7b3e815"
}

Přehled typů chyb

500Neočekávaná chyba.

Hlavičky

X-Request-Id
ID požadavku pro podporu. Vlastní hodnotu z 8–64 písmen, číslic a . _ - API vrátí beze změny, jinak vytvoří novou.

application/problem+json

Schéma: Problem

JSON · 500
{
  "type": "https://api.fakturanet.cz/#problem-server-error",
  "title": "Server error",
  "status": 500,
  "detail": "The request could not be completed. Quote request ID 9f2c41d0a7b3e815 when contacting support.",
  "request_id": "9f2c41d0a7b3e815"
}

Přehled typů chyb

304Záznam se od čtení s daným `ETag` nezměnil. Odpověď nemá tělo.

Hlavičky

ETag
Verze vrácené podoby záznamu. Pošlete ji v If-Match při změně, nebo v If-None-Match při dalším čtení.

Odpověď nemá tělo.

Požadavek · cURL
curl "https://api.fakturanet.cz/v1/expenses/123" \
  -H "Authorization: Bearer $FAKTURANET_API_KEY" \
  -H "Content-Type: application/json" \
  --data-raw '"{\n  \"type\": \"https://api.fakturanet.cz/#problem-server-error\",\n  \"title\": \"Server error\",\n  \"status\": 500,\n  \"detail\": \"The request could not be completed. Quote request ID 9f2c41d0a7b3e815 when contacting support.\",\n  \"request_id\": \"9f2c41d0a7b3e815\"\n}"'
Požadavek · PHP
<?php
declare(strict_types=1);

$key = getenv('FAKTURANET_API_KEY');
if (!$key) { throw new RuntimeException('Nastavte FAKTURANET_API_KEY.'); }

$headers = ["Authorization: Bearer $key"];
$headers[] = 'Content-Type: application/json';
$body = <<<'JSON'
"{\n  \"type\": \"https://api.fakturanet.cz/#problem-server-error\",\n  \"title\": \"Server error\",\n  \"status\": 500,\n  \"detail\": \"The request could not be completed. Quote request ID 9f2c41d0a7b3e815 when contacting support.\",\n  \"request_id\": \"9f2c41d0a7b3e815\"\n}"
JSON;

$ch = curl_init('https://api.fakturanet.cz/v1/expenses/123');
curl_setopt_array($ch, [
    CURLOPT_CUSTOMREQUEST => 'GET',
    CURLOPT_HTTPHEADER => $headers,
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_CONNECTTIMEOUT => 10,
    CURLOPT_TIMEOUT => 30,
    CURLOPT_POSTFIELDS => $body,
]);
$response = curl_exec($ch);
$status = curl_getinfo($ch, CURLINFO_RESPONSE_CODE);
if ($response === false) { throw new RuntimeException(curl_error($ch)); }
if ($status >= 400) { throw new RuntimeException('HTTP ' . $status . ': ' . $response); }
$data = json_decode($response, true, 512, JSON_THROW_ON_ERROR);

ID 123 nahraďte ID svého záznamu.

Odpověď · 200
{
  "data": {
    "id": 123,
    "supplier_contact_id": 123,
    "supplier_snapshot": {
      "name": "Jan Novák",
      "company_no": "",
      "vat_no": "",
      "street": "",
      "city": "Praha",
      "zip": "",
      "email": "jan.novak@example.com",
      "phone": "",
      "web": "",
      "country": "CZ"
    },
    "number": "V2026110002",
    "supplier_doc_no": "2026-018",
    "issue_date": "2026-11-10",
    "supply_date": "2026-11-10",
    "vat_claim_date": "2026-11-10",
    "due_date": "2026-11-24",
    "currency": "CZK",
    "exchange_rate": "1",
    "note": null,
    "total_net": "5000",
    "total_vat": "0",
    "total_gross": "5000",
    "deductible_vat": "0",
    "status": "unpaid",
    "created_at": "2026-11-18T10:15:00+01:00",
    "paid_at": null,
    "supplier_check": null,
    "vat_regime": "domestic",
    "reverse_charge_code": null,
    "items": [
      {
        "id": 1,
        "position": 0,
        "quantity": "1",
        "unit": "ks",
        "description": "Grafický návrh",
        "vat_rate": "0",
        "unit_price": "5000",
        "net": "5000",
        "vat": "0",
        "gross": "5000",
        "tax_deductible": false,
        "deduction_pct": "100",
        "deductible_vat": "0"
      }
    ],
    "updated_at": "2026-11-18T10:15:00+01:00",
    "deleted_at": null
  }
}

Hledat v dokumentaci

Hledejte endpoint, pole, objekt, typ chyby nebo téma příručky.