Modul: Česká a Slovenská faktura, dodací list a dobropis pro PrestaShop

Vzory (PDF): faktura, dodací list, dobropis

Vlastnosti modulu

• kompatibilita: PrestaShop 1.7.x, 1.6.x, 1.5.x
• kompatibilita: Thirty Bees 1.x
• podpora funkce Multistore (více obchodů)
• plná multi-měnová podpora - všechny bankovní údaje je možná zadávat pro každou platební měnu samostatně
• plná multi-jazyční podpora - všechny textové údaje je možná zadávat pro každý z jazyků samostatně
• podpora PayPal plateb - zadání a zobrazování PayPal byznys údajů (e-mailová adresa a MAID)
• platební QR kód - zákazník může fakturu uhradit oskenování QR kódu na faktuře (funkčnost je závislá na bezplatných generátorech QR kódu - PAY by Square a paylibo.com)
• na fakturách zobrazuje směnný kurz a duální ceny, pokud je objednávka v jiné platební měně, jako výchozí
• podpora zaokrouhlování celkové ceny nákupu na faktuře na 5 euro-centů a možnost určit podmínky zaokrouhlování (na základě stavů objednávek a způsobu platby)
• zobrazení textu "Faktura je zaplacena" a možnost nastavit podmínky zobrazení na základě stavů objednávek
• dostupné překlady modulu: český, slovenský a anglický
• modul využívá fukci nahrazování (angl. override)
• upravuje vzhled PDF pro:
  • faktury
  • B2B faktury
  • dodací listy
  • dobropisy
• vzhled faktur splňuje platné požadavky Finančního úřadu České republiky a Daňového úřadu Slovenské republiky
• funkce:
  • změna typu písma PDF dokumentů
  • změna velikosti písma PDF dokumentů
  • změna velikosti písma v PDF
  • nahrávání / odstraňování obrázku firemního loga a razítka v PDF dokumentech
  • nastavování / změna doby splatnosti faktur
  • určení "Datum vystavení" faktury jako datum vystavení objednávky, nebo generování faktury
  • zadávání rozdílných bankovních údajů pro každou platební měnu používanou v e-shopu
  • zobrazení pouze fakturační adresy zákazníka (pokud je zákazníkem vyplněna)
  • možnost nastavit barevně odlehčenou verzi PDF (vhodné pro šetření toneru tiskárny)
  • možnost skrýt jméno osoby ve fakturační adrese zákazníka, pokud existuje název firmy
  • možnost nastavit vlastní název souboru generovaných PDF
  • detekování a zobrazení informace o přenesení daňové povinnosti (pokud jste plátce DPH a při nákupu plátcem DPH z jiné členské země Evropské unie)
  • generování odlišného typu faktur na základě toho, zda je obchodník plátce, nebo neplátce DPH
  • přidávání vlastních informačních textů do paty PDF dokumentů

Instalace modulu

1. Nahrajte složku "cmfaktura" do složky /modules/ prostřednictvím FTP (doporučeno), nebo použijte nástroj pro nahrávání modulů v části: Kontrolní panel » Moduly » Přidat nový modul
2. Ověřte na FTP serveru práva pro zápis systému (CHMOD 777) do složek a souboru:
   1. /tools/tcpdf/fonts
   2. /override/classes/pdf
   3. /cache/class_index.php
   Tento krok není povinný, je pouze doporučený pro snížení rizika neúspěšné instalace modulu. Modul se při instalaci pokouší nahrát do těchto složek soubory nezbytné pro svůj provoz. Pokud modul soubory nenahraje, neproběhne ani jeho instalace. Systémový soubor class_index.php si zároveň uloží informaci o nově nahraných souborech ve složce: /override/classes/pdf.
3. Proveďte instalaci modulu v části: Kontrolní panel » Moduly
4. Po úspěšné instalaci přejděte do nastavení modulu a zadejte povinné a nepovinné údaje.
5. Tímto je modul připraven pro práci v ostrém provozu.
6. Pokud by se vyskytl problém, kontaktujte prosím autora modulu.

Časté dotazy při instalaci a provozu modulu

Nedaří se mi modul nainstalovat. Co mám udělat jako první?
Odpověď: Nejčastějším důvodem jsou nastaveny nekorektní práva pro zápis do složek na serveru. Postupujte prosím podle kroku č.2 (Instalace modulu).

Modul je úspěšně nainstalován. PrestaShop ale stále generuje PDF bez změny vzhledu (nebo žádné). Kde může být problém?
Odpověď: Zkontrolujte prosím práva na zápis do souboru /cache/class_index.php. Nahlédněte prosím do kroku č.2 (Instalace modulu). Pokud tento soubor neobsahuje záznam o nahrazených souborech ve složce "override", modul nebude pracovat správně. Problém se může vyskytnout u starších verzí PrestaShop (1.6.0.9 a nižších). Pomůže, pokud soubor zcela odstraníte (předtím si ho zálohujte) a PrestaShop si vytvoří nový. Současně zkontrolujte práva na zápis pro nový soubor.

