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