X-Git-Url: http://wagnertech.de/git?a=blobdiff_plain;f=doc%2Fdokumentenvorlagen-und-variablen.html;h=9865b479679371c952dbf7860ddd9e472d542a1f;hb=fda64d3f62aae7dd7aff7c1d3dd4e2773a14c5f3;hp=8dffd5b6c15444481ba6182c27ba0207be9e5e7f;hpb=a6fbe7eb6428672a902c46511b4c77c07c873604;p=kivitendo-erp.git

diff --git a/doc/dokumentenvorlagen-und-variablen.html b/doc/dokumentenvorlagen-und-variablen.html
index 8dffd5b6c..9865b4796 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>
 
@@ -78,6 +81,9 @@ 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>
 
@@ -100,7 +106,14 @@ td {
   </li>
 
   <li><a href="dokumentenvorlagen-und-variablen.html#anderevorlagen">
-    Variablen in anderen Vorlagen</a></li>
+    Variablen in anderen Vorlagen</a>
+
+   <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">
     Bl&ouml;cke, bedingte Anweisungen und Schleifen</a>
@@ -133,7 +146,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
@@ -168,6 +185,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>
 
@@ -176,17 +223,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>
@@ -213,6 +309,10 @@ 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>Kunden-/Lieferantentyp</td>
@@ -297,6 +397,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>
@@ -360,7 +464,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>
@@ -370,7 +474,7 @@ 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>
@@ -559,7 +663,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>
@@ -571,7 +675,7 @@ td {
    </tr>
    <tr>
     <td><code>duedate</code></td>
-    <td>Fälligkeitsdatum</td>
+    <td>F&auml;lligkeitsdatum</td>
    </tr>
    <tr>
     <td><code>globalprojectnumber</code></td>
@@ -656,18 +760,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>
@@ -676,18 +772,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>
@@ -708,6 +832,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>
@@ -716,6 +848,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>
@@ -736,42 +872,78 @@ td {
     <td><code>unit</code></td>
     <td>Einheit</td>
    </tr>
+   <tr>
+    <td><code>weight</code></td>
+    <td>Gewicht</td>
+   </tr>
   </table>
  </p>
 
- <h3><a name="invoice_zahlungen">
-   Variablen f&uuml;r die einzelnen Zahlungseingänge:</a></h3>
+ <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>datepaid</code></td>
-    <td>Datum</td>
+    <td><code>make</code></td>
+    <td>Lieferant</td>
    </tr>
    <tr>
-    <td><code>memo</code></td>
-    <td>Memo</td>
+    <td><code>model</code></td>
+    <td>Lieferantenartikelnummer</td>
    </tr>
+  </table>
+ </p>
+
+ <h3><a name="invoice_zahlungen">
+   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>paid</code></td>
+    <td><code>payment</code></td>
     <td>Betrag</td>
    </tr>
    <tr>
-    <td><code>source</code></td>
-    <td>Beleg</td>
+    <td><code>paymentaccount</code></td>
+    <td>Konto</td>
    </tr>
    <tr>
-    <td><code>exchangerate</code></td>
-    <td>Wechselkurs</td>
+    <td><code>paymentdate</code></td>
+    <td>Datum</td>
    </tr>
    <tr>
-    <td><code>forex</code></td>
-    <td>Konto</td>
+    <td><code>paymentmemo</code></td>
+    <td>Memo</td>
+   </tr>
+   <tr>
+    <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>
@@ -791,12 +963,12 @@ td {
 
  <h3><a name="dunning_allgemein">Allgemeine Variablen in Mahnungen:</a></h3>
 
- <p>Die Variablen des Verkäufers stehen wie gewohnt
-  als <code>employee_...</code> zur Verfügung. Die Adressdaten des
+ <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ügung.
+  <code>email</code> zur Verf&uuml;gung.
  </p>
 
  <p>Weitere Variablen beinhalten:</p>
@@ -814,7 +986,7 @@ td {
    </tr>
    <tr>
     <td><code>fee</code></td>
-    <td>Kummulative Mahngebühren</td>
+    <td>Kummulative Mahngeb&uuml;hren</td>
    </tr>
    <tr>
     <td><code>interest_rate</code></td>
@@ -895,12 +1067,12 @@ td {
  <h3><a name="dunning_invoice">Variablen in automatisch erzeugten
    Rechnungen &uuml;ber Mahngeb&uuml;hren</a></h3>
 
- <p>Die Variablen des Verkäufers stehen wie gewohnt
-  als <code>employee_...</code> zur Verfügung. Die Adressdaten des
+ <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ügung.
+  <code>email</code> zur Verf&uuml;gung.
  </p>
 
  <p>Weitere Variablen beinhalten:</p>
@@ -910,7 +1082,7 @@ td {
    <tr><th>Variablenname</th><th>Bedeutung</th></tr>
    <tr>
     <td><code>duedate</code></td>
-    <td>Fälligkeitsdatum der Rechnung</td>
+    <td>F&auml;lligkeitsdatum der Rechnung</td>
    </tr>
    <tr>
     <td><code>dunning_id</code></td>
@@ -958,6 +1130,106 @@ td {
   Variablen, die vom Gesch&auml;ftsablauf her in der entsprechenden Vorlage
   keine Bedeutung haben oder noch nicht belegt sein k&ouml;nnen.</p>
 
+ <p>Im Folgenden werden nur wichtige Unterschiede zu den Variablen in
+  Rechnungen aufgef&uuml;hrt.</p>
+
+ <h3><a name="anderevorlagen_quotations">Angebote und Preisanfragen</a></h3>
+
+ <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="anderevorlagen_orders">Auftragsbest&auml;tigungen und Lieferantenauftr&auml;ge</a></h3>
+
+ <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="anderevorlagen_delivery_orders">Lieferscheine (Verkauf und Einkauf)</a></h3>
+
+ <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>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>
+  <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>
+
  <small><a href="dokumentenvorlagen-und-variablen.html#inhaltsverzeichnis">
    zum Inhaltsverzeichnis</a></small><br>
  <hr>