Zoho books logo Extensions
/

Get Supported Entity

Organization

To fetch the current organization’s details:

ZFAPPS.get('organization').then(function (data) {
   //response Handling
}).catch(function (err) {
   //error Handling
});

Response:

{
	organization: {
		organization_id: "ORG_ID",
		org_name: "ORG_NAME",
		org_mode: "TEST",
		org_email: "ORG_EMAIL"
	}
}
To fetch the current organization’s ID:

ZFAPPS.get('organization.organization_id').then(function (data) {
    //response Handling
}).catch(function (err) {
    //error Handling
});    

Response:

{
	"organization.organization_id": "ORG_ID"
}

Supported Keys:

PropertyRequest
organization_idorganization.organization_id
org_emailorganization.org_email
org_modeorganization.org_mode
org_nameorganization.org_name
data_center_extensionorganization.data_center_extension

User

To fetch the details of the user accessing the widget:

ZFAPPS.get('user').then(function (data) {
    //response Handling
}).catch(function (err) {
    //error Handling
});

Response:

{
	user: {
		user_id:  "USER_ID",
		name: "USER_NAME",
		email: "USER_EMAIL",
		zuId: "USER_ZUID"
	}
}
To fetch the current user’s name accessing the widget:

ZFAPPS.get('user.name').then(function (data) {
   //response Handling
}).catch(function (err) {
   //error Handling
});    

Response:

{
	"user.name": "USER_NAME"
}
Supported Keys:

PropertyRequest
user_iduser.user_id
nameuser.name
emailuser.email
zuIduser.zuId

Invoice

Invoice details

This method lets you fetch the details of an invoice. This can be used only when the widget is displayed in the invoice details or creation page.

To fetch the details of an invoice:

ZFAPPS.get('invoice').then(function (data) {
    //response Handling
}).catch(function (err) {
    //error Handling       
});
Response:

{
  "invoice": {
    "invoice_id": "112233",
    "invoice_number": "INV-000006",
    "salesorder_id": "",
    "salesorder_number": "",
    "crm_owner_id": "",
    "zcrm_potential_id": "",
    "zcrm_potential_name": "",
    "date": "2018-08-25",
    "date_formatted": "25 Aug 2019",
    "status": "paid",
    "status_formatted": "Paid",
    "amount": 101,
    "amount_formatted": "$101.00",
    .......
   }
}
Invoice list

This method lets you fetch the list of invoices. This can be used only when the widget is displayed in the invoices list page.

