Bills

When your vendor supplies goods/services to you on credit, you’re sent an invoice that details the amount of money you owe him. You can record this as a bill in Zakya and track it until it’s paid.

Attribute

  • bill_idlong

    Unique ID generated by the server. This is used as identifier.

  • purchaseorder_idlong

    Unique ID generated by the server for the Purchase Order.

  • vendor_idlong

    Unique ID generated by the server for the vendor.

  • vendor_namestring

    Name of the vendor.

  • unused_credits_payable_amountdouble

    Unused credit payable amount.

  • statusstring

    Status of the Bill.

  • bill_numberstring

    Bill number of Purchase Order.

  • datestring

    Date of the Bill.

  • due_datestring

    Due date for the Bill.

  • reference_numberstring

    Reference number for the Bill.

  • due_by_daysinteger

    Number of days by which the Bill is due.

  • currency_idlong

    Unique ID generated by the server for the currency. This is used as an identifier.

  • currency_codestring

    Currency code.

  • currency_symbolstring

    The symbol for the selected currency.

  • price_precisioninteger

    The precision level for the price's decimal point in a Bill.

  • exchange_ratedouble

    Exchange rate of the currency, with respect to the base currency.

  • is_item_level_tax_calcboolean

    Checks whether item level tax is calculated or not.

  • line_itemsarray

    The line items for a Bill.

    Show Sub-Attributes

    • purchaseorder_item_idlong

      Unique ID generated for a line item in the Purchase Order.

    • receive_item_idlong

      Unique ID generated by the server for the receive.

    • line_item_idlong

      Unique ID generated by the server for each line item. This is used as an identifier.

    • namestring

      Name of the line item.

    • account_idlong

      Account ID of the item.

    • account_namestring

      Name of the account.

    • descriptionstring

      Description for the line item.

    • bcy_ratedouble

      Item rate in the organization's base currency.

    • ratedouble

      Item's Puchase Price.

    • quantitydouble

      Quantity of the Item.

    • tax_idlong

      Unique ID of the tax applied on the line item.

    • tax_namestring

      Name of the tax.

    • tax_typestring

      Type of the tax

    • tax_percentagedouble

      Percentage of the tax applied.

    • item_totaldouble

      The total for the items.

    • item_orderdouble

      Order of the line item, starting from 0.

    • unitstring

      Unit of the item.

    • image_iddouble

      Unique ID generated by the server for the item image. This is used an identifier.

    • image_namestring

      Name of the image of the line item.

    • image_typestring

      The type (file format) of the image.

    • reverse_charge_tax_idstring

      Reverse charge tax ID

    • reverse_charge_tax_namestring

      Name of the reverse charge tax

    • reverse_charge_tax_percentagedouble

      Enter reverse charge percentage

    • reverse_charge_tax_amountdouble

      Enter reverse charge amount

    • hsn_or_sacstring

      Add HSN/SAC code for your goods/services

    • tax_exemption_codestring

      Code of the Tax Exemption Applied

    • warehouse_idlong

      Unique ID generated by the server for the ware houses

    • tax_exemption_idstring

      ID of the Tax Exemption Applied

  • taxesarray

    Number of taxes applied on the Purchase Order. Each tax contains: tax_name and tax_amount.

    Show Sub-Attributes

    • tax_namestring

      Name of the tax.

    • tax_amountdouble

      Amount of the tax.

  • vendor_credits_applieddouble

    Vendor credits applied to the Bill.

  • sub_totaldouble

    Sub Total of the Bill.

  • tax_totaldouble

    The total of the Tax.

  • balancedouble

    Remaining balance of the Bill.

  • billing_addressarray

    Customer's billing address. It contains - address, city, state, zip, country and fax.

    Show Sub-Attributes

    • addressstring

      Name of the street of the customer’s billing address.

    • citystring

      Name of the city of the customer’s billing address.

    • statestring

      Name of the state of the customer's billing address.

    • zipstring

      Zip code of the customer’s billing address.

    • faxstring

      Fax number of the customer’s billing address.

  • paymentsarray

    Payment details for the Bill.

    Show Sub-Attributes

    • payment_idlong

      Unique ID generated by the server. This is used as identifier.

    • bill_idlong

      Unique ID generated by the server. This is used as identifier.

    • bill_payment_idlong

      Bill payment ID

    • payment_modestring

      Mode of payment for the Bill.

    • payment_numberstring

      Number of the payment.

    • descriptionstring

      Description for the line item.

    • datestring

      Date of the Bill.

    • reference_numberstring

      Reference number for the Bill.

    • exchange_ratedouble

      Exchange rate of the currency, with respect to the base currency.

    • amountdouble

      Amount paid for the payment.

    • paid_through_account_idlong

      ID for the account through which the payment is made.

    • paid_through_account_namestring

      Name of the account.

    • is_single_bill_paymentboolean

      Checks whether the payment is for single bills or multiple bills.

  • vendor_creditsarray

    The available Vendor Credits.

    Show Sub-Attributes

    • vendor_credit_idlong

      Unique ID generated by server for vendor credits

    • vendor_credit_bill_idlong

      Unique ID generated by server for vendor credit bills

    • vendor_credit_numberlong
    • datestring

      Date of the Bill.

    • amountdouble

      Amount paid for the payment.

  • created_timestring

    Time at which the Bill details were last created.

  • last_modified_timestring

    Time at which the bill details were last Modified.

  • reference_idlong

    Unique ID generated by the server for the reference.

  • notesstring

    Notes for the Bill.

  • termsstring

    Terms and conditions.

  • attachment_namestring

    Name of the attached file.

  • open_purchaseorders_countinteger

    Number of Purchase Orders that are associated with this Bill and open.

  • gst_treatmentstring

    Choose whether the contact is GST registered/unregistered/consumer/overseas. Allowed values are business_gst , business_none , overseas , consumer .

  • gst_nostring

    15 digit GST identification number of the vendor.

  • source_of_supplystring

    Place from where the goods/services are supplied. (If not given, place of contact given for the contact will be taken)

  • destination_of_supplystring

    Place where the goods/services are supplied to. (If not given, organisation's home state will be taken)

  • is_pre_gstboolean

    Applicable for transactions that fall before july 1, 2017

  • is_reverse_charge_appliedboolean

    Applicable for transactions where you pay reverse charge

ExampleCopy
{
    "bill_id": 4815000000045067,
    "purchaseorder_id": 4815000000044972,
    "vendor_id": 4815000000044080,
    "vendor_name": "Molly",
    "unused_credits_payable_amount": 0,
    "status": "paid",
    "bill_number": "BL-00002",
    "date": "2015-05-29",
    "due_date": "2015-05-29",
    "reference_number": "PO-00003",
    "due_by_days": 69,
    "currency_id": 4815000000000097,
    "currency_code": "USD",
    "currency_symbol": "$",
    "price_precision": 2,
    "exchange_rate": 1,
    "is_item_level_tax_calc": true,
    "line_items": [
        {
            "purchaseorder_item_id": 4815000000045245,
            "receive_item_id": 4815000000044131,
            "line_item_id": 4815000000044897,
            "name": "Laptop-white/15inch/dell",
            "account_id": 4815000000035003,
            "account_name": "Inventory Asset",
            "description": "Sample Description",
            "bcy_rate": 122,
            "rate": 6,
            "quantity": 5,
            "tax_id": 4815000000044043,
            "tax_name": "Purchase tax",
            "tax_type": "Tax group",
            "tax_percentage": 12,
            "item_total": 290,
            "item_order": 0,
            "unit": "qty",
            "image_id": 2077500000000002000,
            "image_name": "dell.jpg",
            "image_type": "jpg",
            "reverse_charge_tax_id": 460000000038056,
            "reverse_charge_tax_name": "inter",
            "reverse_charge_tax_percentage": 10,
            "reverse_charge_tax_amount": 100,
            "hsn_or_sac": 80540,
            "tax_exemption_code": "string",
            "warehouse_id": 130426000000664020,
            "tax_exemption_id": "string"
        }
    ],
    "taxes": [
        {
            "tax_name": "Purchase tax",
            "tax_amount": 29
        }
    ],
    "vendor_credits_applied": 24,
    "sub_total": 30,
    "tax_total": 2,
    "balance": 0,
    "billing_address": [
        {
            "address": "No:234,90 Church Street",
            "city": "New York City",
            "state": "New York",
            "zip": 10048,
            "fax": "324-524242"
        }
    ],
    "payments": [
        {
            "payment_id": 4815000000046039,
            "bill_id": 4815000000045067,
            "bill_payment_id": 4815000000046041,
            "payment_mode": "Cash",
            "payment_number": 2,
            "description": "Sample Description",
            "date": "2015-05-29",
            "reference_number": "PO-00003",
            "exchange_rate": 1,
            "amount": 234,
            "paid_through_account_id": 4815000000000361,
            "paid_through_account_name": "Petty Cash",
            "is_single_bill_payment": true
        }
    ],
    "vendor_credits": [
        {
            "vendor_credit_id": 4815000000046039,
            "vendor_credit_bill_id": 4815000000768039,
            "vendor_credit_number": 67258,
            "date": "2015-05-29",
            "amount": 234
        }
    ],
    "created_time": "2015-05-29T00:00:00.000Z",
    "last_modified_time": "2015-05-29T00:00:00.000Z",
    "reference_id": 4815000000000342,
    "notes": "Sample Note",
    "terms": "Term & Conditions",
    "attachment_name": "sample-attachments",
    "open_purchaseorders_count": 4,
    "gst_treatment": "business_gst",
    "gst_no": "22AAAAA0000A1Z5",
    "source_of_supply": "AP",
    "destination_of_supply": "TN",
    "is_pre_gst": false,
    "is_reverse_charge_applied": true
}

Create a Bill

Creates a Bill in Zakya. Description about the extra parameter attachment Allowed extensions are gif, png, jpeg, jpg, bmp and pdf.

OAuth Scope : ZakyaAPI.bills.CREATE

Arguments

  • purchaseorder_idlong

    Unique ID generated by the server for the Purchase Order.

  • vendor_idlong (Required)

    Unique ID generated by the server for the vendor.

  • bill_numberstring (Required)

    Bill number of Purchase Order.

  • datestring (Required)

    Date of the Bill.

  • due_datestring (Required)

    Due date for the Bill.

  • reference_numberstring

    Reference number for the Bill.

  • currency_idlong

    Unique ID generated by the server for the currency. This is used as an identifier.

  • exchange_ratedouble

    Exchange rate of the currency, with respect to the base currency.

  • is_item_level_tax_calcboolean

    Checks whether item level tax is calculated or not.

  • notesstring

    Notes for the Bill.

  • termsstring

    Terms and conditions.

  • is_inclusive_taxboolean

    Indicates whether the item rates are tax inclusive or exclusive

  • line_itemsarray (Required)

    The line items for a Bill.

    Show Sub-Attributes

    • purchaseorder_item_idlong

      Unique ID generated for a line item in the Purchase Order.

    • receive_item_idlong

      Unique ID generated by the server for the receive.

    • line_item_idlong

      Unique ID generated by the server for each line item. This is used as an identifier.

    • namestring

      Name of the line item.

    • account_idlong

      Account ID of the item.

    • account_namestring

      Name of the account.

    • descriptionstring

      Description for the line item.

    • bcy_ratedouble

      Item rate in the organization's base currency.

    • ratedouble

      Item's Puchase Price.

    • quantitydouble

      Quantity of the Item.

    • tax_idlong

      Unique ID of the tax applied on the line item.

    • tax_namestring

      Name of the tax.

    • tax_typestring

      Type of the tax

    • tax_percentagedouble

      Percentage of the tax applied.

    • item_totaldouble

      The total for the items.

    • item_orderdouble

      Order of the line item, starting from 0.

    • unitstring

      Unit of the item.

    • image_iddouble

      Unique ID generated by the server for the item image. This is used an identifier.

    • image_namestring

      Name of the image of the line item.

    • image_typestring

      The type (file format) of the image.

    • reverse_charge_tax_idstring

      Reverse charge tax ID

    • hsn_or_sacstring

      Add HSN/SAC code for your goods/services

    • tax_exemption_codestring

      Code of the Tax Exemption Applied

    • warehouse_idlong

      Unique ID generated by the server for the ware houses

    • tax_exemption_idstring

      ID of the Tax Exemption Applied

  • gst_treatmentstring

    Choose whether the contact is GST registered/unregistered/consumer/overseas. Allowed values are business_gst , business_none , overseas , consumer .

  • gst_nostring

    15 digit GST identification number of the vendor.

  • source_of_supplystring

    Place from where the goods/services are supplied. (If not given, place of contact given for the contact will be taken)

  • destination_of_supplystring

    Place where the goods/services are supplied to. (If not given, organisation's home state will be taken)

Request ExampleCopy
curl --request POST \
  --url 'https://api.zakya.com/inventory/v1/bills?organization_id=10234695' \
  --header 'Authorization: Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f' \
  --header 'content-type: application/json' \
  --data '{"field1":"value1","field2":"value2"}'
parameters_data='{"field1":"value1","field2":"value2"}';
headers_data = Map();
headers_data.put("Authorization", "Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f");
response = invokeUrl
[
url: "https://api.zakya.com/inventory/v1/bills?organization_id=10234695"
type: POST
headers: headers_data
content-type: application/json
parameters: parameters_data
connection: 
]
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://api.zakya.com/inventory/v1/bills?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 http = require("https");

const options = {
  "method": "POST",
  "hostname": "api.zakya.com",
  "port": null,
  "path": "/inventory/v1/bills?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();
const options = {
  method: 'POST',
  headers: {
    Authorization: 'Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f',
    'content-type': 'application/json'
  },
  body: '{"field1":"value1","field2":"value2"}'
};

fetch('https://api.zakya.com/inventory/v1/bills?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("api.zakya.com")

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

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

conn.request("POST", "/inventory/v1/bills?organization_id=10234695", payload, headers)

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

print(data.decode("utf-8"))
Body ParametersCopy
{
    "purchaseorder_id": 4815000000044972,
    "vendor_id": 4815000000044080,
    "bill_number": "BL-00002",
    "date": "2015-05-29",
    "due_date": "2015-05-29",
    "reference_number": "PO-00003",
    "currency_id": 4815000000000097,
    "exchange_rate": 1,
    "is_item_level_tax_calc": true,
    "notes": "Sample Note",
    "terms": "Term & Conditions",
    "is_inclusive_tax": false,
    "line_items": [
        {
            "purchaseorder_item_id": 4815000000045245,
            "receive_item_id": 4815000000044131,
            "line_item_id": 4815000000044897,
            "name": "Laptop-white/15inch/dell",
            "account_id": 4815000000035003,
            "account_name": "Inventory Asset",
            "description": "Sample Description",
            "bcy_rate": 122,
            "rate": 6,
            "quantity": 5,
            "tax_id": 4815000000044043,
            "tax_name": "Purchase tax",
            "tax_type": "Tax group",
            "tax_percentage": 12,
            "item_total": 290,
            "item_order": 0,
            "unit": "qty",
            "image_id": 2077500000000002000,
            "image_name": "dell.jpg",
            "image_type": "jpg",
            "reverse_charge_tax_id": 460000000038056,
            "hsn_or_sac": 80540,
            "tax_exemption_code": "string",
            "warehouse_id": 130426000000664020,
            "tax_exemption_id": "string"
        }
    ],
    "gst_treatment": "business_gst",
    "gst_no": "22AAAAA0000A1Z5",
    "source_of_supply": "AP",
    "destination_of_supply": "TN"
}
Response ExampleCopy
{
    "code": 0,
    "message": "The Bill has been created.",
    "bill": {
        "bill_id": 4815000000045067,
        "purchaseorder_id": 4815000000044972,
        "vendor_id": 4815000000044080,
        "vendor_name": "Molly",
        "unused_credits_payable_amount": 0,
        "status": "paid",
        "bill_number": "BL-00002",
        "date": "2015-05-29",
        "due_date": "2015-05-29",
        "reference_number": "PO-00003",
        "due_by_days": 69,
        "currency_id": 4815000000000097,
        "currency_code": "USD",
        "currency_symbol": "$",
        "price_precision": 2,
        "exchange_rate": 1,
        "is_item_level_tax_calc": true,
        "line_items": [
            {
                "purchaseorder_item_id": 4815000000045245,
                "receive_item_id": 4815000000044131,
                "line_item_id": 4815000000044897,
                "name": "Laptop-white/15inch/dell",
                "account_id": 4815000000035003,
                "account_name": "Inventory Asset",
                "description": "Sample Description",
                "bcy_rate": 122,
                "rate": 6,
                "quantity": 5,
                "tax_id": 4815000000044043,
                "tax_name": "Purchase tax",
                "tax_type": "Tax group",
                "tax_percentage": 12,
                "item_total": 290,
                "item_order": 0,
                "unit": "qty",
                "image_id": 2077500000000002000,
                "image_name": "dell.jpg",
                "image_type": "jpg",
                "reverse_charge_tax_id": 460000000038056,
                "reverse_charge_tax_name": "inter",
                "reverse_charge_tax_percentage": 10,
                "reverse_charge_tax_amount": 100,
                "hsn_or_sac": 80540,
                "tax_exemption_code": "string",
                "warehouse_id": 130426000000664020,
                "tax_exemption_id": "string"
            }
        ],
        "taxes": [
            {
                "tax_name": "Purchase tax",
                "tax_amount": 29
            }
        ],
        "vendor_credits_applied": 24,
        "sub_total": 30,
        "tax_total": 2,
        "balance": 0,
        "billing_address": [
            {
                "address": "No:234,90 Church Street",
                "city": "New York City",
                "state": "New York",
                "zip": 10048,
                "fax": "324-524242"
            }
        ],
        "payments": [
            {
                "payment_id": 4815000000046039,
                "bill_id": 4815000000045067,
                "bill_payment_id": 4815000000046041,
                "payment_mode": "Cash",
                "payment_number": 2,
                "description": "Sample Description",
                "date": "2015-05-29",
                "reference_number": "PO-00003",
                "exchange_rate": 1,
                "amount": 234,
                "paid_through_account_id": 4815000000000361,
                "paid_through_account_name": "Petty Cash",
                "is_single_bill_payment": true
            }
        ],
        "vendor_credits": [
            {
                "vendor_credit_id": 4815000000046039,
                "vendor_credit_bill_id": 4815000000768039,
                "vendor_credit_number": 67258,
                "date": "2015-05-29",
                "amount": 234
            }
        ],
        "created_time": "2015-05-29T00:00:00.000Z",
        "last_modified_time": "2015-05-29T00:00:00.000Z",
        "reference_id": 4815000000000342,
        "notes": "Sample Note",
        "terms": "Term & Conditions",
        "attachment_name": "sample-attachments",
        "open_purchaseorders_count": 4,
        "gst_treatment": "business_gst",
        "gst_no": "22AAAAA0000A1Z5",
        "source_of_supply": "AP",
        "destination_of_supply": "TN",
        "is_pre_gst": false,
        "is_reverse_charge_applied": true
    }
}

List all Bills.

Lists all the Bills in Zakya.

OAuth Scope : ZakyaAPI.bills.READ

Request ExampleCopy
curl --request GET \
  --url 'https://api.zakya.com/inventory/v1/bills?organization_id=10234695' \
  --header 'Authorization: Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f'
headers_data = Map();
headers_data.put("Authorization", "Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f");
response = invokeUrl
[
url: "https://api.zakya.com/inventory/v1/bills?organization_id=10234695"
type: GET
headers: headers_data
connection: 
]
info response;
OkHttpClient client = new OkHttpClient();

Request request = new Request.Builder()
  .url("https://api.zakya.com/inventory/v1/bills?organization_id=10234695")
  .get()
  .addHeader("Authorization", "Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f")
  .build();

Response response = client.newCall(request).execute();
const http = require("https");

const options = {
  "method": "GET",
  "hostname": "api.zakya.com",
  "port": null,
  "path": "/inventory/v1/bills?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();
const options = {
  method: 'GET',
  headers: {
    Authorization: 'Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f'
  }
};

fetch('https://api.zakya.com/inventory/v1/bills?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("api.zakya.com")

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

conn.request("GET", "/inventory/v1/bills?organization_id=10234695", headers=headers)

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

print(data.decode("utf-8"))
Response ExampleCopy
{
    "code": 0,
    "message": "success",
    "bills": [
        {
            "bill_id": 4815000000045067,
            "purchaseorder_id": 4815000000044972,
            "vendor_id": 4815000000044080,
            "vendor_name": "Molly",
            "unused_credits_payable_amount": 0,
            "status": "paid",
            "bill_number": "BL-00002",
            "date": "2015-05-29",
            "due_date": "2015-05-29",
            "reference_number": "PO-00003",
            "due_by_days": 69,
            "currency_id": 4815000000000097,
            "currency_code": "USD",
            "currency_symbol": "$",
            "price_precision": 2,
            "exchange_rate": 1,
            "is_item_level_tax_calc": true,
            "line_items": [
                {
                    "purchaseorder_item_id": 4815000000045245,
                    "receive_item_id": 4815000000044131,
                    "line_item_id": 4815000000044897,
                    "name": "Laptop-white/15inch/dell",
                    "account_id": 4815000000035003,
                    "account_name": "Inventory Asset",
                    "description": "Sample Description",
                    "bcy_rate": 122,
                    "rate": 6,
                    "quantity": 5,
                    "tax_id": 4815000000044043,
                    "tax_name": "Purchase tax",
                    "tax_type": "Tax group",
                    "tax_percentage": 12,
                    "item_total": 290,
                    "item_order": 0,
                    "unit": "qty",
                    "image_id": 2077500000000002000,
                    "image_name": "dell.jpg",
                    "image_type": "jpg",
                    "reverse_charge_tax_id": 460000000038056,
                    "reverse_charge_tax_name": "inter",
                    "reverse_charge_tax_percentage": 10,
                    "reverse_charge_tax_amount": 100,
                    "hsn_or_sac": 80540,
                    "tax_exemption_code": "string",
                    "warehouse_id": 130426000000664020,
                    "tax_exemption_id": "string"
                }
            ],
            "taxes": [
                {
                    "tax_name": "Purchase tax",
                    "tax_amount": 29
                }
            ],
            "vendor_credits_applied": 24,
            "sub_total": 30,
            "tax_total": 2,
            "balance": 0,
            "billing_address": [
                {
                    "address": "No:234,90 Church Street",
                    "city": "New York City",
                    "state": "New York",
                    "zip": 10048,
                    "fax": "324-524242"
                }
            ],
            "payments": [
                {
                    "payment_id": 4815000000046039,
                    "bill_id": 4815000000045067,
                    "bill_payment_id": 4815000000046041,
                    "payment_mode": "Cash",
                    "payment_number": 2,
                    "description": "Sample Description",
                    "date": "2015-05-29",
                    "reference_number": "PO-00003",
                    "exchange_rate": 1,
                    "amount": 234,
                    "paid_through_account_id": 4815000000000361,
                    "paid_through_account_name": "Petty Cash",
                    "is_single_bill_payment": true
                }
            ],
            "vendor_credits": [
                {
                    "vendor_credit_id": 4815000000046039,
                    "vendor_credit_bill_id": 4815000000768039,
                    "vendor_credit_number": 67258,
                    "date": "2015-05-29",
                    "amount": 234
                }
            ],
            "created_time": "2015-05-29T00:00:00.000Z",
            "last_modified_time": "2015-05-29T00:00:00.000Z",
            "reference_id": 4815000000000342,
            "notes": "Sample Note",
            "terms": "Term & Conditions",
            "attachment_name": "sample-attachments",
            "open_purchaseorders_count": 4
        },
        {...},
        {...}
    ]
}

Update a Bill

Updates the details of an existing Bill.

OAuth Scope : ZakyaAPI.bills.UPDATE

Arguments

  • purchaseorder_idlong

    Unique ID generated by the server for the Purchase Order.

  • vendor_idlong (Required)

    Unique ID generated by the server for the vendor.

  • bill_numberstring (Required)

    Bill number of Purchase Order.

  • datestring (Required)

    Date of the Bill.

  • due_datestring (Required)

    Due date for the Bill.

  • reference_numberstring

    Reference number for the Bill.

  • currency_idlong

    Unique ID generated by the server for the currency. This is used as an identifier.

  • exchange_ratedouble

    Exchange rate of the currency, with respect to the base currency.

  • is_item_level_tax_calcboolean

    Checks whether item level tax is calculated or not.

  • notesstring

    Notes for the Bill.

  • termsstring

    Terms and conditions.

  • is_inclusive_taxboolean

    Indicates whether the item rates are tax inclusive or exclusive

  • line_itemsarray (Required)

    The line items for a Bill.

    Show Sub-Attributes

    • purchaseorder_item_idlong

      Unique ID generated for a line item in the Purchase Order.

    • receive_item_idlong

      Unique ID generated by the server for the receive.

    • line_item_idlong

      Unique ID generated by the server for each line item. This is used as an identifier.

    • namestring

      Name of the line item.

    • account_idlong

      Account ID of the item.

    • account_namestring

      Name of the account.

    • descriptionstring

      Description for the line item.

    • bcy_ratedouble

      Item rate in the organization's base currency.

    • ratedouble

      Item's Puchase Price.

    • quantitydouble

      Quantity of the Item.

    • tax_idlong

      Unique ID of the tax applied on the line item.

    • tax_namestring

      Name of the tax.

    • tax_typestring

      Type of the tax

    • tax_percentagedouble

      Percentage of the tax applied.

    • item_totaldouble

      The total for the items.

    • item_orderdouble

      Order of the line item, starting from 0.

    • unitstring

      Unit of the item.

    • image_iddouble

      Unique ID generated by the server for the item image. This is used an identifier.

    • image_namestring

      Name of the image of the line item.

    • image_typestring

      The type (file format) of the image.

    • reverse_charge_tax_idstring

      Reverse charge tax ID

    • hsn_or_sacstring

      Add HSN/SAC code for your goods/services

    • tax_exemption_codestring

      Code of the Tax Exemption Applied

    • warehouse_idlong

      Unique ID generated by the server for the ware houses

    • tax_exemption_idstring

      ID of the Tax Exemption Applied

  • gst_treatmentstring

    Choose whether the contact is GST registered/unregistered/consumer/overseas. Allowed values are business_gst , business_none , overseas , consumer .

  • gst_nostring

    15 digit GST identification number of the vendor.

  • source_of_supplystring

    Place from where the goods/services are supplied. (If not given, place of contact given for the contact will be taken)

  • destination_of_supplystring

    Place where the goods/services are supplied to. (If not given, organisation's home state will be taken)

  • is_pre_gstboolean

    Applicable for transactions that fall before july 1, 2017

  • is_reverse_charge_appliedboolean

    Applicable for transactions where you pay reverse charge

Request ExampleCopy
curl --request PUT \
  --url 'https://api.zakya.com/inventory/v1/bills/4815000000045067?organization_id=10234695' \
  --header 'Authorization: Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f' \
  --header 'content-type: application/json' \
  --data '{"field1":"value1","field2":"value2"}'
parameters_data='{"field1":"value1","field2":"value2"}';
headers_data = Map();
headers_data.put("Authorization", "Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f");
response = invokeUrl
[
url: "https://api.zakya.com/inventory/v1/bills/4815000000045067?organization_id=10234695"
type: PUT
headers: headers_data
content-type: application/json
parameters: parameters_data
connection: 
]
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://api.zakya.com/inventory/v1/bills/4815000000045067?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 http = require("https");

const options = {
  "method": "PUT",
  "hostname": "api.zakya.com",
  "port": null,
  "path": "/inventory/v1/bills/4815000000045067?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();
const options = {
  method: 'PUT',
  headers: {
    Authorization: 'Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f',
    'content-type': 'application/json'
  },
  body: '{"field1":"value1","field2":"value2"}'
};

fetch('https://api.zakya.com/inventory/v1/bills/4815000000045067?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("api.zakya.com")

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

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

conn.request("PUT", "/inventory/v1/bills/4815000000045067?organization_id=10234695", payload, headers)

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

print(data.decode("utf-8"))
Body ParametersCopy
{
    "purchaseorder_id": 4815000000044972,
    "vendor_id": 4815000000044080,
    "bill_number": "BL-00002",
    "date": "2015-05-29",
    "due_date": "2015-05-29",
    "reference_number": "PO-00003",
    "currency_id": 4815000000000097,
    "exchange_rate": 1,
    "is_item_level_tax_calc": true,
    "notes": "Sample Note",
    "terms": "Term & Conditions",
    "is_inclusive_tax": false,
    "line_items": [
        {
            "purchaseorder_item_id": 4815000000045245,
            "receive_item_id": 4815000000044131,
            "line_item_id": 4815000000044897,
            "name": "Laptop-white/15inch/dell",
            "account_id": 4815000000035003,
            "account_name": "Inventory Asset",
            "description": "Sample Description",
            "bcy_rate": 122,
            "rate": 6,
            "quantity": 5,
            "tax_id": 4815000000044043,
            "tax_name": "Purchase tax",
            "tax_type": "Tax group",
            "tax_percentage": 12,
            "item_total": 290,
            "item_order": 0,
            "unit": "qty",
            "image_id": 2077500000000002000,
            "image_name": "dell.jpg",
            "image_type": "jpg",
            "reverse_charge_tax_id": 460000000038056,
            "hsn_or_sac": 80540,
            "tax_exemption_code": "string",
            "warehouse_id": 130426000000664020,
            "tax_exemption_id": "string"
        }
    ],
    "gst_treatment": "business_gst",
    "gst_no": "22AAAAA0000A1Z5",
    "source_of_supply": "AP",
    "destination_of_supply": "TN",
    "is_pre_gst": false,
    "is_reverse_charge_applied": true
}
Response ExampleCopy
{
    "code": 0,
    "message": "The Bill has been updated.",
    "bill": {
        "bill_id": 4815000000045067,
        "purchaseorder_id": 4815000000044972,
        "vendor_id": 4815000000044080,
        "vendor_name": "Molly",
        "unused_credits_payable_amount": 0,
        "status": "paid",
        "bill_number": "BL-00002",
        "date": "2015-05-29",
        "due_date": "2015-05-29",
        "reference_number": "PO-00003",
        "due_by_days": 69,
        "currency_id": 4815000000000097,
        "currency_code": "USD",
        "currency_symbol": "$",
        "price_precision": 2,
        "exchange_rate": 1,
        "is_item_level_tax_calc": true,
        "line_items": [
            {
                "purchaseorder_item_id": 4815000000045245,
                "receive_item_id": 4815000000044131,
                "line_item_id": 4815000000044897,
                "name": "Laptop-white/15inch/dell",
                "account_id": 4815000000035003,
                "account_name": "Inventory Asset",
                "description": "Sample Description",
                "bcy_rate": 122,
                "rate": 6,
                "quantity": 5,
                "tax_id": 4815000000044043,
                "tax_name": "Purchase tax",
                "tax_type": "Tax group",
                "tax_percentage": 12,
                "item_total": 290,
                "item_order": 0,
                "unit": "qty",
                "image_id": 2077500000000002000,
                "image_name": "dell.jpg",
                "image_type": "jpg",
                "reverse_charge_tax_id": 460000000038056,
                "reverse_charge_tax_name": "inter",
                "reverse_charge_tax_percentage": 10,
                "reverse_charge_tax_amount": 100,
                "hsn_or_sac": 80540,
                "tax_exemption_code": "string",
                "warehouse_id": 130426000000664020,
                "tax_exemption_id": "string"
            }
        ],
        "taxes": [
            {
                "tax_name": "Purchase tax",
                "tax_amount": 29
            }
        ],
        "vendor_credits_applied": 24,
        "sub_total": 30,
        "tax_total": 2,
        "balance": 0,
        "billing_address": [
            {
                "address": "No:234,90 Church Street",
                "city": "New York City",
                "state": "New York",
                "zip": 10048,
                "fax": "324-524242"
            }
        ],
        "payments": [
            {
                "payment_id": 4815000000046039,
                "bill_id": 4815000000045067,
                "bill_payment_id": 4815000000046041,
                "payment_mode": "Cash",
                "payment_number": 2,
                "description": "Sample Description",
                "date": "2015-05-29",
                "reference_number": "PO-00003",
                "exchange_rate": 1,
                "amount": 234,
                "paid_through_account_id": 4815000000000361,
                "paid_through_account_name": "Petty Cash",
                "is_single_bill_payment": true
            }
        ],
        "vendor_credits": [
            {
                "vendor_credit_id": 4815000000046039,
                "vendor_credit_bill_id": 4815000000768039,
                "vendor_credit_number": 67258,
                "date": "2015-05-29",
                "amount": 234
            }
        ],
        "created_time": "2015-05-29T00:00:00.000Z",
        "last_modified_time": "2015-05-29T00:00:00.000Z",
        "reference_id": 4815000000000342,
        "notes": "Sample Note",
        "terms": "Term & Conditions",
        "attachment_name": "sample-attachments",
        "open_purchaseorders_count": 4,
        "gst_treatment": "business_gst",
        "gst_no": "22AAAAA0000A1Z5",
        "source_of_supply": "AP",
        "destination_of_supply": "TN",
        "is_pre_gst": false,
        "is_reverse_charge_applied": true
    }
}

Retrieve a Bill

Fetches the details of a Bill.

OAuth Scope : ZakyaAPI.bills.READ

Request ExampleCopy
curl --request GET \
  --url 'https://api.zakya.com/inventory/v1/bills/4815000000045067?organization_id=10234695' \
  --header 'Authorization: Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f'
headers_data = Map();
headers_data.put("Authorization", "Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f");
response = invokeUrl
[
url: "https://api.zakya.com/inventory/v1/bills/4815000000045067?organization_id=10234695"
type: GET
headers: headers_data
connection: 
]
info response;
OkHttpClient client = new OkHttpClient();

Request request = new Request.Builder()
  .url("https://api.zakya.com/inventory/v1/bills/4815000000045067?organization_id=10234695")
  .get()
  .addHeader("Authorization", "Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f")
  .build();

Response response = client.newCall(request).execute();
const http = require("https");

const options = {
  "method": "GET",
  "hostname": "api.zakya.com",
  "port": null,
  "path": "/inventory/v1/bills/4815000000045067?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();
const options = {
  method: 'GET',
  headers: {
    Authorization: 'Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f'
  }
};

fetch('https://api.zakya.com/inventory/v1/bills/4815000000045067?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("api.zakya.com")

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

conn.request("GET", "/inventory/v1/bills/4815000000045067?organization_id=10234695", headers=headers)

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

print(data.decode("utf-8"))
Response ExampleCopy
{
    "code": 0,
    "message": "success",
    "bill": {
        "bill_id": 4815000000045067,
        "purchaseorder_id": 4815000000044972,
        "vendor_id": 4815000000044080,
        "vendor_name": "Molly",
        "unused_credits_payable_amount": 0,
        "status": "paid",
        "bill_number": "BL-00002",
        "date": "2015-05-29",
        "due_date": "2015-05-29",
        "reference_number": "PO-00003",
        "due_by_days": 69,
        "currency_id": 4815000000000097,
        "currency_code": "USD",
        "currency_symbol": "$",
        "price_precision": 2,
        "exchange_rate": 1,
        "is_item_level_tax_calc": true,
        "line_items": [
            {
                "purchaseorder_item_id": 4815000000045245,
                "receive_item_id": 4815000000044131,
                "line_item_id": 4815000000044897,
                "name": "Laptop-white/15inch/dell",
                "account_id": 4815000000035003,
                "account_name": "Inventory Asset",
                "description": "Sample Description",
                "bcy_rate": 122,
                "rate": 6,
                "quantity": 5,
                "tax_id": 4815000000044043,
                "tax_name": "Purchase tax",
                "tax_type": "Tax group",
                "tax_percentage": 12,
                "item_total": 290,
                "item_order": 0,
                "unit": "qty",
                "image_id": 2077500000000002000,
                "image_name": "dell.jpg",
                "image_type": "jpg",
                "reverse_charge_tax_id": 460000000038056,
                "reverse_charge_tax_name": "inter",
                "reverse_charge_tax_percentage": 10,
                "reverse_charge_tax_amount": 100,
                "hsn_or_sac": 80540,
                "tax_exemption_code": "string",
                "warehouse_id": 130426000000664020,
                "tax_exemption_id": "string"
            }
        ],
        "taxes": [
            {
                "tax_name": "Purchase tax",
                "tax_amount": 29
            }
        ],
        "vendor_credits_applied": 24,
        "sub_total": 30,
        "tax_total": 2,
        "balance": 0,
        "billing_address": [
            {
                "address": "No:234,90 Church Street",
                "city": "New York City",
                "state": "New York",
                "zip": 10048,
                "fax": "324-524242"
            }
        ],
        "payments": [
            {
                "payment_id": 4815000000046039,
                "bill_id": 4815000000045067,
                "bill_payment_id": 4815000000046041,
                "payment_mode": "Cash",
                "payment_number": 2,
                "description": "Sample Description",
                "date": "2015-05-29",
                "reference_number": "PO-00003",
                "exchange_rate": 1,
                "amount": 234,
                "paid_through_account_id": 4815000000000361,
                "paid_through_account_name": "Petty Cash",
                "is_single_bill_payment": true
            }
        ],
        "vendor_credits": [
            {
                "vendor_credit_id": 4815000000046039,
                "vendor_credit_bill_id": 4815000000768039,
                "vendor_credit_number": 67258,
                "date": "2015-05-29",
                "amount": 234
            }
        ],
        "created_time": "2015-05-29T00:00:00.000Z",
        "last_modified_time": "2015-05-29T00:00:00.000Z",
        "reference_id": 4815000000000342,
        "notes": "Sample Note",
        "terms": "Term & Conditions",
        "attachment_name": "sample-attachments",
        "open_purchaseorders_count": 4,
        "gst_treatment": "business_gst",
        "gst_no": "22AAAAA0000A1Z5",
        "source_of_supply": "AP",
        "destination_of_supply": "TN",
        "is_pre_gst": false,
        "is_reverse_charge_applied": true
    }
}

Delete a Bill

Deletes a Bill from Zakya.

OAuth Scope : ZakyaAPI.bills.DELETE

Request ExampleCopy
curl --request DELETE \
  --url 'https://api.zakya.com/inventory/v1/bills/4815000000045067?organization_id=10234695' \
  --header 'Authorization: Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f'
headers_data = Map();
headers_data.put("Authorization", "Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f");
response = invokeUrl
[
url: "https://api.zakya.com/inventory/v1/bills/4815000000045067?organization_id=10234695"
type: DELETE
headers: headers_data
connection: 
]
info response;
OkHttpClient client = new OkHttpClient();

Request request = new Request.Builder()
  .url("https://api.zakya.com/inventory/v1/bills/4815000000045067?organization_id=10234695")
  .delete(null)
  .addHeader("Authorization", "Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f")
  .build();

Response response = client.newCall(request).execute();
const http = require("https");

const options = {
  "method": "DELETE",
  "hostname": "api.zakya.com",
  "port": null,
  "path": "/inventory/v1/bills/4815000000045067?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();
const options = {
  method: 'DELETE',
  headers: {
    Authorization: 'Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f'
  }
};

fetch('https://api.zakya.com/inventory/v1/bills/4815000000045067?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("api.zakya.com")

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

conn.request("DELETE", "/inventory/v1/bills/4815000000045067?organization_id=10234695", headers=headers)

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

print(data.decode("utf-8"))
Response ExampleCopy
{
    "code": 0,
    "message": "The Bill has been deleted."
}

Mark as Open

Marks a Bill as Open.

OAuth Scope : ZakyaAPI.bills.CREATE

Request ExampleCopy
curl --request POST \
  --url 'https://api.zakya.com/inventory/v1/bills/4815000000045067/status/open?organization_id=10234695' \
  --header 'Authorization: Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f'
headers_data = Map();
headers_data.put("Authorization", "Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f");
response = invokeUrl
[
url: "https://api.zakya.com/inventory/v1/bills/4815000000045067/status/open?organization_id=10234695"
type: POST
headers: headers_data
connection: 
]
info response;
OkHttpClient client = new OkHttpClient();

Request request = new Request.Builder()
  .url("https://api.zakya.com/inventory/v1/bills/4815000000045067/status/open?organization_id=10234695")
  .post(null)
  .addHeader("Authorization", "Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f")
  .build();

Response response = client.newCall(request).execute();
const http = require("https");

const options = {
  "method": "POST",
  "hostname": "api.zakya.com",
  "port": null,
  "path": "/inventory/v1/bills/4815000000045067/status/open?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();
const options = {
  method: 'POST',
  headers: {
    Authorization: 'Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f'
  }
};

fetch('https://api.zakya.com/inventory/v1/bills/4815000000045067/status/open?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("api.zakya.com")

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

conn.request("POST", "/inventory/v1/bills/4815000000045067/status/open?organization_id=10234695", headers=headers)

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

print(data.decode("utf-8"))
Response ExampleCopy
{
    "code": 0,
    "message": "The bill has been marked as open."
}

Mark as Void

Marks a Bill as Void.

OAuth Scope : ZakyaAPI.bills.CREATE

Request ExampleCopy
curl --request POST \
  --url 'https://api.zakya.com/inventory/v1/bills/4815000000045067/status/void?organization_id=10234695' \
  --header 'Authorization: Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f'
headers_data = Map();
headers_data.put("Authorization", "Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f");
response = invokeUrl
[
url: "https://api.zakya.com/inventory/v1/bills/4815000000045067/status/void?organization_id=10234695"
type: POST
headers: headers_data
connection: 
]
info response;
OkHttpClient client = new OkHttpClient();

Request request = new Request.Builder()
  .url("https://api.zakya.com/inventory/v1/bills/4815000000045067/status/void?organization_id=10234695")
  .post(null)
  .addHeader("Authorization", "Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f")
  .build();

Response response = client.newCall(request).execute();
const http = require("https");

const options = {
  "method": "POST",
  "hostname": "api.zakya.com",
  "port": null,
  "path": "/inventory/v1/bills/4815000000045067/status/void?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();
const options = {
  method: 'POST',
  headers: {
    Authorization: 'Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f'
  }
};

fetch('https://api.zakya.com/inventory/v1/bills/4815000000045067/status/void?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("api.zakya.com")

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

conn.request("POST", "/inventory/v1/bills/4815000000045067/status/void?organization_id=10234695", headers=headers)

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

print(data.decode("utf-8"))
Response ExampleCopy
{
    "code": 0,
    "message": "The bill has been marked as Void."
}