Price Lists AI Tools

Open in ChatGPT

Open in ChatGPT to ask questions about this page

Open in Claude

Open in Claude to ask questions about this page

Copy as Markdown

Copy this page as markdown to use with AI assistants

View as Markdown

Open this page as markdown in a new tab

Price lists used to increase or decrease a product selling or purchase price by a percentage or amount

Download Price Lists OpenAPI Document

End Points

POST

/pricebooks/{pricebook_id}

DELETE

/pricebooks/{pricebook_id}

POST

/pricebooks/{pricebook_id}/active

POST

/pricebooks/{pricebook_id}/inactive

Attribute

currency_code

string

Code based on currency

currency_id

string

The currenct id of the currency

decimal_place

integer

Decimal place for pricebook.

description

string

Description about the pricebook

is_default

boolean

To check the default pricebook.Allowed values: true,false

is_increase

boolean

Mark up or Mark down to discounts.Allowed values: true,false

name

string

Name of the pricebook

percentage

double

About percentage of discounts

pricebook_rate

double

Rate of the price book for the Items

pricebook_id

string

Unique ID generated by server for the price book

pricebook_items

array

Items included in the price book. Applicable when the price book type is set to per_item.

Show Sub-Attributes

item_id

string

Unique ID generated by server for Item

pricebook_rate

double

Rate of the price book for the Items

pricebook_item_id

string

Unique ID generated by the server for each pricebook line item

pricebook_discount

string

Discount percentage for the line item or volume bracket. The value must include a percent sign. Examples: 5%, 10.5%, 0%.

pricing_scheme

string

Applicable only when the price book type is per_item. Allowed values: unit, volume. unit: Uses pricebook_rate. volume: Uses price_brackets. Not applicable for fixed_percentage.

price_brackets

array

Collection of volume pricing tiers for a line item when pricing_scheme is volume.

Show Sub-Attributes

pricebook_item_id

string

Unique ID generated by the server for each pricebook line item

start_quantity

double

Lower bound of the quantity range for a volume bracket.

end_quantity

double

Upper bound of the quantity range for a volume bracket.

pricebook_rate

double

Rate of the price book for the Items

pricebook_discount

string

Discount percentage for the line item or volume bracket. The value must include a percent sign. Examples: 5%, 10.5%, 0%.

pricebook_type

string

Type of the pricebook.Allowed values: per_item,fixed_percentage

pricing_scheme

string

Applicable only when the price book type is per_item. Allowed values: unit, volume. unit: Uses pricebook_rate. volume: Uses price_brackets. Not applicable for fixed_percentage.

rounding_type

string

Type of the rounding.Allowed values: no_rounding,round_to_dollor,round_to_dollar_minus_01,round_to_half_dollar,round_to_half_dollar_minus_01

sales_or_purchase_type

string

Whether its sales or purchase type.Allowed values: sales,purchases

status

string

Status of the price book

{
    "currency_code": "string",
    "currency_id": 982000000000190,
    "decimal_place": 2,
    "description": "Flash sale",
    "is_default": true,
    "is_increase": true,
    "name": "Price List 1",
    "percentage": 4,
    "pricebook_rate": 22,
    "pricebook_id": 130426000002924000,
    "pricebook_items": [
        {
            "item_id": 17775000000227648,
            "pricebook_rate": 22,
            "pricebook_item_id": 17775000000227544,
            "pricebook_discount": "5%",
            "pricing_scheme": "unit",
            "price_brackets": [
                {
                    "pricebook_item_id": 17775000000227544,
                    "start_quantity": 0,
                    "end_quantity": 0,
                    "pricebook_rate": 22,
                    "pricebook_discount": "5%"
                }
            ]
        }
    ],
    "pricebook_type": "fixed_percentage",
    "pricing_scheme": "unit",
    "rounding_type": "round_to_dollar_minus_01",
    "sales_or_purchase_type": "sales",
    "status": "active"
}

Create a pricebook AI Tools

Open in ChatGPT

Open in ChatGPT to ask questions about this page

Open in Claude

Open in Claude to ask questions about this page

Copy as Markdown

Copy this page as markdown to use with AI assistants

View as Markdown

Open this page as markdown in a new tab

