Landed Costs 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 landed cost is the total cost incurred to bring an item to your warehouse, including the item price and additional charges such as shipping, customs duties, insurance, and handling. Use the Landed Costs APIs to allocate these additional charges across the line items of a bill, or to distribute a single charge across multiple bills, so that the inventory cost reflects the true cost of acquisition.

Download Landed Costs OpenAPI Document

End Points

POST

/bills/{bill_id}/landedcosts

PUT

/bills/{bill_id}/landedcosts/{landed_cost_id}

GET

/bills/{bill_id}/landedcosts/{landed_cost_id}

DELETE

/bills/{bill_id}/landedcosts/{landed_cost_id}

POST

/bills/bulklandedcosts

GET

/landedcosts/billdetails

Attribute

bill_id

string

Unique identifier of the bill that the landed cost belongs to.

bill_number

string

Number of the bill that the landed cost belongs to.

landed_cost_id

string

Unique identifier of the landed cost generated by the server.

vendor_id

string

Unique identifier of the vendor associated with the landed cost.

vendor_name

string

Display name of the vendor associated with the landed cost.

reference_entity_id

string

Unique identifier of the source transaction (for example, the bill or self-billed invoice) from which the landed cost is recorded.

reference_item_id

string

Unique identifier of the line item in the source transaction that represents the landed cost.

reference_entity_type

string

Type of the source transaction. Allowed values bill, bill_of_entry and self_billed_invoice.

reference_entity_number

string

Number of the source transaction (for example, the bill number) from which the landed cost is recorded.

price_precision

integer

Number of decimal places used to store the landed cost amounts.

amount

double

Total landed cost amount in the currency of the bill.

currency_id

string

Unique identifier of the currency in which the landed cost is recorded.

currency_code

string

ISO code of the currency in which the landed cost is recorded.

currency_symbol

string

Symbol of the currency in which the landed cost is recorded.

account_id

string

Unique identifier of the expense account against which the landed cost is recorded.

account_name

string

Name of the expense account against which the landed cost is recorded.

description

string

Description of the landed cost. Max length [100].

allocation_method

string

Method used to distribute the landed cost across the bill line items. Allowed values quantity, amount, dimension and weight.

cost_allocations

array

Distribution of the landed cost across the line items of the bill. Each entry contains the bill line item identifier and the amount allocated to it.

Show Sub-Attributes

bill_id

string

Unique identifier of the bill that the landed cost belongs to.

bill_item_id

string

Unique identifier of the bill line item that the landed cost is allocated to.

allocated_amount

double

Amount of the landed cost allocated to the bill line item, in the currency of the bill.

name

string

Name of the bill line item.

description

string

Description of the bill line item.

quantity

double

Quantity of the bill line item.

rate

double

Unit rate of the bill line item in the currency of the bill.

item_total

double

Sub-total of the bill line item in the currency of the bill.

package_details

object

Package dimensions and weight of the item, used when the allocation method is dimension or weight. Returned only when Zoho Inventory is enabled.

Show Sub-Attributes

length

double

Length of the item package.

width

double

Width of the item package.

height

double

Height of the item package.

weight

double

Weight of the item package.

weight_unit

string

Unit of measure for the package weight.

dimension_unit

string

Unit of measure for the package dimensions.

sales_rate

double

Updated sales rate for the bill line item after the landed cost is applied.

label_rate

double

Updated label (MRP) rate for the bill line item after the landed cost is applied. Returned only when MRP is enabled for the organization.

{
    "bill_id": "4815000000045067",
    "bill_number": "BILL-00045",
    "landed_cost_id": "4815000000049011",
    "vendor_id": "4815000000044080",
    "vendor_name": "Molly",
    "reference_entity_id": "4815000000045067",
    "reference_item_id": "4815000000045071",
    "reference_entity_type": "bill",
    "reference_entity_number": "BILL-00045",
    "price_precision": 2,
    "amount": 250,
    "currency_id": "4815000000044052",
    "currency_code": "USD",
    "currency_symbol": "$",
    "account_id": "4815000000035003",
    "account_name": "Freight and Forwarding Charges",
    "description": "Freight charges for the August shipment.",
    "allocation_method": "quantity",
    "cost_allocations": [
        {
            "bill_id": "4815000000045067",
            "bill_item_id": "4815000000045071",
            "allocated_amount": 100,
            "name": "Laptop-white/15inch/dell",
            "description": "Just a sample description.",
            "quantity": 2,
            "rate": 1200,
            "item_total": 2400,
            "package_details": {
                "length": 15,
                "width": 10,
                "height": 2,
                "weight": 1.5,
                "weight_unit": "kg",
                "dimension_unit": "cm"
            },
            "sales_rate": 0,
            "label_rate": 0
        }
    ]
}