ZFAPPS.get('invoices').then(function (data) {
   //response Handling
}).catch(function (err) {
   //error Handling
});
Response:
{
  "invoices": [
	{
      "invoice_id": "112233",
      "invoice_number": "INV-000006",
       ...
     },
     {
      "invoice_id": "112233",
      "invoice_number": "INV-000006",
       ...
     }
     ....
   ]
}
Supported Keys:
PropertyRequest
invoice_idinvoice.invoice_id
invoice_numberinvoice.invoice_number
salesorder_idinvoice.salesorder_id
salesorder_numberinvoice.salesorder_number
crm_owner_idinvoice.crm_owner_id
zcrm_potential_idinvoice.zcrm_potential_id
zcrm_potential_nameinvoice.zcrm_potential_name
dateinvoice.date
date_formattedinvoice.date_formatted
statusinvoice.status
status_formattedinvoice.status_formatted
autobill_statusinvoice.autobill_status
autobill_status_formattedinvoice.autobill_status_formatted
payment_termsinvoice.payment_terms
payment_terms_labelinvoice.payment_terms_label
due_dateinvoice.due_date
due_date_formattedinvoice.due_date_formatted
payment_expected_dateinvoice.payment_expected_date
payment_expected_date_formattedinvoice.payment_expected_date_formatted
payment_discountinvoice.payment_discount
payment_discount_formattedinvoice.payment_discount_formatted
last_payment_dateinvoice.last_payment_date
last_payment_date_formattedinvoice.last_payment_date_formatted
reference_numberinvoice.reference_number
customer_idinvoice.customer_id
estimate_idinvoice.estimate_id
contact_categoryinvoice.contact_category
customer_nameinvoice.customer_name
unused_credits_receivable_amountinvoice.unused_credits_receivable_amount
unused_credits_receivable_amount_formattedinvoice.unused_credits_receivable_amount_formatted
unused_retainer_paymentsinvoice.unused_retainer_payments
unused_retainer_payments_formattedinvoice.unused_retainer_payments_formatted
contact_personsinvoice.contact_persons
currency_idinvoice.currency_id
currency_codeinvoice.currency_code
currency_symbolinvoice.currency_symbol
exchange_rateinvoice.exchange_rate
discountinvoice.discount
discount_applied_on_amountinvoice.discount_applied_on_amount
discount_typeinvoice.discount_type
recurring_invoice_idinvoice.recurring_invoice_id
documentsinvoice.documents
line_itemsinvoice.line_items
submitter_idinvoice.submitter_id
approver_idinvoice.approver_id
submitted_dateinvoice.submitted_date
submitted_date_formattedinvoice.submitted_date_formatted
submitted_byinvoice.submitted_by
contact_persons_detailsinvoice.contact_persons_details
salesordersinvoice.salesorders
deliverychallansinvoice.deliverychallans
shipping_chargeinvoice.shipping_charge
shipping_charge_formattedinvoice.shipping_charge_formatted
adjustmentinvoice.adjustment
adjustment_formattedinvoice.adjustment_formatted
roundoff_valueinvoice.roundoff_value
roundoff_value_formattedinvoice.roundoff_value_formatted
adjustment_descriptioninvoice.adjustment_description
transaction_rounding_typeinvoice.transaction_rounding_type
sub_totalinvoice.sub_total
sub_total_formattedinvoice.sub_total_formatted
tax_totalinvoice.tax_total
tax_total_formattedinvoice.tax_total_formatted
discount_totalinvoice.discount_total
discount_total_formattedinvoice.discount_total_formatted
totalinvoice.total
total_formattedinvoice.total_formatted
discount_percentinvoice.discount_percent
bcy_shipping_chargeinvoice.bcy_shipping_charge
bcy_adjustmentinvoice.bcy_adjustment
bcy_sub_totalinvoice.bcy_sub_total
bcy_discount_totalinvoice.bcy_discount_total
bcy_tax_totalinvoice.bcy_tax_total
bcy_totalinvoice.bcy_total
taxesinvoice.taxes
payment_madeinvoice.payment_made
payment_made_formattedinvoice.payment_made_formatted
credits_appliedinvoice.credits_applied
credits_applied_formattedinvoice.credits_applied_formatted
balanceinvoice.balance
balance_formattedinvoice.balance_formatted
write_off_amountinvoice.write_off_amount
write_off_amount_formattedinvoice.write_off_amount_formatted
payment_optionsinvoice.payment_options
contact_persons_associatedinvoice.contact_persons_associated
paymentsinvoice.payments
shipping_billsinvoice.shipping_bills
creditsinvoice.credits
commentsinvoice.comments
billing_addressinvoice.billing_address
shipping_addressinvoice.shipping_address
customer_default_billing_addressinvoice.customer_default_billing_address
notesinvoice.notes
termsinvoice.terms
custom_fieldsinvoice.custom_fields
template_idinvoice.template_id
template_nameinvoice.template_name
template_typeinvoice.template_type
template_type_formattedinvoice.template_type_formatted
created_timeinvoice.created_time
last_modified_timeinvoice.last_modified_time
created_dateinvoice.created_date
created_date_formattedinvoice.created_date_formatted
created_by_idinvoice.created_by_id
last_modified_by_idinvoice.last_modified_by_id
salesperson_idinvoice.salesperson_id
salesperson_nameinvoice.salesperson_name
merchant_idinvoice.merchant_id
merchant_nameinvoice.merchant_name
ecomm_operator_idinvoice.ecomm_operator_id
ecomm_operator_nameinvoice.ecomm_operator_name
invoice_urlinvoice.invoice_url
billsinvoice.bills
sub_total_inclusive_of_taxinvoice.sub_total_inclusive_of_tax
sub_total_inclusive_of_tax_formattedinvoice.sub_total_inclusive_of_tax_formatted
subject_contentinvoice.subject_content
approvers_listinvoice.approvers_list
zoho_recruit_jobopening_idinvoice.zoho_recruit_jobopening_id

Estimate

Estimate details

This method lets you fetch the details of an estimate. This can be used only when the widget is displayed in the estimate details or creation page.

To fetch the details of an estimate:

ZFAPPS.get('estimate').then(function (data) {
    //response Handling
}).catch(function (err) {
    //error Handling       
});
Response:

{
  "estimate": {
    "estimate_id": "112233",
    "estimate_number": "INV-000006",
    "salesorder_id": "",
    "salesorder_number": "",
    "crm_owner_id": "",
    "zcrm_potential_id": "",
    "zcrm_potential_name": "",
    "date": "2018-08-25",
    "date_formatted": "25 Aug 2019",
    "status": "paid",
    "status_formatted": "Paid",
    "amount": 101,
    "amount_formatted": "$101.00",
    .......
   }
}

Note: Refer the API Docs to know the list key available for estimate detail

Estimate list

This method lets you fetch the list of estimates. This can be used only when the widget is displayed in the estimates list page.

ZFAPPS.get('estimates').then(function (data) {
   //response Handling
}).catch(function (err) {
   //error Handling
});
Response:
{
  "estimates": [
	{
      "estimate_id": "112233",
      "estimate_number": "INV-000006",
       ...
     },
     {
      "estimate_id": "112233",
      "estimate_number": "INV-000006",
       ...
     }
     ....
   ]
}

Note: Refer the API Docs to know the list key available for estimate list

