In der t\u00e4glichen Arbeit mit der Zoho One<\/a> Suite stellt sich oft die Frage: Wie verbindest Du die St\u00e4rken einzelner Apps zu einem nahtlosen, automatisierten Prozess? Viele Unternehmen nutzen Zoho Projects<\/a> f\u00fcr die Projektarbeit und Zeiterfassung und Zoho Books<\/a> f\u00fcr die Buchhaltung. Die eigentliche Herausforderung liegt jedoch darin, diese Daten intelligent zu verkn\u00fcpfen und dem Anwender dort bereitzustellen, wo er sie wirklich braucht \u2013 meist direkt im Kundenkontakt, also im Zoho CRM<\/a>. Dieser Artikel zeigt Dir einen praxisnahen L\u00f6sungsansatz, wie Du eine individuelle Abrechnungslogik entwickelst und diese als interaktives Widget direkt in der Kundenansicht im Zoho CRM integrierst. Wir gehen dabei auf den konkreten Tech-Stack, die n\u00f6tigen API-Verbindungen und die Umsetzung mit Deluge-Scripting ein.<\/p>\n Stell Dir ein typisches IT-Dienstleistungsunternehmen vor. Die Entwickler und Berater erfassen ihre Arbeitszeiten penibel in den jeweiligen Aufgaben in Zoho Projects. Am Monatsende muss die Buchhaltung diese Zeiten exportieren, aufbereiten, nach kundenindividuellen Regeln (z.B. Aufrundung auf 15-Minuten-Intervalle, spezielle S\u00e4tze f\u00fcr Wochenendarbeit) anpassen und anschlie\u00dfend manuell Rechnungen in Zoho Books erstellen. Dieser Prozess ist nicht nur zeitaufwendig, sondern auch fehleranf\u00e4llig. Es fehlt eine zentrale \u00dcbersicht \u00fcber abrechenbare, aber noch nicht fakturierte Stunden direkt am Kunden im CRM. Der Vertrieb oder das Projektmanagement hat keinen schnellen Einblick, welche Leistungen bereits erbracht wurden und zur Abrechnung anstehen. Genau hier setzen wir an und bauen eine Br\u00fccke zwischen den Systemen.<\/p>\n Unser Ziel ist es, eine Anwendung zu schaffen, die abrechenbare Zeiten aus Zoho Projects und Books aggregiert, mit einer benutzerdefinierten Gesch\u00e4ftslogik verarbeitet und das Ergebnis als Widget direkt im Kundenmodul von Zoho CRM anzeigt. Von dort aus soll mit einem Klick eine Rechnungsvorschau in Zoho Books erzeugt werden k\u00f6nnen.<\/p>\n Die Grundlage f\u00fcr jede gute Automatisierung sind saubere Daten. Stelle sicher, dass in Zoho Projects<\/a> die Zeiterfassung konsequent genutzt wird. Ein entscheidender Punkt ist die Erfassung von „Von-Bis“-Zeiten statt pauschaler Stundenangaben. Nur so kannst Du sp\u00e4ter eine Logik f\u00fcr Nacht- oder Wochenendzuschl\u00e4ge implementieren.<\/p>\n Die eigentliche Intelligenz unserer L\u00f6sung liegt in einer benutzerdefinierten Anwendung, die wir mit Zoho Creator<\/a> bauen. Creator dient als Backend f\u00fcr unsere Logik und als Host f\u00fcr das sp\u00e4tere CRM-Widget. Hier schreiben wir unsere Deluge-Funktionen, um die Daten abzurufen und zu verarbeiten.<\/p>\n Zuerst erstellen wir eine Funktion, die alle noch nicht abgerechneten Zeiteintr\u00e4ge f\u00fcr einen bestimmten Kunden aus Zoho Books abruft. Dazu nutzen wir die Zoho Books API.<\/p>\n Diese Funktion ist das Herzst\u00fcck. Sie holt die Rohdaten, wendet einfache Regeln wie Aufrundung an und pr\u00fcft auf Wochenenden. Du kannst diese Logik beliebig erweitern, zum Beispiel durch die Anbindung an eine externe Feiertags-API (z.B. \u00fcber `invokeurl`), um spezielle Stundens\u00e4tze zu berechnen.<\/p>\n Nachdem die Logik im Backend steht, bauen wir in Zoho Creator<\/a> eine „Page“. Diese Page wird unser Widget sein. Sie visualisiert die von unserer Deluge-Funktion zur\u00fcckgegebenen Daten in einer \u00fcbersichtlichen Tabelle.<\/p>\n Die Verbindung zwischen Zoho Creator und Zoho CRM erfolgt \u00fcber „Connected Apps“.<\/p>\n Nach dem Speichern erscheint das Widget nun in jedem Kunden-Datensatz. Es ruft dynamisch die Daten f\u00fcr den jeweiligen Kunden ab und zeigt „Keine abrechenbaren Stunden gefunden“ an, falls keine Daten vorhanden sind.<\/p>\n Der Button „Rechnungsvorschau erstellen“ in unserem Widget soll eine weitere Deluge-Funktion aufrufen. Diese Funktion nimmt die aufbereiteten Daten und erstellt \u00fcber die Zoho Books API einen Rechnungsentwurf.<\/p>\n Nach dem Klick wird im Hintergrund ein Rechnungsentwurf in Zoho Books erzeugt, der von der Buchhaltung nur noch gepr\u00fcft und versendet werden muss.<\/p>\n Diese L\u00f6sung ist nur der Anfang. Du k\u00f6nntest den Prozess weiter ausbauen:<\/p>\n Dieses Praxisbeispiel zeigt eindr\u00fccklich, wie die wahre St\u00e4rke des Zoho-\u00d6kosystems in der intelligenten Kombination seiner Apps liegt. Indem wir Zoho Projects<\/a>, Zoho Books<\/a> und Zoho CRM<\/a> mittels einer in Zoho Creator<\/a> entwickelten Logik verbinden, schaffen wir einen hochgradig automatisierten und effizienten Prozess. Der Nutzer verbleibt in seiner gewohnten Umgebung (Zoho CRM) und erh\u00e4lt kontextbezogene, entscheidungsrelevante Informationen und Aktionen auf Knopfdruck. Du reduzierst manuelle Arbeit, minimierst Fehler und schaffst einen transparenten Abrechnungsprozess, der mit Deinem Unternehmen wachsen kann.<\/p>\n Verwendete Zoho Apps:<\/strong><\/p>\n Automatisiere Deine Zoho-Prozesse: Verbinde Zeiterfassung in Projects mit Abrechnung im CRM-Widget \u2013 effizient und nahtlos!<\/p>\n","protected":false},"author":1,"featured_media":5704,"comment_status":"closed","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"_acf_changed":false,"ocean_front_end_style_editor":"no","ocean_post_layout":"","ocean_both_sidebars_style":"","ocean_both_sidebars_content_width":0,"ocean_both_sidebars_sidebars_width":0,"ocean_sidebar":"","ocean_second_sidebar":"","ocean_disable_margins":"enable","ocean_add_body_class":"","ocean_shortcode_before_top_bar":"","ocean_shortcode_after_top_bar":"","ocean_shortcode_before_header":"","ocean_shortcode_after_header":"","ocean_has_shortcode":"","ocean_shortcode_after_title":"","ocean_shortcode_before_footer_widgets":"","ocean_shortcode_after_footer_widgets":"","ocean_shortcode_before_footer_bottom":"","ocean_shortcode_after_footer_bottom":"","ocean_display_top_bar":"default","ocean_display_header":"default","ocean_header_style":"","ocean_center_header_left_menu":"","ocean_custom_header_template":"","ocean_custom_logo":0,"ocean_custom_retina_logo":0,"ocean_custom_logo_max_width":0,"ocean_custom_logo_tablet_max_width":0,"ocean_custom_logo_mobile_max_width":0,"ocean_custom_logo_max_height":0,"ocean_custom_logo_tablet_max_height":0,"ocean_custom_logo_mobile_max_height":0,"ocean_header_custom_menu":"","ocean_menu_typo_font_family":"","ocean_menu_typo_font_subset":"","ocean_menu_typo_font_size":0,"ocean_menu_typo_font_size_tablet":0,"ocean_menu_typo_font_size_mobile":0,"ocean_menu_typo_font_size_unit":"px","ocean_menu_typo_font_weight":"","ocean_menu_typo_font_weight_tablet":"","ocean_menu_typo_font_weight_mobile":"","ocean_menu_typo_transform":"","ocean_menu_typo_transform_tablet":"","ocean_menu_typo_transform_mobile":"","ocean_menu_typo_line_height":0,"ocean_menu_typo_line_height_tablet":0,"ocean_menu_typo_line_height_mobile":0,"ocean_menu_typo_line_height_unit":"","ocean_menu_typo_spacing":0,"ocean_menu_typo_spacing_tablet":0,"ocean_menu_typo_spacing_mobile":0,"ocean_menu_typo_spacing_unit":"","ocean_menu_link_color":"","ocean_menu_link_color_hover":"","ocean_menu_link_color_active":"","ocean_menu_link_background":"","ocean_menu_link_hover_background":"","ocean_menu_link_active_background":"","ocean_menu_social_links_bg":"","ocean_menu_social_hover_links_bg":"","ocean_menu_social_links_color":"","ocean_menu_social_hover_links_color":"","ocean_disable_title":"default","ocean_disable_heading":"default","ocean_post_title":"","ocean_post_subheading":"","ocean_post_title_style":"","ocean_post_title_background_color":"","ocean_post_title_background":0,"ocean_post_title_bg_image_position":"","ocean_post_title_bg_image_attachment":"","ocean_post_title_bg_image_repeat":"","ocean_post_title_bg_image_size":"","ocean_post_title_height":0,"ocean_post_title_bg_overlay":0.5,"ocean_post_title_bg_overlay_color":"","ocean_disable_breadcrumbs":"default","ocean_breadcrumbs_color":"","ocean_breadcrumbs_separator_color":"","ocean_breadcrumbs_links_color":"","ocean_breadcrumbs_links_hover_color":"","ocean_display_footer_widgets":"default","ocean_display_footer_bottom":"default","ocean_custom_footer_template":"","osh_disable_topbar_sticky":"default","osh_disable_header_sticky":"default","osh_sticky_header_style":"default","osh_sticky_header_effect":"","osh_custom_sticky_logo":0,"osh_custom_retina_sticky_logo":0,"osh_custom_sticky_logo_height":0,"osh_background_color":"","osh_links_color":"","osh_links_hover_color":"","osh_links_active_color":"","osh_links_bg_color":"","osh_links_hover_bg_color":"","osh_links_active_bg_color":"","osh_menu_social_links_color":"","osh_menu_social_hover_links_color":"","ocean_post_oembed":"","ocean_post_self_hosted_media":"","ocean_post_video_embed":"","ocean_link_format":"","ocean_link_format_target":"self","ocean_quote_format":"","ocean_quote_format_link":"post","ocean_gallery_link_images":"on","ocean_gallery_id":[],"footnotes":""},"categories":[1],"tags":[],"class_list":["post-5680","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-zoho","entry","has-media"],"acf":[],"yoast_head":"\nDie Herausforderung: Manuelle Abrechnungsprozesse \u00fcber Systemgrenzen hinweg<\/h3>\n
Schritt-f\u00fcr-Schritt: Dein Weg zum automatisierten Abrechnungs-Widget<\/h3>\n
Schritt 1: Die Datenbasis schaffen und synchronisieren<\/h4>\n
\n
Schritt 2: Die Gesch\u00e4ftslogik mit Zoho Creator und Deluge entwickeln<\/h4>\n
\n\/\/ Deluge Custom Function in Zoho Creator\n\/\/ Parameter: crmContactID - Die ID des Kontakts aus Zoho CRM\nlist getBillableHours(int crmContactID)\n{\n\t\/\/ 1. Finde die Zoho Books Customer ID basierend auf der CRM ID\n\tsearch_customer = zoho.books.getRecords(\"Contacts\",\"\",\"zoho_crm_contact_id=\" + crmContactID);\n\tif(search_customer.get(\"code\") == 0 && search_customer.get(\"contacts\").size() > 0)\n\t{\n\t\tbooksCustomerID = search_customer.get(\"contacts\").get(0).get(\"contact_id\");\n\t\t\n\t\t\/\/ 2. Rufe alle nicht fakturierten Zeiteintr\u00e4ge f\u00fcr diesen Kunden ab\n\t\tparam_map = Map();\n\t\tparam_map.put(\"customer_id\",booksCustomerID);\n\t\tparam_map.put(\"status\",\"unbilled\");\n\t\ttime_entries = zoho.books.getRecords(\"TimeEntries\",\"\",param_map);\n\t\t\n\t\tprocessed_entries = List();\n\t\t\n\t\tif(time_entries.get(\"code\") == 0)\n\t\t{\n\t\t\t\/\/ 3. Verarbeite jeden Zeiteintrag mit unserer Business-Logik\n\t\t\tfor each entry in time_entries.get(\"time_entries\")\n\t\t\t{\n\t\t\t\t\/\/ Beispiel: Aufrundung auf die n\u00e4chste Viertelstunde\n\t\t\t\tminutes = entry.get(\"log_time\").toLong();\n\t\t\t\trounded_minutes = (minutes \/ 15 + (if(minutes % 15 > 0, 1, 0))) * 15;\n\t\t\t\t\n\t\t\t\t\/\/ Beispiel: Pr\u00fcfung auf Wochenende (Samstag=6, Sonntag=7)\n\t\t\t\tlog_date = entry.get(\"log_date\").toDate();\n\t\t\t\tis_weekend = log_date.getDayOfWeek() > 5;\n\n\t\t\t\t\/\/ F\u00fcge verarbeitete Daten zur Liste hinzu\n\t\t\t\tprocessed_entry = Map();\n\t\t\t\tprocessed_entry.put(\"project_name\", entry.get(\"project_name\"));\n\t\t\t\tprocessed_entry.put(\"task_name\", entry.get(\"task_name\"));\n\t\t\t\tprocessed_entry.put(\"user_name\", entry.get(\"user_name\"));\n\t\t\t\tprocessed_entry.put(\"original_minutes\", minutes);\n\t\t\t\tprocessed_entry.put(\"billed_minutes\", rounded_minutes);\n\t\t\t\tprocessed_entry.put(\"is_weekend_rate\", is_weekend);\n\t\t\t\tprocessed_entries.add(processed_entry);\n\t\t\t}\n\t\t}\n\t\treturn processed_entries;\n\t}\n\treturn List();\n}\n<\/code><\/pre>\nSchritt 3: Das Frontend als CRM-Widget bauen<\/h4>\n
\n
Schritt 4: Das Widget im Zoho CRM einbinden<\/h4>\n
\n
Schritt 5: Aktionen aus dem Widget heraus starten<\/h4>\n
\n\/\/ Deluge-Funktion, die vom Widget-Button aufgerufen wird\nvoid createDraftInvoice(int crmContactID, list line_items)\n{\n\t\/\/ 1. Finde die Zoho Books Customer ID (wie oben)\n\tsearch_customer = zoho.books.getRecords(\"Contacts\",\"\",\"zoho_crm_contact_id=\" + crmContactID);\n\tif(search_customer.get(\"code\") == 0 && search_customer.get(\"contacts\").size() > 0)\n\t{\n\t\tbooksCustomerID = search_customer.get(\"contacts\").get(0).get(\"contact_id\");\n\t\t\n\t\t\/\/ 2. Erstelle die JSON-Struktur f\u00fcr die Rechnung\n\t\tinvoice_json = Map();\n\t\tinvoice_json.put(\"customer_id\", booksCustomerID);\n\t\t\n\t\tinvoice_line_items = List();\n\t\tfor each item in line_items\n\t\t{\n\t\t\tline_item_map = Map();\n\t\t\tline_item_map.put(\"name\", item.get(\"project_name\") + \" - \" + item.get(\"task_name\"));\n\t\t\tline_item_map.put(\"description\", \"Geleistete Arbeitszeit von \" + item.get(\"user_name\"));\n\t\t\tline_item_map.put(\"quantity\", (item.get(\"billed_minutes\").toDecimal() \/ 60)); \/\/ Menge in Stunden\n\t\t\tline_item_map.put(\"rate\", 100.0); \/\/ Hier den Stundensatz dynamisch laden!\n\t\t\tinvoice_line_items.add(line_item_map);\n\t\t}\n\t\tinvoice_json.put(\"line_items\", invoice_line_items);\n\t\t\n\t\t\/\/ 3. Sende den API-Aufruf an Zoho Books, um den Entwurf zu erstellen\n\t\tresponse = zoho.books.createRecord(\"Invoices\", invoice_json);\n\t\tinfo response;\n\t}\n}\n<\/code><\/pre>\nTipps und Best Practices<\/h3>\n
\n
zoho.loginuserid<\/code> abfragen und seine CRM-Rolle oder sein Profil pr\u00fcfen. Zeige den „Erstellen“-Button im Widget nur an, wenn die Berechtigung vorhanden ist.<\/li>\nresponse.get(\"code\") == 0<\/code>) und gib dem Anwender im Widget klares Feedback, falls etwas schiefgeht.<\/li>\n<\/ul>\nZus\u00e4tzliche Hinweise: Das \u00d6kosystem erweitern<\/h3>\n
\n
Fazit: Mehr als die Summe der Teile<\/h3>\n
\n