Zoho books

Learn how to use Zoho books with Composio

Overview

SLUG: ZOHO_BOOKS

Description

Zoho Books handles accounting, invoicing, and expense tracking, offering real-time collaboration and integrations within the Zoho ecosystem

Authentication Details

client_id
stringRequired
client_secret
stringRequired
oauth_redirect_uri
stringDefaults to https://backend.composio.dev/api/v1/auth-apps/add
scopes
stringDefaults to ZohoBooks.fullaccess.all
bearer_token
string
suffix.one
stringRequired

Connecting to Zoho books

Create an auth config

Use the dashboard to create an auth config for the Zoho books toolkit. This allows you to connect multiple Zoho books accounts to Composio for agents to use.

1

Select App

Navigate to [Zoho books](https://platform.composio.dev?next_page=/marketplace/Zoho books).

2

Configure Auth Config Settings

Select among the supported auth schemes of and configure them here.

3

Create and Get auth config ID

Click “Create Zoho books Auth Config”. After creation, copy the displayed ID starting with ac_. This is your auth config ID. This is not a sensitive ID — you can save it in environment variables or a database. This ID will be used to create connections to the toolkit for a given user.

Connect Your Account

Using OAuth2

1from composio import Composio
2
3# Replace these with your actual values
4zoho_books_auth_config_id = "ac_YOUR_ZOHO_BOOKS_CONFIG_ID" # Auth config ID created above
5user_id = "0000-0000-0000" # UUID from database/application
6
7composio = Composio()
8
9
10def authenticate_toolkit(user_id: str, auth_config_id: str):
11 connection_request = composio.connected_accounts.initiate(
12 user_id=user_id,
13 auth_config_id=auth_config_id,
14 )
15
16 print(
17 f"Visit this URL to authenticate Zoho books: {connection_request.redirect_url}"
18 )
19
20 # This will wait for the auth flow to be completed
21 connection_request.wait_for_connection(timeout=15)
22 return connection_request.id
23
24
25connection_id = authenticate_toolkit(user_id, zoho_books_auth_config_id)
26
27# You can also verify the connection status using:
28connected_account = composio.connected_accounts.get(connection_id)
29print(f"Connected account: {connected_account}")

Tools

Executing tools

To prototype you can execute some tools to see the responses and working on the [Zoho books toolkit’s playground](https://app.composio.dev/app/Zoho books)

Python
1from composio import Composio
2from openai import OpenAI
3import json
4
5openai = OpenAI()
6composio = Composio()
7
8# User ID must be a valid UUID format
9user_id = "0000-0000-0000" # Replace with actual user UUID from your database
10
11tools = composio.tools.get(user_id=user_id, toolkits=["ZOHO_BOOKS"])
12
13print("[!] Tools:")
14print(json.dumps(tools))
15
16def invoke_llm(task = "What can you do?"):
17 completion = openai.chat.completions.create(
18 model="gpt-4o",
19 messages=[
20 {
21 "role": "user",
22 "content": task, # Your task here!
23 },
24 ],
25 tools=tools,
26 )
27
28 # Handle Result from tool call
29 result = composio.provider.handle_tool_calls(user_id=user_id, response=completion)
30 print(f"[!] Completion: {completion}")
31 print(f"[!] Tool call result: {result}")
32
33invoke_llm()

Tool List

Tool Name: Accept Estimate

Description

Tool to mark an estimate as accepted. Use after reviewing and confirming the estimate.

Action Parameters

estimate_id
stringRequired
organization_id
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Bulk Export Invoices PDF

Description

Tool to export multiple invoices to a single PDF. Use when you have up to 25 invoice IDs ready to merge.

Action Parameters

invoice_ids
arrayRequired
organization_id
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Bulk Print Invoices

Description

Tool to bulk print up to 25 invoices as a single PDF. Use when you have multiple invoice IDs and need a combined PDF for printing.

Action Parameters

invoice_ids
arrayRequired
organization_id
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Categorize Uncategorized Transaction

Description

Tool to categorize an uncategorized bank transaction. Use after fetching an uncategorized entry to assign proper type and details.

Action Parameters

amount
number
bank_charges
number
currency_id
string
custom_fields
array
customer_id
string
date
string
description
string
documents
array
exchange_rate
number
from_account_id
string
from_account_tags
array
is_inclusive_tax
boolean
line_items
array
organization_id
stringRequired
payment_mode
string
reference_number
string
tags
array
tax_authority_id
string
tax_exemption_id
string
tax_id
string
to_account_id
string
to_account_tags
array
transaction_id
stringRequired
transaction_type
stringRequired
user_id
integer

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Create Bank Account

Description

Tool to create a bank or credit card account. Use when you need to add a new bank or credit card account to your Zoho Books organization.

Action Parameters

bankaccount
objectRequired
organization_id
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Create Bank Transaction

Description

Tool to create a manual bank transaction. Use when you need to record a non-invoice bank movement in Zoho Books after obtaining valid account IDs.

Action Parameters

amount
number
bank_charges
number
currency_id
string
custom_fields
array
customer_id
string
date
string
description
string
documents
array
exchange_rate
number
from_account_id
string
from_account_tags
array
is_inclusive_tax
boolean
organization_id
stringRequired
payment_mode
string
reference_number
string
tags
array
tax_authority_id
string
tax_exemption_id
string
tax_id
string
to_account_id
string
to_account_tags
array
transaction_type
stringRequired
user_id
integer

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Create Contact

Description

Tool to create a new contact in Zoho Books. Use when adding a customer or vendor after gathering details.

Action Parameters

avatax_exempt_no
string
avatax_use_code
string
billing_address
object
company_name
string
contact_name
stringRequired
contact_number
string
contact_persons
array
contact_type
string
country_code
string
credit_limit
number
currency_id
string
custom_fields
array
customer_sub_type
string
default_templates
object
facebook
string
gst_no
string
gst_treatment
string
ignore_auto_number_generation
boolean
is_portal_enabled
boolean
is_taxable
boolean
is_tds_registered
boolean
language_code
string
legal_name
string
notes
string
opening_balances
array
organization_id
stringRequired
owner_id
string
payment_terms
integer
payment_terms_label
string
place_of_contact
string
pricebook_id
string
shipping_address
object
tags
array
tax_authority_id
string
tax_authority_name
string
tax_exemption_certificate_number
string
tax_exemption_code
string
tax_exemption_id
string
tax_id
string
tax_id_type
string
tax_id_value
string
tax_reg_no
string
tax_regime
string
tax_treatment
string
tds_tax_id
string
track_1099
boolean
twitter
string
vat_reg_no
string
vat_treatment
string
website
string

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Create Estimate

Description

Tool to create an estimate (quote). Use when you need to raise a new customer quote in Zoho Books.

Action Parameters

accept_retainer
boolean
adjustment
number
adjustment_description
string
contact_persons_associated
array
currency_id
string
custom_body
string
custom_fields
array
custom_subject
string
customer_id
stringRequired
date
string
discount
number
discount_type
string
estimate_number
string
exchange_rate
number
expiry_date
string
gst_no
string
gst_treatment
string
ignore_auto_number_generation
boolean
is_discount_before_tax
boolean
is_inclusive_tax
boolean
line_items
arrayRequired
location_id
string
notes
string
organization_id
stringRequired
place_of_supply
string
project_id
string
reference_number
string
retainer_percentage
integer
salesperson_name
string
send
boolean
shipping_charge
number
tax_id
string
template_id
string
terms
string

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Create Exchange Rate

Description

Tool to create a new exchange rate for a currency. Use after confirming currency_id and organization_id.

Action Parameters

currency_id
stringRequired
effective_date
stringRequired
organization_id
stringRequired
rate
numberRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Create Invoice

Description

Tool to create a new invoice. Use when you need to bill a customer with line items.

Action Parameters

batch_payments
boolean
currency_id
string
customer_id
stringRequired
date
string
discount
number
discount_type
string
due_date
string
exchange_rate
number
ignore_auto_number_generation
boolean
invoice_number
string
is_discount_before_tax
boolean
is_inclusive_tax
boolean
is_quick_create
boolean
line_items
arrayRequired
notes
string
organization_id
stringRequired
payment_terms
integer
payment_terms_label
string
send
boolean
terms
string

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Create Item

Description

Tool to create a new item (product or service). Use when you need to add new items with pricing and inventory details.

Action Parameters

asset_account_id
string
description
string
name
stringRequired
opening_stock
integer
opening_stock_rate
number
organization_id
stringRequired
purchase_account_id
string
purchase_rate
number
rate
numberRequired
reorder_level
integer
sales_account_id
string
sku
string
tax_id
string
tax_id2
string
track_stock
boolean
unit
string

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Create Sales Order

Description

Tool to create a sales order. Use when you need to record a new sales order in Zoho Books.

Action Parameters

avatax_exempt_no
string
avatax_use_code
string
billing_address_id
string
can_send_in_mail
boolean
contact_persons_associated
array
currency_id
string
custom_fields
array
customer_id
stringRequired
date
string
discount
string
discount_type
string
doc
object
exchange_rate
number
gst_no
string
gst_treatment
string
ignore_auto_number_generation
boolean
is_discount_before_tax
boolean
is_inclusive_tax
boolean
is_pre_gst
boolean
is_reverse_charge_applied
boolean
line_items
array
location_id
string
notes
string
organization_id
stringRequired
place_of_supply
string
pricebook_id
string
reference_number
string
salesorder_number
string
shipment_date
string
shipping_address_id
string
tax_authority_id
string
tax_authority_name
string
tax_exemption_code
string
tax_exemption_id
string
tax_treatment
string
template_id
string
terms
string
total_files
integer
vat_treatment
string

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Create User

Description

Tool to create a new user in Zoho Books. Use when inviting a team member to your organization.

Action Parameters

cost_rate
number
email
stringRequired
name
stringRequired
organization_id
stringRequired
role_id
string

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Delete Bank Transaction

Description

Tool to delete a specific bank transaction. Use when you need to remove an existing transaction after confirming its ID.

Action Parameters

bank_transaction_id
stringRequired
organization_id
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Delete Contact

Description

Tool to delete a specific contact. Use when you need to remove an existing contact after confirming its ID.

Action Parameters

contact_id
stringRequired
organization_id
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Delete Invoice

Description

Tool to delete a specific invoice. Use when you need to remove an existing invoice after confirming its ID.

Action Parameters

invoice_id
stringRequired
organization_id
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Delete Item

Description

Tool to delete a specific item. Use when you need to remove an unused item after confirming it has no linked transactions.

Action Parameters

item_id
stringRequired
organization_id
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Email Invoice

Description

Tool to send an invoice email. Use after invoice creation to share it with the customer.

Action Parameters

attachments
array
body
string
cc_mail_ids
array
from_address_id
string
invoice_id
stringRequired
organization_id
stringRequired
send_attachment
boolean
send_customer_statement
boolean
send_from_org_email_id
boolean
subject
string
to_mail_ids
arrayRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Get Bank Account

Description

Tool to fetch details of a specific bank account. Use when you need full metadata of one account by ID.

Action Parameters

account_id
stringRequired
organization_id
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Get Bill

Description

Tool to fetch details of a specific bill. Use after confirming the organization context.

Action Parameters

bill_id
stringRequired
organization_id
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Get Contact

Description

Tool to fetch details of a specific contact. Use when you need to retrieve comprehensive contact information after obtaining the contact_id.

Action Parameters

contact_id
stringRequired
organization_id
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Get Estimate

Description

Tool to fetch details of a specific estimate. Use when you need to retrieve all attributes of an existing estimate by its ID.

Action Parameters

estimate_id
stringRequired
organization_id
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Get Invoice

Description

Tool to fetch details of a specific invoice. Use when you need the full invoice record by its ID after creation or listing.

Action Parameters

accept
stringDefaults to json
invoice_id
stringRequired
organization_id
stringRequired
print
boolean

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Get Item

Description

Tool to fetch details of a specific item. Use when you need to retrieve all attributes of an existing item by its ID.

Action Parameters

item_id
stringRequired
organization_id
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Get Sales Order

Description

Tool to fetch details of a specific sales order. Use when you need the full record of a sales order by its ID.

Action Parameters

accept
string
organization_id
stringRequired
print
boolean
salesorder_id
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Get User

Description

Tool to fetch details of a specific user. Use after obtaining the user_id to retrieve comprehensive user information.

Action Parameters

organization_id
stringRequired
user_id
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: List Bank Accounts

Description

Tool to list bank and credit card accounts. Use when retrieving all accounts for reconciliation or overview.

Action Parameters

filter_by
string
organization_id
stringRequired
page
integer
per_page
integer
sort_column
string

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: List Bank Transactions

Description

Tool to list bank transactions with optional filters. Use when you need to retrieve transactions for reconciliation and reporting.

Action Parameters

account_id
integer
amount_end
number
amount_start
number
date_end
string
date_start
string
filter_by
string
organization_id
stringRequired
page
integerDefaults to 1
per_page
integerDefaults to 200
reference_number
string
search_text
string
sort_column
string
status
string
transaction_type
string

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: List Bills

Description

Tool to retrieve a paginated list of bills. Use when listing bills with filters and pagination.

Action Parameters

bill_number
string
bill_number_contains
string
bill_number_startswith
string
date_after
string
date_before
string
date_end
string
date_start
string
description_contains
string
description_startswith
string
item_id
integer
organization_id
stringRequired
page
integerDefaults to 1
per_page
integerDefaults to 200
reference_number
string
reference_number_contains
string
reference_number_startswith
string
sort_column
string
sort_order
string
status
string
total_greater_equals
number
total_greater_than
number
total_less_equals
number
total_less_than
number
vendor_id
integer
vendor_name_contains
string
vendor_name_startswith
string

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: List Chart Of Accounts

Description

Tool to list chart of accounts. Use when you need to fetch all chart of accounts with optional filtering, sorting, and pagination.

Action Parameters

filter_by
string
organization_id
stringRequired
page
integerDefaults to 1
per_page
integerDefaults to 200
showbalance
boolean
sort_column
string

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: List Contacts

Description

Tool to retrieve a paginated list of contacts with optional filters. Use when you need to fetch and filter contacts from Zoho Books before processing them.

Action Parameters

address_contains
string
address_startswith
string
company_name_contains
string
company_name_startswith
string
contact_name_contains
string
contact_name_startswith
string
contact_type
string
email_contains
string
email_startswith
string
filter_by
string
first_name_contains
string
first_name_startswith
string
last_name_contains
string
last_name_startswith
string
organization_id
stringRequired
page
integerDefaults to 1
per_page
integerDefaults to 200
phone_contains
string
phone_startswith
string
search_text
string
sort_column
string
zcrm_account_id
string
zcrm_contact_id
string
zcrm_vendor_id
string

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: List Currencies

Description

Tool to list currencies configured for the organization. Use after authentication to retrieve all currency settings.

Action Parameters

filter_by
string
organization_id
stringRequired
page
integerDefaults to 1
per_page
integerDefaults to 200

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: List Invoice Payments

Description

Tool to list payments recorded against an invoice. Use when retrieving all payment transactions applied to a specific invoice.

Action Parameters

invoice_id
stringRequired
organization_id
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: List Invoices

Description

Tool to retrieve a paginated list of invoices with filters and search. Use when you need to fetch and filter invoices before processing.

Action Parameters

customer_id
integer
customer_name
string
date_end
string
date_start
string
due_date_end
string
due_date_start
string
filter_by
string
invoice_number
string
invoice_number_contains
string
invoice_number_startswith
string
organization_id
stringRequired
page
integerDefaults to 1
per_page
integerDefaults to 200
response_option
integer
search_text
string
sort_column
string
sort_order
string
status
string

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: List Items

Description

Tool to retrieve a paginated list of items from Zoho Books. Use when you need to list items with optional filters, search, and sorting.

Action Parameters

account_id
string
description
string
description_contains
string
description_startswith
string
filter_by
string
is_taxable
boolean
name
string
name_contains
string
name_startswith
string
organization_id
stringRequired
page
integerDefaults to 1
per_page
integerDefaults to 200
rate
number
rate_greater_equals
number
rate_greater_than
number
rate_less_equals
number
rate_less_than
number
sat_item_key_code
string
search_text
string
sort_column
string
sort_order
string
tax_exemption_id
string
tax_id
string
tax_name
string
unitkey_code
string

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: List Organizations

Description

Tool to list all organizations for the authenticated user. Use when you need to obtain the organization_id for subsequent API calls.

Action Parameters

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: List Sales Orders

Description

Tool to retrieve a paginated list of sales orders. Use when browsing sales orders by organization with optional sorting and filtering.

Action Parameters

filter_by
string
organization_id
stringRequired
page
integerDefaults to 1
per_page
integerDefaults to 200
search_text
string
sort_column
string

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: List Users

Description

Tool to retrieve a paginated list of users. Use when you need to fetch and browse users of an organization in Zoho Books.

Action Parameters

filter_by
string
organization_id
stringRequired
page
integerDefaults to 1
per_page
integerDefaults to 200
sort_column
string

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Mark Contact as Active

Description

Tool to mark a contact as active. Use when you need to reactivate a previously deactivated contact after confirming its ID.

Action Parameters

contact_id
stringRequired
organization_id
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Mark Invoice As Sent

Description

Tool to mark an invoice as Sent. Use after the invoice is finalized and ready for delivery to the customer.

Action Parameters

invoice_id
stringRequired
organization_id
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Open Sales Order

Description

Tool to mark a sales order as Open. Use when a sales order in Draft status needs to be opened for processing.

Action Parameters

organization_id
stringRequired
salesorder_id
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Send Payment Reminder

Description

Tool to send a payment reminder for an invoice. Use when invoice is in Open or Overdue status.

Action Parameters

body
string
cc_mail_ids
array
invoice_id
stringRequired
organization_id
stringRequired
send_customer_statement
boolean
send_from_org_email_id
boolean
subject
string
to_mail_ids
array

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Update Vendor Bill

Description

Tool to update a vendor bill. Use when you need to modify an existing bill in Zoho Books. Use after fetching the current bill details.

Action Parameters

adjustment
number
adjustment_description
string
approvers
array
attachment
object
bill_id
stringRequired
bill_number
stringRequired
currency_id
string
custom_fields
array
date
string
destination_of_supply
string
documents
array
due_date
string
exchange_rate
number
gst_no
string
gst_treatment
string
is_inclusive_tax
boolean
is_item_level_tax_calc
boolean
line_items
array
location_id
string
notes
string
organization_id
stringRequired
payment_terms
integer
payment_terms_label
string
permit_number
string
place_of_supply
string
pricebook_id
string
purchaseorder_ids
array
recurring_bill_id
string
reference_number
string
source_of_supply
string
tax_treatment
string
taxes
array
terms
string
vendor_id
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Update Contact

Description

Tool to update details of a contact. Use when you need to modify any contact attribute after verifying contact_id.

Action Parameters

avatax_exempt_no
string
avatax_use_code
string
billing_address
object
company_name
string
contact_id
stringRequired
contact_name
stringRequired
contact_number
string
contact_persons
array
contact_type
string
country_code
string
credit_limit
number
currency_id
string
custom_fields
array
customer_sub_type
string
default_templates
object
facebook
string
gst_no
string
gst_treatment
string
ignore_auto_number_generation
boolean
is_taxable
boolean
is_tds_registered
boolean
legal_name
string
notes
string
opening_balances
array
organization_id
stringRequired
owner_id
string
payment_terms
integer
payment_terms_label
string
place_of_contact
string
pricebook_id
string
shipping_address
object
tags
array
tax_authority_id
string
tax_authority_name
string
tax_exemption_certificate_number
string
tax_exemption_code
string
tax_exemption_id
string
tax_id
string
tax_id_type
string
tax_id_value
string
tax_reg_no
string
tax_regime
string
tax_treatment
string
track_1099
boolean
twitter
string
vat_reg_no
string
vat_treatment
string
website
string

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Update Invoice

Description

Tool to update details of a specific invoice. Use when you need to modify an existing invoice in Zoho Books—change line items, dates, or other invoice fields. Requires invoice ID and organization ID before calling.

Action Parameters

currency_id
string
customer_id
stringRequired
date
string
discount
number
discount_type
string
due_date
string
exchange_rate
number
ignore_auto_number_generation
boolean
invoice_id
stringRequired
invoice_number
string
is_discount_before_tax
boolean
is_inclusive_tax
boolean
line_items
arrayRequired
notes
string
organization_id
stringRequired
payment_terms
integer
payment_terms_label
string
terms
string

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Update Item

Description

Tool to update details of a specific item. Use when you need to modify an existing item's attributes after fetching its current state.

Action Parameters

account_id
string
avatax_tax_code
string
avatax_use_code
string
custom_fields
array
description
string
hsn_or_sac
string
inventory_account_id
string
is_taxable
boolean
item_id
stringRequired
item_tax_preferences
array
item_type
string
locations
array
name
stringRequired
organization_id
stringRequired
product_type
string
purchase_account_id
string
purchase_description
string
purchase_rate
string
purchase_tax_exemption_id
string
purchase_tax_rule_id
string
rate
numberRequired
reorder_level
string
sales_tax_rule_id
string
sat_item_key_code
string
sku
string
tax_exemption_id
string
tax_id
string
tax_percentage
string
unitkey_code
string
vendor_id
string

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Update Sales Order

Description

Tool to update a specific sales order. Use when you need to modify an existing sales order (e.g., change dates, line items, or custom fields) after creation.

Action Parameters

contact_persons_associated
array
currency_id
string
custom_fields
array
customer_id
string
date
string
line_items
array
organization_id
stringRequired
salesorder_id
stringRequired
shipment_date
string
tax_exemption_code
string
tax_exemption_id
string

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Void Invoice

Description

Tool to mark an invoice as Void. Use when you need to void an existing invoice after reviewing any outstanding payments.

Action Parameters

invoice_id
stringRequired
organization_id
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired