Purchase Receives

Purchase Receives 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

A new purchase receive can a be created.To create Purchase receive, URL parameter purchaseorder_id is needed.

Download Purchase Receives OpenAPI Document

Attribute

purchaseorder_id
string
Unique ID generated by the server for the Purchase Order.
purchaseorder_number
string
Purchase Order number.
receive_id
string
Unique ID generated by the server for the Purchase Receive. This is used as identifier.
receive_number
string
Number of the Purchase Receive.
date
string
Date of Purchase Receive
vendor_id
string
Unique ID generated by the server for the vendor.
vendor_name
string
Name of the vendor.
contact_persons
array
Array of contact person IDs.
notes
string
Purchase Receive notes.
custom_fields
array
Custom fields for a purchasereceive.
Show Sub-Attributes arrow
customfield_id
string
Unique identifier of the custom field
label
string
Label of the Custom Field
value
string
Value of the Custom Field
line_items
array
Number of line items for purchase receive. Each line item contains line_item_id, item_id, name, description, item_order, quantity and unit.
Show Sub-Attributes arrow
line_item_id
string
Unique ID generated by the server for each line item. This is used as an identifier.
item_id
string
Unique ID generated by the server for the item. This is used as an identifier.
name
string
Name of the line item.
description
string
Description of the line item.
item_order
integer
The order of the line items, starts from 0 by default.
quantity
double
Quantity of the line item.
unit
string
Unit of line item.
serial_numbers
array
Serial numbers for the line item. Applicable only for items with serial tracking enabled.
batches
array
Batches tracked for the line item. Returned for items with batch tracking enabled.
Show Sub-Attributes arrow
batch_id
string
Unique identifier of the batch.
batch_number
string
Batch number.
external_batch_number
string
External batch number from the manufacturer.
manufacturer_date
string
Manufacturing date of the batch.
expiry_date
string
Expiration date of the batch.
in_quantity
float
Inward quantity recorded for the batch.
batch_in_id
string
Unique identifier of the batch entry on the line item.
storages
array
Batch with Bin tracked items only
Bin/storage locations from which stock was received for this batch.
Show Sub-Attributes arrow
storage_id
string
Unique identifier of the bin/storage location.
storage_name
string
Display name of the bin/storage location.
in_quantity
float
Inward quantity recorded against the bin.
storage_in_id
string
Unique identifier of the storage entry on the line item.
storages
array
Bin/storage locations tracked for the line item. Returned for items with bin tracking enabled.
Show Sub-Attributes arrow
storage_id
string
Unique identifier of the bin/storage location.
storage_name
string
Display name of the bin/storage location.
in_quantity
float
Inward quantity recorded against the bin.
storage_in_id
string
Unique identifier of the storage entry on the line item.
serial_numbers
array
Serial with Bin tracked items only
Serial numbers allocated to this bin.
item_custom_fields
array
List of custom fields associated with the line item
Show Sub-Attributes arrow
label
string
Label of the Custom Field
value
string
Value of the Custom Field
billing_address
array
Customer's billing address. It contains - address, city, state, zip, country and fax.
Show Sub-Attributes arrow
address
string
Name of the street of the customer's billing address.
city
string
Name of the city of the customer's billing address.
state
string
Name of the state of the customer's billing address.
zip
string
Zip code of the customer's billing address.
country
string
Name of the country of the customer's billing address.
fax
string
Fax number of the customer's billing address.
shipping_address
array
Customer's shipping address. It contains - address, city, state, zip, country and fax.
Show Sub-Attributes arrow
address
string
Name of the street of the customer's billing address.
city
string
Name of the city of the customer's billing address.
state
string
Name of the state of the customer's billing address.
zip
string
Zip code of the customer's billing address.
country
string
Name of the country of the customer's billing address.
fax
string
Fax number of the customer's billing address.
created_time
string
Time at which the Purchase Receive was created.
last_modified_time
string
Time at which the Purchase Order details were last modified.

Example