Supported Keys:
PropertyRequest
estimate_idestimate.estimate_id
estimate_numberestimate.estimate_number
crm_owner_idestimate.crm_owner_id
crm_custom_reference_idestimate.crm_custom_reference_id
zcrm_potential_idestimate.zcrm_potential_id
zcrm_potential_nameestimate.zcrm_potential_name
dateestimate.date
date_formattedestimate.date_formatted
created_dateestimate.created_date
created_date_formattedestimate.created_date_formatted
reference_numberestimate.reference_number
statusestimate.status
status_formattedestimate.status_formatted
customer_idestimate.customer_id
documentsestimate.documents
customer_nameestimate.customer_name
place_of_supplyestimate.place_of_supply
place_of_supply_formattedestimate.place_of_supply_formatted
vat_treatmentestimate.vat_treatment
contact_categoryestimate.contact_category
tax_treatmentestimate.tax_treatment
tax_treatment_formattedestimate.tax_treatment_formatted
contact_personsestimate.contact_persons
currency_idestimate.currency_id
currency_codeestimate.currency_code
currency_symbolestimate.currency_symbol
exchange_rateestimate.exchange_rate
expiry_dateestimate.expiry_date
expiry_date_formattedestimate.expiry_date_formatted
discountestimate.discount
discount_applied_on_amountestimate.discount_applied_on_amount
is_discount_before_taxestimate.is_discount_before_tax
discount_typeestimate.discount_type
is_viewed_by_clientestimate.is_viewed_by_client
client_viewed_timeestimate.client_viewed_time
client_viewed_time_formattedestimate.client_viewed_time_formatted
is_inclusive_taxestimate.is_inclusive_tax
tax_roundingestimate.tax_rounding
estimate_urlestimate.estimate_url
line_itemsestimate.line_items
submitter_idestimate.submitter_id
submitted_dateestimate.submitted_date
submitted_date_formattedestimate.submitted_date_formatted
submitted_byestimate.submitted_by
approver_idestimate.approver_id
shipping_chargeestimate.shipping_charge
shipping_charge_formattedestimate.shipping_charge_formatted
bcy_shipping_chargeestimate.bcy_shipping_charge
adjustmentestimate.adjustment
adjustment_formattedestimate.adjustment_formatted
bcy_adjustmentestimate.bcy_adjustment
adjustment_descriptionestimate.adjustment_description
roundoff_valueestimate.roundoff_value
roundoff_value_formattedestimate.roundoff_value_formatted
transaction_rounding_typeestimate.transaction_rounding_type
sub_totalestimate.sub_total
sub_total_formattedestimate.sub_total_formatted
bcy_sub_totalestimate.bcy_sub_total
sub_total_inclusive_of_taxestimate.sub_total_inclusive_of_tax
sub_total_inclusive_of_tax_formattedestimate.sub_total_inclusive_of_tax_formatted
sub_total_exclusive_of_discountestimate.sub_total_exclusive_of_discount
sub_total_exclusive_of_discount_formattedestimate.sub_total_exclusive_of_discount_formatted
discount_totalestimate.discount_total
discount_total_formattedestimate.discount_total_formatted
bcy_discount_totalestimate.bcy_discount_total
discount_percentestimate.discount_percent
totalestimate.total
total_formattedestimate.total_formatted
bcy_totalestimate.bcy_total
tax_totalestimate.tax_total
tax_total_formattedestimate.tax_total_formatted
bcy_tax_totalestimate.bcy_tax_total
price_precisionestimate.price_precision
taxesestimate.taxes
commentsestimate.comments
invoice_idsestimate.invoice_ids
billing_addressestimate.billing_address
shipping_addressestimate.shipping_address
customer_default_billing_addressestimate.customer_default_billing_address
notesestimate.notes
termsestimate.terms
custom_fieldsestimate.custom_fields
template_idestimate.template_id
template_nameestimate.template_name
template_typeestimate.template_type
template_type_formattedestimate.template_type_formatted
created_timeestimate.created_time
last_modified_timeestimate.last_modified_time
created_by_idestimate.created_by_id
last_modified_by_idestimate.last_modified_by_id
contact_persons_associatedestimate.contact_persons_associated
contact_persons_detailsestimate.contact_persons_details
salesperson_idestimate.salesperson_id
salesperson_nameestimate.salesperson_name
attachment_nameestimate.attachment_name
allow_partial_paymentsestimate.allow_partial_payments
payment_optionsestimate.payment_options
paymentsestimate.payments
subject_contentestimate.subject_content
approvers_listestimate.approvers_list

Contact

Contact details

This method lets you fetch the details of an contacts. This can be used only when the widget is displayed in the contact details or creation page.

To fetch the details of an contact:

ZFAPPS.get('contact').then(function (data) {
    //response Handling
}).catch(function (err) {
    //error Handling       
});
Response:
{
  "contact": {
    "contact_id": "112233",
    "contact_number": "987776575",
    .......
   }
}

Contact list

This method lets you fetch the list of contacts. This can be used only when the widget is displayed in the contacts list page.

ZFAPPS.get('contacts').then(function (data) {
   //response Handling
}).catch(function (err) {
   //error Handling
});
Response:
{
  "contacts": [
	  {
      "contact_id": "112233",
      "contact_number": "987776575",
      ...
     },
     {
      "contact_id": "112233",
      "contact_number": "887776572",
       ...
     }
     ....
   ]
}
Supported Keys:
PropertyRequest
contact_idcontact.contact_id
contact_namecontact.contact_name
company_namecontact.company_name
first_namecontact.first_name
last_namecontact.last_name
designationcontact.designation
departmentcontact.department
websitecontact.website
language_codecontact.language_code
language_code_formattedcontact.language_code_formatted
contact_salutationcontact.contact_salutation
emailcontact.email
phonecontact.phone
mobilecontact.mobile
portal_statuscontact.portal_status
has_transactioncontact.has_transaction
contact_typecontact.contact_type
customer_sub_typecontact.customer_sub_type
customer_sub_type_formattedcontact.customer_sub_type_formatted
owner_idcontact.owner_id
owner_namecontact.owner_name
sourcecontact.source
source_formattedcontact.source_formatted
documentscontact.documents
twittercontact.twitter
facebookcontact.facebook
is_crm_customercontact.is_crm_customer
is_linked_with_zohocrmcontact.is_linked_with_zohocrm
is_gapps_customercontact.is_gapps_customer
primary_contact_idcontact.primary_contact_id
zcrm_account_idcontact.zcrm_account_id
zcrm_contact_idcontact.zcrm_contact_id
crm_owner_idcontact.crm_owner_id
payment_termscontact.payment_terms
payment_terms_labelcontact.payment_terms_label
credit_limit_exceeded_amountcontact.credit_limit_exceeded_amount
credit_limit_exceeded_amount_formattedcontact.credit_limit_exceeded_amount_formatted
currency_idcontact.currency_id
currency_codecontact.currency_code
currency_symbolcontact.currency_symbol
price_precisioncontact.price_precision
exchange_ratecontact.exchange_rate
opening_balance_amountcontact.opening_balance_amount
opening_balance_amount_formattedcontact.opening_balance_amount_formatted
opening_balance_amount_bcycontact.opening_balance_amount_bcy
opening_balance_amount_bcy_formattedcontact.opening_balance_amount_bcy_formatted
outstanding_receivable_amountcontact.outstanding_receivable_amount
outstanding_receivable_amount_formattedcontact.outstanding_receivable_amount_formatted
outstanding_receivable_amount_bcycontact.outstanding_receivable_amount_bcy
outstanding_receivable_amount_bcy_formattedcontact.outstanding_receivable_amount_bcy_formatted
outstanding_payable_amountcontact.outstanding_payable_amount
outstanding_payable_amount_formattedcontact.outstanding_payable_amount_formatted
outstanding_payable_amount_bcycontact.outstanding_payable_amount_bcy
outstanding_payable_amount_bcy_formattedcontact.outstanding_payable_amount_bcy_formatted
unused_credits_receivable_amountcontact.unused_credits_receivable_amount
unused_credits_receivable_amount_formattedcontact.unused_credits_receivable_amount_formatted
unused_credits_receivable_amount_bcycontact.unused_credits_receivable_amount_bcy
unused_credits_receivable_amount_bcy_formattedcontact.unused_credits_receivable_amount_bcy_formatted
unused_credits_payable_amountcontact.unused_credits_payable_amount
unused_credits_payable_amount_formattedcontact.unused_credits_payable_amount_formatted
unused_credits_payable_amount_bcycontact.unused_credits_payable_amount_bcy
unused_credits_payable_amount_bcy_formattedcontact.unused_credits_payable_amount_bcy_formatted
unused_retainer_paymentscontact.unused_retainer_payments
unused_retainer_payments_formattedcontact.unused_retainer_payments_formatted
statuscontact.status
payment_reminder_enabledcontact.payment_reminder_enabled
is_sms_enabledcontact.is_sms_enabled
is_portal_enabledcontact.is_portal_enabled
is_client_review_settings_enabledcontact.is_client_review_settings_enabled
custom_fieldscontact.custom_fields
is_taxablecontact.is_taxable
tax_idcontact.tax_id
tax_namecontact.tax_name
tax_percentagecontact.tax_percentage
country_codecontact.country_code
country_code_formattedcontact.country_code_formatted
contact_categorycontact.contact_category
contact_category_formattedcontact.contact_category_formatted
is_linked_with_contactcontact.is_linked_with_contact
sales_channelcontact.sales_channel
ach_supportedcontact.ach_supported
portal_receipt_countcontact.portal_receipt_count
opening_balancescontact.opening_balances
billing_addresscontact.billing_address
shipping_addresscontact.shipping_address
contact_personscontact.contact_persons
commentscontact.comments
addressescontact.addresses
pricebook_idcontact.pricebook_id
pricebook_namecontact.pricebook_name
default_templatescontact.default_templates
associated_with_squarecontact.associated_with_square
can_add_cardcontact.can_add_card
can_add_bank_accountcontact.can_add_bank_account
cardscontact.cards
checkscontact.checks
bank_accountscontact.bank_accounts
vpa_listcontact.vpa_list
notescontact.notes
created_timecontact.created_time
last_modified_timecontact.last_modified_time
tagscontact.tags
zohopeople_client_idcontact.zohopeople_client_id