create a new pricebook.
OAuth Scope : ZohoBooks.settings.CREATE

Arguments

name

string

(Required)

Name of the pricebook

description

string

Description about the pricebook

currency_id

string

The currenct id of the currency

pricebook_type

string

(Required)

Type of the pricebook.Allowed values: per_item,fixed_percentage

percentage

double

About percentage of discounts

pricebook_rate

double

Rate of the price book for the Items

pricing_scheme

string

Applicable only when the price book type is per_item. Allowed values: unit, volume. unit: Uses pricebook_rate. volume: Uses price_brackets. Not applicable for fixed_percentage.

is_increase

boolean

Mark up or Mark down to discounts.Allowed values: true,false

rounding_type

string

Type of the rounding.Allowed values: no_rounding,round_to_dollor,round_to_dollar_minus_01,round_to_half_dollar,round_to_half_dollar_minus_01

decimal_place

integer

Decimal place for pricebook.

pricebook_items

array

Items included in the price book. Applicable when the price book type is set to per_item.

Show Sub-Attributes

item_id

string

Unique ID generated by server for Item

pricebook_rate

double

Rate of the price book for the Items

pricebook_discount

string

Discount percentage for the line item or volume bracket. The value must include a percent sign. Examples: 5%, 10.5%, 0%.

pricing_scheme

string

Applicable only when the price book type is per_item. Allowed values: unit, volume. unit: Uses pricebook_rate. volume: Uses price_brackets. Not applicable for fixed_percentage.

price_brackets

array

Collection of volume pricing tiers for a line item when pricing_scheme is volume.

Show Sub-Attributes

start_quantity

double

Lower bound of the quantity range for a volume bracket.

end_quantity

double

Upper bound of the quantity range for a volume bracket.

pricebook_rate

double

Rate of the price book for the Items

pricebook_discount

string

Discount percentage for the line item or volume bracket. The value must include a percent sign. Examples: 5%, 10.5%, 0%.

sales_or_purchase_type

string

(Required)

Whether its sales or purchase type.Allowed values: sales,purchases

Query Parameters

organization_id

string

(Required)

ID of the organization

Request Example

parameters_data='{"field1":"value1","field2":"value2"}';
headers_data = Map();
headers_data.put("Authorization", "Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f");
response = invokeUrl
[
url: "https://www.zohoapis.com/books/v3/pricebooks?organization_id=10234695"
type: POST
headers: headers_data
content-type: application/json
parameters: parameters_data
connection: <connection_name>
];
info response;

OkHttpClient client = new OkHttpClient();

MediaType mediaType = MediaType.parse("application/json");
RequestBody body = RequestBody.create(mediaType, "{\"field1\":\"value1\",\"field2\":\"value2\"}");
Request request = new Request.Builder()
  .url("https://www.zohoapis.com/books/v3/pricebooks?organization_id=10234695")
  .post(body)
  .addHeader("Authorization", "Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f")
  .addHeader("content-type", "application/json")
  .build();

Response response = client.newCall(request).execute();

const options = {
  method: 'POST',
  headers: {
    Authorization: 'Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f',
    'content-type': 'application/json'
  },
  body: '{"field1":"value1","field2":"value2"}'
};

fetch('https://www.zohoapis.com/books/v3/pricebooks?organization_id=10234695', options)
  .then(response => response.json())
  .then(response => console.log(response))
  .catch(err => console.error(err));

import http.client

conn = http.client.HTTPSConnection("www.zohoapis.com")

payload = "{\"field1\":\"value1\",\"field2\":\"value2\"}"

headers = {
    'Authorization': "Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f",
    'content-type': "application/json"
    }

conn.request("POST", "/books/v3/pricebooks?organization_id=10234695", payload, headers)

res = conn.getresponse()
data = res.read()

print(data.decode("utf-8"))

const http = require("https");

const options = {
  "method": "POST",
  "hostname": "www.zohoapis.com",
  "port": null,
  "path": "/books/v3/pricebooks?organization_id=10234695",
  "headers": {
    "Authorization": "Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f",
    "content-type": "application/json"
  }
};

