Skip to content

ZdruzenieSTROM/faktury

Repository files navigation

Vytváranie faktúr

Skripty pre rýchle vytváranie faktúr na STROMácke akcie.

Návod pre vyplnenie súborov na akciu

  1. Nájdi v priečinku templates súbory k typu akcie, na ktorú chceš faktúry vytvoriť.
  2. Vyplň údaje v .csv všetky údaje. Ak fakturujeme na osobu, stačí vyplniť to čo uviedli. Ak fakturujeme na firmu treba uviesť všetko aj IČO. Postupuj ako v návode nižšie .Pomenuj ho nazov_akcieROK.csv napríklad lomihlav2024.yaml
  3. Vyplň nastavenia v .yaml súbore. Podľa návodu nižšie. Pomenuj ho nazov_akcieROK.yaml napríklad lomihlav2024.yaml
  4. Pošli oba súbory na mail osobe, ktorá má povolenie spravovať faktúry.

Vyplnenie údajov o odberateľoch (.csv súbor)

Ak kopíruješ súbor zo vzoru nechaj v ňom hlavičku (prvý riadok súboru, kde sú názvy stĺpcov)

Popis možných stĺpcov:

  • o_name - Meno firmy, školy alebo rodiča, prípadne účastníka (ak už mal 18).
  • o_street - Ulica s číslom sídla firmy/bydlisko
  • o_city - Mesto sídla
  • o_state - Štát sídla. Zvyčajne Slovensko.
  • o_zip - PSČ
  • o_ico - IČO v prípade firmy. Ak sa jedná o rodiča/ účastníka ostáva prázdne.
  • o_dic - DIČ v prípade firmy. Ak sa jedná o rodiča/ účastníka ostáva prázdne.
  • o_icdph -
  • o_email - Email (nepovinné)
  • ucastnicky - pocet kusov, kolkokrat danu vec uhradzaju (1)
  • f_paid - Suma, ktorá už bola uhradená - Vyplniť iba ak už zaplatili. Ak je vyplnené, treba vyplniť aj i_date_paid
  • i_date_paid - Dátum úhrady. Je potrebné vyplniť iba ak bolo niečo vyplnené v f_paid.
  • f_payment - Možné hodnoty: hotovost,prevod,karta. Ak nie je uvedené, defaultne sa použije prevod
  • f_original_num - Ak vystavujeme opravnú faktúru(dobropis/ťarchopis), číslo pôvodnej faktúry, ktorú opravujeme

Ďalej je možné doplniť vlastné stĺpce a to konkrétne dva typy.

  1. Prvý typ má i_* musíme mať teda prefix i_. Napríklad i_meno_ucastnika. Takýto stĺpec.
  2. Druhý typ sú položky. Napríklad účastnícky poplatok alebo bageta. Názov stĺpca musí zodpovedať položke v nastaveniach pod kľúčom polozky. Tieto názvy nesmú mať prefixy i_, o_, f_.

Ďalej je možné aplikovať ďalšie polia podľa návodu https://www.faktury-online.com/faktury-online-api/manual

Vyplnenie nastavení (.yaml súbor)

Konfiguračný súbor obsahuje informácie spoločné pre všetky faktúry. Konkrétne:

  • vystavil - Meno osoby, ktorá faktúru vystavila. Zvyčajne niekto zo štatutárov
  • datum_dodania - Deň dodania služby/výrobku, prípadne deň konania akcie. Ak je akcia viacdňová jej posledný deň. Dátum je vo formáte DD.MM.YYYY
  • datum_vystavenia - deň, keď faktúru vytvárame. Dátum je vo formáte DD.MM.YYYY
  • datum_splatnosti - do kedy je nutné faktúru uhradiť. Zvyknú sa dávať dva týždne. Prípadne do termínu úhrady na pozvánkach na akciu
  • typ - Nepovinné, defaultne sa použije faktúra. Možné hodnoty sú faktura,dobropis,tarchopis
  • poznamka - Text, ktorý je uvedený nad položkami faktúry. Použiť napríklad pri zdôvodnení vydania opravnej faktúry
  • tagy - Zoznam tagov pre zaradenie na portáli. Pre zoznam povolených pozri zoznam tagov na faktury-online.com . Zvyčajne sa jedná o názov súťaže bez diakritiky s prvým veľkým písmenom.
  • polozky - Zoznam poloziek. Identifikátor (vo vzore napríklad bageta a bageta_storno sa použije na pripárovania k rovnomennému stĺpcu v csvčku). Následne každá položka má ako vlastnosti
    • nazov_polozky - Tak bude polozka pomenovaná na faktúre. Môže obsahovať aj formátovateľné stringy(Ťahané zo stĺpcov z prefixom i_). Napríklad {i_meno_ucastnika} bude vo fakture nahradené menom účastníka z csv
    • jednotka - napríklad kus, deň ...
    • cena - Cena za jednotku položky. Použite destinnú bodku

Príklad:

vystavil: Mgr. Jožko Mrkvička
datum_dodania: 1.1.2024
datum_vystavenia: 1.1.2024
datum_splatnosti: 1.1.2024
typ: tarchopis
poznamka: Táto faktúra opravuje chybnú sumu za bagety na pôvodnej faktúre
tagy:
  - Matboj
polozky:
  bageta_storno:
    nazov_polozky: Storno bageta s chybnou cenou
    jednotka: ks
    cena: -1.50
  bageta:
    nazov_polozky: Bageta
    jednotka: ks
    cena: 1.75

Návod pre prácu so scriptami

Setup

Pre spustenie treba najprv nainštalovať dependencie:

pip install -r requirements.txt

Pre zakladanie faktúr je potrebné taktiež pridať file s názvom api_key.txt do priečinka .secrets. Do tohto súboru skopíruj API kľúč z nášho konta na faktury-online.com

Spustenie

Pre vytvorenie faktúry použi príkaz

python faktury.py skontroluj sustredenie
python faktury.py vytvor sustredenie

Generovanie výstupu do denníka

python faktury.py dennik 2023-01-01 2023-01-31

About

Skripty pre rýchle vytváranie faktúr

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages