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.
Wenn Sie Deluge lernen möchten, indem Sie Codebeispiele schreiben, lesen Sie den Leitfaden mit Deluge-Codebeispielen.
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.

- 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 eingeben. Sie können Kontextmethoden verwenden, um mit Plattformfunktionen wie Protokollierung, Caching, Warteschlangen, Dateispeicher, geplanter Ausführung und Drittanbieter-Connectors zu interagieren.

- 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. |
| Anzahl der E-Mails, die von Ihren benutzerdefinierten Funktionen mit der sendmail-Aufgabe gesendet wurden. |
Verbindungen
Verbindungen 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.
- Wählen Sie unter Aktionen 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 |
| 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-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-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.
Um mehr über verschiedene Szenarien zu erfahren, in denen Funktionen nützlich sein könnten, besuchen Sie die Seite Funktionsszenarien.
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.