const req = http.request(options, function (res) {
  const chunks = [];

  res.on("data", function (chunk) {
    chunks.push(chunk);
  });

  res.on("end", function () {
    const body = Buffer.concat(chunks);
    console.log(body.toString());
  });
});

req.write(JSON.stringify({field1: 'value1', field2: 'value2'}));
req.end();

curl --request POST \
  --url 'https://www.zohoapis.com/books/v3/pricebooks?organization_id=10234695' \
  --header 'Authorization: Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f' \
  --header 'content-type: application/json' \
  --data '{"field1":"value1","field2":"value2"}'

{
    "name": "Price List 1",
    "description": "Flash sale",
    "currency_id": 982000000000190,
    "pricebook_type": "fixed_percentage",
    "percentage": 4,
    "pricebook_rate": 22,
    "pricing_scheme": "unit",
    "is_increase": true,
    "rounding_type": "round_to_dollar_minus_01",
    "decimal_place": 2,
    "pricebook_items": [
        {
            "item_id": 17775000000227648,
            "pricebook_rate": 22,
            "pricebook_discount": "5%",
            "pricing_scheme": "unit",
            "price_brackets": [
                {
                    "start_quantity": 0,
                    "end_quantity": 0,
                    "pricebook_rate": 22,
                    "pricebook_discount": "5%"
                }
            ]
        }
    ],
    "sales_or_purchase_type": "sales"
}

{
    "code": 0,
    "message": "Price list has been created.",
    "pricebook": {
        "currency_code": "string",
        "currency_id": 982000000000190,
        "decimal_place": 2,
        "description": "Flash sale",
        "is_default": true,
        "is_increase": true,
        "name": "Price List 1",
        "percentage": 4,
        "pricebook_rate": 22,
        "pricebook_id": 130426000002924000,
        "pricebook_items": [
            {
                "item_id": 17775000000227648,
                "pricebook_rate": 22,
                "pricebook_item_id": 17775000000227544,
                "pricebook_discount": "5%",
                "pricing_scheme": "unit",
                "price_brackets": [
                    {
                        "pricebook_item_id": 17775000000227544,
                        "start_quantity": 0,
                        "end_quantity": 0,
                        "pricebook_rate": 22,
                        "pricebook_discount": "5%"
                    }
                ]
            }
        ],
        "pricebook_type": "fixed_percentage",
        "pricing_scheme": "unit",
        "rounding_type": "round_to_dollar_minus_01",
        "sales_or_purchase_type": "sales",
        "status": "active"
    }
}

List all pricebooks AI Tools

Open in ChatGPT

Open in ChatGPT to ask questions about this page

Open in Claude

Open in Claude to ask questions about this page

Copy as Markdown

Copy this page as markdown to use with AI assistants

View as Markdown

Open this page as markdown in a new tab

List all the available pricebooks in your zoho books organization.
OAuth Scope : ZohoBooks.settings.READ

Query Parameters

organization_id

string

(Required)

ID of the organization

page

integer

Page number to be fetched. Default value is 1.

per_page

integer

Number of records to be fetched per page. Default value is 200.

filter_by

string

Filter by sales or purchase type. Allowed values: SalesOrPurchaseType.All, SalesOrPurchaseType.Sales, SalesOrPurchaseType.Purchases.

search_text

string

Text to search in the price list (price book name).

Request Example

headers_data = Map();
headers_data.put("Authorization", "Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f");
response = invokeUrl
[
url: "https://www.zohoapis.com/books/v3/pricebooks?organization_id=10234695"
type: GET
headers: headers_data
connection: <connection_name>
];
info response;

OkHttpClient client = new OkHttpClient();

Request request = new Request.Builder()
  .url("https://www.zohoapis.com/books/v3/pricebooks?organization_id=10234695")
  .get()
  .addHeader("Authorization", "Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f")
  .build();

Response response = client.newCall(request).execute();

const options = {
  method: 'GET',
  headers: {
    Authorization: 'Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f'
  }
};

fetch('https://www.zohoapis.com/books/v3/pricebooks?organization_id=10234695', options)
  .then(response => response.json())
  .then(response => console.log(response))
  .catch(err => console.error(err));

import http.client

conn = http.client.HTTPSConnection("www.zohoapis.com")

headers = { 'Authorization': "Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f" }

