Function #61: Automatically add free item to the invoice based on item quantity

Function #61: Automatically add free item to the invoice based on item quantity



Hello everyone, and welcome back to another Custom Function Friday!

During holiday seasons or special promotions, businesses offer deals like BOGO (Buy One, Get One), Buy 3 Get 1 Free, Buy 2 at 50% off, and much more to attract customers. These promotions encourage buyers to take advantage of limited-time offers, helping them save money while increasing foot traffic for businesses. In today's post, we’ll show you how to automate one such promotional offer – the 'Buy N items and Get X as free' using a custom function in Zoho Books.

Prerequisites: 

1. Create a Connection named "zbooks" to successfully execute the scheduler. You can watch the GIF attached below to know how to create the connection. 



2. Create a Lookup type custom field for Items. This field lets you choose the item to be given for free when a customer purchases a specified quantity of the same item. You can either select the same item as the free item or choose a different one.


3. Create a Check Box type custom field for Invoices. When creating an invoice, tick this field if you want to apply the offer to that particular invoice.




Custom Function:

Navigate to Settings -> Automation -> Workflow Actions -> Custom Functions -> +New Custom Function > Add the function code from this GitHub link -> Save. 



In line 10 of the script, you'll see the node "freeItemQTY". This is where you need to specify the minimum quantity a customer must purchase to qualify for a free item. For example, if the offer is Buy 5, Get 1 Free, then you would enter "5" here.

Workflow Rule:

Go to Settings -> Automation -> Workflow Rules -> +New Workflow Rule and set up the workflow rule as shown below:-





In the final step of this workflow rule, associate the custom function you created and then hit Save.

Here's how it works:

Zylker Stationery has launched several promotional offers to boost sales during the back-to-school season. One of these offers is "Buy 6 Brushes, Get a Palette for Free." To implement this in Zoho Books, the first step is to designate the Palette as the free item associated with the purchase of Brushes in the Lookup custom field. The "freeItemQTY" node in the script should be set to 6.

When creating an invoice, the user must tick the checkbox custom field to apply the promotion, add the items, and save the invoice as a draft. Subsequently, the custom function will get executed,  automatically adding the Palette as a separate line item priced at zero. The updated invoice will then be sent to the selected customers.

If you’ve been running promotions like this and adding the free items manually every time you create an invoice, this function will really help save you time and effort! Give it a try and let us know how it goes. Additionally, we previously shared another function that automatically adds free items based on the invoice amount—be sure to check it out [here]. If you have any other use cases you'd like to automate in Zoho Books, drop an email to support[at]zohobooks[dot]com, and we can explore the possibilities.

