Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

The createEstimate operation creates an estimate for your customer.

Code Block
languagexml
titlecreateEstimate
<zohobooks.createEstimate>
    <contactPersons>{$ctx:contactPersons}</contactPersons>
    <send>{$ctx:send}</send>
    <exchangeRate>{$ctx:exchangeRate}</exchangeRate>
    <referenceNumber>{$ctx:referenceNumber}</referenceNumber>
    <terms>{$ctx:terms}</terms>
    <date>{$ctx:date}</date>
    <customerId>{$ctx:customerId}</customerId>
    <adjustment>{$ctx:adjustment}</adjustment>
    <discountType>{$ctx:discountType}</discountType>
    <salesPersonName>{$ctx:salesPersonName}</salesPersonName>
    <taxExemptionId>{$ctx:taxExemptionId}</taxExemptionId>
    <vatTreatment>{$ctx:vatTreatment}</vatTreatment>
    <ignoreAutoNumberGeneration>{$ctx:ignoreAutoNumberGeneration}</ignoreAutoNumberGeneration>
    <avataxUseCode>{$ctx:avataxUseCode}</avataxUseCode>
    <lineItems>{$ctx:lineItems}</lineItems>
    <note>{$ctx:note}</note>
    <customFields>{$ctx:customFields}</customFields>
    <adjustmentDescription>{$ctx:adjustmentDescription}</adjustmentDescription>
    <expiryDate>{$ctx:expiryDate}</expiryDate>
    <isDiscountBeforeTax>{$ctx:isDiscountBeforeTax}</isDiscountBeforeTax>
    <shippingCharge>{$ctx:shippingCharge}</shippingCharge>
    <estimateNumber>{$ctx:estimateNumber}</estimateNumber>
    <discount>{$ctx:discount}</discount>
    <templateId>{$ctx:templateId}</templateId>
    <avataxExemptNo>{$ctx:avataxExemptNo}</avataxExemptNo>
    <taxId>{$ctx:taxId}</taxId>
	<taxAuthorityId>{$ctx:taxAuthorityId}</taxAuthorityId>
</zohobooks.createEstimate>
Properties
  • contactPersons: Array of contact person(s) to whom the estimate has to be sent.
  • send: Send the invoice estimate to the contact person(s) associated with the estimate. Allowed Values: true and false
  • exchangeRate: Exchange rate of the currency.
  • referenceNumber: Reference number for the estimateVariantsreference_number_startswith and reference_number_contains.
  • terms: Terms and conditions for the estimate.
  • date: The date the estimate was created.
  • customerId: The ID of the customer.
  • adjustment: Adjustments made to the invoice.
  • discountType: How the discount is specified. Allowed values are entity_level or item_level. Allowed Values: entity_level and item_level.
  • salesPersonName: Name of the sales person.
  • taxExemptionId: The ID of the tax exemption (US Edition only).
  • vatTreatment: VAT treatment for the invoice (UK Edition only).
  • ignoreAutoNumberGeneration: Ignore auto estimate number generation for this estimate. This mandates the estimate number. Allowed Values: true and false
  • avataxUseCode: Used to group like customers for exemption purposes. It is a custom value that links customers to a tax rule (Avalara integration only).
  • lineItems: Array containing item details.
  • note: Note for an estimate.
  • customFields: Array of the custom fields for an estimate.
  • adjustmentDescription: Customize the adjustment description. E.g. Rounding off.
  • expiryDate: Date the estimate is valid up to.
  • isDiscountBeforeTax: Used to specify how the discount has to applied. Either before or after the calculation of tax.
  • shippingCharge: Shipping charges applied to the invoice.
  • estimateNumber: Estimate number if auto number generation is disabled.
  • discount: Discount applied to the invoice. It can be either in % or in amount. e.g. 12.5% or 190.
  • templateId: The ID of the PDF template associated with the estimate.
  • avataxExemptNo: Exemption certificate number of the customer (Avalara integration only).
  • taxId: The ID of the tax or tax group applied to the estimate (US Edition only).
  • taxAuthorityId: The ID of the tax authority. Tax authority depends on the location of the customer. For example, if the customer is located in NY, then the tax authority is NY tax authority. (US Edition only).

Anchor
request
request
Sample Request

Following is a sample REST/JSON request that can be handled by the createEstimate operation.

...