API Docs
/
No Results Found
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.

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.
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
mx 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
, mx only
Code of the Tax Exemption Applied
warehouse_id
long
Unique ID generated by the server for the ware houses
tax_exemption_id
string
๐Ÿ‡ฎ๐Ÿ‡ณ India
, ๐Ÿ‡ฆ๐Ÿ‡บ Australia
, ๐Ÿ‡จ๐Ÿ‡ฆ Canada
only
ID of the Tax Exemption Applied
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, "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", "warehouse_id": 130426000000664020, "tax_exemption_id": "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.
oauthscope : 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
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
mx 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
, mx only
Code of the Tax Exemption Applied
warehouse_id
long
Unique ID generated by the server for the ware houses
tax_exemption_id
string
๐Ÿ‡ฎ๐Ÿ‡ณ India
, ๐Ÿ‡ฆ๐Ÿ‡บ Australia
, ๐Ÿ‡จ๐Ÿ‡ฆ Canada
only
ID of the Tax Exemption Applied
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
mx 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)

Request Example

Click to copy
parameters_data='{"field1":"value1","field2":"value2"}'; headers_data = Map(); headers_data.put("Authorization", "Zoho-oauthtoken 1000.41d9f2cfbd1b7a8f9e314b7aff7bc2d1.8fcc9810810a216793f385b9dd6e125f"); 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.41d9f2cfbd1b7a8f9e314b7aff7bc2d1.8fcc9810810a216793f385b9dd6e125f") .addHeader("content-type", "application/json") .build(); Response response = client.newCall(request).execute();
const options = { method: 'POST', headers: { Authorization: 'Zoho-oauthtoken 1000.41d9f2cfbd1b7a8f9e314b7aff7bc2d1.8fcc9810810a216793f385b9dd6e125f', '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.41d9f2cfbd1b7a8f9e314b7aff7bc2d1.8fcc9810810a216793f385b9dd6e125f", '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.41d9f2cfbd1b7a8f9e314b7aff7bc2d1.8fcc9810810a216793f385b9dd6e125f", "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.41d9f2cfbd1b7a8f9e314b7aff7bc2d1.8fcc9810810a216793f385b9dd6e125f' \ --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, "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", "warehouse_id": 130426000000664020, "tax_exemption_id": "string" } ], "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, "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", "warehouse_id": 130426000000664020, "tax_exemption_id": "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.
oauthscope : ZohoInventory.bills.READ

Request Example

Click to copy
headers_data = Map(); headers_data.put("Authorization", "Zoho-oauthtoken 1000.41d9f2cfbd1b7a8f9e314b7aff7bc2d1.8fcc9810810a216793f385b9dd6e125f"); response = invokeUrl [ url: "https://www.zohoapis.com/inventory/v1/bills?organization_id=10234695" type: GET headers: headers_data content-type: application/octet-stream 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.41d9f2cfbd1b7a8f9e314b7aff7bc2d1.8fcc9810810a216793f385b9dd6e125f") .build(); Response response = client.newCall(request).execute();
const options = { method: 'GET', headers: { Authorization: 'Zoho-oauthtoken 1000.41d9f2cfbd1b7a8f9e314b7aff7bc2d1.8fcc9810810a216793f385b9dd6e125f' } }; 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.41d9f2cfbd1b7a8f9e314b7aff7bc2d1.8fcc9810810a216793f385b9dd6e125f" } 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.41d9f2cfbd1b7a8f9e314b7aff7bc2d1.8fcc9810810a216793f385b9dd6e125f" } }; 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.41d9f2cfbd1b7a8f9e314b7aff7bc2d1.8fcc9810810a216793f385b9dd6e125f'

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, "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", "warehouse_id": 130426000000664020, "tax_exemption_id": "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.
oauthscope : 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
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
mx 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
, mx only
Code of the Tax Exemption Applied
warehouse_id
long
Unique ID generated by the server for the ware houses
tax_exemption_id
string
๐Ÿ‡ฎ๐Ÿ‡ณ India
, ๐Ÿ‡ฆ๐Ÿ‡บ Australia
, ๐Ÿ‡จ๐Ÿ‡ฆ Canada
only
ID of the Tax Exemption Applied
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
mx 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

Request Example

Click to copy
parameters_data='{"field1":"value1","field2":"value2"}'; headers_data = Map(); headers_data.put("Authorization", "Zoho-oauthtoken 1000.41d9f2cfbd1b7a8f9e314b7aff7bc2d1.8fcc9810810a216793f385b9dd6e125f"); 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.41d9f2cfbd1b7a8f9e314b7aff7bc2d1.8fcc9810810a216793f385b9dd6e125f") .addHeader("content-type", "application/json") .build(); Response response = client.newCall(request).execute();
const options = { method: 'PUT', headers: { Authorization: 'Zoho-oauthtoken 1000.41d9f2cfbd1b7a8f9e314b7aff7bc2d1.8fcc9810810a216793f385b9dd6e125f', '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.41d9f2cfbd1b7a8f9e314b7aff7bc2d1.8fcc9810810a216793f385b9dd6e125f", '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.41d9f2cfbd1b7a8f9e314b7aff7bc2d1.8fcc9810810a216793f385b9dd6e125f", "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.41d9f2cfbd1b7a8f9e314b7aff7bc2d1.8fcc9810810a216793f385b9dd6e125f' \ --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, "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", "warehouse_id": 130426000000664020, "tax_exemption_id": "string" } ], "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, "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", "warehouse_id": 130426000000664020, "tax_exemption_id": "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.
oauthscope : ZohoInventory.bills.READ

Request Example

Click to copy
headers_data = Map(); headers_data.put("Authorization", "Zoho-oauthtoken 1000.41d9f2cfbd1b7a8f9e314b7aff7bc2d1.8fcc9810810a216793f385b9dd6e125f"); response = invokeUrl [ url: "https://www.zohoapis.com/inventory/v1/bills/4815000000045067?organization_id=10234695" type: GET headers: headers_data content-type: application/octet-stream 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.41d9f2cfbd1b7a8f9e314b7aff7bc2d1.8fcc9810810a216793f385b9dd6e125f") .build(); Response response = client.newCall(request).execute();
const options = { method: 'GET', headers: { Authorization: 'Zoho-oauthtoken 1000.41d9f2cfbd1b7a8f9e314b7aff7bc2d1.8fcc9810810a216793f385b9dd6e125f' } }; 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.41d9f2cfbd1b7a8f9e314b7aff7bc2d1.8fcc9810810a216793f385b9dd6e125f" } 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.41d9f2cfbd1b7a8f9e314b7aff7bc2d1.8fcc9810810a216793f385b9dd6e125f" } }; 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.41d9f2cfbd1b7a8f9e314b7aff7bc2d1.8fcc9810810a216793f385b9dd6e125f'

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", "warehouse_id": 130426000000664020, "tax_exemption_id": "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.
oauthscope : ZohoInventory.bills.DELETE

Request Example

Click to copy
headers_data = Map(); headers_data.put("Authorization", "Zoho-oauthtoken 1000.41d9f2cfbd1b7a8f9e314b7aff7bc2d1.8fcc9810810a216793f385b9dd6e125f"); response = invokeUrl [ url: "https://www.zohoapis.com/inventory/v1/bills/4815000000045067?organization_id=10234695" type: DELETE headers: headers_data content-type: application/octet-stream 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.41d9f2cfbd1b7a8f9e314b7aff7bc2d1.8fcc9810810a216793f385b9dd6e125f") .build(); Response response = client.newCall(request).execute();
const options = { method: 'DELETE', headers: { Authorization: 'Zoho-oauthtoken 1000.41d9f2cfbd1b7a8f9e314b7aff7bc2d1.8fcc9810810a216793f385b9dd6e125f' } }; 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.41d9f2cfbd1b7a8f9e314b7aff7bc2d1.8fcc9810810a216793f385b9dd6e125f" } 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.41d9f2cfbd1b7a8f9e314b7aff7bc2d1.8fcc9810810a216793f385b9dd6e125f" } }; 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.41d9f2cfbd1b7a8f9e314b7aff7bc2d1.8fcc9810810a216793f385b9dd6e125f'

Response Example

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

Mark as Open

Marks a Bill as Open.
oauthscope : ZohoInventory.bills.CREATE

Request Example

Click to copy
headers_data = Map(); headers_data.put("Authorization", "Zoho-oauthtoken 1000.41d9f2cfbd1b7a8f9e314b7aff7bc2d1.8fcc9810810a216793f385b9dd6e125f"); response = invokeUrl [ url: "https://www.zohoapis.com/inventory/v1/bills/4815000000045067/status/open?organization_id=10234695" type: POST headers: headers_data content-type: application/octet-stream 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.41d9f2cfbd1b7a8f9e314b7aff7bc2d1.8fcc9810810a216793f385b9dd6e125f") .build(); Response response = client.newCall(request).execute();
const options = { method: 'POST', headers: { Authorization: 'Zoho-oauthtoken 1000.41d9f2cfbd1b7a8f9e314b7aff7bc2d1.8fcc9810810a216793f385b9dd6e125f' } }; 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.41d9f2cfbd1b7a8f9e314b7aff7bc2d1.8fcc9810810a216793f385b9dd6e125f" } 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.41d9f2cfbd1b7a8f9e314b7aff7bc2d1.8fcc9810810a216793f385b9dd6e125f" } }; 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.41d9f2cfbd1b7a8f9e314b7aff7bc2d1.8fcc9810810a216793f385b9dd6e125f'

