API Docs
/
No Results Found
FAQ
Help Docs
All Resources
Bills

Bills

When your vendor supplies goods/services to you on credit, you're sent an invoice that details the amount of money you owe him. You can record this as a bill in Zoho Inventory and track it until it's paid.

Download Bills OpenAPI Document
Download
Download Zoho Inventory OpenAPI Document
End Points
Create a Bill
List all Bills.
Update a Bill
Retrieve a Bill
Delete a Bill.
Update custom field in existing bills
Mark as Open
Mark as Void

Attribute

bill_id
long
Unique ID generated by the server. This is used as identifier.
purchaseorder_id
long
Unique ID generated by the server for the Purchase Order.
vendor_id
long
Unique ID generated by the server for the vendor.
vendor_name
string
Name of the vendor.
unused_credits_payable_amount
double
Unused credit payable amount.
status
string
Status of the Bill.
bill_number
string
Bill number of Purchase Order.
date
string
Date of the Bill.
due_date
string
Due date for the Bill.
reference_number
string
Reference number for the Bill.
due_by_days
integer
Number of days by which the Bill is due.
currency_id
long
Unique ID generated by the server for the currency. This is used as an identifier.
currency_code
string
Currency code.
currency_symbol
string
The symbol for the selected currency.
price_precision
integer
The precision level for the price's decimal point in a Bill.
exchange_rate
double
Exchange rate of the currency, with respect to the base currency.
is_item_level_tax_calc
boolean
Checks whether item level tax is calculated or not.
custom_fields
array
Custom fields for a bill.
Show Sub-Attributes arrow
customfield_id
long
Unique identifier of the custom field
value
string
Value of the Custom Field
line_items
array
The line items for a Bill.
Show Sub-Attributes arrow
purchaseorder_item_id
long
Unique ID generated for a line item in the Purchase Order.
receive_item_id
long
Unique ID generated by the server for the receive.
line_item_id
long
Unique ID generated by the server for each line item. This is used as an identifier.
name
string
Name of the line item.
account_id
long
Account ID of the item.
account_name
string
Name of the account.
description
string
Description for the line item.
bcy_rate
double
Item rate in the organization's base currency.
rate
double
Item's Puchase Price.
quantity
double
Quantity of the Item.
tax_id
long
Unique ID of the tax applied on the line item.
tds_tax_id
string
🇲🇽 Mexico
only
TDS ID of the tax or tax group applied to the line item
tax_name
string
Name of the tax.
tax_type
string
Type of the tax
tax_percentage
double
Percentage of the tax applied.
item_total
double
The total for the items.
item_order
double
Order of the line item, starting from 0.
unit
string
Unit of the item.
image_id
double
Unique ID generated by the server for the item image. This is used an identifier.
image_name
string
Name of the image of the line item.
image_type
string
The type (file format) of the image.
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
hsn_or_sac
string
🇮🇳 India
only
Add HSN/SAC code for your goods/services
tax_exemption_code
string
🇮🇳 India
, 🇦🇺 Australia
, 🇨🇦 Canada
, 🇲🇽 Mexico
only
Code of the Tax Exemption Applied
location_id
string
Location ID
location_name
string
Name of the location
tax_exemption_id
string
🇮🇳 India
, 🇦🇺 Australia
, 🇨🇦 Canada
only
ID of the Tax Exemption Applied
location_id
string
Location ID
location_name
string
Name of the location
taxes
array
Number of taxes applied on the Purchase Order. Each tax contains: tax_name and tax_amount.
Show Sub-Attributes arrow
tax_name
string
Name of the tax.
tax_amount
double
Amount of the tax.
vendor_credits_applied
double
Vendor credits applied to the Bill.
sub_total
double
Sub Total of the Bill.
tax_total
double
The total of the Tax.
balance
double
Remaining balance of the Bill.
billing_address
array
Customer's billing address. It contains - address, city, state, zip, country and fax.
Show Sub-Attributes arrow
address
string
Name of the street of the customer's billing address.
city
string
Name of the city of the customer's billing address.
state
string
Name of the state of the customer's billing address.
zip
string
Zip code of the customer's billing address.
country
string
Name of the country of the customer's billing address.
fax
string
Fax number of the customer's billing address.
payments
array
Payment details for the Bill.
Show Sub-Attributes arrow
payment_id
long
Unique ID generated by the server. This is used as identifier.
bill_id
long
Unique ID generated by the server. This is used as identifier.
bill_payment_id
long
Bill payment ID
payment_mode
string
Mode of payment for the Bill.
payment_number
string
Number of the payment.
description
string
Description for the line item.
date
string
Date of the Bill.
reference_number
string
Reference number for the Bill.
exchange_rate
double
Exchange rate of the currency, with respect to the base currency.
amount
double
Amount paid for the payment.
paid_through_account_id
long
ID for the account through which the payment is made.
paid_through_account_name
string
Name of the account.
is_single_bill_payment
boolean
Checks whether the payment is for single bills or multiple bills.
vendor_credits
array
The available Vendor Credits.
Show Sub-Attributes arrow
vendor_credit_id
long
Unique ID generated by server for vendor credits
vendor_credit_bill_id
long
Unique ID generated by server for vendor credit bills
vendor_credit_number
long
date
string
Date of the Bill.
amount
double
Amount paid for the payment.
created_time
string
Time at which the Bill details were last created.
last_modified_time
string
Time at which the bill details were last Modified.
reference_id
long
Unique ID generated by the server for the reference.
notes
string
Notes for the Bill.
terms
string
Terms and conditions.
attachment_name
string
Name of the attached file.
open_purchaseorders_count
integer
Number of Purchase Orders that are associated with this Bill and open.
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.
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)
destination_of_supply
string
🇮🇳 India
only
Place where the goods/services are supplied to. (If not given, organisation's home state will be taken)
is_pre_gst
boolean
🇮🇳 India
only
Applicable for transactions that fall before july 1, 2017
is_reverse_charge_applied
boolean
🇮🇳 India
only
Applicable for transactions where you pay reverse charge

Example

{ "bill_id": 4815000000045067, "purchaseorder_id": 4815000000044972, "vendor_id": 4815000000044080, "vendor_name": "Molly", "unused_credits_payable_amount": 0, "status": "paid", "bill_number": "BL-00002", "date": "2015-05-29", "due_date": "2015-05-29", "reference_number": "PO-00003", "due_by_days": 69, "currency_id": 4815000000000097, "currency_code": "USD", "currency_symbol": "$", "price_precision": 2, "exchange_rate": 1, "is_item_level_tax_calc": true, "custom_fields": [ { "customfield_id": "46000000012845", "value": "Normal" } ], "line_items": [ { "purchaseorder_item_id": 4815000000045245, "receive_item_id": 4815000000044131, "line_item_id": 4815000000044897, "name": "Laptop-white/15inch/dell", "account_id": 4815000000035003, "account_name": "Inventory Asset", "description": "Sample Description", "bcy_rate": 122, "rate": 6, "quantity": 5, "tax_id": 4815000000044043, "tds_tax_id": "460000000027009", "tax_name": "Purchase tax", "tax_type": "Tax group", "tax_percentage": 12, "item_total": 290, "item_order": 0, "unit": "qty", "image_id": 2077500000000002000, "image_name": "dell.jpg", "image_type": "jpg", "reverse_charge_tax_id": 460000000038056, "reverse_charge_tax_name": "inter", "reverse_charge_tax_percentage": 10, "reverse_charge_tax_amount": 100, "hsn_or_sac": 80540, "tax_exemption_code": "string", "location_id": "460000000038080", "location_name": "string", "tax_exemption_id": "string" } ], "location_id": "460000000038080", "location_name": "string", "taxes": [ { "tax_name": "Purchase tax", "tax_amount": 29 } ], "vendor_credits_applied": 24, "sub_total": 30, "tax_total": 2, "balance": 0, "billing_address": [ { "address": "No:234,90 Church Street", "city": "New York City", "state": "New York", "zip": 10048, "country": "U.S.A", "fax": "324-524242" } ], "payments": [ { "payment_id": 4815000000046039, "bill_id": 4815000000045067, "bill_payment_id": 4815000000046041, "payment_mode": "Cash", "payment_number": 2, "description": "Sample Description", "date": "2015-05-29", "reference_number": "PO-00003", "exchange_rate": 1, "amount": 234, "paid_through_account_id": 4815000000000361, "paid_through_account_name": "Petty Cash", "is_single_bill_payment": true } ], "vendor_credits": [ { "vendor_credit_id": 4815000000046039, "vendor_credit_bill_id": 4815000000768039, "vendor_credit_number": 67258, "date": "2015-05-29", "amount": 234 } ], "created_time": "2015-05-29T00:00:00.000Z", "last_modified_time": "2015-05-29T00:00:00.000Z", "reference_id": 4815000000000342, "notes": "Sample Note", "terms": "Term & Conditions", "attachment_name": "sample-attachments", "open_purchaseorders_count": 4, "gst_treatment": "business_gst", "gst_no": "22AAAAA0000A1Z5", "source_of_supply": "AP", "destination_of_supply": "TN", "is_pre_gst": false, "is_reverse_charge_applied": true }

Create a Bill

Creates a Bill in Zoho Inventory. Description about the extra parameter attachment Allowed extensions are gif, png, jpeg, jpg, bmp and pdf.
OAuth Scope : ZohoInventory.bills.CREATE

Arguments

purchaseorder_id
long
Unique ID generated by the server for the Purchase Order.
vendor_id
long
(Required)
Unique ID generated by the server for the vendor.
bill_number
string
(Required)
Bill number of Purchase Order.
date
string
(Required)
Date of the Bill.
due_date
string
(Required)
Due date for the Bill.
reference_number
string
Reference number for the Bill.
currency_id
long
Unique ID generated by the server for the currency. This is used as an identifier.
exchange_rate
double
Exchange rate of the currency, with respect to the base currency.
is_item_level_tax_calc
boolean
Checks whether item level tax is calculated or not.
notes
string
Notes for the Bill.
terms
string
Terms and conditions.
is_inclusive_tax
boolean
Indicates whether the item rates are tax inclusive or exclusive
custom_fields
array
Custom fields for a bill.
Show Sub-Attributes arrow
customfield_id
long
Unique identifier of the custom field
value
string
Value of the Custom Field
line_items
array
(Required)
The line items for a Bill.
Show Sub-Attributes arrow
purchaseorder_item_id
long
Unique ID generated for a line item in the Purchase Order.
receive_item_id
long
Unique ID generated by the server for the receive.
line_item_id
long
Unique ID generated by the server for each line item. This is used as an identifier.
name
string
Name of the line item.
account_id
long
Account ID of the item.
account_name
string
Name of the account.
description
string
Description for the line item.
bcy_rate
double
Item rate in the organization's base currency.
rate
double
Item's Puchase Price.
quantity
double
Quantity of the Item.
tax_id
long
Unique ID of the tax applied on the line item.
tds_tax_id
string
🇲🇽 Mexico
only
TDS ID of the tax or tax group applied to the line item
tax_name
string
Name of the tax.
tax_type
string
Type of the tax
tax_percentage
double
Percentage of the tax applied.
item_total
double
The total for the items.
item_order
double
Order of the line item, starting from 0.
unit
string
Unit of the item.
image_id
double
Unique ID generated by the server for the item image. This is used an identifier.
image_name
string
Name of the image of the line item.
image_type
string
The type (file format) of the image.
reverse_charge_tax_id
string
🇮🇳 India
only
Reverse charge tax ID
hsn_or_sac
string
🇮🇳 India
only
Add HSN/SAC code for your goods/services
tax_exemption_code
string
🇮🇳 India
, 🇦🇺 Australia
, 🇨🇦 Canada
, 🇲🇽 Mexico
only
Code of the Tax Exemption Applied
location_id
string
Location ID
tax_exemption_id
string
🇮🇳 India
, 🇦🇺 Australia
, 🇨🇦 Canada
only
ID of the Tax Exemption Applied
location_id
string
Location ID
gst_treatment
string
🇮🇳 India
only
Choose whether the contact is GST registered/unregistered/consumer/overseas. Allowed values are business_gst , business_none , overseas , consumer .
tax_treatment
string
🇲🇽 Mexico
only
VAT treatment for the bill. Choose whether the vendor falls under: home_country_mexico,border_region_mexico,non_mexico supported only for MX.
gst_no
string
🇮🇳 India
only
15 digit GST identification number of the vendor.
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)
destination_of_supply
string
🇮🇳 India
only
Place where the goods/services are supplied to. (If not given, organisation's home state will be taken)

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.com/inventory/v1/bills?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.com/inventory/v1/bills?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.com/inventory/v1/bills?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") payload = "{\"field1\":\"value1\",\"field2\":\"value2\"}" headers = { 'Authorization': "Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f", 'content-type': "application/json" } conn.request("POST", "/inventory/v1/bills?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.com", "port": null, "path": "/inventory/v1/bills?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.com/inventory/v1/bills?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
{ "purchaseorder_id": 4815000000044972, "vendor_id": 4815000000044080, "bill_number": "BL-00002", "date": "2015-05-29", "due_date": "2015-05-29", "reference_number": "PO-00003", "currency_id": 4815000000000097, "exchange_rate": 1, "is_item_level_tax_calc": true, "notes": "Sample Note", "terms": "Term & Conditions", "is_inclusive_tax": false, "custom_fields": [ { "customfield_id": "46000000012845", "value": "Normal" } ], "line_items": [ { "purchaseorder_item_id": 4815000000045245, "receive_item_id": 4815000000044131, "line_item_id": 4815000000044897, "name": "Laptop-white/15inch/dell", "account_id": 4815000000035003, "account_name": "Inventory Asset", "description": "Sample Description", "bcy_rate": 122, "rate": 6, "quantity": 5, "tax_id": 4815000000044043, "tds_tax_id": "460000000027009", "tax_name": "Purchase tax", "tax_type": "Tax group", "tax_percentage": 12, "item_total": 290, "item_order": 0, "unit": "qty", "image_id": 2077500000000002000, "image_name": "dell.jpg", "image_type": "jpg", "reverse_charge_tax_id": 460000000038056, "hsn_or_sac": 80540, "tax_exemption_code": "string", "location_id": "460000000038080", "tax_exemption_id": "string" } ], "location_id": "460000000038080", "gst_treatment": "business_gst", "tax_treatment": "vat_registered", "gst_no": "22AAAAA0000A1Z5", "source_of_supply": "AP", "destination_of_supply": "TN" }

Response Example

{ "code": 0, "message": "The Bill has been created.", "bill": { "bill_id": 4815000000045067, "purchaseorder_id": 4815000000044972, "vendor_id": 4815000000044080, "vendor_name": "Molly", "unused_credits_payable_amount": 0, "status": "paid", "bill_number": "BL-00002", "date": "2015-05-29", "due_date": "2015-05-29", "reference_number": "PO-00003", "due_by_days": 69, "currency_id": 4815000000000097, "currency_code": "USD", "currency_symbol": "$", "price_precision": 2, "exchange_rate": 1, "is_item_level_tax_calc": true, "custom_fields": [ { "customfield_id": "46000000012845", "value": "Normal" } ], "line_items": [ { "purchaseorder_item_id": 4815000000045245, "receive_item_id": 4815000000044131, "line_item_id": 4815000000044897, "name": "Laptop-white/15inch/dell", "account_id": 4815000000035003, "account_name": "Inventory Asset", "description": "Sample Description", "bcy_rate": 122, "rate": 6, "quantity": 5, "tax_id": 4815000000044043, "tds_tax_id": "460000000027009", "tax_name": "Purchase tax", "tax_type": "Tax group", "tax_percentage": 12, "item_total": 290, "item_order": 0, "unit": "qty", "image_id": 2077500000000002000, "image_name": "dell.jpg", "image_type": "jpg", "reverse_charge_tax_id": 460000000038056, "reverse_charge_tax_name": "inter", "reverse_charge_tax_percentage": 10, "reverse_charge_tax_amount": 100, "hsn_or_sac": 80540, "tax_exemption_code": "string", "location_id": "460000000038080", "location_name": "string", "tax_exemption_id": "string" } ], "location_id": "460000000038080", "location_name": "string", "taxes": [ { "tax_name": "Purchase tax", "tax_amount": 29 } ], "vendor_credits_applied": 24, "sub_total": 30, "tax_total": 2, "balance": 0, "billing_address": [ { "address": "No:234,90 Church Street", "city": "New York City", "state": "New York", "zip": 10048, "country": "U.S.A", "fax": "324-524242" } ], "payments": [ { "payment_id": 4815000000046039, "bill_id": 4815000000045067, "bill_payment_id": 4815000000046041, "payment_mode": "Cash", "payment_number": 2, "description": "Sample Description", "date": "2015-05-29", "reference_number": "PO-00003", "exchange_rate": 1, "amount": 234, "paid_through_account_id": 4815000000000361, "paid_through_account_name": "Petty Cash", "is_single_bill_payment": true } ], "vendor_credits": [ { "vendor_credit_id": 4815000000046039, "vendor_credit_bill_id": 4815000000768039, "vendor_credit_number": 67258, "date": "2015-05-29", "amount": 234 } ], "created_time": "2015-05-29T00:00:00.000Z", "last_modified_time": "2015-05-29T00:00:00.000Z", "reference_id": 4815000000000342, "notes": "Sample Note", "terms": "Term & Conditions", "attachment_name": "sample-attachments", "open_purchaseorders_count": 4, "gst_treatment": "business_gst", "gst_no": "22AAAAA0000A1Z5", "source_of_supply": "AP", "destination_of_supply": "TN", "is_pre_gst": false, "is_reverse_charge_applied": true } }

List all Bills.

Lists all the Bills in Zoho Inventory.
OAuth Scope : ZohoInventory.bills.READ

Query Parameters

organization_id
string
(Required)
ID of the organization
page
integer
Page number to be fetched. Default value is 1.
per_page
integer
Number of records to be fetched per page. Default value is 200.

Request Example

Click to copy
headers_data = Map(); headers_data.put("Authorization", "Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f"); response = invokeUrl [ url: "https://www.zohoapis.com/inventory/v1/bills?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/inventory/v1/bills?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/inventory/v1/bills?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", "/inventory/v1/bills?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": "/inventory/v1/bills?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/inventory/v1/bills?organization_id=10234695' \ --header 'Authorization: Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f'

Response Example

{ "code": 0, "message": "success", "bills": [ { "bill_id": 4815000000045067, "purchaseorder_id": 4815000000044972, "vendor_id": 4815000000044080, "vendor_name": "Molly", "unused_credits_payable_amount": 0, "status": "paid", "bill_number": "BL-00002", "date": "2015-05-29", "due_date": "2015-05-29", "reference_number": "PO-00003", "due_by_days": 69, "currency_id": 4815000000000097, "currency_code": "USD", "currency_symbol": "$", "price_precision": 2, "exchange_rate": 1, "is_item_level_tax_calc": true, "custom_fields": [ { "customfield_id": "46000000012845", "value": "Normal" } ], "line_items": [ { "purchaseorder_item_id": 4815000000045245, "receive_item_id": 4815000000044131, "line_item_id": 4815000000044897, "name": "Laptop-white/15inch/dell", "account_id": 4815000000035003, "account_name": "Inventory Asset", "description": "Sample Description", "bcy_rate": 122, "rate": 6, "quantity": 5, "tax_id": 4815000000044043, "tds_tax_id": "460000000027009", "tax_name": "Purchase tax", "tax_type": "Tax group", "tax_percentage": 12, "item_total": 290, "item_order": 0, "unit": "qty", "image_id": 2077500000000002000, "image_name": "dell.jpg", "image_type": "jpg", "reverse_charge_tax_id": 460000000038056, "reverse_charge_tax_name": "inter", "reverse_charge_tax_percentage": 10, "reverse_charge_tax_amount": 100, "hsn_or_sac": 80540, "tax_exemption_code": "string", "location_id": "460000000038080", "location_name": "string", "tax_exemption_id": "string" } ], "location_id": "460000000038080", "location_name": "string", "taxes": [ { "tax_name": "Purchase tax", "tax_amount": 29 } ], "vendor_credits_applied": 24, "sub_total": 30, "tax_total": 2, "balance": 0, "billing_address": [ { "address": "No:234,90 Church Street", "city": "New York City", "state": "New York", "zip": 10048, "country": "U.S.A", "fax": "324-524242" } ], "payments": [ { "payment_id": 4815000000046039, "bill_id": 4815000000045067, "bill_payment_id": 4815000000046041, "payment_mode": "Cash", "payment_number": 2, "description": "Sample Description", "date": "2015-05-29", "reference_number": "PO-00003", "exchange_rate": 1, "amount": 234, "paid_through_account_id": 4815000000000361, "paid_through_account_name": "Petty Cash", "is_single_bill_payment": true } ], "vendor_credits": [ { "vendor_credit_id": 4815000000046039, "vendor_credit_bill_id": 4815000000768039, "vendor_credit_number": 67258, "date": "2015-05-29", "amount": 234 } ], "created_time": "2015-05-29T00:00:00.000Z", "last_modified_time": "2015-05-29T00:00:00.000Z", "reference_id": 4815000000000342, "notes": "Sample Note", "terms": "Term & Conditions", "attachment_name": "sample-attachments", "open_purchaseorders_count": 4 }, {...}, {...} ] }

Update a Bill

Updates the details of an existing Bill.
OAuth Scope : ZohoInventory.bills.UPDATE

Arguments

purchaseorder_id
long
Unique ID generated by the server for the Purchase Order.
vendor_id
long
(Required)
Unique ID generated by the server for the vendor.
bill_number
string
(Required)
Bill number of Purchase Order.
date
string
(Required)
Date of the Bill.
due_date
string
(Required)
Due date for the Bill.
reference_number
string
Reference number for the Bill.
currency_id
long
Unique ID generated by the server for the currency. This is used as an identifier.
exchange_rate
double
Exchange rate of the currency, with respect to the base currency.
is_item_level_tax_calc
boolean
Checks whether item level tax is calculated or not.
notes
string
Notes for the Bill.
terms
string
Terms and conditions.
is_inclusive_tax
boolean
Indicates whether the item rates are tax inclusive or exclusive
custom_fields
array
Custom fields for a bill.
Show Sub-Attributes arrow
customfield_id
long
Unique identifier of the custom field
value
string
Value of the Custom Field
line_items
array
(Required)
The line items for a Bill.
Show Sub-Attributes arrow
purchaseorder_item_id
long
Unique ID generated for a line item in the Purchase Order.
receive_item_id
long
Unique ID generated by the server for the receive.
line_item_id
long
Unique ID generated by the server for each line item. This is used as an identifier.
name
string
Name of the line item.
account_id
long
Account ID of the item.
account_name
string
Name of the account.
description
string
Description for the line item.
bcy_rate
double
Item rate in the organization's base currency.
rate
double
Item's Puchase Price.
quantity
double
Quantity of the Item.
tax_id
long
Unique ID of the tax applied on the line item.
tds_tax_id
string
🇲🇽 Mexico
only
TDS ID of the tax or tax group applied to the line item
tax_name
string
Name of the tax.
tax_type
string
Type of the tax
tax_percentage
double
Percentage of the tax applied.
item_total
double
The total for the items.
item_order
double
Order of the line item, starting from 0.
unit
string
Unit of the item.
image_id
double
Unique ID generated by the server for the item image. This is used an identifier.
image_name
string
Name of the image of the line item.
image_type
string
The type (file format) of the image.
reverse_charge_tax_id
string
🇮🇳 India
only
Reverse charge tax ID
hsn_or_sac
string
🇮🇳 India
only
Add HSN/SAC code for your goods/services
tax_exemption_code
string
🇮🇳 India
, 🇦🇺 Australia
, 🇨🇦 Canada
, 🇲🇽 Mexico
only
Code of the Tax Exemption Applied
location_id
string
Location ID
tax_exemption_id
string
🇮🇳 India
, 🇦🇺 Australia
, 🇨🇦 Canada
only
ID of the Tax Exemption Applied
location_id
string
Location ID
gst_treatment
string
🇮🇳 India
only
Choose whether the contact is GST registered/unregistered/consumer/overseas. Allowed values are business_gst , business_none , overseas , consumer .
tax_treatment
string
🇲🇽 Mexico
only
VAT treatment for the bill. Choose whether the vendor falls under: home_country_mexico,border_region_mexico,non_mexico supported only for MX.
gst_no
string
🇮🇳 India
only
15 digit GST identification number of the vendor.
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)
destination_of_supply
string
🇮🇳 India
only
Place where the goods/services are supplied to. (If not given, organisation's home state will be taken)
is_pre_gst
boolean
🇮🇳 India
only
Applicable for transactions that fall before july 1, 2017
is_reverse_charge_applied
boolean
🇮🇳 India
only
Applicable for transactions where you pay reverse charge

Path Parameters

bill_id
string
(Required)
Unique identifier of the 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.com/inventory/v1/bills/4815000000045067?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.com/inventory/v1/bills/4815000000045067?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.com/inventory/v1/bills/4815000000045067?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") payload = "{\"field1\":\"value1\",\"field2\":\"value2\"}" headers = { 'Authorization': "Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f", 'content-type': "application/json" } conn.request("PUT", "/inventory/v1/bills/4815000000045067?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.com", "port": null, "path": "/inventory/v1/bills/4815000000045067?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.com/inventory/v1/bills/4815000000045067?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
{ "purchaseorder_id": 4815000000044972, "vendor_id": 4815000000044080, "bill_number": "BL-00002", "date": "2015-05-29", "due_date": "2015-05-29", "reference_number": "PO-00003", "currency_id": 4815000000000097, "exchange_rate": 1, "is_item_level_tax_calc": true, "notes": "Sample Note", "terms": "Term & Conditions", "is_inclusive_tax": false, "custom_fields": [ { "customfield_id": "46000000012845", "value": "Normal" } ], "line_items": [ { "purchaseorder_item_id": 4815000000045245, "receive_item_id": 4815000000044131, "line_item_id": 4815000000044897, "name": "Laptop-white/15inch/dell", "account_id": 4815000000035003, "account_name": "Inventory Asset", "description": "Sample Description", "bcy_rate": 122, "rate": 6, "quantity": 5, "tax_id": 4815000000044043, "tds_tax_id": "460000000027009", "tax_name": "Purchase tax", "tax_type": "Tax group", "tax_percentage": 12, "item_total": 290, "item_order": 0, "unit": "qty", "image_id": 2077500000000002000, "image_name": "dell.jpg", "image_type": "jpg", "reverse_charge_tax_id": 460000000038056, "hsn_or_sac": 80540, "tax_exemption_code": "string", "location_id": "460000000038080", "tax_exemption_id": "string" } ], "location_id": "460000000038080", "gst_treatment": "business_gst", "tax_treatment": "vat_registered", "gst_no": "22AAAAA0000A1Z5", "source_of_supply": "AP", "destination_of_supply": "TN", "is_pre_gst": false, "is_reverse_charge_applied": true }

Response Example

{ "code": 0, "message": "The Bill has been updated.", "bill": { "bill_id": 4815000000045067, "purchaseorder_id": 4815000000044972, "vendor_id": 4815000000044080, "vendor_name": "Molly", "unused_credits_payable_amount": 0, "status": "paid", "bill_number": "BL-00002", "date": "2015-05-29", "due_date": "2015-05-29", "reference_number": "PO-00003", "due_by_days": 69, "currency_id": 4815000000000097, "currency_code": "USD", "currency_symbol": "$", "price_precision": 2, "exchange_rate": 1, "is_item_level_tax_calc": true, "custom_fields": [ { "customfield_id": "46000000012845", "value": "Normal" } ], "line_items": [ { "purchaseorder_item_id": 4815000000045245, "receive_item_id": 4815000000044131, "line_item_id": 4815000000044897, "name": "Laptop-white/15inch/dell", "account_id": 4815000000035003, "account_name": "Inventory Asset", "description": "Sample Description", "bcy_rate": 122, "rate": 6, "quantity": 5, "tax_id": 4815000000044043, "tds_tax_id": "460000000027009", "tax_name": "Purchase tax", "tax_type": "Tax group", "tax_percentage": 12, "item_total": 290, "item_order": 0, "unit": "qty", "image_id": 2077500000000002000, "image_name": "dell.jpg", "image_type": "jpg", "reverse_charge_tax_id": 460000000038056, "reverse_charge_tax_name": "inter", "reverse_charge_tax_percentage": 10, "reverse_charge_tax_amount": 100, "hsn_or_sac": 80540, "tax_exemption_code": "string", "location_id": "460000000038080", "location_name": "string", "tax_exemption_id": "string" } ], "location_id": "460000000038080", "location_name": "string", "taxes": [ { "tax_name": "Purchase tax", "tax_amount": 29 } ], "vendor_credits_applied": 24, "sub_total": 30, "tax_total": 2, "balance": 0, "billing_address": [ { "address": "No:234,90 Church Street", "city": "New York City", "state": "New York", "zip": 10048, "country": "U.S.A", "fax": "324-524242" } ], "payments": [ { "payment_id": 4815000000046039, "bill_id": 4815000000045067, "bill_payment_id": 4815000000046041, "payment_mode": "Cash", "payment_number": 2, "description": "Sample Description", "date": "2015-05-29", "reference_number": "PO-00003", "exchange_rate": 1, "amount": 234, "paid_through_account_id": 4815000000000361, "paid_through_account_name": "Petty Cash", "is_single_bill_payment": true } ], "vendor_credits": [ { "vendor_credit_id": 4815000000046039, "vendor_credit_bill_id": 4815000000768039, "vendor_credit_number": 67258, "date": "2015-05-29", "amount": 234 } ], "created_time": "2015-05-29T00:00:00.000Z", "last_modified_time": "2015-05-29T00:00:00.000Z", "reference_id": 4815000000000342, "notes": "Sample Note", "terms": "Term & Conditions", "attachment_name": "sample-attachments", "open_purchaseorders_count": 4, "gst_treatment": "business_gst", "gst_no": "22AAAAA0000A1Z5", "source_of_supply": "AP", "destination_of_supply": "TN", "is_pre_gst": false, "is_reverse_charge_applied": true } }

Retrieve a Bill

Fetches the details of a Bill.
OAuth Scope : ZohoInventory.bills.READ

Path Parameters

bill_id
string
(Required)
Unique identifier of the 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.com/inventory/v1/bills/4815000000045067?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/inventory/v1/bills/4815000000045067?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/inventory/v1/bills/4815000000045067?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", "/inventory/v1/bills/4815000000045067?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": "/inventory/v1/bills/4815000000045067?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/inventory/v1/bills/4815000000045067?organization_id=10234695' \ --header 'Authorization: Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f'

Response Example

{ "code": 0, "message": "success", "bill": { "bill_id": 4815000000045067, "purchaseorder_id": 4815000000044972, "vendor_id": 4815000000044080, "vendor_name": "Molly", "unused_credits_payable_amount": 0, "status": "paid", "bill_number": "BL-00002", "date": "2015-05-29", "due_date": "2015-05-29", "reference_number": "PO-00003", "due_by_days": 69, "currency_id": 4815000000000097, "currency_code": "USD", "currency_symbol": "$", "price_precision": 2, "exchange_rate": 1, "is_item_level_tax_calc": true, "line_items": [ { "purchaseorder_item_id": 4815000000045245, "receive_item_id": 4815000000044131, "line_item_id": 4815000000044897, "name": "Laptop-white/15inch/dell", "account_id": 4815000000035003, "account_name": "Inventory Asset", "description": "Sample Description", "bcy_rate": 122, "rate": 6, "quantity": 5, "tax_id": 4815000000044043, "tds_tax_id": "460000000027009", "tax_name": "Purchase tax", "tax_type": "Tax group", "tax_percentage": 12, "item_total": 290, "item_order": 0, "unit": "qty", "image_id": 2077500000000002000, "image_name": "dell.jpg", "image_type": "jpg", "reverse_charge_tax_id": 460000000038056, "reverse_charge_tax_name": "inter", "reverse_charge_tax_percentage": 10, "reverse_charge_tax_amount": 100, "hsn_or_sac": 80540, "tax_exemption_code": "string", "location_id": "460000000038080", "location_name": "string", "tax_exemption_id": "string" } ], "location_id": "460000000038080", "location_name": "string", "taxes": [ { "tax_name": "Purchase tax", "tax_amount": 29 } ], "vendor_credits_applied": 24, "sub_total": 30, "tax_total": 2, "balance": 0, "billing_address": [ { "address": "No:234,90 Church Street", "city": "New York City", "state": "New York", "zip": 10048, "country": "U.S.A", "fax": "324-524242" } ], "payments": [ { "payment_id": 4815000000046039, "bill_id": 4815000000045067, "bill_payment_id": 4815000000046041, "payment_mode": "Cash", "payment_number": 2, "description": "Sample Description", "date": "2015-05-29", "reference_number": "PO-00003", "exchange_rate": 1, "amount": 234, "paid_through_account_id": 4815000000000361, "paid_through_account_name": "Petty Cash", "is_single_bill_payment": true } ], "vendor_credits": [ { "vendor_credit_id": 4815000000046039, "vendor_credit_bill_id": 4815000000768039, "vendor_credit_number": 67258, "date": "2015-05-29", "amount": 234 } ], "created_time": "2015-05-29T00:00:00.000Z", "last_modified_time": "2015-05-29T00:00:00.000Z", "reference_id": 4815000000000342, "notes": "Sample Note", "terms": "Term & Conditions", "attachment_name": "sample-attachments", "open_purchaseorders_count": 4, "gst_treatment": "business_gst", "gst_no": "22AAAAA0000A1Z5", "source_of_supply": "AP", "destination_of_supply": "TN", "is_pre_gst": false, "is_reverse_charge_applied": true } }

Delete a Bill.

Deletes a Bill from Zoho Inventory.
OAuth Scope : ZohoInventory.bills.DELETE

Path Parameters

bill_id
string
(Required)
Unique identifier of the 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.com/inventory/v1/bills/4815000000045067?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/inventory/v1/bills/4815000000045067?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/inventory/v1/bills/4815000000045067?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", "/inventory/v1/bills/4815000000045067?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": "/inventory/v1/bills/4815000000045067?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/inventory/v1/bills/4815000000045067?organization_id=10234695' \ --header 'Authorization: Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f'

Response Example

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

Update custom field in existing bills

Update the value of the custom field in existing bills.
OAuth Scope : ZohoInventory.bills.UPDATE

Arguments

customfield_id
long
Unique identifier of the custom field
value
string
Value of the Custom Field

Path Parameters

bill_id
string
(Required)
Unique identifier of the 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.com/inventory/v1/bill/460000000098765/customfields?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.com/inventory/v1/bill/460000000098765/customfields?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.com/inventory/v1/bill/460000000098765/customfields?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") payload = "{\"field1\":\"value1\",\"field2\":\"value2\"}" headers = { 'Authorization': "Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f", 'content-type': "application/json" } conn.request("PUT", "/inventory/v1/bill/460000000098765/customfields?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.com", "port": null, "path": "/inventory/v1/bill/460000000098765/customfields?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.com/inventory/v1/bill/460000000098765/customfields?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
[ { "customfield_id": "46000000012845", "value": "Normal" } ]

Response Example

{ "code": 0, "message": "Custom Fields Updated Successfully" }

Mark as Open

Marks a Bill as Open.
OAuth Scope : ZohoInventory.bills.CREATE

Path Parameters

bill_id
string
(Required)
Unique identifier of the 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.com/inventory/v1/bills/4815000000045067/status/open?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/inventory/v1/bills/4815000000045067/status/open?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/inventory/v1/bills/4815000000045067/status/open?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", "/inventory/v1/bills/4815000000045067/status/open?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": "/inventory/v1/bills/4815000000045067/status/open?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/inventory/v1/bills/4815000000045067/status/open?organization_id=10234695' \ --header 'Authorization: Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f'

Response Example

{ "code": 0, "message": "The bill has been marked as open." }

Mark as Void

Marks a Bill as Void.
OAuth Scope : ZohoInventory.bills.CREATE

Path Parameters

bill_id
string
(Required)
Unique identifier of the 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.com/inventory/v1/bills/4815000000045067/status/void?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/inventory/v1/bills/4815000000045067/status/void?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/inventory/v1/bills/4815000000045067/status/void?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", "/inventory/v1/bills/4815000000045067/status/void?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": "/inventory/v1/bills/4815000000045067/status/void?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/inventory/v1/bills/4815000000045067/status/void?organization_id=10234695' \ --header 'Authorization: Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f'

Response Example

{ "code": 0, "message": "The bill has been marked as Void." }