Credit Note

Credit Note details

This method lets you fetch the details of an creditnote. This can be used only when the widget is displayed in the creditnotes details or creation page.

To fetch the details of an creditnote:

ZFAPPS.get('creditnote').then(function (data) {
    //response Handling
}).catch(function (err) {
    //error Handling       
});
Response:
{
  "creditnote": {
    "creditnote_id": "112233",
    "creditnote_number": "INV-000006",
    "salesorder_id": "",
    "salesorder_number": "",
    "crm_owner_id": "",
    "zcrm_potential_id": "",
    "zcrm_potential_name": "",
    "date": "2018-08-25",
    "date_formatted": "25 Aug 2019",
    "status": "paid",
    "status_formatted": "Paid",
    "amount": 101,
    "amount_formatted": "$101.00",
    .......
   }
}

Credit Note list

This method lets you fetch the list of creditnotes. This can be used only when the widget is displayed in the creditnotes list page.

ZFAPPS.get('creditnotes').then(function (data) {
   //response Handling
}).catch(function (err) {
   //error Handling
});

Response:
{
  "creditnotes": [
	{
      "creditnote_id": "112233",
      "creditnote_number": "INV-000006",
       ...
     },
     {
      "creditnote_id": "112233",
      "creditnote_number": "INV-000006",
       ...
     }
     ....
   ]
}
Supported Keys:
PropertyRequest
adjustmentcreditnote.adjustment
adjustment_descriptioncreditnote.adjustment_description
adjustment_formattedcreditnote.adjustment_formatted
approver_idcreditnote.approver_id
approvers_listcreditnote.approvers_list
balancecreditnote.balance
balance_formattedcreditnote.balance_formatted
billing_addresscreditnote.billing_address
color_codecreditnote.color_code
commentscreditnote.comments
contact_categorycreditnote.contact_category
contact_personscreditnote.contact_persons
created_by_idcreditnote.created_by_id
created_timecreditnote.created_time
creditnote_idcreditnote.creditnote_id
creditnote_numbercreditnote.creditnote_number
creditnote_refundscreditnote.creditnote_refunds
currency_codecreditnote.currency_code
currency_idcreditnote.currency_id
currency_symbolcreditnote.currency_symbol
current_sub_statuscreditnote.current_sub_status
current_sub_status_formattedcreditnote.current_sub_status_formatted
current_sub_status_idcreditnote.current_sub_status_id
custom_field_hashcreditnote.custom_field_hash
custom_fieldscreditnote.custom_fields
customer_idcreditnote.customer_id
customer_namecreditnote.customer_name
datecreditnote.date
date_formattedcreditnote.date_formatted
discountcreditnote.discount
discount_applied_on_amountcreditnote.discount_applied_on_amount
discount_typecreditnote.discount_type
documentscreditnote.documents
ewaybillscreditnote.ewaybills
exchange_ratecreditnote.exchange_rate
html_stringcreditnote.html_string
invoice_idcreditnote.invoice_id
invoices_creditedcreditnote.invoices_credited
is_discount_before_taxcreditnote.is_discount_before_tax
is_emailedcreditnote.is_emailed
is_eway_bill_requiredcreditnote.is_eway_bill_required
is_inclusive_taxcreditnote.is_inclusive_tax
is_pre_gstcreditnote.is_pre_gst
is_square_transactioncreditnote.is_square_transaction
last_modified_by_idcreditnote.last_modified_by_id
last_modified_timecreditnote.last_modified_time
line_itemscreditnote.line_items
notescreditnote.notes
orientationcreditnote.orientation
page_heightcreditnote.page_height
page_widthcreditnote.page_width
price_precisioncreditnote.price_precision
reference_numbercreditnote.reference_number
roundoff_valuecreditnote.roundoff_value
roundoff_value_formattedcreditnote.roundoff_value_formatted
salesperson_idcreditnote.salesperson_id
salesperson_namecreditnote.salesperson_name
shipping_addresscreditnote.shipping_address
shipping_chargecreditnote.shipping_charge
shipping_charge_exclusive_of_taxcreditnote.shipping_charge_exclusive_of_tax
shipping_charge_exclusive_of_tax_formattedcreditnote.shipping_charge_exclusive_of_tax_formatted
shipping_charge_formattedcreditnote.shipping_charge_formatted
shipping_charge_inclusive_of_taxcreditnote.shipping_charge_inclusive_of_tax
shipping_charge_inclusive_of_tax_formattedcreditnote.shipping_charge_inclusive_of_tax_formatted
shipping_charge_sac_codecreditnote.shipping_charge_sac_code
shipping_charge_taxcreditnote.shipping_charge_tax
shipping_charge_tax_exemption_codecreditnote.shipping_charge_tax_exemption_code
shipping_charge_tax_exemption_idcreditnote.shipping_charge_tax_exemption_id
shipping_charge_tax_formattedcreditnote.shipping_charge_tax_formatted
shipping_charge_tax_idcreditnote.shipping_charge_tax_id
shipping_charge_tax_namecreditnote.shipping_charge_tax_name
shipping_charge_tax_percentagecreditnote.shipping_charge_tax_percentage
shipping_charge_tax_typecreditnote.shipping_charge_tax_type
statuscreditnote.status
status_formattedcreditnote.status_formatted
sub_statusescreditnote.sub_statuses
sub_totalcreditnote.sub_total
sub_total_formattedcreditnote.sub_total_formatted
sub_total_inclusive_of_taxcreditnote.sub_total_inclusive_of_tax
sub_total_inclusive_of_tax_formattedcreditnote.sub_total_inclusive_of_tax_formatted
subject_contentcreditnote.subject_content
submitted_bycreditnote.submitted_by
submitted_datecreditnote.submitted_date
submitted_date_formattedcreditnote.submitted_date_formatted
submitter_idcreditnote.submitter_id
tax_roundingcreditnote.tax_rounding
tax_totalcreditnote.tax_total
tax_total_formattedcreditnote.tax_total_formatted
taxescreditnote.taxes
template_idcreditnote.template_id
template_namecreditnote.template_name
template_typecreditnote.template_type
template_type_formattedcreditnote.template_type_formatted
termscreditnote.terms
totalcreditnote.total
total_credits_usedcreditnote.total_credits_used
total_formattedcreditnote.total_formatted
total_refunded_amountcreditnote.total_refunded_amount
transaction_rounding_typecreditnote.transaction_rounding_type