Nedaří se mi nahrát logo (razítko) do modulu, nebo se mi při generování faktury zobrazí chybová zpráva (resp. bílá stránka). Co s tim?
Odpověď: Pravděpodobně jste nahráli obrázek v nekorektním tvaru. Často se stává, že obrázek typu JPG je pouze přejmenován na typ PNG apod. V takovém případě se může stát, že systém takovou chybu obrázku zaznamená a fakturu z tohoto důvodu nevygeneruje. Vytvořte, zda převeďte v grafickém editoru obrázky korektně a zkuste do modulunahrať znovu.

Generované faktury obsahují / neobsahují rozpis DPH i když nejsem / jsem plátce DPH. Proč a jak to napravit?
Odpověď: Ujistěte se, že máte nastaveno možnosti "Je subjekt plátce DPH" (nastavení modulu) a "Povolit daň" (v části: Lokalizace > Daně) tak, že odpovídají Vaší aktuální skutečnosti. Pokud máte v PrestaShop zapnuté daně, jste zřejmě plátce DPH. V modulu proto nastavte možnost "Je subjekt plátce DPH" na hodnotu "áno". To zabezpečí, že sa vo faktúrach bude zobrazovať rozpis a rekapitulaci DPH.

Poznámka: Především po aktualizaci PrestaShopu ze starších verzí (1.4.xa nižších) se stává, že i když obchodník je (byl) neplátce DPH, měl systém nastaven jako plátce DPH, avšak při produktech neuváděl výšku DPH "0%" a ceny zboží uváděl včetně DPH. V současné verzi měl pak systém zapnutou možnost "Povolit daň", avšak produkty má bez sazby DPH (jako v e-shopu, tak i ve fakturách). V tomto případě je nutné opravit všechny produkty a přiřadit jim sazbu DPH.

Obrázek loga a / nebo razítka je v PDF dokumentu rozostřený a nevypadá dobře. Jak to opravit?
Odpověď: Pokud máte v modulu nahrané obrázky loga a razítka v standardní webové hustotě bodů 72 dpi, mohou být v PDF rozostřené. Nahrajte proto prosím do modulu obrázky s hustotou 300 dpi.

Legislatíva spojená s fakturáciou v SR

• Zákon o správe daní - daňový poriadok (563/2009 Z.z.)
• Zákon o DPH (222/2004 Z.z.)
• Zákon o dani z príjmov (595/2003 Z.z.)
• Zákon o účtovníctve (431/2002 Z.z.)
• Obchodný zákonník (513/1991 Z.z.)

Legislatíva spojená s fakturáciou v ČR

• Nový Občanský zákoník (Předpis č. 89/2012 Sb.)
• Zákon o DPH (Předpis č. 235/2004 Sb.)
• Daňový řád (Předpis č. 280/2009 Sb.)
• Zákon o daních z příjmů (Předpis č. 586/1992 Sb.)
• Zákon o účetnictví (Předpis č. 563/1991 Sb.)
• Zákon o ochraně spotřebitele (Předpis č. 634/1992 Sb.)

Faktúra

Dodací list

Dobropis

SLOVAK AND CZECH INVOICE MODULE - CHANGELOG

------------------------ PrestaShop 1.7.x ------------------------

version 3.1.9 (07/12/2022)
    + added an option (under custom conditions) to allow rounding Total order price on invoice to 5 Cents

version 3.1.8 (05/18/2022)
    x changed module filename "cmfaktura" into "cm_faktura"
    x BO design changes
    x fixed FA_YEAR_SHAPE variable name
    + added an option to select order states when "Invoice paid" will appear on invoice
    + added an option to select shape of the year in the numbering - short (2 digits) and large (4 digits)
    + added BO module tabs for better UX usability and experience
    - removed 'hint' parameters from module BO

version 3.1.7 (02/28/2021)
    + added QR payment code on invoices
      EUR: via PAY by Square
      CZK: via paylibo.com
    x fixed image URLs
    x improved conversion rate format on invoice
    x improved variable symbol variations available to choose
    - removed maxlength for BO account details fileds
    - removed module JS file that affected PrestaShop BO

version 3.1.6 (05/12/2020)
    x correct installation of the 'displayBackOfficeHeader' hook - the bug avoid correct module installation

