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