conn.request("GET", "/books/v3/pricebooks?organization_id=10234695", headers=headers)

res = conn.getresponse()
data = res.read()

print(data.decode("utf-8"))

const http = require("https");

const options = {
  "method": "GET",
  "hostname": "www.zohoapis.com",
  "port": null,
  "path": "/books/v3/pricebooks?organization_id=10234695",
  "headers": {
    "Authorization": "Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f"
  }
};

const req = http.request(options, function (res) {
  const chunks = [];

  res.on("data", function (chunk) {
    chunks.push(chunk);
  });

  res.on("end", function () {
    const body = Buffer.concat(chunks);
    console.log(body.toString());
  });
});

req.end();

curl --request GET \
  --url 'https://www.zohoapis.com/books/v3/pricebooks?organization_id=10234695' \
  --header 'Authorization: Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f'

{
    "code": 0,
    "message": "success",
    "pricebooks": [
        {
            "currency_code": "string",
            "currency_id": 982000000000190,
            "decimal_place": 2,
            "description": "Flash sale",
            "is_default": true,
            "is_increase": true,
            "name": "Price List 1",
            "percentage": 4,
            "pricebook_id": 130426000002924000,
            "pricebook_items": [
                {
                    "item_id": 17775000000227648,
                    "pricebook_rate": 22,
                    "pricebook_item_id": 17775000000227544,
                    "pricebook_discount": "5%",
                    "pricing_scheme": "unit",
                    "price_brackets": [
                        {
                            "pricebook_item_id": 17775000000227544,
                            "start_quantity": 0,
                            "end_quantity": 0,
                            "pricebook_rate": 22,
                            "pricebook_discount": "5%"
                        }
                    ]
                }
            ],
            "pricebook_type": "fixed_percentage",
            "pricing_scheme": "unit",
            "rounding_type": "round_to_dollar_minus_01",
            "sales_or_purchase_type": "sales",
            "status": "active"
        },
        {...},
        {...}
    ]
}

Update pricebook AI Tools

Open in ChatGPT

Open in ChatGPT to ask questions about this page

Open in Claude

Open in Claude to ask questions about this page

Copy as Markdown

Copy this page as markdown to use with AI assistants

View as Markdown

Open this page as markdown in a new tab

update existing pricebook.
OAuth Scope : ZohoBooks.settings.UPDATE

Arguments

name

string

(Required)

Name of the pricebook

description

string

Description about the pricebook

currency_id

string

The currenct id of the currency

pricebook_type

string

(Required)

Type of the pricebook.Allowed values: per_item,fixed_percentage

percentage

double

About percentage of discounts

pricebook_rate

double

Rate of the price book for the Items

pricing_scheme

string

Applicable only when the price book type is per_item. Allowed values: unit, volume. unit: Uses pricebook_rate. volume: Uses price_brackets. Not applicable for fixed_percentage.

is_increase

boolean

Mark up or Mark down to discounts.Allowed values: true,false

rounding_type

string

Type of the rounding.Allowed values: no_rounding,round_to_dollor,round_to_dollar_minus_01,round_to_half_dollar,round_to_half_dollar_minus_01

decimal_place

integer

Decimal place for pricebook.

pricebook_items

array

Items included in the price book. Applicable when the price book type is set to per_item.

Show Sub-Attributes

item_id

string

Unique ID generated by server for Item

pricebook_rate

double

Rate of the price book for the Items

pricebook_item_id

string

Unique ID generated by the server for each pricebook line item

pricebook_discount

string

Discount percentage for the line item or volume bracket. The value must include a percent sign. Examples: 5%, 10.5%, 0%.

pricing_scheme

string

Applicable only when the price book type is per_item. Allowed values: unit, volume. unit: Uses pricebook_rate. volume: Uses price_brackets. Not applicable for fixed_percentage.

price_brackets

array

Collection of volume pricing tiers for a line item when pricing_scheme is volume.

Show Sub-Attributes

pricebook_item_id

string

Unique ID generated by the server for each pricebook line item

start_quantity

double

Lower bound of the quantity range for a volume bracket.

end_quantity

double

Upper bound of the quantity range for a volume bracket.

pricebook_rate

double

