Manuál pro vývojáře - Faktury web API

https://www.fakturyweb.cz/api/init?data={JSON}

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

<?php

// Příprava základních dat:
$data = [];

// Váš API klíč:
$data['key'] = "dJyMc*53@687*wGhofIWi!WDcEEQUdmj";

// Váš email (příp. uživatelské jméno):
$data['email'] = "name@example.com";

// Data se uloží do formátu JSON:
$data_json = json_encode($data);

// Inicializace sezení
$url = 'https://www.fakturyweb.cz/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_FOLLOWLOCATION, true);
curl_setopt($ch, CURLOPT_CONNECTTIMEOUT, 5);
$output = curl_exec($ch);
$result = json_decode($output, true);

// Výsledek:
$result = json_decode($output, true);
if ($result['status'] == 1) {
    echo "Sezení bylo vytvořeno";
} else {
    echo "Vyskytla se chyba č." . $result['status'];
}

Array
(
    [status] => 1
)

https://www.fakturyweb.cz/api/nf?data={JSON}

Array
(
    [0] => Název tagu 1
    [1] => Název tagu 2
)

Array
(
    [key] => dJyMc*53@687*wGhofIWi!WDcEEQUdmj
    [email] => name@example.com
    [apitest] => 1
    [d] => Array
        (
            [d_name] => Moje společnost, s.r.o.
            [d_street] => Táborská 231/10
            [d_city] => Praha 4 - Nusle
            [d_zip] => 140 00
            [d_state] => Česká republika
            [d_ico] => 60991234
            [d_dic] => CZ60991234
            [d_vatpayer] => 1
            [d_viewpayer] => 1
            [d_info] => Zapsaná v obchodním rejstříku u Městského soudu v Praze, oddíl B
            [d_bankaccount] => 12345678/0100
            [d_bank] => Komerční banka
            [d_iban] => CZ620100000000012345678
            [d_swift] => KOMBCZPP
            [d_email] => info@example.com
            [d_web] => www.example.com
            [d_phone] => +420 601 111 111
        )

    [o] => Array
        (
            [o_name] => Petr Novák
            [o_street] => Pod kaštany 2299/10
            [o_city] => Brno - Žabovřesky
            [o_zip] => 616 00
            [o_state] => 
            [o_ico] => 
            [o_dic] => 
            [o_email] => client@example.com
        )

    [f] => Array
        (
            [f_number] => 2024099
            [f_vs] => 2024099
            [f_ks] => 308
            [f_date_issue] => 2014-02-14
            [f_date_delivery] => 2024-02-14
            [f_date_due] => 2024-04-28
            [f_issued_by] => Ing. Zbyněk Tuček
            [f_payment] => prevod
            [f_logo] => 1
            [f_stamp] => 0
            [f_currency] => Kč
            [f_type] => 1
            [f_paid] => 
            [f_rounding] => 0
            [f_style] => standard
            [f_language] => CS
            [f_qr] => 1
            [f_order] => OBJ-2017-514
            [f_tags] => Array
                (
                    [0] => VIP klient
                    [1] => Doprava zdarma
                )

        )

    [p] => Array
        (
            [0] => Array
                (
                    [p_text] => Malířské práce
                    [p_quantity] => 3
                    [p_unit] => hod
                    [p_price] => 300
                    [p_vat] => 21
                )

            [1] => Array
                (
                    [p_text] => Natěračské a lakýrnické práce
                    [p_quantity] => 2
                    [p_unit] => hod
                    [p_vat] => 21
                    [p_pricevat] => 450
                )

        )

)

<?php

// Příprava základních dat:
$data = [];

// Váš API klíč:
$data['key'] = "dJyMc*53@687*wGhofIWi!WDcEEQUdmj";

// Váš email (příp. uživatelské jméno):
$data['email'] = "name@example.com";

// V případě, že budeme testovat API, zvolíme hodnotu 1
// Znamená to, že všechny vytvořené faktury se automaticky odstraní o 5 - 10 minut od vytvoření
$data['apitest'] = 1; //hodnota může být 1 nebo 0


// Příprava dat dodavatele
$dodavatel = [];

// Údaje dodavatele můžeme použít buď z uložených záznamů v seznamu Moje společnosti
// nebo údaje dodavatele vložíme zadáním dat.
// Pokud použijeme stávajícího dodavatele, vložíme pouze jeho ID.
// $dodavatel['d_id'] = 123; // ID dodavatele najdeme v seznamu Moje společnosti

// nebo (ne obě) :
$dodavatel['d_name'] = "Moje společnost, s.r.o."; // Obchodní jméno dodavatele
$dodavatel['d_street'] = "Táborská 231/10"; // Ulice
$dodavatel['d_city'] = "Praha 4 - Nusle"; // Město
$dodavatel['d_zip'] = "140 00"; // PSČ
$dodavatel['d_state'] = "Česká republika"; // Stát
$dodavatel['d_ico'] = "60991234"; // IČO
$dodavatel['d_dic'] = "CZ60991234"; // DIČ
$dodavatel['d_vatpayer'] = "1"; // Plátce DPH. Pokud je dodavatel plátcem DPH ponechte
// hodnotu 1, pokud není plátcem DPH, napište 0.
$dodavatel['d_viewpayer'] = "1"; // Pokud chcete zobrazit informaci na faktuře,
// že dodavatel je / není plátcem DPH.
$dodavatel['d_info'] = "Zapsaná v obchodním rejstříku u Městského soudu v Praze, oddíl B";
//Info o dodavateli
$dodavatel['d_bankaccount'] = "12345678/0100"; // Číslo účtu
$dodavatel['d_bank'] = "Komerční banka"; // Název banky
$dodavatel['d_iban'] = "CZ620100000000012345678"; // IBAN
$dodavatel['d_swift'] = "KOMBCZPP"; // SWIFT
$dodavatel['d_email'] = "info@example.com"; // E-mail
$dodavatel['d_web'] = "www.example.com"; // WEB
$dodavatel['d_phone'] = "+420 601 111 111"; // Telefon