version 3.1.5 (07/25/2020)
    x fixed credit slip tax excl. and incl. prices
    x wrapping cost moved from summary into items table with full details
    x fixed summary table
    x fixed tax rate on invoice
    - removed testing code from the invoice templates that produced an errors

version 3.1.4 (01/15/2020)
    + added OrderInvoice.php override - fix for displaying invoice number in the order detail
    + added new options to better shaping PDF numbering: 
      * Number series identifier
      * Number of zeros in the numbering
    x improving alert system if the module is installed correctly

version 3.1.3 (01/12/2020)
    x fixed PDF filenames
    x fixed invoice number on the order slip
    x fixed displaying invoice custom notes
    + added generate advanced delivery and order slip number (missing PrestaShop feature)
    + added icons into fields in module Back office
    + added build-in invoice & delivery & credit slips settings into module ("Documents numbering settings" panel)

version 3.1.2 (12/16/2019)
    x fixed displaying Cash On Delivery fee when PDF is sent as email attachment by Cash On Delivery Plus module (from version 1.7.3)

version 3.1.1 (06/11/2019)
    x fixed displaying decimal places for Cash On Delivery Fee
    + added formated document numbers

version 3.1.0 (06/04/2019)
    x fixed displaying Cash On Delivery fee
    + added Odrder.php override - fix for Cash On Delivery Plus fee
    + added "Don't pay, already paid!" note on the invoice if the order is paid
    + added option to display/hide product images
    + added an option to chose language of PDF generated by merchant (customer or merchant language) - fixed default behavior of PrestaShop

version 3.0.4 (11/16/2018)
    + added option to display/hide Manufacturer (Brand) column into all PDF documents
    + added/fix column with an original price when price is discounted

version 3.0.3 (08/09/2018)
    + added Discount vouchers into Order slip
    x fixed Total amount in Order slip

version 3.0.2 (12/02/2017)
    x fixed tax rate for discount vouchers
    x rewrited Tax recapitulation table + table formating
    x fixed undefined variables in the HTMLTemplate.php file
    + added Invoice number into Order slip
    x fixed Order number in the Credit slip
    - removed useless code

version 3.0.1 (11/13/2017)
    x fixed line height of the Due date text
    x fixed variables for module info and documentation + links

version 3.0.0 (12/29/2016)
    + initial release for PrestaShop 1.7.x (testing environment: PrestaShop 1.7.0.3)
    x updated module documentation

------------------------ PrestaShop 1.6.x ------------------------

version 2.1.4 (02/28/2021)
    + added QR payment code on invoices
      EUR: via PAY by Square
      CZK: via paylibo.com
    x fixed image URLs
    x improved conversion rate format on invoice
    x improved variable symbol variations available to choose
    - removed maxlength for BO account details fileds

version 2.1.3 (05/12/2020)
    x correct installation of the 'displayBackOfficeHeader' hook - the bug avoid correct module installation
    x fixed Order Slip template

version 2.1.2 (01/15/2020)
    + added OrderInvoice.php override - fix for displaying invoice number in the order detail
    + added new options to better shaping PDF numbering: 
      * Number series identifier
      * Number of zeros in the numbering
    x improving alert system if the module is installed correctly

version 2.1.1 (12/31/2019)
    x fixed PDF filenames
    x fixed invoice number on the order slip
    x fixed displaying invoice custom notes
    x fixed displaying Cash On Delivery fee when PDF is sent as email attachment by Cash On Delivery Plus module (from version 1.6.9)
    + added generate advanced delivery and order slip number (missing PrestaShop feature)
    + added icons into fields in module Back office
    + added build-in invoice & delivery & credit slips settings into module ("Documents numbering settings" panel)

version 2.1.0 (06/04/2019)
    x fixed displaying Cash On Delivery fee
    + added Odrder.php override - fix for Cash On Delivery Plus fee
    + added "Don't pay, already paid!" note on the invoice if the order is paid
    + added option to display/hide product images
    + added an option to chose language of PDF generated by merchant (customer or merchant language) - fixed default behavior of PrestaShop

version 2.0.15 (11/24/2018)
    + added option to display/hide Manufacturer (Brand) column into all PDF documents
    + added/fix column with an original price when price is discounted
    + added an option to chose language of PDF generated by merchant (customer or merchant language) - fixed default behavior of PrestaShop

version 2.0.14 (08/09/2018)
    + added Discount vouchers into Order slip
    x fixed Total amount in Order slip

version 2.0.13 (07/10/2018)
    x fixed PDF headers in Delivery & Order slip
    x fixed saving "Tax notification for foreign customers" text in the module settings
    x fixed displaying "Tax notification for foreign customers" text in the PDF
    x fixed tax rate for discount vouchers

version 2.0.12 (03/03/2018)
    + added pieces volume
    + added Cash On Delivery fee with conjunction our "Cash On Delivery Plus" module

