Journals

(Optional) VAT treatment for the journals. VAT treatment denotes the location of the customer, if the customer resides in UK then the VAT treatment is uk. If the customer is in an EU country & VAT registered, you are resides in Northen Ireland and selling Goods then his VAT treatment is eu_vat_registered, if he resides outside of the UK then his VAT treatment is overseas (For Pre Brexit, this can be split as eu_vat_registered, eu_vat_not_registered and non_eu).

product_type

string

🇬🇧 only

Type of the journal. This denotes whether the journal is to be treated as goods or service. Allowed Values: digital_service, goods and service.

include_in_vat_return

boolean

Europe , 🇬🇧 only

Check if Journal should be included in VAT Return

is_bas_adjustment

boolean

🇦🇺 only

Check if Journal is created for BAS Adjustment

line_items

array

Show Sub-Attributes

line_id

string

ID of the Line

account_id

string

ID of account for which journals to be recorded.

customer_id

string

ID of the Customer/Vendor

customer_name

string

Name of the Customer/Vendor

account_name

string

Name of the Account

description

string

Description that can be given at the line item level.

debit_or_credit

string

Whether the accounts needs to be debited or credited. Allowed Values: debit and credit.

tax_exemption_id

string

🇮🇳 , 🇺🇸 , 🇦🇺 , 🇨🇦 , 🇲🇽 only

ID of the Tax Exemption

tax_exemption_type

string

🇮🇳 , 🇺🇸 , 🇦🇺 , 🇨🇦 , 🇲🇽 only

Type of the Tax Exemption. Allowed Values : customer and item

tax_exemption_code

string

🇮🇳 , 🇺🇸 , 🇦🇺 , 🇨🇦 only

Code of the Tax Exemption

tax_authority_id

string

🇺🇸 , 🇦🇺 , 🇨🇦 , 🇲🇽 only

ID of the Tax Authority

tax_authority_name

string

🇺🇸 , 🇦🇺 , 🇨🇦 only

Name of the Tax Authority

tax_id

string

ID of the tax.

tax_name

string

Name of the Tax

tax_type

string

Type of the Tax

tax_percentage

string

Percentage of the Tax

amount

double

Amount to be recorded for the journal.

bcy_amount

double

Amount in Base Currency

acquisition_vat_id

string

🇬🇧 only

(Optional) This is the ID of the tax applied in case this is an EU - goods journal and acquisition VAT needs to be reported.

acquisition_vat_name

string

🇬🇧 , Europe only

Name of the VAT Acquistion

acquisition_vat_percentage

string

🇬🇧 , Europe only

Percentage of the VAT Acquistion

acquisition_vat_amount

string

🇬🇧 , Europe only

Amount of the VAT Acquistion

reverse_charge_vat_id

string

🇬🇧 only

(Optional) This is the ID of the tax applied in case this is a non UK - service journal and reverse charge VAT needs to be reported.

reverse_charge_vat_name

string

🇬🇧 , Europe only

Name of the Reverse Charge

reverse_charge_vat_percentage

string

🇬🇧 , Europe only

Percentage of the Reverse Charge

reverse_charge_vat_amount

string

🇬🇧 , Europe only

Percentage of the Reverse Charge

Create a journal

Create a journal.
OAuth Scope : ZohoBooks.accountants.CREATE

Arguments

journal_date

string

(Required)

Date on which the journal to be recorded.

reference_number

string

Reference number for the journal.

notes

string

Notes for the journal.

journal_type

string

Type of the Journal. Allowed values: Cash and Both .

vat_treatment

string

🇬🇧 , Europe only

include_in_vat_return

boolean

Europe , 🇬🇧 only

Check if Journal should be included in VAT Return

product_type

string

🇬🇧 only

Type of the journal. This denotes whether the journal is to be treated as goods or service. Allowed Values: digital_service, goods and service.

is_bas_adjustment

boolean

🇦🇺 only

Check if Journal is created for BAS Adjustment

currency_id

string

ID of the Currency Associated with the Journal

exchange_rate

double

Exchange Rate between the Currencies

line_items

array

Show Sub-Attributes

account_id

string

ID of account for which journals to be recorded.

customer_id

string

ID of the Customer/Vendor

line_id

string

ID of the Line

description

string

Description that can be given at the line item level.

tax_exemption_id

string

🇮🇳 , 🇺🇸 , 🇦🇺 , 🇨🇦 , 🇲🇽 only

ID of the Tax Exemption

tax_authority_id

string

🇺🇸 , 🇦🇺 , 🇨🇦 , 🇲🇽 only

ID of the Tax Authority

tax_exemption_type

string

🇮🇳 , 🇺🇸 , 🇦🇺 , 🇨🇦 , 🇲🇽 only

Type of the Tax Exemption. Allowed Values : customer and item

tax_exemption_code

string

🇮🇳 , 🇺🇸 , 🇦🇺 , 🇨🇦 only

Code of the Tax Exemption

tax_authority_name

string

🇺🇸 , 🇦🇺 , 🇨🇦 only

Name of the Tax Authority

tax_id

string

ID of the tax.

amount

double

(Required)

Amount to be recorded for the journal.

debit_or_credit

string

(Required)

Whether the accounts needs to be debited or credited. Allowed Values: debit and credit.

acquisition_vat_id

string

🇬🇧 only

(Optional) This is the ID of the tax applied in case this is an EU - goods journal and acquisition VAT needs to be reported.

reverse_charge_vat_id

string

🇬🇧 only

(Optional) This is the ID of the tax applied in case this is a non UK - service journal and reverse charge VAT needs to be reported.

Get journal list

Get journal list.
OAuth Scope : ZohoBooks.accountants.READ

Query Parameters

entry_number

Search journals by journal entry number. Variants: entry_number_startswith and entry_number_contains

reference_number

Search journals by journal reference number. Variants: reference_number_startswith and reference_number_contains

date

Search journals by journal date. Variants: date_start, date_end, date_before and date_after

notes

Search journals by journal notes. Variants: notes_startswith and notes_contains

last_modified_time

Search the journals using Last Modified Time

total

Search journals by journal total. Variants: total_less_than, total_less_equals, total_greater_than and total_greater_equals

customer_id

Search Journals using Customer ID

vendor_id

Search the journals using Vendor ID

filter_by

Filter journals by journal date. Allowed Values: JournalDate.All, JournalDate.Today, JournalDate.ThisWeek, JournalDate.ThisMonth, JournalDate.ThisQuarter and JournalDate.ThisYear

sort_column

Sort journal list. Allowed Values: journal_date, entry_number, reference_number and total

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

OkHttpClient client = new OkHttpClient();

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

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

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

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

import http.client

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

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

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

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

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

const http = require("https");

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

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

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

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

req.end();

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

{
    "code": 0,
    "message": "success",
    "journals": [
        {
            "journal_id": "460000000038001",
            "journal_date": "2013-09-04",
            "entry_number": "1",
            "reference_number": "7355",
            "currency_id": "460000000000097",
            "notes": "Loan repayment",
            "journal_type": "both",
            "entity_type": "journal",
            "total": 5000,
            "bcy_total": 100,
            "custom_field": "string"
        },
        {...},
        {...}
    ]
}

Update a journal

Updates the journal with given information.
OAuth Scope : ZohoBooks.accountants.UPDATE

Arguments

journal_date

string

(Required)

Date on which the journal to be recorded.

reference_number

string

Reference number for the journal.

notes

string

Notes for the journal.

journal_type

string

Type of the Journal. Allowed values: Cash and Both .

vat_treatment

string

🇬🇧 , Europe only

include_in_vat_return

boolean

Europe , 🇬🇧 only

Check if Journal should be included in VAT Return

product_type

string

🇬🇧 only

Type of the journal. This denotes whether the journal is to be treated as goods or service. Allowed Values: digital_service, goods and service.

is_bas_adjustment

boolean

🇦🇺 only

Check if Journal is created for BAS Adjustment

currency_id

string

ID of the Currency Associated with the Journal

exchange_rate

double

Exchange Rate between the Currencies

line_items

array

Show Sub-Attributes

account_id

string

ID of account for which journals to be recorded.

customer_id

string

ID of the Customer/Vendor

line_id

string

ID of the Line

description

string

Description that can be given at the line item level.

tax_exemption_id

string

🇮🇳 , 🇺🇸 , 🇦🇺 , 🇨🇦 , 🇲🇽 only

ID of the Tax Exemption

tax_authority_id

string

🇺🇸 , 🇦🇺 , 🇨🇦 , 🇲🇽 only

ID of the Tax Authority

tax_exemption_type

string

🇮🇳 , 🇺🇸 , 🇦🇺 , 🇨🇦 , 🇲🇽 only

Type of the Tax Exemption. Allowed Values : customer and item

tax_exemption_code

string

🇮🇳 , 🇺🇸 , 🇦🇺 , 🇨🇦 only

Code of the Tax Exemption

tax_authority_name

string

🇺🇸 , 🇦🇺 , 🇨🇦 only

Name of the Tax Authority

tax_id

string

ID of the tax.

amount

double

(Required)

Amount to be recorded for the journal.

debit_or_credit

string

(Required)

Whether the accounts needs to be debited or credited. Allowed Values: debit and credit.

acquisition_vat_id

string

🇬🇧 only

(Optional) This is the ID of the tax applied in case this is an EU - goods journal and acquisition VAT needs to be reported.

reverse_charge_vat_id

string

🇬🇧 only

(Optional) This is the ID of the tax applied in case this is a non UK - service journal and reverse charge VAT needs to be reported.

Get journal

Get the details of the journal.
OAuth Scope : ZohoBooks.accountants.READ

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

OkHttpClient client = new OkHttpClient();

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

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

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

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

import http.client

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

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

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

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

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

const http = require("https");

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

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

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

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

req.end();

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

{
    "code": 0,
    "message": "success",
    "journal": {
        "journal_id": "460000000038001",
        "entry_number": "1",
        "reference_number": "7355",
        "notes": "Loan repayment",
        "currency_id": "460000000000097",
        "currency_code": "USD",
        "currency_symbol": "$",
        "exchange_rate": 1,
        "journal_date": "2013-09-04",
        "journal_type": "both",
        "vat_treatment": "string",
        "product_type": "string",
        "include_in_vat_return": true,
        "is_bas_adjustment": true,
        "line_items": [
            {
                "line_id": "460000000038005",
                "account_id": "460000000000361",
                "customer_id": "string",
                "customer_name": "string",
                "account_name": "Petty Cash",
                "description": "string",
                "debit_or_credit": "credit",
                "tax_exemption_id": "string",
                "tax_exemption_type": "string",
                "tax_exemption_code": "string",
                "tax_authority_id": "string",
                "tax_authority_name": "string",
                "tax_id": "string",
                "tax_name": "string",
                "tax_type": "tax",
                "tax_percentage": "string",
                "amount": 5000,
                "bcy_amount": 100,
                "acquisition_vat_id": "string",
                "acquisition_vat_name": "string",
                "acquisition_vat_percentage": "string",
                "acquisition_vat_amount": "string",
                "reverse_charge_vat_id": "string",
                "reverse_charge_vat_name": "string",
                "reverse_charge_vat_percentage": "string",
                "reverse_charge_vat_amount": "string",
                "tags": [
                    {
                        "is_tag_mandatory": false,
                        "tag_id": "460000000094001",
                        "tag_name": "Location",
                        "tag_option_id": "460000000048001",
                        "tag_option_name": "USA"
                    }
                ],
                "project_id": "460000000898001",
                "project_name": "Network Distribution"
            }
        ],
        "line_item_total": 5000,
        "total": 5000,
        "bcy_total": 100,
        "price_precision": 2,
        "taxes": [
            {
                "tax_name": "string",
                "tax_amount": 0.1,
                "debit_or_credit": "credit",
                "tax_account": true
            }
        ],
        "created_time": "2013-09-04T09:40:07+0530",
        "last_modified_time": "2013-09-05T17:13:31+0530",
        "status": "draft",
        "custom_fields": [
            {
                "customfield_id": "460000000098001",
                "value": "Normal"
            }
        ]
    }
}

Delete a journal

Deletes the given journal.
OAuth Scope : ZohoBooks.accountants.DELETE

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

OkHttpClient client = new OkHttpClient();

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

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

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

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

import http.client

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

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

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

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

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

const http = require("https");

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

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

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

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

req.end();

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

{
    "code": 0,
    "message": "The selected journal entry has been deleted."
}

Mark a journal as published

Mark a draft journal as published.
OAuth Scope : ZohoBooks.accountants.CREATE

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

OkHttpClient client = new OkHttpClient();

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

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

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

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

import http.client

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

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

conn.request("POST", "/books/v3/journals/460000000038001/status/publish?organization_id=10234695", headers=headers)

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

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

const http = require("https");

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

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

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

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

req.end();

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

{
    "code": 0,
    "message": "Journal has been published."
}

Add attachment to a journal

Attach a file to a journal.
OAuth Scope : ZohoBooks.accountants.CREATE

Query Parameters

attachment

The file that is to be added as an Attachment in the Journal

doc

Document that is to be attached

totalFiles

Total number of files.

document_ids

ID's of the document

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

OkHttpClient client = new OkHttpClient();

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

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

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

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

import http.client

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

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

conn.request("POST", "/books/v3/journals/460000000038001/attachment?organization_id=10234695", headers=headers)

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

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

const http = require("https");

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

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

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

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

req.end();

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

{
    "code": 0,
    "message": "Your file has been successfully attached to the journal."
}

Add comment

Add a comment for a journal.
OAuth Scope : ZohoBooks.accountants.CREATE

Arguments

description

string

Description of a comment

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

OkHttpClient client = new OkHttpClient();

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

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

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

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

import http.client

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

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

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

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

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

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

const http = require("https");

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

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

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

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

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

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

{
    "description": "Journal Created"
}

{
    "code": 0,
    "message": "Journal comment has been added successfully.",
    "comment": [
        {
            "comment_id": "460000000048023",
            "description": "string",
            "commented_by_id": "460000000017003",
            "commented_by": "John",
            "comment_type": "system",
            "date": "string",
            "operation_type": "Added"
        },
        {...},
        {...}
    ]
}

Delete a comment

Delete a jounral comment.
OAuth Scope : ZohoBooks.accountants.DELETE

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

OkHttpClient client = new OkHttpClient();

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

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

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

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

import http.client

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

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

conn.request("DELETE", "/books/v3/journals//comments/460000000048023?organization_id=10234695", headers=headers)

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

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

const http = require("https");

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

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

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

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

req.end();

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

{
    "code": 0,
    "message": "The selected journal comment entries have been deleted."
}