Recurring Bills

The place of supply is where a transaction is considered to have occurred for VAT purposes. For the supply of goods, the place of supply is the location of the goods when the supply occurs. For the supply of services, the place of supply should be where the supplier is established. (If not given, place of contact given for the contact will be taken)
Supported codes for UAE emirates are :
Abu Dhabi - AB,
Ajman - AJ,
Dubai - DU,
Fujairah - FU,
Ras al-Khaimah - RA,
Sharjah - SH,
Umm al-Quwain - UM.
Supported codes for the GCC countries are :
United Arab Emirates - AE,
Saudi Arabia - SA,
Bahrain - BH,
Kuwait - KW,
Oman - OM,
Qatar - QA.

destination_of_supply

string

🇮🇳 only

Place where the goods/services are supplied to. (If not given, organisation's home state will be taken)

gst_treatment

string

🇮🇳 only

Choose whether the contact is GST registered/unregistered/consumer/overseas. Allowed values are business_gst , business_none , overseas , consumer .

gst_no

string

🇮🇳 only

15 digit GST identification number of the vendor.

tax_treatment

string

GCC , 🇲🇽 only

VAT treatment for the bill. Choose whether the vendor falls under: vat_registered,vat_not_registered,gcc_vat_not_registered,gcc_vat_registered,non_gcc.
dz_vat_registered and dz_vat_not_registered are supported only for UAE.
home_country_mexico,border_region_mexico,non_mexico supported only for MX.

vat_treatment

string

🇬🇧 only

(Optional) VAT treatment for the bill. VAT treatment denotes the location of the vendor, if the vendor resides in UK then the VAT treatment is uk. If the vendor is in an EU country & VAT registered, you are resides in Northen Ireland and purchasing Goods then his VAT treatment is eu_vat_registered and if he resides outside the UK then his VAT treatment is overseas(For Pre Brexit, this can be split as eu_vat_registered, eu_vat_not_registered and non_eu).

vat_reg_no

string

🇬🇧 , Avalara Integration only

For UK Edition: VAT Registration number of a contact with length should be between 2 and 12 characters.
For Avalara: If you are doing sales in the European Union (EU) then provide VAT Registration Number of your customers here. This is used to calculate VAT for B2B sales, from Avalara.

is_abn_quoted

string

🇦🇺 only

abn

string

🇦🇺 only

is_reverse_charge_applied

boolean

🇮🇳 only

Applicable for transactions where you pay reverse charge

pricebook_id

string

Enter ID of the price book.

pricebook_name

string

Name of the price book

is_inclusive_tax

boolean

Not applicable 🇺🇸

Used to specify whether the line item rates are inclusive or exclusive of tax.

line_items

array

Line items of a recurrence bill.

Show Sub-Attributes

line_item_id

string

ID of the Line Item

item_id

string

ID of the Item

sku

string

SKU of the Item

name

string

account_id

string

ID of the account associated with the line item.

account_name

string

Name of the Account

image_document_id

string

🇮🇳 only

ID of the image document

warehouse_id

string

🇮🇳 only

Warehoude ID

warehouse_name

string

Name of the warehouse

reverse_charge_tax_id

string

🇮🇳 , GCC only

Reverse charge tax ID

reverse_charge_tax_name

string

🇮🇳 only

Name of the reverse charge tax

reverse_charge_tax_percentage

double

🇮🇳 only

Enter reverse charge percentage

reverse_charge_tax_amount

double

🇮🇳 only

Enter reverse charge amount

description

string

Description of the line item.

bcy_rate

integer

Rate in Base Currency of the Organization

rate

double

Rate of the line item.

Create a recurring bill

Create a recurring bill.
OAuth Scope : ZohoBooks.bills.CREATE

Arguments

vendor_id

string

(Required)

ID of the vendor the bill has to be created.

currency_id

string

ID of the Currency

recurrence_name

string

(Required)

Name of the Recurring Bill. Max-length [100]

start_date

string

(Required)

Start date of the recurring bill. Bills will not be generated for dates prior to the current date. Format [yyyy-mm-dd].

end_date

string

Date on which recurring bill has to expire. Can be left as empty to run forever. Format [yyyy-mm-dd].

source_of_supply

string

🇮🇳 only

Place from where the goods/services are supplied. (If not given, place of contact given for the contact will be taken)

place_of_supply

string

GCC only

destination_of_supply

string

🇮🇳 only

Place where the goods/services are supplied to. (If not given, organisation's home state will be taken)

gst_treatment

string

🇮🇳 only

Choose whether the contact is GST registered/unregistered/consumer/overseas. Allowed values are business_gst , business_none , overseas , consumer .

gst_no

string

🇮🇳 only

15 digit GST identification number of the vendor.

tax_treatment

string

GCC , 🇲🇽 only

vat_treatment

string

🇬🇧 only

vat_reg_no

string

🇬🇧 , Avalara Integration only

is_abn_quoted

string

🇦🇺 only

abn

string

🇦🇺 only

is_reverse_charge_applied

boolean

🇮🇳 only

Applicable for transactions where you pay reverse charge

pricebook_id

string

Enter ID of the price book.

is_inclusive_tax

boolean

Not applicable 🇺🇸

Used to specify whether the line item rates are inclusive or exclusive of tax.

line_items

array

Line items of a recurrence bill.

Show Sub-Attributes

line_item_id

string

ID of the Line Item

item_id

string

ID of the Item

name

string

account_id

string

ID of the account associated with the line item.

description

string

Description of the line item.

rate

double

Rate of the line item.

hsn_or_sac

string

🇮🇳 only

Add HSN/SAC code for your goods/services

reverse_charge_tax_id

string

🇮🇳 , GCC only

Reverse charge tax ID

warehouse_id

string

🇮🇳 only

Warehoude ID

quantity

double

Quantity of the line item.

tax_id

string

Not applicable 🇺🇸

ID of the tax or tax group applied to the line item.

tds_tax_id

string

🇲🇽 only

TDS ID of the tax group applied to the line item

tax_treatment_code

string

GCC only

tax_exemption_id

string

🇮🇳 , 🇦🇺 , 🇨🇦 only

ID of the Tax Exemption Applied

tax_exemption_code

string

🇮🇳 , 🇦🇺 , 🇨🇦 only

Code of the Tax Exemption Applied

item_order

integer

product_type

string

Europe , 🇬🇧 only

acquisition_vat_id

string

🇬🇧 only

(Optional) This is the ID of the tax applied in case this is an EU - goods purchase and acquisition VAT needs to be reported.

reverse_charge_vat_id

string

🇬🇧 only

(Optional) This is the ID of the tax applied in case this is a non UK - service purchase and reverse charge VAT needs to be reported.

unit

string

Unit of the Item

List recurring bills

List all recurring bills with pagination.
OAuth Scope : ZohoBooks.bills.READ

Query Parameters

recurring_bill_id

vendor_id

Search recurring bills by Vendor ID

vendor_name

Search recurring bills by vendor name. Variants: vendor_name_startswith and vendor_name_contains

status

Search recurring bills by recurring bill status. Allowed Values: active, stopped, expired

recurrence_name

Search recurring bills by recurrence number. Variants: recurrence_name_startswith and recurrence_name_contains

currency_id

ID of the Currency

currency_code

Code of the Currency

currency_symbol

Symbol of the Currency

start_date

Search recurring bills by recurring bill start date. Variants: start_date_start, start_date_end, start_date_before and start_date_after

end_date

Date on which recurring bill has to expire. Can be left as empty to run forever. Format [yyyy-mm-dd].

source_of_supply

🇮🇳 only

Place from where the goods/services are supplied. (If not given, place of contact given for the contact will be taken)

place_of_supply

GCC only

destination_of_supply

🇮🇳 only

Place where the goods/services are supplied to. (If not given, organisation's home state will be taken)

gst_treatment

🇮🇳 only

Choose whether the contact is GST registered/unregistered/consumer/overseas. Allowed values are business_gst , business_none , overseas , consumer .

gst_no

🇮🇳 only

15 digit GST identification number of the vendor.

tax_treatment

GCC , 🇲🇽 only

vat_treatment

🇬🇧 only

vat_reg_no

🇬🇧 , Avalara Integration only

is_abn_quoted

🇦🇺 only

abn

🇦🇺 only

is_reverse_charge_applied

🇮🇳 only

Applicable for transactions where you pay reverse charge

pricebook_id

Enter ID of the price book.

pricebook_name

Name of the price book

is_inclusive_tax

only

Used to specify whether the line item rates are inclusive or exclusive of tax.

is_tds_applied

🇮🇳 , 🌎 , 🇦🇺 only

Check if TDS is applied

notes

Notes for the Bill

terms

Terms and Conditions for the Bill

payment_terms

Number Referring to Payment Terms

payment_terms_label

Label of the Payment Terms

acquisition_vat_total

🇬🇧 , Europe only

Total of the VAT Acquistion

reverse_charge_vat_total

🇬🇧 , Europe only

Total of the Reverse Charge

created_time

Created time of the bill

created_by_id

Name of User who created the Bill

last_modified_time

Last Modified Time of the Bill

discount

Discount applied to the recurrence. It can be either in % or in amount. E.g: 12.5% or 190.

discount_account_id

ID of the account associated with the discount account.

is_discount_before_tax

To specify discount applied in before /after tax.

headers_data = Map();
headers_data.put("Authorization", "Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f");
response = invokeUrl
[
url: "https://www.zohoapis.com/books/v3/recurringbills?organization_id=10234695"
type: GET
headers: headers_data
connection: <connection_name>
]
info response;

OkHttpClient client = new OkHttpClient();

Request request = new Request.Builder()
  .url("https://www.zohoapis.com/books/v3/recurringbills?organization_id=10234695")
  .get()
  .addHeader("Authorization", "Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f")
  .build();

Response response = client.newCall(request).execute();

const options = {
  method: 'GET',
  headers: {
    Authorization: 'Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f'
  }
};

fetch('https://www.zohoapis.com/books/v3/recurringbills?organization_id=10234695', options)
  .then(response => response.json())
  .then(response => console.log(response))
  .catch(err => console.error(err));

import http.client

conn = http.client.HTTPSConnection("www.zohoapis.com")

headers = { 'Authorization': "Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f" }

conn.request("GET", "/books/v3/recurringbills?organization_id=10234695", headers=headers)

res = conn.getresponse()
data = res.read()

print(data.decode("utf-8"))

const http = require("https");

const options = {
  "method": "GET",
  "hostname": "www.zohoapis.com",
  "port": null,
  "path": "/books/v3/recurringbills?organization_id=10234695",
  "headers": {
    "Authorization": "Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f"
  }
};

const req = http.request(options, function (res) {
  const chunks = [];

  res.on("data", function (chunk) {
    chunks.push(chunk);
  });

  res.on("end", function () {
    const body = Buffer.concat(chunks);
    console.log(body.toString());
  });
});

req.end();

curl --request GET \
  --url 'https://www.zohoapis.com/books/v3/recurringbills?organization_id=10234695' \
  --header 'Authorization: Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f'

{
    "code": 0,
    "message": "success",
    "recurringbills": [
        {
            "recurring_bill_id": 982000000567240,
            "vendor_id": "460000000038029",
            "vendor_name": "string",
            "status": "active",
            "recurrence_name": "Monthly Rental",
            "currency_id": "460000000000099",
            "currency_code": "INR",
            "currency_symbol": "string",
            "start_date": "2013-11-18",
            "end_date": "2013-12-18",
            "source_of_supply": "AP",
            "place_of_supply": "DU",
            "destination_of_supply": "TN",
            "gst_treatment": "business_gst",
            "gst_no": "22AAAAA0000A1Z5",
            "tax_treatment": "vat_registered",
            "vat_treatment": "string",
            "vat_reg_no": "string",
            "is_abn_quoted": "string",
            "abn": "string",
            "is_reverse_charge_applied": true,
            "pricebook_id": 460000000038090,
            "pricebook_name": "string",
            "is_inclusive_tax": false,
            "line_items": [
                {
                    "line_item_id": "460000000067009",
                    "item_id": "460000000054135",
                    "sku": "string",
                    "name": "string",
                    "account_id": "460000000000403",
                    "account_name": "Other Expenses",
                    "image_document_id": 460000000038067,
                    "warehouse_id": 460000000038089,
                    "warehouse_name": "string",
                    "reverse_charge_tax_id": 460000000038056,
                    "reverse_charge_tax_name": "inter",
                    "reverse_charge_tax_percentage": 10,
                    "reverse_charge_tax_amount": 100,
                    "description": "string",
                    "bcy_rate": 40,
                    "rate": 10,
                    "tags": [
                        {
                            "tag_id": "460000000054178",
                            "tag_option_id": "460000000054180"
                        }
                    ],
                    "quantity": 1,
                    "tax_id": "460000000027005",
                    "tds_tax_id": "460000000027001",
                    "tax_treatment_code": "uae_others",
                    "tax_exemption_id": "string",
                    "tax_exemption_code": "string",
                    "tax_name": "VAT (12.5%)",
                    "tax_type": "tax",
                    "tax_percentage": 0,
                    "item_total": 40,
                    "item_total_inclusive_of_tax": 40,
                    "item_order": 1,
                    "unit": "kgs",
                    "product_type": "string",
                    "hsn_or_sac": 80540,
                    "acquisition_vat_id": "string",
                    "acquisition_vat_name": "string",
                    "acquisition_vat_percentage": "string",
                    "acquisition_vat_amount": "string",
                    "reverse_charge_vat_id": "string",
                    "reverse_charge_vat_name": "string",
                    "reverse_charge_vat_percentage": "string",
                    "reverse_charge_vat_amount": "string",
                    "is_billable": false,
                    "customer_id": "string",
                    "customer_name": "string",
                    "project_id": "string",
                    "project_name": "string",
                    "item_custom_fields": [
                        {
                            "custom_field_id": 0,
                            "index": 0,
                            "value": "string",
                            "label": "string"
                        }
                    ]
                }
            ],
            "is_tds_applied": true,
            "notes": "Thanks for your business.",
            "terms": "Terms and conditions apply.",
            "payment_terms": 0,
            "payment_terms_label": "Due on Receipt",
            "custom_fields": [
                {
                    "custom_field_id": 0,
                    "index": 0,
                    "label": "string",
                    "value": "string"
                }
            ],
            "acquisition_vat_summary": [
                {
                    "tax_name": "VAT (12.5%)",
                    "tax_amount": 1.25
                }
            ],
            "reverse_charge_vat_summary": [
                {
                    "tax_name": "VAT (12.5%)",
                    "tax_amount": 1.25
                }
            ],
            "acquisition_vat_total": 0.1,
            "reverse_charge_vat_total": 0.1,
            "created_time": "2013-09-11T17:18:32+0530",
            "created_by_id": "4600000053001",
            "last_modified_time": "2013-09-11T17:18:32+0530",
            "discount": "30%",
            "discount_account_id": "460000000000403",
            "is_discount_before_tax": true
        },
        {...},
        {...}
    ]
}

Update a recurring bill

Update a recurring bill. To delete a line item just remove it from the line_items list.
OAuth Scope : ZohoBooks.bills.UPDATE

Arguments

recurring_bill_id

string

vendor_id

string

(Required)

ID of the vendor the bill has to be created.

currency_id

string

ID of the Currency

status

string

Status of the Recurring Bill

recurrence_name

string

(Required)

Name of the Recurring Bill. Max-length [100]

start_date

string

(Required)

Start date of the recurring bill. Bills will not be generated for dates prior to the current date. Format [yyyy-mm-dd].

end_date

string

Date on which recurring bill has to expire. Can be left as empty to run forever. Format [yyyy-mm-dd].

source_of_supply

string

🇮🇳 only

Place from where the goods/services are supplied. (If not given, place of contact given for the contact will be taken)

place_of_supply

string

GCC only

destination_of_supply

string

🇮🇳 only

Place where the goods/services are supplied to. (If not given, organisation's home state will be taken)

gst_treatment

string

🇮🇳 only

Choose whether the contact is GST registered/unregistered/consumer/overseas. Allowed values are business_gst , business_none , overseas , consumer .

gst_no

string

🇮🇳 only

15 digit GST identification number of the vendor.

tax_treatment

string

GCC , 🇲🇽 only

vat_treatment

string

🇬🇧 only

vat_reg_no

string

🇬🇧 , Avalara Integration only

is_abn_quoted

string

🇦🇺 only

abn

string

🇦🇺 only

is_reverse_charge_applied

boolean

🇮🇳 only

Applicable for transactions where you pay reverse charge

pricebook_id

string

Enter ID of the price book.

pricebook_name

string

Name of the price book

is_inclusive_tax

boolean

Not applicable 🇺🇸

Used to specify whether the line item rates are inclusive or exclusive of tax.

line_items

array

Line items of a recurrence bill.

Show Sub-Attributes

line_item_id

string

ID of the Line Item

item_id

string

ID of the Item

name

string

account_id

string

ID of the account associated with the line item.

description

string

Description of the line item.

rate

double

Rate of the line item.

hsn_or_sac

string

🇮🇳 only

Add HSN/SAC code for your goods/services

reverse_charge_tax_id

string

🇮🇳 , GCC only

Reverse charge tax ID

warehouse_id

string

🇮🇳 only

Warehoude ID

quantity

double

Quantity of the line item.

tax_id

string

Not applicable 🇺🇸

ID of the tax or tax group applied to the line item.

tds_tax_id

string

🇲🇽 only

TDS ID of the tax group applied to the line item

tax_treatment_code

string

GCC only

tax_exemption_id

string

🇮🇳 , 🇦🇺 , 🇨🇦 only

ID of the Tax Exemption Applied

tax_exemption_code

string

🇮🇳 , 🇦🇺 , 🇨🇦 only

Code of the Tax Exemption Applied

item_order

integer

product_type

string

Europe , 🇬🇧 only

acquisition_vat_id

string

🇬🇧 only

(Optional) This is the ID of the tax applied in case this is an EU - goods purchase and acquisition VAT needs to be reported.

reverse_charge_vat_id

string

🇬🇧 only

(Optional) This is the ID of the tax applied in case this is a non UK - service purchase and reverse charge VAT needs to be reported.

unit

string

Unit of the Item

Get a recurring bill

Get the details of a recurring bill.
OAuth Scope : ZohoBooks.bills.READ

headers_data = Map();
headers_data.put("Authorization", "Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f");
response = invokeUrl
[
url: "https://www.zohoapis.com/books/v3/recurring_bills/982000000567240?organization_id=10234695"
type: GET
headers: headers_data
connection: <connection_name>
]
info response;

OkHttpClient client = new OkHttpClient();

Request request = new Request.Builder()
  .url("https://www.zohoapis.com/books/v3/recurring_bills/982000000567240?organization_id=10234695")
  .get()
  .addHeader("Authorization", "Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f")
  .build();

Response response = client.newCall(request).execute();

const options = {
  method: 'GET',
  headers: {
    Authorization: 'Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f'
  }
};

fetch('https://www.zohoapis.com/books/v3/recurring_bills/982000000567240?organization_id=10234695', options)
  .then(response => response.json())
  .then(response => console.log(response))
  .catch(err => console.error(err));

import http.client

conn = http.client.HTTPSConnection("www.zohoapis.com")

headers = { 'Authorization': "Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f" }

conn.request("GET", "/books/v3/recurring_bills/982000000567240?organization_id=10234695", headers=headers)

res = conn.getresponse()
data = res.read()

print(data.decode("utf-8"))

const http = require("https");

const options = {
  "method": "GET",
  "hostname": "www.zohoapis.com",
  "port": null,
  "path": "/books/v3/recurring_bills/982000000567240?organization_id=10234695",
  "headers": {
    "Authorization": "Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f"
  }
};

const req = http.request(options, function (res) {
  const chunks = [];

  res.on("data", function (chunk) {
    chunks.push(chunk);
  });

  res.on("end", function () {
    const body = Buffer.concat(chunks);
    console.log(body.toString());
  });
});

req.end();

curl --request GET \
  --url 'https://www.zohoapis.com/books/v3/recurring_bills/982000000567240?organization_id=10234695' \
  --header 'Authorization: Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f'

{
    "code": 0,
    "message": "success",
    "recurring_bill": {
        "recurring_bill_id": 982000000567240,
        "vendor_id": "460000000038029",
        "vendor_name": "string",
        "status": "active",
        "recurrence_name": "Monthly Rental",
        "currency_id": "460000000000099",
        "currency_code": "INR",
        "currency_symbol": "string",
        "start_date": "2013-11-18",
        "end_date": "2013-12-18",
        "source_of_supply": "AP",
        "place_of_supply": "DU",
        "destination_of_supply": "TN",
        "gst_treatment": "business_gst",
        "gst_no": "22AAAAA0000A1Z5",
        "tax_treatment": "vat_registered",
        "vat_treatment": "string",
        "vat_reg_no": "string",
        "is_abn_quoted": "string",
        "abn": "string",
        "is_reverse_charge_applied": true,
        "pricebook_id": 460000000038090,
        "pricebook_name": "string",
        "is_inclusive_tax": false,
        "line_items": [
            {
                "line_item_id": "460000000067009",
                "item_id": "460000000054135",
                "sku": "string",
                "name": "string",
                "account_id": "460000000000403",
                "account_name": "Other Expenses",
                "image_document_id": 460000000038067,
                "warehouse_id": 460000000038089,
                "warehouse_name": "string",
                "reverse_charge_tax_id": 460000000038056,
                "reverse_charge_tax_name": "inter",
                "reverse_charge_tax_percentage": 10,
                "reverse_charge_tax_amount": 100,
                "description": "string",
                "bcy_rate": 40,
                "rate": 10,
                "tags": [
                    {
                        "tag_id": "460000000054178",
                        "tag_option_id": "460000000054180"
                    }
                ],
                "quantity": 1,
                "tax_id": "460000000027005",
                "tds_tax_id": "460000000027001",
                "tax_treatment_code": "uae_others",
                "tax_exemption_id": "string",
                "tax_exemption_code": "string",
                "tax_name": "VAT (12.5%)",
                "tax_type": "tax",
                "tax_percentage": 0,
                "item_total": 40,
                "item_total_inclusive_of_tax": 40,
                "item_order": 1,
                "unit": "kgs",
                "product_type": "string",
                "hsn_or_sac": 80540,
                "acquisition_vat_id": "string",
                "acquisition_vat_name": "string",
                "acquisition_vat_percentage": "string",
                "acquisition_vat_amount": "string",
                "reverse_charge_vat_id": "string",
                "reverse_charge_vat_name": "string",
                "reverse_charge_vat_percentage": "string",
                "reverse_charge_vat_amount": "string",
                "is_billable": false,
                "customer_id": "string",
                "customer_name": "string",
                "project_id": "string",
                "project_name": "string",
                "item_custom_fields": [
                    {
                        "custom_field_id": 0,
                        "index": 0,
                        "value": "string",
                        "label": "string"
                    }
                ]
            }
        ],
        "is_tds_applied": true,
        "notes": "Thanks for your business.",
        "terms": "Terms and conditions apply.",
        "payment_terms": 0,
        "payment_terms_label": "Due on Receipt",
        "custom_fields": [
            {
                "custom_field_id": 0,
                "index": 0,
                "label": "string",
                "value": "string"
            }
        ],
        "acquisition_vat_summary": [
            {
                "tax_name": "VAT (12.5%)",
                "tax_amount": 1.25
            }
        ],
        "reverse_charge_vat_summary": [
            {
                "tax_name": "VAT (12.5%)",
                "tax_amount": 1.25
            }
        ],
        "acquisition_vat_total": 0.1,
        "reverse_charge_vat_total": 0.1,
        "created_time": "2013-09-11T17:18:32+0530",
        "created_by_id": "4600000053001",
        "last_modified_time": "2013-09-11T17:18:32+0530",
        "discount": "30%",
        "discount_account_id": "460000000000403",
        "is_discount_before_tax": true
    }
}

Delete a recurring bill

Delete an existing recurring bill.
OAuth Scope : ZohoBooks.bills.DELETE

headers_data = Map();
headers_data.put("Authorization", "Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f");
response = invokeUrl
[
url: "https://www.zohoapis.com/books/v3/recurring_bills/982000000567240?organization_id=10234695"
type: DELETE
headers: headers_data
connection: <connection_name>
]
info response;

OkHttpClient client = new OkHttpClient();

Request request = new Request.Builder()
  .url("https://www.zohoapis.com/books/v3/recurring_bills/982000000567240?organization_id=10234695")
  .delete(null)
  .addHeader("Authorization", "Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f")
  .build();

Response response = client.newCall(request).execute();

const options = {
  method: 'DELETE',
  headers: {
    Authorization: 'Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f'
  }
};

fetch('https://www.zohoapis.com/books/v3/recurring_bills/982000000567240?organization_id=10234695', options)
  .then(response => response.json())
  .then(response => console.log(response))
  .catch(err => console.error(err));

import http.client

conn = http.client.HTTPSConnection("www.zohoapis.com")

headers = { 'Authorization': "Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f" }

conn.request("DELETE", "/books/v3/recurring_bills/982000000567240?organization_id=10234695", headers=headers)

res = conn.getresponse()
data = res.read()

print(data.decode("utf-8"))

const http = require("https");

const options = {
  "method": "DELETE",
  "hostname": "www.zohoapis.com",
  "port": null,
  "path": "/books/v3/recurring_bills/982000000567240?organization_id=10234695",
  "headers": {
    "Authorization": "Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f"
  }
};

const req = http.request(options, function (res) {
  const chunks = [];

  res.on("data", function (chunk) {
    chunks.push(chunk);
  });

  res.on("end", function () {
    const body = Buffer.concat(chunks);
    console.log(body.toString());
  });
});

req.end();

curl --request DELETE \
  --url 'https://www.zohoapis.com/books/v3/recurring_bills/982000000567240?organization_id=10234695' \
  --header 'Authorization: Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f'

{
    "code": 0,
    "message": "The recurring bill has been deleted."
}

Stop a recurring bill

Stop an active recurring bill.
OAuth Scope : ZohoBooks.bills.CREATE

headers_data = Map();
headers_data.put("Authorization", "Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f");
response = invokeUrl
[
url: "https://www.zohoapis.com/books/v3/recurringbills/982000000567240/status/stop?organization_id=10234695"
type: POST
headers: headers_data
connection: <connection_name>
]
info response;

OkHttpClient client = new OkHttpClient();

Request request = new Request.Builder()
  .url("https://www.zohoapis.com/books/v3/recurringbills/982000000567240/status/stop?organization_id=10234695")
  .post(null)
  .addHeader("Authorization", "Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f")
  .build();

Response response = client.newCall(request).execute();

const options = {
  method: 'POST',
  headers: {
    Authorization: 'Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f'
  }
};

fetch('https://www.zohoapis.com/books/v3/recurringbills/982000000567240/status/stop?organization_id=10234695', options)
  .then(response => response.json())
  .then(response => console.log(response))
  .catch(err => console.error(err));

import http.client

conn = http.client.HTTPSConnection("www.zohoapis.com")

headers = { 'Authorization': "Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f" }

conn.request("POST", "/books/v3/recurringbills/982000000567240/status/stop?organization_id=10234695", headers=headers)

res = conn.getresponse()
data = res.read()

print(data.decode("utf-8"))

const http = require("https");

const options = {
  "method": "POST",
  "hostname": "www.zohoapis.com",
  "port": null,
  "path": "/books/v3/recurringbills/982000000567240/status/stop?organization_id=10234695",
  "headers": {
    "Authorization": "Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f"
  }
};

const req = http.request(options, function (res) {
  const chunks = [];

  res.on("data", function (chunk) {
    chunks.push(chunk);
  });

  res.on("end", function () {
    const body = Buffer.concat(chunks);
    console.log(body.toString());
  });
});

req.end();

curl --request POST \
  --url 'https://www.zohoapis.com/books/v3/recurringbills/982000000567240/status/stop?organization_id=10234695' \
  --header 'Authorization: Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f'

{
    "code": 0,
    "message": "The recurring bill has been stopped."
}

Resume a recurring Bill

Resume a stopped recurring bill.
OAuth Scope : ZohoBooks.bills.CREATE

headers_data = Map();
headers_data.put("Authorization", "Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f");
response = invokeUrl
[
url: "https://www.zohoapis.com/books/v3/recurringbills/982000000567240/status/resume?organization_id=10234695"
type: POST
headers: headers_data
connection: <connection_name>
]
info response;

OkHttpClient client = new OkHttpClient();

Request request = new Request.Builder()
  .url("https://www.zohoapis.com/books/v3/recurringbills/982000000567240/status/resume?organization_id=10234695")
  .post(null)
  .addHeader("Authorization", "Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f")
  .build();

Response response = client.newCall(request).execute();

const options = {
  method: 'POST',
  headers: {
    Authorization: 'Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f'
  }
};

fetch('https://www.zohoapis.com/books/v3/recurringbills/982000000567240/status/resume?organization_id=10234695', options)
  .then(response => response.json())
  .then(response => console.log(response))
  .catch(err => console.error(err));

import http.client

conn = http.client.HTTPSConnection("www.zohoapis.com")

headers = { 'Authorization': "Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f" }

conn.request("POST", "/books/v3/recurringbills/982000000567240/status/resume?organization_id=10234695", headers=headers)

res = conn.getresponse()
data = res.read()

print(data.decode("utf-8"))

const http = require("https");

const options = {
  "method": "POST",
  "hostname": "www.zohoapis.com",
  "port": null,
  "path": "/books/v3/recurringbills/982000000567240/status/resume?organization_id=10234695",
  "headers": {
    "Authorization": "Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f"
  }
};

const req = http.request(options, function (res) {
  const chunks = [];

  res.on("data", function (chunk) {
    chunks.push(chunk);
  });

  res.on("end", function () {
    const body = Buffer.concat(chunks);
    console.log(body.toString());
  });
});

req.end();

curl --request POST \
  --url 'https://www.zohoapis.com/books/v3/recurringbills/982000000567240/status/resume?organization_id=10234695' \
  --header 'Authorization: Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f'

{
    "code": 0,
    "message": "The recurring bill has been activated."
}

List recurring bill history

Get history and comments of a recurring bill.
OAuth Scope : ZohoBooks.bills.READ

headers_data = Map();
headers_data.put("Authorization", "Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f");
response = invokeUrl
[
url: "https://www.zohoapis.com/books/v3/recurringbills/982000000567240/comments?organization_id=10234695"
type: GET
headers: headers_data
connection: <connection_name>
]
info response;

OkHttpClient client = new OkHttpClient();

Request request = new Request.Builder()
  .url("https://www.zohoapis.com/books/v3/recurringbills/982000000567240/comments?organization_id=10234695")
  .get()
  .addHeader("Authorization", "Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f")
  .build();

Response response = client.newCall(request).execute();

const options = {
  method: 'GET',
  headers: {
    Authorization: 'Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f'
  }
};

fetch('https://www.zohoapis.com/books/v3/recurringbills/982000000567240/comments?organization_id=10234695', options)
  .then(response => response.json())
  .then(response => console.log(response))
  .catch(err => console.error(err));

import http.client

conn = http.client.HTTPSConnection("www.zohoapis.com")

headers = { 'Authorization': "Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f" }

conn.request("GET", "/books/v3/recurringbills/982000000567240/comments?organization_id=10234695", headers=headers)

res = conn.getresponse()
data = res.read()

print(data.decode("utf-8"))

const http = require("https");

const options = {
  "method": "GET",
  "hostname": "www.zohoapis.com",
  "port": null,
  "path": "/books/v3/recurringbills/982000000567240/comments?organization_id=10234695",
  "headers": {
    "Authorization": "Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f"
  }
};

const req = http.request(options, function (res) {
  const chunks = [];

  res.on("data", function (chunk) {
    chunks.push(chunk);
  });

  res.on("end", function () {
    const body = Buffer.concat(chunks);
    console.log(body.toString());
  });
});

req.end();

curl --request GET \
  --url 'https://www.zohoapis.com/books/v3/recurringbills/982000000567240/comments?organization_id=10234695' \
  --header 'Authorization: Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f'

{
    "code": 0,
    "message": "success"
}