Manuál pre vývojárov - Faktúry online API

Je potrebné, aby ste poznali svoj API kľúč. API kľúč je 32 znakový reťazec nutný pre používanie API. Svoj API kľúč nikomu nedávajte. Unikátny API kľúč si nájdete vo Vašom profile hneď po prihlásení sa na uvítacej stránke.

Volanie API pre vytvorenie novej faktúry:

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.

Základné parametre:

Parameter	Atribút	Popis
key	povinný parameter	API kľúč.
email	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

Parametre dodávateľa:
Dodávateľa môžeme vybrať buď pomocou parametra d_id, ktorého máme uloženého v zozname Moje spoločnosti (možnosť 1) alebo všetky potrebné údaje vyplníme v parametroch (možnosť 2).

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.

Parametre odberateľ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Č.

Parametre faktúry:

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

Parametre položiek faktúry:

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

Formát dát pred odoslaním:

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
                )

        )

)

Zoznam návratových kódov:

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.

Ukážka zdrojového kódu:

<?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'];
}

Odpoveď:

Array
(
    [status] => 1
    [code] => 1a35b89cd48eaf8940a6409ff45a0cc5
    [number] => FA2019015
    [created] => 2019-02-15 17:45:12
)

Inicialializácia sedenia je potrebná pre zobrazenie faktúry. Volanie API pre vytvorenie inicializácie sedenia:

https://www.faktury-online.com/api/init?data={JSON}

Základné parametre:

Parameter	Atribút	Popis
key	povinný parameter	API kľúč.
email	povinný parameter	Email (alebo používateľské meno), ktorým sa prihlasujete do Faktúr online.

Základné parametre:

Array
(
    [key] => vJyMc*4@2754*wGhofIWi!QDcEEQUdmj
    [email] => name@example.com
)

Zoznam návratových kódov:

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.

Ukážka zdrojového kódu:

<?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'];
}

Odpoveď:

Array
(
    [status] => 1
)

Pred týmto volaním je potrebné inicializovať sedenie (viď vyššie). Volanie API pre zobrazenie faktúry:

https://www.faktury-online.com/api/zf?data={JSON}

Základné parametre:

Parameter	Atribút	Popis
key	povinný parameter	API kľúč.
email	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)

Základné parametre:

Array
(
    [key] => vJyMc*4@2754*wGhofIWi!QDcEEQUdmj
    [email] => name@example.com
    [code] => 26915945a67c8b7ba74dac59c5badfbf
)

Zoznam návratových kódov:

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

Ukážka zdrojového kódu:

<?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);
*/

Odpoveď:

Array
(
    [status] => 1
    [url] => https://www.faktury-online.com/faktury/detail-subor?f=26915945a67c8b7ba74dac59c5badfbf
    [number] => FA2019015
)

Pred týmto volaním je potrebné inicializovať sedenie (viď vyššie). Volanie API pre zobrazenie faktúry:

https://www.faktury-online.com/api/uf?data={JSON}

Základné parametre:

Parameter	Atribút	Popis
key	povinný parameter	API kľúč.
email	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'

Základné parametre:

Array
(
    [key] => vJyMc*4@2754*wGhofIWi!QDcEEQUdmj
    [email] => name@example.com
    [code] => 26915945a67c8b7ba74dac59c5badfbf
    [date] => 2019-06-01
)

Zoznam návratových kódov:

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.

Ukážka zdrojového kódu:

<?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'];
}

Odpoveď:

Array
(
    [status] => 1
)

Pred týmto volaním je potrebné inicializovať sedenie (viď vyššie). Volanie API pre zobrazenie statusu a detailu faktúry:

https://www.faktury-online.com/api/status?data={JSON}

Základné parametre:

Parameter	Atribút	Popis
key	povinný parameter	API kľúč.
email	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)

Základné parametre:

Array
(
    [key] => vJyMc*4@2754*wGhofIWi!QDcEEQUdmj
    [email] => name@example.com
    [code] => 26915945a67c8b7ba74dac59c5badfbf
)

Zoznam návratových kódov:

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

Ukážka zdrojového kódu:

<?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'];
}

Odpoveď:

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
        )

)

Pred týmto volaním je potrebné inicializovať sedenie (viď vyššie). Nasledujúce URL vrátia zoznamy faktúr.
Všetky faktúry vytvorené v období:

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ľúč.
email	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

Základné parametre:

Array
(
    [key] => vJyMc*4@2754*wGhofIWi!QDcEEQUdmj
    [email] => name@example.com
    [from] => 2021-01-01
)

Zoznam návratových kódov:

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.

Ukážka zdrojového kódu:

<?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'];
}

Odpoveď:

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
                )

        )

)