Recurring Bills

Recurring Bills AI Tools

Open in ChatGPT

Open in ChatGPT to ask questions about this page

Open in Claude

Open in Claude to ask questions about this page

Copy as Markdown

Copy this page as markdown to use with AI assistants

View as Markdown

Open this page as markdown in a new tab

Recurring Bills are those bills that repeat itself after a fixed interval of time.

Download Recurring Bills OpenAPI Document

Attribute

recurring_bill_id
string
Unique ID of the recurring bill.
vendor_id
string
ID of the vendor the bill has to be created.
vendor_name
string
Name of the Vendor.
status
string
Status of the Recurring Bill.
recurrence_name
string
Name of the Recurring Bill. Max-length [100]
currency_id
string
ID of the Currency.
currency_code
string
Code of the Currency.
currency_symbol
string
Symbol of the Currency.
start_date
string
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
🇮🇳 India
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
🇮🇳 India
only
Place of supply for GST (Indian state/UT code where the purchase is treated as supplied). If omitted, the contact's place of contact may apply. Example: TN (Tamil Nadu).
destination_of_supply
string
🇮🇳 India
only
Place where the goods/services are supplied to. (If not given, organization's home state will be taken)
gst_treatment
string
🇮🇳 India
only
Choose whether the contact is GST registered/unregistered/consumer/overseas. Allowed values are business_gst , business_none , overseas , consumer .
gst_no
string
🇮🇳 India
only
15 digit GST identification number of the vendor.
is_reverse_charge_applied
boolean
🇮🇳 India
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
Used to specify whether the line item rates are inclusive or exclusive of tax.
location_id
string
Location ID.
location_name
string
Name of the location.
line_items
array
Line items of a recurrence bill.
Show Sub-Attributes arrow
line_item_id
string
ID of the Line Item.
item_id
string
ID of the Item.
sku
string
SKU of the Item.
name
string
Name of the line item.
account_id
string
ID of the chart of accounts entry for the line item. Use the Chart of Accounts API to resolve valid IDs. Note: This value is a set of numeric characters.
account_name
string
Name of the Account.
image_document_id
string
🇮🇳 India
only
ID of the image document.
location_id
string
Location ID.
location_name
string
Name of the location.
reverse_charge_tax_id
string
🇮🇳 India
only
Reverse charge tax ID.
reverse_charge_tax_name
string
🇮🇳 India
only
Name of the reverse charge tax.
reverse_charge_tax_percentage
double
🇮🇳 India
only
Enter reverse charge percentage.
reverse_charge_tax_amount
double
🇮🇳 India
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.
tags
array
Reporting tags help organize and filter data across reports and enable detailed business intelligence analysis.
Show Sub-Attributes arrow
tag_id
string
ID of the tag.
tag_option_id
string
ID of the tag option.
quantity
double
Quantity of the line item.
tax_id
string
ID of the tax or tax group applied to the line item. Note: This value is a set of numeric characters.
tds_tax_id
string
🇮🇳 India
only
TDS (Tax Deducted at Source) tax or tax group ID for this line item, as returned by the Taxes API. Note: This value is a set of numeric characters.
tax_exemption_id
string
🇮🇳 India
only
ID of the Tax Exemption Applied.
tax_exemption_code
string
🇮🇳 India
only
Code of the Tax Exemption Applied.
tax_name
string
Name of the Tax.
tax_type
string
Type of tax.
tax_percentage
integer
Percentage of Tax.
item_total
integer
Total of the Item.
item_total_inclusive_of_tax
double
Total of the Item Inclusive of Tax.
item_order
integer
Order of the line item.
unit
string
Unit of the Item.
hsn_or_sac
string
🇮🇳 India
only
Add HSN/SAC code for your goods/services.
is_billable
boolean
Indicates if entity is Billable.
customer_id
string
ID of the Customer.
customer_name
string
Name of the Customer.
project_id
string
ID of the Project.
project_name
string
Name of the Project.
item_custom_fields
array
List of custom fields for the line item.
Show Sub-Attributes arrow
custom_field_id
string
Unique ID of the custom field.
index
integer
Index of the custom field.
value
string
Value of the Custom Field.
label
string
Label of the Custom Field.
is_tds_applied
boolean
🇮🇳 India
only
Indicates if TDS is applied.
notes
string
Notes for the Bill.
terms
string
Terms and Conditions for the Bill.
payment_terms
integer
Number Referring to Payment Terms.
payment_terms_label
string
Label of the Payment Terms.
custom_fields
array
List of custom fields for the recurring bill.
Show Sub-Attributes arrow
custom_field_id
string
Unique ID of the custom field.
index
integer
Index of the custom field.
label
string
Label of the Custom Field.
value
string
Value of the Custom Field.
created_time
string
Created time of the bill.
created_by_id
string
Name of User who created the Bill.
last_modified_time
string
Last Modified Time of the Bill.
discount
string
Discount applied to the recurring bill, which can be either a percentage or a flat amount. For percentage discounts, the value should include the % symbol (e.g., 10%). For example, on Rs.1000, a 10% discount results in Rs.900, while a flat Rs.200 discount results in Rs.800.
discount_account_id
string
ID of the account associated with the discount account.
is_discount_before_tax
boolean
To specify discount applied in before /after tax.
tags
array
Reporting tags help organize and filter data across reports and enable detailed business intelligence analysis.
Show Sub-Attributes arrow
tag_id
string
ID of the tag.
tag_name
string
Name of the tag.
tag_option_id
string
ID of the tag option.
tag_option_name
string
Name of the tag option.
is_tag_mandatory
boolean
Used to check if the tag is mandatory.

Example

{ "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": "TN", "destination_of_supply": "TN", "gst_treatment": "business_gst", "gst_no": "22AAAAA0000A1Z5", "is_reverse_charge_applied": true, "pricebook_id": 460000000038090, "pricebook_name": "string", "is_inclusive_tax": false, "location_id": "460000000038080", "location_name": "string", "line_items": [ { "line_item_id": "460000000067009", "item_id": "460000000054135", "sku": "string", "name": "string", "account_id": "460000000000403", "account_name": "Other Expenses", "image_document_id": 460000000038067, "location_id": "460000000038080", "location_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": "460000000000567", "tag_option_id": "460000000014044" } ], "quantity": 1, "tax_id": "460000000027005", "tds_tax_id": "460000000027001", "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", "hsn_or_sac": 80540, "is_billable": false, "customer_id": "string", "customer_name": "string", "project_id": "string", "project_name": "string", "item_custom_fields": [ { "custom_field_id": "string", "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": "string", "index": 0, "label": "string", "value": "string" } ], "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, "tags": [ { "tag_id": "460000000000567", "tag_name": "Business Unit", "tag_option_id": "460000000014044", "tag_option_name": "Sales", "is_tag_mandatory": false } ] }

Create a recurring bill AI Tools

Open in ChatGPT

Open in ChatGPT to ask questions about this page

Open in Claude

Open in Claude to ask questions about this page

Copy as Markdown

Copy this page as markdown to use with AI assistants

View as Markdown

Open this page as markdown in a new tab

Create a recurring bill.
OAuth Scope : ERP.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
🇮🇳 India
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
🇮🇳 India
only
Place of supply for GST (Indian state/UT code where the purchase is treated as supplied). If omitted, the contact's place of contact may apply. Example: TN (Tamil Nadu).
destination_of_supply
string
🇮🇳 India
only
Place where the goods/services are supplied to. (If not given, organization's home state will be taken)
gst_treatment
string
🇮🇳 India
only
Choose whether the contact is GST registered/unregistered/consumer/overseas. Allowed values are business_gst , business_none , overseas , consumer .
gst_no
string
🇮🇳 India
only
15 digit GST identification number of the vendor.
is_reverse_charge_applied
boolean
🇮🇳 India
only
Applicable for transactions where you pay reverse charge.
pricebook_id
string
Enter ID of the price book.
is_inclusive_tax
boolean
Used to specify whether the line item rates are inclusive or exclusive of tax.
location_id
string
Location ID.
line_items
array
Line items of a recurrence bill.
Show Sub-Attributes arrow
line_item_id
string
ID of the Line Item.
item_id
string
ID of the Item.
name
string
Name of the line item.
account_id
string
ID of the chart of accounts entry for the line item. Use the Chart of Accounts API to resolve valid IDs. Note: This value is a set of numeric characters.
description
string
Description of the line item.
rate
double
Rate of the line item.
hsn_or_sac
string
🇮🇳 India
only
Add HSN/SAC code for your goods/services.
reverse_charge_tax_id
string
🇮🇳 India
only
Reverse charge tax ID.
location_id
string
Location ID.
quantity
double
Quantity of the line item.
tax_id
string
ID of the tax or tax group applied to the line item. Note: This value is a set of numeric characters.
tds_tax_id
string
🇮🇳 India
only
TDS (Tax Deducted at Source) tax or tax group ID for this line item, as returned by the Taxes API. Note: This value is a set of numeric characters.
tax_exemption_id
string
🇮🇳 India
only
ID of the Tax Exemption Applied.
tax_exemption_code
string
🇮🇳 India
only
Code of the Tax Exemption Applied.
item_order
integer
Order of the line item.
unit
string
Unit of the Item.
tags
array
Reporting tags help organize and filter data across reports and enable detailed business intelligence analysis.
Show Sub-Attributes arrow
tag_id
string
ID of the tag.
tag_option_id
string
ID of the tag option.
is_billable
boolean
Indicates if entity is Billable.
project_id
string
ID of the Project.
customer_id
string
ID of the Customer.
item_custom_fields
array
List of custom fields for the line item.
Show Sub-Attributes arrow
custom_field_id
string
Unique ID of the custom field.
index
integer
Index of the custom field.
value
string
Value of the Custom Field.
label
string
Label of the Custom Field.
serial_numbers
array
List of serial numbers for the line item.
is_tds_applied
boolean
🇮🇳 India
only
Indicates if TDS is applied.
notes
string
Notes for the Bill.
terms
string
Terms and Conditions for the Bill.
payment_terms
integer
Number Referring to Payment Terms.
payment_terms_label
string
Label of the Payment Terms.
custom_fields
array
List of custom fields for the recurring bill.
Show Sub-Attributes arrow
index
integer
Index of the custom field.
value
string
Value of the Custom Field.
discount
string
Discount applied to the recurring bill, which can be either a percentage or a flat amount. For percentage discounts, the value should include the % symbol (e.g., 10%). For example, on Rs.1000, a 10% discount results in Rs.900, while a flat Rs.200 discount results in Rs.800.
discount_account_id
string
ID of the account associated with the discount account.
is_discount_before_tax
boolean
To specify discount applied in before /after tax.
repeat_every
string
(Required)
Description for repeat_every.
recurrence_frequency
string
(Required)
Description for recurrence_frequency.
tags
array
Reporting tags help organize and filter data across reports and enable detailed business intelligence analysis.
Show Sub-Attributes arrow
tag_id
string
ID of the tag.
tag_option_id
string
ID of the tag option.

Query Parameters

organization_id
string
(Required)
ID of the organization

Request Example

Click to copy
parameters_data='{"field1":"value1","field2":"value2"}'; headers_data = Map(); headers_data.put("Authorization", "Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f"); response = invokeUrl [ url: "https://www.zohoapis.in/erp/v3/recurringbills?organization_id=10234695" type: POST headers: headers_data content-type: application/json parameters: parameters_data connection: <connection_name> ]; info response;
OkHttpClient client = new OkHttpClient(); MediaType mediaType = MediaType.parse("application/json"); RequestBody body = RequestBody.create(mediaType, "{\"field1\":\"value1\",\"field2\":\"value2\"}"); Request request = new Request.Builder() .url("https://www.zohoapis.in/erp/v3/recurringbills?organization_id=10234695") .post(body) .addHeader("Authorization", "Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f") .addHeader("content-type", "application/json") .build(); Response response = client.newCall(request).execute();
const options = { method: 'POST', headers: { Authorization: 'Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f', 'content-type': 'application/json' }, body: '{"field1":"value1","field2":"value2"}' }; fetch('https://www.zohoapis.in/erp/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.in") payload = "{\"field1\":\"value1\",\"field2\":\"value2\"}" headers = { 'Authorization': "Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f", 'content-type': "application/json" } conn.request("POST", "/erp/v3/recurringbills?organization_id=10234695", payload, headers) res = conn.getresponse() data = res.read() print(data.decode("utf-8"))
const http = require("https"); const options = { "method": "POST", "hostname": "www.zohoapis.in", "port": null, "path": "/erp/v3/recurringbills?organization_id=10234695", "headers": { "Authorization": "Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f", "content-type": "application/json" } }; 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.write(JSON.stringify({field1: 'value1', field2: 'value2'})); req.end();
curl --request POST \ --url 'https://www.zohoapis.in/erp/v3/recurringbills?organization_id=10234695' \ --header 'Authorization: Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f' \ --header 'content-type: application/json' \ --data '{"field1":"value1","field2":"value2"}'

Body Parameters

Click to copy
{ "vendor_id": "460000000038029", "currency_id": "460000000000099", "recurrence_name": "Monthly Rental", "start_date": "2013-11-18", "end_date": "2013-12-18", "source_of_supply": "AP", "place_of_supply": "TN", "destination_of_supply": "TN", "gst_treatment": "business_gst", "gst_no": "22AAAAA0000A1Z5", "is_reverse_charge_applied": true, "pricebook_id": 460000000038090, "is_inclusive_tax": false, "location_id": "460000000038080", "line_items": [ { "line_item_id": "460000000067009", "item_id": "460000000054135", "name": "string", "account_id": "460000000000403", "description": "string", "rate": 10, "hsn_or_sac": 80540, "reverse_charge_tax_id": 460000000038056, "location_id": "460000000038080", "quantity": 1, "tax_id": "460000000027005", "tds_tax_id": "460000000027001", "tax_exemption_id": "string", "tax_exemption_code": "string", "item_order": 1, "unit": "kgs", "tags": [ { "tag_id": "460000000000567", "tag_option_id": "460000000014044" } ], "is_billable": false, "project_id": "string", "customer_id": "string", "item_custom_fields": [ { "custom_field_id": "string", "index": 0, "value": "string", "label": "string" } ], "serial_numbers": [ "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": [ { "index": 0, "value": "string" } ], "discount": "30%", "discount_account_id": "460000000000403", "is_discount_before_tax": true, "repeat_every": "", "recurrence_frequency": "", "tags": [ { "tag_id": "460000000000567", "tag_option_id": "460000000014044" } ] }

Response Example

{ "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": "TN", "destination_of_supply": "TN", "gst_treatment": "business_gst", "gst_no": "22AAAAA0000A1Z5", "is_reverse_charge_applied": true, "pricebook_id": 460000000038090, "pricebook_name": "string", "is_inclusive_tax": false, "location_id": "460000000038080", "location_name": "string", "line_items": [ { "line_item_id": "460000000067009", "item_id": "460000000054135", "sku": "string", "name": "string", "account_id": "460000000000403", "account_name": "Other Expenses", "image_document_id": 460000000038067, "location_id": "460000000038080", "location_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": "460000000000567", "tag_option_id": "460000000014044" } ], "quantity": 1, "tax_id": "460000000027005", "tds_tax_id": "460000000027001", "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", "hsn_or_sac": 80540, "is_billable": false, "customer_id": "string", "customer_name": "string", "project_id": "string", "project_name": "string", "item_custom_fields": [ { "custom_field_id": "string", "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": "string", "index": 0, "label": "string", "value": "string" } ], "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, "tags": [ { "tag_id": "460000000000567", "tag_name": "Business Unit", "tag_option_id": "460000000014044", "tag_option_name": "Sales", "is_tag_mandatory": false } ] } }

Update a recurring bill using a custom field's unique value AI Tools

Open in ChatGPT

Open in ChatGPT to ask questions about this page

Open in Claude

Open in Claude to ask questions about this page

Copy as Markdown

Copy this page as markdown to use with AI assistants

View as Markdown

Open this page as markdown in a new tab

A custom field will have unique values if it's configured to not accept duplicate values. Now, you can use that custom field's value to update a recurring bill by providing its API name in the X-Unique-Identifier-Key header and its value in the X-Unique-Identifier-Value header. Based on this value, the corresponding recurring bill will be retrieved and updated. Additionally, there is an optional X-Upsert header. If the X-Upsert header is true and the custom field's unique value is not found in any of the existing recurring bills, a new recurring bill will be created if the necessary payload details are available.
OAuth Scope : ERP.settings.UPDATE

Arguments

recurring_bill_id
string
Unique ID of the recurring bill.
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
🇮🇳 India
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
🇮🇳 India
only
Place of supply for GST (Indian state/UT code where the purchase is treated as supplied). If omitted, the contact's place of contact may apply. Example: TN (Tamil Nadu).
destination_of_supply
string
🇮🇳 India
only
Place where the goods/services are supplied to. (If not given, organization's home state will be taken)
gst_treatment
string
🇮🇳 India
only
Choose whether the contact is GST registered/unregistered/consumer/overseas. Allowed values are business_gst , business_none , overseas , consumer .
gst_no
string
🇮🇳 India
only
15 digit GST identification number of the vendor.
is_reverse_charge_applied
boolean
🇮🇳 India
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
Used to specify whether the line item rates are inclusive or exclusive of tax.
location_id
string
Location ID.
line_items
array
Line items of a recurrence bill.
Show Sub-Attributes arrow
line_item_id
string
ID of the Line Item.
item_id
string
ID of the Item.
name
string
Name of the line item.
account_id
string
ID of the chart of accounts entry for the line item. Use the Chart of Accounts API to resolve valid IDs. Note: This value is a set of numeric characters.
description
string
Description of the line item.
rate
double
Rate of the line item.
hsn_or_sac
string
🇮🇳 India
only
Add HSN/SAC code for your goods/services.
reverse_charge_tax_id
string
🇮🇳 India
only
Reverse charge tax ID.
location_id
string
Location ID.
quantity
double
Quantity of the line item.
tax_id
string
ID of the tax or tax group applied to the line item. Note: This value is a set of numeric characters.
tds_tax_id
string
🇮🇳 India
only
TDS (Tax Deducted at Source) tax or tax group ID for this line item, as returned by the Taxes API. Note: This value is a set of numeric characters.
tax_exemption_id
string
🇮🇳 India
only
ID of the Tax Exemption Applied.
tax_exemption_code
string
🇮🇳 India
only
Code of the Tax Exemption Applied.
item_order
integer
Order of the line item.
unit
string
Unit of the Item.
tags
array
Reporting tags help organize and filter data across reports and enable detailed business intelligence analysis.
Show Sub-Attributes arrow
tag_id
string
ID of the tag.
tag_option_id
string
ID of the tag option.
is_billable
boolean
Indicates if entity is Billable.
project_id
string
ID of the Project.
customer_id
string
ID of the Customer.
item_custom_fields
array
List of custom fields for the line item.
Show Sub-Attributes arrow
custom_field_id
string
Unique ID of the custom field.
index
integer
Index of the custom field.
value
string
Value of the Custom Field.
label
string
Label of the Custom Field.
serial_numbers
array
List of serial numbers for the line item.
is_tds_applied
boolean
🇮🇳 India
only
Indicates if TDS is applied.
notes
string
Notes for the Bill.
terms
string
Terms and Conditions for the Bill.
payment_terms
integer
Number Referring to Payment Terms.
payment_terms_label
string
Label of the Payment Terms.
custom_fields
array
List of custom fields for the recurring bill.
Show Sub-Attributes arrow
index
integer
Index of the custom field.
value
string
Value of the Custom Field.
discount
string
Discount applied to the recurring bill, which can be either a percentage or a flat amount. For percentage discounts, the value should include the % symbol (e.g., 10%). For example, on Rs.1000, a 10% discount results in Rs.900, while a flat Rs.200 discount results in Rs.800.
discount_account_id
string
ID of the account associated with the discount account.
is_discount_before_tax
boolean
To specify discount applied in before /after tax.
repeat_every
string
(Required)
Description for repeat_every.
recurrence_frequency
string
(Required)
Description for recurrence_frequency.
tags
array
Reporting tags help organize and filter data across reports and enable detailed business intelligence analysis.
Show Sub-Attributes arrow
tag_id
string
ID of the tag.
tag_option_id
string
ID of the tag option.

Query Parameters

organization_id
string
(Required)
ID of the organization

Headers

X-Unique-Identifier-Key
string
(Required)
Unique CustomField Api Name.
X-Unique-Identifier-Value
string
(Required)
Unique CustomField Value.
X-Upsert
boolean
If there is no record is found unique custom field value , will create new invoice.

Request Example

Click to copy
parameters_data='{"field1":"value1","field2":"value2"}'; headers_data = Map(); headers_data.put("X-Unique-Identifier-Key", "cf_unique_cf"); headers_data.put("X-Unique-Identifier-Value", "unique Value"); headers_data.put("X-Upsert", "true"); headers_data.put("Authorization", "Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f"); response = invokeUrl [ url: "https://www.zohoapis.in/erp/v3/recurringbills?organization_id=10234695" type: PUT headers: headers_data content-type: application/json parameters: parameters_data connection: <connection_name> ]; info response;
OkHttpClient client = new OkHttpClient(); MediaType mediaType = MediaType.parse("application/json"); RequestBody body = RequestBody.create(mediaType, "{\"field1\":\"value1\",\"field2\":\"value2\"}"); Request request = new Request.Builder() .url("https://www.zohoapis.in/erp/v3/recurringbills?organization_id=10234695") .put(body) .addHeader("X-Unique-Identifier-Key", "cf_unique_cf") .addHeader("X-Unique-Identifier-Value", "unique Value") .addHeader("X-Upsert", "true") .addHeader("Authorization", "Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f") .addHeader("content-type", "application/json") .build(); Response response = client.newCall(request).execute();
const options = { method: 'PUT', headers: { 'X-Unique-Identifier-Key': 'cf_unique_cf', 'X-Unique-Identifier-Value': 'unique Value', 'X-Upsert': 'true', Authorization: 'Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f', 'content-type': 'application/json' }, body: '{"field1":"value1","field2":"value2"}' }; fetch('https://www.zohoapis.in/erp/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.in") payload = "{\"field1\":\"value1\",\"field2\":\"value2\"}" headers = { 'X-Unique-Identifier-Key': "cf_unique_cf", 'X-Unique-Identifier-Value': "unique Value", 'X-Upsert': "true", 'Authorization': "Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f", 'content-type': "application/json" } conn.request("PUT", "/erp/v3/recurringbills?organization_id=10234695", payload, headers) res = conn.getresponse() data = res.read() print(data.decode("utf-8"))
const http = require("https"); const options = { "method": "PUT", "hostname": "www.zohoapis.in", "port": null, "path": "/erp/v3/recurringbills?organization_id=10234695", "headers": { "X-Unique-Identifier-Key": "cf_unique_cf", "X-Unique-Identifier-Value": "unique Value", "X-Upsert": "true", "Authorization": "Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f", "content-type": "application/json" } }; 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.write(JSON.stringify({field1: 'value1', field2: 'value2'})); req.end();
curl --request PUT \ --url 'https://www.zohoapis.in/erp/v3/recurringbills?organization_id=10234695' \ --header 'Authorization: Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f' \ --header 'X-Unique-Identifier-Key: cf_unique_cf' \ --header 'X-Unique-Identifier-Value: unique Value' \ --header 'X-Upsert: true' \ --header 'content-type: application/json' \ --data '{"field1":"value1","field2":"value2"}'

Body Parameters

Click to copy
{ "recurring_bill_id": 982000000567240, "vendor_id": "460000000038029", "currency_id": "460000000000099", "status": "active", "recurrence_name": "Monthly Rental", "start_date": "2013-11-18", "end_date": "2013-12-18", "source_of_supply": "AP", "place_of_supply": "TN", "destination_of_supply": "TN", "gst_treatment": "business_gst", "gst_no": "22AAAAA0000A1Z5", "is_reverse_charge_applied": true, "pricebook_id": 460000000038090, "pricebook_name": "string", "is_inclusive_tax": false, "location_id": "460000000038080", "line_items": [ { "line_item_id": "460000000067009", "item_id": "460000000054135", "name": "string", "account_id": "460000000000403", "description": "string", "rate": 10, "hsn_or_sac": 80540, "reverse_charge_tax_id": 460000000038056, "location_id": "460000000038080", "quantity": 1, "tax_id": "460000000027005", "tds_tax_id": "460000000027001", "tax_exemption_id": "string", "tax_exemption_code": "string", "item_order": 1, "unit": "kgs", "tags": [ { "tag_id": "460000000000567", "tag_option_id": "460000000014044" } ], "is_billable": false, "project_id": "string", "customer_id": "string", "item_custom_fields": [ { "custom_field_id": "string", "index": 0, "value": "string", "label": "string" } ], "serial_numbers": [ "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": [ { "index": 0, "value": "string" } ], "discount": "30%", "discount_account_id": "460000000000403", "is_discount_before_tax": true, "repeat_every": "", "recurrence_frequency": "", "tags": [ { "tag_id": "460000000000567", "tag_option_id": "460000000014044" } ] }

Response Example

{ "code": 0, "message": "Recurring Bill information has been updated." }

List recurring bills AI Tools

Open in ChatGPT

Open in ChatGPT to ask questions about this page

Open in Claude

Open in Claude to ask questions about this page

Copy as Markdown

Copy this page as markdown to use with AI assistants

View as Markdown

Open this page as markdown in a new tab

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

Query Parameters

organization_id
string
(Required)
ID of the organization
recurring_bill_id
string
Unique identifier of the recurring bill.
vendor_id
string
Search recurring bills by Vendor ID.
vendor_name
string
Search recurring bills by vendor name. Variants: vendor_name_startswith and vendor_name_contains
status
string
Search recurring bills by recurring bill status. Allowed Values: active, stopped, expired
recurrence_name
string
Search recurring bills by recurrence number. Variants: recurrence_name_startswith and recurrence_name_contains
currency_id
string
ID of the Currency.
currency_code
string
Code of the Currency.
currency_symbol
string
Symbol of the Currency.
start_date
string
Search recurring bills by recurring bill start date. Variants: start_date_start, start_date_end, start_date_before and start_date_after
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
🇮🇳 India
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
🇮🇳 India
only
Place of supply for GST (Indian state/UT code where the purchase is treated as supplied). If omitted, vendor contact or organization defaults may apply. Example: TN (Tamil Nadu).
destination_of_supply
string
🇮🇳 India
only
Place where the goods/services are supplied to. (If not given, organization's home state will be taken)
gst_treatment
string
🇮🇳 India
only
Choose whether the contact is GST registered/unregistered/consumer/overseas. Allowed values are business_gst , business_none , overseas , consumer .
gst_no
string
🇮🇳 India
only
15 digit GST identification number of the vendor.

Request Example

Click to copy
headers_data = Map(); headers_data.put("Authorization", "Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f"); response = invokeUrl [ url: "https://www.zohoapis.in/erp/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.in/erp/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.in/erp/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.in") headers = { 'Authorization': "Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f" } conn.request("GET", "/erp/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.in", "port": null, "path": "/erp/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.in/erp/v3/recurringbills?organization_id=10234695' \ --header 'Authorization: Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f'

Response Example

{ "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": "TN", "destination_of_supply": "TN", "gst_treatment": "business_gst", "gst_no": "22AAAAA0000A1Z5", "is_reverse_charge_applied": true, "pricebook_id": 460000000038090, "pricebook_name": "string", "is_inclusive_tax": false, "location_id": "460000000038080", "location_name": "string", "line_items": [ { "line_item_id": "460000000067009", "item_id": "460000000054135", "sku": "string", "name": "string", "account_id": "460000000000403", "account_name": "Other Expenses", "image_document_id": 460000000038067, "location_id": "460000000038080", "location_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": "460000000000567", "tag_option_id": "460000000014044" } ], "quantity": 1, "tax_id": "460000000027005", "tds_tax_id": "460000000027001", "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", "hsn_or_sac": 80540, "is_billable": false, "customer_id": "string", "customer_name": "string", "project_id": "string", "project_name": "string", "item_custom_fields": [ { "custom_field_id": "string", "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": "string", "index": 0, "label": "string", "value": "string" } ], "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, "tags": [ { "tag_id": "460000000000567", "tag_name": "Business Unit", "tag_option_id": "460000000014044", "tag_option_name": "Sales", "is_tag_mandatory": false } ] }, {...}, {...} ] }

Update a recurring bill AI Tools

Open in ChatGPT

Open in ChatGPT to ask questions about this page

Open in Claude

Open in Claude to ask questions about this page

Copy as Markdown

Copy this page as markdown to use with AI assistants

View as Markdown

Open this page as markdown in a new tab

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

Arguments

recurring_bill_id
string
Unique ID of the recurring bill.
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
🇮🇳 India
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
🇮🇳 India
only
Place of supply for GST (Indian state/UT code where the purchase is treated as supplied). If omitted, the contact's place of contact may apply. Example: TN (Tamil Nadu).
destination_of_supply
string
🇮🇳 India
only
Place where the goods/services are supplied to. (If not given, organization's home state will be taken)
gst_treatment
string
🇮🇳 India
only
Choose whether the contact is GST registered/unregistered/consumer/overseas. Allowed values are business_gst , business_none , overseas , consumer .
gst_no
string
🇮🇳 India
only
15 digit GST identification number of the vendor.
is_reverse_charge_applied
boolean
🇮🇳 India
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
Used to specify whether the line item rates are inclusive or exclusive of tax.
location_id
string
Location ID.
line_items
array
Line items of a recurrence bill.
Show Sub-Attributes arrow
line_item_id
string
ID of the Line Item.
item_id
string
ID of the Item.
name
string
Name of the line item.
account_id
string
ID of the chart of accounts entry for the line item. Use the Chart of Accounts API to resolve valid IDs. Note: This value is a set of numeric characters.
description
string
Description of the line item.
rate
double
Rate of the line item.
hsn_or_sac
string
🇮🇳 India
only
Add HSN/SAC code for your goods/services.
reverse_charge_tax_id
string
🇮🇳 India
only
Reverse charge tax ID.
location_id
string
Location ID.
quantity
double
Quantity of the line item.
tax_id
string
ID of the tax or tax group applied to the line item. Note: This value is a set of numeric characters.
tds_tax_id
string
🇮🇳 India
only
TDS (Tax Deducted at Source) tax or tax group ID for this line item, as returned by the Taxes API. Note: This value is a set of numeric characters.
tax_exemption_id
string
🇮🇳 India
only
ID of the Tax Exemption Applied.
tax_exemption_code
string
🇮🇳 India
only
Code of the Tax Exemption Applied.
item_order
integer
Order of the line item.
unit
string
Unit of the Item.
tags
array
Reporting tags help organize and filter data across reports and enable detailed business intelligence analysis.
Show Sub-Attributes arrow
tag_id
string
ID of the tag.
tag_option_id
string
ID of the tag option.
is_billable
boolean
Indicates if entity is Billable.
project_id
string
ID of the Project.
customer_id
string
ID of the Customer.
item_custom_fields
array
List of custom fields for the line item.
Show Sub-Attributes arrow
custom_field_id
string
Unique ID of the custom field.
index
integer
Index of the custom field.
value
string
Value of the Custom Field.
label
string
Label of the Custom Field.
serial_numbers
array
List of serial numbers for the line item.
is_tds_applied
boolean
🇮🇳 India
only
Indicates if TDS is applied.
notes
string
Notes for the Bill.
terms
string
Terms and Conditions for the Bill.
payment_terms
integer
Number Referring to Payment Terms.
payment_terms_label
string
Label of the Payment Terms.
custom_fields
array
List of custom fields for the recurring bill.
Show Sub-Attributes arrow
index
integer
Index of the custom field.
value
string
Value of the Custom Field.
discount
string
Discount applied to the recurring bill, which can be either a percentage or a flat amount. For percentage discounts, the value should include the % symbol (e.g., 10%). For example, on Rs.1000, a 10% discount results in Rs.900, while a flat Rs.200 discount results in Rs.800.
discount_account_id
string
ID of the account associated with the discount account.
is_discount_before_tax
boolean
To specify discount applied in before /after tax.
repeat_every
string
(Required)
Description for repeat_every.
recurrence_frequency
string
(Required)
Description for recurrence_frequency.
tags
array
Reporting tags help organize and filter data across reports and enable detailed business intelligence analysis.
Show Sub-Attributes arrow
tag_id
string
ID of the tag.
tag_option_id
string
ID of the tag option.

Path Parameters

recurring_bill_id
string
(Required)
Unique identifier of the recurring bill.

Query Parameters

organization_id
string
(Required)
ID of the organization

Request Example

Click to copy
parameters_data='{"field1":"value1","field2":"value2"}'; headers_data = Map(); headers_data.put("Authorization", "Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f"); response = invokeUrl [ url: "https://www.zohoapis.in/erp/v3/recurringbills/982000000567240?organization_id=10234695" type: PUT headers: headers_data content-type: application/json parameters: parameters_data connection: <connection_name> ]; info response;
OkHttpClient client = new OkHttpClient(); MediaType mediaType = MediaType.parse("application/json"); RequestBody body = RequestBody.create(mediaType, "{\"field1\":\"value1\",\"field2\":\"value2\"}"); Request request = new Request.Builder() .url("https://www.zohoapis.in/erp/v3/recurringbills/982000000567240?organization_id=10234695") .put(body) .addHeader("Authorization", "Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f") .addHeader("content-type", "application/json") .build(); Response response = client.newCall(request).execute();
const options = { method: 'PUT', headers: { Authorization: 'Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f', 'content-type': 'application/json' }, body: '{"field1":"value1","field2":"value2"}' }; fetch('https://www.zohoapis.in/erp/v3/recurringbills/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.in") payload = "{\"field1\":\"value1\",\"field2\":\"value2\"}" headers = { 'Authorization': "Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f", 'content-type': "application/json" } conn.request("PUT", "/erp/v3/recurringbills/982000000567240?organization_id=10234695", payload, headers) res = conn.getresponse() data = res.read() print(data.decode("utf-8"))
const http = require("https"); const options = { "method": "PUT", "hostname": "www.zohoapis.in", "port": null, "path": "/erp/v3/recurringbills/982000000567240?organization_id=10234695", "headers": { "Authorization": "Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f", "content-type": "application/json" } }; 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.write(JSON.stringify({field1: 'value1', field2: 'value2'})); req.end();
curl --request PUT \ --url 'https://www.zohoapis.in/erp/v3/recurringbills/982000000567240?organization_id=10234695' \ --header 'Authorization: Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f' \ --header 'content-type: application/json' \ --data '{"field1":"value1","field2":"value2"}'

Body Parameters

Click to copy
{ "recurring_bill_id": 982000000567240, "vendor_id": "460000000038029", "currency_id": "460000000000099", "status": "active", "recurrence_name": "Monthly Rental", "start_date": "2013-11-18", "end_date": "2013-12-18", "source_of_supply": "AP", "place_of_supply": "TN", "destination_of_supply": "TN", "gst_treatment": "business_gst", "gst_no": "22AAAAA0000A1Z5", "is_reverse_charge_applied": true, "pricebook_id": 460000000038090, "pricebook_name": "string", "is_inclusive_tax": false, "location_id": "460000000038080", "line_items": [ { "line_item_id": "460000000067009", "item_id": "460000000054135", "name": "string", "account_id": "460000000000403", "description": "string", "rate": 10, "hsn_or_sac": 80540, "reverse_charge_tax_id": 460000000038056, "location_id": "460000000038080", "quantity": 1, "tax_id": "460000000027005", "tds_tax_id": "460000000027001", "tax_exemption_id": "string", "tax_exemption_code": "string", "item_order": 1, "unit": "kgs", "tags": [ { "tag_id": "460000000000567", "tag_option_id": "460000000014044" } ], "is_billable": false, "project_id": "string", "customer_id": "string", "item_custom_fields": [ { "custom_field_id": "string", "index": 0, "value": "string", "label": "string" } ], "serial_numbers": [ "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": [ { "index": 0, "value": "string" } ], "discount": "30%", "discount_account_id": "460000000000403", "is_discount_before_tax": true, "repeat_every": "", "recurrence_frequency": "", "tags": [ { "tag_id": "460000000000567", "tag_option_id": "460000000014044" } ] }

Response Example

{ "code": 0, "message": "Recurring Bill information has been updated." }

Get a recurring bill AI Tools

Open in ChatGPT

Open in ChatGPT to ask questions about this page

Open in Claude

Open in Claude to ask questions about this page

Copy as Markdown

Copy this page as markdown to use with AI assistants

View as Markdown

Open this page as markdown in a new tab

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

Path Parameters

recurring_bill_id
string
(Required)
Unique identifier of the recurring bill.

Query Parameters

organization_id
string
(Required)
ID of the organization

Request Example

Click to copy
headers_data = Map(); headers_data.put("Authorization", "Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f"); response = invokeUrl [ url: "https://www.zohoapis.in/erp/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.in/erp/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.in/erp/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.in") headers = { 'Authorization': "Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f" } conn.request("GET", "/erp/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.in", "port": null, "path": "/erp/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.in/erp/v3/recurring_bills/982000000567240?organization_id=10234695' \ --header 'Authorization: Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f'

Response Example

{ "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": "TN", "destination_of_supply": "TN", "gst_treatment": "business_gst", "gst_no": "22AAAAA0000A1Z5", "is_reverse_charge_applied": true, "pricebook_id": 460000000038090, "pricebook_name": "string", "is_inclusive_tax": false, "location_id": "460000000038080", "location_name": "string", "line_items": [ { "line_item_id": "460000000067009", "item_id": "460000000054135", "sku": "string", "name": "string", "account_id": "460000000000403", "account_name": "Other Expenses", "image_document_id": 460000000038067, "location_id": "460000000038080", "location_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": "460000000000567", "tag_option_id": "460000000014044" } ], "quantity": 1, "tax_id": "460000000027005", "tds_tax_id": "460000000027001", "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", "hsn_or_sac": 80540, "is_billable": false, "customer_id": "string", "customer_name": "string", "project_id": "string", "project_name": "string", "item_custom_fields": [ { "custom_field_id": "string", "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": "string", "index": 0, "label": "string", "value": "string" } ], "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, "tags": [ { "tag_id": "460000000000567", "tag_name": "Business Unit", "tag_option_id": "460000000014044", "tag_option_name": "Sales", "is_tag_mandatory": false } ] } }

Delete a recurring bill AI Tools

Open in ChatGPT

Open in ChatGPT to ask questions about this page

Open in Claude

Open in Claude to ask questions about this page

Copy as Markdown

Copy this page as markdown to use with AI assistants

View as Markdown

Open this page as markdown in a new tab

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

Path Parameters

recurring_bill_id
string
(Required)
Unique identifier of the recurring bill.

Query Parameters

organization_id
string
(Required)
ID of the organization

Request Example

Click to copy
headers_data = Map(); headers_data.put("Authorization", "Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f"); response = invokeUrl [ url: "https://www.zohoapis.in/erp/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.in/erp/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.in/erp/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.in") headers = { 'Authorization': "Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f" } conn.request("DELETE", "/erp/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.in", "port": null, "path": "/erp/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.in/erp/v3/recurring_bills/982000000567240?organization_id=10234695' \ --header 'Authorization: Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f'

Response Example

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

Stop a recurring bill AI Tools

Open in ChatGPT

Open in ChatGPT to ask questions about this page

Open in Claude

Open in Claude to ask questions about this page

Copy as Markdown

Copy this page as markdown to use with AI assistants

View as Markdown

Open this page as markdown in a new tab

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

Path Parameters

recurring_bill_id
string
(Required)
Unique identifier of the recurring bill.

Query Parameters

organization_id
string
(Required)
ID of the organization

Request Example

Click to copy
headers_data = Map(); headers_data.put("Authorization", "Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f"); response = invokeUrl [ url: "https://www.zohoapis.in/erp/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.in/erp/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.in/erp/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.in") headers = { 'Authorization': "Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f" } conn.request("POST", "/erp/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.in", "port": null, "path": "/erp/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.in/erp/v3/recurringbills/982000000567240/status/stop?organization_id=10234695' \ --header 'Authorization: Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f'

Response Example

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

Resume a recurring Bill AI Tools

Open in ChatGPT

Open in ChatGPT to ask questions about this page

Open in Claude

Open in Claude to ask questions about this page

Copy as Markdown

Copy this page as markdown to use with AI assistants

View as Markdown

Open this page as markdown in a new tab

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

Path Parameters

recurring_bill_id
string
(Required)
Unique identifier of the recurring bill.

Query Parameters

organization_id
string
(Required)
ID of the organization

Request Example

Click to copy
headers_data = Map(); headers_data.put("Authorization", "Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f"); response = invokeUrl [ url: "https://www.zohoapis.in/erp/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.in/erp/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.in/erp/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.in") headers = { 'Authorization': "Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f" } conn.request("POST", "/erp/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.in", "port": null, "path": "/erp/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.in/erp/v3/recurringbills/982000000567240/status/resume?organization_id=10234695' \ --header 'Authorization: Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f'

Response Example

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

List recurring bill history AI Tools

Open in ChatGPT

Open in ChatGPT to ask questions about this page

Open in Claude

Open in Claude to ask questions about this page

Copy as Markdown

Copy this page as markdown to use with AI assistants

View as Markdown

Open this page as markdown in a new tab

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

Path Parameters

recurring_bill_id
string
(Required)
Unique identifier of the recurring bill.

Query Parameters

organization_id
string
(Required)
ID of the organization

Request Example

Click to copy
headers_data = Map(); headers_data.put("Authorization", "Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f"); response = invokeUrl [ url: "https://www.zohoapis.in/erp/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.in/erp/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.in/erp/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.in") headers = { 'Authorization': "Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f" } conn.request("GET", "/erp/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.in", "port": null, "path": "/erp/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.in/erp/v3/recurringbills/982000000567240/comments?organization_id=10234695' \ --header 'Authorization: Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f'

Response Example

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