// Přidání dodavatele k datům:
$data['d'] = $dodavatel;


// Příprava dat odběratele
$odberatel = [];
$odberatel['o_name'] = "Petr Novák"; // Název odběratele
$odberatel['o_street'] = "Pod kaštany 2299/10"; // Ulice
$odberatel['o_city'] = "Brno - Žabovřesky"; // Město
$odberatel['o_zip'] = "616 00"; // PSČ
$odberatel['o_state'] = ""; // Stát
$odberatel['o_ico'] = ""; // IČO
$odberatel['o_dic'] = ""; // DIČ
$odberatel['o_email'] = "client@example.com"; // Email odběratele

// Přidání odběratele k datům:
$data['o'] = $odberatel;


// Příprava fakturačních údajů
$faktura = [];

// Číslo faktury můžeme zadat ručně:
$faktura['f_number'] = "2024099";
// Pokud chceme vypočítat číslo faktury automaticky, toto pole nevyplňte. Doporučuje se
// ovšem mít zapnuté a nastavené automatické číslování faktur pro vybraného dodavatele.

$faktura['f_vs'] = "2024099"; // Variabilní symbol
$faktura['f_ks'] = "308"; // Konstantní symbol
$faktura['f_date_issue'] = '2014-02-14'; // Datum vystavení ve formátu RRRR-MM-DD
$faktura['f_date_delivery'] = '2024-02-14'; // Datum dodaní ve formátu RRRR-MM-DD
$faktura['f_date_due'] = '2024-04-28'; // Datum splatnosti ve formátu RRRR-MM-DD
$faktura['f_issued_by'] = "Ing. Zbyněk Tuček";  // Fakturu vystavil
$faktura['f_payment'] = "prevod";   // Druh plaby. Na výběr jsou "prevod", "poukazka",
// "hotovost", "dobirka", "registracna_pokladna", "jina", "eprovider"
$faktura['f_logo'] = "1";   // Zobrazit logo dodavatele. Pouze v případě, že byl
// dodavatel vybrán pomocí ID a má uloženo logo.
$faktura['f_stamp'] = "0";  // Nezobrazit razítko
$faktura['f_currency'] = "Kč";  // Měna faktury
$faktura['f_type'] = "1";  // Faktura
$faktura['f_paid'] = "";  // Již uhrazená částka nedaňovými zálohami
$faktura['f_rounding'] = "0";  // Zaokrouhlení - žádné
$faktura['f_style'] = "standard";  // Styl faktury. Možnosti jsou standard nebo classic
$faktura['f_language'] = "CS";   // Jazyk faktury: CS - čeština
$faktura['f_qr'] = "1";   // Zobrazit QR kód na faktuře
$faktura['f_order'] = "OBJ-2017-514";  // Číslo objednávky
$faktura['f_tags'] = ["VIP klient", "Doprava zdarma"];  // Přiřadit označení k faktuře

// Přidání fakturačních údajů k datům:
$data['f'] = $faktura;


// Příprava fakturačních položek
$polozky = [];

// první položka:
$polozka = [];
$polozka['p_text'] = "Malířské práce"; // Název služby nebo zboží
$polozka['p_quantity'] = "3"; // Množství
$polozka['p_unit'] = "hod"; // Měrná jednotka
$polozka['p_price'] = "300"; // Cena za jednu jednotku bez DPH
$polozka['p_vat'] = "21"; // Daň v %
// přiřazení k položkám:
$polozky[] = $polozka;
// druhá položka:
$polozka = [];
$polozka['p_text'] = "Natěračské a lakýrnické práce"; // Název služby nebo zboží
$polozka['p_quantity'] = "2"; // Množství
$polozka['p_unit'] = "hod"; // Měrná jednotka
$polozka['p_vat'] = "21"; // Daň v %
$polozka['p_pricevat'] = "450"; // Cena za jednu jednotku včetně DPH
// přiřazení k položkám:
$polozky[] = $polozka;

// přiřazení fakturačních položek k datům:
$data['p'] = $polozky;

// Data se uloží do formátu JSON:
$data_json = json_encode($data);

// Data se odešlou:
$url = 'https://www.fakturyweb.cz/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ýsledek:
$result = json_decode($output, true);
if ($result['status'] == 1) {
    echo "Uloženo, nová faktura má kód: " . $result['code'] . "<br />";
    echo "Číslo faktury: " . $result['number'] . " <br />";
    echo "Faktura vytvořená: " . $result['created'] . " <br />";
} else {
    echo "Vyskytla se chyba č." . $result['status'];
}

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

https://www.fakturyweb.cz/api/zf?data={JSON}

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

<?php

// Příprava základních dat:
$data = [];

// Váš API klíč:
$data['key'] = "dJyMc*53@687*wGhofIWi!WDcEEQUdmj";

// Váš email (příp. uživatelské jméno):
$data['email'] = "name@example.com";

// Data se uloží do formátu JSON:
$data_json = json_encode($data);


// Inicializace sezení
$url = 'https://www.fakturyweb.cz/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ýsledek:
$result = json_decode($output, true);
if ($result['status'] != 1) {
    throw new Exception("Vyskytla se chyba č. " . $result['status']);
}

// Kód faktury:
$data['code'] = "14915945a66c8b7be74dac59c5badfbf";

// Data se uloží do formátu JSON:
$data_json = json_encode($data);


// Data se odešlou:
$url = 'https://www.fakturyweb.cz/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ýsledek:
$result = json_decode($output, true);
if ($result['status'] != 1) {
    throw new Exception("Vyskytla se chyba č. " . $result['status']);
}

// pro zobrazení faktury:
header('Content-Type: application/pdf');
header('Content-Disposition: inline; filename="' . $cislo . '.pdf"');
header('Cache-Control: private, max-age=0, must-revalidate');
curl_setopt($ch, CURLOPT_URL, $url);
curl_setopt($ch, CURLOPT_FOLLOWLOCATION, true);
echo curl_exec($ch);


/*
// pro download faktury:
header('Content-Type: application/download');
header('Content-Disposition: inline; filename="'.$cislo.'.pdf"');
header('Cache-Control: private, max-age=0, must-revalidate');
curl_setopt($ch, CURLOPT_URL, $url);
curl_setopt($ch, CURLOPT_FOLLOWLOCATION, true);
echo curl_exec($ch);
*/

Array
(
    [status] => 1
    [url] => http://www.fakturyweb.cz/faktury/detail-soubor?f=26915945a67c8b7ba74dac59c5badfbf
    [number] => FA2019015
)

https://www.fakturyweb.cz/api/uf?data={JSON}

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

<?php

// Příprava základních dat:
$data = [];

// Váš API klíč:
$data['key'] = "dJyMc*53@687*wGhofIWi!WDcEEQUdmj";

// Váš email (příp. uživatelské jméno):
$data['email'] = "name@example.com";

// Data se uloží do formátu JSON:
$data_json = json_encode($data);

// Inicializace sezení
$url = 'https://www.fakturyweb.cz/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ýsledek:
$result = json_decode($output, true);
if ($result['status'] != 1) {
    throw new Exception("Vyskytla se chyba č. " . $result['status']);
}

// Kod faktury:
$data['code'] = "14915945a66c8b7be74dac59c5badfbf";
// Datum úhrady
$data['date'] = "2017-06-01"; // případně žádný záznam pro nastavení dnešního dne úhrady

// Data se uloží do formátu JSON:
$data_json = json_encode($data);


// Data se odešlou:
$url = 'https://www.fakturyweb.cz/api/uf?data=' . urlencode($data_json);
curl_setopt($ch, CURLOPT_URL, $url);
$output = curl_exec($ch);
$result = json_decode($output, true);


// Výsledek:
$result = json_decode($output, true);
if ($result['status'] == 1) {
    echo "Faktura byla uhrazena";
} else {
    echo "Vyskytla se chyba č." . $result['status'];
}

Array
(
    [status] => 1
)

https://www.fakturyweb.cz/api/status?data={JSON}

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

<?php

// Příprava základních dat:
$data = [];

// Váš API klíč:
$data['key'] = "dJyMc*53@687*wGhofIWi!WDcEEQUdmj";

// Váš email (příp. uživatelské jméno):
$data['email'] = "name@example.com";

// Data se uloží do formátu JSON:
$data_json = json_encode($data);

// Inicializace sezení
$url = 'https://www.fakturyweb.cz/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_FOLLOWLOCATION, true);
curl_setopt($ch, CURLOPT_CONNECTTIMEOUT, 5);
$output = curl_exec($ch);


// Výsledek:
$result = json_decode($output, true);
if ($result['status'] != 1) {
    throw new Exception("Vyskytla se chyba č. " . $result['status']);
}


// Kód faktury:
$data['code'] = "14915945a66c8b7be74dac59c5badfbf";

// Data se uloží do formátu JSON:
$data_json = json_encode($data);


// Data se odešlou:
$url = 'https://www.fakturyweb.cz/api/status?data=' . urlencode($data_json);
curl_setopt($ch, CURLOPT_URL, $url);
$output = curl_exec($ch);


// Výsledek:
$result = json_decode($output, true);
if ($result['status'] == 1) {
    echo "Dodavatel: {$result['supplier']} \n";
    echo "Dodavatel IČO: {$result['supplier_ico']} \n";
    echo "Odběratel / Zákazník: {$result['customer']} \n";
    echo "Odběratel / Zákazník IČO: {$result['customer_ico']} \n";
    // Možnosti: faktura, zalohova_faktura, dobropis, danovy_doklad
    echo "Typ faktury: {$result['invoice_type']} \n";
    echo "Číslo faktury: {$result['invoice_number']} \n";
    echo "Částka bez DPH: {$result['invoice_amount']} \n";
    if (isset($result['invoice_amount_vat'])){
        echo "Částka s DPH: {$result['invoice_amount_vat']} \n";
    }
    echo "Měna: {$result['invoice_currency']} \n";
    echo "Datum vystavení: {$result['invoice_date_issue']} \n";
    echo "Datum dodání: {$result['invoice_date_delivery']} \n";
    echo "Datum splatnosti: {$result['invoice_date_due']} \n";
    // Možnosti: ano, ne, castecne
    echo "Faktura uhrazena: {$result['invoice_paid']} \n";
    if ($result['invoice_paid'] != 'ne'){
        echo "Uhrazena částka: {$result['invoice_paid_amount']} \n";
        echo "Datum úhrady: {$result['invoice_date_payment']} \n";
    }
    echo "Vlastní data z API: {$result['invoice_api_custom']} \n";
    if (isset($result['invoice_tags']) && is_array($result['invoice_tags'])){
        echo "Tagy faktury: ";
        echo implode(", ",$result['invoice_tags']);
    }
} else {
    echo "Vyskytla se chyba č." . $result['status'];
}

