Filterkriterium "Kunden-/Lieferantenname" in Berichten auch beim Umsortieren beibehal...
[kivitendo-erp.git] / doc / dokumentenvorlagen-und-variablen.html
index 029ce00..986ae97 100644 (file)
@@ -55,6 +55,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>
 
@@ -78,6 +81,18 @@ td {
    </ol>
   </li>
 
+  <li><a href="dokumentenvorlagen-und-variablen.html#dunning">
+    Variablen in Mahnungen</a>
+
+   <ol>
+    <li><a href="dokumentenvorlagen-und-variablen.html#dunning_allgemein">
+      Allgemeine Variablen</a></li>
+
+    <li><a href="dokumentenvorlagen-und-variablen.html#dunning_details">
+      Variablen f&uuml;r jede gemahnte Rechnung</a></li>
+   </ol>
+  </li>
+
   <li><a href="dokumentenvorlagen-und-variablen.html#anderevorlagen">
     Variablen in anderen Vorlagen</a></li>
 
@@ -85,15 +100,6 @@ td {
     Bl&ouml;cke, bedingte Anweisungen und Schleifen</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#bloecke_einschr_opendocument">
-      Einsch&auml;nkungen f&uuml;r Bl&ouml;cke in OpenDocument-Vorlagen</a></li>
-
-    <li><a href="dokumentenvorlagen-und-variablen.html#bloecke_include">
-      Die <code>include</code>-Anweisung</a></li>
-
     <li><a href="dokumentenvorlagen-und-variablen.html#bloecke_ifnot">
       Der <code>if not</code>-Block</a></li>
 
@@ -203,7 +209,7 @@ td {
    </tr>
    <tr>
     <td><code>business</code></td>
-    <td>Kundentyp</td>
+    <td>Kunden-/Lieferantentyp</td>
    </tr>
    <tr>
     <td><code>city</code></td>
@@ -250,13 +256,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>
@@ -281,6 +299,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>
@@ -300,6 +322,16 @@ td {
     <td>Land (Lieferadresse)
      <a href="dokumentenvorlagen-und-variablen.html#anmerkung_shipto">*</a></td>
    </tr>
+   <tr>
+    <td><code>shiptodepartment1</code></td>
+    <td>Abteilung 1 (Lieferadresse)
+     <a href="dokumentenvorlagen-und-variablen.html#anmerkung_shipto">*</a></td>
+   </tr>
+   <tr>
+    <td><code>shiptodepartment2</code></td>
+    <td>Abteilung 2 (Lieferadresse)
+     <a href="dokumentenvorlagen-und-variablen.html#anmerkung_shipto">*</a></td>
+   </tr>
    <tr>
     <td><code>shiptoemail</code></td>
     <td>Email (Lieferadresse)
@@ -338,10 +370,6 @@ td {
     <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>
@@ -377,12 +405,32 @@ 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">
    <tr><th>Variablenname</th><th>Bedeutung</th></tr>
+   <tr>
+    <td><code>employee_address</code></td>
+    <td>Adressfeld</td>
+   </tr>
+   <tr>
+    <td><code>employee_businessnumber</code></td>
+    <td>Firmennummer</td>
+   </tr>
+   <tr>
+    <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>
@@ -399,6 +447,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>
@@ -406,6 +458,59 @@ td {
   </table>
  </p>
 
+ <h3><a name="allgemein_verkaeufer">
+   Informationen &uuml;ber den Verk&auml;fer (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>
 
@@ -462,6 +567,10 @@ td {
     <td><code>duedate</code></td>
     <td>Fälligkeitsdatum</td>
    </tr>
+   <tr>
+    <td><code>globalprojectnumber</code></td>
+    <td>Projektnummer des ganzen Beleges</td>
+   </tr>
    <tr>
     <td><code>intnotes</code></td>
     <td>Interne Bemerkungen</td>
@@ -482,10 +591,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>
@@ -512,6 +633,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>
@@ -645,6 +770,111 @@ td {
    zum Inhaltsverzeichnis</a></small><br>
  <hr>
 
+ <h2><a name="dunning">Variablen in Mahnungen</a></h2>
+
+ <h3><a name="dunning_allgemein">Allgemeine Variablen:</a></h3>
+
+ <p>Die Variablen des Verkäufers stehen wie gewohnt
+  als <code>employee_...</code> zur Verfü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.
+ </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>dunning_duedate</code></td>
+    <td>F&auml;lligkeitsdatum f&uuml;r diese Mahhnung</td>
+   </tr>
+   <tr>
+    <td><code>fee</code></td>
+    <td>Kummulative Mahngebühren</td>
+   </tr>
+   <tr>
+    <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:</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 (ist die gleiche wie f&uuml;r die ganze Mahnung, da die Geb&uuml;hr nur einmal pro Mahnung erhoben wird)</td>
+   </tr>
+   <tr>
+    <td><code>dn_interest</code></td>
+    <td>Zinsen per anno f&uum;r diese Rechnung</td>
+   </tr>
+   <tr>
+    <td><code>dn_invnumber</code></td>
+    <td>Rechnungsnummer</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>
+
+ <small><a href="dokumentenvorlagen-und-variablen.html#inhaltsverzeichnis">
+   zum Inhaltsverzeichnis</a></small><br>
+ <hr>
+
  <h2><a name="anderevorlagen">
    Variablen in anderen Vorlagen</a></h2>
 
@@ -671,47 +901,11 @@ td {
   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>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>
-
- <p class="blue"><code>\ifthenelse{\equal{&lt;%variable%&gt;}{}}{}{Dieser
-   Text erscheint nur, wenn &lt;%variable%&gt; nicht leer ist.}</code></p>
-
- <h3><a name="bloecke_einschr_opendocument">
-   Einsch&auml;nkungen f&uuml;r Bl&ouml;cke in OpenDocument-Vorlagen</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>
-
- <h3><a name="bloecke_include">Die <code>include</code>-Anweisung</a></h3>
-
- <p class="blue"><code>&lt;%include dateiname.ext%&gt;</code></p>
-
- <p>Dieser Block funktioniert nur in LaTeX- und HTML-Vorlagen.</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>
-
  <h3><a name="bloecke_ifnot">Der <code>if not</code>-Block</a></h3>
 
  <p class="blue"><code>&lt;%if not variablenname%&gt;<br>
    ...<br>
-   &lt;%end if&gt;</code></p>
+   &lt;%end&gt;</code></p>
 
  <p>Eine normale "if-not-then"-Bedingung. Die Zeilen zwischen dem "if not" und
   dem "end" werden nur ausgegeben, wenn die Variable "variablenname" nicht
@@ -721,7 +915,7 @@ td {
 
  <p class="blue"><code>&lt;%if variablenname%&gt;<br>
    ...<br>
-   &lt;%end if&gt;</code></p>
+   &lt;%end&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
@@ -731,7 +925,7 @@ td {
 
  <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
@@ -749,21 +943,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>