{ "purchaseorder_id": 4815000000044972, "purchaseorder_number": "PO-00002", "receive_id": 4815000000045035, "receive_number": "PR-00002", "date": "2015-05-28", "vendor_id": 4815000000044080, "vendor_name": "Molly", "contact_persons": 4815000000044080, "notes": "Sample Note.", "custom_fields": [ { "customfield_id": "46000000012845", "label": "string", "value": "Normal" } ], "line_items": [ { "line_item_id": 4815000000044897, "item_id": 4815000000044100, "name": "Laptop-white/15inch/dell", "description": "Just a sample description.", "item_order": 0, "quantity": 2, "unit": "qty", "serial_numbers": [ "TC-IO-09" ], "batches": [ { "batch_id": "6780203000001066789", "batch_number": "BTC-TL-890", "external_batch_number": "MFR-TL-890", "manufacturer_date": "2026-05-12", "expiry_date": "2026-12-24", "in_quantity": 2, "batch_in_id": "6780203000001066797", "storages": [ { "storage_id": "6780203000001066003", "storage_name": "Bin A1", "in_quantity": 2, "storage_in_id": "6780203000001066792" } ] } ], "storages": [ { "storage_id": "6780203000000093226", "storage_name": "Bin A2", "in_quantity": 2, "storage_in_id": "6780203000001066795", "serial_numbers": [ "TC-IO-09" ], "item_custom_fields": [ { "label": "string", "value": "Normal" } ] } ] } ], "billing_address": [ { "address": "No:234,90 Church Street", "city": "New York City", "state": "New York", "zip": 10048, "country": "U.S.A", "fax": "324-524242" } ], "shipping_address": [ { "address": "No:234,90 Church Street", "city": "New York City", "state": "New York", "zip": 10048, "country": "U.S.A", "fax": "324-524242" } ], "created_time": "2015-05-28T00:00:00.000Z", "last_modified_time": "2015-05-28T00:00:00.000Z" }

Create a purchase receive 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

A new purchase receive can a be created.To create Purchase receive, URL parameter purchaseorder_id is needed.
OAuth Scope : ZohoInventory.purchasereceives.CREATE

Arguments

receive_number
string
(Required)
Number of the Purchase Receive.
date
string
Date of Purchase Receive
notes
string
Purchase Receive notes.
custom_fields
array
Custom fields for a purchasereceive.
Show Sub-Attributes arrow
customfield_id
string
Unique identifier of the custom field
label
string
Label of the Custom Field
value
string
Value of the Custom Field
line_items
array
(Required)
Number of line items for purchase receive.
Show Sub-Attributes arrow
line_item_id
string
Unique ID generated by the server for each line item. This is used as an identifier.
item_id
string
Unique ID generated by the server for the item. This is used as an identifier.
name
string
Name of the line item.
description
string
Description of the line item.
item_order
integer
The order of the line items, starts from 0 by default.
quantity
double
Quantity of the line item.
unit
string
Unit of line item.
serial_numbers
array
Serial numbers for the line item. Applicable only for items with serial tracking enabled.
batches
array
Batches for the line item. Create a new batch using batch_number or reference an existing batch using batch_id. Applicable only for items with batch tracking enabled.
Show Sub-Attributes arrow
batch_id
string
Unique identifier of a batch. Use when adding inward quantity to an existing batch or updating a batch.
batch_number
string
Batch number. Required when creating a new batch.
external_batch_number
string
External batch number from the manufacturer. Applicable when creating a new batch.
manufacturer_date
string
Manufacturing date of the batch. Applicable when creating a new batch.
expiry_date
string
Expiration date of the batch. Applicable when creating a new batch.
in_quantity
float
(Required)
Inward quantity for the batch.
storages
array
Batch with Bin tracked items only
Bin/storage locations allocated for stock received against this batch.
Show Sub-Attributes arrow
storage_id
string
(Required)
Unique identifier of the bin/storage location.
in_quantity
float
(Required)
Inward quantity into the bin.
storages
array
Bin/storage locations allocated for the line item. Applicable only for items with bin tracking enabled.
Show Sub-Attributes arrow
storage_id
string
(Required)
Unique identifier of the bin/storage location.
in_quantity
float
(Required)
Inward quantity into the bin.
serial_numbers
array
Serial with Bin tracked items only
Serial numbers allocated to this bin.

Query Parameters

organization_id
string
(Required)
ID of the organization

Request Example

Click to copy
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/inventory/v1/purchasereceives?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/inventory/v1/purchasereceives?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/inventory/v1/purchasereceives?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", "/inventory/v1/purchasereceives?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": "/inventory/v1/purchasereceives?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/inventory/v1/purchasereceives?organization_id=10234695' \ --header 'Authorization: Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f' \ --header 'content-type: application/json' \ --data '{"field1":"value1","field2":"value2"}'