Array
(
    [status] => 1
    [supplier] => Moje společnost, s.r.o.
    [supplier_street] => Táborská 231/10
    [supplier_city] => Praha 4 - Nusle
    [supplier_zip] => 140 00
    [supplier_state] => Česká republika
    [supplier_ico] => 60991234
    [supplier_dic] => CZ60991234
    [supplier_info] => Zapsaná v obchodním rejstříku u Městského soudu v Praze, oddíl B, vložka 12345
    [supplier_bankaccount] => 12345678/0100
    [supplier_bank] => Komerční banka
    [supplier_iban] => CZ620100000000012345678
    [supplier_swift] => KOMBCZPP
    [supplier_email] => me@example.com
    [supplier_phone] => +420 601 111 111
    [supplier_web] => 
    [supplier_custom_key_1] => 
    [supplier_custom_value_1] => 
    [supplier_custom_key_2] => 
    [supplier_custom_value_2] => 
    [customer] =>  Petr Novák
    [customer_street] => Pod kaštany 2299/10
    [customer_city] => Brno - Žabovřesky
    [customer_zip] => 616 00
    [customer_state] => 
    [customer_ico] => 
    [customer_dic] => 
    [customer_email] => client@example.com
    [customer_info] => 
    [customer_delivery_name] => 
    [customer_delivery_street] => 
    [customer_delivery_city] => 
    [customer_delivery_zip] => 
    [customer_delivery_state] => 
    [customer_custom_key_1] => 
    [customer_custom_value_1] => 
    [customer_custom_key_2] => 
    [customer_custom_value_2] => 
    [invoice_type] => faktura
    [invoice_number] => 2022099
    [invoice_vs] => 2022099
    [invoice_ks] => 
    [invoice_payment_type] => prevod
    [invoice_currency] => Kč
    [invoice_date_issue] => 2022-04-27
    [invoice_date_delivery] => 2022-04-27
    [invoice_date_due] => 2022-05-04
    [invoice_order] => 
    [invoice_issued_by] => Martin Hrubý
    [invoice_note] => Poznámka pod položkami
    [invoice_note_above] => Poznámka nad položkami
    [invoice_amount] => 5336.19
    [invoice_amount_vat] => 6456.79
    [invoice_vat_reverse_c] => ne
    [invoice_paid_advanced] => 500
    [invoice_total_discount_perc] => 10
    [invoice_to_pay] => 5956.79
    [invoice_paid] => ne
    [invoice_api_custom] => 
    [invoice_language] => cz
    [items] => Array
        (
            [0] => Array
                (
                    [item_name] => Diamantový kotouč na obklady 
                    [item_unit] => ks
                    [item_quantity] => 8
                    [item_unit_price] => 518
                    [item_unit_price_total] => 626.78
                    [item_vat_rate] => 21
                    [item_vat_total] => 870.24
                    [item_unit_price_vat] => 626.78
                    [item_unit_price_totla_vat] => 5014.24
                    [item_api_custom] => 
                )

            [1] => Array
                (
                    [item_name] => Sada nylonových drátěných kartáčů
                    [item_unit] => ks
                    [item_quantity] => 10
                    [item_unit_price] => 178.51
                    [item_unit_price_total] => 216
                    [item_vat_rate] => 21
                    [item_vat_total] => 374.88
                    [item_unit_price_vat] => 216
                    [item_unit_price_totla_vat] => 2160
                    [item_api_custom] => 
                )

        )

    [invoice_tags] => Array
        (
            [0] => Tag 1
            [1] => Tag 2
        )

)

https://www.fakturyweb.cz/api/list/created?data={JSON}

https://www.fakturyweb.cz/api/list/issued?data={JSON}

https://www.fakturyweb.cz/api/list/delivered?data={JSON}

https://www.fakturyweb.cz/api/list/paid?data={JSON}

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

<?php

// Příprava základních dat:
$data = [];

// Váš API klíč:
$data['key'] = "dJyMc*53@687*wGhofIWi!WDcEEQUdmj";

// Váš email (příp. uživatelské jméno):
$data['email'] = "name@example.com";

// Data se uloží do formátu JSON:
$data_json = json_encode($data);

// Inicializace sezení
$url = 'https://www.fakturyweb.cz/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_FOLLOWLOCATION, true);
curl_setopt($ch, CURLOPT_CONNECTTIMEOUT, 5);
$output = curl_exec($ch);


// Výsledek:
$result = json_decode($output, true);
if ($result['status'] != 1) {
    throw new Exception("Vyskytla se chyba č. " . $result['status']);
}


// Data v kalendářním roce 2021
$data['from'] = '2021-01-01';
$data['to'] = '2021-12-31';
// Data se uloží do formátu JSON:
$data_json = json_encode($data);


// Data se odešlou:
$url = 'https://www.fakturyweb.cz/api/list/paid?data=' . urlencode($data_json);
curl_setopt($ch, CURLOPT_URL, $url);
$output = curl_exec($ch);