Salesorder

Salesorder details

This method lets you fetch the details of an salesorder. This can be used only when the widget is displayed in the salesorders details or creation page.

To fetch the details of an salesorder:

ZFAPPS.get('salesorder').then(function (data) {
    //response Handling
}).catch(function (err) {
    //error Handling       
});
Response:

{
  "salesorder": {
    "salesorder_id": "112233",
    "salesorder_number": "INV-000006",
    "salesorder_id": "",
    "salesorder_number": "",
    "crm_owner_id": "",
    "zcrm_potential_id": "",
    "zcrm_potential_name": "",
    "date": "2018-08-25",
    "date_formatted": "25 Aug 2019",
    "status": "paid",
    "status_formatted": "Paid",
    "amount": 101,
    "amount_formatted": "$101.00",
    .......
   }
}
Salesorder list

This method lets you fetch the list of salesorders. This can be used only when the widget is displayed in the salesorders list page.

ZFAPPS.get('retainerinvoice').then(function (data) {
   //response Handling
}).catch(function (err) {
   //error Handling
});
Response:
{
  "salesorders": [
	{
      "salesorder_id": "112233",
      "salesorder_number": "INV-000006",
       ...
     },
     {
      "salesorder_id": "112233",
      "salesorder_number": "INV-000006",
       ...
     }
     ....
   ]
}
Supported Keys:
PropertyRequest
adjustmentsalesorder.adjustment
adjustment_descriptionsalesorder.adjustment_description
adjustment_formattedsalesorder.adjustment_formatted
approver_idsalesorder.approver_id
approvers_listsalesorder.approvers_list
attachment_namesalesorder.attachment_name
balancesalesorder.balance
balance_formattedsalesorder.balance_formatted
bcy_adjustmentsalesorder.bcy_adjustment
bcy_discount_totalsalesorder.bcy_discount_total
bcy_shipping_chargesalesorder.bcy_shipping_charge
bcy_sub_totalsalesorder.bcy_sub_total
bcy_tax_totalsalesorder.bcy_tax_total
bcy_totalsalesorder.bcy_total
billing_addresssalesorder.billing_address
billing_address_idsalesorder.billing_address_id
commentssalesorder.comments
contact_categorysalesorder.contact_category
contact_personssalesorder.contact_persons
created_by_emailsalesorder.created_by_email
created_by_idsalesorder.created_by_id
created_datesalesorder.created_date
created_date_formattedsalesorder.created_date_formatted
created_timesalesorder.created_time
created_time_formattedsalesorder.created_time_formatted
crm_custom_reference_idsalesorder.crm_custom_reference_id
crm_owner_idsalesorder.crm_owner_id
currency_codesalesorder.currency_code
currency_idsalesorder.currency_id
currency_symbolsalesorder.currency_symbol
custom_fieldssalesorder.custom_fields
customer_idsalesorder.customer_id
customer_namesalesorder.customer_name
datesalesorder.date
date_formattedsalesorder.date_formatted
delivery_methodsalesorder.delivery_method
delivery_method_idsalesorder.delivery_method_id
discountsalesorder.discount
discount_applied_on_amountsalesorder.discount_applied_on_amount
discount_percentsalesorder.discount_percent
discount_totalsalesorder.discount_total
discount_total_formattedsalesorder.discount_total_formatted
discount_typesalesorder.discount_type
documentssalesorder.documents
estimate_idsalesorder.estimate_id
exchange_ratesalesorder.exchange_rate
invoiced_statussalesorder.invoiced_status
invoiced_status_formattedsalesorder.invoiced_status_formatted
invoicessalesorder.invoices
is_adv_tracking_in_packagesalesorder.is_adv_tracking_in_package
is_discount_before_taxsalesorder.is_discount_before_tax
is_emailedsalesorder.is_emailed
is_fba_shipment_createdsalesorder.is_fba_shipment_created
is_inclusive_taxsalesorder.is_inclusive_tax
is_offline_paymentsalesorder.is_offline_payment
is_pre_gstsalesorder.is_pre_gst
last_modified_by_idsalesorder.last_modified_by_id
last_modified_timesalesorder.last_modified_time
last_modified_time_formattedsalesorder.last_modified_time_formatted
line_itemssalesorder.line_items
merchant_idsalesorder.merchant_id
merchant_namesalesorder.merchant_name
notessalesorder.notes
order_statussalesorder.order_status
order_status_formattedsalesorder.order_status_formatted
paid_statussalesorder.paid_status
paid_status_formattedsalesorder.paid_status_formatted
payment_termssalesorder.payment_terms
payment_terms_labelsalesorder.payment_terms_label
price_precisionsalesorder.price_precision
purchaseorderssalesorder.purchaseorders
reference_numbersalesorder.reference_number
refundable_amountsalesorder.refundable_amount
roundoff_valuesalesorder.roundoff_value
roundoff_value_formattedsalesorder.roundoff_value_formatted
salesorder_idsalesorder.salesorder_id
salesorder_numbersalesorder.salesorder_number
salesperson_idsalesorder.salesperson_id
salesperson_namesalesorder.salesperson_name
shipment_datesalesorder.shipment_date
shipment_date_formattedsalesorder.shipment_date_formatted
shipping_addresssalesorder.shipping_address
shipping_address_idsalesorder.shipping_address_id
shipping_chargesalesorder.shipping_charge
shipping_charge_exclusive_of_taxsalesorder.shipping_charge_exclusive_of_tax
shipping_charge_exclusive_of_tax_formattedsalesorder.shipping_charge_exclusive_of_tax_formatted
shipping_charge_formattedsalesorder.shipping_charge_formatted
shipping_charge_inclusive_of_taxsalesorder.shipping_charge_inclusive_of_tax
shipping_charge_inclusive_of_tax_formattedsalesorder.shipping_charge_inclusive_of_tax_formatted
shipping_charge_sac_codesalesorder.shipping_charge_sac_code
shipping_charge_taxsalesorder.shipping_charge_tax
shipping_charge_tax_exemption_codesalesorder.shipping_charge_tax_exemption_code
shipping_charge_tax_exemption_idsalesorder.shipping_charge_tax_exemption_id
shipping_charge_tax_formattedsalesorder.shipping_charge_tax_formatted
shipping_charge_tax_idsalesorder.shipping_charge_tax_id
shipping_charge_tax_namesalesorder.shipping_charge_tax_name
shipping_charge_tax_percentagesalesorder.shipping_charge_tax_percentage
shipping_charge_tax_typesalesorder.shipping_charge_tax_type
sourcesalesorder.source
statussalesorder.status
status_formattedsalesorder.status_formatted
sub_totalsalesorder.sub_total
sub_total_exclusive_of_discountsalesorder.sub_total_exclusive_of_discount
sub_total_exclusive_of_discount_formattedsalesorder.sub_total_exclusive_of_discount_formatted
sub_total_formattedsalesorder.sub_total_formatted
sub_total_inclusive_of_taxsalesorder.sub_total_inclusive_of_tax
sub_total_inclusive_of_tax_formattedsalesorder.sub_total_inclusive_of_tax_formatted
submitted_bysalesorder.submitted_by
submitted_datesalesorder.submitted_date
submitted_date_formattedsalesorder.submitted_date_formatted
submitter_idsalesorder.submitter_id
tax_roundingsalesorder.tax_rounding
tax_totalsalesorder.tax_total
tax_total_formattedsalesorder.tax_total_formatted
taxessalesorder.taxes
template_idsalesorder.template_id
template_namesalesorder.template_name
template_typesalesorder.template_type
template_type_formattedsalesorder.template_type_formatted
termssalesorder.terms
totalsalesorder.total
total_formattedsalesorder.total_formatted
total_quantitysalesorder.total_quantity
total_quantity_formattedsalesorder.total_quantity_formatted
transaction_rounding_typesalesorder.transaction_rounding_type
zcrm_potential_idsalesorder.zcrm_potential_id
zcrm_potential_namesalesorder.zcrm_potential_name

