Beim Bearbeiten des Angebots kannst du Variablen nutzen, um Angaben aus Grip in das Dokument einzufügen.

Grundlagen

Wo kann ich Variablen nutzen?

Variablen kannst du in folgenden Bereichen einsetzen:

  • Auf der Titelseite
  • In Kapiteln
  • In Preispositionen
  • Im Steuerhinweis
  • Im Auftragsformular

Wie funktioniert es?

Zum Beispiel fügt der folgende Code den Titel des Angebots ein, wie du ihn in Grip hinterlegt hast:

Unsere Mission: {{ proposal.title }}

Dabei werden die geschweiften Klammern samt Inhalt durch den in Grip hinterlegten Wert ersetzt.

Angebot Titel

Wenn Du dem Angebot den Titel “Erhöhen Sie Ihren Umsatz mit einer modernen Website” (1) gegeben hast, wird auf der Titelseite folgendes ausgegeben:

Unsere Mission: Erhöhen Sie Ihren Umsatz mit einer modernen Website

Im folgenden erklären wir, welche Variablen in Grip zur Verfügung stehen und was diese bedeuten.

Daten des Angebots

Angebotsdatum
proposal.date | long_date
Hier wird das Datum mit Hilfe des Filters long_date in das Datumsformat TT. Monat JJJJ (13. April 2016) gebracht.
Logische Prüfung: optionale Preispositionen enthalten?
proposal.has_optional_fees?
Wahr, wenn das Angebot mindestens eine optionale Preisposition enthält.
Optionale Preispositionen ausgeben
proposal.optional_fees
Alle optionalen Preispositionen zur weiteren Verarbeitung in einer for-Schleife. (Siehe Abschnitt Preisposition)
Logische Prüfung: Briefkopf auf der Titelseite ausgeben?
proposal.show_letterhead?
Wahr, wenn die Option 'Briefkopf anzeigen' im Reiter Layout aktiv ist.
Titel des Angebots
proposal.title
Angebotsnummer
proposal.number
Externe Referenz-Nummer (bspw. für Anfrage-/PO-Nummer)
proposal.external_reference

Daten des Autors

E-Mail-Adresse des Autors
proposal.author.email
Name des Autors
proposal.author.name
Vorname des Autors
proposal.author.firstname
Nachname des Autors
proposal.author.lastname

Daten deiner Firma

Ort
proposal.account.city
Postleitzahl und Ort
proposal.account.city_with_zip
Postleitzahl und Ort in der landesspezifischen Form, z.B. 80333 München oder London, W11 2BQ.
E-Mail-Adresse der Firma
proposal.account.email
Faxnummer
proposal.account.fax
Logische Prüfung: Logo vorhanden?
proposal.account.logo?
Wahr, wenn in den Konto-Einstellungen des Grip-Kontos ein Logo hinterlegt wurde.
Firmenname
proposal.account.name
Land
proposal.account.nation
Telefonnummer
proposal.account.phone
Straße
proposal.account.street
URL der Website
proposal.account.website
Beispiel: https://getgrip.de
Website
proposal.account.website_without_protocol
Die Anzeige erfolgt ohne http:// oder https:// zum Beispiel: getgrip.de

Daten des Empfängers

Firmenname
proposal.client.organization
Kundennummer der Firma
proposal.client.customer_number
Name des Kunden inkl. Titel
proposal.client.name
Beispiel: Prof. Dr. Claudia Bachmann
Titel und Nachname des Kunden
proposal.client.full_lastname
Beispiel: Prof. Dr. Bachmann
Vorname des Kunden
proposal.client.firstname
Nachname des Kunden
proposal.client.lastname
Titel des Kunden
proposal.client.prefix
Jobtitel / Berufsbezeichnung des Kunden
proposal.client.job_title
Straße
proposal.client.street
Postleitzahl
proposal.client.zip
Ort
proposal.client.city
Postleitzahl und Ort
proposal.client.city_with_zip
Postleitzahl und Ort in der landesspezifischen Form, z.B. 80333 München oder London, W11 2BQ.
Land
proposal.client.nation
E-Mail-Adresse
proposal.client.email
Telefon
proposal.client.phone