// Výsledek:
$result = json_decode($output, true);
if ($result['status'] == 1) {
    $faktury = $result['invoices'];
    foreach ($faktury as $faktura) {
        echo "Kód: {$faktura['code']} \n";
        echo "Dodavatel: {$faktura['supplier']} \n";
        echo "Dodavatel IČO: {$faktura['supplier_ico']} \n";
        echo "Odběratel  / Zákazník: {$faktura['customer']} \n";
        echo "Odběratel / Zákazník IČO: {$faktura['customer_ico']} \n";
        // Možnosti: faktura, zalohova_faktura, dobropis, danovy_doklad
        echo "Typ faktury: {$faktura['invoice_type']} \n";
        echo "Číslo faktury: {$faktura['invoice_number']} \n";
        echo "Částka bez DPH: {$faktura['invoice_amount']} \n";
        if (isset($faktura['invoice_amount_vat'])) {
            echo "Částka s DPH: {$faktura['invoice_amount_vat']} \n";
        }
        echo "Měna : {$faktura['invoice_currency']} \n";
        echo "Datum vystavení: {$faktura['invoice_date_issue']} \n";
        echo "Datum dodání: {$faktura['invoice_date_delivery']} \n";
        echo "Dátum splatnosti: {$faktura['invoice_date_due']} \n";
        // Možnosti: ano, ne, castecne
        echo "Faktura uhrazena: {$faktura['invoice_paid']} \n";
        if ($faktura['invoice_paid'] != 'ne') {
            echo "Uhrazena částka: {$faktura['invoice_paid_amount']} \n";
            echo "Datum úhrady: {$faktura['invoice_date_payment']} \n";
        }
        echo "Vlastní data z API: {$faktura['invoice_api_custom']} \n";
        echo "Tagy: {$faktura['tags']} \n";
    }
} else {
    echo "Vyskytla se chyba č." . $result['status'];
}

Array
(
    [status] => 1
    [invoices] => Array
        (
            [0] => Array
                (
                    [code] => 1a35b89cd48eaf8940a6409ff45a0cc5
                    [supplier] => Moje společnost, s.r.o.
                    [supplier_ico] => 60991234
                    [customer] => Petr Novák
                    [customer_ico] => 
                    [invoice_type] => faktura
                    [invoice_number] => 20210400
                    [invoice_amount] => 2000
                    [invoice_amount_vat] => 2420
                    [invoice_currency] => CZK
                    [invoice_date_issue] => 2021-01-10
                    [invoice_date_delivery] => 2021-01-10
                    [invoice_date_due] => 2021-01-25
                    [invoice_paid] => ano
                    [invoice_paid_amount] => 2420
                    [invoice_date_payment] => 2021-01-19
                    [invoice_api_custom] => data z API
                    [tags] => Tag1 ,Tag2
                )

        )

)

https://www.fakturyweb.cz/api/ncn?data={JSON}

Array
(
    [0] => Název tagu 1
    [1] => Název tagu 2
)

Array
(
    [key] => vJyMc*4@2754*wGhofIWi!QDcEEQUdmj
    [email] => name@example.com
    [apitest] => 1
    [d] => Array
        (
            [d_name] => Moje společnost, s.r.o.
            [d_street] => Táborská 231/10
            [d_city] => Praha 4 - Nusle
            [d_zip] => 140 00
            [d_state] => Česká republika
            [d_ico] => 60991234
            [d_dic] => CZ60991234
            [d_vatpayer] => 1
            [d_viewpayer] => 0
            [d_info] => Zapsaná v obchodním rejstříku u Městského soudu v Praze, oddíl B, vložka 12345 
            [d_bankaccount] => 12345678/0100
            [d_bank] => Komerční banka
            [d_iban] => CZ620100000000012345678
            [d_swift] => KOMBCZPP
            [d_email] => info@example.com
            [d_web] => www.example.com
            [d_phone] => +420 601 111 111
        )

    [o] => Array
        (
            [o_name] => Petr Novák
            [o_street] => Pod kaštany 2299/10
            [o_city] => Brno - Žabovřesky
            [o_zip] => 616 00
            [o_state] => 
            [o_ico] => 
            [o_dic] => 
            [o_email] => client@example.com
        )

    [po] => Array
        (
            [po_number] => 2022099
            [po_date_issue] => 2022-01-01
            [po_date_expiration] => 2022-01-15
            [po_issued_by] => Martin Hrubý
            [po_note] => Nezávazná cenová nabídka platná 15 dní
            [po_currency] => Kč
            [po_language] => CZ
            [po_tags] => Array
                (
                    [0] => VIP klient
                    [1] => Doprava zdarma
                )

        )

    [p] => Array
        (
            [0] => Array
                (
                    [p_text] => Diamantový kotouč na obklady
                    [p_quantity] => 8
                    [p_unit] => ks
                    [p_price] => 518
                    [p_vat] => 21
                    [p_pricevat] => 626.78
                )

            [1] => Array
                (
                    [p_text] => Sada nylonových drátěných kartáčů
                    [p_quantity] => 10
                    [p_unit] => ks
                    [p_price] => 178.51
                    [p_vat] => 21
                    [p_pricevat] => 216
                )

        )

)

<?php

// Příprava základních dat:
$data = [];

// Váš API klíč:
$data['key'] = "dJyMc*53@687*wGhofIWi!WDcEEQUdmj";

// Váš email (příp. uživatelské jméno):
$data['email'] = "name@example.com";

// V případě, že budeme testovat API, zvolíme hodnotu 1
// Znamená to, že všechny vytvořené cenové nabídky se automaticky smažou o 5 - 10 minut
$data['apitest'] = 1; //hodnota může být 1 nebo 0


// Příprava dat dodavatele
$dodavatel = [];

// Dodavatele můžeme použít již existujícího (uloženého v seznamu Moje společnosti)
// nebo dodavatele vytvoříme ručně vložením dat.
// Pokud použijeme stávajícího dodavatele, vložíme pouze jeho ID:
// $dodavatel['d_id'] = 123; // ID dodavatele najdeme v seznamu Moje společnosti