Creates a landed cost for a bill. 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 landed cost for a bill. Use this to record additional charges such as shipping, customs, or handling against a bill, and allocate those charges across the line items of the bill using the chosen allocation method.
OAuth Scope : ZohoInventory.bills.CREATE

Arguments

vendor_id

string

Unique identifier of the vendor associated with the landed cost.

reference_entity_id

string

Unique identifier of the source transaction (for example, the bill or self-billed invoice) from which the landed cost is recorded.

reference_item_id

string

Unique identifier of the line item in the source transaction that represents the landed cost.

reference_entity_type

string

Type of the source transaction. Allowed values bill, bill_of_entry and self_billed_invoice.

account_id

string

Unique identifier of the expense account against which the landed cost is recorded.

description

string

Description of the landed cost. Max length [100].

allocation_method

string

Method used to distribute the landed cost across the bill line items. Allowed values quantity, amount, dimension and weight.

cost_allocations

array

(Required)

Distribution of the landed cost across the line items of the bill. At least one entry is required.

Show Sub-Attributes

bill_item_id

string

Unique identifier of the bill line item that the landed cost is allocated to.

allocated_amount

double

Amount of the landed cost allocated to the bill line item, in the currency of the bill.

sales_rate

double

Updated sales rate for the bill line item after the landed cost is applied.

label_rate

double

Updated label (MRP) rate for the bill line item after the landed cost is applied. Returned only when MRP is enabled for the organization.

Path Parameters

bill_id

string

(Required)

Unique identifier of the bill to which the landed cost is added.

Query Parameters

organization_id

string

(Required)

ID of the organization. Note: This value is a set of numeric characters.

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

{
    "vendor_id": "4815000000044080",
    "reference_entity_id": "4815000000045067",
    "reference_item_id": "4815000000045071",
    "reference_entity_type": "bill",
    "account_id": "4815000000035003",
    "description": "Freight charges for the August shipment.",
    "allocation_method": "quantity",
    "cost_allocations": [
        {
            "bill_item_id": "4815000000045071",
            "allocated_amount": 100,
            "sales_rate": 0,
            "label_rate": 0
        }
    ]
}

{
    "code": 0,
    "message": "The landed cost has been added.",
    "landed_cost": {
        "bill_id": "4815000000045067",
        "bill_number": "BILL-00045",
        "landed_cost_id": "4815000000049011",
        "vendor_id": "4815000000044080",
        "vendor_name": "Molly",
        "reference_entity_id": "4815000000045067",
        "reference_item_id": "4815000000045071",
        "reference_entity_type": "bill",
        "reference_entity_number": "BILL-00045",
        "price_precision": 2,
        "amount": 250,
        "currency_id": "4815000000044052",
        "currency_code": "USD",
        "currency_symbol": "$",
        "account_id": "4815000000035003",
        "account_name": "Freight and Forwarding Charges",
        "description": "Freight charges for the August shipment.",
        "allocation_method": "quantity",
        "cost_allocations": [
            {
                "bill_id": "4815000000045067",
                "bill_item_id": "4815000000045071",
                "allocated_amount": 100,
                "name": "Laptop-white/15inch/dell",
                "description": "Just a sample description.",
                "quantity": 2,
                "rate": 1200,
                "item_total": 2400,
                "package_details": {
                    "length": 15,
                    "width": 10,
                    "height": 2,
                    "weight": 1.5,
                    "weight_unit": "kg",
                    "dimension_unit": "cm"
                },
                "sales_rate": 0,
                "label_rate": 0
            }
        ]
    }
}

Updates an existing landed cost on a bill. 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 an existing landed cost on a bill. The full landed cost record, including its allocations across the bill line items, is replaced with the values provided in the request body.
OAuth Scope : ZohoInventory.bills.UPDATE

Path Parameters

bill_id

string

(Required)

Unique identifier of the bill that the landed cost belongs to.

landed_cost_id

string

(Required)

Unique identifier of the landed cost.

Query Parameters

organization_id

string

(Required)

ID of the organization. Note: This value is a set of numeric characters.

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