Rate of the price book for the Items

pricebook_discount

string

Discount percentage for the line item or volume bracket. The value must include a percent sign. Examples: 5%, 10.5%, 0%.

sales_or_purchase_type

string

(Required)

Whether its sales or purchase type.Allowed values: sales,purchases

Path Parameters

pricebook_id

string

(Required)

Unique identifier of the pricebook.

Query Parameters

organization_id

string

(Required)

ID of the organization

Request Example

parameters_data='{"field1":"value1","field2":"value2"}';
headers_data = Map();
headers_data.put("Authorization", "Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f");
response = invokeUrl
[
url: "https://www.zohoapis.com/books/v3/pricebooks/130426000002924000?organization_id=10234695"
type: PUT
headers: headers_data
content-type: application/json
parameters: parameters_data
connection: <connection_name>
];
info response;

OkHttpClient client = new OkHttpClient();

MediaType mediaType = MediaType.parse("application/json");
RequestBody body = RequestBody.create(mediaType, "{\"field1\":\"value1\",\"field2\":\"value2\"}");
Request request = new Request.Builder()
  .url("https://www.zohoapis.com/books/v3/pricebooks/130426000002924000?organization_id=10234695")
  .put(body)
  .addHeader("Authorization", "Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f")
  .addHeader("content-type", "application/json")
  .build();

Response response = client.newCall(request).execute();

const options = {
  method: 'PUT',
  headers: {
    Authorization: 'Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f',
    'content-type': 'application/json'
  },
  body: '{"field1":"value1","field2":"value2"}'
};

fetch('https://www.zohoapis.com/books/v3/pricebooks/130426000002924000?organization_id=10234695', options)
  .then(response => response.json())
  .then(response => console.log(response))
  .catch(err => console.error(err));

import http.client

conn = http.client.HTTPSConnection("www.zohoapis.com")

payload = "{\"field1\":\"value1\",\"field2\":\"value2\"}"

headers = {
    'Authorization': "Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f",
    'content-type': "application/json"
    }

conn.request("PUT", "/books/v3/pricebooks/130426000002924000?organization_id=10234695", payload, headers)

res = conn.getresponse()
data = res.read()

print(data.decode("utf-8"))

const http = require("https");

const options = {
  "method": "PUT",
  "hostname": "www.zohoapis.com",
  "port": null,
  "path": "/books/v3/pricebooks/130426000002924000?organization_id=10234695",
  "headers": {
    "Authorization": "Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f",
    "content-type": "application/json"
  }
};

const req = http.request(options, function (res) {
  const chunks = [];

  res.on("data", function (chunk) {
    chunks.push(chunk);
  });

  res.on("end", function () {
    const body = Buffer.concat(chunks);
    console.log(body.toString());
  });
});

req.write(JSON.stringify({field1: 'value1', field2: 'value2'}));
req.end();

curl --request PUT \
  --url 'https://www.zohoapis.com/books/v3/pricebooks/130426000002924000?organization_id=10234695' \
  --header 'Authorization: Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f' \
  --header 'content-type: application/json' \
  --data '{"field1":"value1","field2":"value2"}'

{
    "name": "Price List 1",
    "description": "Flash sale",
    "currency_id": 982000000000190,
    "pricebook_type": "fixed_percentage",
    "percentage": 4,
    "pricebook_rate": 22,
    "pricing_scheme": "unit",
    "is_increase": true,
    "rounding_type": "round_to_dollar_minus_01",
    "decimal_place": 2,
    "pricebook_items": [
        {
            "item_id": 17775000000227648,
            "pricebook_rate": 22,
            "pricebook_item_id": 17775000000227544,
            "pricebook_discount": "5%",
            "pricing_scheme": "unit",
            "price_brackets": [
                {
                    "pricebook_item_id": 17775000000227544,
                    "start_quantity": 0,
                    "end_quantity": 0,
                    "pricebook_rate": 22,
                    "pricebook_discount": "5%"
                }
            ]
        }
    ],
    "sales_or_purchase_type": "sales"
}