version 2.0.11 (12/02/2017)
    x fixed bug in Credit slip
    x fixed Order number in the Credit slip

version 2.0.10 (07/03/2017)
    x fixed Tax recapitulation table + table formating
    x fixed invoice numbering
    + added Invoice number into Order slip

version 2.0.9 (12/15/2016)
    + added "Order slip for invoice" into Order slip
    x rewrited product customization row in the Invoices and added into Delivery slips
    x fixed typo PDH and others
    x fixed "Issue invoice date behavior" function
    x updated "Terms and conditions of use" document

version 2.0.8 (11/02/2016)
    + added field for notification about TAX payment for foreign EU customers
    + added description info "Cash on Delivery" field
    x updated module documentation

version 2.0.7 (10/16/2016)
    + added an option for display / hide person name when invoice address including company name
    + added an option to change PDF design (for reducing solid black areas for saving toner printers etc.)
    + added an options to add custom multi-language filename of PDF's
    x fixed displaying VAT number field placeholder 
    x fixed saving/deleting initial texts for multi-language after module installation/unistallation
    x "img" folder moved into "views" folder
    x improved design & code

version 2.0.6 (10/03/2016)
    x fixed getPagination function in Delivery slips for PrestaShop 1.6.1.5 and new

version 2.0.5 (04/06/2016)
    x improved invoice layout design
    x removed customer name if Company name exist

version 2.0.4 (03/30/2016)
    x fixed PHP 7 issue - eregi_replace

version 2.0.3 (01/19/2016)
    + added an option to choose invoice issue date
    x minor changes

version 2.0.2 (11/25/2015)
    + added custom text for electronic goods distribution
    + added PayPal account information support
    + added multilanguage support for texts
    + added conversion rate and dual prices when an order isn't in default currency
    + added main module 57x57px logo
    x updated module documentation

version 2.0.1 (10/31/2015)
    x fixed fa_sk variable
    x fixed bug where delivery address displayed instead invoice address
    x fixed Constant symbol initial value
    x fixed list of Fonts - removed no exist fonts
    + added textarea fields dimensions
    + to-do: correct loading bank account variables for each currency
    + added customer's mobile and phone number into PDF

version 2.0.0 (08/19/2015)
    + added ability to change PDF font size
    + added multi-language module installer
    + changed Country field to selector using PrestaShop's country list
    + added State field selector using PrestaShop's State list
    x corrected module translations
    x rewritten module core for BOOTSTRAP
    x added alert for override files availability
    x changed module logo
    x updated module documentation
    - removed useless code

version 1.9.0 (08/17/2015)
    x fixed issue for PrestaShop 1.6.1.0
    x fixed width / height variable mistake
    + added Multi-store support
    + added logo and stamp image upload & delete tool
    + added timestamp into images filename to prevent loading old image from user's browser cache
    + added ability to setup business bank information for each currency independently
    + added option to display customer's invoice address only
    + added alert when "Disable all overrides" option is allowed
    + added alert when "Allow Tax" and "Is tax payer" options are different
    + added module documentation
    + moved templates into module folder
    x removed install.php and unistall.php separate files
    x fixed minor bugs
    x rewriting some module parts

version 1.8.0 (06/08/2015)
    x fixed sum of products and shipping total prices
    x fixed prices before discount

version 1.7.0 (09/22/2014)
    x removed employee name in PDFGenerator.php
    x fixed missing variables definition $fa_note3
    
version 1.6.0 (05/08/2014)
    + added variables: $date_due_orderslip, $taxable_date_orderslip
    x fixed missing variables definition
    
version 1.5.0 (04/18/2014)
    x fixed undefined values
    x checking the PrestaShop 1.6.x compatibility

version 1.4.0 (01/12/2014)
    + added field "Name of the person on the stamp"
    + added feature allowing break line text from textarea fields
    + added feature allowing set shape of the variable symbol
    + added field TAX ID
    x fixed displaying customers VAT ID
    x fixed PDF filenames; now included ID with prefix of the document
    x modified "id TAX payer" info on PDF regarding to country
    - fixed country selector

version 1.3.0 (10/04/2013)
    x fixed different display content issue for not TAX payer

version 1.2.0 (09/09/2013)
    x fixed Order slip date
    - added Credit slip prefix

version 1.1.0 (27/102013)
    - added DejaVu Sans Condensed and DejaVu Serif Condensed fonts
    - added nobr="true" attribute to safe braking the page content
    x improved PDF design
    x fixed various bugs
    
version 1.0.0 (12/262012)
    + initial release for PrestaShop 1.5.x

---------------------

Legend:
    + added a new feature
    x fixed issue, updated feature
    - removed feature