Response Example

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

Mark as Void

Marks a Bill as Void.
oauthscope : ZohoInventory.bills.CREATE

Request Example

Click to copy
headers_data = Map(); headers_data.put("Authorization", "Zoho-oauthtoken 1000.41d9f2cfbd1b7a8f9e314b7aff7bc2d1.8fcc9810810a216793f385b9dd6e125f"); response = invokeUrl [ url: "https://www.zohoapis.com/inventory/v1/bills/4815000000045067/status/void?organization_id=10234695" type: POST headers: headers_data content-type: application/octet-stream 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.41d9f2cfbd1b7a8f9e314b7aff7bc2d1.8fcc9810810a216793f385b9dd6e125f") .build(); Response response = client.newCall(request).execute();
const options = { method: 'POST', headers: { Authorization: 'Zoho-oauthtoken 1000.41d9f2cfbd1b7a8f9e314b7aff7bc2d1.8fcc9810810a216793f385b9dd6e125f' } }; 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.41d9f2cfbd1b7a8f9e314b7aff7bc2d1.8fcc9810810a216793f385b9dd6e125f" } 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.41d9f2cfbd1b7a8f9e314b7aff7bc2d1.8fcc9810810a216793f385b9dd6e125f" } }; 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.41d9f2cfbd1b7a8f9e314b7aff7bc2d1.8fcc9810810a216793f385b9dd6e125f'

Response Example

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