doc/dokumentenvorlagen-und-variablen.html

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