xMatix
Sign in Request demo
xMatix
PRODUCTS
SalesField Sales & SFACRMRewardsClaimsInventoryProcurementWarehouse ManagementField ServiceServiceSupportTelephony & MessagingFinance & AccountingPayrollExpense ManagementCommercePortalsAnalytics & ReportingData StudioMobile AppSee all products →
PLATFORM
Platform overviewApp BuilderAutomationIntegrationsSecurity & GovernanceChange ManagementDevelopers
SENSE AI
Sense AI overviewSense AssistSense ControlSense VisionAI StudioTrust & governanceIn Claude & ChatGPTUse cases
SOLUTIONS
Auto DMSConsumer Goods DMSSales Force Automation (SFA) FMCG & DistributionManufacturing & Dealer NetworksAutomotive & DealershipsPharma & HealthcareConsumer DurablesAgri-InputsBuilding MaterialsService NetworksWarehousing & 3PLFinancial AccountingERP SoftwareIndia GST ComplianceUAE VAT & e-InvoicingSaudi ZATCA & VATAll solutions →
RESOURCES
Knowledge CenterDeveloper & CLIBlogGuidesWhat is xMatix?Company facts
COMPANY
AboutCareersPartnersEventsContactAuthorsLegal
Sign in Request demo
Home/Docs/Entity Reference/Quote — entity reference
REFERENCE · Last reviewed

Quote — entity reference

A quote is the priced offer sent to a customer: the customer, the items or services offered with their prices and taxes, and the record a sales order or service order is created from once the customer agrees. It has two record types (Sales, Service) and appears in the CRM app. It is created directly, or by the Quote button on an opportunity, which copies every opportunity line and can run any number of times. It is numbered from document numbering (shipped series QT, no separator). Account, Partner Account, Branch, Opportunity and Asset are locked once saved with a value. Approve and Decline set the approved and declined flags on the quote and every line but never change Status, which starts at Draft and is changed by hand. The Order action creates one sales order per quote and refuses a second run; the Service Order action creates one service order, and a re-run adds only the lines added since to that same order. Both skip a declined quote without a message. Step-by-step procedures are on the Quotes page of the CRM documentation.

Fields

FieldLabelTypeRequiredWhat it does
AccountIdAccountLookup → AccountThe customer the quote is for. Only active customer accounts can be picked. When left empty it is filled from the selected asset's owner. Choosing an account fills the names, email, phone and billing and shipping addresses that are still blank. Locked once saved with a value.
AccountNameAccount NameTextThe customer's filing name. Defaults to the business name, otherwise first and last name.
AssetIdAssetLookup → AssetThe customer's asset the work is quoted for, on service quotes. Limited to the account's assets. Locked once saved with a value; copied to the service order.
BillingAddressBilling AddressText
BillingCityBilling CityPickListValues: Mumbai, Pune, Chandigarh.
BillingCityPlaceIdBilling City PlaceLookup
BillingContactAddressIdContact AddressLookup → ContactAddress
BillingCountryBilling CountryPickListValues: India.
BillingPostalCodeBilling Postal CodeText
BillingRegionBilling RegionText
BillingStateBilling StatePickListValues: Haryana, Maharashtra, New Delhi, Punjab.
BillingStreetBilling StreetText
BranchIdBranchLookup → BranchThe selling branch. Must be active and belong to the partner account; required when the partner account has branches. Locked once saved with a value.
ComplaintComplaintLookup
ComplaintIdComplaintLookup → Complaint
CreatedByIdCreated ByLookup → UserAccountYes
CreatedDateTimeCreated DateDateAndTimeYes
DiscountDiscountPercentA header discount percentage. It is copied into each line's discount when the line is added; changing it later does not change lines already on the quote. Not shown on the shipped layouts.
DiscountGroupIdDiscount GroupLookup → DiscountGroupThe discount group whose discounts apply to the lines. Chosen automatically on creation; not shown on the shipped layouts.
DocumentDateDocument DateDateThe quote's business date. Set to the creation day when the quote is raised from an opportunity; there is no default on a quote created directly.
DocumentNumberDocument NumberNumberYes
EstimateDateEstimate DateDateThe date the estimate was prepared. Set to the creation day when the quote is raised from an opportunity.
EstimateRejectionReasonEstimate Rejection ReasonPickListWhy the customer turned the quote down. Only None is shipped; organizations add their own reasons. Shown with Rejection Remarks under Rejections.
ExternalIdExternalText, unique
IdIdGuidYes
IsApprovedApprovedBooleanYesSet on the quote and every line by the Approve action, which also clears Declined. Separate from Status.
IsDeclinedDeclinedBooleanYesSet on the quote and every line by the Decline action, which also clears Approved. A declined quote is skipped by the Order and Service Order actions without a message, and declined lines are not copied to a service order.
IsDropOffRequiredDrop Off RequiredBooleanYes
IsEstimateLinesGeneratedEstimate Lines GeneratedBooleanYes
IsFieldServiceField ServiceBooleanYes
IsOrderGeneratedOrder GeneratedBooleanYesMarks that a sales order has been created from the quote. While set, the Order action is refused with "Order has already been generated for this quote."
IsPickUpRequiredPick Up RequiredBooleanYes
IsServiceOrderGeneratedService Order GeneratedBooleanYesMarks that a service order has been created from the quote.
IsServiceOrderUpdatedService Order UpdatedBooleanYes
ItemServiceContractIdItem Service ContractLookup → ItemServiceContractThe service contract the work falls under. Choosing one adds the contract's lines to the quote. Copied to the service order.
ModifiedByIdModified ByLookup → UserAccountYes
NameDocument NumberTextYesThe quote's document number, generated on save from the Quote Document Name Setting. The shipped format is QT, the day, month and year, and a six-digit counter, with no separator.
OpportunityIdOpportunityLookup → OpportunityThe opportunity the quote came from. Choosing an opportunity on a saved quote whose opportunity was empty adds that opportunity's lines. Locked once saved with a value.
OpportunityRepairOrderIdOpportunity Repair OrderLookup
OrderIdOrderLookup → OrderThe sales order created from the quote by the Order action.
OwnerIdOwnerLookup → UserAccountYes
PackageServiceIdPackage ServiceLookup
PartnerAccountIdPartner AccountLookup → AccountYour selling company. Only active partner accounts can be picked. Locked once saved with a value.
PerformApprovalPerform ApprovalBoolean
PerformDeclinePerform DeclineBoolean
PerformEstimateLinesGenerationPerform Estimate Lines GenerationBooleanYesLegacy flag with no effect.
PerformOrderGenerationPerform Order GenerationBooleanYes
PerformServiceOrderGenerationPerform Service Order GenerationBooleanYes
PerformUpdateRepairOrderPerform Update Repair OrderBooleanYesLegacy flag with no effect.
PriceAsOnDatePrice As On DateDateThe date prices are taken from. Changing it reprices every line from the price list in force on that date. Not shown on the shipped layouts.
PriceListIdPrice ListLookup → PriceListThe sale price list line prices come from. Chosen automatically on creation for the customer, partner account and branch; not shown on the shipped layouts.
QuantityQuantityDecimal
Quantity2Quantity2Decimal
RecordTypeIdRecord TypeGuid, hidden
RejectionRemarksRejection RemarksTextFree-text explanation of why the quote was lost. The Quotes Lost Sale By Reason report groups lost quotes by it.
RemarksRemarksText
RoundOffRound OffCurrency
ServiceAdvisorIdService AdvisorLookup → ResourceLabelled Executive: the person handling the quote. Shown in the record header; activities on the record are assigned to them. Copied to the service order.
ServiceContractItemService Contract ItemLookup
ServiceOrderIdService OrderLookup → ServiceOrderThe service order created from the quote by the Service Order action. While it is set, running the action again adds only the quote lines not yet on that service order.
ServiceRequestIdServiceRequestGuid
ServiceRequestRepairOrderIdServiceRequestRepairOrderGuid
ServiceTypeService TypePickListThe kind of work quoted on a service quote: Paid Repair, PDI, Warranty Repair or Accidental Repair. Copied to the service order. Values: Paid Repair.
ShippingAddressIdShipping AddressLookup
ShippingCityShipping CityPickListValues: Pune, Mumbai, Chandigarh.
ShippingCityPlaceIdShipping City PlaceLookup
ShippingContactAddressIdContact AddressLookup → ContactAddress
ShippingCountryShipping CountryPickListValues: India.
ShippingPostalCodeShipping Postal CodeText
ShippingRegionShipping RegionText
ShippingStateShipping StatePickListValues: Haryana, New Delhi, Maharashtra, Punjab.
ShippingStreetShipping StreetText
StatusStatusPickListWhere the quote stands: Draft (the default), Pending Approval, Approved or Declined. Nothing in the shipped configuration changes it; it is set by hand or by business rules an administrator adds. The Approve and Decline actions do not change it. Values: Draft, Pending Approval, Approved, Declined.
Tax1Tax 1Currency
Tax1NameTax Name 1Text
Tax1RateTax Rate 1Currency
Tax1TypeTax Type 1Text
TaxGroupIdTax GroupLookup → TaxGroup
TaxIdTaxLookup → Tax
TaxSupplyTypeTax Supply TypePickListWithin State, Outside State, Exempt or Exports. For businesses in India it is recalculated on every save from the place of supply, the source of supply and the customer's registration. Values: Within State, Outside State, Exempt, Exports.
TCSEligibleAmountTCS Eligible AmountCurrency
TotalAmountTotal AmountCalculated (calculated)The quote total: total line amount plus total line tax.
TotalDiscountAmountTotal Discount AmountCalculated (calculated)The total of line discounts.
TotalLineAmountTotal Line AmountCalculated (calculated)
TotalLineBaseAmountTotal Line Base AmountCalculated (calculated)Quantity times unit price over all lines, before discounts.
TotalLineGrossAmountTotal Line Gross AmountCalculated (calculated)The total of line amounts including tax.
TotalLineTaxAmountTotal Line Tax AmountCalculated (calculated)The total tax over all lines.
TotalSchemeDiscountAmountTotal Scheme Discount AmountCalculated (calculated)
TotalTaxAmountTotalTaxAmountDecimal
TotalTaxPostingAmountTotal Tax Posting AmountCalculated (calculated)
UIPropsUI PropsText
UpdatedDateTimeModified DateDateAndTimeYes
UsageReadingUsage ReadingDecimalThe asset's usage reading for the estimate. Copied to the service order.
UsageReadingHoursUsage Reading HoursDecimalThe asset's hour-meter reading for the estimate. Copied to the service order.

