Zoho Books - Void Sales Order
•@sergio•
•code:
•data:private•last updated:3 years ago
today
Build integrations remarkably fast!
You're viewing a public workflow template.
Sign up to customize, add steps, modify code and more.
Join 1,000,000+ developers using the Pipedream platform
steps.
trigger
HTTP API
Deploy to generate unique URL
This workflow runs on Pipedream's servers and is triggered by HTTP / Webhook requests.
steps.
zoho_books_void_salesorder
Marks a sales order as void.
auth
(auths.zoho_books)
params
Organization id
In Zoho Books, your business is termed as an organization. If you have multiple businesses, you simply set each of those up as an individual organization. Each organization is an independent Zoho Books Organization with it’s own organization ID, base currency, time zone, language, contacts, reports, etc.
The parameter organization_id should be sent in with every API request to identify the organization.
The organization_id can be obtained from the GET /organizations API’s JSON response. Alternatively, it can be obtained from the Manage Organizations page in the admin console.
string ·params.organization_id
Salesorder id
ID of the sales order to void.
string ·params.salesorder_id
Optional
code
async (params, auths) => {1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
}18
//See the API docs: https://www.zoho.com/books/api/v3/#Sales-Order_Mark_a_sales_order_as_void
if (!params.organization_id || !params.salesorder_id) {
throw new Error("Must provide organization_id, and salesorder_id parameters.");
}
return await require("@pipedreamhq/platform").axios(this, {
method: "post",
url: `https://books.${auths.zoho_books.base_api_uri}/api/v3/salesorders/${params.salesorder_id}/status/void?organization_id=${params.organization_id}`,
headers: {
Authorization: `Zoho-oauthtoken ${auths.zoho_books.oauth_access_token}`,
},
params: {
reason: params.reason
}
})