X-Git-Url: http://wagnertech.de/git?a=blobdiff_plain;f=doc%2Fdokumentenvorlagen-und-variablen.html;h=16e7fb014afd8c60ab781758692613111a010d71;hb=5b2980ad49f1937786d25f10fa9dac43cf255eb0;hp=4ca82e372ccb577ad93eee4dd417cd88c33816fe;hpb=8f2157619ac4656eabb16fa972846a0e38c98ad0;p=kivitendo-erp.git

diff --git a/doc/dokumentenvorlagen-und-variablen.html b/doc/dokumentenvorlagen-und-variablen.html
index 4ca82e372..16e7fb014 100644
--- a/doc/dokumentenvorlagen-und-variablen.html
+++ b/doc/dokumentenvorlagen-und-variablen.html
@@ -3,7 +3,7 @@
   <title>Dokumentenvorlagen und verf&uuml;gbare Variablen</title>
   <style type="text/css">
   <!--
-.blue { 
+.blue {
            color: #000000;
            background-color: #b0ecff;
            border: 1px solid blue;
@@ -18,7 +18,7 @@ table {
         border-collapse: collapse;
         }
 
-td { 
+td {
      border: 1px solid #be5303;
      padding: 3px;
      }
@@ -48,6 +48,9 @@ td {
   <li><a href="dokumentenvorlagen-und-variablen.html#zuordnung_dateinamen">
     Zuordnung von Dateinamen zu den Funktionen</a></li>
 
+  <li><a href="dokumentenvorlagen-und-variablen.html#tag_style">
+    Anfang und Ende der Tags ver&auml;ndern</a></li>
+
   <li><a href="dokumentenvorlagen-und-variablen.html#allgemeine_variablen">
     Allgemeine Variablen, die in allen Vorlagen vorhanden sind</a><br>
 
@@ -55,6 +58,9 @@ td {
     <li><a href="dokumentenvorlagen-und-variablen.html#allgemein_stammdaten">
       Stammdaten von Kunden und Lieferanten</a></li>
 
+    <li><a href="dokumentenvorlagen-und-variablen.html#allgemein_bearbeiter">
+      Informationen &uuml;ber den Bearbeiter</a></li>
+
     <li><a href="dokumentenvorlagen-und-variablen.html#allgemein_verkaeufer">
       Informationen &uuml;ber den Verk&auml;ufer</a></li>
 
@@ -75,28 +81,44 @@ td {
 
     <li><a href="dokumentenvorlagen-und-variablen.html#invoice_zahlungen">
       Variablen f&uuml;r die Zahlungseing&auml;nge</a></li>
+
+    <li><a href="dokumentenvorlagen-und-variablen.html#invoice_benutzerdefinierte_variablen_vc">
+      Benutzerdefinierte Kunden- und Lieferantenvariablen</a></li>
    </ol>
   </li>
 
-  <li><a href="dokumentenvorlagen-und-variablen.html#anderevorlagen">
-    Variablen in anderen Vorlagen</a></li>
-
-  <li><a href="dokumentenvorlagen-und-variablen.html#bloecke">
-    Bl&ouml;cke, bedingte Anweisungen und Schleifen</a>
+  <li><a href="dokumentenvorlagen-und-variablen.html#dunning">
+    Variablen in Mahnungen und Rechnungen &uuml;ber Mahngeb&uuml;hren</a>
 
    <ol>
-    <li><a href="dokumentenvorlagen-und-variablen.html#bloecke_einschr_latex">
-      Einsch&auml;nkungen f&uuml;r Bl&ouml;cke in LaTeX-Vorlagen</a></li>
+    <li><a href="dokumentenvorlagen-und-variablen.html#dunning_vorlagennamen">
+      Namen der Vorlagen</a></li>
+
+    <li><a href="dokumentenvorlagen-und-variablen.html#dunning_allgemein">
+      Allgemeine Variablen in Mahnungen</a></li>
+
+    <li><a href="dokumentenvorlagen-und-variablen.html#dunning_details">
+      Variablen f&uuml;r jede gemahnte Rechnung in einer Mahnung</a></li>
+
+    <li><a href="dokumentenvorlagen-und-variablen.html#dunning_invoice">
+      Variablen in automatisch erzeugten Rechnungen &uuml;ber Mahngeb&uuml;hren</a></li>
+   </ol>
+  </li>
 
-    <li><a href="dokumentenvorlagen-und-variablen.html#bloecke_einschr_opendocument">
-      Einsch&auml;nkungen f&uuml;r Bl&ouml;cke in OpenDocument-Vorlagen</a></li>
+  <li><a href="dokumentenvorlagen-und-variablen.html#anderevorlagen">
+    Variablen in anderen Vorlagen</a>
 
-    <li><a href="dokumentenvorlagen-und-variablen.html#bloecke_include">
-      Die <code>include</code>-Anweisung</a></li>
+   <ol>
+    <li><a href="dokumentenvorlagen-und-variablen.html#anderevorlagen_quotations">Angebote und Preisanfragen</a></li>
+    <li><a href="dokumentenvorlagen-und-variablen.html#anderevorlagen_orders">Auftragsbest&auml;tigungen und Lieferantenauftr&auml;ge</a></li>
+    <li><a href="dokumentenvorlagen-und-variablen.html#anderevorlagen_delivery_orders">Lieferscheine (Verkauf und Einkauf)</a></li>
+   </ol>
+  </li>
 
-    <li><a href="dokumentenvorlagen-und-variablen.html#bloecke_ifnot">
-      Der <code>if not</code>-Block</a></li>
+  <li><a href="dokumentenvorlagen-und-variablen.html#bloecke">
+    Bl&ouml;cke, bedingte Anweisungen und Schleifen</a>
 
+   <ol>
     <li><a href="dokumentenvorlagen-und-variablen.html#bloecke_if">
       Der <code>if</code>-Block</a></li>
 
@@ -121,7 +143,11 @@ td {
  <p>Dies ist eine Auflistung der Standard-Dokumentenvorlagen und aller
   zur Bearbeitung verf&uuml;gbaren Variablen. Eine Variable wird in
   einer Vorlage durch ihren Inhalt ersetzt, wenn sie in der Form
-  <code>&lt;%variablenname%&gt;</code> verwendet wird.</p>
+  <code>&lt;%variablenname%&gt;</code> verwendet wird. F&uuml;r LaTeX-
+  und HTML-Vorlagen kann man die Form dieser Tags auch
+  <a href="dokumentenvorlagen-und-variablen.html#tag_style">
+   ver&auml;ndern</a>.
+ </p>
 
  <p>Fr&uuml;her wurde hier nur &uuml;ber LaTeX gesprochen. Inzwischen
   unterst&uuml;tzt Lx-Office aber auch OpenDocument-Vorlagen. Sofern
@@ -156,6 +182,36 @@ td {
    zum Inhaltsverzeichnis</a></small><br>
  <hr>
 
+ <h2><a name="tag_style">
+   Anfang und Ende der Tags ver&auml;ndern</a></h2>
+
+ <p>Der Standardstil f&uuml;r Tags sieht vor, dass ein Tag mit dem
+  Kleinerzeichen und einem Prozentzeichen beginnt und mit dem
+  Prozentzeichen und dem Gr&ouml;&szlig;erzeichen endet,
+  beispielsweise <code>&lt;%customer%&gt;</code>. Da diese Form aber
+  z.B. in LaTeX zu Problemen f&uuml;hren kann, weil das Prozentzeichen
+  dort Kommentare einleitet, kann pro HTML- oder
+  LaTeX-Dokumentenvorlage der Stil umgestellt werden.</p>
+
+ <p>Dazu werden in die Datei Zeilen geschrieben, die mit dem f&uuml;r
+  das Format g&uuml;ltigen Kommentarzeichen anfangen,
+  dann <code>config:</code> enthalten, die entsprechende Option setzen
+  und bei HTML-Dokumentenvorlagen mit dem Kommentarendzeichen
+  enden. Beispiel f&uuml;r LaTeX:</p>
+
+ <p><code>% config: tag-style=($ $)</code></p>
+
+ <p>Dies w&uuml;rde Lx-Office dazu veranlassen, Variablen zu ersetzen,
+  wenn sie wie folgt aussehen: <code>($customer$)</code>. Das
+  &auml;quivalente Beispiel f&uuml;r HTML-Dokumentenvorlagen sieht so
+  aus:</p>
+
+ <p><code>&lt;!-- config: tag-stye=($ $)&gt;</code></p>
+
+ <small><a href="dokumentenvorlagen-und-variablen.html#inhaltsverzeichnis">
+   zum Inhaltsverzeichnis</a></small><br>
+ <hr>
+
  <h2><a name="zuordnung_dateinamen">
    Zuordnung von den Dateinamen zu den Funktionen</a></h2>
 
@@ -164,17 +220,66 @@ td {
   geeignet zu ersetzen: &quot;.tex&quot; f&uuml; LaTeX-Vorlagen und
   &quot;.odt&quot; f&uuml;r OpenDocument-Vorlagen.</p>
 
- <ul>
-  <li><code>bin_list.ext</code> -- Lagerliste</li>
-  <li><code>check.ext</code> -- ?</li>
-  <li><code>invoice.ext</code> -- Rechnung</li>
-  <li><code>packing_list.ext</code> -- Verpackungsliste</li>
-  <li><code>pick_list.ext</code> -- Sammelliste</li>
-  <li><code>purcharse_order.ext</code> -- Bestellung an Lieferanten</li>
-  <li><code>request_quotation.ext</code> -- Anfrage an Lieferanten</li>
-  <li><code>sales_order.ext</code> -- Bestellung</li>
-  <li><code>sales_quotation.ext</code> -- Angebot an Kunden</li>
- </ul>
+ <p>
+  <table border="1">
+   <tr>
+    <th>Dateiname</th>
+    <th>Bedeutung</th>
+   </tr>
+   <tr>
+    <td><code>bin_list.ext</code></td>
+    <td>Lagerliste</td>
+   </tr>
+   <tr>
+    <td><code>check.ext</code></td>
+    <td>?</td>
+   </tr>
+   <tr>
+    <td><code>invoice.ext</code></td>
+    <td>Rechnung</td>
+   </tr>
+   <tr>
+    <td><code>packing_list.ext</code></td>
+    <td>Verpackungsliste</td>
+   </tr>
+   <tr>
+    <td><code>pick_list.ext</code></td>
+    <td>Sammelliste</td>
+   </tr>
+   <tr>
+    <td><code>purchase_delivery_order.ext</code></td>
+    <td>Lieferschein (Einkauf)</td>
+   </tr>
+   <tr>
+    <td><code>purcharse_order.ext</code></td>
+    <td>Bestellung an Lieferanten</td>
+   </tr>
+   <tr>
+    <td><code>request_quotation.ext</code></td>
+    <td>Anfrage an Lieferanten</td>
+   </tr>
+   <tr>
+    <td><code>sales_delivery_order.ext</code></td>
+    <td>Lieferschein (Verkauf)</td>
+   </tr>
+   <tr>
+    <td><code>sales_order.ext</code></td>
+    <td>Bestellung</td>
+   </tr>
+   <tr>
+    <td><code>sales_quotation.ext</code></td>
+    <td>Angebot an Kunden</td>
+   </tr>
+   <tr>
+    <td><code>zahlungserinnerung.ext</code></td>
+    <td>Mahnung (Dateiname im Programm konfigurierbar)</td>
+   </tr>
+   <tr>
+    <td><code>zahlungserinnerung_invoice.ext</code></td>
+    <td>Rechnung &uuml;ber Mahngeb&uuml;hren (Dateiname im Programm konfigurierbar)</td>
+   </tr>
+  </table>
+ </p>
 
  <small><a href="dokumentenvorlagen-und-variablen.html#inhaltsverzeichnis">
    zum Inhaltsverzeichnis</a></small><br>
@@ -201,9 +306,13 @@ td {
     <td><code>bank_code</code></td>
     <td>Bankleitzahl</td>
    </tr>
+   <tr>
+    <td><code>bic</code></td>
+    <td>Bank-Identifikations-Code (Bank Identifier Code, BIC)</td>
+   </tr>
    <tr>
     <td><code>business</code></td>
-    <td>Kundentyp</td>
+    <td>Kunden-/Lieferantentyp</td>
    </tr>
    <tr>
     <td><code>city</code></td>
@@ -250,13 +359,25 @@ td {
     <td>Kreditlimit</td>
    </tr>
    <tr>
-    <td><code>customernumber</code></td>
-    <td>Kundennummer; nur f&uuml;r Kunden</td>
+    <td><code>customeremail</code></td>
+    <td>Email des Kunden; nur f&uuml;r Kunden</td>
+   </tr>
+   <tr>
+    <td><code>customerfax</code></td>
+    <td>Faxnummer des Kunden; nur f&uuml;r Kunden</td>
    </tr>
    <tr>
     <td><code>customernotes</code></td>
     <td>Bemerkungen beim Kunden; nur f&uuml;r Kunden</td>
    </tr>
+   <tr>
+    <td><code>customernumber</code></td>
+    <td>Kundennummer; nur f&uuml;r Kunden</td>
+   </tr>
+   <tr>
+    <td><code>customerphone</code></td>
+    <td>Telefonnummer des Kunden; nur f&uuml;r Kunden</td>
+   </tr>
    <tr>
     <td><code>discount</code></td>
     <td>Rabatt</td>
@@ -273,6 +394,10 @@ td {
     <td><code>homepage</code></td>
     <td>Homepage</td>
    </tr>
+   <tr>
+    <td><code>iban</code></td>
+    <td>Internationale Kontonummer (International Bank Account Number, IBAN)</td>
+   </tr>
    <tr>
     <td><code>language</code></td>
     <td>Sprache</td>
@@ -281,6 +406,10 @@ td {
     <td><code>name</code></td>
     <td>Firmenname</td>
    </tr>
+   <tr>
+    <td><code>payment_terms</code></td>
+    <td>Zahlungskonditionen</td>
+   </tr>
    <tr>
     <td><code>phone</code></td>
     <td>Telefonnummer</td>
@@ -332,7 +461,7 @@ td {
    </tr>
    <tr>
     <td><code>shiptostreet</code></td>
-    <td>Straße und Hausnummer (Lieferadresse)
+    <td>Stra&szlig;e und Hausnummer (Lieferadresse)
      <a href="dokumentenvorlagen-und-variablen.html#anmerkung_shipto">*</a></td>
    </tr>
    <tr>
@@ -342,16 +471,12 @@ td {
    </tr>
    <tr>
     <td><code>street</code></td>
-    <td>Straße und Hausnummer</td>
+    <td>Stra&szlig;e und Hausnummer</td>
    </tr>
    <tr>
     <td><code>taxnumber</code></td>
     <td>Steuernummer</td>
    </tr>
-   <tr>
-    <td><code>terms</code></td>
-    <td>Zahlungsziel</td>
-   </tr>
    <tr>
     <td><code>vendoremail</code></td>
     <td>Email des Lieferanten; nur f&uuml;r Lieferanten</td>
@@ -387,8 +512,8 @@ td {
   sondern schlicht Kopien der Lieferdatenvariablen sind
   (z.B. <code>shiptocontact</code>).</p>
 
- <h3><a name="allgemein_verkaeufer">
-   Informationen &uuml;ber den Verkäufer:</a></h3>
+ <h3><a name="allgemein_bearbeiter">
+   Informationen &uuml;ber den Bearbeiter:</a></h3>
 
  <p>
   <table border="1">
@@ -405,6 +530,14 @@ td {
     <td><code>employee_company</code></td>
     <td>Firmenname</td>
    </tr>
+   <tr>
+    <td><code>employee_co_ustid</code></td>
+    <td>Usatzsteuer-Identifikationsnummer</td>
+   </tr>
+   <tr>
+    <td><code>employee_duns</code></td>
+    <td>DUNS-Nummer</td>
+   </tr>
    <tr>
     <td><code>employee_email</code></td>
     <td>Email</td>
@@ -421,6 +554,10 @@ td {
     <td><code>employee_signature</code></td>
     <td>Signatur</td>
    </tr>
+   <tr>
+    <td><code>employee_taxnumber</code></td>
+    <td>Steuernummer</td>
+   </tr>
    <tr>
     <td><code>employee_tel</code></td>
     <td>Telefonnummer</td>
@@ -428,6 +565,59 @@ td {
   </table>
  </p>
 
+ <h3><a name="allgemein_verkaeufer">
+   Informationen &uuml;ber den Verk&auml;ufer (nur bei Verkaufsmasken):</a></h3>
+
+ <p>
+  <table border="1">
+   <tr><th>Variablenname</th><th>Bedeutung</th></tr>
+   <tr>
+    <td><code>salesman_address</code></td>
+    <td>Adressfeld</td>
+   </tr>
+   <tr>
+    <td><code>salesman_businessnumber</code></td>
+    <td>Firmennummer</td>
+   </tr>
+   <tr>
+    <td><code>salesman_company</code></td>
+    <td>Firmenname</td>
+   </tr>
+   <tr>
+    <td><code>salesman_co_ustid</code></td>
+    <td>Usatzsteuer-Identifikationsnummer</td>
+   </tr>
+   <tr>
+    <td><code>salesman_duns</code></td>
+    <td>DUNS-Nummer</td>
+   </tr>
+   <tr>
+    <td><code>salesman_email</code></td>
+    <td>Email</td>
+   </tr>
+   <tr>
+    <td><code>salesman_fax</code></td>
+    <td>Fax</td>
+   </tr>
+   <tr>
+    <td><code>salesman_name</code></td>
+    <td>voller Name</td>
+   </tr>
+   <tr>
+    <td><code>salesman_signature</code></td>
+    <td>Signatur</td>
+   </tr>
+   <tr>
+    <td><code>salesman_taxnumber</code></td>
+    <td>Steuernummer</td>
+   </tr>
+   <tr>
+    <td><code>salesman_tel</code></td>
+    <td>Telefonnummer</td>
+   </tr>
+  </table>
+ </p>
+
  <h3><a name="allgemein_steuern">
    Variablen f&uuml;r die einzelnen Steuern:</a></h3>
 
@@ -470,7 +660,7 @@ td {
    </tr>
    <tr>
     <td><code>currency</code></td>
-    <td>Währung</td>
+    <td>W&auml;hrung</td>
    </tr>
    <tr>
     <td><code>cusordnumber</code></td>
@@ -482,7 +672,11 @@ td {
    </tr>
    <tr>
     <td><code>duedate</code></td>
-    <td>Fälligkeitsdatum</td>
+    <td>F&auml;lligkeitsdatum</td>
+   </tr>
+   <tr>
+    <td><code>globalprojectnumber</code></td>
+    <td>Projektnummer des ganzen Beleges</td>
    </tr>
    <tr>
     <td><code>intnotes</code></td>
@@ -504,10 +698,22 @@ td {
     <td><code>notes</code></td>
     <td>Bemerkungen der Rechnung</td>
    </tr>
+   <tr>
+    <td><code>orddate</code></td>
+    <td>Auftragsdatum</td>
+   </tr>
    <tr>
     <td><code>ordnumber</code></td>
     <td>Auftragsnummer, wenn die Rechnung aus einem Auftrag erstellt wurde</td>
    </tr>
+   <tr>
+    <td><code>payment_terms</code></td>
+    <td>Zahlungskonditionen</td>
+   </tr>
+   <tr>
+    <td><code>quodate</code></td>
+    <td>Angebotsdatum</td>
+   </tr>
    <tr>
     <td><code>quonumber</code></td>
     <td>Angebotsnummer</td>
@@ -534,6 +740,10 @@ td {
     <td><code>total</code></td>
     <td>Restsumme der Rechnung (Summe abz&uuml;glich bereits bezahlter Posten)</td>
    </tr>
+   <tr>
+    <td><code>transaction_description</code></td>
+    <td>Vorgangsbezeichnung</td>
+   </tr>
    <tr>
     <td><code>transdate</code></td>
     <td>Auftragsdatum wenn die Rechnung aus einem Auftrag erstellt wurde</td>
@@ -547,18 +757,10 @@ td {
  <p>
   <table border="1">
    <tr><th>Variablenname</th><th>Bedeutung</th></tr>
-   <tr>
-    <td><code>assembly</code></td>
-    <td>Erzeugnis</td>
-   </tr>
    <tr>
     <td><code>bin</code></td>
     <td>Stellage</td>
    </tr>
-   <tr>
-    <td><code>deliverydate_oe</code></td>
-    <td>Lieferdatum</td>
-   </tr>
    <tr>
     <td><code>description</code></td>
     <td>Artikelbeschreibung</td>
@@ -567,18 +769,46 @@ td {
     <td><code>discount</code></td>
     <td>Rabatt als Betrag</td>
    </tr>
+   <tr>
+    <td><code>discount_sub</code></td>
+    <td>Zwischensumme mit Rabatt</td>
+   </tr>
+   <tr>
+    <td><code>drawing</code></td>
+    <td>Zeichnung</td>
+   </tr>
+   <tr>
+    <td><code>ean</code></td>
+    <td>EAN-Code</td>
+   </tr>
+   <tr>
+    <td><code>image</code></td>
+    <td>Grafik</td>
+   </tr>
    <tr>
     <td><code>linetotal</code></td>
     <td>Zeilensumme (Anzahl * Einzelpreis)</td>
    </tr>
    <tr>
-    <td><code>listprice</code></td>
-    <td>Listenpreis</td>
+    <td><code>longdescription</code></td>
+    <td>Langtext</td>
+   </tr>
+   <tr>
+    <td><code>microfiche</code></td>
+    <td>Mikrofilm</td>
    </tr>
    <tr>
     <td><code>netprice</code></td>
     <td>Nettopreis</td>
    </tr>
+   <tr>
+    <td><code>nodiscount_linetotal</code></td>
+    <td>Zeilensumme ohne Rabatt</td>
+   </tr>
+   <tr>
+    <td><code>nodiscount_sub</code></td>
+    <td>Zwischensumme ohne Rabatt</td>
+   </tr>
    <tr>
     <td><code>number</code></td>
     <td>Artikelnummer</td>
@@ -599,6 +829,14 @@ td {
     <td><code>partsgroup</code></td>
     <td>Warengruppe</td>
    </tr>
+   <tr>
+    <td><code>price_factor</code></td>
+    <td>Der Preisfaktor als Zahl, sofern einer eingestellt ist</td>
+   </tr>
+   <tr>
+    <td><code>price_factor_name</code></td>
+    <td>Der Name des Preisfaktors, sofern einer eingestellt ist</td>
+   </tr>
    <tr>
     <td><code>projectnumber</code></td>
     <td>Projektnummer</td>
@@ -607,6 +845,10 @@ td {
     <td><code>qty</code></td>
     <td>Anzahl</td>
    </tr>
+   <tr>
+    <td><code>reqdate</code></td>
+    <td>Lieferdatum</td>
+   </tr>
    <tr>
     <td><code>runningnumber</code></td>
     <td>Position auf der Rechnung (1, 2, 3...)</td>
@@ -627,38 +869,241 @@ td {
     <td><code>unit</code></td>
     <td>Einheit</td>
    </tr>
+   <tr>
+    <td><code>weight</code></td>
+    <td>Gewicht</td>
+   </tr>
+  </table>
+ </p>
+
+ <p>F&uuml;r jeden Posten gibt es ein Unterarray mit den Informationen &uuml;ber
+  Lieferanten und Lieferantenartikelnummer. Diese m&uuml;ssen mit
+  einer <code>foreach</code>-Schleife ausgegeben werden, da f&uuml;r jeden
+  Artikel mehrere Lieferanteninformationen hinterlegt sein k&ouml;nnen. Die
+  Variablen daf&uuml;r lauten:</p>
+
+ <p>
+  <table border="1">
+   <tr><th>Variablenname</th><th>Bedeutung</th></tr>
+   <tr>
+    <td><code>make</code></td>
+    <td>Lieferant</td>
+   </tr>
+   <tr>
+    <td><code>model</code></td>
+    <td>Lieferantenartikelnummer</td>
+   </tr>
   </table>
  </p>
 
  <h3><a name="invoice_zahlungen">
-   Variablen f&uuml;r die einzelnen Zahlungseingänge:</a></h3>
+   Variablen f&uuml;r die einzelnen Zahlungseing&auml;nge:</a></h3>
 
  <p>
   <table border="1">
    <tr><th>Variablenname</th><th>Bedeutung</th></tr>
    <tr>
-    <td><code>datepaid</code></td>
+    <td><code>payment</code></td>
+    <td>Betrag</td>
+   </tr>
+   <tr>
+    <td><code>paymentaccount</code></td>
+    <td>Konto</td>
+   </tr>
+   <tr>
+    <td><code>paymentdate</code></td>
     <td>Datum</td>
    </tr>
    <tr>
-    <td><code>memo</code></td>
+    <td><code>paymentmemo</code></td>
     <td>Memo</td>
    </tr>
    <tr>
-    <td><code>paid</code></td>
-    <td>Betrag</td>
+    <td><code>paymentsource</code></td>
+    <td>Beleg</td>
+   </tr>
+  </table>
+ </p>
+
+ <h3><a name="invoice_benutzerdefinierte_variablen_vc">
+   Benutzerdefinierte Kunden- und Lieferantenvariablen:</a></h3>
+
+ <p>
+  Die vom Benutzer definierten Variablen f&uuml;r Kunden und
+  Lieferanten stehen beim Ausdruck von Einkaufs- und Verkaufsbelegen
+  ebenfalls zur Verf&uuml;gung. Ihre Namen setzen sich aus dem
+  Pr&auml;fix <code>vc_cvar_</code> und dem vom Benutzer festgelegten
+  Variablennamen zusammen.</p>
+
+ <p>Beispiel: Der Benutzer hat eine Variable
+  namens <code>number_of_employees</code> definiert, die die Anzahl
+  der Mitarbeiter des Unternehmens enth&auml;lt. Diese Variable steht
+  dann unter dem Namen <code>vc_cvar_number_of_employees</code> zur
+  Verf&uuml;gung.</p>
+
+ <small><a href="dokumentenvorlagen-und-variablen.html#inhaltsverzeichnis">
+   zum Inhaltsverzeichnis</a></small><br>
+ <hr>
+
+ <h2><a name="dunning">Variablen in Mahnungen und Rechnungen &uuml;ber Mahngeb&uuml;hren</a></h2>
+
+ <h3><a name="dunning_vorlagennamen">Namen der Vorlagen</a></h3>
+
+ <p>Die Namen der Vorlagen werden im System-Men&uuml; vom Benutzer
+  eingegeben. Wird f&uuml;r ein Mahnlevel die Option zur automatischen
+  Erstellung einer Rechnung &uuml;ber die Mahngeb&uuml;hren und Zinsen
+  aktiviert, so wird der Name der Vorlage f&uuml;r diese Rechnung aus
+  dem Vorlagenname f&uuml;r diese Mahnstufe mit dem
+  Zusatz <code>_invoice</code> gebildet. Weiterhin werden die
+  K&uuml;rzel f&uuml;r die ausgew&auml;hlte Sprache und den
+  ausgew&auml;hlten Drucker angeh&auml;ngt.</p>
+
+ <h3><a name="dunning_allgemein">Allgemeine Variablen in Mahnungen:</a></h3>
+
+ <p>Die Variablen des Verk&auml;ufers stehen wie gewohnt
+  als <code>employee_...</code> zur Verf&uuml;gung. Die Adressdaten des
+  Kunden stehen als Variablen <code>name</code>, <code>street</code>,
+  <code>zipcode</code>, <code>city</code>, <code>country</code>,
+  <code>department_1</code>, <code>department_2</code>, und
+  <code>email</code> zur Verf&uuml;gung.
+ </p>
+
+ <p>Weitere Variablen beinhalten:</p>
+
+ <p>
+  <table border="1">
+   <tr><th>Variablenname</th><th>Bedeutung</th></tr>
+   <tr>
+    <td><code>dunning_date</code></td>
+    <td>Datum der Mahnung</td>
    </tr>
    <tr>
-    <td><code>source</code></td>
-    <td>Beleg</td>
+    <td><code>dunning_duedate</code></td>
+    <td>F&auml;lligkeitsdatum f&uuml;r diese Mahhnung</td>
    </tr>
    <tr>
-    <td><code>exchangerate</code></td>
-    <td>Wechselkurs</td>
+    <td><code>fee</code></td>
+    <td>Kummulative Mahngeb&uuml;hren</td>
    </tr>
    <tr>
-    <td><code>forex</code></td>
-    <td>Konto</td>
+    <td><code>interest_rate</code></td>
+    <td>Zinssatz per anno in Prozent</td>
+   </tr>
+   <tr>
+    <td><code>total_amount</code></td>
+    <td>Gesamter noch zu zahlender Betrag als <code>fee</code> + <code>total_interest</code> + <code>total_open_amount</code></td>
+   </tr>
+   <tr>
+    <td><code>total_interest</code></td>
+    <td>Zinsen per anno &uuml;ber alle Rechnungen</td>
+   </tr>
+   <tr>
+    <td><code>total_open_amount</code></td>
+    <td>Summe &uuml;ber alle offene Betr&auml;ge der Rechnungen</td>
+   </tr>
+  </table>
+ </p>
+
+ <h3><a name="dunning_details">
+   Variablen f&uuml;r jede gemahnte Rechnung in einer Mahnung:</a></h3>
+
+ <p>
+  <table border="1">
+   <tr><th>Variablenname</th><th>Bedeutung</th></tr>
+   <tr>
+    <td><code>dn_amount</code></td>
+    <td>Rechnungssumme (brutto)</td>
+   </tr>
+   <tr>
+    <td><code>dn_duedate</code></td>
+    <td>Originales F&auml;lligkeitsdatum der Rechnung</td>
+   </tr>
+   <tr>
+    <td><code>dn_dunning_date</code></td>
+    <td>Datum der Mahnung</td>
+   </tr>
+   <tr>
+    <td><code>dn_dunning_duedate</code></td>
+    <td>F&auml;lligkeitsdatum der Mahnung</td>
+   </tr>
+   <tr>
+    <td><code>dn_fee</code></td>
+    <td>Kummulative Mahngeb&uuml;hr</td>
+   </tr>
+   <tr>
+    <td><code>dn_interest</code></td>
+    <td>Zinsen per anno f&uuml;r diese Rechnung</td>
+   </tr>
+   <tr>
+    <td><code>dn_invnumber</code></td>
+    <td>Rechnungsnummer</td>
+   </tr>
+   <tr>
+    <td><code>dn_linetotal</code></td>
+    <td>Noch zu zahlender Betrag (ergibt sich aus <code>dn_open_amount + dn_fee + dn_interest</code>)</td>
+   </tr>
+   <tr>
+    <td><code>dn_netamount</code></td>
+    <td>Rechnungssumme (netto)</td>
+   </tr>
+   <tr>
+    <td><code>dn_open_amount</code></td>
+    <td>Offener Rechnungsbetrag</td>
+   </tr>
+   <tr>
+    <td><code>dn_ordnumber</code></td>
+    <td>Bestellnummer</td>
+   </tr>
+   <tr>
+    <td><code>dn_transdate</code></td>
+    <td>Rechnungsdatum</td>
+   </tr>
+  </table>
+ </p>
+
+ <h3><a name="dunning_invoice">Variablen in automatisch erzeugten
+   Rechnungen &uuml;ber Mahngeb&uuml;hren</a></h3>
+
+ <p>Die Variablen des Verk&auml;ufers stehen wie gewohnt
+  als <code>employee_...</code> zur Verf&uuml;gung. Die Adressdaten des
+  Kunden stehen als Variablen <code>name</code>, <code>street</code>,
+  <code>zipcode</code>, <code>city</code>, <code>country</code>,
+  <code>department_1</code>, <code>department_2</code>, und
+  <code>email</code> zur Verf&uuml;gung.
+ </p>
+
+ <p>Weitere Variablen beinhalten:</p>
+
+ <p>
+  <table border="1">
+   <tr><th>Variablenname</th><th>Bedeutung</th></tr>
+   <tr>
+    <td><code>duedate</code></td>
+    <td>F&auml;lligkeitsdatum der Rechnung</td>
+   </tr>
+   <tr>
+    <td><code>dunning_id</code></td>
+    <td>Mahnungsnummer</td>
+   </tr>
+   <tr>
+    <td><code>fee</code></td>
+    <td>Mahngeb&uuml;hren</td>
+   </tr>
+   <tr>
+    <td><code>interest</code></td>
+    <td>Zinsen</td>
+   </tr>
+   <tr>
+    <td><code>invamount</code></td>
+    <td>Rechnungssumme (ergibt sich aus <code>fee + interest</code>)</td>
+   </tr>
+   <tr>
+    <td><code>invdate</code></td>
+    <td>Rechnungsdatum</td>
+   </tr>
+   <tr>
+    <td><code>invnumber</code></td>
+    <td>Rechnungsnummer</td>
    </tr>
   </table>
  </p>
@@ -682,78 +1127,184 @@ td {
   Variablen, die vom Gesch&auml;ftsablauf her in der entsprechenden Vorlage
   keine Bedeutung haben oder noch nicht belegt sein k&ouml;nnen.</p>
 
- <small><a href="dokumentenvorlagen-und-variablen.html#inhaltsverzeichnis">
-   zum Inhaltsverzeichnis</a></small><br>
- <hr>
-
- <h2><a name="bloecke">
-   Bl&ouml;cke, bedingte Anweisungen und Schleifen</a></h2>
-
- <p>Der Parser kennt neben den Variablen einige weitere Konstrukte, die
-  gesondert behandelt werden. Diese sind wie Variablennamen in spezieller
-  Weise markiert: <code>&lt;%anweisung%&gt;</code></p>
-
- <h3><a name="bloecke_einschr_latex">
-   Einsch&auml;nkungen f&uuml;r Bl&ouml;cke in LaTeX-Vorlagen</a></h3>
+ <p>Im Folgenden werden nur wichtige Unterschiede zu den Variablen in
+  Rechnungen aufgef&uuml;hrt.</p>
 
- <p>Achtung: Bl&ouml;cke k&ouml;nnen in LaTeX-Vorlagen momentan nicht
-   verschachtelt werden. Das bedeutet, dass innerhalb einer
-   <code>&lt;%foreach%&gt;</code>-Schleife keine
-   <code>&lt;%if%&gt;</code>-Abfragen verwendet werden k&ouml;nnen. Dieses
-   kann man aber mit LaTeX-Bordmitteln selber nachgebildet werden. Dazu muss
-   im Vorspann das Paket <code>ifthen</code> eingebunden werden. Das Konstrukt
-   selber sieht dann wie folgt aus:</p>
+ <h3><a name="anderevorlagen_quotations">Angebote und Preisanfragen</a></h3>
 
- <p class="blue"><code>\ifthenelse{\equal{&lt;%variable%&gt;}{}}{}{Dieser
-   Text erscheint nur, wenn &lt;%variable%&gt; nicht leer ist.}</code></p>
+ <p>
+  <table border="1">
+   <tr><th>Variablenname</th><th>Bedeutung</th></tr>
+   <tr>
+    <td><code>quonumber</code></td>
+    <td>Angebots- bzw. Anfragenummer</td>
+   </tr>
+   <tr>
+    <td><code>reqdate</code></td>
+    <td>G&uuml;ltigkeitsdatum (bei Angeboten) bzw. Lieferdatum (bei Preisanfragen)</td>
+   </tr>
+   <tr>
+    <td><code>transdate</code></td>
+    <td>Angebots- bzw. Anfragedatum</td>
+   </tr>
+  </table>
+ </p>
 
- <h3><a name="bloecke_einschr_opendocument">
-   Einsch&auml;nkungen f&uuml;r Bl&ouml;cke in OpenDocument-Vorlagen</a></h3>
+ <h3><a name="anderevorlagen_orders">Auftragsbest&auml;tigungen und Lieferantenauftr&auml;ge</a></h3>
 
- <p>Die eben erw&auml;hnten Einschr&auml;nkungen f&uuml;r
-  LaTeX-Vorlagen gelten in abgeschw&auml;chter Form auch f&uuml;r
-  OpenDocument-Vorlagen. Auch bei OpenDocument-Vorlagen k&ouml;nnen
-  Bl&ouml;cke nicht verschachtelt werden. Einzige Ausnahme ist, dass
-  <code>&lt;if&gt;</code> und
-  <code>&lt;ifnot&gt;</code>-Bl&ouml;cke innerhalb von
-  <code>&lt;foreach&gt;</code>-Bl&ouml;cken auftreten
-  d&uuml;rfen.</p>
+ <p>
+  <table border="1">
+   <tr><th>Variablenname</th><th>Bedeutung</th></tr>
+   <tr>
+    <td><code>ordnumber</code></td>
+    <td>Auftragsnummer</td>
+   </tr>
+   <tr>
+    <td><code>reqdate</code></td>
+    <td>Lieferdatum</td>
+   </tr>
+   <tr>
+    <td><code>transdate</code></td>
+    <td>Auftragsdatum</td>
+   </tr>
+  </table>
+ </p>
 
- <h3><a name="bloecke_include">Die <code>include</code>-Anweisung</a></h3>
+ <h3><a name="anderevorlagen_delivery_orders">Lieferscheine (Verkauf und Einkauf)</a></h3>
 
- <p class="blue"><code>&lt;%include dateiname.ext%&gt;</code></p>
+ <p>
+  <table border="1">
+   <tr><th>Variablenname</th><th>Bedeutung</th></tr>
+   <tr>
+    <td><code>donumber</code></td>
+    <td>Lieferscheinnummer</td>
+   </tr>
+   <tr>
+    <td><code>transdate</code></td>
+    <td>Lieferscheindatum</td>
+   </tr>
+  </table>
+ </p>
 
- <p>Dieser Block funktioniert nur in LaTeX- und HTML-Vorlagen.</p>
+ <p>F&uuml;r jede Position eines Lieferscheines gibt es ein Unterarray mit
+  den Informationen dar&uuml;ber, von welchem Lager und Lagerplatz aus die
+  Waren verschickt wurden (Verkaufslieferscheine) bzw. auf welchen
+  Lagerplatz sie eingelagert wurden. Diese m&uuml;ssen mittels
+  einer <code>foreach</code>-Schleife ausgegeben werden. Diese
+  Variablen sind:</p>
 
- <p>F&uuml;gt den Inhalt einer Datei an der entsprechenden Stelle ein. Der
-  eingef&uuml;gte Text wird ganz normal durch den Parser behandelt und kann
-  Variablen und Bl&ouml;cke enthalten.</p>
+ <p>
+  <table border="1">
+   <tr><th>Variablenname</th><th>Bedeutung</th></tr>
+   <tr>
+    <td><code>si_bin</code></td>
+    <td>Lagerplatz</td>
+   </tr>
+   <tr>
+    <td><code>si_chargenumber</code></td>
+    <td>Chargennummer</td>
+   </tr>
+   <tr>
+    <td><code>si_number</code></td>
+    <td>Artikelnummer</td>
+   </tr>
+   <tr>
+    <td><code>si_qty</code></td>
+    <td>Anzahl bzw. Menge</td>
+   </tr>
+   <tr>
+    <td><code>si_runningnumber</code></td>
+    <td>Positionsnummer (1, 2, 3 etc)</td>
+   </tr>
+   <tr>
+    <td><code>si_unit</code></td>
+    <td>Einheit</td>
+   </tr>
+   <tr>
+    <td><code>si_warehouse</code></td>
+    <td>Lager</td>
+   </tr>
+  </table>
+ </p>
 
- <h3><a name="bloecke_ifnot">Der <code>if not</code>-Block</a></h3>
+ <small><a href="dokumentenvorlagen-und-variablen.html#inhaltsverzeichnis">
+   zum Inhaltsverzeichnis</a></small><br>
+ <hr>
 
- <p class="blue"><code>&lt;%if not variablenname%&gt;<br>
-   ...<br>
-   &lt;%end if&gt;</code></p>
+ <h2><a name="bloecke">
+   Bl&ouml;cke, bedingte Anweisungen und Schleifen</a></h2>
 
- <p>Eine normale "if-not-then"-Bedingung. Die Zeilen zwischen dem "if not" und
-  dem "end" werden nur ausgegeben, wenn die Variable "variablenname" nicht
-  gesetzt oder gleich 0 ist.</p>
+ <p>Der Parser kennt neben den Variablen einige weitere Konstrukte,
+  die gesondert behandelt werden. Diese sind wie Variablennamen in
+  spezieller Weise markiert: <code>&lt;%anweisung%&gt;
+  ... &lt;%end%&gt;</code></p>
+
+ <p>Anmerkung zum <code>&lt;%end%&gt;</code>: Der besseren
+  Verständlichkeit halber kann man nach dem <code>end</code> noch
+  beliebig weitere Wörter schreiben, um so zu markieren, welche
+  Anweisung (z.B. <code>if</code> oder <code>foreach</code>) damit
+  abgeschlossen wird.</p>
+
+ <p>Beispiel: Lautet der Beginn eines Blockes
+   z.B. <code class="blue">&lt;%if type ==
+   &quot;sales_quotation&quot;%&gt;</code>, so könnte er mit
+  <code class="blue">&lt;%end%&gt;</code> genauso abgeschlossen werden
+  wie mit
+  <code class="blue">&lt;%end if%&gt;</code> oder auch
+  <code class="blue">&lt;%end type ==
+  &quot;sales_quotation&quot;%&gt;</code>.</p>
 
  <h3><a name="bloecke_if">Der <code>if</code>-Block</a></h3>
 
  <p class="blue"><code>&lt;%if variablenname%&gt;<br>
    ...<br>
-   &lt;%end if&gt;</code></p>
-
- <p>Eine normale "if-then"-Bedingung. Die Zeilen zwischen dem "if" und dem
-  "end" werden nur ausgegeben, wenn die Variable "variablenname" gesetzt und
-  ungleich 0 ist.</p>
+   &lt;%end%&gt;</code></p>
+
+ <p>Eine normale &quot;if-then&quot;-Bedingung. Die Zeilen zwischen
+  dem &quot;if&quot; und dem &quot;end&quot; werden nur ausgegeben,
+  wenn die Variable &quot;variablenname&quot; gesetzt und ungleich 0
+  ist.</p>
+
+ <p>Die Bedingung kann auch negiert werden, indem das Wort
+  &quot;not&quot; nach dem &quot;if&quot; verwendet
+  wird. Beispiel: <code class="blue">&lt;%if not
+  cp_greeting%&gt;</code></p>
+
+ <p>Zusätzlich zu dem einfachen Test, ob eine Variable gesetzt ist
+  oder nicht, bietet dieser Block auch die Möglichkeit, den Inhalt
+  einer Variablen mit einer festen Zeichenkette oder einer anderen
+  Variablen zu vergleichen. Ob der Vergleich mit einer Zeichenkette
+  oder einer anderen Variablen vorgenommen wird, hängt davon ab, ob
+  die rechte Seite des Vergleichsoperators in Anführungszeichen
+  gesetzt wird (Vergleich mit Zeichenkette) oder nicht (Vergleich mit
+  anderer Variablen). Zwei Beispiele, die beide Vergleiche zeigen:</p>
+
+ <p><code class="blue">&lt;%if var1 == &quot;Wert&quot;%&gt;</code>
+  testet die Variable &quot;var1&quot; auf Übereinstimmung mit der
+  Zeichenkette &quot;Wert&quot;. Mittels &quot;!=&quot; anstelle von
+  &quot;==&quot; würde auf Ungleichheit getestet.</p>
+
+ <p><code class="blue">&lt;%if var1 == var2%&gt;</code> testet die
+  Variable &quot;var1&quot; auf Übereinstimmung mit der Variablen
+  &quot;var2&quot;. Mittels &quot;!=&quot; anstelle von &quot;==&quot;
+  würde auf Ungleichheit getestet.</p>
+
+ <p>Erfahrere Benutzer können neben der Tests auf (Un-)Gleichheit auch
+  Tests auf Übereinstimmung mit regulären Ausdrücken ohne
+  Berücksichtung der Groß- und Kleinschreibung durchführen. Dazu dient
+  dieselbe Syntax wie oben nur mit &quot;=~&quot; und &quot;!~&quot;
+  als Vergleichsoperatoren.</p>
+
+ <p>Beispiel für einen Test, ob die Variable &quot;intnotes&quot;
+  (interne Bemerkungen) das Wort &quot;schwierig&quot; enthält:
+  <code class="blue">&lt;%if intnotes =~
+  &quot;schwierig&quot;%&gt;</code></p>
 
  <h3><a name="bloecke_foreach">Die <code>foreach</code>-Schleife</a></h3>
 
  <p class="blue"><code>&lt;%foreach variablenname%&gt;<br>
    ...<br>
-   &lt;%end foreach&gt;</code></p>
+   &lt;%end%&gt;</code></p>
 
  <p>F&uuml;gt die Zeilen zwischen den beiden Anweisungen so oft ein, wie das
   Perl-Array der Variablen "variablenname" Elemente enth&auml;t. Dieses
@@ -771,21 +1322,20 @@ td {
    Artikelnummer: &lt;%number%&gt;<br>
    Beschreibung: &lt;%description%&gt;<br>
    ...<br>
-   &lt;%end foreach&gt;</code></p>
+   &lt;%end%&gt;</code></p>
 
  <p>Besonderheit in OpenDocument-Vorlagen: Tritt ein
-  <code>&lt;foreach&gt;</code>-Blcok innerhalb einer Tabellenzelle
+  <code>&lt;%foreach%&gt;</code>-Block innerhalb einer Tabellenzelle
   auf, so wird die komplette Tabellenzeile so oft wiederholt wie
   notwendig. Tritt er au&szlig;erhalb auf, so wird nur der Inhalt
-  zwischen <code>&lt;foreach&gt;</code> und <code>&lt;end
-  foreach&gt;</code> wiederholt, nicht aber die komplette Zeile, in
-  der er steht.</p>
+  zwischen <code>&lt;%foreach%&gt;</code> und <code>&lt;%end%&gt;</code>
+  wiederholt, nicht aber die komplette Zeile, in der er steht.</p>
 
  <h3><a name="bloecke_pagebreak">Der <code>pagebreak</code>-Block</a></h3>
 
  <p class="blue"><code>&lt;%pagebreak ZpZ ZeS ZzS%&gt;<br>
    ...<br>
-   &lt;%end pagebreak%&gt;</code></p>
+   &lt;%end%&gt;</code></p>
 
  <p>Dieser Block existiert nur in LaTeX-Vorlagen.</p>
 
@@ -874,8 +1424,8 @@ td {
   href="dokumentenvorlagen-und-variablen.html#bloecke_pagebreak">pagebreak-Block</a>
   voreingestellten Werte einen Seitenumbruch nach der aktuellen
   Rechnungsposition. Dementsprechend funktioniert er nur innerhalb von
-  <code>&lt;foreach...&gt;</code>-Schleifen. Weiterhin ben&ouml;tigt er kein
-  Endtag.</p>
+  <code>&lt;%foreach...%&gt;</code>-Schleifen. Weiterhin ben&ouml;tigt
+  er kein Endtag.</p>
 
  <small><a href="dokumentenvorlagen-und-variablen.html#inhaltsverzeichnis">
    zum Inhaltsverzeichnis</a></small><br>