//nebo (ne obě) :
$dodavatel['d_name'] = "Moje společnost, s.r.o."; // Obchodní jméno dodavatele
$dodavatel['d_street'] = "Táborská 231/10"; // Ulice
$dodavatel['d_city'] = "Praha 4 - Nusle"; // Město
$dodavatel['d_zip'] = "140 00"; // PSČ
$dodavatel['d_state'] = "Česká republika"; // Stát
$dodavatel['d_ico'] = "60991234"; // IČO
$dodavatel['d_dic'] = "CZ60991234"; // DIČ
$dodavatel['d_vatpayer'] = "1"; // Plátce DPH. Pokud je dodavatel plátce DPH ponechte hodnotu 1,
// pokud není plátce DPH, napište 0.
$dodavatel['d_viewpayer'] = "1"; // Pokud chcete zobrazit informaci v nabídce,
// že dodavatel je plátcem/neplátcem DPH.
$dodavatel['d_info'] = "Zapsaná v obchodním rejstříku u Městského soudu v Praze, oddíl B";
//Info o dodavateli
$dodavatel['d_bankaccount'] = "12345678/0100"; // Číslo účtu
$dodavatel['d_bank'] = "Komerční banka"; // Název banky
$dodavatel['d_iban'] = "CZ620100000000012345678"; // IBAN
$dodavatel['d_swift'] = "KOMBCZPP"; // SWIFT
$dodavatel['d_email'] = "info@example.com"; // E-mail
$dodavatel['d_web'] = "www.example.com"; // WEB
$dodavatel['d_phone'] = "+420 601 111 111"; // Telefon

// Přidání dodavatele k datům:
$data['d'] = $dodavatel;


// Příprava dat odběratele
$odberatel = [];
$odberatel['o_name'] = "Petr Novák"; // Název odběratele
$odberatel['o_street'] = "Pod kaštany 2299/10"; // Ulice
$odberatel['o_city'] = "Brno - Žabovřesky"; // Město
$odberatel['o_zip'] = "616 00"; // PSČ
$odberatel['o_state'] = ""; // Stát
$odberatel['o_ico'] = ""; // IČO
$odberatel['o_dic'] = ""; // DIČ
$odberatel['o_email'] = "client@example.com"; // Email odběratele

// Přidání odběratele k datům:
$data['o'] = $odberatel;


// Příprava údajů cenové nabídky 
$cenovaNabidka = [];

// Číslo cenové nabídky můžeme zadat ručně :
$cenovaNabidka['po_number'] = "2022099";
// Pokud chceme vypočítat číslo automaticky, toto pole nevyplníme
$cenovaNabidka['po_date_issue'] = '2022-01-01'; // Datum vystavení ve formátu RRRR-MM-DD
$cenovaNabidka['po_date_expiration'] = '2022-01-15'; // Datum platnosti ve formátu RRRR-MM-DD
$cenovaNabidka['po_issued_by'] = "Martin Hrubý";  // Nabídku vystavil
$cenovaNabidka['po_logo'] = "1";   // Zobrazit logo dodavatele. Pouze v případě, že byl
// dodavatel vybrán pomocí ID a má přiřazeno logo.
$cenovaNabidka['po_stamp'] = "1";  // Zobrazit razítko dodavatele. Pouze v případě, že byl
// dodavatel vybran pomocí ID a má přiřazeno razítko
$cenovaNabidka['po_currency'] = "Kč";  // Měna cenové nabídky
$cenovaNabidka['po_language'] = "EN";   // Jazyk cenové nabídky
$cenovaNabidka['po_tags'] = ["VIP klient", "Doprava zdarma"];  // Přiřadit označení k nabídce

// Přidání údajů nabídky k datům:
$data['po'] = $cenovaNabidka;


// Příprava položek nabídky
$polozky = [];
// první položka:
$polozka = [];
$polozka['p_text'] = "Diamantový kotouč na obklady "; // Název služby nebo zboží
$polozka['p_quantity'] = "8"; // Množství
$polozka['p_unit'] = "ks"; // Měrná jednotka
$polozka['p_price'] = "518"; // Částka za jednu jednotku bez DPH
$polozka['p_vat'] = "21"; // Daň v %
// přiřazení k položkám:
$polozky[] = $polozka;

// druhá položka:
$polozka = [];
$polozka['p_text'] = "Sada nylonových drátěných kartáčů"; // Název služby nebo zboží
$polozka['p_quantity'] = "10"; // Množství
$polozka['p_unit'] = "ks"; // Měrná jednotka
$polozka['p_vat'] = "21"; // Daň v %
$polozka['p_pricevat'] = "216"; // Částka za jednu jednotku včetně DPH (Částka bez DPH se vypočítá)
// přiřazení k položkám:
$polozky[] = $polozka;

// přiřazení položek k datům:
$data['p'] = $polozky;


// Data se uloží do formátu JSON:
$data_json = json_encode($data);

// Data se odešlou:
$url = 'https://www.fakturyweb.cz/api/ncn?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_FOLLOWLOCATION, true);
curl_setopt($ch, CURLOPT_CONNECTTIMEOUT, 5);
$output = curl_exec($ch);

// Výsledek:
$result = json_decode($output, true);
if ($result['status'] == 1) {
    echo "Uloženo, nová cenová má kód: " . $result['code'] . " <br />";
    echo "Číslo cenové nabídky: " . $result['number'] . " <br />";
    echo "Cenová nabídka vytvořená: " . $result['created'] . " <br />";
} else {
    echo "Vyskytla se chyba č." . $result['status'];
}

Array
(
    [status] => 1
    [code] => ca9658a5448a945059f44658bac985e5
    [number] => 2022099
    [created] => 2022-01-01 09:49:05
)

https://www.fakturyweb.cz/api/zcn?data={JSON}

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

<?php

// Příprava základních dat:
$data = [];

// Váš API klíč:
$data['key'] = "dJyMc*53@687*wGhofIWi!WDcEEQUdmj";

// Váš email (příp. uživatelské jméno):
$data['email'] = "name@example.com";

// Data se uloží do formátu JSON:
$data_json = json_encode($data);

// Inicializace sezení
$url = 'https://www.fakturyweb.cz/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_FOLLOWLOCATION, true);
curl_setopt($ch, CURLOPT_CONNECTTIMEOUT, 5);
$output = curl_exec($ch);
$result = json_decode($output, true);

// Výsledek:
$result = json_decode($output, true);
if ($result['status'] != 1) {
    throw new Exception("Vyskytla se chyba č. " . $result['status']);
}

// Kód cenovej nabídky:
$data['code'] = "aa9025bc0094c88445daa22b90eff3b";

// Data se uloží do formátu JSON:
$data_json = json_encode($data);

// Data se odešlou:
$url = 'https://www.fakturyweb.cz/api/zcn?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ýsledek:
$result = json_decode($output, true);
if ($result['status'] != 1) {
    throw new Exception("Vyskytla se chyba č. " . $result['status']);
}

// pro zobrazení cenové nabídky:
header('Content-Type: application/pdf');
header('Content-Disposition: inline; filename="' . $cislo . '.pdf"');
header('Cache-Control: private, max-age=0, must-revalidate');
curl_setopt($ch, CURLOPT_URL, $url);
curl_setopt($ch, CURLOPT_FOLLOWLOCATION, true);
echo curl_exec($ch);



/*
// pro download cenové nabídky:
header('Content-Type: application/download');
header('Content-Disposition: inline; filename="'.$cislo.'.pdf"');
header('Cache-Control: private, max-age=0, must-revalidate');
curl_setopt($ch, CURLOPT_URL, $url);
curl_setopt($ch, CURLOPT_FOLLOWLOCATION, true);
echo curl_exec($ch);
*/

Array
(
    [status] => 1
    [url] => https://www.fakturyweb.cz/cenove-nabidky/detail-soubor?cp=26915945a67c8b7ba74dac59c5badfbf
    [number] => 2022099
)

https://www.fakturyweb.cz/api/cn-status?data={JSON}

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

<?php

// Příprava základních dat:
$data = [];

// Váš API klíč:
$data['key'] = "vJyMc*4@2754*wGhofIWi!QDcEEQUdmj";

// Váš email (příp. uživatelské jméno):
$data['email'] = "name@example.com";

// Data se uloží do formátu JSON:
$data_json = json_encode($data);

// Inicializace sezení
$url = 'https://www.fakturyweb.cz/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_FOLLOWLOCATION, true);
curl_setopt($ch, CURLOPT_CONNECTTIMEOUT, 5);
$output = curl_exec($ch);

// Výsledek:
$result = json_decode($output, true);
if ($result['status'] != 1) {
    throw new Exception("Vyskytla se chyba č. " . $result['status']);
}

// Kód cenové nabídky:
$data['code'] = "ae47ece062b0021144d768446b071fee";

// Data se uloží do formátu JSON:
$data_json = json_encode($data);


// Data se odešlou:
$url = 'https://www.fakturyweb.cz/api/cn-status?data=' . urlencode($data_json);
curl_setopt($ch, CURLOPT_URL, $url);
$output = curl_exec($ch);


// Výsledek:
$result = json_decode($output, true);
if ($result['status'] == 1) {
    echo "Dodavatel: {$result['supplier']} \n";
    echo "Dodavatel IČO: {$result['supplier_ico']} \n";
    echo "Odběratel / Zákazník: {$result['customer']} \n";
    echo "Odběratel / Zákazník IČO: {$result['customer_ico']} \n";
    echo "Číslo cenové nabídky: {$result['offer_number']} \n";
    echo "Částka bez DPH: {$result['offer_amount']} \n";
    if (isset($result['offer_amount_vat'])){
        echo "Částka s DPH: {$result['offer_amount_vat']} \n";
    }
    echo "Měna: {$result['offer_currency']} \n";
    echo "Datum vystavení: {$result['offer_date_issue']} \n";
    echo "Datum platnosti: {$result['offer_date_expiration']} \n";
    echo "Vlastní data z API: {$result['offer_api_custom']} \n";
    if (isset($result['offer_tags']) && is_array($result['offer_tags'])){
        echo "Tagy cenové nabídky: ";
        echo implode(", ",$result['offer_tags']);
    }
} else {
    echo "Vyskytla se chyba č." . $result['status'];
}