{
    "code": 0,
    "message": "Price list has been updated.",
    "pricebook": {
        "currency_code": "string",
        "currency_id": 982000000000190,
        "decimal_place": 2,
        "description": "Flash sale",
        "is_default": true,
        "is_increase": true,
        "name": "Price List 1",
        "percentage": 4,
        "pricebook_rate": 22,
        "pricebook_id": 130426000002924000,
        "pricebook_items": [
            {
                "item_id": 17775000000227648,
                "pricebook_rate": 22,
                "pricebook_item_id": 17775000000227544,
                "pricebook_discount": "5%",
                "pricing_scheme": "unit",
                "price_brackets": [
                    {
                        "pricebook_item_id": 17775000000227544,
                        "start_quantity": 0,
                        "end_quantity": 0,
                        "pricebook_rate": 22,
                        "pricebook_discount": "5%"
                    }
                ]
            }
        ],
        "pricebook_type": "fixed_percentage",
        "pricing_scheme": "unit",
        "rounding_type": "round_to_dollar_minus_01",
        "sales_or_purchase_type": "sales",
        "status": "active"
    }
}

Delete the pricebook AI Tools

Open in ChatGPT

Open in ChatGPT to ask questions about this page

Open in Claude

Open in Claude to ask questions about this page

Copy as Markdown

Copy this page as markdown to use with AI assistants

View as Markdown

Open this page as markdown in a new tab

Delete the pricebook.
OAuth Scope : ZohoBooks.settings.DELETE

Path Parameters

pricebook_id

string

(Required)

Unique identifier of the pricebook.

Query Parameters

organization_id

string

(Required)

ID of the organization

Request Example

headers_data = Map();
headers_data.put("Authorization", "Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f");
response = invokeUrl
[
url: "https://www.zohoapis.com/books/v3/pricebooks/130426000002924000?organization_id=10234695"
type: DELETE
headers: headers_data
connection: <connection_name>
];
info response;

OkHttpClient client = new OkHttpClient();

Request request = new Request.Builder()
  .url("https://www.zohoapis.com/books/v3/pricebooks/130426000002924000?organization_id=10234695")
  .delete(null)
  .addHeader("Authorization", "Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f")
  .build();

Response response = client.newCall(request).execute();

const options = {
  method: 'DELETE',
  headers: {
    Authorization: 'Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f'
  }
};

fetch('https://www.zohoapis.com/books/v3/pricebooks/130426000002924000?organization_id=10234695', options)
  .then(response => response.json())
  .then(response => console.log(response))
  .catch(err => console.error(err));

import http.client

conn = http.client.HTTPSConnection("www.zohoapis.com")

headers = { 'Authorization': "Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f" }

conn.request("DELETE", "/books/v3/pricebooks/130426000002924000?organization_id=10234695", headers=headers)

res = conn.getresponse()
data = res.read()

print(data.decode("utf-8"))

const http = require("https");

const options = {
  "method": "DELETE",
  "hostname": "www.zohoapis.com",
  "port": null,
  "path": "/books/v3/pricebooks/130426000002924000?organization_id=10234695",
  "headers": {
    "Authorization": "Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f"
  }
};

const req = http.request(options, function (res) {
  const chunks = [];

  res.on("data", function (chunk) {
    chunks.push(chunk);
  });

  res.on("end", function () {
    const body = Buffer.concat(chunks);
    console.log(body.toString());
  });
});

req.end();

curl --request DELETE \
  --url 'https://www.zohoapis.com/books/v3/pricebooks/130426000002924000?organization_id=10234695' \
  --header 'Authorization: Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f'

{
    "code": 0,
    "message": "Price list has been deleted."
}

Mark as Active AI Tools

Open in ChatGPT

Open in ChatGPT to ask questions about this page

Open in Claude

Open in Claude to ask questions about this page

Copy as Markdown

Copy this page as markdown to use with AI assistants

View as Markdown

Open this page as markdown in a new tab

Mark the pricebook as Active.
OAuth Scope : ZohoBooks.settings.CREATE

Path Parameters

pricebook_id

string

(Required)

Unique identifier of the pricebook.

Query Parameters

organization_id

string

(Required)

ID of the organization

Request Example

headers_data = Map();
headers_data.put("Authorization", "Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f");
response = invokeUrl
[
url: "https://www.zohoapis.com/books/v3/pricebooks/130426000002924000/active?organization_id=10234695"
type: POST
headers: headers_data
connection: <connection_name>
];
info response;

