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.
Possible error codes:
Error Code | Message |
---|---|
1001 | Invoice Number already exist |
1002 | Contact Person does not exist |
3009 | The contact details of this invoice cannot be edited as the credits have been applied to it |
3010 | The customer for this invoice cannot be changed because payments have been recorded for this invoice |
4001 | Payments have been recorded for these invoices.Hence they cannot be deleted |
12008 | This invoice has credits applied to it. Hence, it cannot be deleted |
Attribute
Maximum length [100]
place of contact
given for the contact will be taken) business_gst
, business_none
, overseas
, consumer
.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
.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
, if he resides outside of the UK then his VAT treatment is overseas
(For Pre Brexit, this can be split as eu_vat_registered
, eu_vat_not_registered
and non_eu
).Date format yyyy-mm-dd
sent
, draft
, overdue
, paid
, void
, unpaid
, partially_paid
and viewed
Maximum length [100]
Maximum length [100]
Date format yyyy-mm-dd
Maximum length [100]
Maximum length [100]
entity_level
and item_level
.Maximum length [100]
Maximum length [2000]
Maximum length [100]
Maximum length [100]
Maximum length [100]
standard
and adaptive
paypal
, authorize_net
, payflow_pro
, stripe
, 2checkout
and braintree
Maximum length [200]
Create an invoice
Create an invoice for your customer.
OAuth Scope : ZohoInvoice.invoices.CREATE
Arguments
Maximum length [100]
place of contact
given for the contact will be taken)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
, if he resides outside of the UK then his VAT treatment is overseas
(For Pre Brexit, this can be split as eu_vat_registered
, eu_vat_not_registered
and non_eu
). business_gst
, business_none
, overseas
, consumer
.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
.Date format yyyy-mm-dd
Maximum length [100]
Maximum length [100]
Date format yyyy-mm-dd
Maximum length [100]
entity_level
and item_level
.Maximum length [200]
Maximum length [100]
Maximum length [2000]
Maximum length [100]
Maximum length [100]
Maximum length [25]
Maximum length [25]
standard
and adaptive
paypal
, authorize_net
, payflow_pro
, stripe
, 2checkout
and braintree
Maximum length [100]
Maximum length [25]
Maximum length [25]
Maximum length [25]
Query Parameters
true
and false
.true
and false
List invoices
List all invoices with pagination.
OAuth Scope : ZohoInvoice.invoices.READ
Query Parameters
Maximum length [100]
item_name_startswith
and item_name_contains
. Maximum length [100]
item_description_startswith
and item_description_contains
. Maximum length [100]
Maximum length [100]
Maximum length [100]
custom_field_startswith
and custom_field_contains
Date format yyyy-mm-dd
. Variants: due_date_start, due_date_end, due_date_before and due_date_after
.Date format yyyy-mm-dd
. 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
Maximum length [100]
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 : ZohoInvoice.invoices.UPDATE
Arguments
Maximum length [100]
place of contact
given for the contact will be taken)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
, if he resides outside of the UK then his VAT treatment is overseas
(For Pre Brexit, this can be split as eu_vat_registered
, eu_vat_not_registered
and non_eu
). business_gst
, business_none
, overseas
, consumer
.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
.Date format yyyy-mm-dd
Maximum length [100]
Maximum length [100]
Date format yyyy-mm-dd
Maximum length [100]
entity_level
and item_level
.Maximum length [200]
Maximum length [100]
Maximum length [2000]
Maximum length [100]
Maximum length [100]
Maximum length [25]
Maximum length [25]
standard
and adaptive
paypal
, authorize_net
, payflow_pro
, stripe
, 2checkout
and braintree
Maximum length [100]
Maximum length [25]
Maximum length [25]
Maximum length [25]
Query Parameters
true
and false
Get an invoice
Get the details of an invoice.
OAuth Scope : ZohoInvoice.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 : ZohoInvoice.invoices.DELETE
Update custom field in existing invoices
Update the value of the custom field in existing invoices.
OAuth Scope : ZohoInvoice.invoices.UPDATE
Arguments
Mark an invoice as sent
Mark a draft invoice as sent.
OAuth Scope : ZohoInvoice.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 : ZohoInvoice.invoices.CREATE
Mark as draft
Mark a voided invoice as draft.
OAuth Scope : ZohoInvoice.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 : ZohoInvoice.invoices.CREATE
Arguments
Query Parameters
Get invoice email content
Get the email content of an invoice.
OAuth Scope : ZohoInvoice.invoices.READ
Query Parameters
Email invoices
Send invoices to your customers by email. Maximum of 10 invoices can be sent at once.
OAuth Scope : ZohoInvoice.invoices.CREATE
Arguments
Query Parameters
Remind Customer
Remind your customer about an unpaid invoice by email. Reminder will be sent, only for the invoices which are in open or overdue status.
OAuth Scope : ZohoInvoice.invoices.CREATE
Arguments
Query Parameters
Get payment reminder mail content
Get the mail content of the payment reminder.
OAuth Scope : ZohoInvoice.invoices.READ
Bulk invoice reminder
Remind your customer about an unpaid invoices by email. Reminder mail will be send, only for the invoices is in open or overdue status. Maximum 10 invoices can be reminded at once.
OAuth Scope : ZohoInvoice.invoices.CREATE
Query Parameters
Bulk export Invoices
Maximum of 25 invoices can be exported in a single pdf.
OAuth Scope : ZohoInvoice.invoices.READ
Query Parameters
Bulk print invoices
Export invoices as pdf and print them. Maximum of 25 invoices can be printed.
OAuth Scope : ZohoInvoice.invoices.READ
Query Parameters
Disable payment reminder
Disable automated payment reminders for an invoice.
OAuth Scope : ZohoInvoice.invoices.CREATE
Enable payment reminder
Enable automated payment reminders for an invoice.
OAuth Scope : ZohoInvoice.invoices.CREATE
Write off invoice
Write off the invoice balance amount of an invoice.
OAuth Scope : ZohoInvoice.invoices.CREATE
Cancel write off
Cancel the write off amount of an invoice.
OAuth Scope : ZohoInvoice.invoices.CREATE
Update billing address
Updates the billing address for this invoice alone.
OAuth Scope : ZohoInvoice.invoices.UPDATE
Arguments
Update shipping address
Updates the shipping address for this invoice alone.
OAuth Scope : ZohoInvoice.invoices.UPDATE
Arguments
List invoice templates
Get all invoice pdf templates.
OAuth Scope : ZohoInvoice.invoices.READ
Update invoice template
Update the pdf template associated with the invoice.
OAuth Scope : ZohoInvoice.invoices.UPDATE
List invoice payments
Get the list of payments made for an invoice.
OAuth Scope : ZohoInvoice.invoices.READ
List credits applied
Get the list of credits applied for an invoice.
OAuth Scope : ZohoInvoice.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 : ZohoInvoice.invoices.CREATE
Arguments
Delete a payment
Delete a payment made to an invoice.
OAuth Scope : ZohoInvoice.invoices.DELETE
Delete applied credit
Delete a particular credit applied to an invoice.
OAuth Scope : ZohoInvoice.invoices.DELETE
Add attachment to an invoice
Attach a file to an invoice.
OAuth Scope : ZohoInvoice.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 : ZohoInvoice.invoices.UPDATE
Query Parameters
Get an invoice attachment
Returns the file attached to the invoice.
OAuth Scope : ZohoInvoice.invoices.READ
Query Parameters
Delete an attachment
Delete the file attached to the invoice.
OAuth Scope : ZohoInvoice.invoices.DELETE
Delete the expense receipt
Delete the expense receipts attached to an invoice which is raised from an expense.
OAuth Scope : ZohoInvoice.invoices.DELETE
Add comment
Add a comment for an invoice.
OAuth Scope : ZohoInvoice.invoices.CREATE
Query Parameters
List invoice comments & history
Get the complete history and comments of an invoice.
OAuth Scope : ZohoInvoice.invoices.READ
Update comment
Update an existing comment of an invoice.
OAuth Scope : ZohoInvoice.invoices.UPDATE
Query Parameters
Delete a comment
Delete an invoice comment.
OAuth Scope : ZohoInvoice.invoices.DELETE