Body Parameters

Click to copy
{ "receive_number": "PR-00002", "date": "2015-05-28", "notes": "Sample Note.", "custom_fields": [ { "customfield_id": "46000000012845", "label": "string", "value": "Normal" } ], "line_items": [ { "line_item_id": 4815000000044897, "item_id": 4815000000044100, "name": "Laptop-white/15inch/dell", "description": "Just a sample description.", "item_order": 0, "quantity": 2, "unit": "qty", "serial_numbers": [ "TC-IO-09" ], "batches": [ { "batch_id": "6780203000001066789", "batch_number": "BTC-TL-890", "external_batch_number": "MFR-TL-890", "manufacturer_date": "2026-05-12", "expiry_date": "2026-12-24", "in_quantity": 2, "storages": [ { "storage_id": "6780203000001066003", "in_quantity": 2 } ] } ], "storages": [ { "storage_id": "6780203000000093226", "in_quantity": 2, "serial_numbers": [ "TC-IO-09" ] } ] } ] }

Response Example

{ "code": 0, "message": "success", "purchase_receive": { "purchaseorder_id": 4815000000044972, "purchaseorder_number": "PO-00002", "receive_id": 4815000000045035, "receive_number": "PR-00002", "date": "2015-05-28", "vendor_id": 4815000000044080, "vendor_name": "Molly", "contact_persons": 4815000000044080, "notes": "Sample Note.", "custom_fields": [ { "customfield_id": "46000000012845", "label": "string", "value": "Normal" } ], "line_items": [ { "line_item_id": 4815000000044897, "item_id": 4815000000044100, "name": "Laptop-white/15inch/dell", "description": "Just a sample description.", "item_order": 0, "quantity": 2, "unit": "qty", "serial_numbers": [ "TC-IO-09" ], "batches": [ { "batch_id": "6780203000001066789", "batch_number": "BTC-TL-890", "external_batch_number": "MFR-TL-890", "manufacturer_date": "2026-05-12", "expiry_date": "2026-12-24", "in_quantity": 2, "batch_in_id": "6780203000001066797", "storages": [ { "storage_id": "6780203000001066003", "storage_name": "Bin A1", "in_quantity": 2, "storage_in_id": "6780203000001066792" } ] } ], "storages": [ { "storage_id": "6780203000000093226", "storage_name": "Bin A2", "in_quantity": 2, "storage_in_id": "6780203000001066795", "serial_numbers": [ "TC-IO-09" ], "item_custom_fields": [ { "label": "string", "value": "Normal" } ] } ] } ], "billing_address": [ { "address": "No:234,90 Church Street", "city": "New York City", "state": "New York", "zip": 10048, "country": "U.S.A", "fax": "324-524242" } ], "shipping_address": [ { "address": "No:234,90 Church Street", "city": "New York City", "state": "New York", "zip": 10048, "country": "U.S.A", "fax": "324-524242" } ], "created_time": "2015-05-28T00:00:00.000Z", "last_modified_time": "2015-05-28T00:00:00.000Z" } }

Update a Purchase Receive 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 a existing Purchase Receive from Zoho Inventory.
OAuth Scope : ZohoInventory.purchasereceives.UPDATE

Arguments

receive_number
string
(Required)
Number of the Purchase Receive.
date
string
Date of Purchase Receive
notes
string
Purchase Receive notes.
custom_fields
array
Custom fields for a purchasereceive.
Show Sub-Attributes arrow
customfield_id
string
Unique identifier of the custom field
label
string
Label of the Custom Field
value
string
Value of the Custom Field
line_items
array
(Required)
Number of line items for purchase receive.
Show Sub-Attributes arrow
line_item_id
string
Unique ID generated by the server for each line item. This is used as an identifier.
item_id
string
Unique ID generated by the server for the item. This is used as an identifier.
name
string
Name of the line item.
description
string
Description of the line item.
item_order
integer
The order of the line items, starts from 0 by default.
quantity
double
Quantity of the line item.
unit
string
Unit of line item.
serial_numbers
array
Serial numbers for the line item. Applicable only for items with serial tracking enabled.
batches
array
Batches for the line item. Create a new batch using batch_number or reference an existing batch using batch_id. Applicable only for items with batch tracking enabled.
Show Sub-Attributes arrow
batch_id
string
Unique identifier of a batch. Use when adding inward quantity to an existing batch or updating a batch.
batch_number
string
Batch number. Required when creating a new batch.
external_batch_number
string
External batch number from the manufacturer. Applicable when creating a new batch.
manufacturer_date
string
Manufacturing date of the batch. Applicable when creating a new batch.
expiry_date
string
Expiration date of the batch. Applicable when creating a new batch.
in_quantity
float
(Required)
Inward quantity for the batch.
batch_in_id
string
Unique identifier of the batch record. Applicable only when updating an existing batch entry.
storages
array
Batch with Bin tracked items only
Bin/storage locations allocated for stock received against this batch.
Show Sub-Attributes arrow
storage_id
string
(Required)
Unique identifier of the bin/storage location.
storage_in_id
string
Unique identifier of the storage record. Applicable only when updating an existing storage entry.
in_quantity
float
(Required)
Inward quantity into the bin.
storages
array
Bin/storage locations allocated for the line item. Applicable only for items with bin tracking enabled.
Show Sub-Attributes arrow
storage_id
string
(Required)
Unique identifier of the bin/storage location.
storage_in_id
string
Unique identifier of the storage record. Applicable only when updating an existing storage entry.
in_quantity
float
(Required)
Inward quantity into the bin.
serial_numbers
array
Serial with Bin tracked items only
Serial numbers allocated to this bin.

Path Parameters

purchasereceive_id
string
(Required)
Unique identifier of the purchase receive.

Query Parameters

organization_id
string
(Required)
ID of the organization

Request Example

Click to copy
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/inventory/v1/purchasereceives/4815000000045035?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/inventory/v1/purchasereceives/4815000000045035?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/inventory/v1/purchasereceives/4815000000045035?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", "/inventory/v1/purchasereceives/4815000000045035?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": "/inventory/v1/purchasereceives/4815000000045035?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/inventory/v1/purchasereceives/4815000000045035?organization_id=10234695' \ --header 'Authorization: Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f' \ --header 'content-type: application/json' \ --data '{"field1":"value1","field2":"value2"}'

Body Parameters

Click to copy
{ "receive_number": "PR-00002", "date": "2015-05-28", "notes": "Sample Note.", "custom_fields": [ { "customfield_id": "46000000012845", "label": "string", "value": "Normal" } ], "line_items": [ { "line_item_id": 4815000000044897, "item_id": 4815000000044100, "name": "Laptop-white/15inch/dell", "description": "Just a sample description.", "item_order": 0, "quantity": 2, "unit": "qty", "serial_numbers": [ "TC-IO-09" ], "batches": [ { "batch_id": "6780203000001066789", "batch_number": "BTC-TL-890", "external_batch_number": "MFR-TL-890", "manufacturer_date": "2026-05-12", "expiry_date": "2026-12-24", "in_quantity": 2, "batch_in_id": "6780203000001066797", "storages": [ { "storage_id": "6780203000001066003", "storage_in_id": "6780203000001066792", "in_quantity": 2 } ] } ], "storages": [ { "storage_id": "6780203000000093226", "storage_in_id": "6780203000001066795", "in_quantity": 2, "serial_numbers": [ "TC-IO-09" ] } ] } ] }

Response Example

{ "code": 0, "message": "success", "purchase_receive": { "purchaseorder_id": 4815000000044972, "purchaseorder_number": "PO-00002", "receive_id": 4815000000045035, "receive_number": "PR-00002", "date": "2015-05-28", "vendor_id": 4815000000044080, "vendor_name": "Molly", "contact_persons": 4815000000044080, "notes": "Sample Note.", "custom_fields": [ { "customfield_id": "46000000012845", "label": "string", "value": "Normal" } ], "line_items": [ { "line_item_id": 4815000000044897, "item_id": 4815000000044100, "name": "Laptop-white/15inch/dell", "description": "Just a sample description.", "item_order": 0, "quantity": 2, "unit": "qty", "serial_numbers": [ "TC-IO-09" ], "batches": [ { "batch_id": "6780203000001066789", "batch_number": "BTC-TL-890", "external_batch_number": "MFR-TL-890", "manufacturer_date": "2026-05-12", "expiry_date": "2026-12-24", "in_quantity": 2, "batch_in_id": "6780203000001066797", "storages": [ { "storage_id": "6780203000001066003", "storage_name": "Bin A1", "in_quantity": 2, "storage_in_id": "6780203000001066792" } ] } ], "storages": [ { "storage_id": "6780203000000093226", "storage_name": "Bin A2", "in_quantity": 2, "storage_in_id": "6780203000001066795", "serial_numbers": [ "TC-IO-09" ], "item_custom_fields": [ { "label": "string", "value": "Normal" } ] } ] } ], "billing_address": [ { "address": "No:234,90 Church Street", "city": "New York City", "state": "New York", "zip": 10048, "country": "U.S.A", "fax": "324-524242" } ], "shipping_address": [ { "address": "No:234,90 Church Street", "city": "New York City", "state": "New York", "zip": 10048, "country": "U.S.A", "fax": "324-524242" } ], "created_time": "2015-05-28T00:00:00.000Z", "last_modified_time": "2015-05-28T00:00:00.000Z" } }

