Zoho books Logo Hilfedokumente
/

Dieses Dokument wurde mit KI übersetzt, um Ihnen den Zugang in Ihrer Sprache zu erleichtern. Für die genauesten Informationen möchten Sie vielleicht auf die englische Version verweisen oder schreiben Sie uns an support@eu.zohobooks.com.

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.
Schaltfläche Neue Funktion
  • 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.
Neue vordefinierte Verbindung
  • 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:

CodeBedeutung
1000Erfolg. Die Funktion wurde ausgeführt und der Workflow wird fortgesetzt.
1001Fehler. Die Funktion wurde ausgeführt, der Workflow gilt jedoch als fehlgeschlagen.
1002Abgebrochen. Die Workflow-Aktion wurde von der Funktion abgebrochen.
1003Ungültige Eingabe. Eine oder mehrere Eingaben für die Funktion waren nicht gültig.
1004Validierung fehlgeschlagen. Eine geschäftliche Validierung innerhalb der Funktion war nicht erfolgreich.
1005Fehler beim externen Dienst. Ein Aufruf eines externen Dienstes war nicht erfolgreich.
1006Berechtigung verweigert. Die Funktion verfügt nicht über die erforderliche Berechtigung, um die Aktion abzuschließen.
1007Datensatz nicht gefunden. Der von der Funktion referenzierte Datensatz konnte nicht gefunden werden.
1008Limit überschritten. Ein konfiguriertes Limit, wie etwa die API- oder Deluge-Komponentenverwendung, wurde erreicht.
1009Unbekannter 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:

KomponenteBeschreibung
invoke_url_apiAnzahl der invokeurl-Aufrufe, die von Ihren benutzerdefinierten Funktionen an externe APIs gesendet wurden.
webhookAnzahl der Webhook-Aufrufe, die von Ihren benutzerdefinierten Funktionen ausgelöst wurden.
emailAnzahl 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-FelderBeschreibung
nameName des Benutzers
zuidZUID des Benutzers

Organisation

Die Organisations-Map unterstützt die folgenden Felder:

Schlüssel-FelderBeschreibung
organization_idIhre Organisations-ID
nameOrganisationsname
time_zoneZeitzone Ihrer Organisation
language_codeSprache der Organisation
date_formatDatumsformat Ihrer Organisation
currency_idWährungs-ID
currency_codeWährungscode
currency_symbolWährungssymbol
addressOrganisationsadresse
phoneKontaktnummer der Organisation
faxFaxnummer
websiteURL der Organisation
emailE-Mail-Adresse
portal_namePortalname 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-FelderBeschreibung
quote_idAngebots-ID
quote_numberIhre Angebotsnummer
dateAngebotsdatum
reference_numberReferenznummer Ihres Angebots
statusStatus Ihres Angebots
customer_idID des Kunden, dem das Angebot zugewiesen ist
customer_nameName Ihres Kunden
currency_idWährungs-ID
currency_codeWährungscode
currency_symbolWährungssymbol
exchange_rateWechselkurs, der im Angebot verwendet wird
expiry_dateAblaufdatum des Angebots
discount_amountRabattbetrag
discountRabatt
shipping_chargeVersandkosten, die im Angebot eingegeben wurden
adjustmentAnpassungen
sub_totalZwischensumme des Angebots
totalGesamtsumme des Angebots
tax_totalGesamter Steuerbetrag im Angebot
billing_addressRechnungsadresse des Kunden
shipping_addressVersandadresse des Kunden
notesNotizen
termsAllgemeine Geschäftsbedingungen
custom_fieldsBenutzerdefinierte Felder des Angebots
salesperson_idID des Verkäufers
salesperson_nameName 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-FelderBeschreibung
due_dateFälligkeitsdatum der Rechnung
payment_expected_dateErwartetes Zahlungsdatum für die Rechnung
reference_numberReferenznummer der Rechnung
customer_idKunden-ID
customer_nameName des Kunden, dem die Rechnung zugewiesen ist
currency_idWährungs-ID
currency_codeWährungscode
currency_symbolWährungssymbol
exchange_rateWechselkurs, der in der Rechnung verwendet wird
discount_amountRabattbetrag, der in der Rechnung enthalten ist
discountRabatt, der in der Rechnung enthalten ist
shipping_chargeVersandkosten, die in der Rechnung eingegeben wurden
adjustmentAnpassungen
sub_totalZwischensumme der Rechnung
tax_totalGesamter Steuerbetrag in der Rechnung
totalGesamtbetrag
balanceSaldo
price_precisionAnzahl der Dezimalstellen
billing_addressRechnungsadresse des Kunden
shipping_addressVersandadresse des Kunden
notesNotizen
termsAllgemeine Geschäftsbedingungen
custom_fieldsBenutzerdefinierte Felder der Rechnung
salesperson_idID 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-FelderBeschreibung
dateVerkaufsauftragsdatum
tax_totalGesamter Steuerbetrag im Verkaufsauftrag
zcrm_potential_idID des Potenzials in Zoho CRM
discount_amountRabattbetrag, der im Verkaufsauftrag enthalten ist
salesorder_idVerkaufsauftrags-ID
discountRabatt
shipment_dateDatum, an dem die Lieferung erfolgt
billing_addressRechnungsadresse des Kunden
line_itemsPositionsartikel
currency_codeWährungscode
totalGesamtbetrag
delivery_method_idID der Liefermethode
termsAllgemeine Geschäftsbedingungen
delivery_methodMethode der Lieferung
shipping_addressVersandadresse des Kunden
exchange_rateWechselkurs, der im Verkaufsauftrag verwendet wird
currency_symbolWährungssymbol
custom_fieldsBenutzerdefinierte Felder des Verkaufsauftrags
quote_idAngebots-ID
reference_numberReferenznummer des Verkaufsauftrags
salesperson_nameName des beteiligten Verkäufers
salesperson_idID des beteiligten Verkäufers
shipping_chargeVersandkosten, die im Verkaufsauftrag eingegeben wurden
salesorder_numberIhre Verkaufsauftragsnummer
sub_totalZwischensumme des Verkaufsauftrags
zcrm_potential_nameName des Potenzials in Zoho CRM
adjustmentVorgenommene Anpassungen
customer_nameName des Kunden, dem der Verkaufsauftrag zugewiesen ist
customer_idID des Kunden, dem der Verkaufsauftrag zugewiesen ist
currency_idWährungs-ID
statusStatus 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-FelderBeschreibung
dateDatum der Bestellung
delivery_addressLieferadresse
tax_totalGesamter Steuerbetrag in der Bestellung
delivery_org_address_idID der Lieferorganisationsadresse
purchaseorder_idBestell-ID
expected_delivery_dateErwartetes Lieferdatum
billing_addressRechnungsadresse der Bestellung
line_itemsPositionsartikel in der Bestellung
currency_codeWährungscode
totalGesamtbetrag der Bestellung
delivery_customer_idLieferkunden-ID
exchange_rateWechselkurs, der in der Bestellung verwendet wird
currency_symbolWährungssymbol
custom_fieldsBenutzerdefinierte Felder der Bestellung
ship_via_idID der Versandart
vendor_nameName des Lieferanten
reference_numberReferenznummer Ihrer Bestellung
purchaseorder_numberBestellnummer
delivery_dateLieferdatum
vendor_idLieferanten-ID
sub_totalZwischensumme der Bestellung
ship_viaVersandart
attentionZu Händen von
crm_owner_idID des Zoho CRM-Besitzers
currency_idWährungs-ID
statusStatus

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-FelderBeschreibung
owner_idID des zugehörigen Eigentümers
billing_addressRechnungsadresse, die mit dem Kunden verbunden ist
sourceQuelle des Kunden
contact_idKontakt-ID
payment_termsZahlungsbedingungen, die mit dem Kunden verbunden sind
currency_codeWährungscode
language_codeSprachcode
contact_typeArt des Kontakts
twitterTwitter-Informationen
zcrm_contact_idID des Kontakts in Zoho CRM
shipping_addressVersandadresse, die mit dem Kunden verbunden ist
pricebook_idID des zugeordneten Preisbuchs
contact_nameName des Kontakts
websiteWebsite des Kontakts
owner_nameName des Kontaktinhabers
currency_symbolWährungssymbol
zcrm_account_idID des Zoho CRM-Kontos
custom_fieldsBenutzerdefinierte Felder, die mit dem Kunden verbunden sind
facebookFacebook-Informationen
pricebook_nameName des zugeordneten Preisbuchs
primary_contact_idID des primären Kontakts
company_nameName des Unternehmens
contact_salutationAnrede des Kontakts
crm_owner_idID des CRM-Eigentümers
currency_idWährungs-ID
payment_terms_labelBezeichnung der Zahlungsbedingungen
statusStatus

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-FelderBeschreibung
end_dateEnddatum des Profils für wiederkehrende Rechnungen
tax_totalGesamter Steuerbetrag in der wiederkehrenden Rechnung
discount_amountRabattbetrag, der in der wiederkehrenden Rechnung enthalten ist
repeat_everyWiederholungszeitraum des Profils für wiederkehrende Rechnungen
discountRabatt, der in der wiederkehrenden Rechnung enthalten ist
taxesSteuern, die mit der wiederkehrenden Rechnung verbunden sind
billing_addressRechnungsadresse des Kunden
line_itemsPositionsartikel in der wiederkehrenden Rechnung
payment_termsZahlungsbedingungen, die mit dem Kunden verbunden sind
currency_codeWährungscode
last_sent_dateDatum der zuletzt gesendeten Rechnung
totalGesamtbetrag
recurrence_nameName des Profils für wiederkehrende Rechnungen
shipping_addressVersandadresse des Kunden
next_invoice_dateDatum der nächsten zu sendenden Rechnung
recurrence_frequencyHäufigkeit des Profils für wiederkehrende Rechnungen
recurring_invoice_idID des Profils für wiederkehrende Rechnungen
contact_personsKontaktpersonen, die an der wiederkehrenden Rechnung beteiligt sind
start_dateStartdatum des Profils für wiederkehrende Rechnungen
exchange_rateWechselkurs, der in der wiederkehrenden Rechnung verwendet wird
currency_symbolWährungssymbol
custom_fieldsBenutzerdefinierte Felder der wiederkehrenden Rechnung
salesperson_nameName des beteiligten Verkäufers
salesperson_idID des beteiligten Verkäufers
shipping_chargeVersandkosten, die in der wiederkehrenden Rechnung eingegeben wurden
sub_totalZwischensumme der wiederkehrenden Rechnung
adjustmentVorgenommene Anpassungen
customer_nameName des beteiligten Kunden
customer_idID des beteiligten Kunden
statusStatus 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-FelderBeschreibung
dateDatum
payment_modeZahlungsmodus
custom_fieldsBenutzerdefinierte Felder der Ausgabe
vendor_nameName des beteiligten Lieferanten
is_billableAbrechenbarkeit der Ausgabe
line_itemsPositionsartikel in der Ausgabe
project_nameName des beteiligten Projekts
reference_numberReferenznummer der Ausgabe
currency_codeWährungscode
totalGesamt
project_idID des beteiligten Projekts
vendor_idID des beteiligten Lieferanten
sub_totalZwischensumme der Ausgabe
customer_nameName des beteiligten Kunden
customer_idID des beteiligten Kunden
expense_idAusgaben-ID
currency_idWä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-FelderBeschreibung
dateDatum auf der Lieferantenrechnung
bill_idID der Lieferantenrechnung
purchaseorder_idsID der beteiligten Bestellung
tax_totalGesamter Steuerbetrag in der Lieferantenrechnung
exchange_rateWechselkurs, der in der Lieferantenrechnung verwendet wird
currency_symbolWährungssymbol
custom_fieldsBenutzerdefinierte Felder der Lieferantenrechnung
due_dateFälligkeitsdatum der Lieferantenrechnung
vendor_nameName des beteiligten Lieferanten
billing_addressRechnungsadresse
line_itemsPositionsartikel in der Lieferantenrechnung
payment_termsZahlungsbedingungen, die mit dem Lieferanten verbunden sind
payment_expected_dateErwartetes Zahlungsdatum
reference_numberReferenznummer der Lieferantenrechnung
currency_codeWährungscode
totalGesamt auf der Lieferantenrechnung
bill_numberLieferantenrechnungsnummer
payment_madeGeleistete Zahlung für die Lieferantenrechnung
balanceSaldobetrag
recurring_bill_idID des Profils für wiederkehrende Lieferantenrechnungen
vendor_idID des beteiligten Lieferanten
sub_totalZwischensumme auf der Lieferantenrechnung
statusStatus 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-FelderBeschreibung
end_dateEnddatum des Profils für wiederkehrende Lieferantenrechnungen
tax_totalGesamter Steuerbetrag in der wiederkehrenden Lieferantenrechnung
exchange_rateWechselkurs, der in der wiederkehrenden Lieferantenrechnung verwendet wird
custom_fieldsBenutzerdefinierte Felder der wiederkehrenden Lieferantenrechnung
repeat_everyWiederholungszeitraum des Profils für wiederkehrende Lieferantenrechnungen
taxesSteuern, die in der wiederkehrenden Lieferantenrechnung enthalten sind
vendor_nameName des beteiligten Lieferanten
line_itemsPositionsartikel in der wiederkehrenden Lieferantenrechnung
payment_termsZahlungsbedingungen, die mit dem Lieferanten verbunden sind
currency_codeWährungscode
last_sent_dateDatum der zuletzt gesendeten Lieferantenrechnung
totalGesamtsumme der wiederkehrenden Lieferantenrechnung
next_bill_dateDatum der nächsten Lieferantenrechnung
recurring_bill_idID der wiederkehrenden Lieferantenrechnung
recurrence_nameName des Profils für wiederkehrende Lieferantenrechnungen
vendor_idID des beteiligten Lieferanten
sub_totalZwischensumme auf der wiederkehrenden Lieferantenrechnung
recurrence_frequencyHäufigkeit des Profils für wiederkehrende Rechnungen
payment_terms_labelBezeichnung der Zahlungsbedingungen
statusStatus des Profils für wiederkehrende Lieferantenrechnungen
start_dateStartdatum 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-FelderBeschreibung
item_idArtikel-ID
custom_fieldsBenutzerdefinierte Felder des Artikels
item_typeArt des Artikels
tax_nameName der beteiligten Steuer
purchase_rateEinkaufspreis des Artikels
zcrm_product_idID des Produkts in Zoho CRM
tax_idID der beteiligten Steuer
unitEinheit des Artikels
account_idVerkaufskonto-ID
purchase_account_nameName des Einkaufskontos
purchase_account_idEinkaufskonto-ID
tax_typeArt der beteiligten Steuer
rateVerkaufspreis des Artikels
account_nameName des beteiligten Verkaufskontos
nameName des Artikels
tax_percentageProzentsatz der beteiligten Steuer
pricebook_ratePreisbuchpreis
skuSKU des Artikels
statusStatus 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.

Verwandte Themen

Hat dieses Dokument Ihnen geholfen?
Ja
Nein

Vielen Dank für Ihre Rückmeldung!