How AI is applied across API Evangelist and APIs.io. Read my AI disclosure →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Zoho Inventory Bills API

Bills Module

Zoho Inventory Bills API is one of 37 APIs that Zoho Inventory publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

This API exposes 1 JSON Schema definition.

Tagged areas include Bills. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, and 1 JSON Schema.

This API exposes 14 operations across 11 paths, and defines 114 schemas. It is described by OpenAPI 3.2.0, at version 1.0.0.

Requests are made against a single base URL, https://www.zohoapis.com/inventory/v1.

14 operations 11 paths 114 schemas 1 DELETE2 GET9 POST2 PUT

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.2.0
API Version
1.0.0
Base URL
https://www.zohoapis.com/inventory/v1
Authentication
OAuth 2.0
Resource Areas
1

Authentication & Security 1

Zoho Inventory Bills API declares 1 security scheme for authenticating requests. It supports OAuth 2.0 (Zoho_Auth) using the implicit flow, exposing 4 scopes.

Paths & Operations 14

Across 11 paths, the API surfaces 14 operations — 1 DELETE, 2 GET, 9 POST, 2 PUT. Each is listed below with its method, path, parameters, and response codes.

Bills 14

Bills Module

POST
/bills
Create a Bill
create_bill 1 param body → 201
GET
/bills
List all Bills
list_bills 3 params → 200
GET
/bills/{bill_id}
Retrieve a Bill
get_bill 2 params → 200
PUT
/bills/{bill_id}
Update a Bill
update_bill 2 params body → 200
DELETE
/bills/{bill_id}
Delete a Bill
delete_bill 2 params → 200
PUT
/bill/{bill_id}/customfields
Update custom field in existing bills
update_custom_field_in_bill 2 params body → 200
POST
/bills/{bill_id}/status/open
Mark as Open
mark_bill_as_open 2 params → 200
POST
/bills/{bill_id}/status/void
Mark as Void
mark_bill_as_void 2 params → 200
POST
/bills/{bill_id}/submit
Submit a bill for approval
submit_bill 2 params → 200
POST
/bills/{bill_id}/approve
Approve a bill
approve_bill 2 params → 200
POST
/bills/{bill_id}/approve/final
Final approval of a bill
approve_bill_final 2 params → 200
POST
/bills/{bill_id}/reject
Reject a bill
reject_bill 2 params body → 200
POST
/bills/submit
Bulk submit bills for approval
bulk_submit_bills 2 params → 200
POST
/bills/approve
Bulk approve bills
bulk_approve_bills 2 params → 200

Schemas 114

The contract defines 114 schemas that model the data the API accepts and returns. The most detailed are bill-response (42 properties), update-a-bill-request (22 properties), create-a-bill-request (20 properties), update-a-bill-response (3 properties). Each schema is shown below with its type and property counts.

