De/Kundenrechnung
From GnuCash
Hier wird unregelmäßig der aktuelle Stand veröffentlicht. Für all die, die Interesse haben, vor den selben Problem stehen eine äußerlich anpassbare Kundenrechnung erstellen zu benötigen oder gar mithelfen wollen.
Dieser Bericht basiert auf taxinvoice und ist mit gnucash 2.4.7 entwickelt worden. Der aktuelle Zustand ist "es funktioniert - aber weit entfernt von perfekt" :-)
Zur Zeit fehlt dieser Kundenrechnung noch:
- Anpassung der Sprache der Textelemente (derzeit noch ein Mischmasch aus Deutsch und Englisch) Wie realsiert man die Mehrsprachigkeit am saubersten? Wie passt man die Formateausgabe der Werte an (unabhängig von der gnucash-GUI-Sprache)?
- Anzeige auch ohne USt. (siehe Kleinunternehmer)
- html->pdf Konverter via ConTeXt
Die Kundenrechnung besteht aus drei Dateien:
- german-taxincoice.scm
- german-taxinvoice.eguile.scm
- gnucash-zenlima.css
Um den Bericht auf die eigenen Bedürfnisse anzupassen, dürfte es in den meisten Fällen genügen, die CSS-Datei anzupassen.
(wird fortgeführt - be continued)
Contents
Dateien
german-taxinvoice.scm
;; $Author: Zenlima $ $Date: 2011/07/29 09:31:44 $ $Revision: 1.34 $
;; $Author: chris $ $Date: 2009/07/29 09:31:44 $ $Revision: 1.33 $
;;
;; This program is free software; you can redistribute it and/or
;; modify it under the terms of the GNU General Public License as
;; published by the Free Software Foundation; either version 2 of the
;; License, or (at your option) any later version.
;;
;; This program is distributed in the hope that it will be useful,
;; but WITHOUT ANY WARRANTY; without even the implied warranty of
;; MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
;; General Public License for more details.
;;
;; You should have received a copy of the GNU General Public License
;; along with this program; if not, write to the Free Software
;; Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA
;; 02111-1307 USA
; put the (define-module... back when installing as a 'proper' report
; as opposed to referring to it from .gnucash/config.user
; (see http://wiki.gnucash.org/wiki/Custom_Reports )
(define-module (gnucash report taxinvoice))
(use-modules (gnucash main))
(use-modules (gnucash gnc-module))
(use-modules (gnucash app-utils))
(use-modules (gnucash business-utils))
(gnc:module-load "gnucash/report/report-system" 0)
(gnc:module-load "gnucash/business-utils" 0)
(gnc:module-load "gnucash/html" 0)
(gnc:module-load "gnucash/engine" 0)
(use-modules (gnucash report standard-reports))
(use-modules (gnucash report business-reports))
(use-modules (gnucash report eguile-utilities))
(use-modules (gnucash report eguile-html-utilities))
(use-modules (gnucash report eguile-gnc))
(use-modules (srfi srfi-13)) ; for extra string functions
;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
;;; Extension for html-utilities
(use-modules (ice-9 regex)) ; for regular expressions
(use-modules (srfi srfi-13)) ; for extra string functions
(define delimiter " • ")
(define-public (nl->delimiter str)
;; Replace newlines with -
(regexp-substitute/global #f "\n" str 'pre delimiter 'post))
;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
;;; Report-specific routines
(define (taxrate taxable taxtable curr)
;; Display the tax rate applicable to an invoice line.
;; This may be e.g. "15%" or "£5.00" or "15% + £5.00" or "n/a"
;; depending on how complicated the tax table is.
;; (When called from within the eguile template, anything
;; (display)ed becomes part of the HTML string.)
(if (or (not taxable) (eq? taxtable '()))
(display " ")
(let* ((amttot (gnc:make-commodity-collector))
(pctot (gnc:make-numeric-collector))
(entries (gncTaxTableGetEntries taxtable))
(amt? #f) ; becomes #t if any entries are amounts
(pc? #f)) ; becomes #t if any entries are percentages
(for entry in entries do
(let ((tttype (gncTaxTableEntryGetType entry))
(ttamt (gncTaxTableEntryGetAmount entry)))
(if (equal? tttype GNC-AMT-TYPE-VALUE)
(begin
(set! amt? #t)
(amttot 'add curr ttamt))
(begin
(set! pc? #t)
(pctot 'add ttamt)))))
(if pc? (begin (display (fmtnumeric (pctot 'total #f))) (display "%")))
(if (and amt? pc?) (display " + ")) ; both - this seems unlikely in practice
(if amt?
(display-comm-coll-total amttot #f))
(if (and (not amt?) (not pc?)) (display (_ "n/a")))))) ; neither
(define (coy-info slots key)
;; Extract a value from the company info key-value pairs
(kvp-frame-get-slot-path-gslist
slots
(append gnc:*kvp-option-path* (list gnc:*business-label* key))))
;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
;;; Define all the options
; option pages
(define headingpage (N_ "Headings 1"))
(define headingpage2 (N_ "Headings 2"))
;(define headingpage3 (N_ "Headings 3"))
(define companyaddpage (N_ "Company adds"))
(define legalpage (N_ "Legal data"))
(define bankconnectionpage (N_ "Bank connection"))
(define notespage (N_ "Notes"))
;(define filespage (N_ "Files"))
(define displaypage (N_ "Display"))
(define generalpage gnc:pagename-general)
; option names
(define optname-report-title (N_ "Report title"))
(define optname-invoice-number (N_ "Invoice number"))
(define optname-template-file (N_ "Template file"))
(define optname-css-file (N_ "CSS stylesheet file"))
(define optname-heading-font (N_ "Heading font"))
(define optname-text-font (N_ "Text font"))
(define optname-logofile (N_ "Logo filename"))
(define optname-logo-width (N_ "Logo width"))
(define optname-units (N_ "Units"))
(define optname-qty (N_ "Qty"))
(define optname-unit-price (N_ "Unit Price"))
(define optname-disc-rate (N_ "Discount Rate"))
(define optname-disc-amount (N_ "Discount Amount"))
(define optname-net-price (N_ "Net Price"))
(define optname-tax-rate (N_ "Tax Rate"))
(define optname-tax-amount (N_ "Tax Amount"))
(define optname-total-price (N_ "Total Price"))
(define optname-subtotal (N_ "Sub-total"))
(define optname-amount-due (N_ "Amount Due"))
(define optname-payment-recd (N_ "Payment received text"))
(define optname-extra-notes (N_ "Extra notes"))
(define optname-company-slogan (N_ "Company slogan"))
(define optname-legal-kind-title (N_ "Legal kind text"))
(define optname-legal-kind (N_ "Legal kind"))
(define optname-legal-kind-add-title (N_ "Legal kind add text"))
(define optname-legal-kind-add (N_ "Legal kind add"))
(define optname-legal-coyid-title (N_ "Coyid text"))
(define optname-bank-connection-title (N_ "Bankverbindung Text"))
(define optname-bank-name-title (N_ "Bank name text"))
(define optname-bank-nationalcode-title (N_ "National bank code text"))
(define optname-bank-swiftcode-title (N_ "Swift BIC text"))
(define optname-bank-ibancode-title (N_ "IBAN text"))
(define optname-bank-accountnumber-title (N_ "Account number text"))
(define optname-bank-name (N_ "Bank name"))
(define optname-bank-nationalcode (N_ "National bank code"))
(define optname-bank-swiftcode (N_ "Swift BIC"))
(define optname-bank-ibancode (N_ "IBAN"))
(define optname-bank-accountnumber (N_ "Account number"))
; Choose only customer invoices
; (This doesn't work very nicely -- all invoices and bills
; are offered for selection, but if a non-customer invoice
; is selected, the user is dumped back to viewing the
; previous invoice (or none) with no error message)
(define (customers-only invoice)
(let* ((owner (gncInvoiceGetOwner invoice))
(endowner (gncOwnerGetEndOwner owner))
(ownertype (gncOwnerGetType endowner)))
;(gnc:debug "ownertype is ")(gnc:debug ownertype)
(if (eqv? ownertype GNC-OWNER-CUSTOMER)
(list #t invoice)
(list #f invoice))))
(define (options-generator)
;; Options
(define report-options (gnc:new-options))
(define (add-option new-option)
(gnc:register-option report-options new-option))
(add-option
(gnc:make-invoice-option ; defined in gnucash/scm/business-options.scm
generalpage optname-invoice-number
"a" "" (lambda () '())
#f)) ;customers-only)) ;-- see above
;; Display options
(add-option (gnc:make-string-option displaypage optname-template-file "a"
(N_ "The file name of the eguile template part of this report. This file should either be in your .gnucash directory, or else in its proper place within the GnuCash installation directories.")
"taxinvoice.eguile.scm"))
(add-option (gnc:make-string-option displaypage optname-css-file "b"
(N_ "The file name of the CSS stylesheet to use with this report. This file should either be in your .gnucash directory, or else in its proper place within the GnuCash installation directories.")
"taxinvoice.css"))
(add-option (gnc:make-font-option
displaypage optname-heading-font "c"
(N_ "Font to use for the main heading") "Sans Bold 18"))
(add-option (gnc:make-font-option
displaypage optname-text-font "d"
(N_ "Font to use for everything else") "Sans 10"))
(add-option (gnc:make-pixmap-option
displaypage optname-logofile "e"
(N_ "Name of a file containing a logo to be used on the report")
""))
(add-option (gnc:make-string-option
displaypage optname-logo-width "f" (N_ "Width of the logo in CSS format, e.g. 10% or 32px. Leave blank to display the logo at its natural width. The height of the logo will be scaled accordingly.") ""))
;; Heading options
(add-option (gnc:make-string-option
; page / name / orderkey / tooltip / default
headingpage optname-report-title "a" "" (N_ "Invoice")))
(add-option (gnc:make-string-option
headingpage optname-units "b" "" (N_ "Units")))
(add-option (gnc:make-string-option
headingpage optname-qty "c" "" (N_ "Qty")))
(add-option (gnc:make-string-option
headingpage optname-unit-price "d" "" (N_ "Unit Price")))
(add-option (gnc:make-string-option
headingpage optname-disc-rate "e" "" (N_ "Discount Rate")))
(add-option (gnc:make-string-option
headingpage optname-disc-amount "f" "" (N_ "Discount Amount")))
(add-option (gnc:make-string-option
headingpage optname-net-price "g" "" (N_ "Net Price")))
(add-option (gnc:make-string-option
headingpage optname-tax-rate "h" "" (N_ "Tax Rate")))
(add-option (gnc:make-string-option
headingpage optname-tax-amount "i" "" (N_ "Tax Amount")))
(add-option (gnc:make-string-option
headingpage optname-total-price "j" "" (N_ "Total Price")))
(add-option (gnc:make-string-option
headingpage2 optname-subtotal "a" "" (N_ "Sub-total")))
(add-option (gnc:make-string-option
headingpage2 optname-amount-due "b" "" (N_ "Amount Due")))
(add-option (gnc:make-string-option
headingpage2 optname-payment-recd "c" ""
(N_ "Payment received, thank you")))
;; Company additional options
(add-option (gnc:make-string-option
companyaddpage optname-company-slogan "a" "" ""))
;; Legal options
(add-option (gnc:make-string-option
legalpage optname-legal-kind-title "a" "" ""))
(add-option (gnc:make-string-option
legalpage optname-legal-kind "b" "" ""))
(add-option (gnc:make-string-option
legalpage optname-legal-kind-add-title "c" "" ""))
(add-option (gnc:make-text-option
legalpage optname-legal-kind-add "d" "" ""))
(add-option (gnc:make-string-option
legalpage optname-legal-coyid-title "e" "" ""))
;; Bank connection options
(add-option (gnc:make-string-option
bankconnectionpage optname-bank-connection-title "a" "" ""))
(add-option (gnc:make-string-option
bankconnectionpage optname-bank-name-title "b" "" ""))
(add-option (gnc:make-string-option
bankconnectionpage optname-bank-name "c" "" ""))
(add-option (gnc:make-string-option
bankconnectionpage optname-bank-nationalcode-title "d" "" ""))
(add-option (gnc:make-string-option
bankconnectionpage optname-bank-nationalcode "e" "" ""))
(add-option (gnc:make-string-option
bankconnectionpage optname-bank-swiftcode-title "f" "" ""))
(add-option (gnc:make-string-option
bankconnectionpage optname-bank-swiftcode "g" "" ""))
(add-option (gnc:make-string-option
bankconnectionpage optname-bank-accountnumber-title "h" "" ""))
(add-option (gnc:make-string-option
bankconnectionpage optname-bank-accountnumber "i" "" ""))
(add-option (gnc:make-string-option
bankconnectionpage optname-bank-ibancode-title "j" "" ""))
(add-option (gnc:make-string-option
bankconnectionpage optname-bank-ibancode "k" "" ""))
(add-option (gnc:make-text-option
notespage optname-extra-notes "a"
(N_ "Notes added at end of invoice -- may contain HTML markup")
""))
;(N_ "(Development version -- don't rely on the numbers on this report without double-checking them.<br>Change the 'Extra Notes' option to get rid of this message)")))
(gnc:options-set-default-section
report-options generalpage)
report-options)
;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
;;; Create the report
(define (report-renderer report-obj)
;; Create and return the report as either an HTML string
;; or an <html-document>
(define (opt-value section name)
; wrapper for option routines
(define (get-opt section name)
(gnc:lookup-option (gnc:report-options report-obj) section name))
(gnc:option-value (get-opt section name)))
; Get all the options
(let* ((document (gnc:make-html-document))
(opt-invoice (opt-value generalpage optname-invoice-number))
(opt-template-file (find-file
(opt-value displaypage optname-template-file)))
(opt-css-file (find-file
(opt-value displaypage optname-css-file)))
(opt-heading-font (font-name-to-style-info
(opt-value displaypage optname-heading-font)))
(opt-text-font (font-name-to-style-info
(opt-value displaypage optname-text-font)))
(opt-logofile (opt-value displaypage optname-logofile))
(opt-logo-width (opt-value displaypage optname-logo-width))
(opt-report-title (opt-value headingpage optname-report-title))
(opt-units-heading (opt-value headingpage optname-units))
(opt-qty-heading (opt-value headingpage optname-qty))
(opt-unit-price-heading (opt-value headingpage optname-unit-price))
(opt-disc-rate-heading (opt-value headingpage optname-disc-rate))
(opt-disc-amount-heading (opt-value headingpage optname-disc-amount))
(opt-net-price-heading (opt-value headingpage optname-net-price))
(opt-tax-rate-heading (opt-value headingpage optname-tax-rate))
(opt-tax-amount-heading (opt-value headingpage optname-tax-amount))
(opt-total-price-heading (opt-value headingpage optname-total-price))
(opt-subtotal-heading (opt-value headingpage2 optname-subtotal))
(opt-amount-due-heading (opt-value headingpage2 optname-amount-due))
(opt-payment-recd-heading (opt-value headingpage2 optname-payment-recd))
(opt-company-slogan (opt-value companyaddpage optname-company-slogan))
(opt-legal-kind-title (opt-value legalpage optname-legal-kind-title))
(opt-legal-kind (opt-value legalpage optname-legal-kind))
(opt-legal-kind-add-title (opt-value legalpage optname-legal-kind-add-title))
(opt-legal-kind-add (opt-value legalpage optname-legal-kind-add))
(opt-legal-coyid-title (opt-value legalpage optname-legal-coyid-title))
(opt-bank-connection-title (opt-value bankconnectionpage optname-bank-connection-title))
(opt-bank-name-title (opt-value bankconnectionpage optname-bank-name-title))
(opt-bank-name (opt-value bankconnectionpage optname-bank-name))
(opt-bank-nationalcode-title (opt-value bankconnectionpage optname-bank-nationalcode-title))
(opt-bank-nationalcode (opt-value bankconnectionpage optname-bank-nationalcode))
(opt-bank-swiftcode-title (opt-value bankconnectionpage optname-bank-swiftcode-title))
(opt-bank-swiftcode (opt-value bankconnectionpage optname-bank-swiftcode))
(opt-bank-accountnumber-title (opt-value bankconnectionpage optname-bank-accountnumber-title))
(opt-bank-accountnumber (opt-value bankconnectionpage optname-bank-accountnumber))
(opt-bank-ibancode-title (opt-value bankconnectionpage optname-bank-ibancode-title))
(opt-bank-ibancode (opt-value bankconnectionpage optname-bank-ibancode))
(opt-extra-notes (opt-value notespage optname-extra-notes))
(css? #t) ;(and (defined? 'gnc-html-engine-supports-css) (gnc-html-engine-supports-css)))
(html #f))
(set! html (eguile-file-to-string
opt-template-file
(the-environment)))
(gnc:debug "german-taxinvoice.scm: css? is " css?)
(gnc:debug "german-taxinvoice.scm: defined is " (defined? 'gnc-html-engine-supports-css))
(gnc:debug "german-taxinvoice.scm - generated html:") (gnc:debug html)
(if css? ; return report as document or html, depending on version
html
(let ((document (gnc:make-html-document)))
(gnc:html-document-add-object! document html)
document))))
;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
;;; Define the report
(gnc:define-report
'version 1
'name (N_ "German Tax Invoice")
'report-guid "0769e242be474010b4acf264a5512e6f"
'menu-name (N_ "German Tax Invoice")
'menu-tip (N_ "Display a customer invoice with tax columns (using eguile template)")
'menu-path (list gnc:menuname-business-reports)
'options-generator options-generator
'renderer report-renderer)
