Verze 2.1.0

redbitcz · Jul 26, 2016 · 52e5be0 · 52e5be0
1 parent 0b4ffab
commit 52e5be0
Show file tree

Hide file tree

Showing 9 changed files with 629 additions and 0 deletions.
diff --git a/.gitignore b/.gitignore
@@ -0,0 +1 @@
+nbproject/
diff --git a/1-test.php b/1-test.php
@@ -0,0 +1,12 @@
+<?php
+
+include(__DIR__.'/inc/inc.php');
+$vyfakturuj_api = new VyfakturujAPI(VYFAKTURUJ_API_LOGIN,VYFAKTURUJ_API_KEY);
+
+$result = $vyfakturuj_api->test();
+
+echo '<h2>Test připojení k serveru:</h2>';
+echo '<pre>'.print_r($result,true).'</pre>';
+
+
+exit;
diff --git a/2-invoice.php b/2-invoice.php
@@ -0,0 +1,112 @@
+<?php
+
+include(__DIR__.'/inc/inc.php');
+$vyfakturuj_api = new VyfakturujAPI(VYFAKTURUJ_API_LOGIN,VYFAKTURUJ_API_KEY);
+
+#
+#
+####################################################################################
+####################################################################################
+#####                                                                          #####
+#####                             Vytvoření faktury                            #####
+#####                                                                          #####
+####################################################################################
+####################################################################################
+#
+#
+
+$opt = array(
+    'customer_IC' => '123456789',
+    'customer_DIC' => 'CZ123456789',
+    'customer_name' => 'Ukázková Firma',
+    'customer_street' => 'Pouliční 79/C',
+    'customer_city' => 'Praha',
+    'customer_zip' => '10300',
+    'customer_country' => 'Česká republika',
+    'items' => array(
+        array(
+            'text' => 'Stěrač na ponorku',
+            'unit_price' => 990.25,
+            'vat_rate' => 15,
+        ),
+        array(
+            'text' => 'Kapalina do ostřikovačů 250 ml',
+            'unit_price' => 59,
+            'vat_rate' => 15,
+        )
+    )
+);
+
+$inv = $vyfakturuj_api->createInvoice($opt);    // vytvoříme novou fakturu
+
+echo '<h2>Vytvořili jsme fakturu:</h2>';
+echo '<pre>'.print_r($inv,true).'</pre>';
+
+$_ID_DOKUMENTU = $inv['id'];    // uložíme si ID nového dokumentu
+#
+#
+####################################################################################
+####################################################################################
+#####                                                                          #####
+##### Úprava již vytvoření faktury (budeme upravovat právě vytvořenou fakturu) #####
+#####                                                                          #####
+####################################################################################
+####################################################################################
+#
+#
+
+$opt = array(
+    'customer_name' => 'Ukázková Firma po úpravě',// Změníme název
+    'items' => array(// odstraníme druhou položku a necháme jen jednu
+        array(
+            'text' => 'Stěrač na ponorku',
+            'unit_price' => 990.25,
+            'vat_rate' => 15,
+        ),
+    )
+);
+
+$inv2 = $vyfakturuj_api->updateInvoice($_ID_DOKUMENTU,$opt);    // upravíme fakturu
+
+echo '<h2>Upravili jsme fakturu:</h2>';
+echo '<pre>'.print_r($inv2,true).'</pre>';
+
+
+#
+#
+####################################################################################
+####################################################################################
+#####                                                                          #####
+#####                 Získání informací o již vytvoření faktuře                #####
+#####                                                                          #####
+####################################################################################
+####################################################################################
+#
+#
+
+
+$inv3 = $vyfakturuj_api->getInvoice($_ID_DOKUMENTU);
+
+echo '<h2>Načetli jsme data o faktuře ze systému:</h2>';
+echo '<pre>'.print_r($inv3,true).'</pre>';
+
+
+#
+#
+####################################################################################
+####################################################################################
+#####                                                                          #####
+#####                              Smazání faktury                             #####
+#####                                                                          #####
+####################################################################################
+####################################################################################
+#
+#
+
+exit;   // zablokování smazání
+
+$inv4 = $vyfakturuj_api->deleteInvoice($_ID_DOKUMENTU);
+
+echo '<h2>Načetli jsme data o průběhu smazání faktury ze systému:</h2>';
+echo '<pre>'.print_r($inv4,true).'</pre>';
+exit;
diff --git a/3-contact.php b/3-contact.php
@@ -0,0 +1,114 @@
+<?php
+
+include(__DIR__.'/inc/inc.php');
+$vyfakturuj_api = new VyfakturujAPI(VYFAKTURUJ_API_LOGIN,VYFAKTURUJ_API_KEY);
+
+#
+#
+#####################################################################################
+#####################################################################################
+#####                                                                           #####
+#####                                 Vytvoření                                 #####
+#####                                                                           #####
+#####################################################################################
+#####################################################################################
+#
+#
+
+$opt = array(
+    'IC' => '123456789',
+    'name' => '#API - Ukázkový kontakt',// "#API - " dáváme na začátek, chceme mít tento kontakt na začátku našeho adresáře
+    'note' => 'Kontakt vytvořený přes API',
+    'company' => 'Ukázkový kontakt',
+    'street' => 'Pouliční 79/C',
+    'city' => 'Praha',
+    'zip' => '10300',
+    'country' => 'Česká republika',
+    'mail_to' => '[email protected]',
+);
+
+$contact = $vyfakturuj_api->createContact($opt);    // vytvoříme novou fakturu
+
+echo '<h2>Vytvořili jsme kontakt:</h2>';
+echo '<pre>'.print_r($contact,true).'</pre>';
+
+$_ID_KONTAKTU = $contact['id'];    // uložíme si ID nového kontaktu
+#
+#
+#####################################################################################
+#####################################################################################
+#####                                                                           #####
+#####                                  Úprava                                   #####
+#####                                                                           #####
+#####################################################################################
+#####################################################################################
+#
+#
+
+$opt = array(
+    'name' => '#API - Ukázkový kontakt - po úpravě',//
+);
+
+$contact2 = $vyfakturuj_api->updateContact($_ID_KONTAKTU,$opt);    // upravíme kontakt
+
+echo '<h2>Upravili jsme fakturu:</h2>';
+echo '<pre>'.print_r($contact2,true).'</pre>';
+
+
+#
+#
+#####################################################################################
+#####################################################################################
+#####                                                                           #####
+#####                                   Čtení                                   #####
+#####                                                                           #####
+#####################################################################################
+#####################################################################################
+#
+#
+
+
+$contact3 = $vyfakturuj_api->getContact($_ID_KONTAKTU); // načte 1 konkrétní kontakt
+// $contact3 = $vyfakturuj_api->getContacts();  // vrátí všechny moje kontakty
+
+echo '<h2>Načetli jsme data o kontaktu ze systému:</h2>';
+echo '<pre>'.print_r($contact3,true).'</pre>';
+
+
+
+
+
+#
+#
+#####################################################################################
+#####################################################################################
+#####                                                                           #####
+#####                                  Smazání                                  #####
+#####                                                                           #####
+#####################################################################################
+#####################################################################################
+#
+#
+
+exit;   // zablokování smazání
+
+$contact4 = $vyfakturuj_api->deleteContact($_ID_KONTAKTU);
+
+echo '<h2>Načetli jsme data o průběhu smazání kontaktu ze systému:</h2>';
+echo '<pre>'.print_r($contact4,true).'</pre>';
+
+
+#
+#
+#####################################################################################
+#####################################################################################
+#####                                                                           #####
+#####                        Získání všech kontaktů                             #####
+#####                                                                           #####
+#####################################################################################
+#####################################################################################
+#
+#
+
+
+exit;
diff --git a/4-template.php b/4-template.php
@@ -0,0 +1,132 @@
+<?php
+
+include(__DIR__.'/inc/inc.php');
+$vyfakturuj_api = new VyfakturujAPI(VYFAKTURUJ_API_LOGIN,VYFAKTURUJ_API_KEY);
+
+#
+#
+#####################################################################################
+#####################################################################################
+#####                                                                           #####
+#####                                 Vytvoření                                 #####
+#####                                                                           #####
+#####################################################################################
+#####################################################################################
+#
+#
+// Vytvoříme nový kontakt
+$opt_contact = array(
+    'IC' => '123456789',
+    'name' => '#API - Ukázkový kontakt pro pravidelnou fakturu',// "#API - " dáváme na začátek, chceme mít tento kontakt na začátku našeho adresáře
+    'note' => 'Kontakt vytvořený přes API',
+    'company' => 'Ukázkový kontakt',
+    'street' => 'Pouliční 79/C',
+    'city' => 'Praha',
+    'zip' => '10300',
+    'country' => 'Česká republika',
+    'mail_to' => '[email protected]',
+);
+$contact = $vyfakturuj_api->createContact($opt_contact);    // vytvoříme nový kontakt
+
+$_ID_CONTACT = $contact['id'];
+
+$opt_template = array(
+    'id_customer' => $_ID_CONTACT,// vložíme právě vytvořený kontakt
+//    'id_customer' => 20224,// vložíme právě vytvořený kontakt
+    'type' => 2,// chceme pravidelnou fakturu
+    'name' => '#API - Test pravidelné faktury',
+//    'id_customer' => $contact['id'],// vložíme právě vytvořený kontakt
+    'items' => array(
+        array(
+            'text' => 'Stěrač na ponorku',
+            'unit_price' => 990.25,
+            'vat_rate' => 15,
+        ),
+        array(
+            'text' => 'Kapalina do ostřikovačů 250 ml',
+            'unit_price' => 59,
+            'vat_rate' => 15,
+        )
+    )
+);
+
+
+$ret = $vyfakturuj_api->createTemplate($opt_template);    // vytvoříme novou fakturu
+
+echo '<h2>Vytvořili jsme pravidelnou fakturu:</h2>';
+echo '<pre>'.print_r($ret,true).'</pre>';
+
+$_ID_ITEM = $ret['id'];    // uložíme si ID nového zaznamu
+#
+#
+#####################################################################################
+#####################################################################################
+#####                                                                           #####
+#####                                  Úprava                                   #####
+#####                                                                           #####
+#####################################################################################
+#####################################################################################
+#
+#
+
+$opt_template = array(
+    'name' => '#API + Test pravidelné faktury',// změníme název
+    'items' => array(
+        array(
+            'text' => 'Stěrač na ponorku',
+            'unit_price' => 990.25,
+            'vat_rate' => 21,// změníme DPH
+        ),
+        array(
+            'text' => 'Kapalina do ostřikovačů 250 ml',
+            'unit_price' => 59,
+            'vat_rate' => 21,// změníme DPH
+        )
+    )
+);
+
+$ret2 = $vyfakturuj_api->updateTemplate($_ID_ITEM,$opt_template);    // upravíme zaznam
+
+echo '<h2>Upravili jsme pravidelnou fakturu:</h2>';
+echo '<pre>'.print_r($ret2,true).'</pre>';
+
+
+#
+#
+#####################################################################################
+#####################################################################################
+#####                                                                           #####
+#####                                   Čtení                                   #####
+#####                                                                           #####
+#####################################################################################
+#####################################################################################
+#
+#
+
+
+$ret3 = $vyfakturuj_api->getTemplate($_ID_ITEM);
+
+echo '<h2>Načetli jsme data o pravidelné faktuře faktuře ze systému:</h2>';
+echo '<pre>'.print_r($ret3,true).'</pre>';
+
+
+#
+#
+#####################################################################################
+#####################################################################################
+#####                                                                           #####
+#####                                  Smazání                                  #####
+#####                                                                           #####
+#####################################################################################
+#####################################################################################
+#
+#
+exit;   // zablokování smazání
+
+$ret4 = $vyfakturuj_api->deleteTemplate($_ID_ITEM);
+$ret5 = $vyfakturuj_api->deleteContact($_ID_CONTACT);
+
+echo '<h2>Načetli jsme data o průběhu smazání faktury ze systému:</h2>';
+echo '<pre>'.print_r($ret4,true).'</pre>';
+echo '<pre>'.print_r($ret5,true).'</pre>';
+exit;
diff --git a/README.md b/README.md
@@ -1,2 +1,9 @@
 # Vyfakturuj API PHP
 API napojení na aplikace Vyfakturuj.cz
+
+## Postup instalace
+1) V souboru /inc/inc.php doplnit potřebné údaje
+2) Spustit 1-test.php a otestovat připojení na server (musí se zobrazit welcome zpráva s datumem)
+3) V souboru 2-invoice.php se nachází ukázka, jak vytvářet, updatovat, získávat a mazat faktury
+4) V souboru 3-contact.php se nachází ukázka, jak vytvářet, updatovat, získávat a mazat kontakty
+5) V souboru 4-template.php se nachází ukázka, jak vytvářet, updatovat, získávat a mazat pravidelné faktury a šablony
diff --git a/changelog.txt b/changelog.txt
@@ -0,0 +1,11 @@
+Verze 2.1.0
+-----------
++ Vytváření, úprava, čtení a mazání kontaktů
++ Vytváření, úprava, čtení a mazání šablon
++ Vytváření, úprava, čtení a mazání pravidelných faktur
++ Mazání faktur
+
+Verze 2.0.0
+-----------
++ Připojení na server
++ Vytváření, úprava a čtení faktur