Retainer Invoice

Retainer Invoice details

This method lets you fetch the details of an retainerinvoice. This can be used only when the widget is displayed in the retainerinvoices details or creation page.

To fetch the details of an retainerinvoice:

ZFAPPS.get('retainerinvoice').then(function (data) {
    //response Handling
}).catch(function (err) {
    //error Handling       
});
Response:

{
  "retainerinvoice": {
    "retainerinvoice_id": "112233",
    "retainerinvoice_number": "INV-000006",
    "salesorder_id": "",
    "salesorder_number": "",
    "crm_owner_id": "",
    "zcrm_potential_id": "",
    "zcrm_potential_name": "",
    "date": "2018-08-25",
    "date_formatted": "25 Aug 2019",
    "status": "paid",
    "status_formatted": "Paid",
    "amount": 101,
    "amount_formatted": "$101.00",
    .......
   }
}
Retainer Invoice list

This method lets you fetch the list of retainerinvoices. This can be used only when the widget is displayed in the retainerinvoices list page.

ZFAPPS.get('retainerinvoice').then(function (data) {
   //response Handling
}).catch(function (err) {
   //error Handling
});
Response:
{
  "retainerinvoices": [
	{
      "retainerinvoice_id": "112233",
      "retainerinvoice_number": "INV-000006",
       ...
     },
     {
      "retainerinvoice_id": "112233",
      "retainerinvoice_number": "INV-000006",
       ...
     }
     ....
   ]
}
Supported Keys:
PropertyRequest
retainerinvoice_idretainerinvoice.retainerinvoice_id
retainerinvoice_numberretainerinvoice.retainerinvoice_number
dateretainerinvoice.date
date_formattedretainerinvoice.date_formatted
statusretainerinvoice.status
status_formattedretainerinvoice.status_formatted
last_payment_dateretainerinvoice.last_payment_date
last_payment_date_formattedretainerinvoice.last_payment_date_formatted
reference_numberretainerinvoice.reference_number
customer_idretainerinvoice.customer_id
roundoff_valueretainerinvoice.roundoff_value
roundoff_value_formattedretainerinvoice.roundoff_value_formatted
transaction_rounding_typeretainerinvoice.transaction_rounding_type
vat_treatmentretainerinvoice.vat_treatment
place_of_supplyretainerinvoice.place_of_supply
place_of_supply_formattedretainerinvoice.place_of_supply_formatted
customer_nameretainerinvoice.customer_name
contact_personsretainerinvoice.contact_persons
currency_idretainerinvoice.currency_id
currency_coderetainerinvoice.currency_code
currency_symbolretainerinvoice.currency_symbol
exchange_rateretainerinvoice.exchange_rate
is_viewed_by_clientretainerinvoice.is_viewed_by_client
unused_retainer_paymentsretainerinvoice.unused_retainer_payments
unused_retainer_payments_formattedretainerinvoice.unused_retainer_payments_formatted
client_viewed_timeretainerinvoice.client_viewed_time
client_viewed_time_formattedretainerinvoice.client_viewed_time_formatted
is_inclusive_taxretainerinvoice.is_inclusive_tax
tax_roundingretainerinvoice.tax_rounding
line_itemsretainerinvoice.line_items
sub_totalretainerinvoice.sub_total
sub_total_formattedretainerinvoice.sub_total_formatted
totalretainerinvoice.total
total_formattedretainerinvoice.total_formatted
taxesretainerinvoice.taxes
payment_maderetainerinvoice.payment_made
payment_made_formattedretainerinvoice.payment_made_formatted
payment_drawnretainerinvoice.payment_drawn
payment_drawn_formattedretainerinvoice.payment_drawn_formatted
balanceretainerinvoice.balance
balance_formattedretainerinvoice.balance_formatted
allow_partial_paymentsretainerinvoice.allow_partial_payments
price_precisionretainerinvoice.price_precision
payment_optionsretainerinvoice.payment_options
is_emailedretainerinvoice.is_emailed
contact_persons_associatedretainerinvoice.contact_persons_associated
paymentsretainerinvoice.payments
payment_refundsretainerinvoice.payment_refunds
documentsretainerinvoice.documents
commentsretainerinvoice.comments
billing_addressretainerinvoice.billing_address
shipping_addressretainerinvoice.shipping_address
notesretainerinvoice.notes
termsretainerinvoice.terms
custom_fieldsretainerinvoice.custom_fields
template_idretainerinvoice.template_id
template_nameretainerinvoice.template_name
template_typeretainerinvoice.template_type
template_type_formattedretainerinvoice.template_type_formatted
created_timeretainerinvoice.created_time
last_modified_timeretainerinvoice.last_modified_time
created_by_idretainerinvoice.created_by_id
last_modified_by_idretainerinvoice.last_modified_by_id
attachment_nameretainerinvoice.attachment_name
invoice_urlretainerinvoice.invoice_url
submitted_dateretainerinvoice.submitted_date
submitted_date_formattedretainerinvoice.submitted_date_formatted
submitted_byretainerinvoice.submitted_by
approvers_listretainerinvoice.approvers_list
Was this document helpful?
Yes
No