## Documentation Index Access the complete documentation index at: https://www.zoho.com/de-de/books/help/llms.txt Use this file to discover all available documentation pages before proceeding. # Funktionen Mit Funktionen in Zoho Books können Sie kleine Codeabschnitte schreiben, um Ihre Geschäftsprozesse zu automatisieren. Ob Sie Ihrem Kunden einen speziellen Rabatt auf die Rechnung gewähren oder eine Verspätungsgebühr hinzufügen möchten, wenn eine Rechnung überfällig wird: Sie können den Code mit einem Deluge-Skript schreiben und ihn mit einer Workflow-Regel verknüpfen. Der Prozess wird dann automatisch für Sie ausgeführt. **Szenario:** Angenommen, Sie möchten jeder überfällig gewordenen Rechnung eine Verspätungsgebühr hinzufügen. Anstatt jede Rechnung manuell zu bearbeiten, können Sie eine Funktion mit einem Deluge-Skript schreiben, die die Verspätungsgebühr berechnet und sie der Rechnung hinzufügt. Anschließend verknüpfen Sie diese Funktion mit einer Workflow-Regel, die ausgelöst wird, sobald eine Rechnung überfällig wird, sodass die Verspätungsgebühr automatisch angewendet wird. ## Was ist Deluge? **Deluge (Data Enriched Language for the Universal Grid Environment)** ist eine Online-Skriptsprache, die in Zoho Creator integriert ist. Sie ermöglicht es Benutzern, der Anwendung schrittweise Logik hinzuzufügen, wodurch sie leistungsfähiger und robuster wird. Um mehr über Deluge zu erfahren, lesen Sie das [Deluge-Referenzhandbuch](https://www.zoho.com/deluge/help/). Wenn Sie Deluge lernen möchten, indem Sie Codebeispiele schreiben, lesen Sie den [Leitfaden mit Deluge-Codebeispielen](https://creator.zoho.com/learndeluge/). ## Eine Funktion erstellen Um eine Funktion zu erstellen: * Gehen Sie zu **Einstellungen** in der oberen rechten Ecke der Seite. * Wählen Sie **Workflow-Aktionen** unter _Automatisierung_. * Wählen Sie im Bereich _Workflow-Aktionen_ **Funktionen**. * Klicken Sie auf **\+ Neue Funktion** in der oberen rechten Ecke. ![Schaltfläche Neue Funktion](/books/help/images/settings/custom-function-button.png) * Auf der Seite _Neue Funktion_: * Geben Sie einen **Namen** für Ihre Funktion ein und geben Sie eine kurze **Beschreibung** an. * Wählen Sie das **Modul**, für das Sie die Funktion erstellen möchten. * Wählen Sie die **Programmiersprache**, in der Sie den Code der Funktion schreiben möchten. * Wenn Sie _Deluge_ als Programmiersprache gewählt haben, klicken Sie auf **Fortfahren** und geben Sie die Parameter in den **Deluge-Editor** ein oder ziehen Sie sie hinein. * Wenn Sie eine andere Programmiersprache als Deluge gewählt haben, müssen Sie den Code der Funktion mit der [Zoho Finance CLI](/de-de/books/help/settings/custom-functions-using-zoho-finance-cli.html) eingeben. Sie können [Kontextmethoden](/de-de/books/help/settings/custom-functions-context-methods.html) verwenden, um mit Plattformfunktionen wie Protokollierung, Caching, Warteschlangen, Dateispeicher, geplanter Ausführung und Drittanbieter-Connectors zu interagieren. ![Neue vordefinierte Verbindung](/books/help/images/settings/custom-function-form.png) * Sobald Sie fertig sind, klicken Sie auf **Speichern**. ### Benutzerdefinierter Ausführungsstatus Wenn eine benutzerdefinierte Funktion ausgeführt wird, kann das Skript einen Statuscode zurückgeben, der erklärt, was während der Ausführung passiert ist. Dies hilft dem Administrator und dem Benutzer zu verstehen, warum ein Workflow ausgeführt, blockiert oder teilweise ausgeführt wurde. Um diese Codes anzuzeigen oder zu definieren, klicken Sie auf **Benutzerdefinierter Ausführungsstatus** in der Kopfzeile des Deluge-Editors. Die folgenden Statuscodes werden unterstützt: Code Bedeutung **1000** Erfolg. Die Funktion wurde ausgeführt und der Workflow wird fortgesetzt. **1001** Fehler. Die Funktion wurde ausgeführt, der Workflow gilt jedoch als fehlgeschlagen. **1002** Abgebrochen. Die Workflow-Aktion wurde von der Funktion abgebrochen. **1003** Ungültige Eingabe. Eine oder mehrere Eingaben für die Funktion waren nicht gültig. **1004** Validierung fehlgeschlagen. Eine geschäftliche Validierung innerhalb der Funktion war nicht erfolgreich. **1005** Fehler beim externen Dienst. Ein Aufruf eines externen Dienstes war nicht erfolgreich. **1006** Berechtigung verweigert. Die Funktion verfügt nicht über die erforderliche Berechtigung, um die Aktion abzuschließen. **1007** Datensatz nicht gefunden. Der von der Funktion referenzierte Datensatz konnte nicht gefunden werden. **1008** Limit überschritten. Ein konfiguriertes Limit, wie etwa die API- oder Deluge-Komponentenverwendung, wurde erreicht. **1009** Unbekannter Fehler. Die Funktion ist aus einem Grund fehlgeschlagen, der von den anderen Codes nicht abgedeckt wird. **Hinweis:** Um benutzerdefinierte Ausführungsstatuscodes zu verwenden, sollte Ihre Funktion eine Map zurückgeben, die einen Statuscode und eine optionale Nachricht enthält. Die zurückgegebene Nachricht wird dem Benutzer angezeigt, wenn der Workflow blockiert wird oder fehlschlägt. ### Deluge-Komponentenverwendung anzeigen Benutzerdefinierte Funktionen werden mit Deluge-Komponenten erstellt, und jede Komponente hat ein von Zoho Books festgelegtes tägliches Nutzungslimit. Um zu überprüfen, wie viel von jeder Komponente Ihre Organisation bisher verwendet hat, klicken Sie auf **Deluge-Komponentenverwendung anzeigen** in der Kopfzeile des Deluge-Editors. Der Bereich **Deluge-Komponentenverwendung (pro Tag)** listet jede Komponente mit ihren Werten für **Gesamt**, **Verwendet** und **Verbleibend** für den aktuellen Tag auf. Die erfassten Komponenten sind: Komponente Beschreibung invoke\_url\_api Anzahl der invokeurl-Aufrufe, die von Ihren benutzerdefinierten Funktionen an externe APIs gesendet wurden. webhook Anzahl der Webhook-Aufrufe, die von Ihren benutzerdefinierten Funktionen ausgelöst wurden. email Anzahl der E-Mails, die von Ihren benutzerdefinierten Funktionen mit der sendmail-Aufgabe gesendet wurden. ### Verbindungen [Verbindungen](/de-de/books/help/settings/connections.html) ermöglichen es Ihnen, Aufrufe aus Ihrem Deluge-Skript an Zoho-Dienste und Drittanbieteranwendungen zu authentifizieren, ohne Anmeldedaten im Skript zu speichern. Um die von Ihren benutzerdefinierten Funktionen verwendeten Verbindungen zu verwalten, klicken Sie auf **Verbindungen** in der Kopfzeile des Deluge-Editors. Sie können neue Verbindungen erstellen, vorhandene bearbeiten und sie in Ihrem Skript über die standardmäßige Deluge-Verbindungssyntax verwenden. * * * ## Funktionen mit Workflow-Regeln verknüpfen Die von Ihnen erstellten Funktionen sollten mit Workflow-Regeln verknüpft werden, damit sie automatisch ausgelöst werden, wenn die erforderlichen Bedingungen erfüllt sind. Um Funktionen mit Workflow-Regeln zu verknüpfen: * Gehen Sie zu **Einstellungen**. * Wählen Sie **Workflow-Regeln** unter _Automatisierung_. * Klicken Sie auf **\+ Neue Workflow-Regel** in der oberen rechten Ecke. * Geben Sie die erforderlichen Details ein. Siehe [Workflow-Regeln](/de-de/books/help/settings/automation/workflow-rules.html). * Wählen Sie unter [**Aktionen**](/de-de/books/help/settings/automation/workflow-rules.html#add-actions) **Funktionen** als _Typ_ und wählen Sie die Funktion aus, die Sie mit der Workflow-Regel verknüpfen möchten. * Klicken Sie auf **Speichern**. Jetzt wird die Workflow-Regel jedes Mal ausgelöst, wenn die Kriterien erfüllt sind, was wiederum die Funktion auslöst. ### Standardfelder Derzeit unterstützen Funktionen die Module Benutzer, Organisation, Angebote, Rechnungen, Verkaufsaufträge, Bestellungen, Kunden, wiederkehrende Rechnungen, Ausgaben, Lieferantenrechnungen, wiederkehrende Lieferantenrechnungen und Artikel. Diese Module verfügen über die folgenden Felder, aus denen Sie die erforderlichen Parameter für Ihre Funktion abrufen können. #### Benutzer Das Benutzerfeld unterstützt die folgenden Parameter: Schlüssel-Felder Beschreibung name Name des Benutzers zuid ZUID des Benutzers ### Organisation Die Organisations-Map unterstützt die folgenden Felder: Schlüssel-Felder Beschreibung organization\_id Ihre Organisations-ID name Organisationsname time\_zone Zeitzone Ihrer Organisation language\_code Sprache der Organisation date\_format Datumsformat Ihrer Organisation currency\_id Währungs-ID currency\_code Währungscode currency\_symbol Währungssymbol address Organisationsadresse phone Kontaktnummer der Organisation fax Faxnummer website URL der Organisation email E-Mail-Adresse portal\_name Portalname Ihrer Organisation **Beispiel-Map:** ``` { "time_zone": "Asia/Calcutta", "language_code": "en", "currency_id": "7605000000000099", "phone": "99999999999", "fax": "check", "website": "", "email": "charles@zylker.com", "address": { "zip": "624001", "country": "India", "city": "New Delhi", "street_address2": "Block 15", "street_address1": "6/35 Garden Lane,", "state": "Delhi" }, "organization_id": "12345678", "name": "Zlyker Industries", "date_format": "dd MMM yyyy", "currency_symbol": "Rs.", "portal_name": "zylkerindustry", "currency_code": "INR" } ``` ### Angebot Die Angebots-Map unterstützt die folgenden Felder: Schlüssel-Felder Beschreibung quote\_id Angebots-ID quote\_number Ihre Angebotsnummer date Angebotsdatum reference\_number Referenznummer Ihres Angebots status Status Ihres Angebots customer\_id ID des Kunden, dem das Angebot zugewiesen ist customer\_name Name Ihres Kunden currency\_id Währungs-ID currency\_code Währungscode currency\_symbol Währungssymbol exchange\_rate Wechselkurs, der im Angebot verwendet wird expiry\_date Ablaufdatum des Angebots discount\_amount Rabattbetrag discount Rabatt shipping\_charge Versandkosten, die im Angebot eingegeben wurden adjustment Anpassungen sub\_total Zwischensumme des Angebots total Gesamtsumme des Angebots tax\_total Gesamter Steuerbetrag im Angebot billing\_address Rechnungsadresse des Kunden shipping\_address Versandadresse des Kunden notes Notizen terms Allgemeine Geschäftsbedingungen custom\_fields Benutzerdefinierte Felder des Angebots salesperson\_id ID des Verkäufers salesperson\_name Name des Verkäufers **Beispiel-Map:** ``` { "total": "12000.0", "terms": “checking", "quote_id": "7605000000320001", "date": "2016-06-03", "quote_number": "EST-000026", "shipping_address": { "zip": "94588", "country": "USA", "address": "4910 Hopyard Rd", "city": "Pleasanton", "state": "CA", "fax": “Fax Number” }, "salesperson_name": “Salesperson”, "adjustment": "0.0", "currency_symbol": "Rs.", "salesperson_id": "7605000000336089", "currency_code": "INR", "shipping_charge": "0.0", "custom_fields": [ { "customfield_id": "7605000000190011", "is_active": true, "show_in_all_pdf": false, "value_formatted": "Check-6", "data_type": "autonumber", "index": 1, "label": "auto number", "show_on_pdf": false, "value": "Check-6" } ], "currency_id": "7605000000000099", "exchange_rate": "1.0", "status": "invoiced", "sub_total": "12000.0", "customer_name": “Customer”, "discount_amount": "0.0", "discount": "0.0", "tax_total": "0.0", "reference_number": “Ref number”, "notes": "Looking forward for your business.", "expiry_date": "2016-06-03", "customer_id": "7605000000258011", "billing_address": { "zip": "94588", "country": "USA", "address": "4910 Hopyard Rd", "city": "Pleasanton", "state": "CA", "fax": "Fax Number" } } ``` ### Rechnung Die Rechnungs-Map unterstützt die folgenden Felder: Schlüssel-Felder Beschreibung due\_date Fälligkeitsdatum der Rechnung payment\_expected\_date Erwartetes Zahlungsdatum für die Rechnung reference\_number Referenznummer der Rechnung customer\_id Kunden-ID customer\_name Name des Kunden, dem die Rechnung zugewiesen ist currency\_id Währungs-ID currency\_code Währungscode currency\_symbol Währungssymbol exchange\_rate Wechselkurs, der in der Rechnung verwendet wird discount\_amount Rabattbetrag, der in der Rechnung enthalten ist discount Rabatt, der in der Rechnung enthalten ist shipping\_charge Versandkosten, die in der Rechnung eingegeben wurden adjustment Anpassungen sub\_total Zwischensumme der Rechnung tax\_total Gesamter Steuerbetrag in der Rechnung total Gesamtbetrag balance Saldo price\_precision Anzahl der Dezimalstellen billing\_address Rechnungsadresse des Kunden shipping\_address Versandadresse des Kunden notes Notizen terms Allgemeine Geschäftsbedingungen custom\_fields Benutzerdefinierte Felder der Rechnung salesperson\_id ID des Verkäufers **Beispiel-Map:** ``` { "total": "0.0", "payment_terms": "0", "terms": “Checking”, "price_precision": "2", "payment_expected_date": "2016-06-31”, "date": "2016-06-30", "shipping_address": { "zip": "94588", "country": "USA", "address": "4910 Hopyard Rd", "city": "Pleasanton", "state": "CA", "fax": "Fax Number" }, "balance": "0.0", "adjustment": "0.0", "currency_symbol": "Rs.", "salesperson_id": “7605000000336089”, "currency_code": "INR", "shipping_charge": "0.0", "custom_fields": [ { "customfield_id": "7605000000336081", "is_active": true, "show_in_all_pdf": false, "value_formatted": "INV-8", "data_type": "autonumber", "index": 1, "label": "AutoNumber", "show_on_pdf": false, "value": "INV-8" }, { "customfield_id": "7605000000351027", "is_active": true, "show_in_all_pdf": true, "value_formatted": "01 Aug 2016", "data_type": "date", "index": 2, "label": "Date", "show_on_pdf": true, "value": "2016-08-01" } ], "currency_id": "7605000000000099", "exchange_rate": "1.0", "status": "draft", "sub_total": "12000.0", "customer_name": “Customer”, "invoice_number": "INV-000087", "discount_amount": "12000.0", "discount": "100.00%", "tax_total": "0.0", "reference_number": “checking”, "due_date": "2016-06-30", "invoice_id": "7605000000369043", "notes": "Thanks for your business.", "customer_id": "7605000000258011", "billing_address": { "zip": "94588", "country": "USA", "address": "4910 Hopyard Rd", "city": "Pleasanton", "state": "CA", "fax": "Fax Number" } } ``` ### Verkaufsauftrag Schlüssel-Felder Beschreibung date Verkaufsauftragsdatum tax\_total Gesamter Steuerbetrag im Verkaufsauftrag zcrm\_potential\_id ID des Potenzials in Zoho CRM discount\_amount Rabattbetrag, der im Verkaufsauftrag enthalten ist salesorder\_id Verkaufsauftrags-ID discount Rabatt shipment\_date Datum, an dem die Lieferung erfolgt billing\_address Rechnungsadresse des Kunden line\_items Positionsartikel currency\_code Währungscode total Gesamtbetrag delivery\_method\_id ID der Liefermethode terms Allgemeine Geschäftsbedingungen delivery\_method Methode der Lieferung shipping\_address Versandadresse des Kunden exchange\_rate Wechselkurs, der im Verkaufsauftrag verwendet wird currency\_symbol Währungssymbol custom\_fields Benutzerdefinierte Felder des Verkaufsauftrags quote\_id Angebots-ID reference\_number Referenznummer des Verkaufsauftrags salesperson\_name Name des beteiligten Verkäufers salesperson\_id ID des beteiligten Verkäufers shipping\_charge Versandkosten, die im Verkaufsauftrag eingegeben wurden salesorder\_number Ihre Verkaufsauftragsnummer sub\_total Zwischensumme des Verkaufsauftrags zcrm\_potential\_name Name des Potenzials in Zoho CRM adjustment Vorgenommene Anpassungen customer\_name Name des Kunden, dem der Verkaufsauftrag zugewiesen ist customer\_id ID des Kunden, dem der Verkaufsauftrag zugewiesen ist currency\_id Währungs-ID status Status Ihres Verkaufsauftrags **Beispiel-Map:** ``` { "date": "2016-05-23", "tax_total": "0.0", "zcrm_potential_id": "", "discount_amount": "1200.0", "salesorder_id": "7605000000295003", "discount": "10.00%", "shipment_date": "2016-05-23", "billing_address": { "zip": "94588", "country": "USA", "address": "4910 Hopyard Rd", "city": "Pleasanton", "state": "CA", "fax": "Fax Number" }, "line_items": [ { "bcy_rate": 12000, "line_item_id": "7605000000295011", "quantity": 1, "item_id": "7605000000259147", "tax_name": "", "description": "", "discount": 0, "item_total": 12000, "item_custom_fields": [ ], "tax_id": "", "is_invoiced": true, "item_order": 0, "tags": [ ], "stock_on_hand": "", "unit": "", "rate": 12000, "tax_type": "tax", "name": "Moto", "tax_percentage": 0 } ], "currency_code": "INR", "total": "10820.0", "delivery_method_id": "7605000000461053", "terms": "Terms & Conditions", "delivery_method": "Door Delivery", "shipping_address": { "zip": "", "country": "", "address": "", "city": "", "state": "", "fax": "" }, "exchange_rate": "1.0", "currency_symbol": "Rs.", "custom_fields": [ { "customfield_id": "7605000000321009", "is_active": true, "show_in_all_pdf": true, "value_formatted": "Text", "data_type": "string", "index": 1, "label": "Text", "show_on_pdf": true, "value": "Text" } ], "quote_id": "7605000000405047", "reference_number": "Reference", "salesperson_name": "Arun", "salesperson_id": "7605000000135003", "shipping_charge": "10.0", "salesorder_number": "SO-00002", "sub_total": "12000.0", "zcrm_potential_name": "", "adjustment": "10.0", "customer_name": "Arun", "customer_id": "7605000000101007", "currency_id": "7605000000000099", "status": "invoiced" } ``` ### Bestellung Die Bestell-Map unterstützt die folgenden Felder: Schlüssel-Felder Beschreibung date Datum der Bestellung delivery\_address Lieferadresse tax\_total Gesamter Steuerbetrag in der Bestellung delivery\_org\_address\_id ID der Lieferorganisationsadresse purchaseorder\_id Bestell-ID expected\_delivery\_date Erwartetes Lieferdatum billing\_address Rechnungsadresse der Bestellung line\_items Positionsartikel in der Bestellung currency\_code Währungscode total Gesamtbetrag der Bestellung delivery\_customer\_id Lieferkunden-ID exchange\_rate Wechselkurs, der in der Bestellung verwendet wird currency\_symbol Währungssymbol custom\_fields Benutzerdefinierte Felder der Bestellung ship\_via\_id ID der Versandart vendor\_name Name des Lieferanten reference\_number Referenznummer Ihrer Bestellung purchaseorder\_number Bestellnummer delivery\_date Lieferdatum vendor\_id Lieferanten-ID sub\_total Zwischensumme der Bestellung ship\_via Versandart attention Zu Händen von crm\_owner\_id ID des Zoho CRM-Besitzers currency\_id Währungs-ID status Status **Beispiel-Map:** ``` { "date": "2016-07-11", "delivery_address": { "zip": "94588", "country": "USA", "address": "4910 Hopyard Rd", "city": "Pleasanton", "state": "CA", "fax": "Fax Number" }, "tax_total": "0.0", "delivery_org_address_id": "7605000000054013", "purchaseorder_id": "7605000000378500", "expected_delivery_date": "", "billing_address": { "zip": "94588", "country": "USA", "address": "4910 Hopyard Rd", "city": "Pleasanton", "state": "CA", "fax": "Fax Number" }, "line_items": [ { "bcy_rate": 1000, "line_item_id": "7605000000378504", "quantity": 1, "item_id": "7605000000298021", "tax_name": "", "description": "", "item_total": 1000, "tax_id": "", "item_order": 0, "tags": [ ], "unit": "No", "account_id": "7605000000000403", "rate": 1000, "tax_type": "tax", "account_name": "Advertising And Marketing", "name": "Moto G Turbo Edition", "tax_percentage": 0 } ], "currency_code": "INR", "total": "1000.0", "delivery_customer_id": "", "exchange_rate": "1.0", "currency_symbol": "Rs.", "custom_fields": "[]", "ship_via_id": "7605000000461053", "vendor_name": "Mr. Vendor", "reference_number": "Reference", "purchaseorder_number": "PO-00006", "delivery_date": "2016-07-11", "vendor_id": "7605000000112009", "sub_total": "1000.0", "ship_via": "Door Delivery", "attention": "Arun", "crm_owner_id": "", "currency_id": "7605000000000099", "status": "billed" } ``` ### Kunde Die Kunden-Map unterstützt die folgenden Felder: Schlüssel-Felder Beschreibung owner\_id ID des zugehörigen Eigentümers billing\_address Rechnungsadresse, die mit dem Kunden verbunden ist source Quelle des Kunden contact\_id Kontakt-ID payment\_terms Zahlungsbedingungen, die mit dem Kunden verbunden sind currency\_code Währungscode language\_code Sprachcode contact\_type Art des Kontakts twitter Twitter-Informationen zcrm\_contact\_id ID des Kontakts in Zoho CRM shipping\_address Versandadresse, die mit dem Kunden verbunden ist pricebook\_id ID des zugeordneten Preisbuchs contact\_name Name des Kontakts website Website des Kontakts owner\_name Name des Kontaktinhabers currency\_symbol Währungssymbol zcrm\_account\_id ID des Zoho CRM-Kontos custom\_fields Benutzerdefinierte Felder, die mit dem Kunden verbunden sind facebook Facebook-Informationen pricebook\_name Name des zugeordneten Preisbuchs primary\_contact\_id ID des primären Kontakts company\_name Name des Unternehmens contact\_salutation Anrede des Kontakts crm\_owner\_id ID des CRM-Eigentümers currency\_id Währungs-ID payment\_terms\_label Bezeichnung der Zahlungsbedingungen status Status **Beispiel-Map:** ``` { "owner_id": "", "shipping_address": { "zip": "94588", "country": "USA", "address": "4910 Hopyard Rd", "city": "Pleasanton", "state": "CA", "fax": "Fax Number" }, "source": "user", "contact_id": "7605000000197147", "payment_terms": "0", "currency_code": "INR", "language_code": "en", "contact_type": "customer", "twitter": "", "zcrm_contact_id": "", "billing_address": { "zip": "94588", "country": "USA", "address": "4910 Hopyard Rd", "city": "Pleasanton", "state": "CA", "fax": "Fax Number" }, "pricebook_id": "", "contact_name": "Arun", "website": "www.zoho.com", "owner_name": "", "currency_symbol": "Rs.", "zcrm_account_id": "418070000000135001", "custom_fields": [ { "customfield_id": "7605000000063049", "is_active": true, "show_in_all_pdf": false, "value_formatted": "1234", "data_type": "number", "index": 1, "label": "Unpaid Invoices", "show_on_pdf": false, "value": "1234" } ], "facebook": "", "pricebook_name": "", "primary_contact_id": "7605000000197149", "company_name": "Zoho", "contact_salutation": "", "crm_owner_id": "", "currency_id": "7605000000000099", "payment_terms_label": "Due on Receipt", "status": "active" } ``` ### Wiederkehrende Rechnung Die Map für wiederkehrende Rechnungen unterstützt die folgenden Felder: Schlüssel-Felder Beschreibung end\_date Enddatum des Profils für wiederkehrende Rechnungen tax\_total Gesamter Steuerbetrag in der wiederkehrenden Rechnung discount\_amount Rabattbetrag, der in der wiederkehrenden Rechnung enthalten ist repeat\_every Wiederholungszeitraum des Profils für wiederkehrende Rechnungen discount Rabatt, der in der wiederkehrenden Rechnung enthalten ist taxes Steuern, die mit der wiederkehrenden Rechnung verbunden sind billing\_address Rechnungsadresse des Kunden line\_items Positionsartikel in der wiederkehrenden Rechnung payment\_terms Zahlungsbedingungen, die mit dem Kunden verbunden sind currency\_code Währungscode last\_sent\_date Datum der zuletzt gesendeten Rechnung total Gesamtbetrag recurrence\_name Name des Profils für wiederkehrende Rechnungen shipping\_address Versandadresse des Kunden next\_invoice\_date Datum der nächsten zu sendenden Rechnung recurrence\_frequency Häufigkeit des Profils für wiederkehrende Rechnungen recurring\_invoice\_id ID des Profils für wiederkehrende Rechnungen contact\_persons Kontaktpersonen, die an der wiederkehrenden Rechnung beteiligt sind start\_date Startdatum des Profils für wiederkehrende Rechnungen exchange\_rate Wechselkurs, der in der wiederkehrenden Rechnung verwendet wird currency\_symbol Währungssymbol custom\_fields Benutzerdefinierte Felder der wiederkehrenden Rechnung salesperson\_name Name des beteiligten Verkäufers salesperson\_id ID des beteiligten Verkäufers shipping\_charge Versandkosten, die in der wiederkehrenden Rechnung eingegeben wurden sub\_total Zwischensumme der wiederkehrenden Rechnung adjustment Vorgenommene Anpassungen customer\_name Name des beteiligten Kunden customer\_id ID des beteiligten Kunden status Status des Profils für wiederkehrende Rechnungen **Beispiel-Map:** ``` { "end_date": "2016-10-15", "tax_total": "0.0", "discount_amount": "1.0", "repeat_every": "2", "discount": "1.00%", "taxes": "[]", "billing_address": {"zip":"","fax":"","address":"","state":"","country":"","city":""}, "line_items": [{"tags":[],"tax_name":"","tax_type":"tax","item_custom_fields":[],"product_type":"service","line_item_id":"348960000000103013","discount":0,"unit":"","item_order":0,"rate":100,"item_id":"","description":"%(d)%-%(m-2)%-%(y)%","name":"","quantity":1,"tax_id":"","tax_percentage":0,"item_total":100}], "payment_terms": "0", "currency_code": "GBP", "last_sent_date": "", "total": "200.0", "recurrence_name": "1", "shipping_address": {"zip":"","fax":"","address":"","state":"","country":"","city":""}, "next_invoice_date": "", "recurrence_frequency": "months", "recurring_invoice_id": "348960000000103005", "contact_persons": "[]", "start_date": "2016-01-07", "exchange_rate": "1.0", "currency_symbol": "£", "custom_fields": [{"value_formatted":"EST-001","index":1,"is_active":true,"data_type":"string","show_on_pdf":false,"value":"EST-001","show_in_all_pdf":false,"label":"Quote Number","customfield_id":"348960000000056001"},{"value_formatted":"15 Oct 2016","index":2,"is_active":true,"data_type":"date","show_on_pdf":false,"value":"2016-10-15","show_in_all_pdf":false,"label":"Date","customfield_id":"348960000000056003"},{"value_formatted":"true","index":3,"is_active":true,"data_type":"check_box","show_on_pdf":false,"value":true,"show_in_all_pdf":false,"label":"Invoice Factoring","customfield_id":"348960000000056079"},{"value_formatted":"£100.00","index":4,"is_active":true,"data_type":"amount","show_on_pdf":true,"value":100,"show_in_all_pdf":true,"label":"Amount","customfield_id":"348960000000060003"},{"value_formatted":"10%","index":5,"is_active":true,"data_type":"percent","show_on_pdf":true,"value":10,"show_in_all_pdf":true,"label":"Percentage","customfield_id":"348960000000060005"}], "salesperson_name": "Arun N", "salesperson_id": "348960000000111001", "shipping_charge": "100.0", "sub_total": "100.0", "adjustment": "1.0", "customer_name": "iArun", "customer_id": "348960000000051041", "status": "expired" } ``` ### Ausgabe Die Ausgaben-Map unterstützt die folgenden Felder: Schlüssel-Felder Beschreibung date Datum payment\_mode Zahlungsmodus custom\_fields Benutzerdefinierte Felder der Ausgabe vendor\_name Name des beteiligten Lieferanten is\_billable Abrechenbarkeit der Ausgabe line\_items Positionsartikel in der Ausgabe project\_name Name des beteiligten Projekts reference\_number Referenznummer der Ausgabe currency\_code Währungscode total Gesamt project\_id ID des beteiligten Projekts vendor\_id ID des beteiligten Lieferanten sub\_total Zwischensumme der Ausgabe customer\_name Name des beteiligten Kunden customer\_id ID des beteiligten Kunden expense\_id Ausgaben-ID currency\_id Währungs-ID **Beispiel-Map:** ``` { "date": "2016-10-08", "payment_mode": "Cash", "custom_fields": "[]", "vendor_name": "Vendor", "is_billable": "true", "line_items": [{"tags":[],"tax_name":"Standard Rate","item_order":1,"tax_type":"tax","account_id":"348960000000000400","description":"Notes","tax_amount":16.67,"product_type":"goods","tax_id":"348960000000044037","line_item_id":"348960000000184015","tax_percentage":20,"item_total":83.33,"account_name":"Office Supplies"}], "project_name": "", "reference_number": "12345", "currency_code": "GBP", "total": "100.0", "project_id": "", "vendor_id": "348960000000051033", "sub_total": "83.33", "customer_name": "Accounts", "customer_id": "348960000000111017", "expense_id": "348960000000184003", "currency_id": "348960000000000103" } ``` ### Lieferantenrechnung Die Lieferantenrechnungs-Map unterstützt die folgenden Felder: Schlüssel-Felder Beschreibung date Datum auf der Lieferantenrechnung bill\_id ID der Lieferantenrechnung purchaseorder\_ids ID der beteiligten Bestellung tax\_total Gesamter Steuerbetrag in der Lieferantenrechnung exchange\_rate Wechselkurs, der in der Lieferantenrechnung verwendet wird currency\_symbol Währungssymbol custom\_fields Benutzerdefinierte Felder der Lieferantenrechnung due\_date Fälligkeitsdatum der Lieferantenrechnung vendor\_name Name des beteiligten Lieferanten billing\_address Rechnungsadresse line\_items Positionsartikel in der Lieferantenrechnung payment\_terms Zahlungsbedingungen, die mit dem Lieferanten verbunden sind payment\_expected\_date Erwartetes Zahlungsdatum reference\_number Referenznummer der Lieferantenrechnung currency\_code Währungscode total Gesamt auf der Lieferantenrechnung bill\_number Lieferantenrechnungsnummer payment\_made Geleistete Zahlung für die Lieferantenrechnung balance Saldobetrag recurring\_bill\_id ID des Profils für wiederkehrende Lieferantenrechnungen vendor\_id ID des beteiligten Lieferanten sub\_total Zwischensumme auf der Lieferantenrechnung status Status der Lieferantenrechnung **Beispiel-Map:** ``` { "date": "2016-10-12", "bill_id": "348960000000193039", "purchaseorder_ids": "[]", "tax_total": "0.0", "exchange_rate": "1.0", "currency_symbol": "£", "custom_fields": "[]", "due_date": "2016-10-15", "vendor_name": "Vendor", "billing_address": {"zip":"","fax":"","address":"","state":"","country":"","city":""}, "line_items": [{"tags":[],"tax_name":"","project_name":"","tax_type":"tax","account_id":"348960000000000412","customer_name":"","is_billable":false,"product_type":"goods","line_item_id":"348960000000193047","invoice_number":"","sku":"","purchaseorder_item_id":"","account_name":"Credit Card Charges","unit":"1","item_order":0,"rate":33000,"bcy_rate":33000,"item_id":"348960000000087031","description":"","project_id":"","name":"refrigerator","tax_id":"","quantity":1,"invoice_id":"","tax_percentage":0,"customer_id":"","item_total":33000}], "payment_terms": "3", "payment_expected_date": "", "reference_number": "1", "currency_code": "GBP", "total": "33000.0", "bill_number": "Bill-001", "payment_made": "0.0", "balance": "33000.0", "recurring_bill_id": "", "vendor_id": "348960000000051033", "sub_total": "33000.0", "status": "open" } ``` ### Wiederkehrende Lieferantenrechnung Die Map für wiederkehrende Lieferantenrechnungen unterstützt die folgenden Felder: Schlüssel-Felder Beschreibung end\_date Enddatum des Profils für wiederkehrende Lieferantenrechnungen tax\_total Gesamter Steuerbetrag in der wiederkehrenden Lieferantenrechnung exchange\_rate Wechselkurs, der in der wiederkehrenden Lieferantenrechnung verwendet wird custom\_fields Benutzerdefinierte Felder der wiederkehrenden Lieferantenrechnung repeat\_every Wiederholungszeitraum des Profils für wiederkehrende Lieferantenrechnungen taxes Steuern, die in der wiederkehrenden Lieferantenrechnung enthalten sind vendor\_name Name des beteiligten Lieferanten line\_items Positionsartikel in der wiederkehrenden Lieferantenrechnung payment\_terms Zahlungsbedingungen, die mit dem Lieferanten verbunden sind currency\_code Währungscode last\_sent\_date Datum der zuletzt gesendeten Lieferantenrechnung total Gesamtsumme der wiederkehrenden Lieferantenrechnung next\_bill\_date Datum der nächsten Lieferantenrechnung recurring\_bill\_id ID der wiederkehrenden Lieferantenrechnung recurrence\_name Name des Profils für wiederkehrende Lieferantenrechnungen vendor\_id ID des beteiligten Lieferanten sub\_total Zwischensumme auf der wiederkehrenden Lieferantenrechnung recurrence\_frequency Häufigkeit des Profils für wiederkehrende Rechnungen payment\_terms\_label Bezeichnung der Zahlungsbedingungen status Status des Profils für wiederkehrende Lieferantenrechnungen start\_date Startdatum des Profils für wiederkehrende Lieferantenrechnungen **Beispiel-Map:** ``` { "end_date": "2016-10-15", "tax_total": "0.0", "exchange_rate": "1.0", "custom_fields": "[]", "repeat_every": "1", "taxes": "[]", "vendor_name": "Vendor", "line_items": [{"tags":[],"tax_name":"","account_id":"348960000000000403","tax_type":"tax","product_type":"goods","line_item_id":"348960000000193067","account_name":"Advertising And Marketing","unit":"","item_order":0,"rate":900,"bcy_rate":900,"item_id":"348960000000051011","description":"","name":"Item","quantity":1,"tax_id":"","tax_percentage":0,"item_total":900}], "payment_terms": "0", "currency_code": "GBP", "last_sent_date": "2016-10-12", "total": "900.0", "next_bill_date": "", "recurring_bill_id": "348960000000193061", "recurrence_name": "RB-001", "vendor_id": "348960000000051033", "sub_total": "900.0", "recurrence_frequency": "weeks", "payment_terms_label": "Due on Receipt", "status": "expired", "start_date": "2016-10-12" } ``` ### Artikel Die Artikel-Map unterstützt die folgenden Felder: Schlüssel-Felder Beschreibung item\_id Artikel-ID custom\_fields Benutzerdefinierte Felder des Artikels item\_type Art des Artikels tax\_name Name der beteiligten Steuer purchase\_rate Einkaufspreis des Artikels zcrm\_product\_id ID des Produkts in Zoho CRM tax\_id ID der beteiligten Steuer unit Einheit des Artikels account\_id Verkaufskonto-ID purchase\_account\_name Name des Einkaufskontos purchase\_account\_id Einkaufskonto-ID tax\_type Art der beteiligten Steuer rate Verkaufspreis des Artikels account\_name Name des beteiligten Verkaufskontos name Name des Artikels tax\_percentage Prozentsatz der beteiligten Steuer pricebook\_rate Preisbuchpreis sku SKU des Artikels status Status des Artikels **Beispiel-Map:** ``` { "item_id": "348960000000051011", "custom_fields": [{"value_formatted":"100","index":1,"is_active":true,"data_type":"decimal","show_on_pdf":true,"value":100,"show_in_all_pdf":true,"label":"Profit","customfield_id":"348960000000134003"}], "item_type": "sales_and_purchases", "tax_name": "", "purchase_rate": "900.0", "zcrm_product_id": "1665395000000205001", "tax_id": "", "unit": "1", "account_id": "348960000000000388", "purchase_account_name": "Advertising And Marketing", "purchase_account_id": "348960000000000403", "tax_type": "", "rate": "1000.0", "account_name": "Sales", "name": "Item", "tax_percentage": "0", "pricebook_rate": "1000.0", "sku": "SKU", "status": "active" } ``` Einige Beispiele, die erklären, wie diese Felder beim Abrufen der erforderlichen Parameter helfen würden: **Beispiel 1:** Um die Angebots-ID abzurufen, verwenden Sie: ``` quoteid = quote.get("quote_id"); ``` **Beispiel 2:** Um den Namen Ihrer Organisation abzurufen, verwenden Sie: ``` orgid = organization.get("name"); ``` **Beispiel 3:** Um den Namen und die ZUID eines Benutzers abzurufen, verwenden Sie: ``` username = user.get("name"); zuid = user.get("zuid"); ``` Um mehr darüber zu erfahren, wie Sie Deluge-Skripte zum Schreiben von Funktionen verwenden, lesen Sie das [Deluge-Referenzhandbuch](https://creator.zoho.com/learndeluge/). Um mehr über verschiedene Szenarien zu erfahren, in denen Funktionen nützlich sein könnten, besuchen Sie die Seite [Funktionsszenarien](/de-de/books/help/settings/automation-scenarios.html#custom-function-scenarios). * * * ## Funktionen bearbeiten Wenn Sie die Details einer Funktion aktualisieren möchten, können Sie sie bearbeiten. So geht’s: * Gehen Sie zu **Einstellungen** in der oberen rechten Ecke der Seite. * Wählen Sie **Workflow-Aktionen** unter _Automatisierung_. * Wählen Sie im Bereich _Workflow-Aktionen_ **Funktionen**. * Fahren Sie mit der Maus über die Funktion, die Sie bearbeiten möchten, klicken Sie auf das Dropdown-Menü rechts und wählen Sie **Bearbeiten**. * Nehmen Sie die erforderlichen Änderungen vor und klicken Sie auf **Speichern**. * * * ## Funktionen filtern Sie können Funktionen leicht finden, indem Sie sie nach dem Modul filtern, für das sie erstellt wurden. Um Funktionen zu filtern: * Gehen Sie zu **Einstellungen** in der oberen rechten Ecke der Seite. * Wählen Sie **Workflow-Aktionen** unter _Automatisierung_. * Wählen Sie im Bereich _Workflow-Aktionen_ **Funktionen**. * Wählen Sie unter **Modul** ein Modul aus dem Dropdown-Menü aus. Die für das ausgewählte Modul erstellten Funktionen werden angezeigt. * * * ## Funktionen löschen **Warnung:** Das Löschen einer Funktion ist endgültig und kann nicht rückgängig gemacht werden. Wenn die Funktion mit einer Workflow-Regel verknüpft ist, wird die Workflow-Regel nicht ausgeführt. Wenn Sie bestimmte Funktionen nicht mehr benötigen, können Sie sie löschen. So geht’s: * Gehen Sie zu **Einstellungen** in der oberen rechten Ecke der Seite. * Wählen Sie **Workflow-Aktionen** unter _Automatisierung_. * Wählen Sie im Bereich _Workflow-Aktionen_ **Funktionen**. * Fahren Sie mit der Maus über die Funktion, die Sie löschen möchten, klicken Sie auf das Dropdown-Menü rechts und wählen Sie **Löschen**. * Bestätigen Sie Ihre Aktion, indem Sie im Pop-up auf **Löschen** klicken. * * * ## Verwandte Themen * [Workflow-Regeln](/de-de/books/help/settings/automation/workflow-rules.html) * [E-Mail-Benachrichtigungen](/de-de/books/help/settings/automation/workflow-actions/email-alerts.html) * [Feldaktualisierungen](/de-de/books/help/settings/automation/workflow-actions/field-updates.html) * [In-App-Benachrichtigungen](/de-de/books/help/settings/automation/workflow-actions/in-app-notifications.html) * [Webhooks](/de-de/books/help/settings/automation/workflow-actions/webhooks.html) * [Zeitpläne](/de-de/books/help/settings/automation/schedules.html) * [Workflow-Protokolle](/de-de/books/help/settings/automation/workflow-logs.html)