Základná URL
https://{tenant}.logzi.com/api/receipt_file/
Každá požiadavka vracia odpoveď vo formáte JSON. Pri úspešnej odpovedi je result.code == 1, pri chybe result.code == 0. Súbor dokladu je binárny súbor priložený k dokladu (faktúra, objednávka, zmluva atď.) — uložený s obsahom kódovaným v base64.
/api/receipt_file/get
Získanie jedného súboru dokladu podľa identifikátora.
Query parametre
| Parameter | Typ | Povinné | Popis |
|---|---|---|---|
id | int | Identifikátor záznamu súboru |
Príklad požiadavky
GET /api/receipt_file/get?id=10
X-API-KEY: {vas_api_kluc}
/api/receipt_file/list
Stránkovateľný zoznam súborov dokladov s možnosťou filtrovania.
Query parametre
| Parameter | Typ | Povinné | Popis |
|---|---|---|---|
list_offset | int | Posun stránkovania (predvolené: 0) | |
list_condition[receipt_id] | int | Filtrovanie podľa identifikátora dokladu | |
list_condition[receipt_type_id] | int | Filtrovanie podľa typu dokladu | |
list_condition[partner_id] | int | Filtrovanie všetkých súborov dokladov partnera |
Príklad požiadavky
GET /api/receipt_file/list?list_condition[receipt_id]=150&list_condition[receipt_type_id]=8
X-API-KEY: {vas_api_kluc}
/api/receipt_file/list_light
Odľahčený zoznam súborov dokladov — bez obsahu súboru (file_source), iba s metaúdajmi.
Query parametre
| Parameter | Typ | Povinné | Popis |
|---|---|---|---|
list_offset | int | Posun stránkovania (predvolené: 0) | |
list_condition | object | Filtrovacie podmienky (rovnako ako pri koncovom bode /list) |
Príklad požiadavky
GET /api/receipt_file/list_light?list_condition[receipt_id]=150&list_condition[receipt_type_id]=8
X-API-KEY: {vas_api_kluc}
/api/receipt_file/save
Nahratie súboru alebo úprava existujúceho. Pre nový súbor data[id] = 0.
POST polia — objekt data
| Pole | Typ | Povinné | Popis |
|---|---|---|---|
id | int | 0 = nový súbor, >0 = úprava | |
receipt_type_id | int | Identifikátor typu dokladu | |
receipt_id | int | Identifikátor dokladu | |
file_name | string | Názov súboru s príponou (napr. szamla.pdf) | |
file_source | string | Obsah súboru kódovaný v base64 | |
file_type_id | int | Identifikátor typu súboru (predvolené: 1) | |
file_classification_id | int | Identifikátor klasifikácie súboru |
Príklad požiadavky
POST /api/receipt_file/save
X-API-KEY: {vas_api_kluc}
Content-Type: application/json
{
"data": {
"id": 0,
"receipt_type_id": 8,
"receipt_id": 150,
"file_name": "szamla_150.pdf",
"file_source": "JVBERi0x..."
}
}
/api/receipt_file/delete
Odstránenie súboru dokladu podľa identifikátora.
POST polia — objekt data
| Pole | Typ | Povinné | Popis |
|---|---|---|---|
id | int | Identifikátor súboru, ktorý sa má odstrániť |
Príklad požiadavky
POST /api/receipt_file/delete
X-API-KEY: {vas_api_kluc}
Content-Type: application/json
{ "data": { "id": 10 } }
Zaregistruj sa teraz,
zaplať neskôr!