{
    "vendor_id": "4815000000044080",
    "reference_entity_id": "4815000000045067",
    "reference_item_id": "4815000000045071",
    "reference_entity_type": "bill",
    "account_id": "4815000000035003",
    "description": "Freight charges for the August shipment.",
    "allocation_method": "quantity",
    "cost_allocations": [
        {
            "bill_item_id": "4815000000045071",
            "allocated_amount": 100,
            "sales_rate": 0,
            "label_rate": 0
        }
    ]
}

{
    "code": 0,
    "message": "The landed cost has been updated.",
    "landed_cost": {
        "bill_id": "4815000000045067",
        "bill_number": "BILL-00045",
        "landed_cost_id": "4815000000049011",
        "vendor_id": "4815000000044080",
        "vendor_name": "Molly",
        "reference_entity_id": "4815000000045067",
        "reference_item_id": "4815000000045071",
        "reference_entity_type": "bill",
        "reference_entity_number": "BILL-00045",
        "price_precision": 2,
        "amount": 250,
        "currency_id": "4815000000044052",
        "currency_code": "USD",
        "currency_symbol": "$",
        "account_id": "4815000000035003",
        "account_name": "Freight and Forwarding Charges",
        "description": "Freight charges for the August shipment.",
        "allocation_method": "quantity",
        "cost_allocations": [
            {
                "bill_id": "4815000000045067",
                "bill_item_id": "4815000000045071",
                "allocated_amount": 100,
                "name": "Laptop-white/15inch/dell",
                "description": "Just a sample description.",
                "quantity": 2,
                "rate": 1200,
                "item_total": 2400,
                "package_details": {
                    "length": 15,
                    "width": 10,
                    "height": 2,
                    "weight": 1.5,
                    "weight_unit": "kg",
                    "dimension_unit": "cm"
                },
                "sales_rate": 0,
                "label_rate": 0
            }
        ]
    }
}

Retrieves the details of a specific landed cost 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

Retrieve the details of a specific landed cost recorded against a bill, including the cost allocations across the bill line items.
OAuth Scope : ZohoInventory.bills.READ

Path Parameters

bill_id

string

(Required)

Unique identifier of the bill that the landed cost belongs to.

landed_cost_id

string

(Required)

Unique identifier of the landed cost.

Query Parameters

organization_id

string

(Required)

ID of the organization. Note: This value is a set of numeric characters.

Request Example

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

{
    "code": 0,
    "message": "success",
    "landed_cost": {
        "bill_id": "4815000000045067",
        "bill_number": "BILL-00045",
        "landed_cost_id": "4815000000049011",
        "vendor_id": "4815000000044080",
        "vendor_name": "Molly",
        "reference_entity_id": "4815000000045067",
        "reference_item_id": "4815000000045071",
        "reference_entity_type": "bill",
        "reference_entity_number": "BILL-00045",
        "price_precision": 2,
        "amount": 250,
        "currency_id": "4815000000044052",
        "currency_code": "USD",
        "currency_symbol": "$",
        "account_id": "4815000000035003",
        "account_name": "Freight and Forwarding Charges",
        "description": "Freight charges for the August shipment.",
        "allocation_method": "quantity",
        "cost_allocations": [
            {
                "bill_id": "4815000000045067",
                "bill_item_id": "4815000000045071",
                "allocated_amount": 100,
                "name": "Laptop-white/15inch/dell",
                "description": "Just a sample description.",
                "quantity": 2,
                "rate": 1200,
                "item_total": 2400,
                "package_details": {
                    "length": 15,
                    "width": 10,
                    "height": 2,
                    "weight": 1.5,
                    "weight_unit": "kg",
                    "dimension_unit": "cm"
                },
                "sales_rate": 0,
                "label_rate": 0
            }
        ]
    }
}

Deletes a landed cost from a bill. 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 a landed cost from a bill. The allocated amounts are removed from the bill line items.
OAuth Scope : ZohoInventory.bills.DELETE

Path Parameters

bill_id

string

(Required)

Unique identifier of the bill that the landed cost belongs to.

landed_cost_id

string

(Required)

Unique identifier of the landed cost.

Query Parameters

organization_id

string

(Required)

ID of the organization. Note: This value is a set of numeric characters.

Request Example

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

{
    "code": 0,
    "message": "The landed cost has been deleted."
}

Create bulk landed costs 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 landed cost from a single source transaction (such as a bill, bill of entry, or self-billed invoice) and allocate it across multiple bills in one call. Use this when a single charge, for example a freight invoice, needs to be distributed across more than one downstream bill.
OAuth Scope : ZohoInventory.bills.CREATE

Arguments

reference_entity_id

string

Unique identifier of the source transaction (for example, the bill or self-billed invoice) from which the landed cost is recorded.