Preispositionen

Im Auftragsformular werden die optionalen Preispositionen eines Angebots ausgegeben. Dafür ist eine for-Schleife notwendig:

{% for fee in proposal.optional_fees %}
  {{ fee.headline  }}
{% endfor %}

Zusätzlich kann geprüft werden, ob das Angebot optionale Positionen enthält:

{% if proposal.has_optional_fees? %}
  ... Überschrift ...
{% endif %}

Das ist nützlich, um z.B. eine Überschrift nur dann anzuzeigen, wenn auch optionale Positionen vorhanden sind.

Folgende Informationen können aus der Preisposition verwendet werden:

Überschrift der Preisposition
fee.headline
Preis als Betrag oder, falls angegeben, Text um den Betrag zu verbergen. Kann auch ein leerer Text sein.
fee.public_amount
Die dem Preis zu Grunde liegende Einheit, z.B. pro Monat. Kann leer sein.
fee.unit

Gesamtpreis

Du kannst auf die Gesamtbeträge der einmaligen, monatlichen, quartalsweisen und jährlichen Leistungen zugreifen.

Der Gesamtbetrag steht entweder als Geldbetrag inkl. Währung (z.B. “2.480,00 €”) oder als reine Zahl (z.B. 2480.0) ausgegeben werden. Letztere haben eine Bezeichnung, die auf _number endet.

Der Gesamtbetrag als Zahl eignet sich für logische Prüfungen oder Berechnungen:

{% if proposal.monthly_total_number > 0 %}
  Ihre monatlichen Kosten belaufen sich auf {{ proposal.monthly_total  }}
{% endif %}

Folgenden Variablen kannst du verwenden:

Gesamtbetrag einmalig mit Währung im Format der Angebotssprache
proposal.onetime_total
Gesamtbetrag einmalig als Zahl zur Weiterverarbeitung
proposal.onetime_total_number
Gesamtbetrag monatlich mit Währung im Format der Angebotssprache
proposal.monthly_total
Gesamtbetrag monatlich als Zahl zur Weiterverarbeitung
proposal.monthly_total_number
Gesamtbetrag quartalsweise mit Währung im Format der Angebotssprache
proposal.quarterly_total
Gesamtbetrag quartalsweise als Zahl zur Weiterverarbeitung
proposal.quarterly_total_number
Gesamtbetrag jährlich mit Währung im Format der Angebotssprache
proposal.yearly_total
Gesamtbetrag jährlich als Zahl zur Weiterverarbeitung
proposal.yearly_total_number
Logo einfügen
logo
Generiert den HTML Code zur Einbindung des Logos aus den Konto-Einstellungen

Unterschiede zu den anderen ##variablen##

Mit beiden Arten von Variablen lassen sich die wichtigsten Angaben eines Angebots einfügen. Es gibt jedoch einige Unterschiede im Detail.

Die klassischen Rauten-Variablen in Grip-Angeboten bestehen aus deutschen Wörtern wie bspw. ##kundenname##. Dadurch sind sie im Text vielleicht etwas angenehmer zu lesen. Sie ermöglichen außerdem eine typische Brief-Anrede wie z.B. “Sehr geehrte Frau Meier”. Außerdem wird die korrekte Verwendung von Rauten-Variablen überwacht. Wenn beispielsweise ##meinetelefonnr## eingefügt werden soll, diese aber nicht im Konto gespeichert ist, zeigt Grip eine Warnung an.

Auf der anderen Seite bieten Liquid-Variablen wie {{ proposal.date }} etwas mehr Möglichkeiten in Sachen Programmierung. Sie können mit Hilfe der Liquid-Syntax manipuliert und ausgewertet werden. So lässt sich ein Datum in ein anderes Datumsformat umwandeln, man kann mit Zahlen rechnen, Texte anreichern usw. Außerdem bietet Liquid logische Funktionen an, wie Verzeigung und Iteration. Mehr zur Verwendung von Liquid findest du auf liquidmarkup.org.”

Bereich Liquid-Variablen Rauten-Variablen
Titelseite
Text-Kapitel
Preis-Kapitel
Steuerhinweis
Auftragsformular
Mailversand des Angebots