Retrieve a Purchase Receive 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

Fetches a Purchase Receive from Zoho Inventory.
OAuth Scope : ZohoInventory.purchasereceives.READ

Path Parameters

purchasereceive_id
string
(Required)
Unique identifier of the purchase receive.

Query Parameters

organization_id
string
(Required)
ID of the organization

Request Example

Click to copy
headers_data = Map(); headers_data.put("Authorization", "Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f"); response = invokeUrl [ url: "https://www.zohoapis.com/inventory/v1/purchasereceives/4815000000045035?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/inventory/v1/purchasereceives/4815000000045035?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/inventory/v1/purchasereceives/4815000000045035?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", "/inventory/v1/purchasereceives/4815000000045035?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": "/inventory/v1/purchasereceives/4815000000045035?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/inventory/v1/purchasereceives/4815000000045035?organization_id=10234695' \ --header 'Authorization: Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f'

Response Example

{ "code": 0, "message": "success", "purchase_receive": { "purchaseorder_id": 4815000000044972, "purchaseorder_number": "PO-00002", "receive_id": 4815000000045035, "receive_number": "PR-00002", "date": "2015-05-28", "vendor_id": 4815000000044080, "vendor_name": "Molly", "contact_persons": 4815000000044080, "notes": "Sample Note.", "custom_fields": [ { "customfield_id": "46000000012845", "label": "string", "value": "Normal" } ], "line_items": [ { "line_item_id": 4815000000044897, "item_id": 4815000000044100, "name": "Laptop-white/15inch/dell", "description": "Just a sample description.", "item_order": 0, "quantity": 2, "unit": "qty", "serial_numbers": [ "TC-IO-09" ], "batches": [ { "batch_id": "6780203000001066789", "batch_number": "BTC-TL-890", "external_batch_number": "MFR-TL-890", "manufacturer_date": "2026-05-12", "expiry_date": "2026-12-24", "in_quantity": 2, "batch_in_id": "6780203000001066797", "storages": [ { "storage_id": "6780203000001066003", "storage_name": "Bin A1", "in_quantity": 2, "storage_in_id": "6780203000001066792" } ] } ], "storages": [ { "storage_id": "6780203000000093226", "storage_name": "Bin A2", "in_quantity": 2, "storage_in_id": "6780203000001066795", "serial_numbers": [ "TC-IO-09" ], "item_custom_fields": [ { "label": "string", "value": "Normal" } ] } ] } ], "billing_address": [ { "address": "No:234,90 Church Street", "city": "New York City", "state": "New York", "zip": 10048, "country": "U.S.A", "fax": "324-524242" } ], "shipping_address": [ { "address": "No:234,90 Church Street", "city": "New York City", "state": "New York", "zip": 10048, "country": "U.S.A", "fax": "324-524242" } ], "created_time": "2015-05-28T00:00:00.000Z", "last_modified_time": "2015-05-28T00:00:00.000Z" } }

Delete a Purchase Receive 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

Deletes a Purchase Receive from Zoho Inventory.
OAuth Scope : ZohoInventory.purchasereceives.DELETE

Path Parameters

purchasereceive_id
string
(Required)
Unique identifier of the purchase receive.

Query Parameters

organization_id
string
(Required)
ID of the organization

Request Example

Click to copy
headers_data = Map(); headers_data.put("Authorization", "Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f"); response = invokeUrl [ url: "https://www.zohoapis.com/inventory/v1/purchasereceives/4815000000045035?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/inventory/v1/purchasereceives/4815000000045035?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/inventory/v1/purchasereceives/4815000000045035?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", "/inventory/v1/purchasereceives/4815000000045035?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": "/inventory/v1/purchasereceives/4815000000045035?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/inventory/v1/purchasereceives/4815000000045035?organization_id=10234695' \ --header 'Authorization: Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f'

Response Example

{ "code": 0, "message": "The Purchase Receive has been deleted." }

Submit a purchase receive for approval 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

Submit a purchase receive for approval workflow.
OAuth Scope : ZohoInventory.purchasereceives.UPDATE

Path Parameters

purchasereceive_id
string
(Required)
Unique ID of the purchase receive.

Query Parameters

organization_id
string
(Required)
ID of the organization

Request Example

Click to copy
headers_data = Map(); headers_data.put("Authorization", "Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f"); response = invokeUrl [ url: "https://www.zohoapis.com/inventory/v1/purchasereceives/4815000000045035/submit?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/inventory/v1/purchasereceives/4815000000045035/submit?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/inventory/v1/purchasereceives/4815000000045035/submit?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", "/inventory/v1/purchasereceives/4815000000045035/submit?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": "/inventory/v1/purchasereceives/4815000000045035/submit?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/inventory/v1/purchasereceives/4815000000045035/submit?organization_id=10234695' \ --header 'Authorization: Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f'

Response Example

{ "code": 0, "message": "success" }

Approve a purchase receive 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

Approve a submitted purchase receive.
OAuth Scope : ZohoInventory.purchasereceives.UPDATE

Path Parameters

purchasereceive_id
string
(Required)
Unique ID of the purchase receive.

Query Parameters

organization_id
string
(Required)
ID of the organization

Request Example

Click to copy
headers_data = Map(); headers_data.put("Authorization", "Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f"); response = invokeUrl [ url: "https://www.zohoapis.com/inventory/v1/purchasereceives/4815000000045035/approve?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/inventory/v1/purchasereceives/4815000000045035/approve?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/inventory/v1/purchasereceives/4815000000045035/approve?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", "/inventory/v1/purchasereceives/4815000000045035/approve?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": "/inventory/v1/purchasereceives/4815000000045035/approve?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/inventory/v1/purchasereceives/4815000000045035/approve?organization_id=10234695' \ --header 'Authorization: Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f'

Response Example

{ "code": 0, "message": "success" }

Final approval of a purchase receive 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

Perform the final approval of a purchase receive (admin only).
OAuth Scope : ZohoInventory.purchasereceives.UPDATE

Path Parameters

purchasereceive_id
string
(Required)
Unique ID of the purchase receive.

Query Parameters

organization_id
string
(Required)
ID of the organization

Request Example

Click to copy
headers_data = Map(); headers_data.put("Authorization", "Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f"); response = invokeUrl [ url: "https://www.zohoapis.com/inventory/v1/purchasereceives/4815000000045035/approve/final?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/inventory/v1/purchasereceives/4815000000045035/approve/final?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/inventory/v1/purchasereceives/4815000000045035/approve/final?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", "/inventory/v1/purchasereceives/4815000000045035/approve/final?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": "/inventory/v1/purchasereceives/4815000000045035/approve/final?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/inventory/v1/purchasereceives/4815000000045035/approve/final?organization_id=10234695' \ --header 'Authorization: Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f'

Response Example

{ "code": 0, "message": "success" }

Reject a purchase receive 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

Reject a submitted purchase receive.
OAuth Scope : ZohoInventory.purchasereceives.UPDATE

Arguments

reason
string
Reason for rejecting the purchase receive. Max-length [500].

Path Parameters

purchasereceive_id
string
(Required)
Unique ID of the purchase receive.

Query Parameters

organization_id
string
(Required)
ID of the organization

Request Example

Click to copy
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/inventory/v1/purchasereceives/4815000000045035/reject?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/inventory/v1/purchasereceives/4815000000045035/reject?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/inventory/v1/purchasereceives/4815000000045035/reject?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", "/inventory/v1/purchasereceives/4815000000045035/reject?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": "/inventory/v1/purchasereceives/4815000000045035/reject?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/inventory/v1/purchasereceives/4815000000045035/reject?organization_id=10234695' \ --header 'Authorization: Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f' \ --header 'content-type: application/json' \ --data '{"field1":"value1","field2":"value2"}'

Body Parameters

Click to copy
{ "reason": "Items received do not match the purchase order." }

Response Example

{ "code": 0, "message": "success" }