====== offer-cube FAQ / Benachrichtigung bei Angebot beauftragt oder abgelehnt ======

Zurück zur [[offer-cube:howto|Anleitungen / HowTos]]

Siehe auch [[offer-cube:howto:syncsetting|Synchronisierungen]] \\
Siehe auch [[offer-cube:howto:syncsetting-hook-codes|Synchronisierungen Hook-Codes]] \\
Siehe auch [[offer-cube:howto:syscron|Zeitaktionen]] \\
Siehe auch [[offer-cube:howto:docmeta-email|Dokument Vorlagen f. Emails]] \\
Siehe auch [[offer-cube:howto:pdf-special-variables|PDF Power User Funktionen Variablen/Funktionen]] \\

Siehe auch [[offer-cube:faq:faq_ooi-syncsetting_notification_slack_channel|FAQ: Nachrichten in SLACK Channel]] \\

===== Allgemeines / Zusammenfassung =====

Das System kann Benachrichtigungen z.B. per Email (siehe [[offer-cube:howto:docmeta-email|Dokument Vorlagen f. Emails]]) über z.B. beauftragte [[offer-cube:howto:offer|Angebote]] oder versendete oder offene [[offer-cube:howto:invoice|Rechnungen]] senden. \\

Der Auslöser für eine Benachrichtigung kann eine Aktion eines Benutzers sein (z.B. Angebot //Gewonnen// klicken) oder eine zeitlich gesteuerte Aktion wie z.B. 10 Tage nach Angebotsversand (siehe [[offer-cube:howto:syscron|Zeitaktionen]]).

Konfiguriert werden diese Art von Benachrichtigungen in einer [[offer-cube:howto:syncsetting|Synchronisierungen]] vom Typ //Hook//.

==== Details: Anlegen Hook ====

Zuerst muss eine [[offer-cube:howto:docmeta-email|Dokument Vorlagen f. Email]] angelegt werden.

Im zweiten Schritt wird dann eine [[offer-cube:howto:syncsetting|Synchronisierungen]] angelegt, bei der bei einem bestimmten Ereignis diese Email Vorlage an die gewünschte Email Adresse gesendet wird.

==== Email Vorlage bei Angebot vom Kunden beauftragt/abgelehnt ====

Zuerst muss eine [[offer-cube:howto:docmeta-email|Dokument Vorlagen f. Email]] angelegt werden:

Unter "//Einstellungen//" --> "//Dokument Vorlagen//" wird eine neue Dokument Vorlage vom Typ "//Mail Vorlage//" angelegt.

Bezeichnung:
<code>Angebot beauftragt Email an Office</code>

Der Betreff könnte folgendermaßen lauten:
<code>[[$CONFIGURATION.ownCompany]]: Angebot [[$obj._objref]] "[[$obj.summary|escape]]" Kunde [[$obj.site_name]] [[$obj.site_company]] beauftragt</code>

Hierbei werden [[offer-cube:howto:pdf-special-variables|PDF Power User Funktionen Variablen/Funktionen]] verwendet.

Dann wird ein Textblock angelegt mit z.B. folgendem Inhalt:
<code>
<p>Hallo [[$obj.modified_user__firstname]]&nbsp;[[$obj.modified_user__lastname]],</p>
<p>das Angebot&nbsp;<strong>[[$obj._objref]]</strong>&nbsp;[[if $obj.summary != ""]]mit dem Titel "<strong>[[$obj.summary|escape]]</strong>" [[/if]]wurde am <strong>[[$obj.status_custinstructed|ut2humandate:1]]</strong> beauftragt.</p>
<p>Link zum Angebot: <a href="[[myurl absolute=true noGetParams=true script='b']]#/detail/offer/[[$payload.id]]">[[myurl absolute=true noGetParams=true script='b']]#/detail/offer/[[$payload.id]]</a></p>
<p>Weitere Daten:</p>
<p>Angebot: <strong>[[$payload._objref]]<em>&nbsp;[[$obj.summary|escape]]</em></strong><br />[[if $obj.status_sent != 0]]Gesendet am: <strong>[[$obj.status_sent|ut2humandate:1]]</strong><br />[[/if]] [[if $obj.startdate != 0]]Startdatum: <strong>[[$obj.startdate|ut2humandate:1]]</strong><br />[[/if]] [[if $obj.enddate != 0]]Enddatum: <strong>[[$obj.enddate|ut2humandate:1]]</strong><br />[[/if]] [[if $payload.site_company != ""]]Firma: <strong>[[$payload.site_company|escape]]</strong><br />[[/if]] [[if $payload.site_name != ""]]Name: <strong>[[$payload.site_name|escape]]</strong><br />[[/if]] [[if $payload.site_email != ""]]Email: <strong>[[$payload.site_email|escape]]</strong><br />[[/if]] [[if $obj.site_phone != ""]]Telefon: <strong>[[$obj.site_phone|escape]]</strong><br />[[/if]] [[if $obj.site_mobile != ""]]Mobil: <strong>[[$obj.site_mobile|escape]]</strong><br />[[/if]] [[if $obj.customer != 0]]Kunde: <strong>[[$obj.customer___objref]] [[$obj.customer__comboname|escape]]</strong><br />Link zum Kunden: <a id="" href="[[myurl absolute=true noGetParams=true script='b']]#/detail/customer/[[$obj.customer]]">[[myurl absolute=true noGetParams=true script='b']]#/detail/customer/[[$obj.customer]]</a><br />[[/if]] <br />[[if $payload.annotation != ""]]Notiz: <br /><em>[[$payload.annotation|escape|nl2br]]</em>[[/if]]</p>
<p>&nbsp;</p>
<p>Mit freundlichen Gr&uuml;&szlig;en<br />[[$CONFIGURATION.ownCompany|escape]]</p>
<div class="footer" style="color: #8c8c8c; font-size: 0.8em;">[[$CONFIGURATION.ownCompany|escape|nl2br]] <br />[[$CONFIGURATION.ownOfferContact|escape|nl2br]]</div>
</code>

{{offer-cube:faq:faq_ooi-syncsetting_notification_email_offer_accepted:offer-cube-faq-syncsetting-offer-accepted-01-create-docmeta.png|Einstellungen -> Neue Dokument Vorlage}}

{{offer-cube:faq:faq_ooi-syncsetting_notification_email_offer_accepted:offer-cube-faq-syncsetting-offer-accepted-02-create-docmeta.png|Einstellungen -> Email Dokument Vorlage Textblock}}

==== Synchronisierung bei Angebot vom Kunden beauftragt ====

Unter "//Einstellungen//" --> "//Synchronisierungen//" wird eine neue Synchronisierungen vom Typ "//Hook//" angelegt.

	* **Bezeichnung:** z.B. //Angebot beauftragt Email an Office//
	* **Hook-Code:** z.B. //global.offer.custinstructed// oder //global.offer.custdeclined// - siehe [[offer-cube:howto:syncsetting-hook-codes|Synchronisierungen Hook-Codes]]
	* **Methodenname:** //mail// für Mailversand oder //post// für Webservice Request (siehe z.B. [[offer-cube:faq:faq_ooi-syncsetting_notification_slack_channel|FAQ: Nachrichten in SLACK Channel]])
	* **Dokument Vorlage:** (die vorher angelegte Email Dokumentenvorlage)
	* **Alternative Empfänger Email:** //<fixe@mailadresse>// oder z.B. //<nowiki>[[$CONFIGURATION.ownMail]]</nowiki>// \\ Dies wird ersetzt durch die eigene Email Adresse aus //Einstellungen// --> //Eigene Firmendaten//. \\ Es kann hier auch eine beliebige fixe Email Adresse eingetragen werden. \\ **ACHTUNG: Wenn das Feld leer gelassen wird, wird die Email an den Kunden geschickt!**

=== Hook-Code Angebot vom Kunden beauftragt ===

Der Hook-Code //**global.offer.custinstructed**// wird ausgelöst, wenn ein Kunde im Bestellportal auf "//Angebot beauftragen//" klickt.

=== Hook-Code Angebot vom Kunden abgelehnt ===

Der Hook-Code //**global.offer.custdeclined**// wird ausgelöst, wenn ein Kunde im Bestellportal auf "//Angebot ablehnen//" klickt.

=== Hook-Code Kundenportal/Webshop Bestellung ===

Der Hook-Code //**global.bifroest.created**// wird ausgelöst, wenn ein Kunde im [[offer-cube:howto:bifroest-portal-webshop|Kundenportal/Webshop]] eine Bestellung aufgibt.

=== Synchronisierung mit Hook anlegen ===

{{offer-cube:faq:faq_ooi-syncsetting_notification_email_offer_accepted:offer-cube-faq-syncsetting-offer-accepted-05-create-syncsetting.png|Einstellungen -> Synchronisierung}}

===== Ergebnis =====

{{offer-cube:faq:faq_ooi-syncsetting_notification_email_offer_accepted:offer-cube-faq-syncsetting-offer-accepted-11-offer-clientchoice.png|Angebot beauftragen}}

{{offer-cube:faq:faq_ooi-syncsetting_notification_email_offer_accepted:offer-cube-faq-syncsetting-offer-accepted-12-email-notification.png|Email Nachricht}}