====== offer-cube FAQ / Label auf Auftrag zuordnen wenn Rechnung bezahlt ======

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

Siehe auch [[offer-cube:howto:label|Labels]] \\
Siehe auch [[offer-cube:howto:label-date-reminder|Labels mit Datum]] \\
Siehe auch [[offer-cube:howto:syncsetting|Synchronisierungen]] \\
Siehe auch [[offer-cube:howto:syncsetting-hook-codes|Synchronisierungen Hook-Codes]] \\
Siehe auch [[offer-cube:howto:pdf-special-variables|PDF Power User Funktionen Variablen/Funktionen]] \\

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

[[offer-cube:howto:label|Labels]] sind wie Post-its, die man auf Kunden, Angebote, Aufträge, Rechnungen, etc. "kleben" kann und nach denen man auch [[offer-cube:howto:label#suchen-filtern|suchen oder filtern]] kann.

Labels können automatisiert aufgrund einer Aktion gesetzt werden.

**__Anwendungsbeispiel:__\\ Man sieht anhand des BEZAHLT Labels direkt im Auftrag, dass die Anzahlungsrechnung bereits bezahlt wurde**


==== Schritt 1: Anlegen eines BEZAHLT Labels ====

Hierzu legt man z.B. das Label "//BEZAHLT//" unter //Einstellungen// --> //Labels// an. \\
Das Label muss hierbei für Angebote, Aufträge und Rechnungen erlaubt sein (//"zu Auftrag?"="Ja"// ...).

Nach dem Anlegen des Labels, muss man sich die ID merken - diese wird im nächsten Schritt verwendet.

{{offer-cube:faq:faq_label-auf-auftrag-rechnung-bezahlt:faq_label-auf-auftrag-rechnung-bezahlt-01-label-create.png|Label anlegen und zu Auftrag=Ja und Rechnung=Ja}}

{{offer-cube:faq:faq_label-auf-auftrag-rechnung-bezahlt:faq_label-auf-auftrag-rechnung-bezahlt-02-label-create-id.png|Die ID des Labels wird im nächsten Schritt benötigt}}

==== Schritt 2: Erstellen einer Synchronisierung mit Hook ====

Nachdem das Label angelegt wurde muss eine [[offer-cube:howto:syncsetting|Synchronisierung]] mit dem entsprechenden [[offer-cube:howto:syncsetting-hook-codes|Hook Code]] "//global.invoice.paid//" angelegt werden.

Dies geschieht unter //Einstellungen// --> //Synchronisierung//:

	* Bezeichnung: **Label 'Bezahlt' beim Bezahlen zu Auftrag hinzufügen**
	* Hook-Code: **global.invoice.paid** (Rechnung vollständig bezahlt) \\ Siehe [[offer-cube:howto:syncsetting-hook-codes|Synchronisierungen Hook-Codes]]
	* Methodenname: **labelinstance_ui::add**
	* Interne Konfiguration: \\ //<nowiki>{ "type": "[[$object[0]._type]]", "id": "[[$object[0].id]]" }</nowiki>// fügt das Label zum aktuellen Objekt (=die Rechnung) hinzu. \\ //<nowiki>{ "type": "[[$object[0].order___type]]", "id": "[[$object[0].order__id]]" }</nowiki>// fügt das Label zum Auftrag (=order aus der Sicht der Rechnung) hinzu. \\ Die ID (in diesem Beispiel "//30//") ist die ID des vorher angelegten Labels. \\ Siehe [[offer-cube:howto:pdf-special-variables|PDF Power User Funktionen Variablen/Funktionen]]


<code>
{
	"objects": [
		{ "type": "[[$object[0]._type]]", "id": "[[$object[0].id]]" },
		{ "type": "[[$object[0].order___type]]", "id": "[[$object[0].order__id]]" }
	],
	"labels": [
		{ "type": "label", "id": 30 }
	]
}
</code>


{{offer-cube:faq:faq_label-auf-auftrag-rechnung-bezahlt:faq_label-auf-auftrag-rechnung-bezahlt-11-syncsetting-create.png|Synchronisierung mit Hook anlegen}}


==== Schritt 3: Bezahlen der Rechnung ====

Nun kann ganz normal die Rechnung als vollständig bezahlt markiert werden.

Hierbei wird automatisch das Label (in diesem Beispiel "//BEZAHLT//") in den dazugehörigen Auftrag und in die Rechnung übernommen.

Dies ist vorallem sinnvoll, dass direkt im Auftrag sichtbar wird, dass z.B. die Anzahlungsrechnung bereits bezahlt wurde.

{{offer-cube:faq:faq_label-auf-auftrag-rechnung-bezahlt:faq_label-auf-auftrag-rechnung-bezahlt-21-result-label-added-to-order.png|Label Bezahlt zu Auftrag hinzugefügt}}

==== Schritt 4: Suchen/Filtern nach Labels ====

Nun kann in der Liste der Angebote nach dem Label "//BEZAHLT//" gefiltert werden.

Hierzu in der Liste rechts neben der Suchzeile auf das Filtersymbol klicken und dann ein //"Label als Filter hinzufügen"//. \\
Siehe auch [[offer-cube:howto:label#suchen-filtern|Label suchen oder filtern]]

{{offer-cube:faq:best-practice_label_inherit:offer-cube-faq-label_inherit-05-filter4label.png|Filtern nach Label "MESSE"}}