Array
(
    [status] => 1
    [supplier] => Moje společnost, s.r.o.
    [supplier_street] => Táborská 231/10
    [supplier_city] => Praha 4 - Nusle
    [supplier_zip] => 140 00
    [supplier_state] => Česká republika
    [supplier_ico] => 60991234
    [supplier_dic] => CZ60991234
    [supplier_info] => Zapsaná v obchodním rejstříku u Městského soudu v Praze, oddíl B, vložka 12345
    [supplier_bankaccount] => 12345678/0100
    [supplier_bank] => Komerční banka
    [supplier_iban] => CZ620100000000012345678
    [supplier_swift] => KOMBCZPP
    [supplier_email] => me@example.com
    [supplier_phone] => +420 601 111 111
    [supplier_web] => 
    [supplier_custom_key_1] => 
    [supplier_custom_value_1] => 
    [supplier_custom_key_2] => 
    [supplier_custom_value_2] => 
    [customer] =>  Petr Novák
    [customer_street] => Pod kaštany 2299/10
    [customer_city] => Brno - Žabovřesky
    [customer_zip] => 616 00
    [customer_state] => 
    [customer_ico] => 
    [customer_dic] => 
    [customer_email] => client@example.com
    [customer_info] => 
    [customer_custom_key_1] => ID klienta
    [customer_custom_value_1] => 654
    [customer_custom_key_2] => 
    [customer_custom_value_2] => 
    [offer_number] => 2022003
    [offer_amount] => 5336.19
    [offer_amount_vat] => 6456.79
    [offer_total_discount_perc] => 10
    [offer_currency] => Kč
    [offer_date_issue] => 2022-03-01
    [offer_date_expiration] => 
    [offer_note] => Poznámka pod položkami
    [offer_note_above] => Poznámka nad položkami
    [offer_api_custom] => Test custom
    [offer_language] => cz
    [items] => Array
        (
            [0] => Array
                (
                    [item_name] => Diamantový kotouč na obklady 
                    [item_unit] => ks
                    [item_quantity] => 8
                    [item_unit_price] => 518
                    [item_unit_price_total] => 626.78
                    [item_vat_rate] => 21
                    [item_vat_total] => 870.24
                    [item_unit_price_vat] => 626.78
                    [item_unit_price_totla_vat] => 5014.24
                    [item_api_custom] => 
                )

            [1] => Array
                (
                    [item_name] => Sada nylonových drátěných kartáčů
                    [item_unit] => ks
                    [item_quantity] => 10
                    [item_unit_price] => 178.51
                    [item_unit_price_total] => 216
                    [item_vat_rate] => 21
                    [item_vat_total] => 374.88
                    [item_unit_price_vat] => 216
                    [item_unit_price_totla_vat] => 2160
                    [item_api_custom] => 
                )

        )

    [offer_tags] => Array
        (
            [0] => Tag 1
            [1] => Tag 2
        )

)

https://www.fakturyweb.cz/api/cn-list/created?data={JSON}

https://www.fakturyweb.cz/api/cn-list/issued?data={JSON}

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

<?php

// Příprava základních dat:
$data = [];

// Váš API klíč:
$data['key'] = "dJyMc*53@687*wGhofIWi!WDcEEQUdmj";

// Váš email (příp. uživatelské jméno):
$data['email'] = "name@example.com";

// Data se uloží do formátu JSON:
$data_json = json_encode($data);

// Inicializace sezení
$url = 'https://www.fakturyweb.cz/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_FOLLOWLOCATION, true);
curl_setopt($ch, CURLOPT_CONNECTTIMEOUT, 5);
$output = curl_exec($ch);


// Výsledek:
$result = json_decode($output, true);
if ($result['status'] != 1) {
    throw new Exception("Vyskytla se chyba č. " . $result['status']);
}


// Data v kalendářním roce 2022
$data['from'] = '2022-01-01';
$data['to'] = '2022-12-31';
// Data se uloží do formátu JSON:
$data_json = json_encode($data);


// Data se odešlou:
$url = 'https://www.fakturyweb.cz/api/cn-list/issued?data=' . urlencode($data_json);
curl_setopt($ch, CURLOPT_URL, $url);
$output = curl_exec($ch);



// Výsledek:
$result = json_decode($output, true);
if ($result['status'] == 1) {
    $cenovePonuky = $result['offers'];
    foreach ($cenovePonuky as $cenovaPonuka) {
        echo "Kód: {$cenovaPonuka['code']} \n";
        echo "Dodavatel: {$cenovaPonuka['supplier']} \n";
        echo "Dodavatel IČO: {$cenovaPonuka['supplier_ico']} \n";
        echo "Odběratel / Zákazník: {$cenovaPonuka['customer']} \n";
        echo "Odběratel / Zákazník IČO: {$cenovaPonuka['customer_ico']} \n";
        echo "Číslo cenové nabídky: {$cenovaPonuka['offer_number']} \n";
        echo "Částka bez DPH: {$cenovaPonuka['offer_amount']} \n";
        if (isset($cenovaPonuka['offer_amount_vat'])) {
            echo "Částka s DPH: {$cenovaPonuka['offer_amount_vat']} \n";
        }
        echo "Měna: {$cenovaPonuka['offer_currency']} \n";
        echo "Datum vystavení: {$cenovaPonuka['offer_date_issue']} \n";
        echo "Datum platnosti: {$cenovaPonuka['offer_date_expiration']} \n";
        echo "Vlastní data z API: {$cenovaPonuka['offer_api_custom']} \n";
        echo "Tagy cenové nabídky: {$cenovaPonuka['tags']} \n";
    }
} else {
    echo "Vyskytla se chyba č." . $result['status'];
}

Array
(
    [status] => 1
    [offers] => Array
        (
            [0] => Array
                (
                    [code] => ae47ece062b0021144d768446b071fee
                    [supplier] => Moje společnost, s.r.o.
                    [supplier_ico] => 60991234
                    [customer] => Petr Novák
                    [customer_ico] => 40436097
                    [offer_number] => 20220123
                    [offer_amount] => 2000
                    [offer_amount_vat] => 2420
                    [offer_currency] => CZK
                    [offer_date_issue] => 2022-01-10
                    [offer_date_expiration] => 2022-01-25
                    [offer_api_custom] => data z API
                    [tags] => Tag1 ,Tag2
                )

        )

)