2f45393b2f9417cb2541a1e271dc6efb204233b8
[kivitendo-erp.git] / doc / dokumentenvorlagen-und-variablen.html
1 <html>
2  <head>
3   <title>Dokumentenvorlagen und verf&uuml;gbare Variablen</title>
4   <style type="text/css">
5   <!--
6 .blue {
7            color: #000000;
8            background-color: #b0ecff;
9            border: 1px solid blue;
10            padding-left: 2px;
11            padding-right: 2px;
12            }
13
14 table {
15         color: #000000;
16         background-color: #fae8b8;
17         border: 1px solid #be5303;
18         border-collapse: collapse;
19         }
20
21 td {
22      border: 1px solid #be5303;
23      padding: 3px;
24      }
25     -->
26   </style>
27
28  </head>
29
30 <body>
31
32  <h1>Dokumentenvorlagen und verf&uuml;gbare Variablen</h1>
33
34  <p>geschrieben von <a href="mailto:m.bunkus@linet-services.de">Moritz
35    Bunkus</a>. Version: $Id$ </p>
36
37  <hr>
38
39  <h2><a name="inhaltsverzeichnis">Inhaltsverzeichnis</a></h2>
40
41  <ol>
42   <li><a href="dokumentenvorlagen-und-variablen.html#inhaltsverzeichnis">
43     Inhaltsverzeichnis</a></li>
44
45   <li><a href="dokumentenvorlagen-und-variablen.html#einfuehrung">Einf&uuml;hrung</a>
46   </li>
47
48   <li><a href="dokumentenvorlagen-und-variablen.html#zuordnung_dateinamen">
49     Zuordnung von Dateinamen zu den Funktionen</a></li>
50
51   <li><a href="#variablen_ausgeben">Variablen ausgeben</a>
52   </li>
53
54   <li><a href="dokumentenvorlagen-und-variablen.html#tag_style">
55     Anfang und Ende der Tags ver&auml;ndern</a></li>
56
57   <li><a href="dokumentenvorlagen-und-variablen.html#allgemeine_variablen">
58     Allgemeine Variablen, die in allen Vorlagen vorhanden sind</a><br>
59
60    <ol>
61     <li><a href="dokumentenvorlagen-und-variablen.html#allgemein_stammdaten">
62       Stammdaten von Kunden und Lieferanten</a></li>
63
64     <li><a href="dokumentenvorlagen-und-variablen.html#allgemein_bearbeiter">
65       Informationen &uuml;ber den Bearbeiter</a></li>
66
67     <li><a href="dokumentenvorlagen-und-variablen.html#allgemein_verkaeufer">
68       Informationen &uuml;ber den Verk&auml;ufer</a></li>
69
70     <li><a href="dokumentenvorlagen-und-variablen.html#allgemein_steuern">
71       Variablen f&uuml;r jede Steuer</a></li>
72    </ol>
73   </li>
74
75   <li><a href="dokumentenvorlagen-und-variablen.html#invoice">
76     Variablen in Rechnungen</a>
77
78    <ol>
79     <li><a href="dokumentenvorlagen-und-variablen.html#invoice_allgemein">
80       Allgemeine Variablen</a></li>
81
82     <li><a href="dokumentenvorlagen-und-variablen.html#invoice_posten">
83       Variablen f&uuml;r jeden Posten auf der Rechnung</a></li>
84
85     <li><a href="dokumentenvorlagen-und-variablen.html#invoice_zahlungen">
86       Variablen f&uuml;r die Zahlungseing&auml;nge</a></li>
87
88     <li><a href="dokumentenvorlagen-und-variablen.html#invoice_benutzerdefinierte_variablen_vc">
89       Benutzerdefinierte Kunden- und Lieferantenvariablen</a></li>
90    </ol>
91   </li>
92
93   <li><a href="dokumentenvorlagen-und-variablen.html#dunning">
94     Variablen in Mahnungen und Rechnungen &uuml;ber Mahngeb&uuml;hren</a>
95
96    <ol>
97     <li><a href="dokumentenvorlagen-und-variablen.html#dunning_vorlagennamen">
98       Namen der Vorlagen</a></li>
99
100     <li><a href="dokumentenvorlagen-und-variablen.html#dunning_allgemein">
101       Allgemeine Variablen in Mahnungen</a></li>
102
103     <li><a href="dokumentenvorlagen-und-variablen.html#dunning_details">
104       Variablen f&uuml;r jede gemahnte Rechnung in einer Mahnung</a></li>
105
106     <li><a href="dokumentenvorlagen-und-variablen.html#dunning_invoice">
107       Variablen in automatisch erzeugten Rechnungen &uuml;ber Mahngeb&uuml;hren</a></li>
108    </ol>
109   </li>
110
111   <li><a href="dokumentenvorlagen-und-variablen.html#anderevorlagen">
112     Variablen in anderen Vorlagen</a>
113
114    <ol>
115     <li><a href="dokumentenvorlagen-und-variablen.html#anderevorlagen_quotations">Angebote und Preisanfragen</a></li>
116     <li><a href="dokumentenvorlagen-und-variablen.html#anderevorlagen_orders">Auftragsbest&auml;tigungen und Lieferantenauftr&auml;ge</a></li>
117     <li><a href="dokumentenvorlagen-und-variablen.html#anderevorlagen_delivery_orders">Lieferscheine (Verkauf und Einkauf)</a></li>
118     <li><a href="dokumentenvorlagen-und-variablen.html#anderevorlagen_statement">Sammelrechnung</a></li>
119    </ol>
120   </li>
121
122   <li><a href="dokumentenvorlagen-und-variablen.html#bloecke">
123     Bl&ouml;cke, bedingte Anweisungen und Schleifen</a>
124
125    <ol>
126     <li><a href="dokumentenvorlagen-und-variablen.html#bloecke_if">
127       Der <code>if</code>-Block</a></li>
128
129     <li><a href="dokumentenvorlagen-und-variablen.html#bloecke_foreach">
130       Die <code>foreach</code>-Schleife</a></li>
131
132     <li><a href="dokumentenvorlagen-und-variablen.html#bloecke_pagebreak">
133       Der <code>pagebreak</code>-Block</a></li>
134    </ol>
135   </li>
136
137   <li><a href="dokumentenvorlagen-und-variablen.html#markup">
138     Markup-Code, der innerhalb von Formularen zur Textformatierung verwendet
139     werden kann</a></li>
140
141  </ol>
142
143  <hr>
144
145  <h2><a name="einfuehrung">Einf&uuml;hrung</a></h2>
146
147  <p>Dies ist eine Auflistung der Standard-Dokumentenvorlagen und aller
148   zur Bearbeitung verf&uuml;gbaren Variablen. Eine Variable wird in
149   einer Vorlage durch ihren Inhalt ersetzt, wenn sie in der Form
150   <code>&lt;%variablenname%&gt;</code> verwendet wird. F&uuml;r LaTeX-
151   und HTML-Vorlagen kann man die Form dieser Tags auch
152   <a href="dokumentenvorlagen-und-variablen.html#tag_style">
153    ver&auml;ndern</a>.
154  </p>
155
156  <p>Einige Zahlenwerte werden auch in unformatierter Form zur Verf&uuml;gung
157   gestellt (also z.B. 35 statt 35,00 oder 12.3 statt 12,30). Der Dezimaltrenner
158   ist dabei also immer ein Punkt unabhaengig vom eingestellten Zahlenformat.
159   Diese Variabelen kann man mit der Erweiterung _nofmt (f&uuml;r  no-format) aufrufen
160   (also z.B. netprice = 12,30 -- netprice_nofmt = 12.3). Variabeln die zus&auml;tzlich
161   unformatiert zur Verf&uuml;gung stehen sind unten als variable[_nofmt] gelistet.
162   Die Eckigen Klammern weisen also auf eine optionale Verw&auml;ndung der Erweiterung hin.
163   </p>
164
165  <p>Fr&uuml;her wurde hier nur &uuml;ber LaTeX gesprochen. Inzwischen
166   unterst&uuml;tzt Lx-Office aber auch OpenDocument-Vorlagen. Sofern
167   es nicht ausdr&uuml;cklich eingeschr&auml;nkt wird, gilt das im
168   Folgenden gesagte f&uuml;r alle Vorlagenarten.</p>
169
170  <p>Insgesamt sind technisch gesehen eine ganze Menge mehr Variablen
171   verf&uuml;gbar als hier aufgelistet werden. Die meisten davon k&ouml;nnen
172   allerdings innerhalb einer solchen Vorlage nicht sinnvoll verwendet
173   werden. Wenn eine Auflistung dieser Variablen gewollt ist, so kann diese wie
174   folgt erhalten werden:</p>
175
176  <ol>
177
178   <li><code>SL/Form.pm</code> &ouml;ffnen und am Anfang die Zeile
179    <pre>"use Data::Dumper;"</pre> einf&uuml;gen.</li>
180
181   <li>In <code>Form.pm</code> die Funktion <code>parse_template</code>
182    suchen und hier die Zeile <pre>print(STDERR Dumper($self));</pre>
183    einf&uuml;gen.</li>
184
185   <li>Einmal per Browser die gew&uuml;nschte Vorlage "benutzen", z.B. ein PDF
186    f&uuml;r eine Rechnung erzeugen.</li>
187
188   <li>Im <code>error.log</code> vom Apache steht die Ausgabe der Variablen
189    <code>$self</code> in der Form <code>'key' =&gt; 'value',</code>. Alle
190    <code>key</code>s sind verf&uuml;gbar.</li>
191
192  </ol>
193
194  <small><a href="dokumentenvorlagen-und-variablen.html#inhaltsverzeichnis">
195    zum Inhaltsverzeichnis</a></small><br>
196  <hr>
197
198  <h2><a name="variablen_ausgeben">Variablen ausgeben</a></h2>
199
200  <p>Um eine Variable auszugeben, müssen sie einfach nur zwischen die
201   Tags geschrieben werden, also
202   z.B. <code>&lt;%variablenname%&gt;</code>.</p>
203
204  <p>
205   Optional kann man auch mit Leerzeichen getrennte Flags angeben, die
206   man aber nur selten brauchen wird. Die Syntax sieht also so
207   aus: <code>&lt;%variablenname FLAG1 FLAG2%&gt;</code>. Momentan werden
208   die folgenden Flags unterstützt:
209  </p>
210
211  <ul>
212   <li>
213    <code>NOFORMAT</code> gilt nur für Zahlenwerte und gibt den Wert
214    ohne Formatierung, also ohne Tausendertrennzeichen mit mit einem
215    Punkt als Dezimaltrennzeichen aus. Nützlich z.B., wenn damit in der
216    Vorlage z.B. von LaTeX gerechnet werden soll.
217   </li>
218
219   <li>
220    <code>NOESCAPE</code> unterdrückt das Escapen von Sonderzeichen für
221    die Vorlagensprache. Wenn also in einer Variablen bereits gültiger
222    LaTeX-Code steht und dieser von LaTeX auch ausgewertet und nicht
223    wortwörtlich angezeigt werden soll, so ist dieses Flag sinnvoll.
224   </li>
225  </ul>
226
227  <p>
228   Beispiel: <code class="blue">&lt;%quototal NOFORMAT%&gt;</code>
229  </p>
230
231  <small><a href="dokumentenvorlagen-und-variablen.html#inhaltsverzeichnis">
232    zum Inhaltsverzeichnis</a></small><br>
233  <hr>
234
235  <h2><a name="tag_style">
236    Anfang und Ende der Tags ver&auml;ndern</a></h2>
237
238  <p>Der Standardstil f&uuml;r Tags sieht vor, dass ein Tag mit dem
239   Kleinerzeichen und einem Prozentzeichen beginnt und mit dem
240   Prozentzeichen und dem Gr&ouml;&szlig;erzeichen endet,
241   beispielsweise <code>&lt;%customer%&gt;</code>. Da diese Form aber
242   z.B. in LaTeX zu Problemen f&uuml;hren kann, weil das Prozentzeichen
243   dort Kommentare einleitet, kann pro HTML- oder
244   LaTeX-Dokumentenvorlage der Stil umgestellt werden.</p>
245
246  <p>Dazu werden in die Datei Zeilen geschrieben, die mit dem f&uuml;r
247   das Format g&uuml;ltigen Kommentarzeichen anfangen,
248   dann <code>config:</code> enthalten, die entsprechende Option setzen
249   und bei HTML-Dokumentenvorlagen mit dem Kommentarendzeichen
250   enden. Beispiel f&uuml;r LaTeX:</p>
251
252  <p><code>% config: tag-style=($ $)</code></p>
253
254  <p>Dies w&uuml;rde Lx-Office dazu veranlassen, Variablen zu ersetzen,
255   wenn sie wie folgt aussehen: <code>($customer$)</code>. Das
256   &auml;quivalente Beispiel f&uuml;r HTML-Dokumentenvorlagen sieht so
257   aus:</p>
258
259  <p><code>&lt;!-- config: tag-style=($ $) --&gt;</code></p>
260
261  <small><a href="dokumentenvorlagen-und-variablen.html#inhaltsverzeichnis">
262    zum Inhaltsverzeichnis</a></small><br>
263  <hr>
264
265  <h2><a name="zuordnung_dateinamen">
266    Zuordnung von den Dateinamen zu den Funktionen</a></h2>
267
268  <p>Diese folgende kurze Auflistung zeigt, welche Vorlage bei welcher
269   Funktion ausgelesen wird. Dabei ist die Dateiendung &quot;.ext&quot;
270   geeignet zu ersetzen: &quot;.tex&quot; f&uuml; LaTeX-Vorlagen und
271   &quot;.odt&quot; f&uuml;r OpenDocument-Vorlagen.</p>
272
273  <p>
274   <table border="1">
275    <tr>
276     <th>Dateiname</th>
277     <th>Bedeutung</th>
278    </tr>
279    <tr>
280     <td><code>bin_list.ext</code></td>
281     <td>Lagerliste</td>
282    </tr>
283    <tr>
284     <td><code>check.ext</code></td>
285     <td>?</td>
286    </tr>
287    <tr>
288     <td><code>invoice.ext</code></td>
289     <td>Rechnung</td>
290    </tr>
291    <tr>
292     <td><code>packing_list.ext</code></td>
293     <td>Packliste</td>
294    </tr>
295    <tr>
296     <td><code>pick_list.ext</code></td>
297     <td>Sammelliste</td>
298    </tr>
299    <tr>
300     <td><code>purchase_delivery_order.ext</code></td>
301     <td>Lieferschein (Einkauf)</td>
302    </tr>
303    <tr>
304     <td><code>purcharse_order.ext</code></td>
305     <td>Bestellung an Lieferanten</td>
306    </tr>
307    <tr>
308     <td><code>request_quotation.ext</code></td>
309     <td>Anfrage an Lieferanten</td>
310    </tr>
311    <tr>
312     <td><code>sales_delivery_order.ext</code></td>
313     <td>Lieferschein (Verkauf)</td>
314    </tr>
315    <tr>
316     <td><code>sales_order.ext</code></td>
317     <td>Bestellung</td>
318    </tr>
319    <tr>
320     <td><code>sales_quotation.ext</code></td>
321     <td>Angebot an Kunden</td>
322    </tr>
323    <tr>
324     <td><code>zahlungserinnerung.ext</code></td>
325     <td>Mahnung (Dateiname im Programm konfigurierbar)</td>
326    </tr>
327    <tr>
328     <td><code>zahlungserinnerung_invoice.ext</code></td>
329     <td>Rechnung &uuml;ber Mahngeb&uuml;hren (Dateiname im Programm konfigurierbar)</td>
330    </tr>
331   </table>
332  </p>
333
334  <a name="#dateinamen_erweitert"<h3>Sprache, Drucker und E-Mail</h3>
335
336  <p>Angeforderte Sprache und Druckerk&uuml;rzel in den Dateinamen mit eingearbeitet. So wird aus der Vorlage <code>sales_order.ext</code> bei Sprache <code>de</code> und Druckerk&uuml;rzel <code>lpr2</code> der Vorlagenname <code>sales_order_de_lpr2.ext</code>. Zus&auml;tzlich k&ouml;nnen f&uuml;r E-Mails andere Vorlagen erstellt werden, diese bekommen dann noch das K&uuml;rzel <code>_email</code>, der vollst&auml;ndige Vorlagenname w&auml;re dann <code>sales_order_email_de_lpr2.ext</code>. In allen F&auml;llen kann eine Standarddatei <code>default.ext</code> hinterlegt werden. Diese wird verwendet, wenn keine der anderen Varianten gefunden wird.</p>
337
338  <p>Die vollst&auml;ndige Suchreihenfolge f&uuml;r einen Verkaufsauftrag mit der Sprache "de" und dem Drucker "lpr2", der per E-Mail im Format PDF verschickt wird, ist:</p>
339  <p>
340   <table border='1'>
341    <tr><th>Reihenfolge der m&ouml;glichen Vorlagennamen</th></tr>
342    <tr><td><code>sales_order_email_de_lpr2.tex</code></td></tr>
343    <tr><td><code>sales_order_de_lpr2.tex</code></td></tr>
344    <tr><td><code>sales_order.tex</code></td></tr>
345    <tr><td><code>default.tex</code></td></tr>
346   </table>
347  </p>
348
349  <p>Die kurzen Varianten dieser Vorlagentitel m&uuml;ssen dann entweder Standardwerte anzeigen, oder die angeforderten Werte selbst auswerten, siehe dazu <a href="#allgemein_meta">Metadaten in Vorlagen</a></p>
350
351  <small><a href="dokumentenvorlagen-und-variablen.html#inhaltsverzeichnis">
352    zum Inhaltsverzeichnis</a></small><br>
353  <hr>
354
355  <h2><a name="allgemeine_variablen">
356    Allgemeine Variablen, die in allen Vorlagen vorhanden sind</a></h2>
357
358  <h3><a name="allgemein_meta">
359    Metainformationen zur angeforderten Vorlage:</a></h3>
360
361  <p>Diese Variablen liefern Informationen dar&uuml;ber welche Variante einer Vorlage der Benutzer angefragt hat. Sie sind n&uuml;tzlich f&uuml;r Vorlagenautoren, die aus einer zentralen Layoutvorlage die einzelnen Formulare einbinden m&ouml;chten.</p>
362
363  <p>
364   <table border="1">
365    <tr><th>Variablenname</th><th>Bedeutung</th></tr>
366    <tr>
367     <td><code>template_meta.formname</code></td>
368     <td>Basisname der Vorlage. Identisch mit der <a href="#zuordnung_dateinamen">Zurordnung zu den Dateinamen</a> ohne die Erweiterung. Ein Verkaufsauftrag enth&auml;lt hier <code>sales_order</code>.</td>
369    </tr>
370    <tr>
371     <td><code>template_meta.language.description</code></td>
372     <td>Beschreibung der verwendeten Sprache</td>
373    </tr>
374    <tr>
375     <td><code>template_meta.language.template_code</code></td>
376     <td>Vorlagen&uuml;rzel der verwendeten Sprache, identisch mit dem K&uuml;rzel das im Dateinamen verwendetet wird.</td>
377    </tr>
378    <tr>
379     <td><code>template_meta.language.output_numberformat</code></td>
380     <td>Zahlenformat der verwendeten Sprache in der Form "1.000,00". <em>Experimentell!</em>. Nur interessant f&uuml;r Vorlagen die mit unformatierten Werten arbeiten.</td>
381    </tr>
382    <tr>
383     <td><code>template_meta.language.output_dateformat</code></td>
384     <td>Datumsformat der verwendeten Sprache in der Form "dd.mm.yyyy". <em>Experimentell!</em>. Nur interessant f&uuml;r Vorlagen die mit unformatierten Werten arbeiten.</td>
385    </tr>
386    <tr>
387     <td><code>template_meta.format</code></td>
388     <td>Das angeforderte Format. Kann im Moment die Werte <code>pdf</code>, <code>postscript</code>, <code>html</code>, <code>opendocument</code>, <code>opendocument_pdf</code> und <code>excel</code> enthalten.</td>
389    </tr>
390    <tr>
391     <td><code>template_meta.extension</code></td>
392     <td>Dateierweiterung, wie im Dateinamen. Wird aus <code>format</code> entschieden.</td>
393    </tr>
394    <tr>
395     <td><code>template_meta.media</code></td>
396     <td>Ausgabemedium. Kann zur Zeit die Werte <code>screen</code> f&uuml;r Bildschirm, <code>email</code> f&uuml;r E-Mmail (triggert das <code>_email</code> K&uuml;rzel im Dateinamen), <code>printer</code> f&uuml;r Drucker, und <code>queue</code> f&uuml;r Warteschlange enthalten.</td>
397    </tr>
398    <tr>
399     <td><code>template_meta.printer.description</code></td>
400     <td>Beschreibung des ausgew&auml;hlten Druckers</td>
401    </tr>
402    <tr>
403     <td><code>template_meta.printer.template_code</code></td>
404     <td>Vorlagen&uuml;rzel des ausgew&auml;hlten Druckers, identisch mit dem K&uuml;rzel das im Dateinamen verwendetet wird.</td>
405    </tr>
406   </table>
407  </p>
408
409  <h3><a name="allgemein_stammdaten">
410    Stammdaten von Kunden und Lieferanten:</a></h3>
411
412  <p>
413   <table border="1">
414    <tr><th>Variablenname</th><th>Bedeutung</th></tr>
415    <tr>
416     <td><code>account_number</code></td>
417     <td>Kontonummer</td>
418    </tr>
419    <tr>
420     <td><code>bank</code></td>
421     <td>Name der Bank</td>
422    </tr>
423    <tr>
424     <td><code>bank_code</code></td>
425     <td>Bankleitzahl</td>
426    </tr>
427    <tr>
428     <td><code>bic</code></td>
429     <td>Bank-Identifikations-Code (Bank Identifier Code, BIC)</td>
430    </tr>
431    <tr>
432     <td><code>business</code></td>
433     <td>Kunden-/Lieferantentyp</td>
434    </tr>
435    <tr>
436     <td><code>city</code></td>
437     <td>Stadt</td>
438    </tr>
439    <tr>
440     <td><code>contact</code></td>
441     <td>Kontakt</td>
442    </tr>
443    <tr>
444     <td><code>country</code></td>
445     <td>Land</td>
446    </tr>
447    <tr>
448     <td><code>cp_email</code></td>
449     <td>Email des Ansprechpartners</td>
450    </tr>
451    <tr>
452     <td><code>cp_givenname</code></td>
453     <td>Vorname des Ansprechpartners</td>
454    </tr>
455    <tr>
456     <td><code>cp_greeting</code></td>
457     <td>Anrede des Ansprechpartners</td>
458    </tr>
459    <tr>
460     <td><code>cp_name</code></td>
461     <td>Name des Ansprechpartners</td>
462    </tr>
463    <tr>
464     <td><code>cp_phone1</code></td>
465     <td>Telefonnummer 1 des Ansprechpartners</td>
466    </tr>
467    <tr>
468     <td><code>cp_phone2</code></td>
469     <td>Telefonnummer 2 des Ansprechpartners</td>
470    </tr>
471    <tr>
472     <td><code>cp_title</code></td>
473     <td>Titel des Ansprechpartners</td>
474    </tr>
475    <tr>
476     <td><code>creditlimit</code></td>
477     <td>Kreditlimit</td>
478    </tr>
479    <tr>
480     <td><code>customeremail</code></td>
481     <td>Email des Kunden; nur f&uuml;r Kunden</td>
482    </tr>
483    <tr>
484     <td><code>customerfax</code></td>
485     <td>Faxnummer des Kunden; nur f&uuml;r Kunden</td>
486    </tr>
487    <tr>
488     <td><code>customernotes</code></td>
489     <td>Bemerkungen beim Kunden; nur f&uuml;r Kunden</td>
490    </tr>
491    <tr>
492     <td><code>customernumber</code></td>
493     <td>Kundennummer; nur f&uuml;r Kunden</td>
494    </tr>
495    <tr>
496     <td><code>customerphone</code></td>
497     <td>Telefonnummer des Kunden; nur f&uuml;r Kunden</td>
498    </tr>
499    <tr>
500     <td><code>discount</code></td>
501     <td>Rabatt</td>
502    </tr>
503    <tr>
504     <td><code>email</code></td>
505     <td>Emailadresse</td>
506    </tr>
507    <tr>
508     <td><code>fax</code></td>
509     <td>Faxnummer</td>
510    </tr>
511    <tr>
512     <td><code>homepage</code></td>
513     <td>Homepage</td>
514    </tr>
515    <tr>
516     <td><code>iban</code></td>
517     <td>Internationale Kontonummer (International Bank Account Number, IBAN)</td>
518    </tr>
519    <tr>
520     <td><code>language</code></td>
521     <td>Sprache</td>
522    </tr>
523    <tr>
524     <td><code>name</code></td>
525     <td>Firmenname</td>
526    </tr>
527    <tr>
528     <td><code>payment_description</code></td>
529     <td>Name der Zahlart</td>
530    </tr>
531    <tr>
532     <td><code>payment_terms</code></td>
533     <td>Zahlungskonditionen</td>
534    </tr>
535    <tr>
536     <td><code>phone</code></td>
537     <td>Telefonnummer</td>
538    </tr>
539    <tr>
540     <td><code>shiptocity</code></td>
541     <td>Stadt (Lieferadresse)
542      <a href="dokumentenvorlagen-und-variablen.html#anmerkung_shipto">*</a></td>
543    </tr>
544    <tr>
545     <td><code>shiptocontact</code></td>
546     <td>Kontakt (Lieferadresse)
547      <a href="dokumentenvorlagen-und-variablen.html#anmerkung_shipto">*</a></td>
548    </tr>
549    <tr>
550     <td><code>shiptocountry</code></td>
551     <td>Land (Lieferadresse)
552      <a href="dokumentenvorlagen-und-variablen.html#anmerkung_shipto">*</a></td>
553    </tr>
554    <tr>
555     <td><code>shiptodepartment1</code></td>
556     <td>Abteilung 1 (Lieferadresse)
557      <a href="dokumentenvorlagen-und-variablen.html#anmerkung_shipto">*</a></td>
558    </tr>
559    <tr>
560     <td><code>shiptodepartment2</code></td>
561     <td>Abteilung 2 (Lieferadresse)
562      <a href="dokumentenvorlagen-und-variablen.html#anmerkung_shipto">*</a></td>
563    </tr>
564    <tr>
565     <td><code>shiptoemail</code></td>
566     <td>Email (Lieferadresse)
567      <a href="dokumentenvorlagen-und-variablen.html#anmerkung_shipto">*</a></td>
568    </tr>
569    <tr>
570     <td><code>shiptofax</code></td>
571     <td>Fax (Lieferadresse)
572      <a href="dokumentenvorlagen-und-variablen.html#anmerkung_shipto">*</a></td>
573    </tr>
574    <tr>
575     <td><code>shiptoname</code></td>
576     <td>Firmenname (Lieferadresse)
577      <a href="dokumentenvorlagen-und-variablen.html#anmerkung_shipto">*</a></td>
578    </tr>
579    <tr>
580     <td><code>shiptophone</code></td>
581     <td>Telefonnummer (Lieferadresse)
582      <a href="dokumentenvorlagen-und-variablen.html#anmerkung_shipto">*</a></td>
583    </tr>
584    <tr>
585     <td><code>shiptostreet</code></td>
586     <td>Stra&szlig;e und Hausnummer (Lieferadresse)
587      <a href="dokumentenvorlagen-und-variablen.html#anmerkung_shipto">*</a></td>
588    </tr>
589    <tr>
590     <td><code>shiptozipcode</code></td>
591     <td>Postleitzahl (Lieferadresse)
592      <a href="dokumentenvorlagen-und-variablen.html#anmerkung_shipto">*</a></td>
593    </tr>
594    <tr>
595     <td><code>street</code></td>
596     <td>Stra&szlig;e und Hausnummer</td>
597    </tr>
598    <tr>
599     <td><code>taxnumber</code></td>
600     <td>Steuernummer</td>
601    </tr>
602    <tr>
603     <td><code>ustid</code></td>
604     <td>Usatzsteuer-Identifikationsnummer</td>
605    </tr>
606    <tr>
607    <tr>
608     <td><code>vendoremail</code></td>
609     <td>Email des Lieferanten; nur f&uuml;r Lieferanten</td>
610    </tr>
611    <tr>
612     <td><code>vendorfax</code></td>
613     <td>Faxnummer des Lieferanten; nur f&uuml;r Lieferanten</td>
614    </tr>
615    <tr>
616     <td><code>vendornotes</code></td>
617     <td>Bemerkungen beim Lieferanten; nur f&uuml;r Lieferanten</td>
618    </tr>
619    <tr>
620     <td><code>vendornumber</code></td>
621     <td>Lieferantennummer; nur f&uuml;r Lieferanten</td>
622    </tr>
623    <tr>
624     <td><code>vendorphone</code></td>
625     <td>Telefonnummer des Lieferanten; nur f&uuml;r Lieferanten</td>
626    </tr>
627    <tr>
628     <td><code>zipcode</code></td>
629     <td>Postleitzahl</td>
630    </tr>
631   </table>
632  </p>
633
634  <p><a name="anmerkung_shipto"><em>Anmerkung</em></a>: Sind die
635   <code>shipto*</code>-Felder in den Stammdaten nicht eingetragen, so haben
636   die Variablen <code>shipto*</code> den gleichen Wert wie die die
637   entsprechenden Variablen der Lieferdaten. Das bedeutet, dass sich einige
638   <code>shipto*</code>-Variablen so nicht in den Stammdaten wiederfinden
639   sondern schlicht Kopien der Lieferdatenvariablen sind
640   (z.B. <code>shiptocontact</code>).</p>
641
642  <h3><a name="allgemein_bearbeiter">
643    Informationen &uuml;ber den Bearbeiter:</a></h3>
644
645  <p>
646   <table border="1">
647    <tr><th>Variablenname</th><th>Bedeutung</th></tr>
648    <tr>
649     <td><code>employee_address</code></td>
650     <td>Adressfeld</td>
651    </tr>
652    <tr>
653     <td><code>employee_businessnumber</code></td>
654     <td>Firmennummer</td>
655    </tr>
656    <tr>
657     <td><code>employee_company</code></td>
658     <td>Firmenname</td>
659    </tr>
660    <tr>
661     <td><code>employee_co_ustid</code></td>
662     <td>Usatzsteuer-Identifikationsnummer</td>
663    </tr>
664    <tr>
665     <td><code>employee_duns</code></td>
666     <td>DUNS-Nummer</td>
667    </tr>
668    <tr>
669     <td><code>employee_email</code></td>
670     <td>Email</td>
671    </tr>
672    <tr>
673     <td><code>employee_fax</code></td>
674     <td>Fax</td>
675    </tr>
676    <tr>
677     <td><code>employee_name</code></td>
678     <td>voller Name</td>
679    </tr>
680    <tr>
681     <td><code>employee_signature</code></td>
682     <td>Signatur</td>
683    </tr>
684    <tr>
685     <td><code>employee_taxnumber</code></td>
686     <td>Steuernummer</td>
687    </tr>
688    <tr>
689     <td><code>employee_tel</code></td>
690     <td>Telefonnummer</td>
691    </tr>
692   </table>
693  </p>
694
695  <h3><a name="allgemein_verkaeufer">
696    Informationen &uuml;ber den Verk&auml;ufer (nur bei Verkaufsmasken):</a></h3>
697
698  <p>
699   <table border="1">
700    <tr><th>Variablenname</th><th>Bedeutung</th></tr>
701    <tr>
702     <td><code>salesman_address</code></td>
703     <td>Adressfeld</td>
704    </tr>
705    <tr>
706     <td><code>salesman_businessnumber</code></td>
707     <td>Firmennummer</td>
708    </tr>
709    <tr>
710     <td><code>salesman_company</code></td>
711     <td>Firmenname</td>
712    </tr>
713    <tr>
714     <td><code>salesman_co_ustid</code></td>
715     <td>Usatzsteuer-Identifikationsnummer</td>
716    </tr>
717    <tr>
718     <td><code>salesman_duns</code></td>
719     <td>DUNS-Nummer</td>
720    </tr>
721    <tr>
722     <td><code>salesman_email</code></td>
723     <td>Email</td>
724    </tr>
725    <tr>
726     <td><code>salesman_fax</code></td>
727     <td>Fax</td>
728    </tr>
729    <tr>
730     <td><code>salesman_name</code></td>
731     <td>voller Name</td>
732    </tr>
733    <tr>
734     <td><code>salesman_signature</code></td>
735     <td>Signatur</td>
736    </tr>
737    <tr>
738     <td><code>salesman_taxnumber</code></td>
739     <td>Steuernummer</td>
740    </tr>
741    <tr>
742     <td><code>salesman_tel</code></td>
743     <td>Telefonnummer</td>
744    </tr>
745   </table>
746  </p>
747
748  <h3><a name="allgemein_steuern">
749    Variablen f&uuml;r die einzelnen Steuern:</a></h3>
750
751  <p>
752   <table border="1">
753    <tr><th>Variablenname</th><th>Bedeutung</th></tr>
754    <tr>
755     <td><code>tax</code></td>
756     <td>Steuer</td>
757    </tr>
758    <tr>
759     <td><code>taxbase</code></td>
760     <td>zu versteuernder Betrag</td>
761    </tr>
762    <tr>
763     <td><code>taxdescription</code></td>
764     <td>Name der Steuer</td>
765    </tr>
766    <tr>
767     <td><code>taxrate</code></td>
768     <td>Steuersatz</td>
769    </tr>
770   </table>
771  </p>
772
773  <small><a href="dokumentenvorlagen-und-variablen.html#inhaltsverzeichnis">
774    zum Inhaltsverzeichnis</a></small><br>
775  <hr>
776
777  <h2><a name="invoice">Variablen in Rechnungen</a></h2>
778
779  <h3><a name="invoice_allgemein">Allgemeine Variablen:</a></h3>
780
781  <p>
782   <table border="1">
783    <tr><th>Variablenname</th><th>Bedeutung</th></tr>
784    <tr>
785     <td><code>creditremaining</code></td>
786     <td>Verbleibender Kredit</td>
787    </tr>
788    <tr>
789     <td><code>currency</code></td>
790     <td>W&auml;hrung</td>
791    </tr>
792    <tr>
793     <td><code>cusordnumber</code></td>
794     <td>Bestellnummer beim Kunden</td>
795    </tr>
796    <tr>
797     <td><code>deliverydate</code></td>
798     <td>Lieferdatum</td>
799    </tr>
800    <tr>
801     <td><code>duedate</code></td>
802     <td>F&auml;lligkeitsdatum</td>
803    </tr>
804    <tr>
805     <td><code>globalprojectnumber</code></td>
806     <td>Projektnummer des ganzen Beleges</td>
807    </tr>
808    <tr>
809     <td><code>globalprojectdescription</code></td>
810     <td>Projekbeschreibung des ganzen Beleges</td>
811    </tr>
812    <tr>
813     <td><code>intnotes</code></td>
814     <td>Interne Bemerkungen</td>
815    </tr>
816    <tr>
817     <td><code>invdate</code></td>
818     <td>Rechnungsdatum</td>
819    </tr>
820    <tr>
821     <td><code>invnumber</code></td>
822     <td>Rechnungsnummer</td>
823    </tr>
824    <tr>
825     <td><code>invtotal</code></td>
826     <td>gesamter Rechnungsbetrag</td>
827    </tr>
828    <tr>
829     <td><code>notes</code></td>
830     <td>Bemerkungen der Rechnung</td>
831    </tr>
832    <tr>
833     <td><code>orddate</code></td>
834     <td>Auftragsdatum</td>
835    </tr>
836    <tr>
837     <td><code>ordnumber</code></td>
838     <td>Auftragsnummer, wenn die Rechnung aus einem Auftrag erstellt wurde</td>
839    </tr>
840    <tr>
841     <td><code>payment_description</code></td>
842     <td>Name der Zahlart</td>
843    </tr>
844    <tr>
845     <td><code>payment_terms</code></td>
846     <td>Zahlungskonditionen</td>
847    </tr>
848    <tr>
849     <td><code>quodate</code></td>
850     <td>Angebotsdatum</td>
851    </tr>
852    <tr>
853     <td><code>quonumber</code></td>
854     <td>Angebotsnummer</td>
855    </tr>
856    <tr>
857     <td><code>shippingpoint</code></td>
858     <td>Versandort</td>
859    </tr>
860    <tr>
861     <td><code>shipvia</code></td>
862     <td>Transportmittel</td>
863    </tr>
864    <tr>
865     <td><code>subtotal[_nofmt]</code></td>
866     <td>Zwischensumme aller Posten ohne Steuern</td>
867    </tr>
868    <tr>
869     <td><code>sumcarriedforward</code></td>
870     <td>Zwischensumme aller bisher ausgegebenen Posten. Sollte nur in einem
871      <a href="dokumentenvorlagen-und-variablen.html#bloecke_pagebreak">
872       <code>pagebreak</code></a>-Block verwendet werden.</td>
873    </tr>
874    <tr>
875     <td><code>total</code></td>
876     <td>Restsumme der Rechnung (Summe abz&uuml;glich bereits bezahlter Posten)</td>
877    </tr>
878    <tr>
879     <td><code>transaction_description</code></td>
880     <td>Vorgangsbezeichnung</td>
881    </tr>
882    <tr>
883     <td><code>transdate</code></td>
884     <td>Auftragsdatum wenn die Rechnung aus einem Auftrag erstellt wurde</td>
885    </tr>
886   </table>
887  </p>
888
889  <h3><a name="invoice_posten">
890    Variablen f&uuml;r jeden Posten auf der Rechnung:</a></h3>
891
892  <p>
893   <table border="1">
894    <tr><th>Variablenname</th><th>Bedeutung</th></tr>
895    <tr>
896     <td><code>bin</code></td>
897     <td>Stellage</td>
898    </tr>
899    <tr>
900     <td><code>description</code></td>
901     <td>Artikelbeschreibung</td>
902    </tr>
903    <tr>
904     <td><code>discount[_nofmt]</code></td>
905     <td>Rabatt als Betrag</td>
906    </tr>
907    <tr>
908     <td><code>discount_sub[_nofmt]</code></td>
909     <td>Zwischensumme mit Rabatt</td>
910    </tr>
911    <tr>
912     <td><code>drawing</code></td>
913     <td>Zeichnung</td>
914    </tr>
915    <tr>
916     <td><code>ean</code></td>
917     <td>EAN-Code</td>
918    </tr>
919    <tr>
920     <td><code>image</code></td>
921     <td>Grafik</td>
922    </tr>
923    <tr>
924     <td><code>linetotal[_nofmt]</code></td>
925     <td>Zeilensumme (Anzahl * Einzelpreis)</td>
926    </tr>
927    <tr>
928     <td><code>longdescription</code></td>
929     <td>Langtext</td>
930    </tr>
931    <tr>
932     <td><code>microfiche</code></td>
933     <td>Mikrofilm</td>
934    </tr>
935    <tr>
936     <td><code>netprice[_nofmt]</code></td>
937     <td>Nettopreis</td>
938    </tr>
939    <tr>
940     <td><code>nodiscount_linetotal[_nofmt]</code></td>
941     <td>Zeilensumme ohne Rabatt</td>
942    </tr>
943    <tr>
944     <td><code>nodiscount_sub[_nofmt]</code></td>
945     <td>Zwischensumme ohne Rabatt</td>
946    </tr>
947    <tr>
948     <td><code>number</code></td>
949     <td>Artikelnummer</td>
950    </tr>
951    <tr>
952     <td><code>ordnumber_oe</code></td>
953     <td>Auftragsnummer des Originalauftrags, wenn die Rechnung aus einem Sammelauftrag erstellt wurde</td>
954    </tr>
955    <tr>
956    <td><code>p_discount</code></td>
957     <td>Rabatt in Prozent</td>
958    </tr>
959    <tr>
960     <td><code>partnotes</code></td>
961     <td>Die beim Artikel gespeicherten Bemerkungen</td>
962    </tr>
963    <tr>
964     <td><code>partsgroup</code></td>
965     <td>Warengruppe</td>
966    </tr>
967    <tr>
968     <td><code>price_factor</code></td>
969     <td>Der Preisfaktor als Zahl, sofern einer eingestellt ist</td>
970    </tr>
971    <tr>
972     <td><code>price_factor_name</code></td>
973     <td>Der Name des Preisfaktors, sofern einer eingestellt ist</td>
974    </tr>
975    <tr>
976     <td><code>projectnumber</code></td>
977     <td>Projektnummer</td>
978    </tr>
979    <tr>
980     <td><code>projectdescription</code></td>
981     <td>Projektbeschreibung</td>
982    </tr>
983    <tr>
984     <td><code>qty[_nofmt]</code></td>
985     <td>Anzahl</td>
986    </tr>
987    <tr>
988     <td><code>reqdate</code></td>
989     <td>Lieferdatum</td>
990    </tr>
991    <tr>
992     <td><code>runningnumber</code></td>
993     <td>Position auf der Rechnung (1, 2, 3...)</td>
994    </tr>
995    <tr>
996     <td><code>sellprice[_nofmt]</code></td>
997     <td>Verkaufspreis</td>
998    </tr>
999    <tr>
1000     <td><code>serialnumber</code></td>
1001     <td>Seriennummer</td>
1002    </tr>
1003    <tr>
1004     <td><code>tax_rate</code></td>
1005     <td>Steuersatz</td>
1006    </tr>
1007    <tr>
1008     <td><code>transdate_oe</code></td>
1009     <td>Auftragsdatum des Originalauftrags, wenn die Rechnung aus einem Sammelauftrag erstellt wurde</td>
1010    </tr>
1011    <tr>
1012     <td><code>unit</code></td>
1013     <td>Einheit</td>
1014    </tr>
1015    <tr>
1016     <td><code>weight</code></td>
1017     <td>Gewicht</td>
1018    </tr>
1019   </table>
1020  </p>
1021
1022  <p>F&uuml;r jeden Posten gibt es ein Unterarray mit den Informationen &uuml;ber
1023   Lieferanten und Lieferantenartikelnummer. Diese m&uuml;ssen mit
1024   einer <code>foreach</code>-Schleife ausgegeben werden, da f&uuml;r jeden
1025   Artikel mehrere Lieferanteninformationen hinterlegt sein k&ouml;nnen. Die
1026   Variablen daf&uuml;r lauten:</p>
1027
1028  <p>
1029   <table border="1">
1030    <tr><th>Variablenname</th><th>Bedeutung</th></tr>
1031    <tr>
1032     <td><code>make</code></td>
1033     <td>Lieferant</td>
1034    </tr>
1035    <tr>
1036     <td><code>model</code></td>
1037     <td>Lieferantenartikelnummer</td>
1038    </tr>
1039   </table>
1040  </p>
1041
1042  <h3><a name="invoice_zahlungen">
1043    Variablen f&uuml;r die einzelnen Zahlungseing&auml;nge:</a></h3>
1044
1045  <p>
1046   <table border="1">
1047    <tr><th>Variablenname</th><th>Bedeutung</th></tr>
1048    <tr>
1049     <td><code>payment</code></td>
1050     <td>Betrag</td>
1051    </tr>
1052    <tr>
1053     <td><code>paymentaccount</code></td>
1054     <td>Konto</td>
1055    </tr>
1056    <tr>
1057     <td><code>paymentdate</code></td>
1058     <td>Datum</td>
1059    </tr>
1060    <tr>
1061     <td><code>paymentmemo</code></td>
1062     <td>Memo</td>
1063    </tr>
1064    <tr>
1065     <td><code>paymentsource</code></td>
1066     <td>Beleg</td>
1067    </tr>
1068   </table>
1069  </p>
1070
1071  <h3><a name="invoice_benutzerdefinierte_variablen_vc">
1072    Benutzerdefinierte Kunden- und Lieferantenvariablen:</a></h3>
1073
1074  <p>
1075   Die vom Benutzer definierten Variablen f&uuml;r Kunden und
1076   Lieferanten stehen beim Ausdruck von Einkaufs- und Verkaufsbelegen
1077   ebenfalls zur Verf&uuml;gung. Ihre Namen setzen sich aus dem
1078   Pr&auml;fix <code>vc_cvar_</code> und dem vom Benutzer festgelegten
1079   Variablennamen zusammen.</p>
1080
1081  <p>Beispiel: Der Benutzer hat eine Variable
1082   namens <code>number_of_employees</code> definiert, die die Anzahl
1083   der Mitarbeiter des Unternehmens enth&auml;lt. Diese Variable steht
1084   dann unter dem Namen <code>vc_cvar_number_of_employees</code> zur
1085   Verf&uuml;gung.</p>
1086
1087  <small><a href="dokumentenvorlagen-und-variablen.html#inhaltsverzeichnis">
1088    zum Inhaltsverzeichnis</a></small><br>
1089  <hr>
1090
1091  <h2><a name="dunning">Variablen in Mahnungen und Rechnungen &uuml;ber Mahngeb&uuml;hren</a></h2>
1092
1093  <h3><a name="dunning_vorlagennamen">Namen der Vorlagen</a></h3>
1094
1095  <p>Die Namen der Vorlagen werden im System-Men&uuml; vom Benutzer
1096   eingegeben. Wird f&uuml;r ein Mahnlevel die Option zur automatischen
1097   Erstellung einer Rechnung &uuml;ber die Mahngeb&uuml;hren und Zinsen
1098   aktiviert, so wird der Name der Vorlage f&uuml;r diese Rechnung aus
1099   dem Vorlagenname f&uuml;r diese Mahnstufe mit dem
1100   Zusatz <code>_invoice</code> gebildet. Weiterhin werden die
1101   K&uuml;rzel f&uuml;r die ausgew&auml;hlte Sprache und den
1102   ausgew&auml;hlten Drucker angeh&auml;ngt.</p>
1103
1104  <h3><a name="dunning_allgemein">Allgemeine Variablen in Mahnungen:</a></h3>
1105
1106  <p>Die Variablen des Verk&auml;ufers stehen wie gewohnt
1107   als <code>employee_...</code> zur Verf&uuml;gung. Die Adressdaten des
1108   Kunden stehen als Variablen <code>name</code>, <code>street</code>,
1109   <code>zipcode</code>, <code>city</code>, <code>country</code>,
1110   <code>department_1</code>, <code>department_2</code>, und
1111   <code>email</code> zur Verf&uuml;gung.
1112  </p>
1113
1114  <p>Weitere Variablen beinhalten:</p>
1115
1116  <p>
1117   <table border="1">
1118    <tr><th>Variablenname</th><th>Bedeutung</th></tr>
1119    <tr>
1120     <td><code>dunning_date</code></td>
1121     <td>Datum der Mahnung</td>
1122    </tr>
1123    <tr>
1124     <td><code>dunning_duedate</code></td>
1125     <td>F&auml;lligkeitsdatum f&uuml;r diese Mahhnung</td>
1126    </tr>
1127    <tr>
1128     <td><code>dunning_id</code></td>
1129     <td>Mahnungsnummer</td>
1130    </tr>
1131    <tr>
1132     <td><code>fee</code></td>
1133     <td>Kummulative Mahngeb&uuml;hren</td>
1134    </tr>
1135    <tr>
1136     <td><code>interest_rate</code></td>
1137     <td>Zinssatz per anno in Prozent</td>
1138    </tr>
1139    <tr>
1140     <td><code>total_amount</code></td>
1141     <td>Gesamter noch zu zahlender Betrag als <code>fee</code> + <code>total_interest</code> + <code>total_open_amount</code></td>
1142    </tr>
1143    <tr>
1144     <td><code>total_interest</code></td>
1145     <td>Zinsen per anno &uuml;ber alle Rechnungen</td>
1146    </tr>
1147    <tr>
1148     <td><code>total_open_amount</code></td>
1149     <td>Summe &uuml;ber alle offene Betr&auml;ge der Rechnungen</td>
1150    </tr>
1151   </table>
1152  </p>
1153
1154  <h3><a name="dunning_details">
1155    Variablen f&uuml;r jede gemahnte Rechnung in einer Mahnung:</a></h3>
1156
1157  <p>
1158   <table border="1">
1159    <tr><th>Variablenname</th><th>Bedeutung</th></tr>
1160    <tr>
1161     <td><code>dn_amount</code></td>
1162     <td>Rechnungssumme (brutto)</td>
1163    </tr>
1164    <tr>
1165     <td><code>dn_duedate</code></td>
1166     <td>Originales F&auml;lligkeitsdatum der Rechnung</td>
1167    </tr>
1168    <tr>
1169     <td><code>dn_dunning_date</code></td>
1170     <td>Datum der Mahnung</td>
1171    </tr>
1172    <tr>
1173     <td><code>dn_dunning_duedate</code></td>
1174     <td>F&auml;lligkeitsdatum der Mahnung</td>
1175    </tr>
1176    <tr>
1177     <td><code>dn_fee</code></td>
1178     <td>Kummulative Mahngeb&uuml;hr</td>
1179    </tr>
1180    <tr>
1181     <td><code>dn_interest</code></td>
1182     <td>Zinsen per anno f&uuml;r diese Rechnung</td>
1183    </tr>
1184    <tr>
1185     <td><code>dn_invnumber</code></td>
1186     <td>Rechnungsnummer</td>
1187    </tr>
1188    <tr>
1189     <td><code>dn_linetotal</code></td>
1190     <td>Noch zu zahlender Betrag (ergibt sich aus <code>dn_open_amount + dn_fee + dn_interest</code>)</td>
1191    </tr>
1192    <tr>
1193     <td><code>dn_netamount</code></td>
1194     <td>Rechnungssumme (netto)</td>
1195    </tr>
1196    <tr>
1197     <td><code>dn_open_amount</code></td>
1198     <td>Offener Rechnungsbetrag</td>
1199    </tr>
1200    <tr>
1201     <td><code>dn_ordnumber</code></td>
1202     <td>Bestellnummer</td>
1203    </tr>
1204    <tr>
1205     <td><code>dn_transdate</code></td>
1206     <td>Rechnungsdatum</td>
1207    </tr>
1208   </table>
1209  </p>
1210
1211  <h3><a name="dunning_invoice">Variablen in automatisch erzeugten
1212    Rechnungen &uuml;ber Mahngeb&uuml;hren</a></h3>
1213
1214  <p>Die Variablen des Verk&auml;ufers stehen wie gewohnt
1215   als <code>employee_...</code> zur Verf&uuml;gung. Die Adressdaten des
1216   Kunden stehen als Variablen <code>name</code>, <code>street</code>,
1217   <code>zipcode</code>, <code>city</code>, <code>country</code>,
1218   <code>department_1</code>, <code>department_2</code>, und
1219   <code>email</code> zur Verf&uuml;gung.
1220  </p>
1221
1222  <p>Weitere Variablen beinhalten:</p>
1223
1224  <p>
1225   <table border="1">
1226    <tr><th>Variablenname</th><th>Bedeutung</th></tr>
1227    <tr>
1228     <td><code>duedate</code></td>
1229     <td>F&auml;lligkeitsdatum der Rechnung</td>
1230    </tr>
1231    <tr>
1232     <td><code>dunning_id</code></td>
1233     <td>Mahnungsnummer</td>
1234    </tr>
1235    <tr>
1236     <td><code>fee</code></td>
1237     <td>Mahngeb&uuml;hren</td>
1238    </tr>
1239    <tr>
1240     <td><code>interest</code></td>
1241     <td>Zinsen</td>
1242    </tr>
1243    <tr>
1244     <td><code>invamount</code></td>
1245     <td>Rechnungssumme (ergibt sich aus <code>fee + interest</code>)</td>
1246    </tr>
1247    <tr>
1248     <td><code>invdate</code></td>
1249     <td>Rechnungsdatum</td>
1250    </tr>
1251    <tr>
1252     <td><code>invnumber</code></td>
1253     <td>Rechnungsnummer</td>
1254    </tr>
1255   </table>
1256  </p>
1257
1258  <small><a href="dokumentenvorlagen-und-variablen.html#inhaltsverzeichnis">
1259    zum Inhaltsverzeichnis</a></small><br>
1260  <hr>
1261
1262  <h2><a name="anderevorlagen">
1263    Variablen in anderen Vorlagen</a></h2>
1264
1265  <p>Die Variablen in anderen Vorlagen sind &auml;hnlich wie in der
1266   Rechnung. Allerdings hei&szlig;en die Variablen, die mit <code>inv</code>
1267   beginnen, jetzt anders. Bei den Angeboten fangen sie mit <code>quo</code>
1268   f&uuml;r "quotation" an: <code>quodate</code> f&uuml;r Angebotsdatum
1269   etc. Bei Bestellungen wiederum fangen sie mit <code>ord</code> f&uuml;r
1270   "order" an: <code>ordnumber</code> f&uuml;r Bestellnummer etc.</p>
1271
1272  <p>Manche Variablen sind in anderen Vorlagen hingegen gar nicht vorhanden wie
1273   z.B. die f&uuml;r bereits verbuchte Zahlungseing&auml;nge. Dies sind
1274   Variablen, die vom Gesch&auml;ftsablauf her in der entsprechenden Vorlage
1275   keine Bedeutung haben oder noch nicht belegt sein k&ouml;nnen.</p>
1276
1277  <p>Im Folgenden werden nur wichtige Unterschiede zu den Variablen in
1278   Rechnungen aufgef&uuml;hrt.</p>
1279
1280  <h3><a name="anderevorlagen_quotations">Angebote und Preisanfragen</a></h3>
1281
1282  <p>
1283   <table border="1">
1284    <tr><th>Variablenname</th><th>Bedeutung</th></tr>
1285    <tr>
1286     <td><code>quonumber</code></td>
1287     <td>Angebots- bzw. Anfragenummer</td>
1288    </tr>
1289    <tr>
1290     <td><code>reqdate</code></td>
1291     <td>G&uuml;ltigkeitsdatum (bei Angeboten) bzw. Lieferdatum (bei Preisanfragen)</td>
1292    </tr>
1293    <tr>
1294     <td><code>transdate</code></td>
1295     <td>Angebots- bzw. Anfragedatum</td>
1296    </tr>
1297   </table>
1298  </p>
1299
1300  <h3><a name="anderevorlagen_orders">Auftragsbest&auml;tigungen und Lieferantenauftr&auml;ge</a></h3>
1301
1302  <p>
1303   <table border="1">
1304    <tr><th>Variablenname</th><th>Bedeutung</th></tr>
1305    <tr>
1306     <td><code>ordnumber</code></td>
1307     <td>Auftragsnummer</td>
1308    </tr>
1309    <tr>
1310     <td><code>reqdate</code></td>
1311     <td>Lieferdatum</td>
1312    </tr>
1313    <tr>
1314     <td><code>transdate</code></td>
1315     <td>Auftragsdatum</td>
1316    </tr>
1317   </table>
1318  </p>
1319
1320  <h3><a name="anderevorlagen_delivery_orders">Lieferscheine (Verkauf und Einkauf)</a></h3>
1321
1322  <p>
1323   <table border="1">
1324    <tr><th>Variablenname</th><th>Bedeutung</th></tr>
1325    <tr>
1326     <td><code>cusordnumber</code></td>
1327     <td>Bestellnummer des Kunden (im Verkauf) bzw. Bestellnummer des Lieferanten (im Einkauf)</td>
1328    </tr>
1329    <tr>
1330     <td><code>donumber</code></td>
1331     <td>Lieferscheinnummer</td>
1332    </tr>
1333    <tr>
1334     <td><code>transdate</code></td>
1335     <td>Lieferscheindatum</td>
1336    </tr>
1337   </table>
1338  </p>
1339
1340  <p>F&uuml;r jede Position eines Lieferscheines gibt es ein Unterarray mit
1341   den Informationen dar&uuml;ber, von welchem Lager und Lagerplatz aus die
1342   Waren verschickt wurden (Verkaufslieferscheine) bzw. auf welchen
1343   Lagerplatz sie eingelagert wurden. Diese m&uuml;ssen mittels
1344   einer <code>foreach</code>-Schleife ausgegeben werden. Diese
1345   Variablen sind:</p>
1346
1347
1348  <p>F&uuml;r jede Position eines Lieferscheines gibt es ein Unterarray mit
1349   den Informationen dar&uuml;ber, von welchem Lager und Lagerplatz aus die
1350   Waren verschickt wurden (Verkaufslieferscheine) bzw. auf welchen
1351   Lagerplatz sie eingelagert wurden. Diese m&uuml;ssen mittels
1352   einer <code>foreach</code>-Schleife ausgegeben werden. Diese
1353   Variablen sind:</p>
1354
1355  <p>
1356   <table border="1">
1357    <tr><th>Variablenname</th><th>Bedeutung</th></tr>
1358    <tr>
1359     <td><code>si_bin</code></td>
1360     <td>Lagerplatz</td>
1361    </tr>
1362    <tr>
1363     <td><code>si_chargenumber</code></td>
1364     <td>Chargennummer</td>
1365    </tr>
1366    <tr>
1367     <td><code>si_bestbefore</code></td>
1368     <td>Mindesthaltbarkeit</td>
1369    </tr>
1370    <tr>
1371     <td><code>si_number</code></td>
1372     <td>Artikelnummer</td>
1373    </tr>
1374    <tr>
1375     <td><code>si_qty</code></td>
1376     <td>Anzahl bzw. Menge</td>
1377    </tr>
1378    <tr>
1379     <td><code>si_runningnumber</code></td>
1380     <td>Positionsnummer (1, 2, 3 etc)</td>
1381    </tr>
1382    <tr>
1383     <td><code>si_unit</code></td>
1384     <td>Einheit</td>
1385    </tr>
1386    <tr>
1387     <td><code>si_warehouse</code></td>
1388     <td>Lager</td>
1389    </tr>
1390   </table>
1391  </p>
1392
1393  <h3><a name="anderevorlagen_statement">Sammelrechnung</a></h3>
1394
1395  <h3> Variablen f&uuml;r Sammelrechnung:</h3>
1396  <p>
1397   <table border="1">
1398    <tr><th>Variablenname</th><th>Bedeutung</th></tr>
1399    <tr>
1400     <td><code>c0total</code></td>
1401     <td>Gesamtbetrag aller Rechnungen mit F&auml;lligkeit &lt; 30 Tage</td>
1402    </tr>
1403    <tr>
1404     <td><code>c30total</code></td>
1405     <td>Gesamtbetrag aller Rechnungen mit F&auml;lligkeit &gt;= 30 und &lt; 60 Tage</td>
1406    </tr>
1407    <tr>
1408     <td><code>c60total</code></td>
1409     <td>Gesamtbetrag aller Rechnungen mit F&auml;lligkeit &gt;= 60 und &lt; 90 Tage</td>
1410    </tr>
1411    <tr>
1412     <td><code>c90total</code></td>
1413     <td>Gesamtbetrag aller Rechnungen mit F&auml;lligkeit &gt;= 90 Tage</td>
1414    </tr>
1415    <tr>
1416     <td><code>total</code></td>
1417     <td>Gesamtbetrag aller Rechnungen</td>
1418    </tr>
1419   </table>
1420  </p>
1421
1422  <h3> Variablen f&uuml;r jede Rechnungsposition in Sammelrechnung:</h3>
1423  <p>
1424   <table border="1">
1425    <tr><th>Variablenname</th><th>Bedeutung</th></tr>
1426    <tr>
1427     <td><code>invnumber</code></td>
1428     <td>Rechnungsnummer</td>
1429    </tr>
1430    <tr>
1431     <td><code>invdate</code></td>
1432     <td>Rechnungsdatum</td>
1433    </tr>
1434    <tr>
1435     <td><code>duedate</code></td>
1436     <td>F&auml;lligkeitsdatum</td>
1437    </tr>
1438    <tr>
1439     <td><code>amount</code></td>
1440     <td>Summe der Rechnung</td>
1441    </tr>
1442    <tr>
1443     <td><code>open</code></td>
1444     <td>Noch offener Betrag der Rechnung</td>
1445    </tr>
1446    <tr>
1447     <td><code>c0</code></td>
1448     <td>Noch offener Rechnungsbetrag mit F&auml;lligkeit &lt; 30 Tage</td>
1449    </tr>
1450    <tr>
1451     <td><code>c30</code></td>
1452     <td>Noch offener Rechnungsbetrag mit F&auml;lligkeit &gt;= 30 und &lt; 60 Tage</td>
1453    </tr>
1454    <tr>
1455     <td><code>c60</code></td>
1456     <td>Noch offener Rechnungsbetrag mit F&auml;lligkeit &gt;= 60 und &lt; 90 Tage</td>
1457    </tr>
1458    <tr>
1459     <td><code>c90</code></td>
1460     <td>Noch offener Rechnungsbetrag mit F&auml;lligkeit &gt;= 90 Tage</td>
1461    </tr>
1462   </table>
1463  </p>
1464
1465
1466
1467
1468  <small><a href="dokumentenvorlagen-und-variablen.html#inhaltsverzeichnis">
1469    zum Inhaltsverzeichnis</a></small><br>
1470  <hr>
1471
1472  <h2><a name="bloecke">
1473    Bl&ouml;cke, bedingte Anweisungen und Schleifen</a></h2>
1474
1475  <p>Der Parser kennt neben den Variablen einige weitere Konstrukte,
1476   die gesondert behandelt werden. Diese sind wie Variablennamen in
1477   spezieller Weise markiert: <code>&lt;%anweisung%&gt;
1478   ... &lt;%end%&gt;</code></p>
1479
1480  <p>Anmerkung zum <code>&lt;%end%&gt;</code>: Der besseren
1481   Verst&auml;ndlichkeit halber kann man nach dem <code>end</code> noch
1482   beliebig weitere W&ouml;rter schreiben, um so zu markieren, welche
1483   Anweisung (z.B. <code>if</code> oder <code>foreach</code>) damit
1484   abgeschlossen wird.</p>
1485
1486  <p>Beispiel: Lautet der Beginn eines Blockes
1487    z.B. <code class="blue">&lt;%if type ==
1488    &quot;sales_quotation&quot;%&gt;</code>, so k&ouml;nnte er mit
1489   <code class="blue">&lt;%end%&gt;</code> genauso abgeschlossen werden
1490   wie mit
1491   <code class="blue">&lt;%end if%&gt;</code> oder auch
1492   <code class="blue">&lt;%end type ==
1493   &quot;sales_quotation&quot;%&gt;</code>.</p>
1494
1495  <h3><a name="bloecke_if">Der <code>if</code>-Block</a></h3>
1496
1497  <p class="blue"><code>&lt;%if variablenname%&gt;<br>
1498    ...<br>
1499    &lt;%end%&gt;</code></p>
1500
1501  <p>Eine normale &quot;if-then&quot;-Bedingung. Die Zeilen zwischen
1502   dem &quot;if&quot; und dem &quot;end&quot; werden nur ausgegeben,
1503   wenn die Variable &quot;variablenname&quot; gesetzt und ungleich 0
1504   ist.</p>
1505
1506  <p>Die Bedingung kann auch negiert werden, indem das Wort
1507   &quot;not&quot; nach dem &quot;if&quot; verwendet
1508   wird. Beispiel: <code class="blue">&lt;%if not
1509   cp_greeting%&gt;</code></p>
1510
1511  <p>Zus&auml;tzlich zu dem einfachen Test, ob eine Variable gesetzt ist
1512   oder nicht, bietet dieser Block auch die M&ouml;glichkeit, den Inhalt
1513   einer Variablen mit einer festen Zeichenkette oder einer anderen
1514   Variablen zu vergleichen. Ob der Vergleich mit einer Zeichenkette
1515   oder einer anderen Variablen vorgenommen wird, h&auml;ngt davon ab, ob
1516   die rechte Seite des Vergleichsoperators in Anf&uuml;hrungszeichen
1517   gesetzt wird (Vergleich mit Zeichenkette) oder nicht (Vergleich mit
1518   anderer Variablen). Zwei Beispiele, die beide Vergleiche zeigen:</p>
1519
1520  <p><code class="blue">&lt;%if var1 == &quot;Wert&quot;%&gt;</code>
1521   testet die Variable &quot;var1&quot; auf &Uuml;bereinstimmung mit der
1522   Zeichenkette &quot;Wert&quot;. Mittels &quot;!=&quot; anstelle von
1523   &quot;==&quot; w&uuml;rde auf Ungleichheit getestet.</p>
1524
1525  <p><code class="blue">&lt;%if var1 == var2%&gt;</code> testet die
1526   Variable &quot;var1&quot; auf &Uuml;bereinstimmung mit der Variablen
1527   &quot;var2&quot;. Mittels &quot;!=&quot; anstelle von &quot;==&quot;
1528   w&uuml;rde auf Ungleichheit getestet.</p>
1529
1530  <p>Erfahrere Benutzer k&ouml;nnen neben der Tests auf (Un-)Gleichheit auch
1531   Tests auf &Uuml;bereinstimmung mit regul&auml;ren Ausdr&uuml;cken ohne
1532   Ber&uuml;cksichtung der Gro&szlig;- und Kleinschreibung durchf&uuml;hren. Dazu dient
1533   dieselbe Syntax wie oben nur mit &quot;=~&quot; und &quot;!~&quot;
1534   als Vergleichsoperatoren.</p>
1535
1536  <p>Beispiel f&uuml;r einen Test, ob die Variable &quot;intnotes&quot;
1537   (interne Bemerkungen) das Wort &quot;schwierig&quot; enth&auml;lt:
1538   <code class="blue">&lt;%if intnotes =~
1539   &quot;schwierig&quot;%&gt;</code></p>
1540
1541  <h3><a name="bloecke_foreach">Die <code>foreach</code>-Schleife</a></h3>
1542
1543  <p class="blue"><code>&lt;%foreach variablenname%&gt;<br>
1544    ...<br>
1545    &lt;%end%&gt;</code></p>
1546
1547  <p>F&uuml;gt die Zeilen zwischen den beiden Anweisungen so oft ein, wie das
1548   Perl-Array der Variablen "variablenname" Elemente enth&auml;t. Dieses
1549   Konstrukt wird zur Ausgabe der einzelnen Posten einer Rechnung / eines
1550   Angebots sowie zur Ausgabe der Steuern benutzt. In jedem Durchlauf werden
1551   die <a href="dokumentenvorlagen-und-variablen.html#invoice_posten">zeilenbezogenen
1552   Variablen</a> jeweils auf den Wert f&uuml;r die aktuelle Position
1553   gesetzt.</p>
1554
1555  <p>Die Syntax sieht normalerweise wie folgt aus:</p>
1556
1557  <p class="blue"><code>&lt;%foreach number%&gt;<br>
1558    Position: &lt;%runningnumber%&gt;<br>
1559    Anzahl: &lt;%qty%&gt;<br>
1560    Artikelnummer: &lt;%number%&gt;<br>
1561    Beschreibung: &lt;%description%&gt;<br>
1562    ...<br>
1563    &lt;%end%&gt;</code></p>
1564
1565  <p>Besonderheit in OpenDocument-Vorlagen: Tritt ein
1566   <code>&lt;%foreach%&gt;</code>-Block innerhalb einer Tabellenzelle
1567   auf, so wird die komplette Tabellenzeile so oft wiederholt wie
1568   notwendig. Tritt er au&szlig;erhalb auf, so wird nur der Inhalt
1569   zwischen <code>&lt;%foreach%&gt;</code> und <code>&lt;%end%&gt;</code>
1570   wiederholt, nicht aber die komplette Zeile, in der er steht.</p>
1571
1572  <h3><a name="bloecke_pagebreak">Der <code>pagebreak</code>-Block</a></h3>
1573
1574  <p class="blue"><code>&lt;%pagebreak ZpZ ZeS ZzS%&gt;<br>
1575    ...<br>
1576    &lt;%end%&gt;</code></p>
1577
1578  <p>Dieser Block existiert nur in LaTeX-Vorlagen.</p>
1579
1580  <p>Dieser Block legt das Verhalten beim manuellen Einf&uuml;gen eines
1581   Seitenumbruchs fest. Normalerweise bricht LaTeX die Seiten selber um. Beim
1582   Rechnungsdruck ist das oft nicht gew&uuml;nscht, oder man m&ouml;chte im
1583   Falle eines Seitenumbruchs den &Uuml;bertrag etc. mit ausgeben. Deswegen
1584   versucht der Parser, manuell Seitenumbr&uuml;che einzuf&uuml;gen,
1585   w&auml;hrend er einen <code>foreach</code>-Block auswertet, weil hier die
1586   manuellen Seitenumbr&uuml;che erforderlich werden. Daf&uuml;r ben&ouml;tigt
1587   der Parser aber drei Informationen:</p>
1588
1589  <p>
1590   <ol>
1591    <li>Wieviele Zeichen passen bei der Variablen "description" pro Posten
1592     in eine Zeile? Das ist der Parameter "ZpZ" (Zeichen pro Zeile).</li>
1593    <li>Wieviele Zeilen/Posten passen auf die erste Seite? Das
1594     ist der Parameter "ZeS" (Zeilen erste Seite).</li>
1595    <li>Wieviele Zeilen/Posten passen auf die zweite und alle nachfolgenden
1596     Seiten? Das ist der Parameter "ZzS" (Zeilen zweite Seite).</li>
1597   </ol>
1598  </p>
1599
1600  <p>Diese Parameter sind drei Zahlen, die manuell durch Verwendung von langen
1601   Warenbezeichnungen und Rechnungen mit vielen Posten bestimmt werden
1602   m&uuml;ssen.</p>
1603
1604  <p>&Uuml;blicherweise wird in diesem Block zuerst die aktuelle Tabelle
1605   geschlossen, eventuell Text eingef&uuml;gt (z.B. "Fortsetzung auf der
1606   n&auml;chsten Seite"), dann ein Seitenumbruch erzwungen, eventuell Text
1607   eingef&uuml;gt (z.B. "&Uuml;bertrag von der vorherigen Seite:
1608   &lt;%sumcarriedforward%&gt; EUR") und die Tabelle wieder ge&ouml;ffnet.</p>
1609
1610  <p>Wird kein manueller Seitenumbruch gew&uuml;scht, so kann dieser Block
1611   komplett entfallen.</p>
1612
1613  <small><a href="dokumentenvorlagen-und-variablen.html#inhaltsverzeichnis">
1614    zum Inhaltsverzeichnis</a></small><br>
1615  <hr>
1616
1617  <h2><a name="markup">
1618    Markup-Code, der innerhalb von Formularen zur Textformatierung
1619    verwendet werden kann</a></h2>
1620
1621  <p>Wenn der Benutzer innhalb von Formularen in Lx-Office Text anders
1622   formatiert haben m&ouml;chte, so ist dies begrenzt m&ouml;glich. Lx-Office
1623   unterst&uuml;tzt die Textformatierung mit HTML-&auml;hnlichen Tags. Der
1624   Benutzer kann z.B. bei der Artikelbeschreibung auf einer Rechnung Teile des
1625   Texts zwischen Start- und Endtags setzen. Dieser Teil wird dann automatisch
1626   in Anweisungen f&uuml;r das ausgew&auml;hlte Vorlagenformat (HTML oder
1627   PDF &uuml;ber LaTeX) umgesetzt.</p>
1628
1629  <p>Die unterst&uuml;tzen Formatierungen sind:</p>
1630
1631  <p>
1632   <table border="1">
1633    <tr><th>Formatierung</th><th>Auswirkung</th></tr>
1634    <tr>
1635     <td><code>&lt;b&gt;Text&lt;/b&gt;</code></td>
1636     <td>Text wird in <b>fettdruck</b> gesetzt.</td>
1637    </tr>
1638    <tr>
1639     <td><code>&lt;i&gt;Text&lt;/i&gt;</code></td>
1640     <td>Text wird <i>kursiv</i> gesetzt.</td>
1641    </tr>
1642    <tr>
1643     <td><code>&lt;u&gt;Text&lt;/u&gt;</code></td>
1644     <td>Text wird <u>unterstrichen</u>.</td>
1645    </tr>
1646    <tr>
1647     <td><code>&lt;s&gt;Text&lt;/s&gt;</code></td>
1648     <td>Text wird <s>durchgestrichen</s>. Diese Formatierung ist nicht bei der
1649      Ausgabe als PDF &uuml;ber LaTeX verf&uuml;gbar.</td>
1650    </tr>
1651    <tr>
1652     <td><code>&lt;pagebreak&gt;</code></td>
1653     <td>Erzwingt einen Seitenumbruch (siehe unten).</td>
1654    </tr>
1655    <tr>
1656     <td><code>&lt;bullet&gt;</code></td>
1657     <td>Erzeugt einen ausgef&uuml;llten Kreis f&uuml;r Aufz&auml;hlungen (&bull;) (siehe unten).</td>
1658    </tr>
1659   </table>
1660  </p>
1661
1662  <p>Eine Besonderheit ist der Befehl <code>&lt;pagebreak&gt;</code>,
1663   der nur in LaTeX-Vorlagen funktioniert und in anderen Vorlagen
1664   einfach gel&ouml;scht wird. Dieser erzwingt unabh&auml;ngig von der
1665   im <a
1666   href="dokumentenvorlagen-und-variablen.html#bloecke_pagebreak">pagebreak-Block</a>
1667   voreingestellten Werte einen Seitenumbruch nach der aktuellen
1668   Rechnungsposition. Dementsprechend funktioniert er nur innerhalb von
1669   <code>&lt;%foreach...%&gt;</code>-Schleifen. Weiterhin ben&ouml;tigt
1670   er kein Endtag.</p>
1671
1672  <p>Auch <code>&lt;bullet&gt;</code> funktioniert momentan auch nur in Latex-Vorlagen.</p>
1673
1674  <small><a href="dokumentenvorlagen-und-variablen.html#inhaltsverzeichnis">
1675    zum Inhaltsverzeichnis</a></small><br>
1676  <hr>
1677
1678 </body>
1679 </html>