Anpassung für oesterreichischen Kontenrahmen. Verhält sich neutral ggue. anderen...
[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="dokumentenvorlagen-und-variablen.html#allgemeine_variablen">
52     Allgemeine Variablen, die in allen Vorlagen vorhanden sind</a><br>
53
54    <ol>
55     <li><a href="dokumentenvorlagen-und-variablen.html#allgemein_stammdaten">
56       Stammdaten von Kunden und Lieferanten</a></li>
57
58     <li><a href="dokumentenvorlagen-und-variablen.html#allgemein_bearbeiter">
59       Informationen &uuml;ber den Bearbeiter</a></li>
60
61     <li><a href="dokumentenvorlagen-und-variablen.html#allgemein_verkaeufer">
62       Informationen &uuml;ber den Verk&auml;ufer</a></li>
63
64     <li><a href="dokumentenvorlagen-und-variablen.html#allgemein_steuern">
65       Variablen f&uuml;r jede Steuer</a></li>
66    </ol>
67   </li>
68
69   <li><a href="dokumentenvorlagen-und-variablen.html#invoice">
70     Variablen in Rechnungen</a>
71
72    <ol>
73     <li><a href="dokumentenvorlagen-und-variablen.html#invoice_allgemein">
74       Allgemeine Variablen</a></li>
75
76     <li><a href="dokumentenvorlagen-und-variablen.html#invoice_posten">
77       Variablen f&uuml;r jeden Posten auf der Rechnung</a></li>
78
79     <li><a href="dokumentenvorlagen-und-variablen.html#invoice_zahlungen">
80       Variablen f&uuml;r die Zahlungseing&auml;nge</a></li>
81    </ol>
82   </li>
83
84   <li><a href="dokumentenvorlagen-und-variablen.html#dunning">
85     Variablen in Mahnungen und Rechnungen &uuml;ber Mahngeb&uuml;hren</a>
86
87    <ol>
88     <li><a href="dokumentenvorlagen-und-variablen.html#dunning_vorlagennamen">
89       Namen der Vorlagen</a></li>
90
91     <li><a href="dokumentenvorlagen-und-variablen.html#dunning_allgemein">
92       Allgemeine Variablen in Mahnungen</a></li>
93
94     <li><a href="dokumentenvorlagen-und-variablen.html#dunning_details">
95       Variablen f&uuml;r jede gemahnte Rechnung in einer Mahnung</a></li>
96
97     <li><a href="dokumentenvorlagen-und-variablen.html#dunning_invoice">
98       Variablen in automatisch erzeugten Rechnungen &uuml;ber Mahngeb&uuml;hren</a></li>
99    </ol>
100   </li>
101
102   <li><a href="dokumentenvorlagen-und-variablen.html#anderevorlagen">
103     Variablen in anderen Vorlagen</a></li>
104
105   <li><a href="dokumentenvorlagen-und-variablen.html#bloecke">
106     Bl&ouml;cke, bedingte Anweisungen und Schleifen</a>
107
108    <ol>
109     <li><a href="dokumentenvorlagen-und-variablen.html#bloecke_ifnot">
110       Der <code>if not</code>-Block</a></li>
111
112     <li><a href="dokumentenvorlagen-und-variablen.html#bloecke_if">
113       Der <code>if</code>-Block</a></li>
114
115     <li><a href="dokumentenvorlagen-und-variablen.html#bloecke_foreach">
116       Die <code>foreach</code>-Schleife</a></li>
117
118     <li><a href="dokumentenvorlagen-und-variablen.html#bloecke_pagebreak">
119       Der <code>pagebreak</code>-Block</a></li>
120    </ol>
121   </li>
122
123   <li><a href="dokumentenvorlagen-und-variablen.html#markup">
124     Markup-Code, der innerhalb von Formularen zur Textformatierung verwendet
125     werden kann</a></li>
126
127  </ol>
128
129  <hr>
130
131  <h2><a name="einfuehrung">Einf&uuml;hrung</a></h2>
132
133  <p>Dies ist eine Auflistung der Standard-Dokumentenvorlagen und aller
134   zur Bearbeitung verf&uuml;gbaren Variablen. Eine Variable wird in
135   einer Vorlage durch ihren Inhalt ersetzt, wenn sie in der Form
136   <code>&lt;%variablenname%&gt;</code> verwendet wird.</p>
137
138  <p>Fr&uuml;her wurde hier nur &uuml;ber LaTeX gesprochen. Inzwischen
139   unterst&uuml;tzt Lx-Office aber auch OpenDocument-Vorlagen. Sofern
140   es nicht ausdr&uuml;cklich eingeschr&auml;nkt wird, gilt das im
141   Folgenden gesagte f&uuml;r alle Vorlagenarten.</p>
142
143  <p>Insgesamt sind technisch gesehen eine ganze Menge mehr Variablen
144   verf&uuml;gbar als hier aufgelistet werden. Die meisten davon k&ouml;nnen
145   allerdings innerhalb einer solchen Vorlage nicht sinnvoll verwendet
146   werden. Wenn eine Auflistung dieser Variablen gewollt ist, so kann diese wie
147   folgt erhalten werden:</p>
148
149  <ol>
150
151   <li><code>SL/Form.pm</code> &ouml;ffnen und am Anfang die Zeile
152    <pre>"use Data::Dumper;"</pre> einf&uuml;gen.</li>
153
154   <li>In <code>Form.pm</code> die Funktion <code>parse_template</code>
155    suchen und hier die Zeile <pre>print(STDERR Dumper($self));</pre>
156    einf&uuml;gen.</li>
157
158   <li>Einmal per Browser die gew&uuml;nschte Vorlage "benutzen", z.B. ein PDF
159    f&uuml;r eine Rechnung erzeugen.</li>
160
161   <li>Im <code>error.log</code> vom Apache steht die Ausgabe der Variablen
162    <code>$self</code> in der Form <code>'key' =&gt; 'value',</code>. Alle
163    <code>key</code>s sind verf&uuml;gbar.</li>
164
165  </ol>
166
167  <small><a href="dokumentenvorlagen-und-variablen.html#inhaltsverzeichnis">
168    zum Inhaltsverzeichnis</a></small><br>
169  <hr>
170
171  <h2><a name="zuordnung_dateinamen">
172    Zuordnung von den Dateinamen zu den Funktionen</a></h2>
173
174  <p>Diese folgende kurze Auflistung zeigt, welche Vorlage bei welcher
175   Funktion ausgelesen wird. Dabei ist die Dateiendung &quot;.ext&quot;
176   geeignet zu ersetzen: &quot;.tex&quot; f&uuml; LaTeX-Vorlagen und
177   &quot;.odt&quot; f&uuml;r OpenDocument-Vorlagen.</p>
178
179  <ul>
180   <li><code>bin_list.ext</code> -- Lagerliste</li>
181   <li><code>check.ext</code> -- ?</li>
182   <li><code>invoice.ext</code> -- Rechnung</li>
183   <li><code>packing_list.ext</code> -- Verpackungsliste</li>
184   <li><code>pick_list.ext</code> -- Sammelliste</li>
185   <li><code>purcharse_order.ext</code> -- Bestellung an Lieferanten</li>
186   <li><code>request_quotation.ext</code> -- Anfrage an Lieferanten</li>
187   <li><code>sales_order.ext</code> -- Bestellung</li>
188   <li><code>sales_quotation.ext</code> -- Angebot an Kunden</li>
189  </ul>
190
191  <small><a href="dokumentenvorlagen-und-variablen.html#inhaltsverzeichnis">
192    zum Inhaltsverzeichnis</a></small><br>
193  <hr>
194
195  <h2><a name="allgemeine_variablen">
196    Allgemeine Variablen, die in allen Vorlagen vorhanden sind</a></h2>
197
198  <h3><a name="allgemein_stammdaten">
199    Stammdaten von Kunden und Lieferanten:</a></h3>
200
201  <p>
202   <table border="1">
203    <tr><th>Variablenname</th><th>Bedeutung</th></tr>
204    <tr>
205     <td><code>account_number</code></td>
206     <td>Kontonummer</td>
207    </tr>
208    <tr>
209     <td><code>bank</code></td>
210     <td>Name der Bank</td>
211    </tr>
212    <tr>
213     <td><code>bank_code</code></td>
214     <td>Bankleitzahl</td>
215    </tr>
216    <tr>
217     <td><code>business</code></td>
218     <td>Kunden-/Lieferantentyp</td>
219    </tr>
220    <tr>
221     <td><code>city</code></td>
222     <td>Stadt</td>
223    </tr>
224    <tr>
225     <td><code>contact</code></td>
226     <td>Kontakt</td>
227    </tr>
228    <tr>
229     <td><code>country</code></td>
230     <td>Land</td>
231    </tr>
232    <tr>
233     <td><code>cp_email</code></td>
234     <td>Email des Ansprechpartners</td>
235    </tr>
236    <tr>
237     <td><code>cp_givenname</code></td>
238     <td>Vorname des Ansprechpartners</td>
239    </tr>
240    <tr>
241     <td><code>cp_greeting</code></td>
242     <td>Anrede des Ansprechpartners</td>
243    </tr>
244    <tr>
245     <td><code>cp_name</code></td>
246     <td>Name des Ansprechpartners</td>
247    </tr>
248    <tr>
249     <td><code>cp_phone1</code></td>
250     <td>Telefonnummer 1 des Ansprechpartners</td>
251    </tr>
252    <tr>
253     <td><code>cp_phone2</code></td>
254     <td>Telefonnummer 2 des Ansprechpartners</td>
255    </tr>
256    <tr>
257     <td><code>cp_title</code></td>
258     <td>Titel des Ansprechpartners</td>
259    </tr>
260    <tr>
261     <td><code>creditlimit</code></td>
262     <td>Kreditlimit</td>
263    </tr>
264    <tr>
265     <td><code>customeremail</code></td>
266     <td>Email des Kunden; nur f&uuml;r Kunden</td>
267    </tr>
268    <tr>
269     <td><code>customerfax</code></td>
270     <td>Faxnummer des Kunden; nur f&uuml;r Kunden</td>
271    </tr>
272    <tr>
273     <td><code>customernotes</code></td>
274     <td>Bemerkungen beim Kunden; nur f&uuml;r Kunden</td>
275    </tr>
276    <tr>
277     <td><code>customernumber</code></td>
278     <td>Kundennummer; nur f&uuml;r Kunden</td>
279    </tr>
280    <tr>
281     <td><code>customerphone</code></td>
282     <td>Telefonnummer des Kunden; nur f&uuml;r Kunden</td>
283    </tr>
284    <tr>
285     <td><code>discount</code></td>
286     <td>Rabatt</td>
287    </tr>
288    <tr>
289     <td><code>email</code></td>
290     <td>Emailadresse</td>
291    </tr>
292    <tr>
293     <td><code>fax</code></td>
294     <td>Faxnummer</td>
295    </tr>
296    <tr>
297     <td><code>homepage</code></td>
298     <td>Homepage</td>
299    </tr>
300    <tr>
301     <td><code>language</code></td>
302     <td>Sprache</td>
303    </tr>
304    <tr>
305     <td><code>name</code></td>
306     <td>Firmenname</td>
307    </tr>
308    <tr>
309     <td><code>payment_terms</code></td>
310     <td>Zahlungskonditionen</td>
311    </tr>
312    <tr>
313     <td><code>phone</code></td>
314     <td>Telefonnummer</td>
315    </tr>
316    <tr>
317     <td><code>shiptocity</code></td>
318     <td>Stadt (Lieferadresse)
319      <a href="dokumentenvorlagen-und-variablen.html#anmerkung_shipto">*</a></td>
320    </tr>
321    <tr>
322     <td><code>shiptocontact</code></td>
323     <td>Kontakt (Lieferadresse)
324      <a href="dokumentenvorlagen-und-variablen.html#anmerkung_shipto">*</a></td>
325    </tr>
326    <tr>
327     <td><code>shiptocountry</code></td>
328     <td>Land (Lieferadresse)
329      <a href="dokumentenvorlagen-und-variablen.html#anmerkung_shipto">*</a></td>
330    </tr>
331    <tr>
332     <td><code>shiptodepartment1</code></td>
333     <td>Abteilung 1 (Lieferadresse)
334      <a href="dokumentenvorlagen-und-variablen.html#anmerkung_shipto">*</a></td>
335    </tr>
336    <tr>
337     <td><code>shiptodepartment2</code></td>
338     <td>Abteilung 2 (Lieferadresse)
339      <a href="dokumentenvorlagen-und-variablen.html#anmerkung_shipto">*</a></td>
340    </tr>
341    <tr>
342     <td><code>shiptoemail</code></td>
343     <td>Email (Lieferadresse)
344      <a href="dokumentenvorlagen-und-variablen.html#anmerkung_shipto">*</a></td>
345    </tr>
346    <tr>
347     <td><code>shiptofax</code></td>
348     <td>Fax (Lieferadresse)
349      <a href="dokumentenvorlagen-und-variablen.html#anmerkung_shipto">*</a></td>
350    </tr>
351    <tr>
352     <td><code>shiptoname</code></td>
353     <td>Firmenname (Lieferadresse)
354      <a href="dokumentenvorlagen-und-variablen.html#anmerkung_shipto">*</a></td>
355    </tr>
356    <tr>
357     <td><code>shiptophone</code></td>
358     <td>Telefonnummer (Lieferadresse)
359      <a href="dokumentenvorlagen-und-variablen.html#anmerkung_shipto">*</a></td>
360    </tr>
361    <tr>
362     <td><code>shiptostreet</code></td>
363     <td>Straße und Hausnummer (Lieferadresse)
364      <a href="dokumentenvorlagen-und-variablen.html#anmerkung_shipto">*</a></td>
365    </tr>
366    <tr>
367     <td><code>shiptozipcode</code></td>
368     <td>Postleitzahl (Lieferadresse)
369      <a href="dokumentenvorlagen-und-variablen.html#anmerkung_shipto">*</a></td>
370    </tr>
371    <tr>
372     <td><code>street</code></td>
373     <td>Straße und Hausnummer</td>
374    </tr>
375    <tr>
376     <td><code>taxnumber</code></td>
377     <td>Steuernummer</td>
378    </tr>
379    <tr>
380     <td><code>vendoremail</code></td>
381     <td>Email des Lieferanten; nur f&uuml;r Lieferanten</td>
382    </tr>
383    <tr>
384     <td><code>vendorfax</code></td>
385     <td>Faxnummer des Lieferanten; nur f&uuml;r Lieferanten</td>
386    </tr>
387    <tr>
388     <td><code>vendornotes</code></td>
389     <td>Bemerkungen beim Lieferanten; nur f&uuml;r Lieferanten</td>
390    </tr>
391    <tr>
392     <td><code>vendornumber</code></td>
393     <td>Lieferantennummer; nur f&uuml;r Lieferanten</td>
394    </tr>
395    <tr>
396     <td><code>vendorphone</code></td>
397     <td>Telefonnummer des Lieferanten; nur f&uuml;r Lieferanten</td>
398    </tr>
399    <tr>
400     <td><code>zipcode</code></td>
401     <td>Postleitzahl</td>
402    </tr>
403   </table>
404  </p>
405
406  <p><a name="anmerkung_shipto"><em>Anmerkung</em></a>: Sind die
407   <code>shipto*</code>-Felder in den Stammdaten nicht eingetragen, so haben
408   die Variablen <code>shipto*</code> den gleichen Wert wie die die
409   entsprechenden Variablen der Lieferdaten. Das bedeutet, dass sich einige
410   <code>shipto*</code>-Variablen so nicht in den Stammdaten wiederfinden
411   sondern schlicht Kopien der Lieferdatenvariablen sind
412   (z.B. <code>shiptocontact</code>).</p>
413
414  <h3><a name="allgemein_bearbeiter">
415    Informationen &uuml;ber den Bearbeiter:</a></h3>
416
417  <p>
418   <table border="1">
419    <tr><th>Variablenname</th><th>Bedeutung</th></tr>
420    <tr>
421     <td><code>employee_address</code></td>
422     <td>Adressfeld</td>
423    </tr>
424    <tr>
425     <td><code>employee_businessnumber</code></td>
426     <td>Firmennummer</td>
427    </tr>
428    <tr>
429     <td><code>employee_company</code></td>
430     <td>Firmenname</td>
431    </tr>
432    <tr>
433     <td><code>employee_co_ustid</code></td>
434     <td>Usatzsteuer-Identifikationsnummer</td>
435    </tr>
436    <tr>
437     <td><code>employee_duns</code></td>
438     <td>DUNS-Nummer</td>
439    </tr>
440    <tr>
441     <td><code>employee_email</code></td>
442     <td>Email</td>
443    </tr>
444    <tr>
445     <td><code>employee_fax</code></td>
446     <td>Fax</td>
447    </tr>
448    <tr>
449     <td><code>employee_name</code></td>
450     <td>voller Name</td>
451    </tr>
452    <tr>
453     <td><code>employee_signature</code></td>
454     <td>Signatur</td>
455    </tr>
456    <tr>
457     <td><code>employee_taxnumber</code></td>
458     <td>Steuernummer</td>
459    </tr>
460    <tr>
461     <td><code>employee_tel</code></td>
462     <td>Telefonnummer</td>
463    </tr>
464   </table>
465  </p>
466
467  <h3><a name="allgemein_verkaeufer">
468    Informationen &uuml;ber den Verk&auml;fer (nur bei Verkaufsmasken):</a></h3>
469
470  <p>
471   <table border="1">
472    <tr><th>Variablenname</th><th>Bedeutung</th></tr>
473    <tr>
474     <td><code>salesman_address</code></td>
475     <td>Adressfeld</td>
476    </tr>
477    <tr>
478     <td><code>salesman_businessnumber</code></td>
479     <td>Firmennummer</td>
480    </tr>
481    <tr>
482     <td><code>salesman_company</code></td>
483     <td>Firmenname</td>
484    </tr>
485    <tr>
486     <td><code>salesman_co_ustid</code></td>
487     <td>Usatzsteuer-Identifikationsnummer</td>
488    </tr>
489    <tr>
490     <td><code>salesman_duns</code></td>
491     <td>DUNS-Nummer</td>
492    </tr>
493    <tr>
494     <td><code>salesman_email</code></td>
495     <td>Email</td>
496    </tr>
497    <tr>
498     <td><code>salesman_fax</code></td>
499     <td>Fax</td>
500    </tr>
501    <tr>
502     <td><code>salesman_name</code></td>
503     <td>voller Name</td>
504    </tr>
505    <tr>
506     <td><code>salesman_signature</code></td>
507     <td>Signatur</td>
508    </tr>
509    <tr>
510     <td><code>salesman_taxnumber</code></td>
511     <td>Steuernummer</td>
512    </tr>
513    <tr>
514     <td><code>salesman_tel</code></td>
515     <td>Telefonnummer</td>
516    </tr>
517   </table>
518  </p>
519
520  <h3><a name="allgemein_steuern">
521    Variablen f&uuml;r die einzelnen Steuern:</a></h3>
522
523  <p>
524   <table border="1">
525    <tr><th>Variablenname</th><th>Bedeutung</th></tr>
526    <tr>
527     <td><code>tax</code></td>
528     <td>Steuer</td>
529    </tr>
530    <tr>
531     <td><code>taxbase</code></td>
532     <td>zu versteuernder Betrag</td>
533    </tr>
534    <tr>
535     <td><code>taxdescription</code></td>
536     <td>Name der Steuer</td>
537    </tr>
538    <tr>
539     <td><code>taxrate</code></td>
540     <td>Steuersatz</td>
541    </tr>
542   </table>
543  </p>
544
545  <small><a href="dokumentenvorlagen-und-variablen.html#inhaltsverzeichnis">
546    zum Inhaltsverzeichnis</a></small><br>
547  <hr>
548
549  <h2><a name="invoice">Variablen in Rechnungen</a></h2>
550
551  <h3><a name="invoice_allgemein">Allgemeine Variablen:</a></h3>
552
553  <p>
554   <table border="1">
555    <tr><th>Variablenname</th><th>Bedeutung</th></tr>
556    <tr>
557     <td><code>creditremaining</code></td>
558     <td>Verbleibender Kredit</td>
559    </tr>
560    <tr>
561     <td><code>currency</code></td>
562     <td>Währung</td>
563    </tr>
564    <tr>
565     <td><code>cusordnumber</code></td>
566     <td>Bestellnummer beim Kunden</td>
567    </tr>
568    <tr>
569     <td><code>deliverydate</code></td>
570     <td>Lieferdatum</td>
571    </tr>
572    <tr>
573     <td><code>duedate</code></td>
574     <td>Fälligkeitsdatum</td>
575    </tr>
576    <tr>
577     <td><code>globalprojectnumber</code></td>
578     <td>Projektnummer des ganzen Beleges</td>
579    </tr>
580    <tr>
581     <td><code>intnotes</code></td>
582     <td>Interne Bemerkungen</td>
583    </tr>
584    <tr>
585     <td><code>invdate</code></td>
586     <td>Rechnungsdatum</td>
587    </tr>
588    <tr>
589     <td><code>invnumber</code></td>
590     <td>Rechnungsnummer</td>
591    </tr>
592    <tr>
593     <td><code>invtotal</code></td>
594     <td>gesamter Rechnungsbetrag</td>
595    </tr>
596    <tr>
597     <td><code>notes</code></td>
598     <td>Bemerkungen der Rechnung</td>
599    </tr>
600    <tr>
601     <td><code>orddate</code></td>
602     <td>Auftragsdatum</td>
603    </tr>
604    <tr>
605     <td><code>ordnumber</code></td>
606     <td>Auftragsnummer, wenn die Rechnung aus einem Auftrag erstellt wurde</td>
607    </tr>
608    <tr>
609     <td><code>payment_terms</code></td>
610     <td>Zahlungskonditionen</td>
611    </tr>
612    <tr>
613     <td><code>quodate</code></td>
614     <td>Angebotsdatum</td>
615    </tr>
616    <tr>
617     <td><code>quonumber</code></td>
618     <td>Angebotsnummer</td>
619    </tr>
620    <tr>
621     <td><code>shippingpoint</code></td>
622     <td>Versandort</td>
623    </tr>
624    <tr>
625     <td><code>shipvia</code></td>
626     <td>Transportmittel</td>
627    </tr>
628    <tr>
629     <td><code>subtotal</code></td>
630     <td>Zwischensumme aller Posten ohne Steuern</td>
631    </tr>
632    <tr>
633     <td><code>sumcarriedforward</code></td>
634     <td>Zwischensumme aller bisher ausgegebenen Posten. Sollte nur in einem
635      <a href="dokumentenvorlagen-und-variablen.html#bloecke_pagebreak">
636       <code>pagebreak</code></a>-Block verwendet werden.</td>
637    </tr>
638    <tr>
639     <td><code>total</code></td>
640     <td>Restsumme der Rechnung (Summe abz&uuml;glich bereits bezahlter Posten)</td>
641    </tr>
642    <tr>
643     <td><code>transaction_description</code></td>
644     <td>Vorgangsbezeichnung</td>
645    </tr>
646    <tr>
647     <td><code>transdate</code></td>
648     <td>Auftragsdatum wenn die Rechnung aus einem Auftrag erstellt wurde</td>
649    </tr>
650   </table>
651  </p>
652
653  <h3><a name="invoice_posten">
654    Variablen f&uuml;r jeden Posten auf der Rechnung:</a></h3>
655
656  <p>
657   <table border="1">
658    <tr><th>Variablenname</th><th>Bedeutung</th></tr>
659    <tr>
660     <td><code>assembly</code></td>
661     <td>Erzeugnis</td>
662    </tr>
663    <tr>
664     <td><code>bin</code></td>
665     <td>Stellage</td>
666    </tr>
667    <tr>
668     <td><code>deliverydate_oe</code></td>
669     <td>Lieferdatum</td>
670    </tr>
671    <tr>
672     <td><code>description</code></td>
673     <td>Artikelbeschreibung</td>
674    </tr>
675    <tr>
676     <td><code>discount</code></td>
677     <td>Rabatt als Betrag</td>
678    </tr>
679    <tr>
680     <td><code>linetotal</code></td>
681     <td>Zeilensumme (Anzahl * Einzelpreis)</td>
682    </tr>
683    <tr>
684     <td><code>listprice</code></td>
685     <td>Listenpreis</td>
686    </tr>
687    <tr>
688     <td><code>netprice</code></td>
689     <td>Nettopreis</td>
690    </tr>
691    <tr>
692     <td><code>number</code></td>
693     <td>Artikelnummer</td>
694    </tr>
695    <tr>
696     <td><code>ordnumber_oe</code></td>
697     <td>Auftragsnummer des Originalauftrags, wenn die Rechnung aus einem Sammelauftrag erstellt wurde</td>
698    </tr>
699    <tr>
700    <td><code>p_discount</code></td>
701     <td>Rabatt in Prozent</td>
702    </tr>
703    <tr>
704     <td><code>partnotes</code></td>
705     <td>Die beim Artikel gespeicherten Bemerkungen</td>
706    </tr>
707    <tr>
708     <td><code>partsgroup</code></td>
709     <td>Warengruppe</td>
710    </tr>
711    <tr>
712     <td><code>projectnumber</code></td>
713     <td>Projektnummer</td>
714    </tr>
715    <tr>
716     <td><code>qty</code></td>
717     <td>Anzahl</td>
718    </tr>
719    <tr>
720     <td><code>runningnumber</code></td>
721     <td>Position auf der Rechnung (1, 2, 3...)</td>
722    </tr>
723    <tr>
724     <td><code>sellprice</code></td>
725     <td>Verkaufspreis</td>
726    </tr>
727    <tr>
728     <td><code>serialnumber</code></td>
729     <td>Seriennummer</td>
730    </tr>
731    <tr>
732     <td><code>transdate_oe</code></td>
733     <td>Auftragsdatum des Originalauftrags, wenn die Rechnung aus einem Sammelauftrag erstellt wurde</td>
734    </tr>
735    <tr>
736     <td><code>unit</code></td>
737     <td>Einheit</td>
738    </tr>
739   </table>
740  </p>
741
742  <h3><a name="invoice_zahlungen">
743    Variablen f&uuml;r die einzelnen Zahlungseingänge:</a></h3>
744
745  <p>
746   <table border="1">
747    <tr><th>Variablenname</th><th>Bedeutung</th></tr>
748    <tr>
749     <td><code>datepaid</code></td>
750     <td>Datum</td>
751    </tr>
752    <tr>
753     <td><code>memo</code></td>
754     <td>Memo</td>
755    </tr>
756    <tr>
757     <td><code>paid</code></td>
758     <td>Betrag</td>
759    </tr>
760    <tr>
761     <td><code>source</code></td>
762     <td>Beleg</td>
763    </tr>
764    <tr>
765     <td><code>exchangerate</code></td>
766     <td>Wechselkurs</td>
767    </tr>
768    <tr>
769     <td><code>forex</code></td>
770     <td>Konto</td>
771    </tr>
772   </table>
773  </p>
774
775  <small><a href="dokumentenvorlagen-und-variablen.html#inhaltsverzeichnis">
776    zum Inhaltsverzeichnis</a></small><br>
777  <hr>
778
779  <h2><a name="dunning">Variablen in Mahnungen und Rechnungen &uuml;ber Mahngeb&uuml;hren</a></h2>
780
781  <h3><a name="dunning_vorlagennamen">Namen der Vorlagen</a></h3>
782
783  <p>Die Namen der Vorlagen werden im System-Men&uuml; vom Benutzer
784   eingegeben. Wird f&uuml;r ein Mahnlevel die Option zur automatischen
785   Erstellung einer Rechnung &uuml;ber die Mahngeb&uuml;hren und Zinsen
786   aktiviert, so wird der Name der Vorlage f&uuml;r diese Rechnung aus
787   dem Vorlagenname f&uuml;r diese Mahnstufe mit dem
788   Zusatz <code>_invoice</code> gebildet. Weiterhin werden die
789   K&uuml;rzel f&uuml;r die ausgew&auml;hlte Sprache und den
790   ausgew&auml;hlten Drucker angeh&auml;ngt.</p>
791
792  <h3><a name="dunning_allgemein">Allgemeine Variablen in Mahnungen:</a></h3>
793
794  <p>Die Variablen des Verkäufers stehen wie gewohnt
795   als <code>employee_...</code> zur Verfügung. Die Adressdaten des
796   Kunden stehen als Variablen <code>name</code>, <code>street</code>,
797   <code>zipcode</code>, <code>city</code>, <code>country</code>,
798   <code>department_1</code>, <code>department_2</code>, und
799   <code>email</code> zur Verfügung.
800  </p>
801
802  <p>Weitere Variablen beinhalten:</p>
803
804  <p>
805   <table border="1">
806    <tr><th>Variablenname</th><th>Bedeutung</th></tr>
807    <tr>
808     <td><code>dunning_date</code></td>
809     <td>Datum der Mahnung</td>
810    </tr>
811    <tr>
812     <td><code>dunning_duedate</code></td>
813     <td>F&auml;lligkeitsdatum f&uuml;r diese Mahhnung</td>
814    </tr>
815    <tr>
816     <td><code>fee</code></td>
817     <td>Kummulative Mahngebühren</td>
818    </tr>
819    <tr>
820     <td><code>interest_rate</code></td>
821     <td>Zinssatz per anno in Prozent</td>
822    </tr>
823    <tr>
824     <td><code>total_amount</code></td>
825     <td>Gesamter noch zu zahlender Betrag als <code>fee</code> + <code>total_interest</code> + <code>total_open_amount</code></td>
826    </tr>
827    <tr>
828     <td><code>total_interest</code></td>
829     <td>Zinsen per anno &uuml;ber alle Rechnungen</td>
830    </tr>
831    <tr>
832     <td><code>total_open_amount</code></td>
833     <td>Summe &uuml;ber alle offene Betr&auml;ge der Rechnungen</td>
834    </tr>
835   </table>
836  </p>
837
838  <h3><a name="dunning_details">
839    Variablen f&uuml;r jede gemahnte Rechnung in einer Mahnung:</a></h3>
840
841  <p>
842   <table border="1">
843    <tr><th>Variablenname</th><th>Bedeutung</th></tr>
844    <tr>
845     <td><code>dn_amount</code></td>
846     <td>Rechnungssumme (brutto)</td>
847    </tr>
848    <tr>
849     <td><code>dn_duedate</code></td>
850     <td>Originales F&auml;lligkeitsdatum der Rechnung</td>
851    </tr>
852    <tr>
853     <td><code>dn_dunning_date</code></td>
854     <td>Datum der Mahnung</td>
855    </tr>
856    <tr>
857     <td><code>dn_dunning_duedate</code></td>
858     <td>F&auml;lligkeitsdatum der Mahnung</td>
859    </tr>
860    <tr>
861     <td><code>dn_fee</code></td>
862     <td>Kummulative Mahngeb&uuml;hr</td>
863    </tr>
864    <tr>
865     <td><code>dn_interest</code></td>
866     <td>Zinsen per anno f&uuml;r diese Rechnung</td>
867    </tr>
868    <tr>
869     <td><code>dn_invnumber</code></td>
870     <td>Rechnungsnummer</td>
871    </tr>
872    <tr>
873     <td><code>dn_linetotal</code></td>
874     <td>Noch zu zahlender Betrag (ergibt sich aus <code>dn_open_amount + dn_fee + dn_interest</code>)</td>
875    </tr>
876    <tr>
877     <td><code>dn_netamount</code></td>
878     <td>Rechnungssumme (netto)</td>
879    </tr>
880    <tr>
881     <td><code>dn_open_amount</code></td>
882     <td>Offener Rechnungsbetrag</td>
883    </tr>
884    <tr>
885     <td><code>dn_ordnumber</code></td>
886     <td>Bestellnummer</td>
887    </tr>
888    <tr>
889     <td><code>dn_transdate</code></td>
890     <td>Rechnungsdatum</td>
891    </tr>
892   </table>
893  </p>
894
895  <h3><a name="dunning_invoice">Variablen in automatisch erzeugten
896    Rechnungen &uuml;ber Mahngeb&uuml;hren</a></h3>
897
898  <p>Die Variablen des Verkäufers stehen wie gewohnt
899   als <code>employee_...</code> zur Verfügung. Die Adressdaten des
900   Kunden stehen als Variablen <code>name</code>, <code>street</code>,
901   <code>zipcode</code>, <code>city</code>, <code>country</code>,
902   <code>department_1</code>, <code>department_2</code>, und
903   <code>email</code> zur Verfügung.
904  </p>
905
906  <p>Weitere Variablen beinhalten:</p>
907
908  <p>
909   <table border="1">
910    <tr><th>Variablenname</th><th>Bedeutung</th></tr>
911    <tr>
912     <td><code>duedate</code></td>
913     <td>Fälligkeitsdatum der Rechnung</td>
914    </tr>
915    <tr>
916     <td><code>dunning_id</code></td>
917     <td>Mahnungsnummer</td>
918    </tr>
919    <tr>
920     <td><code>fee</code></td>
921     <td>Mahngeb&uuml;hren</td>
922    </tr>
923    <tr>
924     <td><code>interest</code></td>
925     <td>Zinsen</td>
926    </tr>
927    <tr>
928     <td><code>invamount</code></td>
929     <td>Rechnungssumme (ergibt sich aus <code>fee + interest</code>)</td>
930    </tr>
931    <tr>
932     <td><code>invdate</code></td>
933     <td>Rechnungsdatum</td>
934    </tr>
935    <tr>
936     <td><code>invnumber</code></td>
937     <td>Rechnungsnummer</td>
938    </tr>
939   </table>
940  </p>
941
942  <small><a href="dokumentenvorlagen-und-variablen.html#inhaltsverzeichnis">
943    zum Inhaltsverzeichnis</a></small><br>
944  <hr>
945
946  <h2><a name="anderevorlagen">
947    Variablen in anderen Vorlagen</a></h2>
948
949  <p>Die Variablen in anderen Vorlagen sind &auml;hnlich wie in der
950   Rechnung. Allerdings hei&szlig;en die Variablen, die mit <code>inv</code>
951   beginnen, jetzt anders. Bei den Angeboten fangen sie mit <code>quo</code>
952   f&uuml;r "quotation" an: <code>quodate</code> f&uuml;r Angebotsdatum
953   etc. Bei Bestellungen wiederum fangen sie mit <code>ord</code> f&uuml;r
954   "order" an: <code>ordnumber</code> f&uuml;r Bestellnummer etc.</p>
955
956  <p>Manche Variablen sind in anderen Vorlagen hingegen gar nicht vorhanden wie
957   z.B. die f&uuml;r bereits verbuchte Zahlungseing&auml;nge. Dies sind
958   Variablen, die vom Gesch&auml;ftsablauf her in der entsprechenden Vorlage
959   keine Bedeutung haben oder noch nicht belegt sein k&ouml;nnen.</p>
960
961  <small><a href="dokumentenvorlagen-und-variablen.html#inhaltsverzeichnis">
962    zum Inhaltsverzeichnis</a></small><br>
963  <hr>
964
965  <h2><a name="bloecke">
966    Bl&ouml;cke, bedingte Anweisungen und Schleifen</a></h2>
967
968  <p>Der Parser kennt neben den Variablen einige weitere Konstrukte, die
969   gesondert behandelt werden. Diese sind wie Variablennamen in spezieller
970   Weise markiert: <code>&lt;%anweisung%&gt;</code></p>
971
972  <h3><a name="bloecke_ifnot">Der <code>if not</code>-Block</a></h3>
973
974  <p class="blue"><code>&lt;%if not variablenname%&gt;<br>
975    ...<br>
976    &lt;%end&gt;</code></p>
977
978  <p>Eine normale "if-not-then"-Bedingung. Die Zeilen zwischen dem "if not" und
979   dem "end" werden nur ausgegeben, wenn die Variable "variablenname" nicht
980   gesetzt oder gleich 0 ist.</p>
981
982  <h3><a name="bloecke_if">Der <code>if</code>-Block</a></h3>
983
984  <p class="blue"><code>&lt;%if variablenname%&gt;<br>
985    ...<br>
986    &lt;%end&gt;</code></p>
987
988  <p>Eine normale "if-then"-Bedingung. Die Zeilen zwischen dem "if" und dem
989   "end" werden nur ausgegeben, wenn die Variable "variablenname" gesetzt und
990   ungleich 0 ist.</p>
991
992  <h3><a name="bloecke_foreach">Die <code>foreach</code>-Schleife</a></h3>
993
994  <p class="blue"><code>&lt;%foreach variablenname%&gt;<br>
995    ...<br>
996    &lt;%end&gt;</code></p>
997
998  <p>F&uuml;gt die Zeilen zwischen den beiden Anweisungen so oft ein, wie das
999   Perl-Array der Variablen "variablenname" Elemente enth&auml;t. Dieses
1000   Konstrukt wird zur Ausgabe der einzelnen Posten einer Rechnung / eines
1001   Angebots sowie zur Ausgabe der Steuern benutzt. In jedem Durchlauf werden
1002   die <a href="dokumentenvorlagen-und-variablen.html#invoice_posten">zeilenbezogenen
1003   Variablen</a> jeweils auf den Wert f&uuml;r die aktuelle Position
1004   gesetzt.</p>
1005
1006  <p>Die Syntax sieht normalerweise wie folgt aus:</p>
1007
1008  <p class="blue"><code>&lt;%foreach number%&gt;<br>
1009    Position: &lt;%runningnumber%&gt;<br>
1010    Anzahl: &lt;%qty%&gt;<br>
1011    Artikelnummer: &lt;%number%&gt;<br>
1012    Beschreibung: &lt;%description%&gt;<br>
1013    ...<br>
1014    &lt;%end&gt;</code></p>
1015
1016  <p>Besonderheit in OpenDocument-Vorlagen: Tritt ein
1017   <code>&lt;foreach&gt;</code>-Block innerhalb einer Tabellenzelle
1018   auf, so wird die komplette Tabellenzeile so oft wiederholt wie
1019   notwendig. Tritt er au&szlig;erhalb auf, so wird nur der Inhalt
1020   zwischen <code>&lt;foreach&gt;</code> und <code>&lt;end&gt;</code>
1021   wiederholt, nicht aber die komplette Zeile, in der er steht.</p>
1022
1023  <h3><a name="bloecke_pagebreak">Der <code>pagebreak</code>-Block</a></h3>
1024
1025  <p class="blue"><code>&lt;%pagebreak ZpZ ZeS ZzS%&gt;<br>
1026    ...<br>
1027    &lt;%end&gt;</code></p>
1028
1029  <p>Dieser Block existiert nur in LaTeX-Vorlagen.</p>
1030
1031  <p>Dieser Block legt das Verhalten beim manuellen Einf&uuml;gen eines
1032   Seitenumbruchs fest. Normalerweise bricht LaTeX die Seiten selber um. Beim
1033   Rechnungsdruck ist das oft nicht gew&uuml;nscht, oder man m&ouml;chte im
1034   Falle eines Seitenumbruchs den &Uuml;bertrag etc. mit ausgeben. Deswegen
1035   versucht der Parser, manuell Seitenumbr&uuml;che einzuf&uuml;gen,
1036   w&auml;hrend er einen <code>foreach</code>-Block auswertet, weil hier die
1037   manuellen Seitenumbr&uuml;che erforderlich werden. Daf&uuml;r ben&ouml;tigt
1038   der Parser aber drei Informationen:</p>
1039
1040  <p>
1041   <ol>
1042    <li>Wieviele Zeichen passen bei der Variablen "description" pro Posten
1043     in eine Zeile? Das ist der Parameter "ZpZ" (Zeichen pro Zeile).</li>
1044    <li>Wieviele Zeilen/Posten passen auf die erste Seite? Das
1045     ist der Parameter "ZeS" (Zeilen erste Seite).</li>
1046    <li>Wieviele Zeilen/Posten passen auf die zweite und alle nachfolgenden
1047     Seiten? Das ist der Parameter "ZzS" (Zeilen zweite Seite).</li>
1048   </ol>
1049  </p>
1050
1051  <p>Diese Parameter sind drei Zahlen, die manuell durch Verwendung von langen
1052   Warenbezeichnungen und Rechnungen mit vielen Posten bestimmt werden
1053   m&uuml;ssen.</p>
1054
1055  <p>&Uuml;blicherweise wird in diesem Block zuerst die aktuelle Tabelle
1056   geschlossen, eventuell Text eingef&uuml;gt (z.B. "Fortsetzung auf der
1057   n&auml;chsten Seite"), dann ein Seitenumbruch erzwungen, eventuell Text
1058   eingef&uuml;gt (z.B. "&Uuml;bertrag von der vorherigen Seite:
1059   &lt;%sumcarriedforward%&gt; EUR") und die Tabelle wieder ge&ouml;ffnet.</p>
1060
1061  <p>Wird kein manueller Seitenumbruch gew&uuml;scht, so kann dieser Block
1062   komplett entfallen.</p>
1063
1064  <small><a href="dokumentenvorlagen-und-variablen.html#inhaltsverzeichnis">
1065    zum Inhaltsverzeichnis</a></small><br>
1066  <hr>
1067
1068  <h2><a name="markup">
1069    Markup-Code, der innerhalb von Formularen zur Textformatierung
1070    verwendet werden kann</a></h2>
1071
1072  <p>Wenn der Benutzer innhalb von Formularen in Lx-Office Text anders
1073   formatiert haben m&ouml;chte, so ist dies begrenzt m&ouml;glich. Lx-Office
1074   unterst&uuml;tzt die Textformatierung mit HTML-&auml;hnlichen Tags. Der
1075   Benutzer kann z.B. bei der Artikelbeschreibung auf einer Rechnung Teile des
1076   Texts zwischen Start- und Endtags setzen. Dieser Teil wird dann automatisch
1077   in Anweisungen f&uuml;r das ausgew&auml;hlte Vorlagenformat (HTML oder
1078   PDF &uuml;ber LaTeX) umgesetzt.</p>
1079
1080  <p>Die unterst&uuml;tzen Formatierungen sind:</p>
1081
1082  <p>
1083   <table border="1">
1084    <tr><th>Formatierung</th><th>Auswirkung</th></tr>
1085    <tr>
1086     <td><code>&lt;b&gt;Text&lt;/b&gt;</code></td>
1087     <td>Text wird in <b>fettdruck</b> gesetzt.</td>
1088    </tr>
1089    <tr>
1090     <td><code>&lt;i&gt;Text&lt;/i&gt;</code></td>
1091     <td>Text wird <i>kursiv</i> gesetzt.</td>
1092    </tr>
1093    <tr>
1094     <td><code>&lt;u&gt;Text&lt;/u&gt;</code></td>
1095     <td>Text wird <u>unterstrichen</u>.</td>
1096    </tr>
1097    <tr>
1098     <td><code>&lt;s&gt;Text&lt;/s&gt;</code></td>
1099     <td>Text wird <s>durchgestrichen</s>. Diese Formatierung ist nicht bei der
1100      Ausgabe als PDF &uuml;ber LaTeX verf&uuml;gbar.</td>
1101    </tr>
1102    <tr>
1103     <td><code>&lt;pagebreak&gt;</code></td>
1104     <td>Erzwingt einen Seitenumbruch (siehe unten).</td>
1105    </tr>
1106   </table>
1107  </p>
1108
1109  <p>Eine Besonderheit ist der Befehl <code>&lt;pagebreak&gt;</code>,
1110   der nur in LaTeX-Vorlagen funktioniert und in anderen Vorlagen
1111   einfach gel&ouml;scht wird. Dieser erzwingt unabh&auml;ngig von der
1112   im <a
1113   href="dokumentenvorlagen-und-variablen.html#bloecke_pagebreak">pagebreak-Block</a>
1114   voreingestellten Werte einen Seitenumbruch nach der aktuellen
1115   Rechnungsposition. Dementsprechend funktioniert er nur innerhalb von
1116   <code>&lt;foreach...&gt;</code>-Schleifen. Weiterhin ben&ouml;tigt er kein
1117   Endtag.</p>
1118
1119  <small><a href="dokumentenvorlagen-und-variablen.html#inhaltsverzeichnis">
1120    zum Inhaltsverzeichnis</a></small><br>
1121  <hr>
1122
1123 </body>
1124 </html>