Zoho Invoice
Zoho Invoice is an online invoicing software used to create, send, and manage professional invoices, along with tracking payments and automating billing workflows.
Categories: Accounting
Type: zohoInvoice/v1
Connections
Version: 1
OAuth2 Authorization Code
Properties
| Name | Label | Type | Description | Required |
|---|---|---|---|---|
| region | Region | STRING Optionszoho.eu, zoho.com, zoho.com.au, zoho.jp, zoho.in, zohocloud.ca | true | |
| organization_id | Organization Id | STRING | true | |
| clientId | Client Id | STRING | true | |
| clientSecret | Client Secret | STRING | true |
Connection Setup
Create OAuth 2.0 Application
Creation of OAuth 2.0 application is documented here.
Create organization ID
- Login to your account at https://www.zoho.com/invoice/.
- Fill in the required fields and click Get Started.
- Click on your organization and copy Organization ID.
- In Bytechef, choose your region based on Zoho Invoice domain you are using.
Actions
Create Contact
Name: createContact
Create a new contact.
Properties
| Name | Label | Type | Description | Required |
|---|---|---|---|---|
| contact_name | Contact Name | STRING | Name of the contact. | true |
| company_name | Company Name | STRING | Name of the contact's company. | false |
| website | Website | STRING | Website of the contact. | false |
| currency_id | Currency ID | STRING | Currency ID of the customer's currency. | false |
| billing_address | Billing Address | OBJECT Properties{STRING(attention), STRING(address), STRING(street2), STRING(state_code), STRING(city), STRING(state), STRING(zip), STRING(country), STRING(fax), STRING(phone)} | Billing address of the contact. | false |
| shipping_address | Shipping Address | OBJECT Properties{STRING(attention), STRING(address), STRING(street2), STRING(state_code), STRING(city), STRING(state), STRING(zip), STRING(country), STRING(fax), STRING(phone)} | Customer's shipping address to which the goods must be delivered. | false |
Example JSON Structure
{
"label" : "Create Contact",
"name" : "createContact",
"parameters" : {
"contact_name" : "",
"company_name" : "",
"website" : "",
"currency_id" : "",
"billing_address" : {
"attention" : "",
"address" : "",
"street2" : "",
"state_code" : "",
"city" : "",
"state" : "",
"zip" : "",
"country" : "",
"fax" : "",
"phone" : ""
},
"shipping_address" : {
"attention" : "",
"address" : "",
"street2" : "",
"state_code" : "",
"city" : "",
"state" : "",
"zip" : "",
"country" : "",
"fax" : "",
"phone" : ""
}
},
"type" : "zohoInvoice/v1/createContact"
}Output
Type: OBJECT
Properties
| Name | Type | Description |
|---|---|---|
| code | NUMBER | Zoho Invoice error code. This will be zero for a success response and non-zero in case of an error. |
| message | STRING | Message for the invoked API. |
| contact | OBJECT Properties{} | Created contact. |
Output Example
{
"code" : 0.0,
"message" : "",
"contact" : { }
}Find Currency ID
To find the Currency ID, click here.
Create Invoice
Name: createInvoice
Create an invoice for your customer.
Properties
| Name | Label | Type | Description | Required |
|---|---|---|---|---|
| customer_id | Customer ID | STRING | ID of the customer the invoice has to be created. | true |
| use_custom_invoice_number | Use Custom Invoice Number | BOOLEAN Optionstrue, false | If true, create custom invoice number, if false, use auto invoice number generation. | true |
| invoice_number | Invoice Number | STRING | Number of invoice. | true |
| line_items | Line Items | ARRAY Items[{STRING(item_id), NUMBER(quantity)}] | Items in invoice. | true |
| date | Invoice Date | DATE | The date of the invoice. | false |
| payment_terms | Payment Terms | INTEGER | Payment terms in days e.g. 15, 30, 60. Invoice due date will be calculated based on this. | false |
Example JSON Structure
{
"label" : "Create Invoice",
"name" : "createInvoice",
"parameters" : {
"customer_id" : "",
"use_custom_invoice_number" : false,
"invoice_number" : "",
"line_items" : [ {
"item_id" : "",
"quantity" : 0.0
} ],
"date" : "2021-01-01",
"payment_terms" : 1
},
"type" : "zohoInvoice/v1/createInvoice"
}Output
Type: OBJECT
Properties
| Name | Type | Description |
|---|---|---|
| code | NUMBER | Zoho Invoice error code. This will be zero for a success response and non-zero in case of an error. |
| message | STRING | Message for the invoked API. |
| invoice | OBJECT Properties{} | Created invoice. |
Output Example
{
"code" : 0.0,
"message" : "",
"invoice" : { }
}Find Customer ID
To find the Customer ID, click here.
Find Item ID
To find the Item ID, click here.
Create Item
Name: createItem
Create a new item.
Properties
| Name | Label | Type | Description | Required |
|---|---|---|---|---|
| name | Item Name | STRING | Name of the item. | true |
| rate | Rate | NUMBER | Per unit price of an item. | true |
| product_type | Product Type | STRING Optionsgoods, service | Specify the type of an item. | true |
| description | Description | STRING | Description for the item. | false |
Example JSON Structure
{
"label" : "Create Item",
"name" : "createItem",
"parameters" : {
"name" : "",
"rate" : 0.0,
"product_type" : "",
"description" : ""
},
"type" : "zohoInvoice/v1/createItem"
}Output
Type: OBJECT
Properties
| Name | Type | Description |
|---|---|---|
| code | NUMBER | Zoho Invoice error code. This will be zero for a success response and non-zero in case of an error. |
| message | STRING | Message for the invoked API. |
| item | OBJECT Properties{} | Created item. |
Output Example
{
"code" : 0.0,
"message" : "",
"item" : { }
}What to do if your action is not listed here?
If this component doesn't have the action you need, you can use Custom Action to create your own. Custom Actions empower you to define HTTP requests tailored to your specific requirements, allowing for greater flexibility in integrating with external services or APIs.
To create a Custom Action, simply specify the desired HTTP method, path, and any necessary parameters. This way, you can extend the functionality of your component beyond the predefined actions, ensuring that you can meet all your integration needs effectively.
Additional Instructions
How to find the Currency ID
- Method 1: Via API
Use the GET /settings/currencies endpoint to retrieve a list of all currencies and their IDs.
How to find the Customer ID
- Method 1: Via API
Use the GET /contacts endpoint to retrieve a list of all customers and their IDs.
- Method 2: Via UI
Open your Zoho Invoice dashboard, then navigate to Customers from the left-hand menu. Select the desired customer, scroll down to the Record Info section and you’ll find the Customer ID listed there.
How to find the Item ID
- Method 1: Via API
Use the GET /items endpoint to retrieve a list of all items and their IDs.
How is this guide?
Last updated on
Zoho CRM
Zoho CRM is a cloud-based customer relationship management platform that integrates sales, marketing, and customer support activities to streamline business processes and enhance team.
Zoom
Zoom is a cloud-based video conferencing platform that enables virtual meetings, webinars, and collaboration through video, audio, and chat.