reference_item_id

string

Unique identifier of the line item in the source transaction that represents the landed cost.

reference_entity_type

string

Type of the source transaction from which the bulk landed cost is recorded. Allowed values bill, bill_of_entry and self_billed_invoice.

account_id

string

Unique identifier of the expense account against which the landed cost is recorded.

description

string

Description of the bulk landed cost.

allocation_method

string

Method used to distribute the landed cost across the bill line items. Allowed values quantity, amount, dimension and weight.

bills

array

Bills that the landed cost is allocated to. A maximum of 100 bills can be passed in a single call.

Show Sub-Attributes

bill_id

string

Unique identifier of the bill that the landed cost is being allocated to.

vendor_id

string

Unique identifier of the vendor associated with the landed cost.

cost_allocations

array

Distribution of the landed cost across the line items of the bill. At least one entry is required.

Show Sub-Attributes

bill_item_id

string

Unique identifier of the bill line item.

allocated_amount

double

Amount of the landed cost allocated to the bill line item, in the currency of the bill.

Query Parameters

organization_id

string

(Required)

ID of the organization. Note: This value is a set of numeric characters.

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

{
    "reference_entity_id": "4815000000045067",
    "reference_item_id": "4815000000045071",
    "reference_entity_type": "bill",
    "account_id": "4815000000035003",
    "description": "Freight charges allocated across August shipments.",
    "allocation_method": "quantity",
    "bills": [
        {
            "bill_id": "4815000000045067",
            "vendor_id": "4815000000044080",
            "cost_allocations": [
                {
                    "bill_item_id": "4815000000045071",
                    "allocated_amount": 100
                }
            ]
        }
    ]
}

{
    "code": 0,
    "message": "The landed cost has been added."
}

Get bill details for bulk landed cost 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

Retrieve the bill and line item details for one or more bills. Use this before calling the bulk landed cost endpoint to fetch the bill items that the landed cost can be allocated against.
OAuth Scope : ZohoInventory.bills.READ

Query Parameters

organization_id

string

(Required)

ID of the organization. Note: This value is a set of numeric characters.

bill_ids

string

(Required)

Comma-separated list of bill IDs whose details are to be fetched. A maximum of 200 bill IDs can be passed in a single call.

Request Example

headers_data = Map();
headers_data.put("Authorization", "Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f");
response = invokeUrl
[
url: "https://www.zohoapis.com/inventory/v1/landedcosts/billdetails?organization_id=10234695&bill_ids=4815000000045067,4815000000045079"
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/landedcosts/billdetails?organization_id=10234695&bill_ids=4815000000045067%2C4815000000045079")
  .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/landedcosts/billdetails?organization_id=10234695&bill_ids=4815000000045067%2C4815000000045079', 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/landedcosts/billdetails?organization_id=10234695&bill_ids=4815000000045067%2C4815000000045079", 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/landedcosts/billdetails?organization_id=10234695&bill_ids=4815000000045067%2C4815000000045079",
  "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/landedcosts/billdetails?organization_id=10234695&bill_ids=4815000000045067%2C4815000000045079' \
  --header 'Authorization: Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f'

{
    "code": 0,
    "message": "success",
    "bills": [
        {
            "bill_id": "4815000000045067",
            "bill_number": "BILL-00045",
            "date": "2015-05-28",
            "vendor_id": "4815000000044080",
            "vendor_name": "Molly",
            "status": "open",
            "total": 2400,
            "currency_id": "4815000000044052",
            "currency_code": "USD",
            "currency_symbol": "$",
            "exchange_rate": 1,
            "price_precision": 2,
            "line_items": [
                {
                    "bill_id": "4815000000045067",
                    "bill_item_id": "4815000000045071",
                    "item_id": "4815000000044100",
                    "name": "Laptop-white/15inch/dell",
                    "sku": "SKU-001",
                    "description": "Just a sample description.",
                    "quantity": 2,
                    "unit": "qty",
                    "item_total": 2400,
                    "package_details": {
                        "length": 15,
                        "width": 10,
                        "height": 2,
                        "weight": 1.5,
                        "weight_unit": "kg",
                        "dimension_unit": "cm"
                    }
                }
            ]
        },
        {...},
        {...}
    ]
}

Landed Costs 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

Creates a landed cost for a bill. 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

Path Parameters

Query Parameters

Path Parameters

Query Parameters

Deletes a landed cost from a bill. 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

Create bulk landed costs 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

Query Parameters

Landed Costs 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 bulk landed costs 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