1 \NeedsTeXFormat{LaTeX2e}
2 \ProvidesPackage{kiviletter}[2020/04/24 Letter Layouts for Kivitendo]
6 \DeclareOption{reffields}{\@kivi@infoboxfalse}
7 \DeclareOption{infobox}{\@kivi@infoboxtrue}
8 \DeclareOption{nofooter}{\@kivi@footerfalse}
9 \DeclareOption{footer}{\@kivi@footertrue}
13 \DeclareOption*{\PassOptionsToPackage{\CurrentOption}{scrletter}}
18 \RequirePackage{expl3}
19 \RequirePackage{iftex}
20 \KOMAoptions{fontsize=12pt}
21 % Schriftart, Eingabelayout der Tastatur
23 \RequirePackage[utf8]{inputenc}% Nur notwendig, wenn Basis älter als TL2018
24 \RequirePackage[T1]{fontenc}
25 \RequirePackage{lmodern}
27 \RequirePackage{fontspec}
30 \RequirePackage{xltabular}
31 \RequirePackage{booktabs}
32 \RequirePackage{graphicx}
35 \RequirePackage{eurosym}
36 \DeclareUnicodeCharacter{20AC}{\euro}
39 \RequirePackage[fromlogo,fromalign=right,
40 firstfoot=false,%Für einheitliche Randeinstellungen
43 \LoadLetterOption{DIN}
45 \newkomavar{transaction}
46 \newkomavar[\lieferschein{}~\nr]{delivery}
47 \newkomavar[\angebot{}~\nr]{quote}
48 \newkomavar[\auftragsnummer]{orderID}
49 \newkomavar[\projektnummer]{projectID}
50 \setkomavar*{fromphone}{\textTelefon}
51 \setkomavar*{fromemail}{\textEmail}
52 \setkomavar*{fromfax}{\textFax}
53 \setkomavar*{customer}{\kundennummer}
59 \dim_new:N \g_kivi_margin_dim
60 \dim_gset:Nn \g_kivi_margin_dim {\useplength{toaddrhpos}}
61 \geometry{a4paper,margin=\g_kivi_margin_dim,heightrounded}
63 \int_new:N \l_kivi_tmp_int
64 \bool_new:N \l_kivi_tmp_bool
65 \bool_new:N \g_kivi_TableFoot_bool
66 \dim_new:N \g_kivi_orig@textheight_dim
69 \newsavebox{\shippingAddressBox}
74 hoffset=\useplength{toaddrhpos},
75 voffset=\dimexpr\useplength{toaddrvpos}+\useplength{toaddrheight}+4\baselineskip,%sep to shippingaddressbox
76 contents={\usebox\shippingAddressBox}
77 ]{kivitendo.shippingaddress}
79 \newpairofpagestyles{kivitendo.letter}{}
81 \renewcommand*{\letterpagestyle}{kivitendo.letter}
83 \DeclareNewPageStyleByLayers{kivitendo.letter.first}{
84 kivitendo.shippingaddress,
85 plain.kivitendo.letter.head.odd,plain.kivitendo.letter.head.even,plain.kivitendo.letter.head.oneside,%
86 plain.kivitendo.letter.foot.odd,plain.kivitendo.letter.foot.even,plain.kivitendo.letter.foot.oneside,%
89 \setkomavar{backaddress}{\firma\ $\cdot$ \strasse\ $\cdot$ \ort}
91 \setkomavar{firsthead}{
93 \rlap{\usekomavar{fromlogo}}%
97 \@setplength{locwidth}{6cm}
100 \dim_new:N \l_kivi_tab_desc_leftskip_dim
104 \cs_new:Nn \__kivi_set_colwidth:nn {
105 \dim_set:cn {l_kivi_tab_#1_dim} {#2}
109 \cs_new:Nn \__kivi_initialize_columns: {
110 \clist_map_inline:Nn \g_kivi_pricingtable_col_clist {
111 \bool_if_exist:cF {l_kivi_col_##1_bool}
113 \bool_new:c {l_kivi_col_##1_bool}
114 \dim_new:c {l_kivi_tab_##1_dim}
115 \keys_define:nn {kivi/PricingTable} {
117 ##1 / true .code:n = \bool_set_true:c {l_kivi_col_##1_bool},
118 ##1 / false .code:n = \bool_set_false:c {l_kivi_col_##1_bool},
119 ##1 / unknown .code:n = {
120 \bool_set_true:c {l_kivi_col_##1_bool}
121 \dim_set:cn {l_kivi_tab_##1_dim} {####1}
123 ##1 .default:n = true,
124 ##1 .initial:n = true,
125 ##1 / header .prop_put:c = {l_kivi_col_##1_prop},
126 ##1 / colspec .prop_put:c = {l_kivi_col_##1_prop},
132 \clist_new:N \g_kivi_pricingtable_col_clist
134 \keys_define:nn {kivi/PricingTable} {
136 \clist_gset:Nn \g_kivi_pricingtable_col_clist {#1}
137 \__kivi_initialize_columns:,
138 columns .initial:n = {pos, id, desc, amount, price, pricetotal},
141 % set default values for colwidth
142 \keys_set:nn {kivi/PricingTable} {
149 pos/header=\position,
150 id/header=\artikelnummer,
151 desc/header=\bezeichnung,
152 amount/header=\menge,
153 price/header=\einzelpreis,
154 pricetotal/header=\gesamtpreis,
155 price / colspec = Price,
156 pricetotal / colspec = Price ,
159 \dim_new:N \g_kivi_tabcolsep_dim
160 \dim_gset:Nn \g_kivi_tabcolsep_dim {.5\tabcolsep}
162 \prg_new_conditional:Nnn \kivi_if_Price_col:n {T} {
163 \prop_get:cnN {l_kivi_col_#1_prop} {colspec} \l_tmpa_tl
164 \tl_if_eq:NnTF \l_tmpa_tl {Price}
170 \cs_new:Nn \__kivi_calc_desc_column: {
171 \dim_zero:N \l_kivi_tab_desc_leftskip_dim
172 \dim_zero:N \l_kivi_tab_desc_dim
173 \bool_set_false:N \l_tmpa_bool
174 \tl_gclear:N \g_kivi_Pricing_colspec_tl
175 \clist_map_inline:Nn \g_kivi_pricingtable_col_clist {
176 \tl_if_eq:nnTF {##1} {desc} {
177 \dim_set:Nn \l_kivi_tab_desc_dim {
178 \textwidth-\l_kivi_tab_desc_leftskip_dim
180 \bool_set_true:N \l_tmpa_bool
181 \tl_gput_right:Nn \g_kivi_Pricing_colspec_tl {p{\l_kivi_tab_desc_dim}}
183 \bool_if:cT {l_kivi_col_##1_bool} {
184 \bool_if:NTF \l_tmpa_bool {
185 \dim_sub:Nn \l_kivi_tab_desc_dim {
186 \dim_use:c {l_kivi_tab_##1_dim}+2\g_kivi_tabcolsep_dim
189 \dim_add:Nn \l_kivi_tab_desc_leftskip_dim {
190 \dim_use:c {l_kivi_tab_##1_dim}+2\g_kivi_tabcolsep_dim
193 \tl_gput_right:Nn \g_kivi_Pricing_colspec_tl {>{\raggedleft\arraybackslash}p{\dim_use:c {l_kivi_tab_##1_dim}}}
194 \kivi_if_Price_col:nT {##1} {\tl_gput_right:Nn \g_kivi_Pricing_colspec_tl {<{\__kivi_tab_column_currency:}}}
198 \tl_gput_left:Nn \g_kivi_Pricing_colspec_tl {@{}}
199 \tl_gput_right:Nn \g_kivi_Pricing_colspec_tl {@{}}
202 \newcolumntype{P}[1]{>{\raggedleft\arraybackslash}p{#1}<{\__kivi_tab_column_currency:}}
204 \RequirePackage{tcolorbox}
205 \tcbuselibrary{breakable, skins}
207 \tcb@new@skin{kivi@LT}{base@unbroken,%
208 frame~engine=empty,interior~titled~engine=empty,interior~engine=empty,segmentation~engine=empty,title~engine=empty,%
209 skin~first=kivi@LT@first,skin~middle=kivi@LT@middle,skin~last=kivi@LT@last,
210 underlay~first~and~middle={
211 \node[anchor=north] at (interior.north) {\csname box_use:c\endcsname {g_kivi_LT@head_box}};
212 \node[anchor=south] at (interior.south) {\csname box_use:c\endcsname {g_kivi_LT@foot_box}};
214 underlay~unbroken~and~last={
215 \node[anchor=north] at (interior.north) {\csname box_use:c\endcsname {g_kivi_LT@head_box}};
216 \node[anchor=south] at (interior.south) {\csname box_use:c\endcsname {g_kivi_LT@lastfoot_box}};
222 bottom=\box_ht:N \g_kivi_LT@foot_box+\box_dp:N \g_kivi_LT@foot_box + \aboverulesep,
223 top=\box_ht:N \g_kivi_LT@head_box+\box_dp:N \g_kivi_LT@head_box +\belowrulesep,
227 \tcb@new@skin{kivi@LT@first}{base@first,%
228 frame~engine=empty,interior~titled~engine=empty,interior~engine=empty,segmentation~engine=empty,title~engine=empty,%
229 skin~first=kivi@LT@first,skin~middle=kivi@LT@middle,skin~last=kivi@LT@middle,
232 \tcb@new@skin{kivi@LT@middle}{base@middle,%
233 frame~engine=empty,interior~titled~engine=empty,interior~engine=empty,segmentation~engine=empty,title~engine=empty,%
234 skin~first=kivi@LT@middle,skin~middle=kivi@LT@middle,skin~last=kivi@LT@middle,
237 \tcb@new@skin{kivi@LT@last}{base@last,%
238 frame~engine=empty,interior~titled~engine=empty,interior~engine=empty,segmentation~engine=empty,title~engine=empty,%
239 skin~first=kivi@LT@middle,skin~middle=kivi@LT@middle,skin~last=kivi@LT@last,
242 \tcbset{kivi@LT/.style={skin=kivi@LT}}%
246 \seq_new:N \l_kivi_PricingTable_seq
247 \seq_new:N \l_kivi_columns_seq
248 \seq_new:N \g_kivi_extraDescription_seq
249 \newcommand{\FakeTable}[1]{
251 \seq_set_split:Nnn \l_kivi_PricingTable_seq {\tabularnewline} {#1}
252 \seq_remove_all:Nn \l_kivi_PricingTable_seq {}
254 \setlength{\parskip}{\c_zero_dim}
255 \let\ExtraDescription\__kivi_addExtraDescription:n
256 \setlength{\tabcolsep}{\g_kivi_tabcolsep_dim}
257 \seq_map_inline:Nn \l_kivi_PricingTable_seq {
258 \seq_set_split:Nnn \l_kivi_columns_seq {&} {##1}
259 \seq_gclear:N \g_kivi_extraDescription_seq
260 \exp_args:Nnx \use:n {\tabular[t]}\g_kivi_Pricing_colspec_tl
261 \seq_pop_left:NN \__l_FakeTable_columns_seq \l_tmpa_tl
262 \seq_item:Nn \l_kivi_columns_seq {\l_tmpa_tl}
263 \seq_map_inline:Nn \__l_FakeTable_columns_seq {
264 &\seq_item:Nn \l_kivi_columns_seq {####1}
267 \seq_if_empty:NTF \g_kivi_extraDescription_seq
271 \setlength{\hsize}{\dimexpr\l_kivi_tab_desc_dim+\l_kivi_tab_desc_leftskip_dim}
272 \setlength{\leftskip}{\l_kivi_tab_desc_leftskip_dim}
273 \usekomafont{extraDescription}
274 \seq_use:Nn \g_kivi_extraDescription_seq {\\}
283 \seq_new:N \__l_FakeTable_columns_seq
284 \cs_new:Nn \__kivi_setup_FakeTable: {
285 \seq_clear:N \__l_FakeTable_columns_seq
286 \int_zero:N \l_tmpa_int
287 \clist_map_inline:Nn \g_kivi_pricingtable_col_clist {
288 \int_incr:N \l_tmpa_int
289 \bool_if:cT {l_kivi_col_##1_bool} {\seq_put_right:Nx \__l_FakeTable_columns_seq {\int_use:N \l_tmpa_int}}
293 \tl_new:N \g_kivi_Pricing_colspec_tl
294 \tl_gset:Nn \g_kivi_Pricing_colspec_tl {
296 \bool_if:NT \l_kivi_col_pos_bool {p{\l_kivi_tab_pos_dim}}
297 \bool_if:NT \l_kivi_col_id_bool {p{\l_kivi_tab_id_dim}}
298 p{\l_kivi_tab_desc_dim}
299 \bool_if:NT \l_kivi_col_amount_bool {\exp_not:n {>{\raggedleft\arraybackslash}p{\l_kivi_tab_amount_dim}}}
300 \bool_if:NT \l_kivi_col_price_bool {\exp_not:n {>{\raggedleft\arraybackslash}p{\l_kivi_tab_price_dim}<{\__kivi_tab_column_currency:}}}
301 \bool_if:NT \l_kivi_col_pricetotal_bool {\exp_not:n {>{\raggedleft\arraybackslash}p{\l_kivi_tab_pricetotal_dim}<{\__kivi_tab_column_currency:}}}
305 \cs_new:Nn \__kivi_tab_column_currency: {\,\currency}
306 \def\tabcurrency{\__kivi_tab_column_currency:}
307 \cs_set:Nn \__kivi_tab_column_header_currency: {}
308 \cs_set_eq:NN \__kivi_tab_column_body_currency: \__kivi_tab_column_currency:
310 \clist_map_inline:nn {head, foot, firsthead, lastfoot} {%TODO reduce
311 \box_new:c {g_kivi_LT@#1_box}
314 \newkomafont{PricingTableHeader}{\bfseries}
316 \cs_new:Nn \__kivi_setup_LT_boxes: {
317 \__kivi_calc_desc_column:
318 \hbox_gset:Nn \g_kivi_LT@head_box {
319 \setlength{\tabcolsep}{\g_kivi_tabcolsep_dim}
320 \exp_args:Nnx \use:n {\tabular[b]}\g_kivi_Pricing_colspec_tl
321 \__kivi_PricingTabular_header:
324 \hbox_gset:Nn \g_kivi_LT@foot_box {
326 \begin{tabular*}{\textwidth}{@{\extracolsep{\fill}}r@{}}
328 \strut\weiteraufnaechsterseite
332 \hbox_gset:Nn \g_kivi_LT@lastfoot_box {
333 \raisebox{\dimexpr\depth+\baselineskip}[0pt][0pt]{
334 \begin{tabular*}{\textwidth}{@{\extracolsep{\fill}}r@{}}
342 %Macht es sinn hier eine Variante zu machen, in der alle Spalten Belegbar sind?
343 \newenvironment{PricingTotal}{
346 \tabular[t]{@{}p{\dim_eval:n {\linewidth-\l_kivi_tab_pricetotal_dim-2\tabcolsep}}P{\l_kivi_tab_pricetotal_dim}@{}}
353 \newcommand*\ExtraDescription{
354 \PackageError{kiviletter}{The~command~\string\ExtraDescription\space~may~be~only~used~inside~the~\string\FakeTable\space~environment.}{See~documentation~for~details}
358 \cs_new:Nn \__kivi_addExtraDescription:n {\seq_gput_right:Nn \g_kivi_extraDescription_seq {#1}}
360 \newenvironment{PricingTabular}[1][]{
362 \dim_set:Nn \parskip {\c_zero_dim}
363 \tl_if_empty:nF {#1} {\keys_set:nn {kivi/PricingTable} {#1}}
364 \setlength{\tabcolsep}{\g_kivi_tabcolsep_dim}
365 \__kivi_calc_desc_column:
366 \exp_args:Nx \longtable \g_kivi_Pricing_colspec_tl
368 \__kivi_PricingTabular_header:
371 \rlap{\makebox[\textwidth][r]{\weiteraufnaechsterseite}}\\
380 \cs_set:Nn \__kivi_PricingTabular_header: {
382 \cs_gset_eq:NN \__kivi_tab_column_currency: \__kivi_tab_column_header_currency:
383 \bool_set_false:N \l_tmpa_bool
384 \clist_map_inline:Nn \g_kivi_pricingtable_col_clist {
385 \bool_if:cT {l_kivi_col_##1_bool} {
386 \bool_if:NT \l_tmpa_bool {&}
387 \bool_set_true:N \l_tmpa_bool
388 \usekomafont{PricingTableHeader}
389 \prop_item:cn {l_kivi_col_##1_prop} {header}
392 \cs_gset_eq:NN \__kivi_tab_column_currency: \__kivi_tab_column_body_currency:
398 \keys_define:nn {kivi/SimpleTabular} {
399 colspec .tl_set:N =\l_kivi_SimpleTabular_colspec_tl,
400 colspec .initial:n = {rrX},
401 headline .tl_set:N = \l_kivi_SimpleTabular_headline_tl,
402 headline .initial:n = {\bfseries\position & \bfseries\menge & \bfseries\bezeichnung},
405 \newcommand*{\SetupSimpleTabular}[1]{\keys_set:nn {kivi/SimpleTabular} {#1}}
406 \newcommand*{\SetupPricingTabular}[1]{\keys_set:nn {kivi/PricingTable} {#1}}
408 \newenvironment{SimpleTabular}[1][]
410 \tl_if_in:nnTF {#1} {=} {\keys_set:nn {kivi/SimpleTabular} {#1}} {\tl_if_empty:nF {#1} {\tl_set:Nn \l_kivi_SimpleTabular_headline_tl {#1}}}
411 \setlength{\tabcolsep}{\g_kivi_tabcolsep_dim}
412 \dim_set:Nn \parskip {\c_zero_dim}
413 \tl_put_right:Nn \l_kivi_SimpleTabular_colspec_tl {@{}}
414 \tl_put_left:Nn \l_kivi_SimpleTabular_colspec_tl {@{}}
415 \exp_args:NnV \xltabular{\linewidth}\l_kivi_SimpleTabular_colspec_tl
417 \cs_gset_eq:NN \__kivi_tab_column_currency: \__kivi_tab_column_header_currency:
418 \l_kivi_SimpleTabular_headline_tl
420 \noalign{\cs_gset_eq:NN \__kivi_tab_column_currency: \__kivi_tab_column_body_currency:}
424 \rlap{\makebox[\textwidth][r]{\weiteraufnaechsterseite}}\\
430 \def\@currenvir{tabularx}
434 %PricingTabular* kann automatisch spalten ignorieren
435 % \begin{PricingTabular*}[id=false]
436 % deaktiviert damit die Spalte der Produktnummer
437 % analog ist dies für pos, amount, price, pricetotal möglich.
438 % Die Spalte der Bezeichnung ist nicht deaktivierbar
439 \newenvironment{PricingTabular*}[1][]{
440 \tl_if_empty:nF {#1} {\keys_set:nn {kivi/PricingTable} {#1}}
441 \__kivi_setup_LT_boxes:
442 \__kivi_setup_FakeTable:
443 \dim_set:Nn \parskip {\c_zero_dim}
444 \PricingTabularBox\ignorespaces
445 }{\endPricingTabularBox}
447 \newtcolorbox{PricingTabularBox}{breakable,skin=kivi@LT}
453 \NewDocumentCommand{\locationentry}{som}{
454 \Ifkomavarempty{#3}{}{
462 \hbox_set:Nn \l_tmpa_box {\usekomavar{#3}}
463 \dim_compare:nTF {\box_wd:N \l_tmpa_box>\linewidth}
464 {\newline\hspace*{\fill}\llap}
466 {\box_use:N \l_tmpa_box\strut}
473 \parbox[t]{\dimexpr\linewidth-\hangindent}{
475 \usekomavar{#3}\strut
484 \setkomavar{location}{
485 \Ifkomavarempty{transaction}{}{
487 \usekomavar{transaction}
491 \parbox{\useplength{locwidth}}{
493 \locationentry{myref}
494 \locationentry{customer}
495 \locationentry{yourref}
496 \locationentry{delivery}
497 \locationentry{quote}
498 \locationentry{orderID}
499 \locationentry{projectID}
500 \locationentry[\ansprechpartner]{fromname}
501 \locationentry{fromphone}
502 \locationentry*{fromemail}
507 \ifdim\ht\shippingAddressBox>\z@
508 \@addtoplength{refvpos}{\dimexpr\ht\shippingAddressBox+\dp\shippingAddressBox}
509 \@addtoplength{refvpos}{4\baselineskip}%sep between address boxes
515 %Fallback for older KOMA-Script-Versions
516 \cs_if_exist:NF \Ifstr {\let\Ifstr\ifstr}
517 \cs_if_exist:NF \Ifkomavarempty {\let\Ifkomavarempty\ifkomavarempty}
519 %Definitionen für die insettings.tex
521 \newcommand*{\setupIdentpath}[1]{
522 \int_set:Nn \l_kivi_tmp_int {1}
523 \bool_set_true:N \l_kivi_tmp_bool
524 \bool_while_do:Nn \l_kivi_tmp_bool {
525 \file_if_exist:nTF {firma\int_use:N \l_kivi_tmp_int/ident.tex}
527 \exp_args:Nf \str_if_in:nnTF {#1} {Firma\int_use:N \l_kivi_tmp_int}
529 \newcommand*{\identpath}{firma\int_use:N \l_kivi_tmpa_int}
530 \bool_set_false:N \l_kivi_tmp_bool
532 {\int_incr:N \l_kivi_tmp_int}
535 \bool_set_false:N \l_kivi_tmp_bool
536 \newcommand*{\identpath}{firma}
541 \newcommand*{\setupCurrencyConfig}[2]{
542 \tl_new:N \g_kivi_currency_tl
543 \exp_args:Nf \str_if_in:nnT {#2} {USD} {\tl_gset:Nn \g_kivi_currency_tl {usd}}
544 \exp_args:Nf \str_if_in:nnT {#2} {CHF} {\tl_gset:Nn \g_kivi_currency_tl {chf}}
545 \exp_args:Nf \str_if_in:nnT {#2} {EUR} {\tl_gset:Nn \g_kivi_currency_tl {euro}}
546 \tl_if_empty:NT \g_kivi_currency_tl {
547 \tl_gset:Nn \g_kivi_currency_tl {default}
548 \edef \currency {\tl_to_str:N \lxcurrency}
550 \input{#1/\g_kivi_currency_tl _account.tex}
556 \renewcommand*{\raggedsignature}{\raggedright}
558 \newkomafont{extraDescription}{}