Regards,
Shireen Farhana
Zoho Books





        • Recent Topics

        • How to add a Data Updated As Of: dynamically in text?

          I need to add a "Data Updated As Of" in the dashboard to show when was the last date the data was updated. I tried to create a widget but it does not look really good, see below. Is there a way I can do this through the text widget and update it automatically

        • Create Your Own Issue Management System

          Effective issue management is a cornerstone of project success. Every bug or issue, no matter how small, needs to be tracked and resolved in time to maintain project momentum. In this post, we’ll explore how an issue management system in Zoho Projects

        • Resource utlisation

          Dear Team, We use the excel for the weekly predicted people utilization how the resource are allocated , is there any way that i can use any of the zoho products.

        • Ask the experts - A live Q & A discussion on Zoho Recruit

          We are delighted to come back with another edition of Ask the Experts community series. This edition, we'll be focusing on everything about Zoho Recruit. The topics will focus on the features that are used/asked by the majority of users and also based

        • Bug - OTP (email) and No Duplicates

          Scenario: Form with an email field, Validation: "No Duplicates" (because I want to ensure 1 entry per email). Embedded form into website (JS option). Enabled email based OTP. 1st test (via my website) - entered my email address - sent OTP - entered pin,

        • Personal Facebook page posting instead of Business Page

          I have a Facebook page that is associated with my Personal Profile and I am the Admin of that Page. I would like to schedule and Post to my Personal Page not the Business Page. Each time I try to connect to the "Page" it takes me to the Business Page. Is there a way of connecting to my personal page?

        • Fixed asset management

          I want to know if there is any individual module for fixed assets management

        • Recording depreciation of fixed assets as a percentage of residual value

          In India, fixed assets are depreciated as a percentage of their residual value at the beginning of each fiscal year. I went through the documentation for creating recurring journal entries, but could only find ways to depreciate by a fixed rupee amount

        • Function #28: Automatically calculate Customer Loyalty points

          Hello everyone, and welcome back to our series! Today, we're excited to share a workflow designed to streamline the management of loyalty points. Many businesses offer incentives or rewards in the form of loyalty points to their customers as a way to

        • Function #6: Calculate Commissions for paid invoices

          Zoho Books helps you automate the process of calculating and recording commissions paid to sales persons using custom functions. We've written a script that computes the commission amount based on the percentage of commission you enter and creates an

        • How to Add Product SKU in Invoice?

          How to Add Product SKU in Invoice?

        • Tracking movement between departments

          I've been developing a reporting system in Zoho and one of the groups I want to develop a report on primarily moves tickets from department to another. Is there a way to set up the reporting on Zoho (or Zoho Reports) that can tell me the number of tickets

        • Zoho CRM Calendar View

          Hello Zoho team, We need desperately a calendar view next to list, kandan and other views. I think it should be easy to implement as you already have the logic from Projects and also from Kanban View in CRM. In calendar view when we set it up - we choose

        • Call transcrition working for ringcentral?

          I don't see anything about what telephony providers can be used. The Zoho support person A said that RingCentral isn't supported. Zoho support person B said that it works, just make sure the call recording link works. Excellent instructions here: Call

        • What is syntax to call creator function (or trigger a creator workflow) from CRM deluge?

          What is syntax to call creator function (or trigger a creator workflow) from CRM deluge?

        • WhatsApp and Zoho Creator Integration

          How we have integrate WhatsApp App with Zoho Creator without using external application ?

        • Improve Creator Calendar Report

          Please can you improve the Creator Calendar Report General There is no way to highlight certain days, for example weekends or public holidays. There is no way to hide certain days, for example weekends. There is no way to modify the day header, it just

        • Important updates to Zoho CRM's email deliverability

          Last modified on: Jul 24, 2024 These enhancements are released for all users across all data centers. Modified on: Oct 30, 2023 Organisations that are in the Enterprise and above editions of Zoho CRM, and have not authenticated their email-sending domains

        • Custom modules not showing in developer console

          I'm trying to create a custom summing function for a custom module I made in my CRM. When I go to create the function, my module isnt showing up. Do I need to share the custom moldule with my developer console or something of the like?

        • Chart with Filtered Data vs Unfiltered Data

          I am looking to create a chart view that displays the full data set vs a subset of the data filtered by user filter. However I do not seem to find any method by which to exclude a plot from the applied filter or any other method by which to display the

        • Meetups Gratuitos Junio 2024 - Profundiza en las funcionalidades de tu Zoho CRM

          Este junio, aprende a sacar el máximo provecho de tu Zoho CRM en la segunda edición de los Zoho Meetups 2024. Los días 18 a 21 de junio, Zoho organiza los Meetups gratuitos para usuarios de Zoho CRM en Valencia, Barcelona, Madrid y Sevilla, donde expertos

        • How to get the Dashboard page to be the first page when you open the app

          So when it opens on a tablet or phone it opens on the welcome page, thanks.

        • Integration between Zoho CRM and Zoho WorkDrive

          I'd like to search Zoho for an invoice I've added as an attachment (pdf) to an account. The name of the invoice is 1388-advertiserx-July.pdf - but I can't find it using the search function for any of these terms: 1388 1388-advertiserx 1388-advertiserx-July.pdf

        • Tip #17: How to mandate partial payment for your appointments

          When you require partial payments during the booking process, customers can only schedule with you after paying a certain amount in advance. This deposit acts as a commitment between both parties. Apart from that, it has many more advantages. Benefits

        • Why option for 'include form submission in the body of the email' check box is missing

          Hi In all our forms we have configured an <Email Notification> (<Rules> <Form Rules>) In some forms, there is an option to <include form submission in the body of the email> in the <Additional Options> section, however, this option is not available in

        • Mozilla Vault extension will not Unlock even once.

          I have been using the Vault extension in Chrome based browsers for years, yet after installing the Mozilla Extension in Firefox, it will not unlock. Initially it did redirect me to log into my account, and then enter the master password. However, it did

        • Unable to Download CRM Contact Data: WorkDrive Integration Issues

          ## Problem Description We need to let users download contact information from CRM as CSV files to their local computers. Since we couldn't implement a direct download option, we're trying to use WorkDrive as a workaround - but we're encountering issues

        • Sort mail by name and subject

          I don't see sort function on columns FROM and Subject. I see only sort functio by date. Could add it ?

        • Zoho Creator monthly roundup - September 2024

          Hello all, We're back with an exciting set of new features and enhancements that will elevate your Creator experience even further. In case you missed it, we’ve recently revamped our Product Roadmap page, now with a refreshed design and showcasing all

        • Kiosk Studio Session #1: View paid customers in the same industry

          Update | 15 Oct 2024: Session #2 is now available here! Hello everyone! We're excited to launch our new series of posts on Kiosk Studio today. Called Kiosk Studio Sessions , these posts will be packed with actionable ideas to help you get the most out

        • Issues hosting Zoho Desk Web Form on SharePoint and/or Power BI

          Zoho Desk onboarding support has no experience with embedding their web form in either SharePoint or Power BI. Microsoft states that SharePoint and Power BI only support iframe HTML. And unfortunately, the web form embed code that Zoho generates is not

        • "Send with Zoho Sign" broken

          Our company uses hyphens in our file name conventions. Our users have been sending the files from other modules with the "Send with Zoho Sign" shortcut in the upper right buttons. Since around June 10, 2024, this stopped working. Our users can send the

        • Not able to change colors help center

          Hi. How can I change the orange color in the help center? You can change everything besides this font color And how can I remove the part on the bottom?

        • Transform Numeric Values using st, nd, rd, th or Convert Numerals to Ordinal Form - Deluge

          Please Use this sample Code This_Day_Date = zoho.currentdate.toString("dd"); value1 = "th"; if(This_Day_Date.right(1) ="1" && This_Day_Date != "11") { This_Day_Date = This_Day_Date+" "+"st"; } else if ( This_Day_Date.right(1) = "2" && This_Day_Date !=

        • Kaizen #166 - Handling Query Variables in Zoho CRM

          Hello, Code Enthusiasts! Welcome to another week of Kaizen! This week, we'll dive into handling variables in Zoho CRM Queries and see how they can be deployed in Kiosk to dynamically retrieve data. This technique is especially useful for integrating data

        • Automate User Invitations on Zoho Desk with API

          Automate User Invitations on Zoho Desk with API Hello Team, We are excited to announce that you can now automatically invite users to the Zoho Desk portal using the API! ### How It Works For example, when a contact is created in Zoho Desk and you enable

        • Is there a way to add clients who don't have organisation in Zoho Books/Payroll/Expense ?

          The Zoho Practice software is only allowing a total of 15 such clients who are not organisations in Zoho Books/Payroll/Expense. i.e. 5 organisation in each of the software by creating a new organization for them and adding the accountant as the admin

        • Email with attachments saving attachments into Zoho CRM from Zoho Mail

          Hi, I get a lot of emails from prospective clients asking if we would bid their project. Those projects usually have many documents associated with them that I link to.  I would like to have those documents be saved as an attachment in my Potential or Contact or Account. I don't see a way to do that that isn't multi-step. As of now I do the following: 1.) Open email 2.) If email sender isn't in my Zoho CRM database I enter them creating a Potential 3.) I download the attachment and save it to a different

        • Fixed assets recording

          Hello there, I recorded a bill for a vendor contain (Computer) so the PC is a fixed assets, do I need to do a manual journal to include this PC under the fixed assets category (furniture & equipment)? If yes, please take me through the manual journal

        • Multi-Select lookup field has reached its maximum??

          Hi there, I want to create a multi-select lookup field in a module but I can't select the model I want the relationship to be with from the list. From the help page on this I see that you can only create a max of 2 relationships per module? Is that true?

        • Next Page