SalesKing | Dokumentation

Platzhalter

Durch Platzhalter können in vielen Bereichen Informationen aus Datensätzen dynamisch abgerufen und dargestellt werden.
Dadurch lassen Sich standardisierte Vorgänge automatisieren.

Die Informationen können Sie hierbei direkt aus einem Datensatz (z.B. einer Rechnung), oder indirekt über einen verknüpften Datensatz (z.B. eine Rechnung die aus einem Angebot erstellt wurde) abrufen.
Bei indirekt abzurufenden Informationen ist auf das entsprechende Präfix [präfix.platzhalter] zu achten.

Folgende Präfixe sind zu nutzen:
  • Rechnung >> invoice
  • Angebot >> estimate
  • Auftrag >> order
  • Gutschrift >> credit_note
  • Kontakt >> contact
Platzhalter stehen Ihnen für folgende Bereiche zur Verfügung:

Achten Sie darauf das Platzhalter IMMER in eckige Klammern [platzhalter] gesetzt werden müssen, und nur Informationen abrufen können die auch vorhanden sind.

Hinweis:
SalesKing arbeitet, wie oben beschrieben, mit eckigen Klammern.
Diese sind nur im Zusammenhang mit den Platzhaltern in SalesKing zu verwenden.
Vermeiden Sie daher die Eingabe von: [irgendeinInhalt] wenn kein [Platzhalter] gemeint ist!

Link zu Bereich:

Wichtige Definitionen

Definition von “vorhandenen” Informationen:
Informationen können “direkt” oder “indirekt” vorhanden sein.

“Direkt vorhandene” Informationen:
Dies sind Informationen, die aus dem Bereich ausgelesen werden können, in dem Sie sich gerade befinden.

“Indirekt vorhandene” Informationen:
Dies sind Informationen, die aus einem mit dem aktuellen Bereich verknüpften Bereich ausgelesen werden können.

Link zu Bereich:

Beispiele für direkt vorhandene Informationen

Direkt aus einer Rechnung darstellbare Informationen sind z.B.

  • das Fälligkeitsdatum [due_date]
  • die Rechnungsnummer [number] oder
  • der Bruttobetrag [gross_total].

Sollen die genannten Informationen in einer E-Mail-Vorlage für die “Art” Rechnung wie folgt dargestellt werden,

“Bitte begleichen Sie den Betrag von 26,36 € aus der Rechnung R-2014-0231 bis zum 24.08.2014.”

sieht der entsprechende Text mit Platzhaltern so aus:

“Bitte begleichen Sie den Betrag von [gross_total] aus der Rechnung [number] bis zum [due_date].”

Link zu Bereich:

Beispiele für indirekt vorhandene Informationen

Indirekt aus einer Rechnung abrufbare Informationen sind z.B. der Ansprechpartner [contact.name] sowie Firmenname des Rechnungsempfängers [contact.organisation].
Die nötige Verknüpfung zum Abrufen der Informationen entsteht durch die Auswahl eines in SalesKing verwalteten Kontaktes.

Weitere mit der Rechnung verknüpfte Bereiche können zum Beispiel daraus entstehen, dass eine Rechnung aus einem Angebot erstellt wurde.
Dann kommen Sie über den Platzhalter z.B. an die Angebotsnummer [estimate.number].

Sollen die genannten Informationen in einer E-Mail-Vorlage für die “Art” Rechnung wie folgt dargestellt werden,

“Gemäß Ihrem Angebot vom 12.02.2014 erlauben wir uns den Betrag in Höhe von 144,00 € von Ihrem Konto mit der IBAN DE12345678901234567 zum 20.02.2014 einzuziehen.”

sieht der entsprechende Text mit Platzhaltern so aus:

“Gemäß Ihrem Angebot vom [estimate.date] erlauben wir uns den Betrag in Höhe von [gross_total] von Ihrem Konto mit der IBAN [contact.bank_iban] zum [due_date] einzuziehen.”

Hinweis:
Einen Unterschied gibt es in einem solchen Szenario bei dem Versand von E-Mails.
Wenn in der E-Mail-Vorlage auf einen mit einem Dokument verbundene Bereich zugegriffen werden soll, müssen die Platzhalter wie folgt aussehen:
[related_object.estimate.date] / [related_object.contact.bank_iban].

Link zu Bereich:

Edge-Cases

Platzhalter “unbekannt”:

Wurde ein Platzhalter verwendet den es “nicht gibt” (nicht abrufbar für Datensatz / Tippfehler), erhalten Sie hierüber Nachricht durch den Hinweis “UNKNOWN for ‘Bereich’: platzhalter”.

Platzhalter kann keine Information abrufen, weil (noch) nicht vorhanden:

Verwenden Sie einen Platzhalter für Informationen die (noch) NICHT VORHANDEN sind z.B den Platzhalter für das Fälligkeitsdatum [due_date], welches bei einem Dokument mit dem Status “Entwurf” noch nicht vergeben ist, wird in der Detailansicht des Dokumentes der Platzhalter und nicht die abzurufende Information angezeigt.
Wenn Sie hieraus nun ein PDF erzeugen, wird in dem PDF “nichts” angezeigt.

Hier finden Sie alle anwendbaren Platzhalter: