https://www.faktury-online.com/api/nf?data={JSON}Nasledujúce tabuľky uvádzajú zoznam parametrov, pomocou ktorých môžete vytvoriť novú faktúru.
Parameter | Atribút | Popis |
---|---|---|
key | povinný parameter | API kľúč. |
povinný parameter | Email (alebo používateľské meno), ktorým sa prihlasujete do Faktúr online. | |
apitest | nepovinný parameter | Parameter apitest určuje, či vytvorená faktúra/dokument slúži na testovacie účely. Tento parameter by mal slúžiť iba vývojárom, ktorý implementujú Faktúry online API. Systém bude brať vytvorenú faktúru ako testovaciu a v rozmedzí 5 – 10 minút ju odstráni. Odporúčame mať túto hodnotu zapnutú pri testovaní nasadzovania API. V produkčnej prevádzke túto hodnotu vypnite, inak sa faktúry odstránia automaticky. Možné hodnoty: 1 alebo 0 Predvolená hodnota: 0 |
Parameter | Atribút | Popis |
---|---|---|
d_id | možnosť 1 / povinný paramater | ID dodávateľa (ID nájdete v zozname Moje spoločnosti). |
d_name | možnosť 2 / povinný paramater | Obchodný názov dodávateľa. |
d_street | možnosť 2 / nepovinný paramater | Ulica dodávateľa. |
d_city | možnosť 2 / nepovinný paramater | Mesto dodávateľa. |
d_state | možnosť 2 / nepovinný paramater | Štát dodávateľa. |
d_zip | možnosť 2 / nepovinný paramater | PSČ dodávateľa. |
d_ico | možnosť 2 / nepovinný paramater | IČO dodávateľa. |
d_dic | možnosť 2 / nepovinný paramater | DIČ dodávateľa. |
d_icdph | možnosť 2 / nepovinný paramater | IČDPH dodávateľa. |
d_vatpayer | možnosť 2 / nepovinný paramater | Platca DPH. Možné hodnoty: Platca DPH: 1 Neplatca DPH: 0 Predvolená hodnota: 0 |
d_viewpayer | možnosť 2 / nepovinný paramater | Zobraziť na faktúre informáciu, či je dodávateľ platcom DPH. Možné hodnoty: Áno: 1 Nie: 0 Predvolená hodnota: 1 |
d_info | možnosť 2 / nepovinný paramater | Info o dodávateľovi. |
d_bankaccount | možnosť 2 / nepovinný paramater | Číslo účtu dodávateľa. |
d_bank | možnosť 2 / nepovinný paramater | Názov banky dodávateľa. |
d_iban | možnosť 2 / nepovinný paramater | IBAN dodávateľa. |
d_swift | možnosť 2 / nepovinný paramater | SWIFT dodávateľa. |
d_email | možnosť 2 / nepovinný paramater | Email dodávateľa. |
d_web | možnosť 2 / nepovinný paramater | Web dodávateľa. |
d_phone | možnosť 2 / nepovinný paramater | Telefón dodávateľa. |
Parameter | Atribút | Popis |
---|---|---|
o_name | povinný paramater | Obchodný názov odberateľa. |
o_street | nepovinný paramater | Ulica odberateľa. |
o_city | nepovinný paramater | Mesto odberateľa. |
o_state | nepovinný paramater | Štát odberateľa. |
o_zip | nepovinný paramater | PSČ odberateľa. |
o_ico | nepovinný paramater | IČO odberateľa. |
o_dic | nepovinný paramater | DIČ odberateľa. |
o_icdph | nepovinný paramater | IČDPH odberateľa. |
o_email | nepovinný paramater | Email odberateľa. |
o_name_d | nepovinný paramater | Adresa dodania - Obchodný názov. |
o_street_d | nepovinný paramater | Adresa dodania - Ulica. |
o_city_d | nepovinný paramater | Adresa dodania - Mesto. |
o_state_d | nepovinný paramater | Adresa dodania - Štát. |
o_zip_d | nepovinný paramater | Adresa dodania - PSČ. |
Parameter | Atribút | Popis |
---|---|---|
f_number | nepovinný paramater | Číslo faktúry. Ak nie je vyplnené, číslo sa automaticky zvýši o 1 z posledne vytvorenej faktúry (rozhodujúci je dátum vystavenia, číslo faktúry musí mať numerický formát). |
f_vs | nepovinný paramater | Variabilný symbol. |
f_ks | nepovinný paramater | Konštantný symbol. |
f_date_issue | nepovinný paramater | Dátum vystavenia. Vo formáte RRRR-MM-DD. Predvolená hodnota: Aktuálny dátum |
f_date_delivery | nepovinný paramater | Dátum dodania. Vo formáte RRRR-MM-DD. Predvolená hodnota: Aktuálny dátum |
f_date_due | nepovinný paramater | Dátum splatnosti. Vo formáte RRRR-MM-DD. Predvolená hodnota: 14 dní od aktuálneho dátumu |
f_issued_by | nepovinný paramater | Faktúru vystavil. |
f_order | nepovinný paramater | Číslo objednávky. |
f_payment | nepovinný paramater | Typ úhrady. Možné hodnoty: Peňažný prevod: prevod Poštová poukážka: poukazka Hotovosť: hotovost Dobierka: dobierka Registračná pokladňa: pokladna Internetový platobný poskytovateľ: eprovider Platobná karta: karta Zápočet: zapocet Iná: ina Predvolená hodnota: prevod |
f_note | nepovinný paramater | Poznámka vo faktúre. Zobrazenie poznámky pod fakturačnými položkami. V prípade, že je dodávateľ vybraný pomocou parametra d_id a f_note je prázdne, zobrazí sa príslušná uložená poznámka k tomuto dodávateľovi. |
f_logo | nepovinný paramater | Zobrazenie loga. Možné hodnoty: Nezobrazí sa: 0 Zobrazí sa: 1 (iba v prípade, že dodávateľ bol načítaný pomocou d_id a logo má uložené) |
f_stamp | nepovinný paramater | Zobrazenie pečiatky. Možné hodnoty: Nezobrazí sa: 0 Zobrazí sa: 1 (iba v prípade, že dodávateľ bol načítaný pomocou d_id a pečiatku má uloženú) |
f_currency | nepovinný paramater | Mena na faktúre. Označenie meny. Predvolená hodnota je EUR. Predvolená hodnota: EUR |
f_proforma | nepovinný paramater | Zálohova faktúra. V prípade, že sa jedná o zálohovu faktúru, je potrebné vložiť hodnotu 1. Predvolená hodnota: 0 |
f_paid | nepovinný paramater | Už uhradené. Suma. Predvolená hodnota: 0 |
f_style | nepovinný paramater | Vizuálny štýl faktúry. Možné hodnoty: styl_1 styl_2 styl_3 styl_4 styl_5 styl_6 clear Predvolená hodnota: styl_1 |
f_language | nepovinný paramater | Jazyk faktúry. Možné hodnoty: SK, EN, DE, CZ, FR, ES, IT, HU, PL, RU, NO Predvolená hodnota: SK |
f_qr | nepovinný paramater | Zobraziť QR kód platby. Možné hodnoty: 1 0 Predvolená hodnota: 1 |
f_omit_stats | nepovinný paramater | Vynechať hodnotu zo štatistiky. Možné hodnoty: 0 1 Predvolená hodnota: 0 |
f_custom | nepovinný paramater | Ľubovoľná textová informácia odoslaná cez API. Zobrazí sa ako samostatný stĺpec v excelovskom exporte. text, max. 50 znakov |
Parameter | Atribút | Popis |
---|---|---|
p_text | povinný paramater | Text fakturačnej položky. |
p_quantity | povinný paramater | Množstvo. Číslo. |
p_unit | povinný paramater | Merná jednotka. Napríklad kg, ks,... |
p_price | možnosť 1 / nepovinný paramater | Cena za jednu mernú jednotku bez dane. Na základe tejto hodnoty sa vypočíta cena s DPH. V príde, že tento atribút nie je zadaný, musí byť zadaný atribút p_pricevat. Pre neplatcov DPH je tento parameter povinný. |
p_vat | nepovinný paramater | Daň v percentách. Vypĺňa sa iba vtedy, ak je dodávateľ platca DPH. |
p_pricevat | možnosť 2 / nepovinný paramater | Cena za jednu mernú jednotku vrátane dane. V prípade, že je tento atribút zadaný, vypočíta sa cena bez dane bez ohľadu, či bol atribút p_price zadaný. |
p_custom | nepovinný paramater | Ľubovoľná textová informácia odoslaná cez API pre položku faktúry. Zobrazí sa ako samostatný stĺpec v excelovskom exporte. text, max. 50 znakov |
Array ( [key] => dJyMc*53@687*wGhofIWi!WDcEEQUdmj [email] => name@example.com [apitest] => 1 [d] => Array ( [d_name] => Moja spoločnosť s.r.o. [d_street] => Mostová 56 [d_city] => Trenčín [d_zip] => 843 21 [d_state] => Slovenská republika [d_ico] => 43226520 [d_dic] => 2165052345 [d_icdph] => SK2165052345 [d_vatpayer] => 1 [d_viewpayer] => 0 [d_info] => Zapísaný v OR Trenčín,oddiel:Sro, vl.č.1234/X [d_bankaccount] => 1234567890/0200 [d_bank] => VÚB [d_iban] => [d_swift] => [d_email] => info@example.com [d_web] => www.example.com [d_phone] => +421 903 111 111 ) [o] => Array ( [o_name] => Andrej Klačanský [o_street] => Štefánikova 455/2 [o_city] => Martin [o_zip] => 876 54 [o_state] => [o_ico] => [o_dic] => [o_icdph] => [o_email] => client@example.com ) [f] => Array ( [f_number] => 2015099 [f_vs] => 2015099 [f_ks] => 308 [f_date_issue] => 2015-02-14 [f_date_delivery] => 2015-02-14 [f_date_due] => 2015-02-28 [f_issued_by] => Moja spoločnosť s.r.o. [f_payment] => prevod [f_logo] => 0 [f_stamp] => 1 [f_currency] => EUR [f_proforma] => 0 [f_paid] => [f_style] => standard [f_language] => SK [f_qr] => 1 [f_order] => OBJ-2019-514 ) [p] => Array ( [0] => Array ( [p_text] => Maliarske práce [p_quantity] => 3 [p_unit] => hod [p_price] => 15 [p_vat] => 20 ) [1] => Array ( [p_text] => Upratovacie práce [p_quantity] => 2 [p_unit] => hod [p_vat] => 20 [p_pricevat] => 14.4 ) ) )
Status ID | Význam | Popis |
---|---|---|
1 | OK | Všetko prebehlo v poriadku, faktúra bola vytvorená |
2 | Chyba | Parameter data nebol odoslaný metódou GET. |
3 | Chyba | API kľúč nie je zadaný alebo nie je platný počet znakov. |
4 | Chyba | API kľúč nie je zadaný správne. |
5 | Chyba | Parameter email nie je zadaný. |
6 | Chyba | Používateľské meno alebo API kľúč nie sú uvedené správne. |
7 | Chyba | Používateľ neexistuje. |
8 | Chyba | Potrebné zadať ID dodávateľa alebo jeho názov.. |
9 | Chyba | Zrušené |
10 | Chyba | Vložené ID dodávateľa nie je správne. |
11 | Chyba | Nie je zadané meno dodávateľa. |
12 | Chyba | Nie je zadané meno odberateľa. |
13 | Chyba | Chýbajú fakturačné údaje. |
14 | Chyba | Chýbajú položky faktúry alebo nie sú zadané správne. |
15 | Chyba | Chyba vo fakturačnej položke chýba povinný údaj. |
16 | Chyba | Množstvo vo fakturačnej položke nie je číslo. |
17 | Chyba | Cena bez dane vo fakturačnej položke nie je číslo. |
18 | Chyba | Daň v percentách nie je zadaná správne. |
19 | Chyba | Vo fakturačnej položke nie je vložená cena bez dane alebo cena vrátane dane. |
20 | Chyba | Nepovolený jazyk vo faktúre. |
21 | Chyba | Vo fakturačnej položke nie je vložená cena bez dane, pričom dodávateľ nie je platcom DPH. |
22 | Chyba | Cena vrátane dane vo fakturačnej položke nie je číslo. |
<?php // Príprava základných dát: $data = array(); // Váš API kľúč: $data['key'] = "dJyMc*53@687*wGhofIWi!WDcEEQUdmj"; // Váš email (príp. používateľské meno): $data['email'] = "name@example.com"; // V prípade, že budeme testovať API, zvolíme hodnotu 1 // Znamená to, že všetky vytvorené faktúry sa automaticky odstránia o 5 - 10 minút a nebudú sa // započítavať k skutočne vytvoreným faktúram. $data['apitest'] = 1; //hodnota môže byť 1 alebo 0 // Príprava dát dodávateľa $dodavatel = array(); // Dodávateľa môžeme použiť už existujúceho (uloženého v zozname Moje spoločnosti) // alebo dodávateľa vytvoríme ručne vložením dát. // Ak použijeme existujúceho dodávateľa, vložíme iba jeho ID: // $dodavatel['d_id'] = 123; // ID dodávateľa nájdeme v zozname Moje spoločnosti // alebo (nie obe): $dodavatel['d_name'] = "Moja spoločnosť s.r.o."; // Obchodný názov dodávateľa $dodavatel['d_street'] = "Mostová 56"; // Ulica $dodavatel['d_city'] = "Trenčín"; // Mesto $dodavatel['d_zip'] = "843 21"; // PSČ $dodavatel['d_state'] = "Slovenská republika"; // Štát $dodavatel['d_ico'] = "43226520"; // IČO $dodavatel['d_dic'] = "2165052345"; // DIČ $dodavatel['d_icdph'] = "SK2165052345"; // IČDPH $dodavatel['d_vatpayer'] = "1"; // Platca DPH. Pokiaľ je dodávateľ platca DPH ponechajte hodnotu 1, // ak nie je platca DPH, napíšte 0. $dodavatel['d_viewpayer'] = "0"; // Pokiaľ nechcete zobraziť informáciu na faktúre, // že dodávateľ je alebo nie je platcom DPH. $dodavatel['d_info'] = "Zapísaný v OR Trenčín,oddiel:Sro, vl.č.1234/X"; //Info o dodávateľovi $dodavatel['d_bankaccount'] = "1234567890/0200"; // Číslo účtu $dodavatel['d_bank'] = "VÚB"; // Názov banky $dodavatel['d_iban'] = ""; // IBAN $dodavatel['d_swift'] = ""; // SWIFT $dodavatel['d_email'] = "info@example.com"; // E-mail $dodavatel['d_web'] = "www.example.com"; // WEB $dodavatel['d_phone'] = "+421 903 111 111"; // Telefón // Pridanie dodávateľa k dátam: $data['d'] = $dodavatel; // Príprava dát odberateľa $odberatel = array(); $odberatel['o_name'] = "Andrej Klačanský"; // Názov odberateľa $odberatel['o_street'] = "Štefánikova 455/2"; // Ulica $odberatel['o_city'] = "Martin"; // Mesto $odberatel['o_zip'] = "876 54"; // PSČ $odberatel['o_state'] = ""; // Štát $odberatel['o_ico'] = ""; // IČO $odberatel['o_dic'] = ""; // DIČ $odberatel['o_icdph'] = ""; // IČDPH $odberatel['o_email'] = "client@example.com"; // Email odberateľa // Pridanie odberateľa k dátam: $data['o'] = $odberatel; // Príprava fakturačných údajov $faktura = array(); // Číslo faktúry môžeme zadať ručne: $faktura['f_number'] = "2017099"; // Ak chceme vypočítať číslo automaticky, toto pole neuvedieme $faktura['f_vs'] = "2017099"; // Variabilný symbol $faktura['f_ks'] = "308"; // Konštantný symbol $faktura['f_date_issue'] = '2017-02-14'; // Dátum vystavenia vo formáte RRRR-MM-DD $faktura['f_date_delivery'] = '2017-02-14'; // Dátum dodania vo formáte RRRR-MM-DD $faktura['f_date_due'] = '2017-02-28'; // Dátum splatnosti vo formáte RRRR-MM-DD $faktura['f_issued_by'] = "Moja spoločnosť s.r.o."; //Faktúru vystavil $faktura['f_payment'] = "prevod"; //Druh plaby. Na výber sú "prevod", "poukazka", // "hotovost", "dobierka", "registracna_pokladna", "ina", // "eprovider" $faktura['f_logo'] = "0"; // Zobraziť logo dodávateľa. Iba v prípade, že bol dodávateľ //vybraný pomocou ID a má priradené logo $faktura['f_stamp'] = "1"; // Zobraziť pečiatku dodávateľa. Iba v prípade, že bol // dodávateľ vybraný pomocou ID a má priradenú pečiatku $faktura['f_currency'] = "EUR"; //Mena faktúry $faktura['f_proforma'] = "0"; // Zálohová faktúra. Ak je zálohová, potom hodnota 1 $faktura['f_paid'] = ""; // Už uhradená suma $faktura['f_style'] = "standard"; // Štýl faktúry. Možnosti sú standard alebo classic $faktura['f_language'] = "SK"; // Jazyk faktúry: SK, CZ, EN, DE, ES, IT, FR, HU, PL, NO, RU $faktura['f_qr'] = "1"; // Zobraziť QR kód (PAY by square) $faktura['f_order'] = "OBJ-2017-514"; //Číslo objednávky // Pridanie fakturačných údajov k dátam: $data['f'] = $faktura; // Príprava fakturačných položiek $polozky = array(); // prvá položka: $polozka = array(); $polozka['p_text'] = "Maliarske práce"; // Názov služby alebo tovaru $polozka['p_quantity'] = "3"; // Množstvo $polozka['p_unit'] = "hod"; // Merná jednotka $polozka['p_price'] = "15"; // Cena za jednu jednotku bez DPH (Cena s DPH sa vypočíta) $polozka['p_vat'] = "20"; // Daň v % // priradenie k položkám: $polozky[] = $polozka; // druhá položka: $polozka = array(); $polozka['p_text'] = "Upratovacie práce"; // Názov služby alebo tovaru $polozka['p_quantity'] = "2"; // Množstvo $polozka['p_unit'] = "hod"; // Merná jednotka $polozka['p_vat'] = "20"; // Daň v % $polozka['p_pricevat'] = "14.4"; // Cena za jednu jednotku vrátane DPH (Cena bez DPH sa vypočíta) // priradenie k položkám: $polozky[] = $polozka; // priradenie fakturačných položiek k dátam: $data['p'] = $polozky; // Dáta sa uložia do formátu JSON: $data_json = json_encode($data); // Dáta sa odošlú: $url = 'https://www.faktury-online.com/api/nf?data=' . urlencode($data_json); $ch = curl_init(); curl_setopt($ch, CURLOPT_URL, $url); curl_setopt($ch, CURLOPT_COOKIESESSION, true); curl_setopt($ch, CURLOPT_RETURNTRANSFER, true); curl_setopt($ch, CURLOPT_CONNECTTIMEOUT, 5); $output = curl_exec($ch); // Výsledok: $result = json_decode($output, true); if ($result['status'] == 1) { echo "Uložené, nová faktúra má kód: " . $result['code'] . " <br />"; echo "Číslo faktúry: " . $result['number'] . " <br />"; echo "Faktúra vytvorená: " . $result['created'] . " <br />"; } else { echo "Vyskytla sa chyba č." . $result['status']; }
Array ( [status] => 1 [code] => 1a35b89cd48eaf8940a6409ff45a0cc5 [number] => FA2019015 [created] => 2019-02-15 17:45:12 )
https://www.faktury-online.com/api/init?data={JSON}
Parameter | Atribút | Popis |
---|---|---|
key | povinný parameter | API kľúč. |
povinný parameter | Email (alebo používateľské meno), ktorým sa prihlasujete do Faktúr online. |
Array ( [key] => vJyMc*4@2754*wGhofIWi!QDcEEQUdmj [email] => name@example.com )
Status ID | Význam | Popis |
---|---|---|
1 | OK | Všetko prebehlo v poriadku, inicializácia sedenia bola vytvorená |
102 | Chyba | Parameter data nebol odoslaný metódou GET. |
103 | Chyba | API kľúč nie je zadaný alebo nie je platný počet reťazcov. |
104 | Chyba | API kľúč nie je zadaný správne. |
105 | Chyba | Parameter email nie je zadaný. |
106 | Chyba | Používateľské meno alebo API kľúč nie sú uvedené správne. |
107 | Chyba | Používateľ neexistuje. |
<?php // Príprava základných dát: $data = array(); // Váš API kľúč: $data['key'] = "dJyMc*53@687*wGhofIWi!WDcEEQUdmj"; // Váš email (príp. používateľské meno): $data['email'] = "name@example.com"; // Dáta sa uložia do formátu JSON: $data_json = json_encode($data); // Inicializácia sedenia $url = 'https://www.faktury-online.com/api/init?data=' . urlencode($data_json); $ch = curl_init(); curl_setopt($ch, CURLOPT_URL, $url); curl_setopt($ch, CURLOPT_COOKIESESSION, true); curl_setopt($ch, CURLOPT_COOKIEJAR, 'cookie.txt'); curl_setopt($ch, CURLOPT_RETURNTRANSFER, true); curl_setopt($ch, CURLOPT_CONNECTTIMEOUT, 5); $output = curl_exec($ch); $result = json_decode($output, true); // Výsledok: $result = json_decode($output, true); if ($result['status'] == 1) { echo "Sedenie bolo vytvorené"; } else { echo "Vyskytla sa chyba č." . $result['status']; }
Array ( [status] => 1 )
https://www.faktury-online.com/api/zf?data={JSON}
Parameter | Atribút | Popis |
---|---|---|
key | povinný parameter | API kľúč. |
povinný parameter | Email (alebo používateľské meno), ktorým sa prihlasujete do Faktúr online. | |
code | povinný parameter | kód faktúry (získaný z odpovede API vytvorenia faktúry) |
Array ( [key] => vJyMc*4@2754*wGhofIWi!QDcEEQUdmj [email] => name@example.com [code] => 26915945a67c8b7ba74dac59c5badfbf )
Status ID | Význam | Popis |
---|---|---|
1 | OK | Všetko prebehlo v poriadku |
202 | Chyba | Parameter data nebol odoslaný metódou GET. |
203 | Chyba | API kľúč nie je zadaný alebo nie je platný počet reťazcov. |
204 | Chyba | API kľúč nie je zadaný správne. |
205 | Chyba | Parameter email nie je zadaný. |
206 | Chyba | Nie je vytvorené sedenie |
207 | Chyba | Vytvorené sedenie nie je správne |
208 | Chyba | Používateľské meno alebo API kľúč nie sú uvedené správne. |
209 | Chyba | Používateľ neexistuje. |
210 | Chyba | Nie je zadaný kód faktúry. |
211 | Chyba | Kód faktúry nie je zadaný správne. |
212 | Chyba | Chyba pri výbere faktúry |
213 | Chyba | Chyba pri zobrazení šablóny faktúry |
<?php // Príprava základných dát: $data = array(); // Váš API kľúč: $data['key'] = "dJyMc*53@687*wGhofIWi!WDcEEQUdmj"; // Váš email (príp. používateľské meno): $data['email'] = "name@example.com"; // Dáta sa uložia do formátu JSON: $data_json = json_encode($data); // Inicializácia sedenia $url = 'https://www.faktury-online.com/api/init?data=' . urlencode($data_json); $ch = curl_init(); curl_setopt($ch, CURLOPT_URL, $url); curl_setopt($ch, CURLOPT_COOKIESESSION, true); // vytvori subor cookie.txt, pozor na prava na zapis curl_setopt($ch, CURLOPT_COOKIEJAR, 'cookie.txt'); curl_setopt($ch, CURLOPT_RETURNTRANSFER, true); curl_setopt($ch, CURLOPT_CONNECTTIMEOUT, 5); $output = curl_exec($ch); $result = json_decode($output, true); // Výsledok: $result = json_decode($output, true); if ($result['status'] != 1) { throw new Exception("Vyskytla sa chyba č. " . $result['status']); } // Kód faktúry: $data['code'] = "14915945a66c8b7be74dac59c5badfbf"; // Dáta sa uložia do formátu JSON: $data_json = json_encode($data); // Dáta sa odošlú: $url = 'https://www.faktury-online.com/api/zf?data=' . urlencode($data_json); curl_setopt($ch, CURLOPT_URL, $url); $output = curl_exec($ch); $result = json_decode($output, true); $url = $result['url']; $cislo = $result['number']; // Výsledok: $result = json_decode($output, true); if ($result['status'] != 1) { throw new Exception("Vyskytla sa chyba č. " . $result['status']); } // pre zobrazenie faktúry: header('Content-Type: application/pdf'); header('Content-Disposition: inline; filename="' . $cislo . '.pdf"'); header('Cache-Control: private, max-age=0, must-revalidate'); header('Pragma: public'); curl_setopt($ch, CURLOPT_URL, $url); curl_setopt($ch, CURLOPT_FOLLOWLOCATION, true); echo curl_exec($ch); /* // pre download faktúry: header('Content-Type: application/download'); header('Content-Disposition: inline; filename="'.$cislo.'.pdf"'); header('Cache-Control: private, max-age=0, must-revalidate'); header('Pragma: public'); curl_setopt($ch, CURLOPT_URL, $url); curl_setopt($ch, CURLOPT_FOLLOWLOCATION, true); echo curl_exec($ch); */
Array ( [status] => 1 [url] => https://www.faktury-online.com/faktury/detail-subor?f=26915945a67c8b7ba74dac59c5badfbf [number] => FA2019015 )
https://www.faktury-online.com/api/uf?data={JSON}
Parameter | Atribút | Popis |
---|---|---|
key | povinný parameter | API kľúč. |
povinný parameter | Email (alebo používateľské meno), ktorým sa prihlasujete do Faktúr online. | |
code | povinný parameter | kód faktúry (získaný z odpovede API vytvorenia faktúry) |
date | nepovinný parameter | Dátum úhrady faktúry Predvolená hodnota: 'Aktuálny dátum' |
Array ( [key] => vJyMc*4@2754*wGhofIWi!QDcEEQUdmj [email] => name@example.com [code] => 26915945a67c8b7ba74dac59c5badfbf [date] => 2019-06-01 )
Status ID | Význam | Popis |
---|---|---|
1 | OK | Všetko prebehlo v poriadku |
302 | Chyba | Parameter data nebol odoslaný metódou GET. |
303 | Chyba | API kľúč nie je zadaný alebo nie je platný počet reťazcov. |
304 | Chyba | API kľúč nie je zadaný správne. |
305 | Chyba | Parameter email nie je zadaný. |
306 | Chyba | Nie je vytvorené sedenie |
307 | Chyba | Vytvorené sedenie nie je správne |
308 | Chyba | Používateľské meno alebo API kľúč nie sú uvedené správne. |
309 | Chyba | Používateľ neexistuje. |
310 | Chyba | Nie je zadaný kód faktúry. |
311 | Chyba | Kód faktúry nie je zadaný správne. |
<?php // Príprava základných dát: $data = array(); // Váš API kľúč: $data['key'] = "dJyMc*53@687*wGhofIWi!WDcEEQUdmj"; // Váš email (príp. používateľské meno): $data['email'] = "name@example.com"; // Dáta sa uložia do formátu JSON: $data_json = json_encode($data); // Inicializácia sedenia $url = 'https://www.faktury-online.com/api/init?data=' . urlencode($data_json); $ch = curl_init(); curl_setopt($ch, CURLOPT_URL, $url); curl_setopt($ch, CURLOPT_COOKIESESSION, true); curl_setopt($ch, CURLOPT_COOKIEJAR, 'cookie.txt'); curl_setopt($ch, CURLOPT_RETURNTRANSFER, true); curl_setopt($ch, CURLOPT_CONNECTTIMEOUT, 5); $output = curl_exec($ch); $result = json_decode($output, true); // Výsledok: $result = json_decode($output, true); if ($result['status'] != 1) { throw new Exception("Vyskytla sa chyba č. " . $result['status']); } // Kód faktúry: $data['code'] = "14915945a66c8b7be74dac59c5badfbf"; // Dátum úhrady $data['date'] = "2017-06-01"; // prípadne žiadny záznam pre nastavenie dnešného dňa úhrady // Dáta sa uložia do formátu JSON: $data_json = json_encode($data); // Dáta sa odošlú: $url = 'https://www.faktury-online.com/api/uf?data=' . urlencode($data_json); curl_setopt($ch, CURLOPT_URL, $url); $output = curl_exec($ch); $result = json_decode($output, true); // Výsledok: $result = json_decode($output, true); if ($result['status'] == 1) { echo "Faktúra bola uhradená"; } else { echo "Vyskytla sa chyba č." . $result['status']; }
Array ( [status] => 1 )
https://www.faktury-online.com/api/status?data={JSON}
Parameter | Atribút | Popis |
---|---|---|
key | povinný parameter | API kľúč. |
povinný parameter | Email (alebo používateľské meno), ktorým sa prihlasujete do Faktúr online. | |
code | povinný parameter | kód faktúry (získaný z odpovede API vytvorenia faktúry) |
Array ( [key] => vJyMc*4@2754*wGhofIWi!QDcEEQUdmj [email] => name@example.com [code] => 26915945a67c8b7ba74dac59c5badfbf )
Status ID | Význam | Popis |
---|---|---|
1 | OK | Všetko prebehlo v poriadku |
402 | Chyba | Parameter data nebol odoslaný metódou GET. |
403 | Chyba | API kľúč nie je zadaný alebo nie je platný počet reťazcov. |
404 | Chyba | API kľúč nie je zadaný správne. |
405 | Chyba | Parameter email nie je zadaný. |
406 | Chyba | Nie je vytvorené sedenie |
407 | Chyba | Vytvorené sedenie nie je správne |
408 | Chyba | Používateľské meno alebo API kľúč nie sú uvedené správne. |
409 | Chyba | Používateľ neexistuje. |
410 | Chyba | Nie je zadaný kód faktúry. |
411 | Chyba | Kód faktúry nie je zadaný správne. |
412 | Chyba | Chyba pri výbere faktúry |
413 | Chyba | Chyba pri zobrazení šablóny faktúry |
<?php // Príprava základných dát: $data = array(); // Váš API kľúč: $data['key'] = "dJyMc*53@687*wGhofIWi!WDcEEQUdmj"; // Váš email (príp. používateľské meno): $data['email'] = "name@example.com"; // Dáta sa uložia do formátu JSON: $data_json = json_encode($data); // Inicializácia sedenia $url = 'https://www.faktury-online.com/api/init?data=' . urlencode($data_json); $ch = curl_init(); curl_setopt($ch, CURLOPT_URL, $url); curl_setopt($ch, CURLOPT_COOKIESESSION, true); curl_setopt($ch, CURLOPT_COOKIEJAR, 'cookie.txt'); curl_setopt($ch, CURLOPT_RETURNTRANSFER, true); curl_setopt($ch, CURLOPT_CONNECTTIMEOUT, 5); $output = curl_exec($ch); $result = json_decode($output, true); // Výsledok: $result = json_decode($output, true); if ($result['status'] != 1) { throw new Exception("Vyskytla sa chyba č. " . $result['status']); } // Kód faktúry: $data['code'] = "14915945a66c8b7be74dac59c5badfbf"; // Dáta sa uložia do formátu JSON: $data_json = json_encode($data); // Dáta sa odošlú: $url = 'https://www.faktury-online.com/api/status?data=' . urlencode($data_json); curl_setopt($ch, CURLOPT_URL, $url); $output = curl_exec($ch); $result = json_decode($output, true); // Výsledok: $result = json_decode($output, true); if ($result['status'] == 1) { echo "Dodávateľ: {$result['supplier']} \n"; echo "Dodávateľ IČO: {$result['supplier_ico']} \n"; echo "Odberateľ / Zákazník: {$result['customer']} \n"; echo "Odberateľ / Zákazník IČO: {$result['customer_ico']} \n"; // Možnosti: faktura, zalohova_faktura, dobropis, danovy_doklad echo "Typ faktúry: {$result['invoice_type']} \n"; echo "Číslo faktúry: {$result['customer_ico']} \n"; echo "Suma bez DPH: {$result['invoice_amount']} \n"; if (isset($result['invoice_amount_vat'])){ echo "Suma s DPH: {$result['invoice_amount_vat']} \n"; } echo "Mena: {$result['invoice_currency']} \n"; echo "Dátum vystavenia: {$result['invoice_date_issue']} \n"; echo "Dátum dodania: {$result['invoice_date_delivery']} \n"; echo "Dátum splatnosti: {$result['invoice_date_due']} \n"; // Možnosti: ano, nie, ciastocne echo "Faktúra uhradená: {$result['invoice_paid']} \n"; if ($result['invoice_paid'] != 'nie'){ echo "Uhradená suma: {$result['invoice_paid_amount']} \n"; echo "Dátum úhrady: {$result['invoice_date_payment']} \n"; } echo "Vlastné dáta z API: {$result['invoice_api_custom']} \n"; if (isset($result['invoice_tags']) && is_array($result['invoice_tags'])){ echo "Tagy faktúry: "; echo implode(", ",$result['invoice_tags']); } } else { echo "Vyskytla sa chyba č." . $result['status']; }
Array ( [status] => 1 [supplier] => Moja spoločnosť s.r.o. [supplier_ico] => 43226520 [customer] => Andrej Klačanský [customer_ico] => 40436097 [invoice_type] => faktura [invoice_number] => 20210400 [invoice_amount] => 200 [invoice_amount_vat] => 240 [invoice_currency] => EUR [invoice_date_issue] => 2021-01-10 [invoice_date_delivery] => 2021-01-10 [invoice_date_due] => 2021-01-25 [invoice_paid] => ano [invoice_paid_amount] => 240 [invoice_date_payment] => 2021-01-19 [invoice_api_custom] => data z API [invoice_tags] => Array ( [0] => Tag 1 [1] => Tag 2 ) )
https://www.faktury-online.com/api/list/created?data={JSON}Všetky faktúry s dátumom vystavenia v období:
https://www.faktury-online.com/api/list/issued?data={JSON}Všetky faktúry s dátumom dodania v období:
https://www.faktury-online.com/api/list/delivered?data={JSON}Všetky faktúry s dátumom úhrady v období:
https://www.faktury-online.com/api/list/paid?data={JSON}Základné parametre:
Parameter | Atribút | Popis |
---|---|---|
key | povinný parameter | API kľúč. |
povinný parameter | Email (alebo používateľské meno), ktorým sa prihlasujete do Faktúr online. | |
from | nepovinný parameter | Dátum hľadania 'Od' Formát: YYYY-MM-DD |
to | nepovinný parameter | Dátum hľadania 'Do' Formát: YYYY-MM-DD |
Array ( [key] => vJyMc*4@2754*wGhofIWi!QDcEEQUdmj [email] => name@example.com [from] => 2021-01-01 )
Status ID | Význam | Popis |
---|---|---|
1 | OK | Všetko prebehlo v poriadku |
502 | Chyba | Parameter data nebol odoslaný metódou GET. |
503 | Chyba | API kľúč nie je zadaný alebo nie je platný počet reťazcov. |
504 | Chyba | API kľúč nie je zadaný správne. |
505 | Chyba | Parameter email nie je zadaný. |
506 | Chyba | Nie je vytvorené sedenie |
507 | Chyba | Vytvorené sedenie nie je správne |
508 | Chyba | Používateľské meno alebo API kľúč nie sú uvedené správne. |
509 | Chyba | Používateľ neexistuje. |
510 | Chyba | Chybná URL. |
511 | Chyba | Dátum 'Od' je zadaný nesprávne. |
512 | Chyba | Dátum 'Do' je zadaný nesprávne. |
513 | Chyba | Nepodarilo sa identifikovať príslušný zoznam, zrejme chyba v URL. |
<?php // Príprava základných dát: $data = array(); // Váš API kľúč: $data['key'] = "dJyMc*53@687*wGhofIWi!WDcEEQUdmj"; // Váš email (príp. používateľské meno): $data['email'] = "name@example.com"; // Dáta sa uložia do formátu JSON: $data_json = json_encode($data); // Inicializácia sedenia $url = 'https://www.faktury-online.com/api/init?data=' . urlencode($data_json); $ch = curl_init(); curl_setopt($ch, CURLOPT_URL, $url); curl_setopt($ch, CURLOPT_COOKIESESSION, true); curl_setopt($ch, CURLOPT_COOKIEJAR, 'cookie.txt'); curl_setopt($ch, CURLOPT_RETURNTRANSFER, true); curl_setopt($ch, CURLOPT_CONNECTTIMEOUT, 5); $output = curl_exec($ch); $result = json_decode($output, true); // Výsledok: $result = json_decode($output, true); if ($result['status'] != 1) { throw new Exception("Vyskytla sa chyba č. " . $result['status']); } // Dáta v kalendárnom roku 2021 $data['from'] = '2021-01-01'; $data['to'] = '2021-12-31'; // Dáta sa uložia do formátu JSON: $data_json = json_encode($data); // Dáta sa odošlú: $url = 'https://www.faktury-online.com/api/list/paid?data=' . urlencode($data_json); curl_setopt($ch, CURLOPT_URL, $url); $output = curl_exec($ch); $result = json_decode($output, true); // Výsledok: $result = json_decode($output, true); if ($result['status'] == 1) { $faktury = $result['invoices']; foreach ($faktury as $faktura) { echo "Kód: {$faktura['code']} \n"; echo "Dodávateľ: {$faktura['supplier']} \n"; echo "Dodávateľ IČO: {$faktura['supplier_ico']} \n"; echo "Odberateľ / Zákazník: {$faktura['customer']} \n"; echo "Odberateľ / Zákazník IČO: {$faktura['customer_ico']} \n"; // Možnosti: faktura, zalohova_faktura, dobropis, danovy_doklad echo "Typ faktúry: {$faktura['invoice_type']} \n"; echo "Číslo faktúry: {$faktura['customer_ico']} \n"; echo "Suma bez DPH: {$faktura['invoice_amount']} \n"; if (isset($faktura['invoice_amount_vat'])) { echo "Suma s DPH: {$faktura['invoice_amount_vat']} \n"; } echo "Mena: {$faktura['invoice_currency']} \n"; echo "Dátum vystavenia: {$faktura['invoice_date_issue']} \n"; echo "Dátum dodania: {$faktura['invoice_date_delivery']} \n"; echo "Dátum splatnosti: {$faktura['invoice_date_due']} \n"; // Možnosti: ano, nie, ciastocne echo "Faktúra uhradená: {$faktura['invoice_paid']} \n"; if ($faktura['invoice_paid'] != 'nie') { echo "Uhradená suma: {$faktura['invoice_paid_amount']} \n"; echo "Dátum úhrady: {$faktura['invoice_date_payment']} \n"; } echo "Vlastné dáta z API: {$faktura['invoice_api_custom']} \n"; echo "Tagy: {$faktura['tags']} \n"; } } else { echo "Vyskytla sa chyba č." . $result['status']; }
Array ( [status] => 1 [invoices] => Array ( [0] => Array ( [code] => 1a35b89cd48eaf8940a6409ff45a0cc5 [supplier] => Moja spoločnosť s.r.o. [supplier_ico] => 43226520 [customer] => Andrej Klačanský [customer_ico] => 40436097 [invoice_type] => faktura [invoice_number] => 20210400 [invoice_amount] => 200 [invoice_amount_vat] => 240 [invoice_currency] => EUR [invoice_date_issue] => 2021-01-10 [invoice_date_delivery] => 2021-01-10 [invoice_date_due] => 2021-01-25 [invoice_paid] => ano [invoice_paid_amount] => 240 [invoice_date_payment] => 2021-01-19 [invoice_api_custom] => data z API [tags] => Tag1 ,Tag2 ) ) )