Deprecating the isInvoiced and isBillable query parameters

Deprecating the isInvoiced and isBillable query parameters

If you offer paid support to your customers, it is important to track the time your agents spend on resolving tickets. Zoho Desk provides a time tracking capability and the option to create billable time entries. Besides, by integrating your Zoho Desk portal with Zoho Invoice, you can also create invoices and send them to customers from within Zoho Desk. 

You can view the time your agents spent on each ticket, under the Time Entry tab on the ticket detail page. All this while, this tab contained three filters: Total Time Spent, Total Billable Hours, and Total Non-Billable Hours. We are now introducing a filter that displays time entries that are already invoiced - Total Invoiced Hours

As a result, this new addition also impacts APIs related to time entries for all relevant modules: Tickets, Contacts, Accounts, Agents, Calls, Events, and Tasks. Here's what's going to change. 

Time entry-related APIs have two main Boolean query parameters: isBillable and isInvoiced. The responses to time entry APIs vary, depending on the combination of values passed for these query parameters. 

Both these parameters will be deprecated and the filtering capability will be made possible through a new query parameter called billStatus (string type). This new parameter will support three values: billable, nonBillable, and billed, to match the filters available in the Zoho Desk UI.  

The isBillable and isInvoiced parameters will be removed by the 22nd of August, 2020. We request you to review your API-based tools and tweak their code where necessary, to accommodate this change. 

For any questions and clarifications, contact support@zohodesk.com

    Access your files securely from anywhere

        Zoho Developer Community




                                  Zoho Desk Resources

                                  • Desk Community Learning Series


                                  • Digest


                                  • Functions


                                  • Meetups


                                  • Kbase


                                  • Resources


                                  • Glossary


                                  • Desk Marketplace


                                  • MVP Corner


                                  • Word of the Day



                                      Zoho Marketing Automation


                                              Manage your brands on social media



                                                    Zoho TeamInbox Resources

                                                      Zoho DataPrep Resources



                                                        Zoho CRM Plus Resources

                                                          Zoho Books Resources


                                                            Zoho Subscriptions Resources

                                                              Zoho Projects Resources


                                                                Zoho Sprints Resources


                                                                  Qntrl Resources


                                                                    Zoho Creator Resources



                                                                        Zoho Campaigns Resources


                                                                          Zoho CRM Resources

                                                                          • CRM Community Learning Series

                                                                            CRM Community Learning Series


                                                                          • Kaizen

                                                                            Kaizen

                                                                          • Functions

                                                                            Functions

                                                                          • Meetups

                                                                            Meetups

                                                                          • Kbase

                                                                            Kbase

                                                                          • Resources

                                                                            Resources

                                                                          • Digest

                                                                            Digest

                                                                          • CRM Marketplace

                                                                            CRM Marketplace

                                                                          • MVP Corner

                                                                            MVP Corner





                                                                              Design. Discuss. Deliver.

                                                                              Create visually engaging stories with Zoho Show.

                                                                              Get Started Now