tax_total
number
The total of the Tax.
amount
number
Amount paid for the payment.
zip
string
Zip code of the customer's billing address.
payment_id
string
Unique ID generated by the server. This is used as identifier.
reverse_charge_tax_amount
number
Enter reverse charge amount
bill-response
object
42 properties
bill_payment_id
string
Bill payment ID
is_pre_gst
boolean
Applicable for transactions that fall before july 1, 2017
reference_number
string
Reference number for the Bill.
tax_percentage
number
Percentage of the tax applied.
created_time
string
Time at which the Bill details were last created.
mark-as-open-response
object
2 properties
address
string
Name of the street of the customer's billing address.
attachment_name
string
Name of the attached file.
due_date
string
Due date for the Bill.
due_by_days
integer
Number of days by which the Bill is due.
line_items
array
The line items for a Bill.
unused_credits_payable_amount
number
Unused credit payable amount.
bill_number
string
Bill number of Purchase Order.
approval-action-response
object
2 properties
receive_item_id
string
Unique ID generated by the server for the receive.
list-all-bills-response
object
3 properties
terms
string
Terms and conditions.
source_of_supply
string
Place from where the goods/services are supplied. (If not given, place of contact given for the contact will be taken)
vendor_id
string
Unique ID generated by the server for the vendor.
payment_mode
string
Mode of payment for the Bill.
bcy_rate
number
Item rate in the organization's base currency.
storages-update
array
Bin/storage locations allocated for the line item. Applicable only for items with bin tracking enabled.
item_total
number
The total for the items.
account_id
string
Account ID of the item.
retrieve-a-bill-response
object
3 properties
update-a-bill-request
object
22 properties 5 required
custom_fields
array
Custom fields for a bill.
state
string
Name of the state of the customer's billing address.
mark-as-void-response
object
2 properties
price_precision
integer
The precision level for the price's decimal point in a Bill.
balance
number
Remaining balance of the Bill.
unit
string
Unit of the item.
account_name
string
Name of the account.
open_purchaseorders_count
integer
Number of Purchase Orders that are associated with this Bill and open.
hsn_or_sac
string
Add HSN/SAC code for your goods/services
item_custom_fields
array
List of custom fields associated with the line item
batches-response
array
Batches tracked for the line item. Returned for items with batch tracking enabled.
currency_symbol
string
The symbol for the selected currency.
fax
string
Fax number of the customer's billing address.
image_type
string
The type (file format) of the image.
rate
number
Item's Puchase Price.
tax_exemption_code
string
Code of the Tax Exemption Applied
tax_treatment
string
VAT treatment for the bill. Choose whether the vendor falls under: homecountrymexico , borderregionmexico , nonmexico supported only for MX .
vendor_credits
array
The available Vendor Credits.
status
string
Status of the Bill.
update-a-bill-response
object
3 properties
delete-a-bill-response
object
2 properties
storages-response
array
Bin/storage locations tracked for the line item. Returned for items with bin tracking enabled.
reject-request
object
1 property
is_reverse_charge_applied
boolean
Applicable for transactions where you pay reverse charge
gst_no
string
15 digit GST identification number of the vendor.
sub_total
number
Sub Total of the Bill.
is_single_bill_payment
boolean
Checks whether the payment is for single bills or multiple bills.
tax_amount
number
Amount of the tax.
date
string
Date of the Bill.
purchaseorder_item_id
string
Unique ID generated for a line item in the Purchase Order.
destination_of_supply
string
Place where the goods/services are supplied to. (If not given, organisation's home state will be taken)
tds_tax_id
string
TDS ID of the tax or tax group applied to the line item
currency_id
string
Unique ID generated by the server for the currency. This is used as an identifier.
exchange_rate
number
Exchange rate of the currency, with respect to the base currency.
last_modified_time
string
Time at which the bill details were last Modified.
item_order
number
Order of the line item, starting from 0.
quantity
number
Quantity of the Item.
vendor_credit_bill_id
string
Unique ID generated by server for vendor credit bills
description
string
Description for the line item.
vendor_credits_applied
number
Vendor credits applied to the Bill.
reverse_charge_tax_id
string
Reverse charge tax ID
payment_number
string
Number of the payment.
label
string
Label of the Custom Field
name
string
Name of the line item.
create-a-bill-response
object
3 properties
customfield_id
string
Unique identifier of the custom field
vendor_credit_id
string
Unique ID generated by server for vendor credits
batches
array
Batches for the line item. Create a new batch using batchnumber or reference an existing batch using batchid . Applicable only for items with batch tracking en…
gst_treatment
string
Choose whether the contact is GST registered/unregistered/consumer/overseas. Allowed values are businessgst , businessnone , overseas , consumer .
notes
string
Notes for the Bill.
payments
array
Payment details for the Bill.
tax_exemption_id
string
ID of the Tax Exemption Applied
create-a-bill-request
object
20 properties 5 required
image_name
string
Name of the image of the line item.
serial_numbers
array
Serial numbers for the line item. Applicable only for items with serial tracking enabled.
purchaseorder_id
string
Unique ID generated by the server for the Purchase Order.
city
string
Name of the city of the customer's billing address.
tax_name
string
Name of the tax.
tax_id
string
Unique ID of the tax applied on the line item.
location_id
string
Location ID
currency_code
string
Currency code.
location_name
string
Name of the location
reverse_charge_tax_name
string
Name of the reverse charge tax
line_item_id
string
Unique ID generated by the server for each line item. This is used as an identifier.
reverse_charge_tax_percentage
number
Enter reverse charge percentage
country
string
Name of the country of the customer's billing address.
reference_id
string
Unique ID generated by the server for the reference.
is_item_level_tax_calc
boolean
Checks whether item level tax is calculated or not.
update-an-bill-customfield-response
object
2 properties
billing_address
array
Customer's billing address. It contains - address , city , state , zip , country and fax .
paid_through_account_name
string
Name of the account.
taxes
array
Number of taxes applied on the Purchase Order. Each tax contains: taxname and taxamount .
paid_through_account_id
string
ID for the account through which the payment is made.
bill_id
string
Unique ID generated by the server. This is used as identifier.
value
string
Value of the Custom Field
tax_type
string
Type of the tax
vendor_credit_number
integer
image_id
number
Unique ID generated by the server for the item image. This is used an identifier.
vendor_name
string
Name of the vendor.
storages
array
Bin/storage locations allocated for the line item. Applicable only for items with bin tracking enabled.
is_inclusive_tax
boolean
Indicates whether the item rates are tax inclusive or exclusive
batches-update
array
Batches for the line item. Create a new batch using batchnumber or reference an existing batch using batchid . Applicable only for items with batch tracking en…

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

zoho-inventory-bills-api-openapi.yml Raw ↑

Other APIs Zoho Inventory publishes across the network.

Zoho Inventory Batches API
Zoho Inventory Compositeitems API
Zoho Inventory Contact Persons API
Zoho Inventory Contacts API
Zoho Inventory Credit Notes API
Zoho Inventory Currency API
Zoho Inventory Customer Payments API
Zoho Inventory Delivery Challans API
Zoho Inventory Inventoryadjustments API
Zoho Inventory Invoices API
Zoho Inventory Items API
Zoho Inventory Landedcosts API
Where this information came from

This is an independent, third-party profile of Zoho Inventory Bills API, published by API Evangelist. We do not operate, host, resell, or support these APIs, and we are not affiliated with or endorsed by the company unless stated above. Everything here is built from publicly available information — the company's own site, developer portal, documentation, public repositories, and the specifications it publishes for public use. Nothing is obtained by breaching a system, defeating an access control, or using credentials.

The Kin Score and Agent Readiness rating are independently calculated assessments of a company's public API artifacts, scored against a published rubric. They are not certifications, endorsements, security assessments, or audits.

Corrections, re-scores, and removal are free — no partnership or purchase required, and you do not need to justify the request. A removed company is recorded as unrated, never scored zero for having asked. Acknowledgement within one business day; removal within two.

info@apievangelist.com · Read the full data-sourcing policy →
On a security or compliance team? Put security in the subject line and you will get a person, not a form — we will tell you exactly which public URLs this profile was built from.