Detail výdaje
GET/expenses/{id}
Vrátí záznam včetně položek.
Oprávnění klíče: expenses:read
Parametry
idintegerpovinnécestaID záznamu.
- Minimum:
1
If-None-MatchstringhlavičkaETag 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-Matchpři změně, nebo vIf-None-Matchpři dalším čtení.
application/json
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-AuthenticateBearer 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"
}
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"
}
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"
}
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"
}
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"
}
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-Matchpři změně, nebo vIf-None-Matchpř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
}
}