Invoices
An invoice is a statement of items sold by a seller. It includes all the details of sale including units of goods, price of goods sold, shipping details, etc.
Attribute
sent
, draft
, overdue
, paid
, void
, unpaid
, partially_paid
and viewed
entity_level
,item_level
. For entity_level type, discount is applied at entity level and the node discount
resides outside the line_items
node.For item_level type, discount is applied at item level and the node discount
resides inside each line_item under the line_items
node.standard
and adaptive
paypal
, authorize_net
, payflow_pro
, stripe
, 2checkout
and braintree
business_gst
, business_none
, overseas
, consumer
.place of contact
given for the contact will be taken)home_country_mexico
,border_region_mexico
,non_mexico
supported only for MX.acquisition_of_merchandise
, return_discount_bonus
, general_expense
, buildings
, furniture_office_equipment
, transport_equipment
, computer_equipmentdye_molds_tools
, telephone_communication
, satellite_communication
, other_machinery_equipment
, hospital_expense
, medical_expense_disability
, funeral_expense
, donation
, interest_mortage_loans
, contribution_sar
, medical_expense_insurance_pormium
, school_transportation_expense
, deposit_saving_account
, payment_educational_service
, no_tax_effect
, payment
, payroll
.return_of_merchandise
, substitution_previous_cfdi
, transfer_of_goods
, invoice_generated_from_order
, cfdi_for_advance
.Create an invoice
Create an invoice for your customer.
OAuth Scope : ZohoInventory.invoices.CREATE
Arguments
entity_level
,item_level
. For entity_level type, discount is applied at entity level and the node discount
resides outside the line_items
node.For item_level type, discount is applied at item level and the node discount
resides inside each line_item under the line_items
node.standard
and adaptive
paypal
, authorize_net
, payflow_pro
, stripe
, 2checkout
and braintree
uk
. If the customer is in an EU country & VAT registered, you are resides in Northen Ireland and selling Goods then his VAT treatment is eu_vat_registered
and if he resides outside the EU then his VAT treatment is overseas
(For Pre Brexit, this can be split as eu_vat_registered
, eu_vat_not_registered
and non_eu
).home_country_mexico
,border_region_mexico
,non_mexico
supported only for MX. business_gst
, business_none
, overseas
, consumer
.place of contact
given for the contact will be taken)acquisition_of_merchandise
, return_discount_bonus
, general_expense
, buildings
, furniture_office_equipment
, transport_equipment
, computer_equipmentdye_molds_tools
, telephone_communication
, satellite_communication
, other_machinery_equipment
, hospital_expense
, medical_expense_disability
, funeral_expense
, donation
, interest_mortage_loans
, contribution_sar
, medical_expense_insurance_pormium
, school_transportation_expense
, deposit_saving_account
, payment_educational_service
, no_tax_effect
, payment
, payroll
.Query Parameters
true
and false
.true
and false
List invoices
List all invoices with pagination.
OAuth Scope : ZohoInventory.invoices.READ
Query Parameters
item_name_startswith
and item_name_contains
. Maximum length [100]item_description_startswith
and item_description_contains
. Maximum length [100]custom_field_startswith
and custom_field_contains
Variants: due_date_start, due_date_end, due_date_before and due_date_after
. Variants: due_date_start, due_date_end, due_date_before and due_date_after
sent
, draft
, overdue
, paid
, void
, unpaid
, partially_paid
and viewed
Status.All
, Status.Sent
, Status.Draft
, Status.OverDue
, Status.Paid
, Status.Void
, Status.Unpaid
, Status.PartiallyPaid
, Status.Viewed
and Date.PaymentExpectedDate
customer_name
, invoice_number
, date
, due_date
, total
, balance
and created_time
Update an invoice
Update an existing invoice. To delete a line item just remove it from the line_items list.
OAuth Scope : ZohoInventory.invoices.UPDATE
Arguments
entity_level
,item_level
. For entity_level type, discount is applied at entity level and the node discount
resides outside the line_items
node.For item_level type, discount is applied at item level and the node discount
resides inside each line_item under the line_items
node.standard
and adaptive
paypal
, authorize_net
, payflow_pro
, stripe
, 2checkout
and braintree
uk
. If the customer is in an EU country & VAT registered, you are resides in Northen Ireland and selling Goods then his VAT treatment is eu_vat_registered
and if he resides outside the EU then his VAT treatment is overseas
(For Pre Brexit, this can be split as eu_vat_registered
, eu_vat_not_registered
and non_eu
).home_country_mexico
,border_region_mexico
,non_mexico
supported only for MX. business_gst
, business_none
, overseas
, consumer
.place of contact
given for the contact will be taken)acquisition_of_merchandise
, return_discount_bonus
, general_expense
, buildings
, furniture_office_equipment
, transport_equipment
, computer_equipmentdye_molds_tools
, telephone_communication
, satellite_communication
, other_machinery_equipment
, hospital_expense
, medical_expense_disability
, funeral_expense
, donation
, interest_mortage_loans
, contribution_sar
, medical_expense_insurance_pormium
, school_transportation_expense
, deposit_saving_account
, payment_educational_service
, no_tax_effect
, payment
, payroll
.return_of_merchandise
, substitution_previous_cfdi
, transfer_of_goods
, invoice_generated_from_order
, cfdi_for_advance
.Query Parameters
true
and false
Get an invoice
Get the details of an invoice.
OAuth Scope : ZohoInventory.invoices.READ
Query Parameters
json
pdf
and html
Delete an invoice
Delete an existing invoice. Invoices which have payment or credits note applied cannot be deleted.
OAuth Scope : ZohoInventory.invoices.DELETE
Update custom field in existing invoices
Update the value of the custom field in existing invoices.
OAuth Scope : ZohoInventory.invoices.UPDATE
Arguments
Query Parameters
Mark an invoice as sent
Mark a draft invoice as sent.
OAuth Scope : ZohoInventory.invoices.CREATE
Void an invoice
Mark an invoice status as void. Upon voiding, the payments and credits associated with the invoices will be unassociated and will be under customer credits.
OAuth Scope : ZohoInventory.invoices.CREATE
Mark as draft
Mark a voided invoice as draft.
OAuth Scope : ZohoInventory.invoices.CREATE
Email an invoice
Email an invoice to the customer. Input json string is not mandatory. If input json string is empty, mail will be send with default mail content.
OAuth Scope : ZohoInventory.invoices.CREATE
Arguments
Query Parameters
Get invoice email content
Get the email content of an invoice.
OAuth Scope : ZohoInventory.invoices.READ
Query Parameters
Email invoices
Send invoices to your customers by email. Maximum of 10 invoices can be sent at once.
OAuth Scope : ZohoInventory.invoices.CREATE
Query Parameters
Get payment reminder mail content
Get the mail content of the payment reminder.
OAuth Scope : ZohoInventory.invoices.READ
Bulk export Invoices
Maximum of 25 invoices can be exported in a single pdf.
OAuth Scope : ZohoInventory.invoices.READ
Query Parameters
Bulk print invoices
Export invoices as pdf and print them. Maximum of 25 invoices can be printed.
OAuth Scope : ZohoInventory.invoices.READ
Query Parameters
Disable payment reminder
Disable automated payment reminders for an invoice.
OAuth Scope : ZohoInventory.invoices.CREATE
Enable payment reminder
Enable automated payment reminders for an invoice.
OAuth Scope : ZohoInventory.invoices.CREATE
Write off invoice
Write off the invoice balance amount of an invoice.
OAuth Scope : ZohoInventory.invoices.CREATE
Cancel write off
Cancel the write off amount of an invoice.
OAuth Scope : ZohoInventory.invoices.CREATE
Update billing address
Updates the billing address for this invoice alone.
OAuth Scope : ZohoInventory.invoices.UPDATE
Arguments
Update shipping address
Updates the shipping address for this invoice alone.
OAuth Scope : ZohoInventory.invoices.UPDATE
Arguments
List invoice templates
Get all invoice pdf templates.
OAuth Scope : ZohoInventory.invoices.READ
Update invoice template
Update the pdf template associated with the invoice.
OAuth Scope : ZohoInventory.invoices.UPDATE
List invoice payments
Get the list of payments made for an invoice.
OAuth Scope : ZohoInventory.invoices.READ
List credits applied
Get the list of credits applied for an invoice.
OAuth Scope : ZohoInventory.invoices.READ
Apply credits
Apply the customer credits either from credit notes or excess customer payments to an invoice. Multiple credits can be applied at once.
OAuth Scope : ZohoInventory.invoices.CREATE
Arguments
Delete a payment
Delete a payment made to an invoice.
OAuth Scope : ZohoInventory.invoices.DELETE
Delete applied credit
Delete a particular credit applied to an invoice.
OAuth Scope : ZohoInventory.invoices.DELETE
Add attachment to an invoice
Attach a file to an invoice.
OAuth Scope : ZohoInventory.invoices.CREATE
Query Parameters
gif
, png
, jpeg
, jpg
, bmp
and pdf
Update attachment preference
Set whether you want to send the attached file while emailing the invoice.
OAuth Scope : ZohoInventory.invoices.UPDATE
Query Parameters
Get an invoice attachment
Returns the file attached to the invoice.
OAuth Scope : ZohoInventory.invoices.READ
Query Parameters
Delete an attachment
Delete the file attached to the invoice.
OAuth Scope : ZohoInventory.invoices.DELETE
Add comment
Add a comment for an invoice.
OAuth Scope : ZohoInventory.invoices.CREATE
Query Parameters
List invoice comments & history
Get the complete history and comments of an invoice.
OAuth Scope : ZohoInventory.invoices.READ
Update comment
Update an existing comment of an invoice.
OAuth Scope : ZohoInventory.invoices.UPDATE
Query Parameters
Delete a comment
Delete an invoice comment.
OAuth Scope : ZohoInventory.invoices.DELETE