Angebote an Kunden erstellen (B2B)

Ein Händler stellt seinem eigenen Kunden ein Angebot. Statt es von Hand zu schreiben, legt er die Produkte in seinen Warenkorb, ergänzt ein paar Angaben und bekommt ein fertiges PDF. Technisch ist das kein eigenes Modul, sondern die PDF-Anzeige des Warenkorbs mit einem vorgeschalteten Formular. Die Eingaben aus diesem Formular reisen als freie Parameter mit und entscheiden im PDF-Template, was dort erscheint.

Die Bausteine

Baustein	Aufgabe
PDF-Anzeige des Warenkorbs	erzeugt das PDF aus einem eigenen Template
freie Parameter `WS-OTPX`	tragen die Eingaben des Formulars in das PDF-Template
Rechen-Tags `DC-CommercialCalc1…3`	Aufschlag, Positionssummen und Gesamtbetrag
ein freies Adressdatenfeld	hält den Dateinamen des Kundenlogos, optional

Wegweiser: PDF-Anzeige des Warenkorbs · Referenz: WS-OTPX Die freien Parameter heißen im Formular klein und ohne Präfix, beispielsweise otpoffernumber, und im Template WS-OTPoffernumber. Es ist derselbe Wert. Die Namen hinter otp wählen Sie frei.

Schritt 1: Das Formular

Auf einer beliebigen Seite, nahe liegend auf der Warenkorbseite ws_basket.htm:

<form action="~FORM-Basket~" method="post">
   <input type="hidden" name="otpofferbasket" value="true">

   <label><input type="checkbox" name="otpshowproductimage" value="true" checked> Produktbilder</label>
   <label><input type="checkbox" name="otpshowbasketprice" value="true" checked> Produktpreise</label>
   <label><input type="checkbox" name="otpshowbasketinventory" value="true" checked> Lieferzeiten</label>
   {A-Suffix1}
      <label><input type="checkbox" name="otpshowownlogo" value="true" checked> Eigenes Firmenlogo</label>
   {/A-Suffix1}

   <label>Angebotsnummer <input type="text" name="otpoffernumber"></label>
   <label>Angebotsdatum <input type="date" name="otpofferdate"></label>

   <fieldset>
      <legend>Adresse Ihres Kunden</legend>
      <label>Anrede
         <select name="otpofferaddrsalutation">
            <option value="" selected disabled>bitte wählen</option>
            <option value="Herr">Herr</option>
            <option value="Frau">Frau</option>
         </select>
      </label>
      <label>Vorname <input type="text" name="otpofferaddrfirstname" autocomplete="off"></label>
      <label>Nachname <input type="text" name="otpofferaddrlastname" autocomplete="off"></label>
      <label>Straße, Nr. <input type="text" name="otpofferaddrstreet1" autocomplete="off"></label>
      <label>PLZ <input type="text" name="otpofferaddrzip" inputmode="numeric" autocomplete="off"></label>
      <label>Ort <input type="text" name="otpofferaddrcity" autocomplete="off"></label>
      <label>Land
         <select name="otpofferaddrcountry">
            {@A-Country_data}
               <option value="~A-Country_value~">~A-Country_value~</option>
            {/@A-Country_data}
         </select>
      </label>
   </fieldset>

   <label>Aufschlag in Prozent
      <input type="number" name="otppricecalculation" min="0" max="100" step="0.01">
   </label>

   <fieldset>
      <legend>Eigene Position</legend>
      <label>Bezeichnung <input type="text" name="otpoffercustompositionname"></label>
      <label>Menge <input type="number" name="otpoffercustompositionquantity" min="1" step="1" value="1"></label>
      <label>Einzelpreis <input type="number" name="otpoffercustompositionprice" min="0" max="100000" step="0.01"></label>
   </fieldset>

   <button type="submit" name="~BT-GeneratePDF~">Angebot erstellen</button>
</form>