Actions

ActionLabelTypeWhat it does
ApplyPackageConfigurationApply Package ConfigurationServerAction (ApplyPackageConfiguration)Writes a package quote line's component selection: requires LineId and a components array of {ItemComponentId, Quantity, IsSelected}.
BulkDeleteDeleteDeleteDelete the selected records.
CloneCloneServerAction (Clone)Create a copy of this record
DeleteDeleteDeleteDelete
DeleteInListDeleteDeleteDelete in a list page
EditEditEditEdit
EditEntityEditEditEditEntity
EditInLineEditEditInlineEdit in page.
EditListEditEditInlineEdit
GetConfigurableItemsGet Configurable ItemsServerAction (GetConfigurableItems)Read-only package-configurator query: returns the quote's configurable package lines (ItemComponentService.GetConfigurableItemsForQuoteAsync). No state change.
GetPackageConfigurationGet Package ConfigurationServerAction (GetPackageConfiguration)Read-only: returns the component configuration of one package quote line - requires a LineId argument; pricing resolved for the quote's partner account. No state change.
NewNewNewNew
PerformApprovalApproveServerAction (PerformApproval)Approves the quote: sets IsApproved true and IsDeclined false on the quote and on every QuoteLine. No other documents are created by this action.
PerformDeclineDeclineServerAction (PerformDecline)Declines the quote: sets IsDeclined true and IsApproved false on the quote and on every QuoteLine. Declined quotes are skipped by service-order generation.
PerformOrderGenerationOrderServerAction (PerformOrderGeneration)Creates a sales Order from the quote, copying account/branch/partner and the opportunity link, then stamps Quote.OrderId and IsOrderGenerated. Skipped when OrderId is already set; validation refuses when IsOrderGenerated is already true.
PerformServiceOrderGenerationService OrderServerAction (PerformServiceOrderGeneration)Creates a ServiceOrder from the quote and stamps IsServiceOrderGenerated. Refused when a service order was already generated or the quote has no lines; declined quotes are skipped.
PrintQuotePrint QuotePrintPrinting of quote
PrintQuotePrint QuotePrintQuote Print

Validations

ValidationApplies toError messageNotes
Usage Reading Cannot be blankError, inactiveUsage Reading cannot be blankUsage Reading cannot be blank
Usage Reading Validation RuleError, inactiveUsage Reading Cannot be NegativeUsage Reading Cannot be Negative

Lookup filters

FilterLookup fieldNotes
Branch For Partner AccountBranchId
Customer Account FilterAccountId
Partner Account FilterPartnerAccountId