OkHttpClient client = new OkHttpClient();

Request request = new Request.Builder()
  .url("https://www.zohoapis.com/books/v3/pricebooks/130426000002924000/active?organization_id=10234695")
  .post(null)
  .addHeader("Authorization", "Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f")
  .build();

Response response = client.newCall(request).execute();

const options = {
  method: 'POST',
  headers: {
    Authorization: 'Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f'
  }
};

fetch('https://www.zohoapis.com/books/v3/pricebooks/130426000002924000/active?organization_id=10234695', options)
  .then(response => response.json())
  .then(response => console.log(response))
  .catch(err => console.error(err));

import http.client

conn = http.client.HTTPSConnection("www.zohoapis.com")

headers = { 'Authorization': "Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f" }

conn.request("POST", "/books/v3/pricebooks/130426000002924000/active?organization_id=10234695", headers=headers)

res = conn.getresponse()
data = res.read()

print(data.decode("utf-8"))

const http = require("https");

const options = {
  "method": "POST",
  "hostname": "www.zohoapis.com",
  "port": null,
  "path": "/books/v3/pricebooks/130426000002924000/active?organization_id=10234695",
  "headers": {
    "Authorization": "Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f"
  }
};

const req = http.request(options, function (res) {
  const chunks = [];

  res.on("data", function (chunk) {
    chunks.push(chunk);
  });

  res.on("end", function () {
    const body = Buffer.concat(chunks);
    console.log(body.toString());
  });
});

req.end();

curl --request POST \
  --url 'https://www.zohoapis.com/books/v3/pricebooks/130426000002924000/active?organization_id=10234695' \
  --header 'Authorization: Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f'

{
    "code": 0,
    "message": "The price list has been marked active."
}

Mark as Inactive AI Tools

Open in ChatGPT

Open in ChatGPT to ask questions about this page

Open in Claude

Open in Claude to ask questions about this page

Copy as Markdown

Copy this page as markdown to use with AI assistants

View as Markdown

Open this page as markdown in a new tab

Mark the pricebook as Inactive.
OAuth Scope : ZohoBooks.settings.CREATE

Path Parameters

pricebook_id

string

(Required)

Unique identifier of the pricebook.

Query Parameters

organization_id

string

(Required)

ID of the organization

Request Example

headers_data = Map();
headers_data.put("Authorization", "Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f");
response = invokeUrl
[
url: "https://www.zohoapis.com/books/v3/pricebooks/130426000002924000/inactive?organization_id=10234695"
type: POST
headers: headers_data
connection: <connection_name>
];
info response;

OkHttpClient client = new OkHttpClient();

Request request = new Request.Builder()
  .url("https://www.zohoapis.com/books/v3/pricebooks/130426000002924000/inactive?organization_id=10234695")
  .post(null)
  .addHeader("Authorization", "Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f")
  .build();

Response response = client.newCall(request).execute();

const options = {
  method: 'POST',
  headers: {
    Authorization: 'Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f'
  }
};

fetch('https://www.zohoapis.com/books/v3/pricebooks/130426000002924000/inactive?organization_id=10234695', options)
  .then(response => response.json())
  .then(response => console.log(response))
  .catch(err => console.error(err));

import http.client

conn = http.client.HTTPSConnection("www.zohoapis.com")

headers = { 'Authorization': "Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f" }

conn.request("POST", "/books/v3/pricebooks/130426000002924000/inactive?organization_id=10234695", headers=headers)

res = conn.getresponse()
data = res.read()

print(data.decode("utf-8"))

const http = require("https");

const options = {
  "method": "POST",
  "hostname": "www.zohoapis.com",
  "port": null,
  "path": "/books/v3/pricebooks/130426000002924000/inactive?organization_id=10234695",
  "headers": {
    "Authorization": "Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f"
  }
};

const req = http.request(options, function (res) {
  const chunks = [];

  res.on("data", function (chunk) {
    chunks.push(chunk);
  });

  res.on("end", function () {
    const body = Buffer.concat(chunks);
    console.log(body.toString());
  });
});

req.end();