otpofferbasket ist der Schalter, an dem das PDF-Template erkennt, dass ein Angebot und kein gewöhnliches Warenkorb-PDF gewünscht ist. Die Klammerung {A-Suffix1} blendet das Kästchen für das Logo aus, wenn für diesen Kunden keines hinterlegt ist. Ein Kästchen ohne Wirkung wäre verwirrend.

Postleitzahl, Aufschlag und Menge stehen in der bisherigen Beschreibung als type="tel". Das ist die Eingabeart für Telefonnummern und erlaubt beliebige Zeichen. Für Zahlen gehört type="number" hin, für die Postleitzahl type="text" mit inputmode="numeric", weil Postleitzahlen führende Nullen haben können.

Die Adressfelder tragen autocomplete="off". Der Händler trägt hier die Daten seines Kunden ein, nicht seine eigenen. Ohne diese Angabe schlägt der Browser seine eigene Adresse vor. Referenz: FORM-Basket · BT-GeneratePDF · A-Suffix1…50 · A-Country_data

Schritt 2: Das PDF-Template

Legen Sie das Template an, wie es die Seite zur PDF-Anzeige des Warenkorbs beschreibt. Der Rahmen sieht so aus:

{WS-OTPofferbasket}

   {WS-OTPshowownlogo}
      <img src="../images/~A-Suffix1~" alt="Firmenlogo">
   {/WS-OTPshowownlogo}

   {WS-OTPofferaddrsalutation}~WS-OTPofferaddrsalutation~{/WS-OTPofferaddrsalutation}
   {WS-OTPofferaddrfirstname}~WS-OTPofferaddrfirstname~{/WS-OTPofferaddrfirstname}
   {WS-OTPofferaddrlastname}~WS-OTPofferaddrlastname~{/WS-OTPofferaddrlastname}
   {WS-OTPofferaddrstreet1}~WS-OTPofferaddrstreet1~{/WS-OTPofferaddrstreet1}
   {WS-OTPofferaddrzip}~WS-OTPofferaddrzip~{/WS-OTPofferaddrzip}
   {WS-OTPofferaddrcity}~WS-OTPofferaddrcity~{/WS-OTPofferaddrcity}
   {WS-OTPofferaddrcountry}~WS-OTPofferaddrcountry~{/WS-OTPofferaddrcountry}

   {WS-OTPoffernumber}Angebot ~WS-OTPoffernumber~{/WS-OTPoffernumber}
   {WS-OTPofferdate}vom ~WS-OTPofferdate~{/WS-OTPofferdate}

   <!-- Positionen, siehe unten -->

{/WS-OTPofferbasket}

{!WS-OTPofferbasket}
   <!-- das gewöhnliche Warenkorb-PDF -->
{/!WS-OTPofferbasket}

Jeder Wert steht in seiner eigenen Klammerung. Dadurch erscheint eine Zeile nur, wenn der Händler sie ausgefüllt hat, und das Angebot enthält keine leeren Beschriftungen.

Der Dateiname des Logos stammt aus einem Adressdatenfeld, das der Kunde selbst pflegen kann, und landet ungeprüft im Pfad des Bildes. Beschränken Sie das Feld auf eine Auswahlliste hinterlegter Logos oder prüfen Sie den Wert im Template gegen eine Liste zugelassener Dateinamen.

Die Positionen und die Rechnung

{BASKET-PR-Data}
   ~DC-CommercialCalc3_set(0)~

   {@BASKET-PR-Data}
      {WS-OTPshowproductimage}
         <img src="~BASKET-PR-ThumbNail~" alt="">
      {/WS-OTPshowproductimage}

      ~BASKET-PR-Name~ ~BASKET-PR-Quantity~

      {WS-OTPshowbasketprice}
         ~DC-CommercialCalc1_set($BASKET-PR-Sum$)~
         {WS-OTPpricecalculation}
            ~DC-CommercialCalc1_VATadd($WS-OTPpricecalculation$)~
         {/WS-OTPpricecalculation}

         ~DC-CommercialCalc1~ ~WS-CurrencySymbol~
         ~DC-CommercialCalc3_add($DC-CommercialCalc1$)~
      {/WS-OTPshowbasketprice}
   {/@BASKET-PR-Data}
{/BASKET-PR-Data}

Tag	Aufgabe
`DC-CommercialCalc3_set(0)`	setzt die Summe auf null, vor der Schleife
`DC-CommercialCalc1_set()`	nimmt den Positionsbetrag auf
`DC-CommercialCalc1_VATadd()`	schlägt den eingegebenen Prozentsatz auf
`DC-CommercialCalc3_add()`	zählt die Position zur Summe

Das _set(0) steht innerhalb von {BASKET-PR-Data}, aber außerhalb der Schleife {@BASKET-PR-Data}. Stünde es in der Schleife, würde die Summe bei jeder Position auf null zurückfallen und am Ende nur die letzte Position enthalten.

Der Aufschlag greift in der bisherigen Beschreibung nur bei den Warenkorbpositionen, nicht bei der eigenen Position. Trägt der Händler einen Aufschlag und eine eigene Position ein, wird diese eine Zeile ohne Aufschlag berechnet, die übrigen mit.Wenden Sie ~DC-CommercialCalc1_VATadd($WS-OTPpricecalculation$)~ auch auf die eigene Position an, oder sagen Sie im Formular ausdrücklich, dass der Aufschlag für sie nicht gilt.Der Mehrwertsteuersatz ist im Beispiel fest auf 19 Prozent verdrahtet.Ein Angebot ist ein kaufmännisches Dokument. Produkte mit ermäßigtem Steuersatz, Lieferungen ins Ausland und steuerfreie Leistungen führen damit zu einem falschen Betrag. Verwenden Sie den tatsächlichen Steuersatz aus dem Warenkorb, und weisen Sie die Steuer getrennt je Satz aus, wenn Ihr Sortiment mehrere enthält.

_VATadd() heißt so, weil es ursprünglich für die Mehrwertsteuer gedacht war. Rechnerisch schlägt es einen Prozentsatz auf, deshalb eignet es sich auch für den Aufschlag. Wenn Sie den Unterschied im Template deutlich machen wollen, verwenden Sie für den Aufschlag stattdessen _percent() und _add(). Referenz: BASKET-PR-Data · DC-CommercialCalc1…3 · WS-CurrencySymbol

Was Sie beachten sollten

Das erzeugte PDF ist ein Angebot des Händlers an seinen Kunden, nicht eines Ihres Shops. Pflichtangaben, Gültigkeitsdauer, Lieferbedingungen und Steuerhinweise verantwortet der Händler. Halten Sie Ihr eigenes Impressum und Ihre Konditionen aus dem Dokument heraus, sonst entsteht der Eindruck, der Shop sei der Anbietende.

Die eingegebene Kundenadresse wird nur für dieses eine PDF verwendet und nicht gespeichert. Das ist der Sinn freier Parameter: Sie gelten für einen Aufruf. Ändert sich der Warenkorb, ändert sich auch das Angebot. Ein einmal erzeugtes PDF bleibt dagegen, wie es ist. Weisen Sie den Händler darauf hin, dass er die Datei sichern soll, wenn er sie weitergibt.

Anwendungsbeispiele

Die Bausteine

Schritt 1: Das Formular

Schritt 2: Das PDF-Template

Die Positionen und die Rechnung

Was Sie beachten sollten

Verwandte Themen

​Die Bausteine

​Schritt 1: Das Formular

​Schritt 2: Das PDF-Template

​Die Positionen und die Rechnung

​Was Sie beachten sollten

​Verwandte Themen

Die Bausteine

Schritt 1: Das Formular

Schritt 2: Das PDF-Template

Die Positionen und die Rechnung

Was Sie beachten sollten

Verwandte Themen