curl --request POST \
  --url 'https://www.zohoapis.com/books/v3/pricebooks/130426000002924000/inactive?organization_id=10234695' \
  --header 'Authorization: Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f'

{
    "code": 0,
    "message": "The price list has been marked inactive."
}

Price Lists AI Tools Open in ChatGPT Open in ChatGPT to ask questions about this page Open in Claude Open in Claude to ask questions about this page Copy as Markdown Copy this page as markdown to use with AI assistants View as Markdown Open this page as markdown in a new tab

Attribute

Create a pricebook AI Tools Open in ChatGPT Open in ChatGPT to ask questions about this page Open in Claude Open in Claude to ask questions about this page Copy as Markdown Copy this page as markdown to use with AI assistants View as Markdown Open this page as markdown in a new tab

Arguments

Query Parameters

List all pricebooks AI Tools Open in ChatGPT Open in ChatGPT to ask questions about this page Open in Claude Open in Claude to ask questions about this page Copy as Markdown Copy this page as markdown to use with AI assistants View as Markdown Open this page as markdown in a new tab

Query Parameters

Update pricebook AI Tools Open in ChatGPT Open in ChatGPT to ask questions about this page Open in Claude Open in Claude to ask questions about this page Copy as Markdown Copy this page as markdown to use with AI assistants View as Markdown Open this page as markdown in a new tab

Arguments

Path Parameters

Query Parameters

Delete the pricebook AI Tools Open in ChatGPT Open in ChatGPT to ask questions about this page Open in Claude Open in Claude to ask questions about this page Copy as Markdown Copy this page as markdown to use with AI assistants View as Markdown Open this page as markdown in a new tab

Path Parameters

Query Parameters

Mark as Active AI Tools Open in ChatGPT Open in ChatGPT to ask questions about this page Open in Claude Open in Claude to ask questions about this page Copy as Markdown Copy this page as markdown to use with AI assistants View as Markdown Open this page as markdown in a new tab

Path Parameters

Query Parameters

Mark as Inactive AI Tools Open in ChatGPT Open in ChatGPT to ask questions about this page Open in Claude Open in Claude to ask questions about this page Copy as Markdown Copy this page as markdown to use with AI assistants View as Markdown Open this page as markdown in a new tab

Path Parameters

Query Parameters

Price Lists AI Tools

Open in ChatGPT

Open in ChatGPT to ask questions about this page

Open in Claude

Open in Claude to ask questions about this page

Copy as Markdown

Copy this page as markdown to use with AI assistants

View as Markdown

Open this page as markdown in a new tab

Create a pricebook AI Tools

Open in ChatGPT

Open in ChatGPT to ask questions about this page

Open in Claude

Open in Claude to ask questions about this page

Copy as Markdown

Copy this page as markdown to use with AI assistants

View as Markdown

Open this page as markdown in a new tab

List all pricebooks AI Tools

Open in ChatGPT

Open in ChatGPT to ask questions about this page

Open in Claude

Open in Claude to ask questions about this page

Copy as Markdown

Copy this page as markdown to use with AI assistants

View as Markdown

Open this page as markdown in a new tab

Update pricebook AI Tools

Open in ChatGPT

Open in ChatGPT to ask questions about this page

Open in Claude

Open in Claude to ask questions about this page

Copy as Markdown

Copy this page as markdown to use with AI assistants

View as Markdown

Open this page as markdown in a new tab

Delete the pricebook AI Tools

Open in ChatGPT

Open in ChatGPT to ask questions about this page

Open in Claude

Open in Claude to ask questions about this page

Copy as Markdown

Copy this page as markdown to use with AI assistants

View as Markdown

Open this page as markdown in a new tab

Mark as Active AI Tools

Open in ChatGPT

Open in ChatGPT to ask questions about this page

Open in Claude

Open in Claude to ask questions about this page

Copy as Markdown

Copy this page as markdown to use with AI assistants

View as Markdown

Open this page as markdown in a new tab

Mark as Inactive AI Tools

Open in ChatGPT

Open in ChatGPT to ask questions about this page

Open in Claude

Open in Claude to ask questions about this page

Copy as Markdown

Copy this page as markdown to use with AI assistants

View as Markdown

Open this page as markdown in a new tab